summaryrefslogtreecommitdiff
path: root/EDITING
blob: 5e2b04c5236811eb799578e3f33c1a79a6b3884b (plain)
  1. Wiki editing guideline
  2. ======================
  3. Ideally, text authors should apply only semantic (not visual) markup.
  4. Unfortunately, Markdown and Mediawiki formats only cover visual markup.
  5. These are suggestions for pseudo-semantic Markdown/Mediawiki markup,
  6. suitable for post-processing into both web-based and print formats.
  7. * Use emphasis + doublequote for foreign terms.
  8. * Use doublequote + emphasis for titles.
  9. * Use strong emphasis only for essential keywords, and very sparsely.
  10. * Use blockquote only for citation (not as emphasis for other blocks).
  11. * Use blockquote for citation block (not blockquote + other quotes).
  12. * Use bibliography at each citation (preferrably at the end).
  13. * Use canonical URL in hyperlink (not wikilink or relative URL).
  14. * Use hyperlink only in footnote and bibliography (not in text body).
  15. * Use square brackets for meta comments (not paranthesis).
  16. * Use verbatim only for code and shell commands.
  17. -- Jonas Smedegaard <dr@jones.dk> Mon, 15 Dec 2014 15:28:48 +0100