View source for Help:Getting Started

This page covers the basics of setting up and editing a page, for more detailed information, see the list of [[#Useful_links|useful links]] below. If you have any other questions or suggestions, please add them to the [[SGUTranscripts:Community portal|Community portal]], where one of us will be happy to help.

If you'd like to just try your hand at transcribing, we suggest you start with an SGU 5x5 as these are much shorter, or a single segment from an episode.

== Adding pages to episode lists ==
By adding your page to the episode list templates, they will appear on both the [[Main Page]], and the individual [[SGU Episodes]] pages. Currently, all SGU 5X5 episodes have been added to the [[5X5 Episodes]] list. For information on how to edit entries in the [[Template:5X5 episode list]], see [[Template:5X5 list entry]].

It's easy to add your transcript of choice to [[Template:SGU episode list]]. Click "Edit" on the top right and you will see the wiki markup for that page.  Don't worry, it's quite simple.  Find the spot where your transcript belongs chronologically, and add the episode link, date and status template. 

Adding a status template indicates what stage the transcription is at by including a linked icon. 

{| class="wikitable"
! Description
! Appearance on page
! What you type
|-
|Entire page reserved for transcription

Use [[Template:i]]
|
* [[SGU Episode 355]], May 5 2012 {{i}}
|<pre>* [[SGU Episode 355]], May 5 2012 {{i}}</pre>
|-
|Episode open for transcription

Use [[Template:open]]
|
* [[SGU Episode 355]], May 5 2012 {{open}}
|<pre>* [[SGU Episode 355]], May 5 2012 {{open}}</pre>
|-
|Transcription complete, proofreading required

Use [[Template:mag]]
|
* [[SGU Episode 355]], May 5 2012 {{mag}}
|<pre>* [[SGU Episode 355]], May 5 2012 {{mag}}</pre>
|-
|Episode complete and proof-read

Use [[Template:tick]]
|
* [[SGU Episode 355]], May 5 2012 {{tick}}
|<pre>* [[SGU Episode 355]], May 5 2012 {{tick}}</pre>
|}

Putting the page name between double square brackets inserts the link to the page (see the [[#Links|links section]] below). Click "Show preview" to make sure everything looks right. Add a summary to describe your edit, something like "added link to episode 355", and hit "Save page".

Now, if you go to the [[Main Page]], or [[SGU Episodes]], you will see your new edit in place. If you click on the link, you will be taken to an edit box for your new page, and you're good to go.  

=== Reserving episodes/segments ===
* To indicate that you are working on the transcript for a whole episode, add the [[Template:transcribing all|transcribing all]] template at the top of the page, and insert your user name (optional) and the date:

<pre>{{transcribing all
|transcriber = user name
|date        = yyyy-mm-dd
}}</pre>

This will appear on the page like this:
{{transcribing all
|transcriber = user name
|date        = yyyy-mm-dd
}}

* If you would like to work on a single section of the transcription, then you can use the [[Template:transcribing|transcribing]] template instead, placed in the relevant section on the page:

<pre>{{transcribing 
|transcriber = user name
|date        = yyyy-mm-dd
}}</pre>

This will appear above the section like this:
{{transcribing
|transcriber = user name
|date        = yyyy-mm-dd
}}

* Make sure that you also add the [[Template:transcribing section|transcribing section]] template at the top of the page so that other people know that part of the transcript is being worked on:

<pre>{{transcribing section
|transcriber = user name
|date        = yyyy-mm-dd
}}</pre>

This will appear on the page like this:
{{transcribing section
|transcriber = user name
|date        = yyyy-mm-dd
}}

== Editing pages ==
If you want to get transcribing right away, we are more than happy for you to do a text-only transcript, as this is really the lion's share of the work.

You can edit any page by clicking the "Edit" tab at the top of the page, which allows you to edit the whole page. If you just want to edit one section, you can click on the "Edit" link to the right of the section heading.

After entering your content into the edit box, enter a description of what you did in the summary field, then click 'preview' to ensure that your work is being displayed as intended.

It's generally best to check the preview before saving a page in order to avoid excessive entries in the [[Special:RecentChanges|Recent changes]] log. This log shows all changes made to the website, and is useful for checking for new additions, such as messages in the [[SGUTranscripts:Community portal|Community portal]]. However, be careful not to lose your work by navigating away from the edit page.

When you're happy with the page, or want to save your progress and come back to it later, click 'save page', which will show your newly edited page in all its glory. 

=== Edit summary ===
When saving a page, it is considered good practice to add a brief summary of the edit in the field above the save and preview buttons. For example, "Interview segment transcribed", "transcript completed", or "proof-read to 45:30".

Adding a summary helps us quickly see what's been done on a page, and distinguishes between different revisions of the page should users wish to compare edits or return to an earlier version. All versions of a page are automatically saved in their revision history, and can be viewed by clicking on the 'View history' tab of the page itself, or from the link in the [[Special:RecentChanges|Recent changes]] log.

You can set your user preferences to show an alert if you try to save a page without entering a summary. When you are logged in, a 'My preferences' link appears at the top of the screen. If you click on this, and go to the 'Editing' tab, you will see a list of check-boxes, including one stating "Prompt me when entering a blank edit summary".

=== Adding comments ===
If you would like someone to look over your transcription to help with distinguishing between Rogues, or to help with any parts of the transcription, it is helpful if you can insert a comment stating the time in the podcast at that point, and post a message on the [[SGUTranscripts:Community portal|Community portal]]. Comments are entered between <code><nowiki>"<!--" and "-->"</nowiki></code> in the editing box and do not appear on the saved page. For example:
<pre><!-- Help needed to distinguish Rogue speaking at 1:02:48 --></pre>
makes that text visible only in the editing box, not the page itself. This means that any user that tries to help with this problem will be able to get to the root of the issue quickly.

Comments can also be very useful when you want to come back to a section later, for example to add to the [[Help:How to Contribute#Today I Learned...|''Today I Learned...'' list]], or to add links.

== Wiki mark-up ==
Here, we briefly describe the most commonly used wikitext markup and HTML tags for pages on this site. 
HTML tags take the form <code><nowiki><tag></nowiki></code> to start, and <code><nowiki></tag></nowiki></code> to end, encompassing the text that the tag applies to. Most require a closing tag, but not all of them (e.g <code><nowiki><br /></nowiki></code> and <code><nowiki><references/></nowiki></code>).

For more detail, see [[metawikipedia:Help:Advanced_editing|Meta-Wiki: Advanced editing]]

:&otimes;  If you would like to leave the mark-up to someone else, or if you have any questions or suggestions, just put a note in the [[SGUTranscripts:Community portal|Community portal]], and someone will be happy to help out. (see [[#Community_Portal|notes on the Community portal]] below)

=== Headers ===
These are used to mark the different podcast segments, and are automatically incorporated into a table of contents that appears at the top of the page. 

An example of the different headers used in transcription pages can be found at the [[Episode skeleton (new)|Episode Skeleton]] page <!-- here is the old Episode skeleton: https://www.sgutranscripts.org/wiki/Episode_skeleton -->
<!--??? sentence case for segments but not sub-sections???-->
{| class="wikitable"
! width="40%"| Description
! width="20%"| Appearance on page
! width="20%"| What you type
|-
|Headers for each of the different segments of the podcast are made by using 2 'equals' signs.
These are second level headers.
|
<span style="font-size: 150%; margin-bottom: .6em; border-bottom: 1px solid #aaa; page-break-after: avoid;">
Podcast Segment</span>
|<pre>==Podcast Segment==</pre>
|-
|Headers for subsections within the podcast segments are made by using 3 'equals' signs.
These are third level headers.
|
<span style="font-size: 132%; font-weight: bold; margin-bottom: .3em; page-break-after: avoid;"> 
Segment subsection</span>
|<pre>===Segment subsection===</pre>
|-
|We also include the time at which podcast segments start in a small font, using the <code><nowiki><small></nowiki></code> and <code><nowiki></small></nowiki></code> tags.
|
<span style="font-size: 132%; font-weight: bold; margin-bottom: .3em; page-break-after: avoid;">News Item 2 <small>(24:32)</small></span>
|<pre>===News Item 2 <small>(24:32)</small>===</pre>
|}

There are a couple of guidelines to follow on these:
* Quickies with Bob should be second level headers
** If these occur between news items, then they should be followed by a second level header "News items continued" without a time stamp, and a third level header ''with'' time stampsfor the next news items. (e.g. [[SGU Episode 349]])
* Questions and Emails use a second level header for the section title, and third level headers for each question/email (e.g. [[SGU Episode 357]])

=== Line breaks and paragraphs ===
{| class="wikitable"
! width="40%"| Description
! width="20%"| Appearance on page
! width="20%"| What you type
|-
| To start a new paragraph, leave an empty line between text in the editing window. 
Use this to separate lines by different speakers
| S: This is the first line
R: This is the second line
|<pre>S: This is the first line

R: This is the second line</pre>
|-
| Starting a new line in the editing window does not appear on the actual page as a line break.
| This is my first lineThis is my second line
|<pre>This is my first line
This is my second line</pre>
|-
| To start a new line, use the <code><nowiki><br></nowiki></code> tag, which doesn't require a closing tag.
You can use this on the same line, or on a new line.
|
This is my first line<br>This is my second line
|<pre>This is my first line
<br>This is my second line</pre>
|}

=== Text formatting ===
{| class="wikitable"
! width="40%"| Description
! width="20%"| Appearance on page
! width="20%"| What you type
|-
| Words in italics are indicated by double apostrophes.
These can be used to signify when a speaker emphasizes a word. 
| We want to ''emphasize'' words
| <pre>We want to ''emphasize'' words</pre>
|-
| Words in bold are indicated by triple apostrophes.
| We want to '''emphasize''' words
| <pre>We want to '''emphasize''' words</pre>
|-
| Superscript text is placed between <code><nowiki><sup></nowiki></code> and <code><nowiki></sup></nowiki></code> tags
| November 15<sup>th</sup> 2011
| <pre>November 15<sup>th</sup> 2011</pre>
|-
| Subscript text is placed between <code><nowiki><sub></nowiki></code> and <code><nowiki></sub></nowiki></code> tags
| Water: H<sub>2</sub>O 
| <pre>Water: H<sub>2</sub>O</pre>
|-
| Special characters can be inserted using wikitext.
For a list of special character codes, see [[metawikipedia:Help:Advanced_editing#Special_characters|Meta-Wiki - Advanced editing]]
| &iuml;  &eacute; 
Na&iuml;vet&eacute;  
| <pre><nowiki>&amp;iuml;  &amp;eacute;

Na&amp;iuml;vet&amp;eacute;  </nowiki></pre>
|}

=== Quotes ===
{| class="wikitable"
! width="40%" |Description
! width="30%" |Appearance on page
! What you type
|-
| Long quotes are defined using the <code><nowiki><blockquote></nowiki></code> and <code><nowiki></blockquote></nowiki></code> tags.
This indents the text from both margins.
| <blockquote>All the world's a stage, And all the men and women merely players</blockquote>
| <pre><blockquote>All the world's a 
stage, And all the men and women 
merely players</blockquote></pre>
|}

=== Links ===
The default source for links used here is Wikipedia, unless there is good reason to use an alternative source. This helps to keep things uniform across transcript pages, and also means that you don't have to search for the ''ultimate'' website to explain the subject.

{| class="wikitable"
! width="40%" |Description
! Appearance on page
! What you type
|-
| Wikipedia links can be inserted using [[Template:W]]
To use alternative text, insert <code>|</code>
| {{w|James Randi}}
{{w|James Randi|Randi}}
| <pre>{{w|James Randi}}
{{w|James Randi|Randi}}
</pre>
|-
| Internal links (pages on sgutranscripts.org) are given within double square brackets.
To use alternative text, insert <code>|</code>
| [[Main Page]]
[[Main Page|Home]]
|<pre>[[Main Page]]
[[Main Page|Home]]</pre>
|-
| Internal links to sections of pages are identified using <code>#</code>
| [[Help:Getting Started#Wiki mark-up]]
|<pre>[[Help:Getting Started#Wiki mark-up]]</pre>
|-
| If an internal link is used, but no such page exists, the link is displayed in red.
| [[Birds vs Monkeys]]
|<pre>[[Birds vs Monkeys]]</pre>
|-
| To use different text for internal links, add a pipe-line between the page name and the text.
| [[Help:Getting Started#Wiki mark-up|Mark-up]]
| <span style="font-size:90%"><pre>[[Help:Getting Started#Wiki mark-up|Mark-up]]</pre></span>
|-
| To assign external links to text, add a space after the URL, insert the required text and enclose using single square brackets.
Remember to include <code><nowiki>http://</nowiki></code>.
| [http://www.theskepticsguide.org/ SGU website]
| <span style="font-size:90%"><pre>[http://www.theskepticsguide.org/ SGU website]</pre></span>
|-
| If no text is assigned to a link within single brackets, it appears numbered.
This should be avoided, and references should be used in cases where it is not appropriate to embed the link in text. ([[#References|see below]])
| [http://www.theskepticsguide.org/]
| <pre>[http://www.theskepticsguide.org/]</pre>
|}

See also: [[Help:How_to_Contribute#Links|How to Contribute Links]]

=== References ===
When it does not make sense to assign a link to words in the transcription, you can use references.
<!-- ???agree criteria??? -->

References can include both text and URLs, and appear as super-scripted numbered links on the page. These link to a reference section, usually inserted at the bottom of the page, which in turn links back to the point in the text where the reference was made. 

References are usually placed ''after'' punctuation. <!-- ???insert link for conventions of referencing??? -->

{| class="wikitable"
! width="40%" | Description
! Appearance on page
! What you type
|-
| Mark each reference separately at the relevant point in the text, using <code><nowiki><ref></nowiki></code> and <code><nowiki></ref></nowiki></code> tags.
Include the text/links you want to appear in the reference section between the tage.<br>
Clicking on the reference links in this example will take you to the examples in the next row.
| This article.<ref>Example 1</ref>
That article.<ref>Example 2</ref>
| <pre>This article.<ref>Example 1</ref>
That article.<ref>Example 2</ref></pre>
|-
|If you need to use the same reference more than once, it will need to be named using <code><nowiki><ref name=example></nowiki></code> on the first time it is used, and <code><nowiki><ref name=example/></nowiki></code> on subsequent references.
|First<ref name=ex3>Example 3</ref>
Second<ref name=ex3/>
|<pre>First<ref name=ex3>Example 3</ref>
Second<ref name=ex3/></pre>
|-
|Pages with references must contain a section for listing these including the <code><nowiki><references/></nowiki></code> tag.
This automatically lists all references on the page.

Clicking on the arrows takes you back to the place where the reference was made. When multiple references are made to the same source, links to each are given by number.

If <code><nowiki><references/></nowiki></code> is not included, an alert is shown when previewing or editing the page.
|
<span style="font-size:150%;border-bottom: 1px solid #aaa">References&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
<references/>
|<pre>== References ==
<references/></pre>
|}
For more information on references, see [[wikipedia:Help:Footnotes|Wiki Help:Footnotes]].


== Tips for Transcription ==
You should use whatever method of transcription you find suits you best. So far, we don't know of any speech recognition software available to do the task for us, so the following is for manual transcription only. Here's some quick info on what we've found useful so far. 

Please let us know if you have any suggestions to add.
=== Audio software ===
[http://www.nch.com.au/scribe/index.html ExpressScribe] is a free program that allows you a lot of control over the audio playback, whilst using the text editor of your choice. You can assign hot-keys to actions such as play, pause, speed up, skip back etc. that are system-wide (i.e. they work no matter what other program you're in at the time). You can also use this program with a foot pedal.  You can find an overview of ExpressScribe functions in [http://www.makeuseof.com/tag/transcribe-audio-video-files-text-express-scribe/ this article]

[http://www.videolan.org/index.html VLC media player] can be also used, by using the playback speed function.  Dialling down the speed until you can type comfortably in your favourite text editor, a quick alt-tab to switch to vlc, then shift-left a couple of times will skip back a few seconds if you missed something.  Alt-left and alt-right skips larger chunks of time.  With a little practice these commands become second nature.

=== Text editing software ===
Ultimately, it doesn't matter what program you use for writing your transcription, but most have their advantages and disadvantages. 

Here are some things you might want to consider:
*'''Spell-checking''' &ndash; the editing box on this site underlines unrecognized and/or misspelled words with a dotted red line, but is relatively limited.
*'''Automatic correction''' &ndash; some text editors (e.g. MS Word) automatically correct common typos, e.g. 'taht', 'beleive' and 'sicence'. This can be very handy, however, it can sometimes cause problems if a false correction is made and not noticed.
*'''Grammar checking''' &ndash; not for the podcast content itself, but for errors such as lower case letters after full-stops and two spaces in a row etc.
*'''Formatting''' &ndash; e.g. only 'straight' (or 'typewriter') apostrophes are recognised in wiki-markup for bold and italics etc., 'curly' (or typographic) apostrophes, as often used in MS Word, are not. 
**To change this in MS Word 2010, go to ''File''>''Options''>''Proofing'' and click ''AutoCorrect Options''. In the pop-up window, deselect the checkbox for replacing ''"Straight quotes" with "smart quotes"'', in both the ''AutoFormat'' and ''AutoFormat As You Type'' tabs.
**To change this in older versions of MS Word, go to ''Tools''>''AutoCorrect Options''>''AutoFormat As You Type'' and deselect the checkbox for replacing ''"Straight quotes" with "smart quotes".
<!--???Microsoft Word
Advantages: Spell-checker; Corrects common typos automatically, highlights double-spaces
Disadvantages: sometimes auto-corrects when you don't want it to; uses ???apostrophes that aren't recognized for formatting in Wiki (see ???)-->

== Community Portal ==
The [[SGUTranscripts:Community portal|Community portal]] is a page where you can post messages about the website. This is the place to ask for help, make suggestions etc.

You can post a message here by editing and saving the page like any other, entering new topics at the top, and adding to threads within them at the bottom of the thread. 

If you are replying to a post, or adding a new post within a current topic, click on the "edit" link to the right of that topic's header. This means that it will be clear what your comment is about when others see it on the [[Special:RecentChanges|Recent changes page]], or the [http://www.sgutranscripts.org/w/index.php?title=SGUTranscripts:Community_portal&action=history Community Portal history page]. If you are replying to a post, you should indent your text by including one or more colons, ":"

Automatically insert your user name and the time of the post by using 4 tildes <nowiki>"~~~~"</nowiki>, or by clicking the signature button at the top of your editing box.

== Useful links ==
* Consult the [[metawikipedia:Help:Contents|User's Guide]] for information on using the wiki software.
* [[mw:Manual:Configuration_settings|Configuration settings list]]
* [[mw:Manual:FAQ|MediaWiki FAQ]]
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
* [[metawikipedia:Help:Advanced_editing|Wikimedia Help:Advanced editing]]

[[Category:Help]]