(anonymous guest) (logged out)

Copyright (C) by the contributors. Some rights reserved, license BY-SA.

Sponsored by the Wiki Symposium and the Nuveon GmbH.

 

Add new attachment

Only authorized users are allowed to upload new attachments.

This page (revision-23) was last changed on 26-Sep-2007 09:44 by ChuckSmith  

This page was created on 23-Sep-2006 18:43 by null

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 1 changed one line
This part of the wiki is intended to document the reasons behind choosing particular markup for [Creole], as well as to allow discussion of particular choices and propositions. These practices where derived from the [Goals] and the experiences Implementers and Users of Creole made.
This part of the wiki is intended to document the reasons behind choosing particular markup for [Creole], as well as to allow discussion of particular choices and propositions. These practices where derived from the [Goals] and the experiences implementers and users of Creole made.
At line 3 changed one line
[Creole] covers markup for some [CommonTextElements]. The markup should be [EasyToLearn] and [EasyToTeach], as well as [FastToType] and should use [ReadableMarkup] which is [NonDestructive].
[Creole] covers markup for some [CommonTextElements]. The markup should be [EasyToLearn] and [EasyToTeach], as well as [FastToType] and should use [ReadableMarkup] which is [NonDestructive]. It should cover the [[CommonThingsPeopleNeed]].
At line 5 changed one line
The special role of common markup requires it to be [ExtensibleByOmission], [NotNew] and [CollisionFree] with markup used commonly on wikis.
The special role of common markup requires it to be [ExtensibleByOmission], [NotNew] and [CollisionFree] with markup used commonly on wikis. A markup should not be designed around [[EdgeCases]].
At line 9 changed one line
Because we want [Creole] to be widely adopted, we need to make it easy to parse using [CommonWikiParsingTechniques], and also easy to explain, preferably using a prepared simple [CheatSheet]. In order to make it easy to explain, that means, intuitive, parser implementers might have to [MakeTheMachineWorkHarder].
Because we want [Creole] to be widely adopted, we need to make it easy to parse using [CommonWikiParsingTechniques], and also easy to explain, preferably using a prepared simple [CheatSheet]. The both goals ''easy to explain'' and ''easy to parse'' sometimes contradict each other. It is generally good practice for developers to listen to their users and [MakeTheMachineWorkHarder] in that case. On the [Ambiguities] page we collect possible markup colissions and strategies to handle them.
At line 11 changed 4 lines
There are [HintsOnExtending] that are supposed to help adding non-standard features to Creole when needed.
----
The only term for the markup page which is generally used is [Text Formatting Rules] across wikis (as shown on [[List of Wiki Markup]]), so I would suggest as a [GoodPractice] to have wiki markup explanation on this page on each wiki or to at have a redirect from that page to the page explaining markup. A redirect would also be preferable if the wiki is not in English. -- [ChuckSmith]
There are [HintsOnExtending] that are supposed to help adding non-standard features to Creole when needed.
Version Date Modified Size Author Changes ... Change note
23 26-Sep-2007 09:44 1.428 kB ChuckSmith to previous restore
22 26-Sep-2007 01:45 1.463 kB 80.97.12.51 to previous | to last
21 26-Sep-2007 01:44 1.452 kB 219.138.204.162 to previous | to last
« This page (revision-23) was last changed on 26-Sep-2007 09:44 by ChuckSmith