Difference between revisions of "VideoLAN Wiki:Syntax"

From VideoLAN Wiki
Jump to navigation Jump to search
(various)
m (Change wikilinks, minor rewording)
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
:''See also: [[Documentation:EditingGuidelines]]''
+
__FORCETOC__
−
Please follow these guidelines when editing this wiki.<br>
+
{{See also|Documentation:EditingGuidelines}}
−
There will be more guidelines later.
+
Please sign your name on talk pages with four tildes: <code><nowiki>~~~~</nowiki></code>. It will automatically expand to your username and date.
  
 
== The basics ==
 
== The basics ==
−
:''Note: You can practice editing at the [[Sandbox|Sandbox page]] whenever you like.''
+
:''Note: You can practice editing at the [[Sandbox]] whenever you like.''
−
 
 
−
This wiki uses something called "wikimarkup", a way to include plain text on a page and modify how it looks. This is similar to both Wikipedia's markup and <abbr title="HyperText Markup Language">HTML</abbr>.<br>
 
  
 +
This wiki uses something called "wikimarkup", a way to include plain text on a page and modify how it looks. This is similar to both Wikipedia's markup and <abbr title="HyperText Markup Language">HTML</abbr>.<br />
 
Commands to modify plain text include:
 
Commands to modify plain text include:
−
* "tags" around words, for example <code><nowiki><big>example text</big></nowiki></code> to display <big>example text</big>
+
* "tags" around words, for example:
−
* "templates" (common snippets of formatting or often-used text), for example <nowiki>{{VLC}}</nowiki> to display {{VLC}}
+
*: <code><nowiki><big>example text</big></nowiki></code> → <big>example text</big>
−
* a particular way of linking to other pages and websites on the Internet
+
*: <code><nowiki><big><big>example text</big></big></nowiki></code> → <big><big>example text</big></big>
−
* a particular way of making things bold or italic
+
*: <code><nowiki><big><big><big>example text</big></big></big></nowiki></code> → <big><big><big>example text</big></big></big>
−
* a particular way of inserting images
+
*: <code><nowiki><small>example text</small></nowiki></code> → <small>example text</small>
 +
*: <code><nowiki><code>example text</code></nowiki></code> → <code>example text</code>
 +
* "templates" (common snippets of formatting or often-used text), for example:
 +
*: {{tl|VLC}} → {{VLC}}
 +
*: {{tl|VLC icon}} → {{VLC icon}}
 +
*: {{tl|VLC:latest version}} → {{VLC:latest version}}
 +
* a particular way of linking to other pages and websites on the Internet:
 +
*: <code><nowiki>[[Sandbox]]</nowiki></code> → [[Sandbox]]
 +
*: <code><nowiki>[[Sandbox|Sandbox page]]</nowiki></code> → [[Sandbox|Sandbox page]]
 +
*: <code><nowiki>https://example.com</nowiki></code> → https://example.com
 +
*: <code><nowiki>[https://example.com Example]</nowiki></code> → [https://example.com Example]
 +
*: <code><nowiki>[https://example.com]</nowiki></code> → [https://example.com]
 +
* a particular way of making things bold or italic:
 +
*: <code><nowiki>'''example text'''</nowiki></code> → '''example text'''
 +
*: <code><nowiki>''example text''</nowiki></code> → ''example text''
 +
*: <code><nowiki>'''''example text'''''</nowiki></code> → '''''example text'''''
 +
* a particular way of inserting images:
 +
*: <code><nowiki>[[File:VLC - icon.png]]</nowiki></code> → [[File:VLC - icon.png]]
 +
*: <code><nowiki>[[File:VLC - icon.png|16px]]</nowiki></code> → [[File:VLC - icon.png|16px]]
 +
Single lines <em>are ignored by the software</em>. To add a line break, use <code><nowiki><br /></nowiki></code> or enter two newlines in the wikitext.
  
 
Another important feature is the page layout:
 
Another important feature is the page layout:
−
* making lists
+
* making lists: simply start a line with *. For an indentation, use **.
−
* making tables
+
* making tables: better explained [//en.wikipedia.org/wiki/Help:Table at Wikipedia]
−
* using page headings to create sections
+
* using page headings to create sections: use pairs of equal signs around text, starting at two
 +
* To show code as pre-formatted text, insert a blank space at the beginning of each line or wrap in pre tags as <code><nowiki><pre>example text</pre></nowiki></code>:
 +
example text
  
−
=== If you have a minute... ===
+
If you have a minute, learn the basics of editing: a [//en.wikipedia.org/wiki/Wikipedia:Cheatsheet one-page summary] and [//en.wikipedia.org/wiki/Help:Wikitext an extensive manual] are available at the English Wikipedia.<br />
−
Begin by learning the basics. A [//en.wikipedia.org/wiki/Wikipedia:Cheatsheet one-page summary] and [//en.wikipedia.org/wiki/Help:Editing an extensive manual] are available at the English Wikipedia.
+
If you want to "dive right in", find the ''Edit Toolbar'' (directly above the edit box) and use the buttons and the dropdown help for assistance.
  
−
=== To start editing right away... ===
+
== Calling attention to pages ==
−
Find the Edit Toolbar directly above the edit box and use the buttons and the "Help" dropdown to guide you.
+
It's understood that a wiki will eventually become outdated, and needs to stay up-to-date. You can help by:
 +
* Adding {{tl|Dead link}} after a dead link
 +
* Adding {{tl|Stub}} at the bottom of a page to show that it needs work
 +
* Adding {{tl|Check}} after something you think might be incorrect
 +
* Adding {{tl|Outdated}} to the bottom of out-of-date pages
 +
* Adding {{tl|Image requested}} on the page needing better imagery
 +
See also the [[VideoLAN Wiki:List of templates]] for an visual listing of (most) of the templates ([[Special:PrefixIndex/Template:|full list]])
  
−
== Common conventions and best practices ==
+
== Further reading ==
−
* Many articles explain how to manipulate code within VLC. It is standard practice to visually separate large chunks of code from the body of the article in order to make it easier to read. You can do this in several ways:
+
* [//www.mediawiki.org/wiki/Help:Editing MediaWiki exhaustive reference guide]
−
** begin lines of code with a single space
 
−
** wrap the code in the tag <code><nowiki><pre>...</pre></nowiki></code>
 
−
** use the in-line tag <code><nowiki><code>...</code></nowiki></code>
 
−
 
 
−
* While making numbered lists, prefer list-making wikicode over manual lists; it makes managing large lists much easier
 
−
* Generally the best way to link to other websites is with descriptive text. Users don't know where links go (within the wiki, Wikipedia, or another site) until they click the link
 
−
* To end a line, use either <u>''two new lines''</u> (a single new line will be ignored) or the HTML entity <code><nowiki><br></nowiki></code>
 
−
* Avoid adding in-line notes such as <code>FIXME</code> or <code>BROKEN LINK</code> within articles—use the [[Help:Templates|templates]] {{tl|Check}} and {{tl|Dead link}} instead. This will add an in-text visual reminder and will automatically add the page to maintenance categories
 
−
* If a page is very short or needs work, place {{tl|Stub}} at either the top or bottom of the page (somewhere out-of-the-way but visible) to help draw attention and add it to [[:Category:Stubs]]
 
−
 
 
−
=== Remarks ===
 
−
Nota bene or NB means "important note". It's a Latin/Italian phrase that is used very often around the wiki to indicate how a page is to be interpreted, for instance, remarking that the page documents ''past'' conventions. Generally, read this before anything else on the page.
 
−
 
 
−
Most pages are written in loosely British English, rather than American English. Contribute in whatever style of English you feel comfortable writing in.
 
−
 
 
−
=== Useful things ===
 
−
* {{tl|VLC}} displays and links to {{VLC}}
 
−
* {{tl|VLC icon}} is a shorthand way to produce the image {{VLC icon}}
 
−
* {{tl|VLC:latest version}} will show the latest version of VLC
 
−
* {{tl|Font colour}}
 
−
 
 
−
=== Editing tips ===
 
−
* Use the editing toolbar to help you; it provides buttons to help you out.
 
−
* Keep things simple, and don't be afraid to make mistakes.
 
  
−
== See also ==
+
[[Category:VideoLAN Wiki]]
−
* [//www.mediawiki.org/wiki/Help:Editing MediaWiki exhaustive reference guide]
 
−
* See the [[List of templates|Documented List of Templates]].
 
−
* See [[Special:PrefixIndex/Template:|all templates on {{SERVERNAME}}]]
 

Latest revision as of 05:07, 13 February 2019

See also: Documentation:EditingGuidelines

Please sign your name on talk pages with four tildes: ~~~~. It will automatically expand to your username and date.

The basics

Note: You can practice editing at the Sandbox whenever you like.

This wiki uses something called "wikimarkup", a way to include plain text on a page and modify how it looks. This is similar to both Wikipedia's markup and HTML.
Commands to modify plain text include:

  • "tags" around words, for example:
    <big>example text</big> → example text
    <big><big>example text</big></big> → example text
    <big><big><big>example text</big></big></big> → example text
    <small>example text</small> → example text
    <code>example text</code> → example text
  • "templates" (common snippets of formatting or often-used text), for example:
    {{VLC}} → VLC media player
    {{VLC icon}} → LargeVLC.png
    {{VLC:latest version}} → 3.0.12
  • a particular way of linking to other pages and websites on the Internet:
    [[Sandbox]] → Sandbox
    [[Sandbox|Sandbox page]] → Sandbox page
    https://example.com → https://example.com
    [https://example.com Example] → Example
    [https://example.com] → [1]
  • a particular way of making things bold or italic:
    '''example text''' → example text
    ''example text'' → example text
    '''''example text''''' → example text
  • a particular way of inserting images:
    [[File:VLC - icon.png]] → VLC - icon.png
    [[File:VLC - icon.png|16px]] → VLC - icon.png

Single lines are ignored by the software. To add a line break, use <br /> or enter two newlines in the wikitext.

Another important feature is the page layout:

  • making lists: simply start a line with *. For an indentation, use **.
  • making tables: better explained at Wikipedia
  • using page headings to create sections: use pairs of equal signs around text, starting at two
  • To show code as pre-formatted text, insert a blank space at the beginning of each line or wrap in pre tags as <pre>example text</pre>:
example text

If you have a minute, learn the basics of editing: a one-page summary and an extensive manual are available at the English Wikipedia.
If you want to "dive right in", find the Edit Toolbar (directly above the edit box) and use the buttons and the dropdown help for assistance.

Calling attention to pages

It's understood that a wiki will eventually become outdated, and needs to stay up-to-date. You can help by:

  • Adding {{Dead link}} after a dead link
  • Adding {{Stub}} at the bottom of a page to show that it needs work
  • Adding {{Check}} after something you think might be incorrect
  • Adding {{Outdated}} to the bottom of out-of-date pages
  • Adding {{Image requested}} on the page needing better imagery

See also the VideoLAN Wiki:List of templates for an visual listing of (most) of the templates (full list)

Further reading

Retrieved from "https://wiki.videolan.org/index.php?title=VideoLAN_Wiki:Syntax&oldid=58000"