Help:Editing: Difference between revisions

Xenwolf (talk | contribs)
updated to current situation - at least tried to ;)
Line 3: Line 3:
Wikis should be easy to edit, so most text you add or change will appear as you expect it. But you can do more if you want.
Wikis should be easy to edit, so most text you add or change will appear as you expect it. But you can do more if you want.


This wiki is in [http://wikiindex.org/Category:OpenEdit open-edit mode] (except during phases of spam or vandalism). If you want your name (or nick) to appear in the histories, you should create a Xenwiki account and join this wiki. (see [[How_to_Get_Your_Xenwiki_Account|How to Get Your Xenwiki Account]])
This wiki is currently in [https://wikiindex.org/Category:LoginToEdit login-to-edit mode] after the move from [[Wikispaces]] to MediaWiki-based installation (the edit mode may change again some time). For editing or adding information to the wiki, you have to join the wiki. See [[How to Get Your Xenwiki Account]] for more!


==Using links==
== Using 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 12: Line 12:
For external links, simply place the URL into the text, certain protocols (http, https, mailto) will be automatically transformed into links. For alternate text, use single brackets, start with the URL and after a space enter the title, like so <code><nowiki>[http://acid3.acidtests.org the Acid3 test]</nowiki></code> which renders to [http://acid3.acidtests.org the Acid3 test].
For external links, simply place the URL into the text, certain protocols (http, https, mailto) will be automatically transformed into links. For alternate text, use single brackets, start with the URL and after a space enter the title, like so <code><nowiki>[http://acid3.acidtests.org the Acid3 test]</nowiki></code> which renders to [http://acid3.acidtests.org the Acid3 test].


===Link text===
=== Link text ===
''tbd''
''tbd''


The link text should relate to the link target, don't use "[[help:here-links|here]]".
The link text should relate to the link target, don't use "[[help:here-links|here]]".


===Redirects===
=== Redirects ===
There are 3 types of redirects: soft redirect, regular redirect and hard redirect.  
There are 3 types of redirects: soft redirect, regular redirect and hard redirect.  


Line 28: Line 28:
see also
see also


<ul><li>http://groups.yahoo.com/neo/groups/tuning/conversations/topics/101227 - under discussion on the [[tuning_list|tuning list]]</li><li>[[:Category:soft redirect|list of pages tagged as soft redirect]] - pages that contain only see <tt>[[</tt><nowiki>''some other page''</nowiki><tt>]]</tt> (be cautious with other tags on these)</li><li>[[:Category:smart redirect|list of pages tagged as smart redirect]] - pages that have more information (a small definition, classification etc.)</li></ul>
* http://groups.yahoo.com/neo/groups/tuning/conversations/topics/101227 - redirects were discussed on the [[tuning_list|tuning list]] in the [[Wikispaces]] era
* [[:Category:soft redirect|list of pages tagged as soft redirect]] - pages that contain only see <tt>[[</tt><nowiki>''some other page''</nowiki><tt>]]</tt> (be cautious with other tags on these)
* [[:Category:smart redirect|list of pages tagged as smart redirect]] - pages that have more information (a small definition, classification etc.)


==Page layout==
== Text formatting ==


===Emphasis===
=== Emphasis ===
Some typographic markup can easy be added by including the phrase in doubled '' (apostrophe) or ''' (apostrophe) chars:
Some typographic markup can easy be added by including the phrase in doubled <code>''</code> or tripled <code>'''</code> (apostrophe chars):


<ul><li>''italic'' using <nowiki>''italic''</nowiki></li><li>'''bold''' using <nowiki>'''bold'''</nowiki></li><li>'''''bold italic''''' using <nowiki>'''''bold italic'''''</nowiki></li></ul>
* ''italic'' using <nowiki>''italic''</nowiki>
* '''bold''' using <nowiki>'''bold'''</nowiki>
* '''''bold italic''''' using <nowiki>'''''bold italic'''''</nowiki>


===Lists===
=== Lists ===


You can create bulleted lists by one or more * (asterisk) chars at the beginning of the line:
You can create bulleted lists by one or more <code>*</code> (asterisk) chars at the beginning of the line:


<ul><li>first level<ul><li>second level</li><li>second level</li></ul></li><li>first level</li></ul>
* first level
** second level
** second level
* first level


You can create numbered lists by one or more # (number sign) at the beginning of the line:
You can create numbered lists by one or more <code>#</code> (number sign) at the beginning of the line:


<ol><li>first level<ol><li>second level</li><li>second level</li></ol></li><li>first level</li></ol>
# first level
## second level
## second level
# first level


...and you can of course mix both, if you know what you're doing ;)
...and you can of course mix both, if you know what you're doing ;)


<ol><li>first level<ul><li>second level</li></ul><ol><li>second level</li></ol></li></ol><ul><li>first level</li></ul>
# first level
#* second level
#* second level
# first level


===Tables===
=== Tables ===
You can add tables with wikitable:
You can add tables to wiki pages:
{| class="wikitable"
! what you write
|
<nowiki>
{| class="wikitable"
|+ The Title
! column A
! column B
|-
| cell A1
| cell B1
|-
| cell A2
| cell B2
|}</nowiki>
|-
! what you get
|
{| class="wikitable"
|+ The Title
! column A
! column B
|-
| cell A1
| cell B1
|-
| cell A2
| cell B2
|}
|}
 
The table cells are left aligned by default, the heading cells are center aligned. You may change this via inline CSS style definitions:


{| class="wikitable"
{| class="wikitable"
! what you want for the cell
! what you do to get it
|-
|-
! | what you want for the cell
| left aligned text
! | what you do to get it
| nothing to do
|-
| | left aligned text
| | nothing to do
|-
|-
| style="text-align:center;" | centered text
| style="text-align:center;" | centered text
| | equals sign (=) immediately after the opening double pipe
| place <code><nowiki>style="text-align:center;" |</nowiki></code> after the opening pipe
|-
|-
| style="text-align:right;" | right aligned
| style="text-align:right;" | right aligned
| | greater-than sign (&gt;) immediately after the opening double pipe
| place <code><nowiki>style="text-align:center;" |</nowiki></code> after the opening pipe
|-
|-
! | headline style
! headline style
| | title (~) immediately after the opening double pipe
| exclamation mark instead of the pipe symbol starts the cell
|}
|}


===Images===
=== Images ===
Inserting a JPEG or PNG image is pretty straightforward - when using the visual page editor click the "File" button and upload the image. Or in Wikitext, use <tt>[[image:filename]]</tt>. SVG images are possible but require a bit more work; see [[SVG_images_on_wiki_pages|SVG images on wiki pages]] for details.
Inserting a JPEG 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>. SVG images are possible but require a bit more work; see [[SVG_images_on_wiki_pages|SVG images on wiki pages]] for details.


===Maths formulas===
=== Maths formulas ===
...can be used [http://en.wikipedia.org/wiki/Help:Displaying_a_formula like in the Wikipedia] but the enclosing tags (<tt>[[math]]</tt> - the same for begin and end) differ. Take care: using the math tags you'll break paragraphs.
...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


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


===Table of contents===
=== Table of contents ===
Place <tt>[[toc]]</tt> on top of the page, or - if you prefer flat tocs - use <tt>[[toc|flat]]</tt>
Place <code><nowiki>__TOC__</nowiki></code> where you wish to place the table of contents, mostly this will be at the top of the page.
 
''Note: when using flat tocs, a horizontal ruler <tt>----</tt> and an empty line may improve the layout.''


==Social aspects==
== Social aspects ==
In Wikispaces wikis, you can use tags and discussions. In MediaWiki we instead have categories and talk pages.
In this wiki, you can use talk pages and user talk pages.  


If you want to discuss the wiki itself, do it on the page [[wikifuture|wikifuture]].
If you want to discuss the wiki itself, do it on the page [[wikifuture]].


===Categories===
=== Categories ===
Categories all serve different purposes: sometimes they say what something is or the context in which it belongs ([[tag/view/edo|edo]], [[tag/view/interval|interval]]). Sometimes they are used for annotation purposes ([[tag/view/todo:reduce_mathslang|todo:reduce mathslang]]), 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 ([[tag/view/edo|edo]], [[tag/view/interval|interval]]). Sometimes they are used for annotation purposes ([[tag/view/todo:reduce_mathslang|todo:reduce mathslang]]), etc. All these forms have in common is that they can combine wiki pages in a way that is independent of their authors.


Line 101: Line 143:
<ul><li><span style="text-decoration: line-through;">[[tag/view/orphan_page|orphan page]]</span> - pages without ingoing links -&gt; [[space/pagelist/orphaned|http://xenharmonic.wikispaces.com/space/pagelist/orphaned]]</li><li>[[tag/view/todo:add_definition|todo:add definition]] - here a term needs to be defined</li></ul>
<ul><li><span style="text-decoration: line-through;">[[tag/view/orphan_page|orphan page]]</span> - pages without ingoing links -&gt; [[space/pagelist/orphaned|http://xenharmonic.wikispaces.com/space/pagelist/orphaned]]</li><li>[[tag/view/todo:add_definition|todo:add definition]] - here a term needs to be defined</li></ul>


===Discussion===
=== Discussion ===
Discussion pages are provided to each content page. Sadly there is no preview function on this wiki, but if you create something entirely wrong, you can delete your post. Please keep in mind that the email notification to people who are monitoring the topic or wiki 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|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 [[GeneralDiscussion]].


==Links==
== Links ==
<ul><li>[http://help.wikispaces.com/home http://help.wikispaces.com]</li><li>http://help.wikispaces.com/Wikitext</li><li>[http://help.wikispaces.com/Editing_a_Page http://help.wikispaces.com/Editing+a+Page]</li><li>[http://help.wikispaces.com/Wikitext-Contents_of_Another_Wiki_Page-Supported_includes http://help.wikispaces.com/Wikitext#Contents%20of%20Another%20Wiki%20Page-Supported%20includes] - page contents can also be included into pages</li><li>[http://helpcenter.wikispaces.com/customer/en/portal/topics/768797-miscellaneous/articles Wikispaces | Miscellaneous]</li></ul>
* [[Halp:Help]]
* [[Conventions]]


==See also==
<ul><li>[[WebDAV_Help|WebDAV Help]]</li></ul>     
[[Category:help]]
[[Category:help]]
[[Category:syntax]]
[[Category:syntax]]
[[Category:wiki_help]]
[[Category:wiki help]]