编辑规范

差異處

這裏顯示兩個版本的差異處。

--- wiki:编辑规范 [2023/01/05 10:38] – nikoqw
+++ wiki:编辑规范 [2023/12/06 11:38] (目前版本) – [CJK 文字、拉丁文字、阿拉伯数字混排] nikoqw
@@ 行 1: / 行 1: @@
+{{indexmenu_n>10}}
 ====== 编辑规范 ======
+===== DokuWiki 功能使用策略 =====
+==== 提示步骤 ====
+<code>
+(step) <说明文字>
+</code>
+**例：**
+<code>
+(step) 第一步。
+(step) 第二步。
+</code>
+**效果：**
+(step) 第一步。
+(step) 第二步。
+==== 快捷键 ====
+使用行内代码块。快捷键与其余文本需加入空格。
+**例：**
+<code>
+按下 ''SHIFT'' 的同时点击箱子。
+</code>
+**效果：**
+按下 ''SHIFT'' 的同时点击箱子。
+==== 着重标记文本 ====
+请注意：粗体字的作用不是着重标记文本，而是作为 “段落说明” 使用。
+欲着重标记文本，使用 ''<nowiki><wrap cjk-em></nowiki>''。
+**例：**
+<code>
+输入单价，<wrap cjk-em>请输入负数</wrap>。
+</code>
+**效果：**
+输入单价，<wrap cjk-em>请输入负数</wrap>。
 ===== 文字使用策略 =====
 ==== CJK 文本 ====
   * 现代汉语（无论是什么方言）：使用规范汉字。
   * 日语中的汉字：使用日本新字体。
-  * 韩、越南语中的汉字：不采用地域制定的文字标准，以文字学上的正字为标准。
+  * 韩、越南语中的汉字：不采用地域制定的文字标准，以传统上的正字为标准。
-  * 引用传统汉语文本（如诗歌、典故）：不采用地域制定的文字标准，以文字学上的正字为标准。若只是在现代汉语的文本中短暂引用一两句诗歌典故表达情感者不遵守此条。
+  * 引用传统汉语文本（如诗歌、典故）：不采用地域制定的文字标准，以传统上的正字为标准。若只是在现代汉语的文本中短暂引用一两句诗歌典故表达情感者不遵守此条。
 ==== 拉丁文本 ====
-  * 缩写词语需全部大写（如''BIOS'' ''MC''），单词之间需要空格。
+  * 缩写词语需全部大写（如 ''%%BIOS%%'' ''%%MC%%''），单词之间需要空格。
   * 英语：一句话的首字母需大写。
 ===== 标点符号使用策略 =====
-==== 英文引号用 “” 而非 "" ====
+==== 拉丁文引号 ====
+=== 用 “” 而非 "" ===
 例：
@@ 行 19: / 行 61: @@
 </code>
-==== CJK 文本：引号一律用「」 ====
+=== 半角逗号、句号与其余文字混排 ===
-例：
+句号、逗号前不空格，后空格。如果前方是标点符号，则不在前方空格。如：
+<code>
+foo, bar.
+“foo”, bar.
+</code>
+=== 全角弯引号、括号同其余文字混排 ===
+前后皆需空格。如果后方是标点符号，则不在后方空格。如：
 <code>
-一二三「上下」天地人
+foo “bar” foo.
+foo “bar”, foo bar.
 </code>
-==== CJK 文本句读使用规则====
+=== 斜线与其余文字混排 ===
-  * 现代汉语（无论是什么方言），使用''，。''。
+前后皆不要空格。例：
-  * 日韩语，使用''、。''。
+<code>
-  * 引用传统汉语文本（如诗歌、典故）时，不论白话或文言，一律用''、。''。若只是在现代汉语的文本中短暂引用一两句诗歌典故表达情感者不遵守此条。
+GNU/Linux
+Input/Output
+</code>
-===== 不同文字混排 =====
+==== CJK 文本 ====
-==== 汉字、英文、阿拉伯数字混排 ====
+=== 引号一律用「」 ===
-汉字、英文、阿拉伯数字混排时，他们之间需要加入空格。
+例：
-规则很简单：半角的字母与形如汉字的方块字放在一行上时，就需要加空格。
+<code>
+一二三「上下」天地人
+</code>
-这是因为半角的字母通常使用空格划分单词，但形如汉字的方块字不用。
+=== 句读样式 ===
+  * 现代汉语（无论是什么方言），使用 ''，。''。
+  * 日韩语及汉喃，使用 ''、。''。
+  * 引用传统汉语文本（如诗歌、典故）时，不论白话或文言，一律用 ''、。''。若只是在现代汉语的文本中短暂引用一两句诗歌典故表达情感者不遵守此条。
-例：
+=== CJK 全角标点符号同其余文本混排 ===
+无论何种情况，前后皆不空格。如：
 <code>
-CJK 文本，IBM 兼容机
+一二（三），上下，「天地人」。
 </code>
-==== 标点符号与其他文字混排 ====
+=== 斜线与其余文字混排 ===
-=== 半角逗号、句号 ===
+前后皆要有空格。例：
-句号、逗号前不空格，后空格。如果前方是标点符号，则不在前方空格。如：
 <code>
-foo, bar.
+输入 / 输出
-“foo”, bar.
+自由 / 开源
 </code>
-=== 全角弯引号、括号 ===
-前后皆需空格。如果后方是标点符号，则不在后方空格。如：
+===== 不同文字交错混排的情况 =====
+==== CJK 文字、拉丁文字、阿拉伯数字混排 ====
+CJK 文字、拉丁文字、阿拉伯数字混排时，他们之间需要加入空格。
+半角的字母与形如汉字的方块字放在一行上时，就需要加空格。这是为了尊重半角字母使用空格划分单词的习惯。
+例：
 <code>
-foo “bar”
+CJK 文本，IBM 兼容机
-foo “bar”, foo bar.
 </code>
-=== CJK 全角标点符号 ===
-无论何种情况，前后皆不空格。如：
+==== 斜线同 CJK 文字、拉丁文、阿拉伯数字混排 ====
+=== 规则一：若斜线任意一侧包含多种文本的混合，则加空格。 ===
+例：
 <code>
-一二（三），上下，「天地人」。
+MiGa 132 / BaaSH
+十目 CEO / 砸微软总部
 </code>
+=== 规则二：若斜线左右两侧为有一侧是 CJK 文本，则加空格。===
+例：
+<code>
+微软 / Microshit
+</code>