Difference between revisions of "explain xkcd:Editor FAQ"

Explain xkcd: It's 'cause you're dumb.
Jump to: navigation, search
m (Why I can't upload pictures or create pages?: Slightly corrected grammar.)
Line 1: Line 1:
 
'''Frequently Asked Questions for editors'''
 
'''Frequently Asked Questions for editors'''
  
This FAQ is a short description about editing pages at this wiki. Please read this careful and when there are further questions do not hesitate to enter them into this [[explain xkcd talk:Editor FAQ|talk page]].
+
This FAQ is a short description about editing pages at this wiki. Please read this carefully and if you have any further questions do not hesitate to enter them into this [[explain xkcd talk:Editor FAQ|talk page]].
  
 
For general questions please read first the MediaWiki help pages about [[mw:Help:Editing pages|Editing pages]] or look at the full overview here: [[mw:Help:Contents|Help Contents]]. You also can use your preferred search engine by entering "MediaWiki mytopic". Change mytopic to the theme you're searching for, i.e. "MediaWiki tables" will show you many useful sites about editing tables.
 
For general questions please read first the MediaWiki help pages about [[mw:Help:Editing pages|Editing pages]] or look at the full overview here: [[mw:Help:Contents|Help Contents]]. You also can use your preferred search engine by entering "MediaWiki mytopic". Change mytopic to the theme you're searching for, i.e. "MediaWiki tables" will show you many useful sites about editing tables.
Line 24: Line 24:
 
The transcript should describe the content (think about talking to an impaired person or someone on phone) in a compact manner and cite all written words. Every line begins with an indent (a simple : at the beginning) and every panel from the comic is separated by a blank line. The transcript must not contain any links and the math markup is also forbidden because it just generates new images. Also tables should be avoided, even when not all transcripts comply with this. Furthermore the title text is not included in the transcript. Check older comics and you will understand.
 
The transcript should describe the content (think about talking to an impaired person or someone on phone) in a compact manner and cite all written words. Every line begins with an indent (a simple : at the beginning) and every panel from the comic is separated by a blank line. The transcript must not contain any links and the math markup is also forbidden because it just generates new images. Also tables should be avoided, even when not all transcripts comply with this. Furthermore the title text is not included in the transcript. Check older comics and you will understand.
  
==What belongs to the trivia section==
+
==What belongs to the trivia section?==
As the word says it's just not important odds-and-ends related to the comic. Since this wiki focuses on explaining this section is not part of the default layout.
+
As implied by the section name, it's just trivia, consisting of unimportant odds-and-ends related to the comic. Since this wiki focuses on explaining this section is not part of the default layout. If a word has been misspelled in the comic or title text, or the image was originally broken at xkcd and reuploaded... basically the things that don't belong in the explanation but should still be mentioned, then it should be mentioned in the trivia section.
  
 
==How do I behave at the talk page (discussion)?==
 
==How do I behave at the talk page (discussion)?==
Everybody can add here any thoughts about the comic and more. Please follow the common netiquette and don't be rude. Every comment has to be signed at the end with <nowiki>~~~~</nowiki> or just click the sign button [[File:Button sig.png]] at the top of the editor.
+
Everybody can add here any thoughts about the comic and more. Please follow the common netiquette and don't be rude. Unless you are replying to a previous comment, in which you should add a colon before your comment, you should add comments at the bottom. Every comment has to be signed at the end with <nowiki>~~~~</nowiki> or just click the sign button [[File:Button sig.png]] at the top of the editor.
  
 
==What does the incomplete tag mean?==
 
==What does the incomplete tag mean?==
There are two templates to indicate that an explanation or the transcript do need further rework. Just enter <nowiki>{{incomplete|YOUR REASON}}</nowiki> or respectively <nowiki>{{incomplete transcript|YOUR REASON}}</nowiki> and don't forget to enter a proper reason. The reason at the transcript is not shown to the viewer.
+
There are two templates to indicate that an explanation or the transcript do need further rework. Just enter <nowiki>{{incomplete|YOUR REASON}}</nowiki> or respectively <nowiki>{{incomplete transcript|YOUR REASON}}</nowiki> and don't forget to enter a proper reason to replace the filler text left by the bot (Created by a BOT - Please change this comment when editing this page. Do NOT delete this tag too soon.), or if the reason said in the tag has been dealt with. The reason at the transcript is not shown to the viewer.
  
 
==How do I enter links to other pages?==
 
==How do I enter links to other pages?==
Line 43: Line 43:
  
 
==Why can't I upload pictures or create pages?==
 
==Why can't I upload pictures or create pages?==
Only registered and trusted users can create pages or upload images. After the registration you have to wait at least three days and you must have done a small amount of edits.
+
Only registered and trusted users can create pages or upload images. After the registration you have to wait at least three days and you must have done a small amount of edits, then you will be able to create pages and upload images at will.  
  
 
==How do I embed images?==
 
==How do I embed images?==

Revision as of 12:47, 15 June 2018

Frequently Asked Questions for editors

This FAQ is a short description about editing pages at this wiki. Please read this carefully and if you have any further questions do not hesitate to enter them into this talk page.

For general questions please read first the MediaWiki help pages about Editing pages or look at the full overview here: Help Contents. You also can use your preferred search engine by entering "MediaWiki mytopic". Change mytopic to the theme you're searching for, i.e. "MediaWiki tables" will show you many useful sites about editing tables.

This FAQ focuses only on topics related to this specific Wiki.

What is the general layout of a comic page?

In general you don't have to care about this because the pages are generated by a bot nearly immediately after a new comic is released. If the bot fails please follow exactly the instructions here User:dgbrtBOT to do all the needed actions.

The layout and order is always this:

  • Comic picture with the title text below
  • Explanation
  • Transcript
  • Trivia (optional)
  • Discussion (embedded Talk page)
  • List of non standard categories

What shall I write at the explanation?

Everything is welcome as long as it explains the content of the comic. Everybody can edit here and when others disagree about your contributions they may change it.

What is the format of the transcript section?

The transcript should describe the content (think about talking to an impaired person or someone on phone) in a compact manner and cite all written words. Every line begins with an indent (a simple : at the beginning) and every panel from the comic is separated by a blank line. The transcript must not contain any links and the math markup is also forbidden because it just generates new images. Also tables should be avoided, even when not all transcripts comply with this. Furthermore the title text is not included in the transcript. Check older comics and you will understand.

What belongs to the trivia section?

As implied by the section name, it's just trivia, consisting of unimportant odds-and-ends related to the comic. Since this wiki focuses on explaining this section is not part of the default layout. If a word has been misspelled in the comic or title text, or the image was originally broken at xkcd and reuploaded... basically the things that don't belong in the explanation but should still be mentioned, then it should be mentioned in the trivia section.

How do I behave at the talk page (discussion)?

Everybody can add here any thoughts about the comic and more. Please follow the common netiquette and don't be rude. Unless you are replying to a previous comment, in which you should add a colon before your comment, you should add comments at the bottom. Every comment has to be signed at the end with ~~~~ or just click the sign button Button sig.png at the top of the editor.

What does the incomplete tag mean?

There are two templates to indicate that an explanation or the transcript do need further rework. Just enter {{incomplete|YOUR REASON}} or respectively {{incomplete transcript|YOUR REASON}} and don't forget to enter a proper reason to replace the filler text left by the bot (Created by a BOT - Please change this comment when editing this page. Do NOT delete this tag too soon.), or if the reason said in the tag has been dealt with. The reason at the transcript is not shown to the viewer.

How do I enter links to other pages?

The three mostly used options are:

  • an internal link like [[Cueball]] which renders like this: Cueball
  • a link to the English Wikipedia should use this template: {{w|Page}} links to the Wikipedia article on "Page" or {{w|Page|Display}} prints "Display" which links to the Wikipedia article on "Page"
  • other external links can be done in three ways:
    • just write the URL and it will be shown like this: http://www.example.com
    • put it into single brackets: [http://www.example.com] and you will see this [1] (please avoid this)
    • and add a text: [http://www.example.com Example Homepage] everything after the first space is shown: Example Homepage

Why can't I upload pictures or create pages?

Only registered and trusted users can create pages or upload images. After the registration you have to wait at least three days and you must have done a small amount of edits, then you will be able to create pages and upload images at will.

How do I embed images?

This Wiki isn't a picture book, use this feature only sparingly and reduce the size as much as possible. An example can be seen here: 1400: D.B. Cooper. The syntax in this case is [[File:DBCooper.jpg|thumb|150px|Cooper]] and the picture is taken from Commons, the main source for Wikipedia images. The full syntax can be found at MediaWiki.

You also can upload pictures directly to this Wiki by using the Special:Upload link from the menu. But do not violate any copyright rules or it will be deleted. And when the picture is available at Commons there is no need to upload it here.

The picture at xkcd was updated, how do I upload this here?

Sometimes the initial picture at xkcd contains typos or other errors. When that has been fixed the comic picture here should also be updated. Save the picture from xkcd to your local PC but be careful, there are two versions available. We here use only the smaller version picture.png and not the larger one picture_2x.png. So change https://imgs.xkcd.com/comics/picture_2x.png to https://imgs.xkcd.com/comics/picture.png when your browser shows the 2x version.

To update it here just click the image in the comic page and then click "Upload a new version of this file" below the file history. And please be patient, you wont see your upload immediately because it still comes from the cache at the server. But when you see your upload in the file history everything is OK. Just wait...

How do I enter mathematical or chemical formulas?

You can use the Math markup <math>...</math>. The other known code from Wikipedia <chem>...</chem> is NOT supported yet. It's based on LaTeX syntax and a general overview can be found at this Wikipedia help page -- don't use it unless you understand what you are doing.

Furthermore never use this markup at the transcript because that math code is rendered to a picture -- at the transcript we try to describe the comic image by words, a picture there wouldn't be helpful.