From 8449401165efb3e88b3f7931f554d28d323ea8a5 Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Sat, 27 Dec 2014 18:44:19 +0100 Subject: Rewrite EDITING: Cover dash and short quotes. Mention quote cleanup. Misc minor rewording, --- EDITING | 25 ++++++++++++++----------- 1 file changed, 14 insertions(+), 11 deletions(-) (limited to 'EDITING') 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 Mon, 15 Dec 2014 15:28:48 +0100 -- cgit v1.2.3