Difference between revisions of "VideoLAN Wiki:Syntax"

From VideoLAN Wiki
Jump to navigation Jump to search
m (add page to Category:VideoLAN Wiki)
(Expand)
Line 1: Line 1:
:''See also: [[Documentation:EditingGuidelines]]''
+
{{See also|Documentation:EditingGuidelines}}
 
Please follow these guidelines when editing this wiki.<br />
 
Please follow these guidelines when editing this wiki.<br />
 
There will be more guidelines later.
 
There will be more guidelines later.
  
 
== 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 />
<!-- doesn't seem too informative
 
 
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]]
  
 
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 <code><nowiki><pre>...</pre></nowiki></code>:
 +
example text
  
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:Editing an extensive manual] are available at the English Wikipedia.<br />
+
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 />
 
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.
 
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.
  
 
== Important points ==
 
== Important points ==
* Single lines <u>are ignored by the software</u>. If you don't want text from one line to wrap to another, end it with <code><nowiki><br /></nowiki></code>
+
* Single lines <em>are ignored by the software</em>. If you don't want text from one line to wrap to another, end it with <code><nowiki><br /></nowiki></code>
 
* Signing your name on talk pages is considered good practice; it lets others know when and by whom comments are written. Use <nowiki>~~~~</nowiki> to insert your signature and the date.
 
* Signing your name on talk pages is considered good practice; it lets others know when and by whom comments are written. Use <nowiki>~~~~</nowiki> to insert your signature and the date.
  
Line 32: Line 51:
 
* Adding {{tl|Stub}} at the bottom of a page to show that it needs work
 
* 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|Check}} after something you think might be incorrect
* Adding {{tl|Outdated}} to the bottom of out-of-date pages (this is a new feature)
+
* Adding {{tl|Outdated}} to the bottom of out-of-date pages
 
+
* Adding {{tl|Image requested}} on the page needing better imagery
== Useful tidbits ==
 
* {{tl|VLC}} displays and links to {{VLC}}
 
* {{tl|VLC icon}} will insert the image {{VLC icon}}
 
* {{tl|VLC:latest version}} will show the latest version of VLC
 
* <code><nowiki><code>...</code></nowiki></code> will show text <code>like this</code>
 
* To show code as pre-formatted text, insert a blank space at the beginning of each line
 
  
 
== See also ==
 
== See also ==
 
* [//www.mediawiki.org/wiki/Help:Editing MediaWiki exhaustive reference guide]
 
* [//www.mediawiki.org/wiki/Help:Editing MediaWiki exhaustive reference guide]
* See the [[List of templates|Documented List of Templates]].
+
* See the [[VideoLAN Wiki:List of templates|Documented List of Templates]].
 
* See [[Special:PrefixIndex/Template:|all templates on {{SERVERNAME}}]]
 
* See [[Special:PrefixIndex/Template:|all templates on {{SERVERNAME}}]]
  
 
[[Category:VideoLAN Wiki]]
 
[[Category:VideoLAN Wiki]]

Revision as of 04:49, 13 February 2019

Please follow these guidelines when editing this wiki.
There will be more guidelines later.

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.comhttps://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

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

Important points

  • Single lines are ignored by the software. If you don't want text from one line to wrap to another, end it with <br />
  • Signing your name on talk pages is considered good practice; it lets others know when and by whom comments are written. Use ~~~~ to insert your signature and the date.

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