Help:Editing: Difference between revisions

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.

[https://wikiindex.org/Xenharmonic_Wiki This wiki] is currently in [https://wikiindex.org/Category:ConfirmEmail ConfirmEmail mode] after the move from Wikispaces to a MediaWiki-based installation (the edit mode may change again some time). For editing or adding information to the wiki, you have to join it. See [[Help:How to get your Xenharmonic Wiki account]] for more!

: ''Shortcut: [[Help: Links]]''

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

=== Internal links ===

If you enclose a word in double brackets (like <code><nowiki>[[word]]</nowiki></code>), you get an internal link, hopefully to an already existing page&mdash;if not, it appears red, and you just created the opportunity for your co-authors to add the details. If you want a text differing from the link target, you can place it after a pipe symbol: <code><nowiki>[[word|different text]]</nowiki></code>.

=== Linking to sections ===

You may link to sections in the same page by using the section title with the prefix <code>#</code>. MediaWiki automatically converts it into a link with the correct anchor identifier. For example to link to the beginning of this section use <code><nowiki>[[#Using links]]</nowiki></code> (rendered as [[#Using links]]) or with changed text <code><nowiki>[[#Using links|top of this section]]</nowiki></code> (rendered as [[#Using links|top of this section]]).

Links to some wikis are supported by placing a specific wiki alias and a colon (<code>:</code>) to the common in-wiki link syntax: <code><nowiki>[[otherwiki: name there]]</nowiki></code> as a prefix, for example, <code><nowiki>[[Wikipedia: Microtonal music]]</nowiki></code> gets rendered as [[Wikipedia: Microtonal music]]. Although this features is named "interwiki", is also includes some services that are definitively not wiki-like, for instance a google search can as well be embedded in wiki syntax: <code><nowiki>[[Google: 159edo]]</nowiki></code> (rendered as: [[Google: 159edo]]) The sites currently supported are managed in [[Special:Interwiki]]. A space after the prefix doesn't change the effect but looks better.

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].

=== Redirects ===

Redirects can be [[#Regular redirect|regular]] or [[#Smart redirect|"smart"]] (definition redirect).

==== Regular redirect ====

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

Redirects can be used to join alternative names (titles, ({{w|Headword|"lemmata"}}) for the same thing to reduce duplication.

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

==== Smart redirect ====

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

The <code><<nowiki />pre></code> tag also accepts styling, just like other HTML elements. Here, if you use the aformentioned <code>includeonly</code> directive, the styling should come after the directive:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

You can also copy some cells from a spreadsheet and paste them into the [[mw:Extension:VisualEditor|visual editor]], and a table will automatically be created. Though, users should be aware that the resulting Wiki markup generated by the visual editor is often poorly formatted (e.g. without spaces that would otherwise make it easier to read).

 

 

 

 

 

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.

 

 

 

 

 

 

For footnotes, the practice is similar. Insert the text in the note itself between <code><nowiki><ref group="note"></nowiki></code> and <code><nowiki></ref></nowiki></code> and insert <code><nowiki><references group="note" /></nowiki></code> where you wish to show them.

 

 

 

References can be reused throughout an article by giving then names. The first time this reference is used, type the full text of the note or reference between the tags (<code><nowiki><ref name="example1">Note 1</ref></nowiki></code>). If you want to reference <code>example1</code> multiple times in the same page, type <code><nowiki><ref name="example1" /></nowiki></code> on all subsequent instances.

 

* Articles should start with an introduction (summary, synopsis) that helps to get a basic understanding what it is about. Don't introduce another heading for the introduction – it's already provided by the h1 heading of the lemma itself.

* After this section (about one to five sentences), subheadings may follow to deepen the concept.

* After the last section (in wikitext: separated by an empty line) follow [[#categories|categories]] (in wikitext: each on a separate line).

 

 

'''Subpages''' are pages whose title contains one or more slashes ("/"). In general, every subpage includes a breadcrumb link at the top, allowing the reader to navigate to the parent page (and further if there are multiple levels of subpages). However, the subpage feature is disabled in the main namespace, mainly to prevent rational interval pages (e.g. [[3/2]]) from incorrectly including a breadcrumb link to a nonexistent page.

 

 

 

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

 

: ''See [https://en.xen.wiki/w/Special:AllPages?from=&to=&namespace=14 Pages in the namespace '''Category''']''

 

 

== Social aspects ==

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]].

=== Discussion ===

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 [[General discussion]].

== See also ==

* [[Help: Visual editor]] – especially helpful for new users, that's why it's enabled by default

[[Category:Help]]