Help:Editing: Difference between revisions

m Fix link after rename, categories
Update. Note: there's inline math and display-style math!
Line 4: Line 4:


== Using links ==
== Using links ==
:'' shortcut: [[Help:Links]]''
:''Shortcut: [[Help: Links]]''
What you always have dreamed of (for your paper notes) - in a wiki it becomes true: fast links!
What you always have dreamed of (for your paper notes) - in a wiki it becomes true: fast links!


Line 34: Line 34:
A regular redirect is performed by <code><nowiki>#REDIRECT [[Page title]]</nowiki></code>.  
A regular redirect is performed by <code><nowiki>#REDIRECT [[Page title]]</nowiki></code>.  


Redirects can be used to join alternative names (titles, ([https://en.wikipedia.org/wiki/Headword "lemmata"]) for the same thing to reduce duplication.
Redirects can be used to join alternative names (titles, ({{w|Headword|"lemmata"}}) for the same thing to reduce duplication.


Redirects are also useful to directly link into sections (especially if they have the potential to grow to an article in future).
Redirects are also useful to directly link into sections (especially if they have the potential to grow to an article in future).


Redirects to redirects should be fixed by skipping intermediate targets. The page [[Special:DoubleRedirects]] can be used to detect them.
Redirects to redirects should be fixed by skipping intermediate targets. The page [[Special: DoubleRedirects]] can be used to detect them.


==== Smart redirect ====
==== Smart redirect ====
Line 50: Line 50:
==== Soft redirect ====
==== Soft redirect ====


This kind of redirect has been eliminated and '''should not be used any more'''. It was there for a historical reason only to overcome usability issues on wikispaces (the former wiki platform): editing redirects was restricted to administrators, so normal users could not expand a redirect page into a full article. (See also [https://yahootuninggroupsultimatebackup.github.io/tuning/topicId_101227.html http://groups.yahoo.com/neo/groups/tuning/conversations/topics/101227] for the discussion on the tuning list)
This kind of redirect has been eliminated and '''should not be used any more'''. It was there for a historical reason only to overcome usability issues on wikispaces (the former wiki platform): editing redirects was restricted to administrators, so normal users could not expand a redirect page into a full article. (See also [https://yahootuninggroupsultimatebackup.github.io/tuning/topicId_101227.html Yahoo! Tuning Group] for the discussion on the tuning list)


== Text formatting ==
== Text formatting ==
Line 62: Line 62:


=== Lists ===
=== Lists ===
:''See [[Help:List]] for advanced use cases.''
:''See [[Help: List]] for advanced use cases.''
There are tree basic types of lists in HTML that are supported in MediaWiki markup: [[#unordered|unordered]] (or "bulleted") lists, [[#numbered|numbered]] lists, [[#description|description]] lists. Each type of lists can be created within wiki source code by just indicating the items at the beginning of the line (the list is automatically built around them). Each item has to start on a new line.
There are tree basic types of lists in HTML that are supported in MediaWiki markup: [[#unordered|unordered]] (or "bulleted") lists, [[#numbered|numbered]] lists, [[#description|description]] lists. Each type of lists can be created within wiki source code by just indicating the items at the beginning of the line (the list is automatically built around them). Each item has to start on a new line.


Line 83: Line 83:


; Coffee
; Coffee
: a brewed drink prepared from roasted coffee beans. (from: ''[https://en.wikipedia.org/wiki/Coffee Coffee - Wikipedia''])
: a brewed drink prepared from roasted coffee beans. (from: ''[[Wikipedia: Coffee]])
; Wine
; Wine
: an alcoholic beverage made from fermented grapes. (from: ''[https://en.wikipedia.org/wiki/Wine Wine - Wikipedia]'')
: an alcoholic beverage made from fermented grapes. (from: ''[[Wikipedia: Wine]]'')
; Milk
; Milk
: a white liquid nutrient-rich food produced by the mammary glands of mammals. (from: ''[https://en.wikipedia.org/wiki/Milk Milk - Wikipedia]'')
: a white liquid nutrient-rich food produced by the mammary glands of mammals. (from: ''[[Wikipedia: Milk]]'')


==== Combined List Styles ====
==== Combined List Styles ====
Line 149: Line 149:


=== Images ===
=== Images ===
Inserting a JPEG, GIF, or PNG image is pretty straightforward - when using the visual page editor click the "File" button and upload the image. Or in Wikitext, use <code><nowiki>[[image:filename]]</nowiki></code> or <code><nowiki>[[file:filename]]</nowiki></code>. Also SVG images are supported (<code><nowiki>[[file:some.svg]]</nowiki></code>), they are automatically transformed into PNG images by the MediaWiki software, because not all Browsers come with native SVG support. A possible problem can arise when the image uses fonts that are not available on the wiki server. To prevent such errors, you can transform text into graphic objects before uploading the image here.
Inserting a JPEG, GIF, or PNG image is pretty straightforward when using the visual page editor click the "File" button and upload the image. Or in Wikitext, use <code><nowiki>[[image:filename]]</nowiki></code> or <code><nowiki>[[file:filename]]</nowiki></code>. Also SVG images are supported (<code><nowiki>[[file:some.svg]]</nowiki></code>), they are automatically transformed into PNG images by the MediaWiki software, because not all Browsers come with native SVG support. A possible problem can arise when the image uses fonts that are not available on the wiki server. To prevent such errors, you can transform text into graphic objects before uploading the image here.


=== Maths formulas ===
=== Maths formulas ===
...can be used [http://en.wikipedia.org/wiki/Help:Displaying_a_formula like in the Wikipedia]: start it with <code><nowiki><math></nowiki></code> and end it with <code><nowiki></math></nowiki></code>. Take care: using the math tags will break paragraphs. See for example
can be used {{w|Help:Displaying a formula|like in Wikipedia}}. For inline math, start it with <code><nowiki><math></nowiki></code> and end it with <code><nowiki></math></nowiki></code>. For example: <math>V =\frac{4}{3} \pi r^3</math>. For display-style math, open and close the formulas with both <code><nowiki>$$</nowiki></code>; this will render it centered in a new line.  


<math>V =\frac{4}{3} \pi r^3</math>
Here is a browser-based formula editor that may be helpful: [https://editor.codecogs.com/ Equation Editor]
 
Here is a browser-based formula editor that may be helpful: http://www.codecogs.com/latex/eqneditor.php


=== Table of contents ===
=== Table of contents ===
Line 179: Line 177:
=== Categories ===
=== Categories ===
Categories all serve different purposes: sometimes they say what something is or the context in which it belongs ([[:Category:Temperament]], [[:Category:Interval]]). Sometimes they are used for annotation purposes ([[:Category:Todo:add example]]), etc. All these forms have in common is that they can combine wiki pages in a way that is independent of their authors.
Categories all serve different purposes: sometimes they say what something is or the context in which it belongs ([[:Category:Temperament]], [[:Category:Interval]]). Sometimes they are used for annotation purposes ([[:Category:Todo:add example]]), etc. All these forms have in common is that they can combine wiki pages in a way that is independent of their authors.


A category may have its own content (and category)
A category may have its own content (and category)
:''see [https://en.xen.wiki/w/Special:AllPages?from=&to=&namespace=14 Pages in the namespace '''Category''']''
:''see [https://en.xen.wiki/w/Special:AllPages?from=&to=&namespace=14 Pages in the namespace '''Category''']''
or not yet (despite being used to categorize other pages):
or not yet (despite being used to categorize other pages):
:''see [[Special:WantedCategories]]''
:''see [[Special: WantedCategories]]''


Some more examples:
Some more examples:
Line 194: Line 191:
Discussion pages are provided to each content page. Please keep in mind that the email notification to people who are observing the page cannot be taken back!
Discussion pages are provided to each content page. Please keep in mind that the email notification to people who are observing the page cannot be taken back!


Sometimes you will wait forever for a reply because nobody monitors the page or topic. In this case you should find out who is most familiar with the topic and ask that person directly. You can check the history of pages for its authors. Another approach is to ask questions on further media, examples are listed on the page [[GeneralDiscussion]].
Sometimes you will wait forever for a reply because nobody monitors the page or topic. In this case you should find out who is most familiar with the topic and ask that person directly. You can check the history of pages for its authors. Another approach is to ask questions on further media, examples are listed on the page [[General discussion]].


== See also ==
== See also ==
* [[Help:Help|Help]]
* [[Help: Help]]
* [[Xenharmonic Wiki:Conventions|Conventions]]
* [[Xenharmonic Wiki: Conventions]]
* [[Xenharmonic Wiki:Article guidelines]]
* [[Xenharmonic Wiki: Article guidelines]]
* [[Help:Visual editor]] -- especially helpful for new users, that's way it's enabled by default
* [[Help: Visual editor]] especially helpful for new users, that's way it's enabled by default


[[Category:Help]]
[[Category:Help]]