diff options
author | Jonas Smedegaard <dr@jones.dk> | 2014-12-27 18:44:19 +0100 |
---|---|---|
committer | Jonas Smedegaard <dr@jones.dk> | 2014-12-27 18:44:19 +0100 |
commit | 8449401165efb3e88b3f7931f554d28d323ea8a5 (patch) | |
tree | 4d803ab2d1d391ce03761d2ada718e07a86a4b6f | |
parent | 4810f4a006f893e39bedf69e2fb3e27bb7639634 (diff) |
Rewrite EDITING: Cover dash and short quotes. Mention quote cleanup. Misc minor rewording,
-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 |