Difference between revisions of "explain xkcd:Editor FAQ"

Explain xkcd: It's 'cause you're dumb.
Jump to: navigation, search
m (de ja vu)
Line 1: Line 1:
'''Frequently Asked Questions for editors'''
+
Tinnitus is that high pitched ringing [https://blog.letsfireurbossnow.com/tag/zenith-hearing-x3-amazon/ Hearing X3] that you get in your ears. It has no external sources and seems to be coming from inside your head. In mild cases it can be maddeningly frustrating and interfere with your normal hearing. In severe cases it can make it hard to concentrate on anything and make it difficult to sleep at night. Regardless of how bad your symptoms are, no doubt you are looking for some remedies for tinnitus. Here are 4 that may help you.
  
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]].
+
The main causes of tinnitus are ear damage, excessive stress on the body and troubles with the sinuses. The most common cause is ear damage, which accounts for around 70% of the cases. Ear damage generally occurs through neglect or some form of infection. Understanding the most probable cause is important when it comes to providing tinnitus relief.
  
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.
+
Tinnitus maskers do not address the cause of the ringing or even try to stop the ringing in the ears. They merely provide the ears with a better sound to listen to. This may not seem like a satisfactory solution but they help to train the ear to filter out the ringing until it is effectively not heard. Tinnitus maskers are often described as white noise or background noise that is playing and helps you to take your mind off the ringing. It could be considered a high tech. remedy for tinnitus.
  
Please always use the preview button to verify your edit before finally pressing the save button.
+
[https://blog.letsfireurbossnow.com/tag/zenith-hearing-x3-amazon/ https://blog.letsfireurbossnow.com/tag/zenith-hearing-x3-amazon/]
 
 
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 should I include in 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.
 
 
 
==In which cases are tables meaningful, and when are they not?==
 
At the transcript tables should never be used, even when there is a table in the comic image it should be described by text.
 
 
 
At the explanation tables only make sense when the content is compact. When a single row contains more than a small item like a number, a small phrase, or something similar a table isn't the proper layout because it's hard to read. Instead it should be written in floating text chapters with distinct headers above (see next section below.)
 
 
 
Instead of using a two-column table (e.g. "sentence from comic", "explanation"), consider using a description list (''bold text''). Place a semicolon (<code>;</code>) at the beginning of the sentence to be explained and a colon (<code>:</code>) at the beginning of each paragraph of the explanation, like this (from [[1987: Python Environment#Explanation|1987]]):
 
; Anaconda Python
 
: Anaconda is a Python distribution for data science and machine learning related applications.
 
: A second paragraph for the explanation.
 
 
 
The Wikipedia's {{w|WP:WHENTABLE#Appropriate use|Manual of Style/Tables}} describes it best:
 
<blockquote>Often a list is best left as a list. Before reformatting a list into table form, consider whether the information will be more clearly conveyed by virtue of having rows and columns. If so, then a table is probably a good choice. If there is no obvious benefit to having rows and columns, then a table is probably not the best choice. </blockquote>
 
 
 
==What is the proper layout for headers?==
 
For headlines you have to use Wiki-style code. The simplest way is a preceding semicolon at the beginning of the line which causes the entire line to be rendered in bold.
 
 
 
On large explanations it can be handy to divide it into subsections. In this case the header is written like this: <code><nowiki>===Sub header===</nowiki></code>. But in most cases the simple semicolon is just enough.
 
 
 
==What is the format of the transcript section?==
 
The transcript should describe the content (think about explaining the comic to a visually impaired person, or to someone on phone). It should do this in a compact manner, and cite all written words. Every line should begin with an indent (a simple <code>:</code> at the beginning), and every panel from the comic should be separated by a blank line. The transcript must not contain any links, nor rich math markup, which once again relies on visuals. Tables should generally be avoided, although not all transcripts comply with this. Furthermore the title text is not included in the transcript. Checking the pages for the older comics will help understand this.
 
 
 
==One or two spaces after a period? And what about newlines?==
 
There is a controversy if one or two spaces after a period ending a sentence should be used. The fact is that even three  or more      spaces are rendered as only one.
 
Furthermore a single newline is also just rendered as a space.
 
 
 
A new paragraph like this needs an empty line before, not just a single newline. Click the edit/source button to see how this chapter is written.
 
 
 
==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 on 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 <nowiki>~~~~</nowiki> or just click the sign button [[File: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 <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?==
 
The three mostly used options are:
 
*an internal link like <code><nowiki>[[Cueball]]</nowiki></code> which renders like this: [[Cueball]]
 
*a link to the English Wikipedia should use this template: <code><nowiki>{{w|Page}}</nowiki></code> links to the Wikipedia article on "Page" or <code><nowiki>{{w|Page|Display}}</nowiki></code> 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: <code><nowiki>[http://www.example.com]</nowiki></code> and you will see this [http://www.example.com] (please avoid this)
 
**and add a text: <code><nowiki>[http://www.example.com Example Homepage]</nowiki></code> everything after the first space is shown: [http://www.example.com 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 <code><nowiki>[[File:DBCooper.jpg|thumb|150px|Cooper]]</nowiki></code> and the picture is taken from Commons, the main source for Wikipedia images. The full syntax can be found at [[mw:Help:Images|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 <code><nowiki>https://imgs.xkcd.com/comics/picture_2x.png</nowiki></code> to <code><nowiki>https://imgs.xkcd.com/comics/picture.png</nowiki></code> 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 won't 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 <code><nowiki><math>...</math></nowiki></code>. The other known code from Wikipedia <code><nowiki><chem>...</chem></nowiki></code> is NOT supported yet. It's based on LaTeX syntax and a general overview can be found at this {{w|Help:Displaying a formula|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.
 
 
 
==Is the ''Citation needed'' template here similar to the analog at Wikipedia?==
 
Simple answer: NO. In fact that template just links to [[285: Wikipedian Protester]], a comic from July 4, 2007 and was meant to be a joke. Adding this template to every comic doesn't explain anything at all (that's what this Wiki aims to do) and should be placed only when there is a deeper sense of humor.
 

Revision as of 09:32, 3 March 2020

Tinnitus is that high pitched ringing Hearing X3 that you get in your ears. It has no external sources and seems to be coming from inside your head. In mild cases it can be maddeningly frustrating and interfere with your normal hearing. In severe cases it can make it hard to concentrate on anything and make it difficult to sleep at night. Regardless of how bad your symptoms are, no doubt you are looking for some remedies for tinnitus. Here are 4 that may help you.

The main causes of tinnitus are ear damage, excessive stress on the body and troubles with the sinuses. The most common cause is ear damage, which accounts for around 70% of the cases. Ear damage generally occurs through neglect or some form of infection. Understanding the most probable cause is important when it comes to providing tinnitus relief.

Tinnitus maskers do not address the cause of the ringing or even try to stop the ringing in the ears. They merely provide the ears with a better sound to listen to. This may not seem like a satisfactory solution but they help to train the ear to filter out the ringing until it is effectively not heard. Tinnitus maskers are often described as white noise or background noise that is playing and helps you to take your mind off the ringing. It could be considered a high tech. remedy for tinnitus.

https://blog.letsfireurbossnow.com/tag/zenith-hearing-x3-amazon/