diff options
Diffstat (limited to 'EDITING')
| -rw-r--r-- | EDITING | 25 |
1 files changed, 14 insertions, 11 deletions
@@ -7,16 +7,19 @@ Unfortunately, Markdown and Mediawiki formats only cover visual markup. These are suggestions for pseudo-semantic Markdown/Mediawiki markup, suitable for post-processing into both web-based and print formats. - * Use emphasis + doublequote for foreign terms. - * Use doublequote + emphasis for titles. - * Use strong emphasis only for essential keywords, and very sparsely. - * Use blockquote only for citation (not as emphasis for other blocks). - * Use blockquote for citation block (not blockquote + other quotes). - * Use bibliography at each citation (preferrably at the end). - * Use direct link (not bibliography) for "see also" style refences. - * Use canonical URL in hyperlink (not wikilink or relative URL). - * Use square brackets for meta comments (not paranthesis). - * Use verbatim only for code and shell commands. - * Fix visual abuse of punctuation or indentation in quoted text. + * Use -- (dash dash) for sentence break or parenthetical statement. + * Use - (hyphen-minus) for ranges or minus (nothing else). + * Use doublequote (") for short quote (e.g. max. 3 lines or 50 words). + * Use singlequote (') for short quote within short quote. + * Use blockquote (alone) for long quote (nothing else). + * Use cite or --- (dash dash dash) after each short or long quote. + * Use hyperlink or footnote for non-citation related info. + * Use emphasis + doublequote for foreign term. + * Use doublequote + emphasis for title. + * Use strong emphasis for essential keyword (nothing else). + * Use canonical URL (not wikilink or relative URL) in hyperlink. + * Use square brackets (not paranthesis) for meta comment. + * Use verbatim for code or shell command (nothing else). + * Fix or remove visual markup in quoted text (e.g. punctuation abuse). -- Jonas Smedegaard <dr@jones.dk> Mon, 15 Dec 2014 15:28:48 +0100 |