User Tools

Site Tools


wiki:syntax

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
wiki:syntax [2012/11/13 11:31]
legatum [RSS/ATOM Feed Aggregation]
wiki:syntax [2012/11/13 12:54]
legatum removed
Line 31: Line 31:
 |  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​ul.png?​nolink}} ​         |  ''​**.**'' ​ | Unordered list item | |  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​ul.png?​nolink}} ​         |  ''​**.**'' ​ | Unordered list item |
 |  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​hr.png?​nolink}} ​         |             | Horizontal rule | |  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​hr.png?​nolink}} ​         |             | Horizontal rule |
-|  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​image.png?​nolink}} ​      ​| ​            | [[media manager|Media Selection, includes file/​attachment uploader]] |+|  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​image.png?​nolink}} ​      ​| ​            | Media Selection, includes file/​attachment uploader |
 |  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​smiley.png?​nolink}} ​     |             | Smiley picker | |  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​smiley.png?​nolink}} ​     |             | Smiley picker |
 |  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​chars.png?​nolink}} ​      ​| ​            | Character picker | |  {{http://​www.dokuwiki.org/​lib/​images/​toolbar/​chars.png?​nolink}} ​      ​| ​            | Character picker |
Line 63: Line 63:
 You should use forced newlines only if really needed. You should use forced newlines only if really needed.
  
 +Instead of a **hyphen** (-), please use a **dash** -- either [[wp>​Dash#​En_dash_versus_em_dash|en dash]] (--) or em dash (---) -- where appropriate (spaced or unspaced).
 +
 +  Instead of a **hyphen** (-), please use a **dash** -- either [[wp>​Dash#​En_dash_versus_em_dash|en dash]] (--) or em dash (---) -- where appropriate (spaced or unspaced).
 ===== Links ===== ===== Links =====
  
 DokuWiki supports multiple ways of creating links. DokuWiki supports multiple ways of creating links.
- 
-==== External ==== 
- 
-External links are recognized automagically:​ http://​www.google.com or simply www.google.com - You can set the link text as well: [[http://​www.google.com|This Link points to google]]. Email addresses like this one: <​info@legatum.sk>​ are recognized, too. 
- 
-  DokuWiki supports multiple ways of creating links. External links are recognized 
-  automagically:​ http://​www.google.com or simply www.google.com - You can set 
-  link text as well: [[http://​www.google.com|This Link points to google]]. Email 
-  addresses like this one: <​info@legatum.sk>​ are recognized, too. 
  
 ==== Internal ==== ==== Internal ====
Line 80: Line 74:
 Internal links are created by using square brackets. You can either just give a page name -- such as [[en:​ahr:​lippe-ad-importance-of-a-single-symptom-158-10559]] -- or use an additional link text -- such as [[en:​ahr:​lippe-ad-importance-of-a-single-symptom-158-10559|Lippe:​ Importance of a Single Symptom]]. Internal links are created by using square brackets. You can either just give a page name -- such as [[en:​ahr:​lippe-ad-importance-of-a-single-symptom-158-10559]] -- or use an additional link text -- such as [[en:​ahr:​lippe-ad-importance-of-a-single-symptom-158-10559|Lippe:​ Importance of a Single Symptom]].
  
-  ​Internal links are created by using square brackets. ​You can either just give +  You can either just give a page name -- such as [[en:​ahr:​lippe-ad-importance-of-a-single-symptom-158-10559]] --  
-  ​a [[pagename]] or use an additional [[pagename|link text]].+  ​or use an additional ​link text -- such as [[en:​ahr:​lippe-ad-importance-of-a-single-symptom-158-10559|Lippe: Importance of a Single Symptom]].
  
 [[doku>​pagename|Wiki pagenames]] are converted to lowercase automatically,​ special characters are not allowed. [[doku>​pagename|Wiki pagenames]] are converted to lowercase automatically,​ special characters are not allowed.
Line 94: Line 88:
  
   This links to [[syntax#​internal|this Section]].   This links to [[syntax#​internal|this Section]].
 +  ​
 +=== Linking to a specific sentence ===
 +
 +Most articles in [[en:​resources|resources]] are sentence disambiguated (by an algorithm). In practice, this means each sentence has a unique anchor you can directly link to. This is a useful feature for linking directly to specific proving symptoms or any sentence or part of an article you would like to direct our attention to.
 +
 +The syntax is the same as in section linking, you just need to find the anchor number in the source of the article (click the Edit button) -- in order to know where to link to.
 +
 +For example, if you wish to link to a sentence where [[en:​ahr:​lippe-ad-the-homoeopathician-158-10568#​s24|Dr. Lippe explains us how to properly relate a successful cure]], you will do this as follows
 +  ​
 +  [[en:​ahr:​lippe-ad-the-homoeopathician-158-10568#​s24|Dr. Lippe explains us how to properly relate a successful cure]]
  
 Notes: Notes:
  
   * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones.   * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones.
-  * When a section'​s heading is changed, its bookmark changes, too. So don't rely on section linking too much.+  * When a section'​s heading is changed, its bookmark changes, too. So don't rely on section linking too much -- use anchor linking, if possible. 
 +==== External ==== 
 + 
 +External links are recognized automagically:​ http://​www.google.com or simply www.google.com - You can set the link text as well: [[http://​www.google.com|This Link points to google]]. Email addresses like this one: <​info@legatum.sk>​ are recognized, too. 
 + 
 +  DokuWiki supports multiple ways of creating links. External links are recognized 
 +  automagically:​ http://​www.google.com or simply www.google.com - You can set 
 +  link text as well: [[http://​www.google.com|This Link points to google]]. Email 
 +  addresses like this one: <​info@legatum.sk>​ are recognized, too. 
 + 
 +DokuWiki supports [[doku>​Interwiki]] links. These are quick links to other Wikis. For example this is a link to Wikipedia'​s page about Wikis: [[wp>​Wiki]]. 
 + 
 +  DokuWiki supports [[doku>​Interwiki]] links. These are quick links to other Wikis. 
 +  For example this is a link to Wikipedia'​s page about Wikis: [[wp>​Wiki]].
 ==== Image Links ==== ==== Image Links ====
  
Line 252: Line 269:
 Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:
  
-  I think we should do it+  I think we should do it.
   ​   ​
-  > No we shouldn'​t+  > Nowe shouldn'​t.
   ​   ​
-  >> Well, I say we should+  >> Well, I say we should.
   ​   ​
   > Really?   > Really?
Line 262: Line 279:
   >> Yes!   >> Yes!
   ​   ​
-  >>>​ Then lets do it!+  >>>​ Then let'​s ​do it!
  
-I think we should do it+I think we should do it.
  
-> No we shouldn'​t+> Nowe shouldn'​t.
  
->> Well, I say we should+>> Well, I say we should.
  
 > Really? > Really?
Line 274: Line 291:
 >> Yes! >> Yes!
  
->>>​ Then lets do it!+>>>​ Then let'​s ​do it!
  
 ===== Tables ===== ===== Tables =====
Line 377: Line 394:
   This is pretty much the same, but you could use it to show that you quoted a file.   This is pretty much the same, but you could use it to show that you quoted a file.
   </​file>​   </​file>​
- 
- 
-==== Downloadable Code Blocks ==== 
- 
-When you use the ''​%%<​code>​%%''​ or ''​%%<​file>​%%''​ syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this: 
- 
-<​code>​ 
-<file php myexample.php>​ 
-<?php echo "hello world!";​ ?> 
-</​file>​ 
-</​code>​ 
- 
-<file php myexample.php>​ 
-<?php echo "hello world!";​ ?> 
-</​file>​ 
- 
-If you don't want any highlighting but want a downloadable file, specify a dash (''​-''​) as the language code: ''​%%<​code - myfile.foo>​%%''​. 
- 
  
  
Line 404: Line 403:
 ^ Macro           ^ Description | ^ Macro           ^ Description |
 | %%~~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 |
 +| %%~~DISCUSSION:​off~~%% ​  | If this macro is found on the page, no discussion at the end of the page 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 |
  
-===== Syntax Plugins ===== 
- 
-DokuWiki'​s syntax can be extended by [[doku>​plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:​ 
- 
-~~INFO:​syntaxplugins~~ 
wiki/syntax.txt · Last modified: 2015/06/23 07:27 (external edit)