足跡: 编辑规范

编辑规范

编辑规范

DokuWiki 功能使用策略

提示步骤

(step) <说明文字>

例:

(step) 第一步。

(step) 第二步。

效果:

☛    第一步。

☛    第二步。

快捷键

使用行内代码块。快捷键与其余文本需加入空格。

例:

按下 ''SHIFT'' 的同时点击箱子。

效果:

按下 SHIFT 的同时点击箱子。

着重标记文本

请注意:粗体字的作用不是着重标记文本,而是作为 “段落说明” 使用。

欲着重标记文本,使用 <wrap cjk-em>

例:

输入单价,<wrap cjk-em>请输入负数</wrap>。

效果:

输入单价,请输入负数

文字使用策略

CJK 文本

  • 现代汉语(无论是什么方言):使用规范汉字。
  • 日语中的汉字:使用日本新字体。
  • 韩、越南语中的汉字:不采用地域制定的文字标准,以传统上的正字为标准。
  • 引用传统汉语文本(如诗歌、典故):不采用地域制定的文字标准,以传统上的正字为标准。若只是在现代汉语的文本中短暂引用一两句诗歌典故表达情感者不遵守此条。

拉丁文本

  • 缩写词语需全部大写(如 BIOS MC),单词之间需要空格。
  • 英语:一句话的首字母需大写。

标点符号使用策略

拉丁文引号

用 “” 而非 ""

例:

Lorem ipsum dolor “sit amet”

半角逗号、句号与其余文字混排

句号、逗号前不空格,后空格。如果前方是标点符号,则不在前方空格。如:

foo, bar.
“foo”, bar.

全角弯引号、括号同其余文字混排

前后皆需空格。如果后方是标点符号,则不在后方空格。如:

foo “bar” foo.
foo “bar”, foo bar.

斜线与其余文字混排

前后皆不要空格。例:

GNU/Linux
Input/Output

CJK 文本

引号一律用「」

例:

一二三「上下」天地人

句读样式

  • 现代汉语(无论是什么方言),使用 ,。
  • 日韩语及汉喃,使用 、。
  • 引用传统汉语文本(如诗歌、典故)时,不论白话或文言,一律用 、。。若只是在现代汉语的文本中短暂引用一两句诗歌典故表达情感者不遵守此条。

CJK 全角标点符号同其余文本混排

无论何种情况,前后皆不空格。如:

一二(三),上下,「天地人」。

斜线与其余文字混排

前后皆要有空格。例:

输入 / 输出
自由 / 开源

不同文字交错混排的情况

CJK 文字、拉丁文字、阿拉伯数字混排

CJK 文字、拉丁文字、阿拉伯数字混排时,他们之间需要加入空格。

半角的字母与形如汉字的方块字放在一行上时,就需要加空格。这是为了尊重半角字母使用空格划分单词的习惯。

例:

CJK 文本,IBM 兼容机

斜线同 CJK 文字、拉丁文、阿拉伯数字混排

规则一:若斜线任意一侧包含多种文本的混合,则加空格。

例:

MiGa 132 / BaaSH
十目 CEO / 砸微软总部

规则二:若斜线左右两侧为有一侧是 CJK 文本,则加空格。

例:

微软 / Microshit
wiki/编辑规范.txt · 上一次變更: 2023/12/06 11:38 由 nikoqw
GNU Free Documentation License 1.3 若無特別註明,本 wiki 上的內容都是採用以下授權方式: GNU Free Documentation License 1.3