Differences

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

--- wiki:dokuwiki_syntax_comparison [2023-12-07 19:30] – created admin
+++ wiki:dokuwiki_syntax_comparison [2023-12-08 11:16] (current) – admin
@@ Line 1: / Line 1: @@
-====== DokuWiki's syntax versus competition ======
+====== 💡DokuWiki's syntax compared ======
+I think DokuWiki has the most readable syntax of all wikis. It was designed to be quickly readable and understandable just by reading the source text. That's also probably the reason why the file extension of DW files is simply ''.txt''.
-I think DokuWiki has the most readable syntax of all wikis. It was designed to be quickly readable and understandable just by reading the source text. That's also probably the reason why the extension of DW files is simply ''.txt''.
 ===== DokuWiki has a natural formatting of headlines. =====
-The largest headline (h1) uses the most amount of special characters which are ''=''\\
+The largest headline (h1) uses the most amount of special characters (which is ''=''),\\
-The smallest (least significant) headline (h5) uses //the least// amount of these characters.
+the smallest (least significant) headline (h5) uses //the least// amount of these characters.
 %%====== Headline h1 ======%%
@@ Line 15: / Line 14: @@
 %%== Headline h5 ==%%
-=== Now have a look at all other alternative syntaxes ===
+=== Now let's have a look at the "competition" ===
 **__Markdown:__**
@@ Line 25: / Line 24: @@
 ##### Headline h5
-The //least// significant headline gets the //most// attention!
+**__PhpWiki:__**
+== Headline h2
+==== Headline h4
+====== Headline h6
+The //least// significant headlines receive the //most// attention! :-o
+I don't want to compare every part of DokuWiki to Markdown or other formats, but there are many more examples which clearly show that people who created [[https://daringfireball.net/projects/markdown/syntax|Markdown]], [[http://phpwiki.demo.free.fr/index.php/Help/TextFormattingRules|PhpWiki]] or [[https://www.mediawiki.org/wiki/Help:Formatting|MediaWiki]] didn't really mean to make the source well readable to humans (or maybe they are aliens :-D).
-I don't want to compare every part of DokuWiki to Markdown or other formats, but there are many more examples which clearly show that people who created [[https://www.markdownguide.org/basic-syntax/|Markdown]], [[http://phpwiki.demo.free.fr/index.php/Help/TextFormattingRules|PhpWiki]] or [[https://www.mediawiki.org/wiki/Help:Formatting|MediaWiki]] didn't really mean to make the source well readable to humans.
+I mean how could anyone come up with the idea that <sub>subscript</sub> should be written with one tilde ''~subscript~'' and <del>strike-through</del> with 2 tilde characters ''~~strikethrough~~'' ?!?\\
+Or //italic// text with 2 apostrophes ''%%''italic''%%'', **bold** with 3 apostrophes ''%%'''bold'''%%'' and **//bold & italic//** with 5 apostrophes ''%%'''''bold & italic'''''%%'' ?!?
-I mean how could anyone come up with the idea that **subscript** should be done with one tilde ''~subscript~'' and **strike-through** with 2 tilde characters ''~~strikethrough~~'' ?!?\\
+On the other hand DokuWiki has some missing formatting features compared to complex formats like MediaWiki. But that's a good thing, DW is easy to learn and read, and for the majority of wiki texts it's all you will ever need. If you still need more formatting capabilites then go ahead and install one of the many [[https://www.dokuwiki.org/plugins?plugintype=1#extension__table|syntax extensions]]. If you know PHP and JS you could even make extensions yourself.
-Or italic text with 2 apostrophes ''%%''italic''%%'', bold with 3 apostrophes ''%%'''bold'''%%'' and bold & italic with 5 apostrophes ''%%'''''bold & italic'''''%%'' ?!?
+-----
-The most similar syntax to DokuWiki is probably [[https://playground.xwiki.org/xwiki/bin/view/XWiki/XWikiSyntax|Xwiki]]
+Interesting footnote: probably the most similar syntax to DokuWiki is [[https://playground.xwiki.org/xwiki/bin/view/XWiki/XWikiSyntax|Xwiki]]