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
hub:syntax [2023/05/31 19:07] – ↷ Page moved from wiki:syntax to hub:syntax elizabethherfelhub:syntax [2023/07/03 16:59] (current) – removed info relating to intranet servers elizabethherfel
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 "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 pages as readable as possible. This guide 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 experiment with different syntax use the [[playground:playground|playground]] page. The most basic markup - such as bold, italics, and underline - can be applied ising [[doku>toolbar|quickbuttons]].
  
 ===== Basic Text Formatting ===== ===== Basic Text Formatting =====
  
-DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' textsOf course you can **__//''combine''//__** all these.+DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' formattingYou can **__//''combine''//__** all these.
  
   DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts.   DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts.
-  Of course you can **__//''combine''//__** all these.+  You can **__//''combine''//__** all these.
  
 You can use <sub>subscript</sub> and <sup>superscript</sup>, too. You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
Line 36: Line 36:
 ==== External ==== ==== 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: <andi@splitbrain.org> are recognized, too.+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: <elizabeth.herfel@gmail.com> are recognized, too.
  
   DokuWiki supports multiple ways of creating links. External links are recognized   DokuWiki supports multiple ways of creating links. External links are recognized
   automagically: http://www.google.com or simply www.google.com - You can set   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   link text as well: [[http://www.google.com|This Link points to google]]. Email
-  addresses like this one: <andi@splitbrain.org> are recognized, too.+  addresses like this one: <elizabeth.herfel@gmail.com> are recognized, too.
  
 ==== Internal ==== ==== Internal ====
  
-Internal links are created by using square brackets. You can either just give a [[wiki:pagename]] or use an additional [[wiki:pagename|link text]].+Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].
  
   Internal links are created by using square brackets. You can either just give   Internal links are created by using square brackets. You can either just give
Line 58: Line 58:
 For details about namespaces see [[doku>namespaces]]. For details about namespaces see [[doku>namespaces]].
  
-Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[wiki:syntax#internal|this Section]].+Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax#internal|this Section]].
  
   This links to [[syntax#internal|this Section]].   This links to [[syntax#internal|this Section]].
Line 64: Line 64:
 Notes: Notes:
  
-  * Links to [[wiki:syntax|existing pages]] are shown in a different style from [[wiki:nonexisting]] ones+  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones.
-  * 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 74: Line 73:
   DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis.   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]].   For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].
- 
-==== Windows Shares ==== 
- 
-Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp>Intranet]]. 
- 
-  Windows Shares like [[\\server\share|this]] are recognized, too. 
- 
-Notes: 
- 
-  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). 
-  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/lang/en/lang.php'' (more details at [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/lang/en/lang.php> 
-<?php 
-/** 
- * Customization of the english language file 
- * Copy only the strings that needs to be modified 
- */ 
-$lang['js']['nosmblinks'] = ''; 
-</code> 
  
 ==== Image Links ==== ==== Image Links ====
Line 99: Line 80:
   [[http://php.net|{{wiki:dokuwiki-128.png}}]]   [[http://php.net|{{wiki:dokuwiki-128.png}}]]
  
-[[http://php.net|{{wiki:dokuwiki-128.png}}]]+[[http://php.net|{{hub:dokuwiki-128.png}}]]
  
 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 126: Line 107:
  
 ---- ----
 +  ----
  
 ===== Media Files ===== ===== Media Files =====
Line 131: Line 113:
 You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them. You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
-Real size:                        {{wiki:dokuwiki-128.png}}+Real size:                        {{hub:dokuwiki-128.png}}
  
-Resize to given width:            {{wiki:dokuwiki-128.png?50}}+Resize to given width:            {{hub:dokuwiki-128.png?50}}
  
-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)): {{hub:dokuwiki-128.png?200x50}}
  
 Resized external image:           {{https://secure.php.net/images/php.gif?200x50}} Resized external image:           {{https://secure.php.net/images/php.gif?200x50}}
Line 147: Line 129:
 By using left or right whitespaces you can choose the alignment. By using left or right whitespaces you can choose the alignment.
  
-{{ wiki:dokuwiki-128.png}}+{{ hub:dokuwiki-128.png}}
  
-{{wiki:dokuwiki-128.png }}+{{hub:dokuwiki-128.png }}
  
-{{ wiki:dokuwiki-128.png }}+{{ hub:dokuwiki-128.png }}
  
   {{ wiki:dokuwiki-128.png}}   {{ wiki:dokuwiki-128.png}}
Line 159: Line 141:
 Of course, you can add a title (displayed as a tooltip by most browsers), too. Of course, you can add a title (displayed as a tooltip by most browsers), too.
  
-{{ wiki:dokuwiki-128.png |This is the caption}}+{{ hub:dokuwiki-128.png |This is the caption}}
  
   {{ wiki:dokuwiki-128.png |This is the caption}}   {{ wiki:dokuwiki-128.png |This is the caption}}
Line 180: Line 162:
   {{wiki:dokuwiki-128.png?linkonly}}   {{wiki:dokuwiki-128.png?linkonly}}
  
-{{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image.+{{hub:dokuwiki-128.png?linkonly}} This is just a link to the image.
  
 ==== Fallback Formats ==== ==== Fallback Formats ====
Last modified: 2023/05/31 19:07 by elizabethherfel