Differences

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

--- start [2023/08/15 18:08] – wikiadmin
+++ start [2023/08/15 19:25] (current) – [Key points about DokuWiki markup, and differences from MediaWiki markup] wikiadmin
@@ Line 13: / Line 13: @@
   * [[wiki:dokuwiki|DokuWiki Resources and Installation Guide]]
-====Key points about DokuWiki markup, and differences from MediaWiki markup====
+====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 details.
+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 still 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. More info is here: https://www.dokuwiki.org/faq:headerlinks
+  - 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 force a new line, use '\\' at the end of a line, or '%%\\ %%' in the  middle of a line.  An empty line is a paragraph separator, which causes a new line followed by an empty line.
+  - 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, partly because there is no database to store it in. FSGW has DokuWiki configured to use the first Headline on each page as the page title.
+  - 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.
-  - To display text with newlines exactly as it is, un-formatted, use %%<text>%%text%%</text>%%. This is what %%<poem>%%text%%</poem>%% did in FSGW's MediaWiki. Uppercase %%<TEXT>%% adds a box around it.
   - 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: https://www.vertopal.com/en/convert/wiki-mediawiki-to-dokuwiki
+  - A basic MediaWiki to DokuWiki markup converter is: https://www.vertopal.com/en/convert/wiki-mediawiki-to-dokuwiki