Wiki Syntax

You are here: Home > Forum > General > Wiki > Wiki Syntax

Page 1 of 1

Wiki Syntax 01/02/2019 at 14:00 #115248
SamTDS
Avatar
153 posts
The syntax appears to be indeed dokuwiki as the page suggests however many parts such as nowiki and code flags do not work and leave the text formatted, this also prevents the wikipage being made for syntax showing the code alongside the result. I also have found the syntax page to be a near identical copy from the dokuwiki site here https://www.dokuwiki.org/wiki:syntax
SamTDS - STDS | My comments are my opinions and interpretations and do not reflect on the wonderfull SimSig team. I am in no way part of the team.
Log in to reply
Wiki Syntax 09/09/2020 at 01:27 #131434
GeoffM
Avatar
6380 posts
Because the old site was written in DokuWiki, and that runs on PHP while this site runs on C#, I had to write a parser to be "DokuWiki-like". It's not complete, and is never intended to be a full copy.

We did consider batch converting to another Wiki format but (at the time) none really existed. There were some C#/.NET based parsers for DokuWiki but they were also incomplete and buggy.

Wiki parsing is horrible - and that applies not just to DokuWiki. The specs are too vague when dealing with valid syntax that can be interpreted in more ways than one, let alone when the syntax is wrong but you try to parse and display it anyway.

A double space indent at line start should now work for code/pre formatting. But since I've only been able to find one page with it on, links to better examples would help.

SimSig Boss
Log in to reply
Wiki Syntax 09/09/2020 at 01:35 #131436
Edgemaster
Avatar
332 posts
This has now broken bullet pointed lists, unfortunately.
Twitter
Log in to reply
Wiki Syntax 09/09/2020 at 01:37 #131437
Edgemaster
Avatar
332 posts
Also of note I had been working on an updated version of the syntax documentation in the sandbox by experimenting what was and wasn't supported:

https://www.SimSig.co.uk/Wiki/Show?page=editors:syntax
https://www.SimSig.co.uk/Wiki/Show?page=editors:sandbox:syntax

Haven't touched it in a while, left it at about the point I got frustrated with the syntax!

Twitter
Log in to reply
Wiki Syntax 09/09/2020 at 02:14 #131438
GeoffM
Avatar
6380 posts
Edgemaster in post 131436 said:
This has now broken bullet pointed lists, unfortunately.
Oh gawd, I know why. DokuWiki's syntax says "two spaces followed by asterisk or hyphen for lists" and "two spaces" for code. A classic case of ambiguous syntax when the author wants a code block starting with an asterisk (eg a comment in many languages). Yes, I know that's not the case on the linked pages, but something I need to think about.

I'll try to fix it later.

SimSig Boss
Last edited: 09/09/2020 at 02:15 by GeoffM
Reason: None given

Log in to reply
Wiki Syntax 09/09/2020 at 03:48 #131439
GeoffM
Avatar
6380 posts
Reverted the code block part. I remember why it took me so long to get back to it.
SimSig Boss
Log in to reply