[Home]WikiSyntax

MeatballWiki | RecentChanges | Random Page | Indices | Categories

1. Preamble
2. Call for participation
3. PatternLanguage
3.1. Syntax Examples
3.2. Support Idiom
3.3. Link syntax
3.4. Site structure
3.5. External links
3.6. Line and Paragraph
3.7. Block
3.8. Page structure
3.9. CyberText
3.10. Parser theory
3.11. Exchange
3.12. Criticism
3.13. Alternative


1. Preamble

Wiki Syntax, or the hopefully simpler markup that is used in WikiPages instead of HTML. In theory it should look as close to PlainText? as possible, although in reality programmers tend to make this insanely complicated. Although, arguably, a WysiwygWiki would be a HumaneInterface.

There's little consistency across WikiEngines for a variety of reasons. One, there should be no standard syntax. The WikiSyntax is the UserInterface, it is not the data encoding. This point gets lost on many people (e.g. the TikiWiki RFC for standard syntax), but wikis aren't really a medium unto themselves. They are more like pure expressions of CyberText. To get away from philosophy, many wikis have to change their local syntax to fit their local users' needs, such as adding LatexInWiki or conforming to pre-existing documentation markup or pre-existing text formatting conventions in that community. This is as it should be. By now, given the proliferation of syntaxes, it should be clear that it is not reasonable to standardize the syntax.

Working with the NetworkStandard model, we prefer first to develop a backend WikiInterchangeFormat that does not impact the UserInterface, and second not to impose the format on wikis that do not wish to communicate with us. That is simply because each wiki will structure itself as it wants; the complications of mapping an ArchivingNews wiki to a PatternLanguage wiki is too much to consider.

Admittedly the above is the biased opinion of one commenter (me). But for the past seven years, this issue has been pressing on wiki developers who both want to exchange data but not give up on their local syntax. Consider this exchange:

On the other hand, should we aim to establish standards? --anon. (1)

Not yet, I think. We are still searching for the perfect Wiki markup language. Once we discover that perfect language, then we can standardize. --anon. (2)

The demand for a markup standard is there. So let's begin discovery on WikiMarkupStandard. --anon.(3)

I do not subscribe to the idea of a standard for markup, and will make strong arguments against it in the RFC. Markup is dynamic, application dependent, and deeply religious. For similar reasons I do not subscribe to the idea of a WikiParserModel. I absolutely subscribe to the concept of a WikiInterchangeFormat (CanonicalWikiForm?). -- CrawfordCurrie

Having worked on ScalableVectorGraphics and read the W3C specs as well as the C language specification, my rationale for a parser model is simply to give us an underlying theory of how the interchange format will function. If it's not done, and if it's not done properly, the final standard will be highly idiosyncratic, and therefore limit how people can form syntax. -- SunirShah

See TextFormattingRules, TextFormattingRulesSpanish for the local markup.

CategoryWikiTechnology CategoryTextMarkup


2. Call for participation

Please add whatever you think is needed, like missing syntax, parser theory, algorithms, best practices, refactoring, etc. The aim is to build a WikiParserModel and then a WikiInterchangeFormat based on that. -- SunirShah


3. PatternLanguage

3.1. Syntax Examples

Please link to any pages that give fairly complete treatments of wiki markup. Pages here should more or less describe a complete syntax or at least a large part of it; if the page is limited to only a particular link style, search behavior, semantic, etc, use the sections following.

3.2. Support Idiom

XXX FIXME: what does this section mean? None of these terms are even linked.'

3.3. Link syntax

3.4. Site structure

3.5. External links

3.6. Line and Paragraph

3.7. Block

3.8. Page structure

3.9. CyberText

3.10. Parser theory

3.11. Exchange

3.12. Criticism

3.13. Alternative


Discussion

MeatballWiki | RecentChanges | Random Page | Indices | Categories
Edit text of this page | View other revisions
Search: