這是本文件的舊版!
编辑规范
DokuWiki 功能使用策略
提示步骤
(step) <说明文字>
例:
(step) 第一步。 (step) 第二步。
效果:
☛ 第一步。
☛ 第二步。
快捷键
使用行内代码块。快捷键与其余文本需加入空格。
例:
按下 ''SHIFT'' 的同时点击箱子。
效果:
按下 SHIFT
的同时点击箱子。
着重标记文本
请注意:粗体字的作用不是着重标记文本,而是作为 “段落说明” 使用。
欲着重标记文本,使用 <wrap cjk-em>
。
例:
输入单价,<wrap cjk-em>请输入负数</wrap>。
效果:
输入单价,请输入负数。
文字使用策略
CJK 文本
- 现代汉语(无论是什么方言):使用规范汉字。
- 日语中的汉字:使用日本新字体。
- 韩、越南语中的汉字:不采用地域制定的文字标准,以传统上的正字为标准。
- 引用传统汉语文本(如诗歌、典故):不采用地域制定的文字标准,以传统上的正字为标准。若只是在现代汉语的文本中短暂引用一两句诗歌典故表达情感者不遵守此条。
拉丁文本
- 缩写词语需全部大写(如
BIOS
MC
),单词之间需要空格。 - 英语:一句话的首字母需大写。
标点符号使用策略
英文引号用 “” 而非 ""
例:
Lorem ipsum dolor “sit amet”
CJK 文本:引号一律用「」
例:
一二三「上下」天地人
CJK 文本句读使用规则
- 现代汉语(无论是什么方言),使用
,。
。 - 日韩语及汉喃,使用
、。
。 - 引用传统汉语文本(如诗歌、典故)时,不论白话或文言,一律用
、。
。若只是在现代汉语的文本中短暂引用一两句诗歌典故表达情感者不遵守此条。
不同文字混排
汉字、英文、阿拉伯数字混排
汉字、英文、阿拉伯数字混排时,他们之间需要加入空格。
规则很简单:半角的字母与形如汉字的方块字放在一行上时,就需要加空格。
这是因为半角的字母通常使用空格划分单词,但形如汉字的方块字不用。
例:
CJK 文本,IBM 兼容机
标点符号与其他文字混排
半角逗号、句号
句号、逗号前不空格,后空格。如果前方是标点符号,则不在前方空格。如:
foo, bar. “foo”, bar.
全角弯引号、括号
前后皆需空格。如果后方是标点符号,则不在后方空格。如:
foo “bar” foo. foo “bar”, foo bar.
CJK 全角标点符号
无论何种情况,前后皆不空格。如:
一二(三),上下,「天地人」。