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 [2026/03/30 18:13] – [Media Files] Simon Grantwiki:syntax [2026/04/20 12:27] (current) – [Text to HTML Conversions] Simon Grant
Line 1: Line 1:
-[[:wiki:|index]]+//[[:wiki:|index to the wiki namespace]], or [[:start]] over// 
 + 
 +==== CARE! this page is complex! ==== 
 + 
 +For much gentler explanations, please go to **the [[doc:start|documentation]]**.
  
 ====== Formatting Syntax for Growing the Commons ====== ====== Formatting Syntax for Growing the Commons ======
Line 143: Line 147:
 `Actually, internal links to [that page](pagename) also work in Markdown format …` `Actually, internal links to [that page](pagename) also work in Markdown format …`
  
-Even with namespaces: [me](p:Simon Grant)+Even with namespaces: [me](user:asimong)
  
-`Even with namespaces: [me](p:Simon Grant)`+`Even with namespaces: [me](user:asimong)`
  
 [[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.
  
-You can use [[wiki:namespaces]] by using a colon in the pagename.+You can use a [[doc:namespace]] by using a colon in the pagename.
  
-`You can use [[wiki:namespaces]] by using a colon in the pagename.`+`You can use a [[doc:namespace]] by using a colon in the pagename.`
  
 For details about namespaces see [[doku>namespaces]]. For details about namespaces see [[doku>namespaces]].
Line 162: Line 166:
 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. //(Please don't create the nonexisting one!)//
   * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled.   * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled.
   * 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.
Line 203: Line 207:
 You can also use an image to link to another internal or external page by combining the syntax for links and [[#media_files|media files]] (this links to the section below) like this: You can also use an image to link to another internal or external page by combining the syntax for links and [[#media_files|media files]] (this links to the section below) like this:
  
-[[http://php.net|{{wiki:dokuwiki-128.png?500}}]]+[[http://www.growingthecommons.org|{{wiki:dokuwiki-128.png?500}}]]
  
-`[[http://php.net|{{wiki:dokuwiki-128.png?500}}]]`+`[[http://www.growingthecommons.org|{{wiki:dokuwiki-128.png?500}}]]`
  
 Please note: The image formatting is the only formatting syntax accepted in link names. Please note: The image formatting is the only formatting syntax accepted in link names.
Line 279: Line 283:
 `Resize to given width:            {{wiki:dokuwiki-128.png?200}}` `Resize to given width:            {{wiki:dokuwiki-128.png?200}}`
  
-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?300x40}}+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 as well as being resized)): {{wiki:dokuwiki-128.png?300x40}}
  
 `Resize to given width and height: {{wiki:dokuwiki-128.png?300x40}}` slices off top and bottom `Resize to given width and height: {{wiki:dokuwiki-128.png?300x40}}` slices off top and bottom
Line 445: Line 449:
  
  
-Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters.+Typography: [[DokuWiki]] can convert simple text character sequences to their typographically correct entities. Here is an example of recognized characters.
  
 -> <- <-> => <= <=> -> <- <-> => <= <=>
Line 454: Line 458:
 "He thought 'It's a woman's world'..." "He thought 'It's a woman's world'..."
 </code> </code>
 +
 +Different dashes are also made easy: `--` becomes an en-dash  "–"; and `---` becomes an em-dash --- slightly longer, see?
  
 The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]]. The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]].
Line 462: Line 468:
  
 Some times you want to mark some text to show it's a reply or comment.  Some times you want to mark some text to show it's a reply or comment. 
-But this syntax does not work:+The first part of this works, but the rest does not:
  
 ``` ```
  • wiki/syntax.1774894429.txt.gz
  • Last modified: 2026/03/30 18:13
  • by Simon Grant