summaryrefslogtreecommitdiff
path: root/EDITING
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2014-12-27 18:44:19 +0100
committerJonas Smedegaard <dr@jones.dk>2014-12-27 18:44:19 +0100
commit8449401165efb3e88b3f7931f554d28d323ea8a5 (patch)
tree4d803ab2d1d391ce03761d2ada718e07a86a4b6f /EDITING
parent4810f4a006f893e39bedf69e2fb3e27bb7639634 (diff)
Rewrite EDITING: Cover dash and short quotes. Mention quote cleanup. Misc minor rewording,
Diffstat (limited to 'EDITING')
-rw-r--r--EDITING25
1 files changed, 14 insertions, 11 deletions
diff --git a/EDITING b/EDITING
index 5c7daa3..3e27304 100644
--- a/EDITING
+++ b/EDITING
@@ -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