Differences

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

--- start [2023/08/08 21:05] – [Cautions about differences from MediaWiki markup syntax] wikiadmin
+++ start [2023/08/15 19:25] (current) – [Key points about DokuWiki markup, and differences from MediaWiki markup] wikiadmin
@@ Line 8: / Line 8: @@
 ====DokuWiki help====
-  * [[wiki:syntax|DokuWiki Syntax guide]]
+  * [[wiki:syntax|DokuWiki Formatting Syntax guide (short)]]
+  * [[https://www.dokuwiki.org/manual|DokuWiki Manual (detailed)]]
   * link to [[playground:playground|a playground page you can safely test in]]
-====Cautions about differences from MediaWiki markup syntax====
+  * [[wiki:dokuwiki|DokuWiki Resources and Installation Guide]]
-At first glance, DokuWiki markup looks rather like MediaWiki markup, but while it has the same markup flavor, it is actually deceptively different in the details.
+====Key points about DokuWiki Formatting markup, and differences from MediaWiki markup====
+At first glance, DokuWiki markup looks a lot like MediaWiki markup, but while it has the same markup flavor, it is actually significantly different in a number of ways.
+  - Headlines (headings) are defined by equal signs (like %%"=====Heading====="%%), but they may ONLY contain text. Especially, links are NOT allowed in Headlines, while MediaWiki does allow links there. (Info on why is here: https://www.dokuwiki.org/faq:headerlinks)
+  - More '='s makes BIGGER headline text, not smaller. I use 4, 5, and 6 '='s for small, medium, and large (top of page) headings, what would be 3, 2, and 1 '='s in MediaWiki.
+  - The characters to start a list item are '*' for unordered, and '-' for ordered (NOT '#'). They MUST be indented by 2 spaces, they do NOT work at the left margin. For each further list indent, add 2 more spaces, NOT another '*' or '-'.
+  - To display copied-in text exactly as it is, for example from an email, use %%<text>%%your text%%</text>%%. Uppercase %%<TEXT>%% does the same, and adds a box around it.
+  - To force a new line, use '\\' at the end of a line, or '%%\\ %%' in the  middle of a line.  An empty line acts as a paragraph separator, which causes a new line followed by an empty line.
+  - To prevent characters from being interpreted as markup, bracket them with pairs of percent signs (%)
+  - Unlike MediaWiki, there is no Page Title stored outside of the page markup, because there is no database to store it in. FSGW has DokuWiki configured to try to use the first Headline on each page as the page title.
+  - External (outside the wiki) links will open in a new tab. This is a configuration choice we made in DokuWiki.
+  - A basic MediaWiki to DokuWiki markup converter is: https://www.vertopal.com/en/convert/wiki-mediawiki-to-dokuwiki
-  - Headings defined by equal signs (like %%"=== Heading ==="%%) CANNOT contain anything but text. Especially, NO links are allowed in Headings. More info is here: https://www.dokuwiki.org/faq:headerlinks
-  - The list item characters are '*' for unordered. '-' for ordered (NOT '#'). They MUST be indented by 2 spaces, they do NOT work at the left margin. For each further list indent, add 2 more spaces, NOT another '*' or '-'.
-  - More '='s makes BIGGER headline text, not smaller. I use 4, 5, and 6 '='s as small, medium, and large (top of page) headings.
-  - An empty line is a paragraph separator. To force just a new line, use '\\' at the end of a line, or '%%\\ %%' in the  middle of a line.
-  - To prevent characters from being interpreted as markup, bracket them with '%%'.