Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
wiki:syntax [2012/01/04 13:44] – [RSS/ATOM Feed Aggregation] nickwiki:syntax [2019/11/11 09:18] (current) – [Footnotes] kevinbowen
Line 1: Line 1:
 ====== Formatting Syntax ====== ====== Formatting Syntax ======
- 
 [[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing the //Edit this page// button at the top or bottom of the page. If you want to try something, just use the [[playground:playground|playground]] page. The simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too. [[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing the //Edit this page// button at the top or bottom of the page. If you want to try something, just use the [[playground:playground|playground]] page. The simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.
 +
 +  * **[[syntax#Basic Text Formatting|Basic Text Formatting]]**
 +  * **[[syntax#Links|Links]]**
 +  * **[[syntax#Image Links|Image Links]]**
 +  * **[[syntax#Sectioning|Sectioning]]**
 +  * **[[syntax#Images and Other Files|Images and Other Files]]**
 +  * **[[syntax#Lists|Lists]]**
 +  * **[[syntax#Text Conversions|Text Conversions]]**
 +  * **[[syntax#Quoting|Quoting]]**
 +  * **[[syntax#Tables|Tables]]**
 +  * **[[syntax#No Formatting|No Formatting]]**
 +  * **[[syntax#Code Blocks|Code Blocks]]**
 +  * **[[syntax#Downloadable Code Blocks|Downloadable Code Blocks]]**
 +  * **[[syntax#Notes|Notes]]**
 +  * **[[syntax#GUI Sequences|Gui Sequences]]**
 +  * **[[syntax#Figures|Figures]]**
 +  * **[[syntax#Definition Lists|Definition Lists]]**
 +
 +----
 +
  
 ===== Basic Text Formatting ===== ===== Basic Text Formatting =====
Line 29: Line 48:
  
 You should use forced newlines only if really needed. You should use forced newlines only if really needed.
 +
 +----
  
 ===== Links ===== ===== Links =====
Line 99: Line 120:
  
 The whole [[#images_and_other_files|image]] and [[#links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links). The whole [[#images_and_other_files|image]] and [[#links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links).
 +
 +[[|Back To Top]]
 +----
  
 ===== Footnotes ===== ===== Footnotes =====
Line 106: Line 130:
   You can add footnotes ((This is a footnote)) by using double parentheses.   You can add footnotes ((This is a footnote)) by using double parentheses.
  
 +----
 ===== Sectioning ===== ===== Sectioning =====
  
Line 132: Line 157:
 Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)): {{wiki:dokuwiki-128.png?200x50}} Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)): {{wiki:dokuwiki-128.png?200x50}}
  
-Resized external image:           {{http://de3.php.net/images/php.gif?200x50}}+Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
  
   Real size:                        {{wiki:dokuwiki-128.png}}   Real size:                        {{wiki:dokuwiki-128.png}}
   Resize to given width:            {{wiki:dokuwiki-128.png?50}}   Resize to given width:            {{wiki:dokuwiki-128.png?50}}
   Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}}   Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}}
-  Resized external image:           {{http://de3.php.net/images/php.gif?200x50}}+  Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
  
  
Line 161: Line 186:
  
 For linking an image to another page see [[#Image Links]] above. For linking an image to another page see [[#Image Links]] above.
 +
 +[[|Back To Top]]
 +----
  
 ===== Lists ===== ===== Lists =====
Line 189: Line 217:
  
 Also take a look at the [[doku>faq:lists|FAQ on list items]]. Also take a look at the [[doku>faq:lists|FAQ on list items]].
 +
 +----
  
 ===== Text Conversions ===== ===== Text Conversions =====
Line 236: Line 266:
  
 There are three exceptions which do not come from that pattern file: multiplication entity (640x480), 'single' and "double quotes". They can be turned off through a [[doku>config:typography|config option]]. There are three exceptions which do not come from that pattern file: multiplication entity (640x480), 'single' and "double quotes". They can be turned off through a [[doku>config:typography|config option]].
 +
 +[[|Back To Top]]
 +----
  
 ===== Quoting ===== ===== Quoting =====
Line 264: Line 297:
  
 >>> Then lets do it! >>> Then lets do it!
 +
 +----
  
 ===== Tables ===== ===== Tables =====
Line 326: Line 361:
  
 Note: Vertical alignment is not supported. Note: Vertical alignment is not supported.
 +
 +[[|Back To Top]]
 +----
  
 ===== No Formatting ===== ===== No Formatting =====
Line 340: Line 378:
   </nowiki>   </nowiki>
   The same is true for %%//__this__ text// with a smiley ;-)%%.   The same is true for %%//__this__ text// with a smiley ;-)%%.
 +
 +----
  
 ===== Code Blocks ===== ===== Code Blocks =====
Line 384: Line 424:
 If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<code - myfile.foo>%%''. If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<code - myfile.foo>%%''.
  
 +[[|Back To Top]]
 +----
  
 +===== Notes =====
  
 +Different types of notes are supported in the wiki. Using the following format:
  
-===== Control Macros =====+  <note $type>Tip text</note>
  
-Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:+$type can be 4 valuesimportant, classic (same as using nothing), tip and warning.
  
-^ Macro           ^ Description | +<note important>A note using **important**.</note>
-| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created | +
-| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (egwhen the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |+
  
 +<note classic>A note using nothing or **classic**.</note>
  
 +<note tip>A note using **tip**.</note>
 +
 +<note warning>A note using **warning**.</note>
 +
 +----
 +
 +===== GUI Sequences =====
 +
 +Because of the documentation and manual target, there is a special syntax for GUI sequences or labels on the interface. The same for key combinations.
 +
 +  You can open the preferences using {gui>Menu>Edit>Preferences...} 
 +  to open the dialog or press {key>Ctrl+P}. If you click the
 +  {gui>Apply} button the settings are saved.
 + 
 +You can open the preferences using {gui>Menu>Edit>Preferences...} to open the dialog or press {key>Ctrl+P}. If you click the {gui>Apply} button the settings are saved.
 +
 +----
 +
 +===== Figures =====
 +
 +To give images a description and make then distinct from the rest of the text, you can use the figure tag.
 +
 +  <figure "Actions Preferences Dialog">
 +  {{:xfce:xfce4-panel:actions.png?nolink&|}}
 +  </figure>
 +
 +This will place the contents between the tags in a table with the string between the brackets as a table comment.
 +
 +<figure "Actions Preferences Dialog">
 +{{:xfce:xfce4-panel:actions.png?nolink&|}}
 +</figure>
 +
 +----
 +
 +===== Definition Lists =====
 +
 +Common to describe dialogs are definition lists. The syntax to write those is as follows:
 +
 +  ? Term 1
 +  ! This is the definition of the first term.
 +  ? Term 2
 +  ! This is the definition of the second term.
 +  ? Term 3
 +  ! Maybe the 3rd term has three possible values:
 +    ? Term 3.1
 +    ! This is the definition of the first subterm.
 +    ? Term 3.2
 +    ! This is the definition of the second irst subterm.
 +    ? Term 3.3
 +    ! This is the definition of the third subterm.
 +
 +? Term 1
 +! This is the definition of the first term.
 +? Term 2
 +! This is the definition of the second term.
 +? Term 3
 +! Maybe the 3rd term has three possible values:
 +  ? Term 3.1
 +  ! This is the definition of the first subterm.
 +  ? Term 3.2
 +  ! This is the definition of the second irst subterm.
 +  ? Term 3.3
 +  ! This is the definition of the third subterm.
 +  
 +----
 +[[|Back To Top]]