Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision		 Révision précédente
wiki:syntax [16/06/2020 19:13] – bonnetwiki:syntax [17/06/2020 08:08] (Version actuelle) – bonnet
Ligne 2: Ligne 2:
  
 [[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 "Edit this 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 "Edit this 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.
 +
 +More advanced syntaxe is available from this documentation: [[http://lotar.altervista.org/wiki/wiki/plugin/bootswrapper]]
  
 ===== Basic Text Formatting ===== ===== Basic Text Formatting =====
Ligne 29: Ligne 31:
  
 You should use forced newlines only if really needed. You should use forced newlines only if really needed.
 +
 +==== Alignement ====
 +
 +<code>
 +<TEXT align="left">Left aligned text.</TEXT>
 +<TEXT align="center">Center aligned text.</TEXT>
 +<TEXT align="right">Right aligned text.</TEXT>
 +<TEXT align="justify">Justified text.</TEXT>
 +<TEXT align="nowrap">No wrap text.</TEXT>
 +</code>
 +
 +<TEXT align="left">Left aligned text.</TEXT>
 +<TEXT align="center">Center aligned text.</TEXT>
 +<TEXT align="right">Right aligned text.</TEXT>
 +<TEXT align="justify">Justified text.</TEXT>
 +<TEXT align="nowrap">No wrap text.</TEXT>
 +
 +==== Contextual colors ====
 +
 +
 +<TEXT type="muted">Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.</TEXT>
 +
 +<TEXT type="primary">Nullam id dolor id nibh ultricies vehicula ut id elit.</TEXT>
 +
 +<TEXT type="success">Duis mollis, est non commodo luctus, nisi erat porttitor ligula.</TEXT>
 +
 +<TEXT type="info">Maecenas sed diam eget risus varius blandit sit amet non magna.</TEXT>
 +
 +<TEXT type="warning">Etiam porta sem malesuada magna mollis euismod.</TEXT>
 +
 +<TEXT type="danger">Donec ullamcorper nulla non metus auctor fringilla.</TEXT>
 +
 +\\
 +
 +<code html5>
 +<text type="muted"> [...] </text>
 +<text type="primary"> [...] </text>
 +<text type="success"> [...] </text>
 +<text type="info"> [...] </text>
 +<text type="warning"> [...] </text>
 +<text type="danger"> [...] </text>
 +</code>
 +
 +\\
 +
 +==== Text size ====
 +
 +<TEXT size="medium">Nullam id dolor id nibh ultricies vehicula ut id elit.</TEXT>
 +
 +<TEXT size="xx-small">Duis mollis, est non commodo luctus, nisi erat porttitor ligula.</TEXT>
 +
 +<TEXT size="x-small">Maecenas sed diam eget risus varius blandit sit amet non magna.</TEXT>
 +
 +<TEXT size="small">Etiam porta sem malesuada magna mollis euismod.</TEXT>
 +
 +<TEXT size="large">Donec ullamcorper nulla non metus auctor fringilla.</TEXT>
 +
 +<TEXT size="x-large">Donec ullamcorper nulla non metus auctor fringilla.</TEXT>
 +
 +<TEXT size="xx-large">Donec ullamcorper nulla non metus auctor fringilla.</TEXT>
 +
 +<TEXT size="smaller">Donec ullamcorper nulla non metus auctor fringilla.</TEXT>
 +
 +<TEXT size="larger">Donec ullamcorper nulla non metus auctor fringilla.</TEXT>
 +
 +
 +
 +<code html5>
 +<text size="medium"> [...] </text>
 +</code>
 +
 +Size attribute can be:
 +  * medium
 +  * xx-small
 +  * x-small
 +  * small
 +  * large
 +  * x-large
 +  * xx-large
 +  * smaller
 +  * larger
 +  * any length in px / percent / em / etc...
  
 ===== Links ===== ===== Links =====
Ligne 105: Ligne 189:
  
 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).
 +
 +===== Tooltip =====
 +<code>
 +<tooltip title="Sample Text">Lorem ipsum</tooltip> dolor sit amet...
 +</code>
 +
 +<tooltip title="Sample Text">Lorem ipsum</tooltip> dolor sit amet...
  
 ===== Footnotes ===== ===== Footnotes =====
Ligne 111: Ligne 202:
  
   You can add footnotes ((This is a footnote)) by using double parentheses.   You can add footnotes ((This is a footnote)) by using double parentheses.
 +
 +===== Grid system =====
 +You can use [[https://getbootstrap.com/docs/3.3/css/#grid|Bootstrap grid system]].
 +
 +**Note:** Instead of <grid> you can use <row> alias.
 +
 +<code>
 +<grid>
 +<col sm="6">.col-sm-6</col>
 +<col sm="6">.col-sm-6</col>
 +</grid>
 +</code>
 +
 +Arguments is xs, sm, md, lg.
 +
 +===== Thumbnail =====
 +
 +<code>
 +<grid>
 +...
 +<col xs="6" md="3">
 +<thumbnail>
 +{{ wiki:dokuwiki-128.png }}
 +<caption>
 +=== DokuWiki ====
 + 
 +//DokuWiki is a simple to use and highly versatile Open Source wiki software that doesn't require a database. It is loved by users for its clean and readable syntax. The ease of maintenance, backup and integration makes it an administrator's favorite. Built in access controls and authentication connectors make DokuWiki especially useful in the enterprise context and the large number of plugins contributed by its vibrant community allow for a broad range of use cases beyond a traditional wiki.//
 +</caption>
 +</thumbnail>
 +...
 +</col>
 +</grid>
 +</code>
 +
 +<grid>
 +<col xs="6" md="3">
 +<thumbnail>
 +{{ wiki:dokuwiki-128.png }}
 +<caption>
 +=== DokuWiki ====
 + 
 +//DokuWiki is a simple to use and highly versatile Open Source wiki software that doesn't require a database. It is loved by users for its clean and readable syntax. The ease of maintenance, backup and integration makes it an administrator's favorite. Built in access controls and authentication connectors make DokuWiki especially useful in the enterprise context and the large number of plugins contributed by its vibrant community allow for a broad range of use cases beyond a traditional wiki.//
 +</caption>
 +</thumbnail>
 +</col>
 +<col xs="6" md="3">
 +<thumbnail>
 +{{ wiki:dokuwiki-128.png }}
 +<caption>
 +=== DokuWiki ====
 + 
 +//DokuWiki is a simple to use and highly versatile Open Source wiki software that doesn't require a database. It is loved by users for its clean and readable syntax. The ease of maintenance, backup and integration makes it an administrator's favorite. Built in access controls and authentication connectors make DokuWiki especially useful in the enterprise context and the large number of plugins contributed by its vibrant community allow for a broad range of use cases beyond a traditional wiki.//
 +</caption>
 +</thumbnail>
 +</col>
 +<col xs="6" md="3">
 +<thumbnail>
 +{{ wiki:dokuwiki-128.png }}
 +<caption>
 +=== DokuWiki ====
 + 
 +//DokuWiki is a simple to use and highly versatile Open Source wiki software that doesn't require a database. It is loved by users for its clean and readable syntax. The ease of maintenance, backup and integration makes it an administrator's favorite. Built in access controls and authentication connectors make DokuWiki especially useful in the enterprise context and the large number of plugins contributed by its vibrant community allow for a broad range of use cases beyond a traditional wiki.//
 +</caption>
 +</thumbnail>
 +</col>
 +</grid>
 +
  
 ===== Sectioning ===== ===== Sectioning =====
Ligne 127: Ligne 285:
  
 ---- ----
 +
 +For beautiful sectionning, use jumbotron:
 +<code>
 +<jumbotron>
 +====== Hello, world! ======
 + 
 +This is a simple hero unit, a simple jumbotron-style 
 +component for calling extra attention to featured
 +content or information.
 + 
 +<btn type="primary">[[#|Learn more]]</btn>
 +</jumbotron>
 +</code>
 +
 +<jumbotron>
 +====== Hello, world! ======
 + 
 +This is a simple hero unit, a simple jumbotron-style 
 +component for calling extra attention to featured
 +content or information.
 + 
 +<btn type="primary">[[#|Learn more]]</btn>
 +</jumbotron>
  
 ===== Media Files ===== ===== Media Files =====
Ligne 183: Ligne 364:
 {{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image. {{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image.
  
 +=== Image shape ===
 +
 +| <image shape="rounded">{{:wiki:plugin:bootswrapper:image-placeholder.png?nolink&100|}}</image>   | <code html><image shape="rounded">
 +{{:wiki:plugin:bootswrapper:image-placeholder.png?nolink&100|}}
 +</image></code> |
 +| <image shape="circle">{{:wiki:plugin:bootswrapper:image-placeholder.png?nolink&100|}}</image>    | <code html><image shape="circle">
 +{{:wiki:plugin:bootswrapper:image-placeholder.png?nolink&100|}}
 +</image></code> |
 +| <image shape="thumbnail">{{:wiki:plugin:bootswrapper:image-placeholder.png?nolink&100|}}</image> | <code html><image shape="thumbnail">
 +{{:wiki:plugin:bootswrapper:image-placeholder.png?nolink&100|}}
 +</image></code> |
 ==== Fallback Formats ==== ==== Fallback Formats ====
  
Ligne 302: Ligne 494:
 </uml> </uml>
 </code> </code>
 +
 +More information on: [[https://plantuml.com/fr/nwdiag]].
  
 <uml> <uml>
Ligne 592: Ligne 786:
 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>%%''.
  
 +
 +===== Tabs =====
 +<tabs>
 +  * [[#tab-foo|Foo]]
 +  * [[#tab-bar|Bar]]
 + 
 +<pane id="tab-foo">
 +=== Foo ===
 +Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
 +</pane>
 + 
 +<pane id="tab-bar">
 +=== Bar ===
 +Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
 +</pane>
 + 
 +</tabs>
 +<code><tabs>
 +  * [[#tab-foo|Foo]]
 +  * [[#tab-bar|Bar]]
 + 
 +<pane id="tab-foo">
 +=== Foo ===
 +Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
 +</pane>
 + 
 +<pane id="tab-bar">
 +=== Bar ===
 +Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat. Quis aute iure reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint obcaecat cupiditat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
 +</pane>
 + 
 +</tabs></code>
  
 ===== Embedding HTML and PHP ===== ===== Embedding HTML and PHP =====
Ligne 673: Ligne 899:
 | %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created | | %%~~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 (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call | | %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |
 +| %%~~CLEARFIX~~%% | Clear the float |
 +| %%~~PAGEBREAK~~%% | Add a page break |
  
 ===== Syntax Plugins ===== ===== Syntax Plugins =====