Help:Editing

From Xenharmonic Wiki
Revision as of 14:57, 18 August 2011 by Wikispaces>keenanpepper (**Imported revision 246769083 - Original comment: **)
Jump to navigation Jump to search

IMPORTED REVISION FROM WIKISPACES

This is an imported revision from Wikispaces. The revision metadata is included below for reference:

This revision was by author keenanpepper and made on 2011-08-18 14:57:54 UTC.
The original revision id was 246769083.
The revision comment was:

The revision contents are below, presented both in the original Wikispaces Wikitext format, and in HTML exactly as Wikispaces rendered it.

Original Wikitext content:

[[toc]]
Wikis should be easy to edit, so the 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 wikispaces accout and join this wiki. (see [[How to Get Your Xenwiki Account]])

==Using links== 
What you always have dreamed of (for your paper notes) - in a wiki it becomes true: fast links!

If you enclose a word in double brackets (like {{``[[word]]``}}), you get a link, hopefully to an already existing page - if not, you just created the opportunity fo your co-authors do add the detais. If you want a text differing from the link target, you can place it after a pipe symbol {{``[[word|different text]]``}}. The same syntax can be used for external links like {{``[[http://en.wikipedia.org|English Wikipedia]]``}} for a link to the [[http://en.wikipedia.org|English Wikipedia]].

===Link text=== 
//tbd//
The link text should relate to the link target, dont use "here".

===Redirects=== 
Real or "hard" redirects can only be made or edited by administrators of the wiki, and a hard redirect cannot link to a specific section of another article. Therefore, they should only be used in the case of simple misspellings or alternate spellings. The rule is that if anyone might ever want to flesh the redirect out into its own article, it should not be a hard redirect.

For all other cases, create a "smart redirect". This is just an ordinary page with the text "See XYZ.", where XYZ is a link to the target of the smart redirect.

A smart redirect should not point to another smart redirect - if you see this you should fix it by shortcutting past the second one and making the first redirect point directly to the ultimate target.

(However, hard redirects can be chained with no problem, which is why they're still appropriate to use for misspellings.)

see also
* http://launch.groups.yahoo.com/group/tuning/message/101227 - under discussion on the [[tuning list]]
* http://xenharmonic.wikispaces.com/tag/view/smart+redirect - list of smart redirects (they use the tag "smart redirect")

==Page layout== 
===Emphasis=== 
Some typographic markup can easy be added by including the phrase in doubled * (asterisk) or / (slash) chars:
* //italic// using {{``//italic//``}}
* **bold** using {{``**bold**``}}
* **//bold italic//** using {{``**//bold italic//**``}}
* or //**italic bold**// using {{``//**italic bold**//``}}

===Lists=== 
You can create bulleted lists by one or more * (asterisk) chars at the beginning of the line:
* 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:
# first level
## second level
## second level
# first level

...and you can of course mix both, if you know what you're doing ;)
# first level
** second level
## second level
* first level


===Tables=== 
You can add tables with doubled | (pipe) chars:

||~ what you want for the cell ||~ what you do to get it ||
|| left aligned text || nothing to do ||
||= centered text || equals sign (=) immediately after the opening double pipe ||
||> right aligned || greater-than sign (>) immediately after the opening double pipe ||
||~ headline style || title (~) immediately after the opening double pipe ||

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

[[math]]
V =\frac{4}{3} \pi r^3
[[math]]

===Table of contents=== 
Place {{``[[toc]]``}} on top of the page, or - ifyou prefer flat tocs - use {{``[[toc|flat]]``}}

==Social aspects== 
In wikispaces wikis, you can use tags and discussions.
If you want to discuss the wiki itself, do it on the page [[wikifuture]].

===Tags=== 
Tags all serve different purposes: sometimes they say what something is or the context in which it belongs ([[http://xenharmonic.wikispaces.com/tag/view/edo|edo]], [[http://xenharmonic.wikispaces.com/tag/view/interval|interval]]). Sometimes they are used for annotation purposes ([[http://xenharmonic.wikispaces.com/tag/view/todo%3Areduce+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.

You can look at the [[http://xenharmonic.wikispaces.com/tag/list|list of used tags]] or link to particular tags using the prefix [[nowiki:http://xenharmonic.wikispaces.com/tag/view/]]

===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!

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 him 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== 
* http://help.wikispaces.com/Wikitext
* http://help.wikispaces.com/Editing+a+Page
* http://help.wikispaces.com
* http://help.wikispaces.com/Wikitext#Contents%20of%20Another%20Wiki%20Page-Supported%20includes - page contents can also be included into pages

Original HTML content:

<html><head><title>wiki help</title></head><body><!-- ws:start:WikiTextTocRule:37:&lt;img id=&quot;wikitext@@toc@@normal&quot; class=&quot;WikiMedia WikiMediaToc&quot; title=&quot;Table of Contents&quot; src=&quot;/site/embedthumbnail/toc/normal?w=225&amp;h=100&quot;/&gt; --><div id="toc"><h1 class="nopad">Table of Contents</h1><!-- ws:end:WikiTextTocRule:37 --><!-- ws:start:WikiTextTocRule:38: --><div style="margin-left: 2em;"><a href="#x-Using links">Using links</a></div>
<!-- ws:end:WikiTextTocRule:38 --><!-- ws:start:WikiTextTocRule:39: --><div style="margin-left: 3em;"><a href="#x-Using links-Link text">Link text</a></div>
<!-- ws:end:WikiTextTocRule:39 --><!-- ws:start:WikiTextTocRule:40: --><div style="margin-left: 3em;"><a href="#x-Using links-Redirects">Redirects</a></div>
<!-- ws:end:WikiTextTocRule:40 --><!-- ws:start:WikiTextTocRule:41: --><div style="margin-left: 2em;"><a href="#x-Page layout">Page layout</a></div>
<!-- ws:end:WikiTextTocRule:41 --><!-- ws:start:WikiTextTocRule:42: --><div style="margin-left: 3em;"><a href="#x-Page layout-Emphasis">Emphasis</a></div>
<!-- ws:end:WikiTextTocRule:42 --><!-- ws:start:WikiTextTocRule:43: --><div style="margin-left: 3em;"><a href="#x-Page layout-Lists">Lists</a></div>
<!-- ws:end:WikiTextTocRule:43 --><!-- ws:start:WikiTextTocRule:44: --><div style="margin-left: 3em;"><a href="#x-Page layout-Tables">Tables</a></div>
<!-- ws:end:WikiTextTocRule:44 --><!-- ws:start:WikiTextTocRule:45: --><div style="margin-left: 3em;"><a href="#x-Page layout-Maths formulas">Maths formulas</a></div>
<!-- ws:end:WikiTextTocRule:45 --><!-- ws:start:WikiTextTocRule:46: --><div style="margin-left: 3em;"><a href="#x-Page layout-Table of contents">Table of contents</a></div>
<!-- ws:end:WikiTextTocRule:46 --><!-- ws:start:WikiTextTocRule:47: --><div style="margin-left: 2em;"><a href="#x-Social aspects">Social aspects</a></div>
<!-- ws:end:WikiTextTocRule:47 --><!-- ws:start:WikiTextTocRule:48: --><div style="margin-left: 3em;"><a href="#x-Social aspects-Tags">Tags</a></div>
<!-- ws:end:WikiTextTocRule:48 --><!-- ws:start:WikiTextTocRule:49: --><div style="margin-left: 3em;"><a href="#x-Social aspects-Discussion">Discussion</a></div>
<!-- ws:end:WikiTextTocRule:49 --><!-- ws:start:WikiTextTocRule:50: --><div style="margin-left: 2em;"><a href="#x-Links">Links</a></div>
<!-- ws:end:WikiTextTocRule:50 --><!-- ws:start:WikiTextTocRule:51: --></div>
<!-- ws:end:WikiTextTocRule:51 -->Wikis should be easy to edit, so the most text you add or change will appear as you expect it. But you can do more if you want.<br />
<br />
This wiki is in <a class="wiki_link_ext" href="http://wikiindex.org/Category:OpenEdit" rel="nofollow">open-edit mode</a> (except during phases of spam or vandalism). If you want your name (or nick) to appear in the histories, you should create a wikispaces accout and join this wiki. (see <a class="wiki_link" href="/How%20to%20Get%20Your%20Xenwiki%20Account">How to Get Your Xenwiki Account</a>)<br />
<br />
<!-- ws:start:WikiTextHeadingRule:11:&lt;h2&gt; --><h2 id="toc0"><a name="x-Using links"></a><!-- ws:end:WikiTextHeadingRule:11 -->Using links</h2>
 What you always have dreamed of (for your paper notes) - in a wiki it becomes true: fast links!<br />
<br />
If you enclose a word in double brackets (like <tt><!-- ws:start:WikiTextRawRule:00:``[[word]]`` -->[[word]]<!-- ws:end:WikiTextRawRule:00 --></tt>), you get a link, hopefully to an already existing page - if not, you just created the opportunity fo your co-authors do add the detais. If you want a text differing from the link target, you can place it after a pipe symbol <tt><!-- ws:start:WikiTextRawRule:01:``[[word|different text]]`` -->[[word|different text]]<!-- ws:end:WikiTextRawRule:01 --></tt>. The same syntax can be used for external links like <tt><!-- ws:start:WikiTextRawRule:02:``[[http://en.wikipedia.org|English Wikipedia]]`` -->[[http://en.wikipedia.org|English Wikipedia]]<!-- ws:end:WikiTextRawRule:02 --></tt> for a link to the <a class="wiki_link_ext" href="http://en.wikipedia.org" rel="nofollow">English Wikipedia</a>.<br />
<br />
<!-- ws:start:WikiTextHeadingRule:13:&lt;h3&gt; --><h3 id="toc1"><a name="x-Using links-Link text"></a><!-- ws:end:WikiTextHeadingRule:13 -->Link text</h3>
 <em>tbd</em><br />
The link text should relate to the link target, dont use &quot;here&quot;.<br />
<br />
<!-- ws:start:WikiTextHeadingRule:15:&lt;h3&gt; --><h3 id="toc2"><a name="x-Using links-Redirects"></a><!-- ws:end:WikiTextHeadingRule:15 -->Redirects</h3>
 Real or &quot;hard&quot; redirects can only be made or edited by administrators of the wiki, and a hard redirect cannot link to a specific section of another article. Therefore, they should only be used in the case of simple misspellings or alternate spellings. The rule is that if anyone might ever want to flesh the redirect out into its own article, it should not be a hard redirect.<br />
<br />
For all other cases, create a &quot;smart redirect&quot;. This is just an ordinary page with the text &quot;See XYZ.&quot;, where XYZ is a link to the target of the smart redirect.<br />
<br />
A smart redirect should not point to another smart redirect - if you see this you should fix it by shortcutting past the second one and making the first redirect point directly to the ultimate target.<br />
<br />
(However, hard redirects can be chained with no problem, which is why they're still appropriate to use for misspellings.)<br />
<br />
see also<br />
<ul><li><!-- ws:start:WikiTextUrlRule:221:http://launch.groups.yahoo.com/group/tuning/message/101227 --><a class="wiki_link_ext" href="http://launch.groups.yahoo.com/group/tuning/message/101227" rel="nofollow">http://launch.groups.yahoo.com/group/tuning/message/101227</a><!-- ws:end:WikiTextUrlRule:221 --> - under discussion on the <a class="wiki_link" href="/tuning%20list">tuning list</a></li><li><!-- ws:start:WikiTextUrlRule:222:http://xenharmonic.wikispaces.com/tag/view/smart+redirect --><a class="wiki_link_ext" href="http://xenharmonic.wikispaces.com/tag/view/smart+redirect" rel="nofollow">http://xenharmonic.wikispaces.com/tag/view/smart+redirect</a><!-- ws:end:WikiTextUrlRule:222 --> - list of smart redirects (they use the tag &quot;smart redirect&quot;)</li></ul><br />
<!-- ws:start:WikiTextHeadingRule:17:&lt;h2&gt; --><h2 id="toc3"><a name="x-Page layout"></a><!-- ws:end:WikiTextHeadingRule:17 -->Page layout</h2>
 <!-- ws:start:WikiTextHeadingRule:19:&lt;h3&gt; --><h3 id="toc4"><a name="x-Page layout-Emphasis"></a><!-- ws:end:WikiTextHeadingRule:19 -->Emphasis</h3>
 Some typographic markup can easy be added by including the phrase in doubled * (asterisk) or / (slash) chars:<br />
<ul><li><em>italic</em> using <tt><!-- ws:start:WikiTextRawRule:03:``//italic//`` -->//italic//<!-- ws:end:WikiTextRawRule:03 --></tt></li><li><strong>bold</strong> using <tt><!-- ws:start:WikiTextRawRule:04:``**bold**`` -->**bold**<!-- ws:end:WikiTextRawRule:04 --></tt></li><li><strong><em>bold italic</em></strong> using <tt><!-- ws:start:WikiTextRawRule:05:``**//bold italic//**`` -->**//bold italic//**<!-- ws:end:WikiTextRawRule:05 --></tt></li><li>or <em><strong>italic bold</strong></em> using <tt><!-- ws:start:WikiTextRawRule:06:``//**italic bold**//`` -->//**italic bold**//<!-- ws:end:WikiTextRawRule:06 --></tt></li></ul><br />
<!-- ws:start:WikiTextHeadingRule:21:&lt;h3&gt; --><h3 id="toc5"><a name="x-Page layout-Lists"></a><!-- ws:end:WikiTextHeadingRule:21 -->Lists</h3>
 You can create bulleted lists by one or more * (asterisk) chars at the beginning of the line:<br />
<ul><li>first level<ul><li>second level</li><li>second level</li></ul></li><li>first level</li></ul><br />
You can create numbered lists by one or more # (number sign) at the beginning of the line:<br />
<ol><li>first level<ol><li>second level</li><li>second level</li></ol></li><li>first level</li></ol><br />
...and you can of course mix both, if you know what you're doing ;)<br />
<ol><li>first level<ul><li>second level</li></ul><ol><li>second level</li></ol></li></ol><ul><li>first level</li></ul><br />
<br />
<!-- ws:start:WikiTextHeadingRule:23:&lt;h3&gt; --><h3 id="toc6"><a name="x-Page layout-Tables"></a><!-- ws:end:WikiTextHeadingRule:23 -->Tables</h3>
 You can add tables with doubled | (pipe) chars:<br />
<br />


<table class="wiki_table">
    <tr>
        <th>what you want for the cell<br />
</th>
        <th>what you do to get it<br />
</th>
    </tr>
    <tr>
        <td>left aligned text<br />
</td>
        <td>nothing to do<br />
</td>
    </tr>
    <tr>
        <td style="text-align: center;">centered text<br />
</td>
        <td>equals sign (=) immediately after the opening double pipe<br />
</td>
    </tr>
    <tr>
        <td style="text-align: right;">right aligned<br />
</td>
        <td>greater-than sign (&gt;) immediately after the opening double pipe<br />
</td>
    </tr>
    <tr>
        <th>headline style<br />
</th>
        <td>title (~) immediately after the opening double pipe<br />
</td>
    </tr>
</table>

<br />
<!-- ws:start:WikiTextHeadingRule:25:&lt;h3&gt; --><h3 id="toc7"><a name="x-Page layout-Maths formulas"></a><!-- ws:end:WikiTextHeadingRule:25 -->Maths formulas</h3>
 ...can be used <a class="wiki_link_ext" href="http://en.wikipedia.org/wiki/Help:Displaying_a_formula" rel="nofollow">like in the Wikipedia</a> but the enclosing tags (<tt><!-- ws:start:WikiTextRawRule:07:``[[math]]`` -->[[math]]<!-- ws:end:WikiTextRawRule:07 --></tt> - the same for begin and end) differ. Take care: using the math tags you'll break paragraphs.<br />
<br />
<!-- ws:start:WikiTextMathRule:10:
[[math]]&lt;br/&gt;
V =\frac{4}{3} \pi r^3&lt;br/&gt;[[math]]
 --><script type="math/tex">V =\frac{4}{3} \pi r^3</script><!-- ws:end:WikiTextMathRule:10 --><br />
<br />
<!-- ws:start:WikiTextHeadingRule:27:&lt;h3&gt; --><h3 id="toc8"><a name="x-Page layout-Table of contents"></a><!-- ws:end:WikiTextHeadingRule:27 -->Table of contents</h3>
 Place <tt><!-- ws:start:WikiTextRawRule:08:``[[toc]]`` -->[[toc]]<!-- ws:end:WikiTextRawRule:08 --></tt> on top of the page, or - ifyou prefer flat tocs - use <tt><!-- ws:start:WikiTextRawRule:09:``[[toc|flat]]`` -->[[toc|flat]]<!-- ws:end:WikiTextRawRule:09 --></tt><br />
<br />
<!-- ws:start:WikiTextHeadingRule:29:&lt;h2&gt; --><h2 id="toc9"><a name="x-Social aspects"></a><!-- ws:end:WikiTextHeadingRule:29 -->Social aspects</h2>
 In wikispaces wikis, you can use tags and discussions.<br />
If you want to discuss the wiki itself, do it on the page <a class="wiki_link" href="/wikifuture">wikifuture</a>.<br />
<br />
<!-- ws:start:WikiTextHeadingRule:31:&lt;h3&gt; --><h3 id="toc10"><a name="x-Social aspects-Tags"></a><!-- ws:end:WikiTextHeadingRule:31 -->Tags</h3>
 Tags all serve different purposes: sometimes they say what something is or the context in which it belongs (<a class="wiki_link_ext" href="http://xenharmonic.wikispaces.com/tag/view/edo" rel="nofollow">edo</a>, <a class="wiki_link_ext" href="http://xenharmonic.wikispaces.com/tag/view/interval" rel="nofollow">interval</a>). Sometimes they are used for annotation purposes (<a class="wiki_link_ext" href="http://xenharmonic.wikispaces.com/tag/view/todo%3Areduce+mathslang" rel="nofollow">todo:reduce mathslang</a>), etc. All these forms have in common is that they can combine wiki pages in a way that is independent of their authors.<br />
<br />
You can look at the <a class="wiki_link_ext" href="http://xenharmonic.wikispaces.com/tag/list" rel="nofollow">list of used tags</a> or link to particular tags using the prefix [[nowiki:<!-- ws:start:WikiTextUrlRule:223:http://xenharmonic.wikispaces.com/tag/view/ --><a class="wiki_link_ext" href="http://xenharmonic.wikispaces.com/tag/view/" rel="nofollow">http://xenharmonic.wikispaces.com/tag/view/</a><!-- ws:end:WikiTextUrlRule:223 -->]]<br />
<br />
<!-- ws:start:WikiTextHeadingRule:33:&lt;h3&gt; --><h3 id="toc11"><a name="x-Social aspects-Discussion"></a><!-- ws:end:WikiTextHeadingRule:33 -->Discussion</h3>
 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!<br />
<br />
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 him 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 <a class="wiki_link" href="/GeneralDiscussion">GeneralDiscussion</a>.<br />
<br />
<!-- ws:start:WikiTextHeadingRule:35:&lt;h2&gt; --><h2 id="toc12"><a name="x-Links"></a><!-- ws:end:WikiTextHeadingRule:35 -->Links</h2>
 <ul><li><!-- ws:start:WikiTextUrlRule:224:http://help.wikispaces.com/Wikitext --><a href="http://help.wikispaces.com/Wikitext">http://help.wikispaces.com/Wikitext</a><!-- ws:end:WikiTextUrlRule:224 --></li><li><!-- ws:start:WikiTextUrlRule:225:http://help.wikispaces.com/Editing+a+Page --><a href="http://help.wikispaces.com/Editing+a+Page">http://help.wikispaces.com/Editing+a+Page</a><!-- ws:end:WikiTextUrlRule:225 --></li><li><!-- ws:start:WikiTextUrlRule:226:http://help.wikispaces.com --><a href="http://help.wikispaces.com">http://help.wikispaces.com</a><!-- ws:end:WikiTextUrlRule:226 --></li><li><!-- ws:start:WikiTextUrlRule:227:http://help.wikispaces.com/Wikitext#Contents%20of%20Another%20Wiki%20Page-Supported%20includes --><a href="http://help.wikispaces.com/Wikitext#Contents%20of%20Another%20Wiki%20Page-Supported%20includes">http://help.wikispaces.com/Wikitext#Contents%20of%20Another%20Wiki%20Page-Supported%20includes</a><!-- ws:end:WikiTextUrlRule:227 --> - page contents can also be included into pages</li></ul></body></html>