From c6e65751c9f53aa754343ee18e7900127b16595d Mon Sep 17 00:00:00 2001 From: Ruijie Yu Date: Wed, 19 Apr 2023 10:36:22 +0800 Subject: [PATCH] Update zh-CN tutorial translation * etc/tutorials/TUTORIAL.cn (INTRO): additions from English version; fixed minor inconsistency (English says C-g quits half-way entered command, Chinese used to say half-way executed command -- they are different); converted half-width square brackets into full-width ones for consistency. (BASIC CURSOR CONTROL): mention that a word boundary for Chinese can also be space; fixed incorrect terminology (keyboard vs terminal); ensure space is added on both ends of an English word. (WINDOWS): clarify it is the digit 1 in C-x 1. (INSERTING AND DELETING): mention the term "continuation line" because this term is mentioned again later in the tutorial; add description for "electric" and a rough translation; sync English for prefix argument for DEL and C-d; ensure that "translator notes" are marked explicitly so; additional translations such as mentioning C--, etc. (FILES): re-pluralized the heading; space around English words; describe what C-g cancels (the command) when entering file name; minor rephrasing; explicit translator notes. (BUFFERS): re-pluralized the heading; mention that C-x C-b also shows buffer name; C-x s only looks for file-visiting buffers. (EXTENDING THE COMMAND SET): include C-x s and C-x b in list of learned commands. (MODE LINE): removed the dashes in description on the point location. (MULTIPLE WINDOWS): add mentioning of the difference between frame and window; also added translator notes pointing to end of tutorial which contains a terminology list. (MULTIPLE FRAMES): change the M-x commands to keybinds C-x 5 2 and C-x 5 0 to sync with English. (GETTING MORE HELP): C-h f changed to C-h x to sync with English. (INSTALLING PACKAGES): rephrase "available packages", used to say lit., "existing", now says lit., "installable". (TRANSLATION): TODO, add my name there. --- etc/tutorials/TUTORIAL.cn | 118 ++++++++++++++++++++++---------------- 1 file changed, 68 insertions(+), 50 deletions(-) diff --git a/etc/tutorials/TUTORIAL.cn b/etc/tutorials/TUTORIAL.cn index 73df2cff4e7..3ac9394bb5a 100644 --- a/etc/tutorials/TUTORIAL.cn +++ b/etc/tutorials/TUTORIAL.cn @@ -15,10 +15,10 @@ META 键(有时候用 EDIT 或 ALT 来标示)。为了避免每次都要写 ESC 键。 重要提示:要退出 Emacs,请用 C-x C-c(两个连续的组合键)。 -要退出一个正在运行中的命令,请用 C-g。 +要退出一个正在输入的命令,请用 C-g。 下文中左边顶行的“>>”字样用来提示你尝试键盘命令。比如: <> -[本页当中特意留出一些空白是出于教学目的,请继续往后阅读] +【本页当中特意留出一些空白是出于教学目的,请继续往后阅读】 >> 现在输入 C-v (查看下一屏文字)移动到下一屏。 (别紧张,在输入字符 v 的同时注意要按住 CONTROL 键) 从现在开始,每读完当前一屏你都需要这样做一次。 @@ -26,12 +26,17 @@ META 键(有时候用 EDIT 或 ALT 来标示)。为了避免每次都要写 值得注意的是,当你从上一屏滚到下一屏时,中间会有两行的重复;这样做是为 了维持滚屏的连续性,方便你顺畅、连续地阅读。 +这是 Emacs 教程文本的一个经过少量修改的副本。不久后我们会让你尝试不同 +的命令来修改此文本。若你在我们提到这些命令前修改了文本,不要担心;这就 +叫做“编辑”,而这就是 Emacs 存在的根本原因。 + 用编辑器,开门第一件事就是学会在文字中移动。你已经知道了 C-v 可以向下移 动一屏,要往上移,请用 M-v (也就是按住 META 键,然后输入v,如果你没有 META、EDIT 或 ALT 键那么就先按 再按 v)。 >> 试试 M-v,然后再试试 C-v,来回遛几次。 +若你知道其他移动文本的方式,也可以在这里试试。 * 小结(SUMMARY) ----------------- @@ -101,7 +106,7 @@ P 代表 previous(上一行),N 代表 next(下一行),B 代表 backw 如果你嫌一个字符一个字符地挪光标太慢,你还可以一个词一个词地跳。M-f (META-f) 可以将光标往前移动一个词,而 M-b 则是往后移。【这里的“词”指 -英文单词,对中文来说,则是指移动到下一个标点符号。】 +英文单词,对中文来说,则是指移动到下一个空格或标点符号。】 >> 试试 M-f 和 M-b。 @@ -132,8 +137,8 @@ P 代表 previous(上一行),N 代表 next(下一行),B 代表 backw C-f 向右移动一个字符 C-b 向左移动一个字符 - M-f 向右移动一个词【对中文是移动到下一个标点符号】 - M-b 向左移动一个词【对中文是移动到上一个标点符号】 + M-f 向右移动一个词【对中文是移动到下一个空格或标点符号】 + M-b 向左移动一个词【对中文是移动到上一个空格或标点符号】 C-n 移动到下一行 C-p 移动到上一行 @@ -160,7 +165,7 @@ M-comma(META 逗号)。 然后再按几次 M-v 回到这里。 如果你的键盘上有方向键的话,也可以用它们来移动光标。不过我们有三个理由 -推荐你学习 C-b 、C-f 、C-n 、和 C-p:(1)它们在任何键盘上都能用。(2) +推荐你学习 C-b 、C-f 、C-n 、和 C-p:(1)它们在任何终端上都能用。(2) 当你熟练使用 Emacs 之后,你会发现用这些组合键比用方向键要快得多,因为你 的手不需要离开打字区。(3)一旦你习惯了使用这些组合键,你也可以很容易地 适应其它更高级的光标移动命令。 @@ -189,7 +194,7 @@ EDIT 或 ALT)键,那么还有另一种办法:按住 META 键不放,然 这个命令应该已经将文字向上滚动了 8 行。如果你想将它再次地向下滚动,你可 以给定一个参数然后执行 M-v。 -如果你正在使用图形界面,比如 X 或者微软的 Windows,那么在 Emacs窗 +如果你正在使用图形界面,比如 X 或者微软的 Windows,那么在 Emacs 窗 口的一边应该有一个长方形的区域叫“滚动条”。你可以用鼠标操纵滚动条来滚动 文字。 @@ -235,8 +240,8 @@ Emacs 可以有多个“窗格”,每个窗格显示不同的文字。后面 C-x 1 只保留一个窗格(也就是关掉其它所有窗格)。 -也就是先按 CONTROL-x 然后再按 1。C-x 1 会保留光标所在的窗格,并将其扩大 -到整个屏幕,同时关掉所有其它的窗格。 +也就是先按 CONTROL-x 然后再按数字1。C-x 1 会保留光标所在的窗格,并将其 +扩大到整个屏幕,同时关掉所有其它的窗格。 >> 把光标移到本行然后输入 C-u 0 C-l。 @@ -266,9 +271,9 @@ Emacs 可以有多个“窗格”,每个窗格显示不同的文字。后面 不用担心文件被修改,你做什么都没关系,这里就是专给你练习用的。 如果一行文字很长、超出了窗格的宽度,显示不下的部分会在紧邻的下一行继续 -显示。如果你使用的是图形界面,文本区域两边的狭窄区域(左右“边缘”)会出 -现小小的转弯箭头,表明这是某一行的接续显示。如果你使用的是文本终端,接 -续显示由屏幕最右边一列的一个反斜线(“\”)来表示。 +显示,称为接续行。如果你使用的是图形界面,文本区域两边的狭窄区域(左右 +“边缘”)会出现小小的转弯箭头,表明这是某一行的接续显示。如果你使用的是 +文本终端,接续显示由屏幕最右边一列的一个反斜线(“\”)来表示。 >> 输入文字,一直到屏幕的右边界,然后继续。 你会看到一个接续行出现。 @@ -286,7 +291,9 @@ Emacs 可以有多个“窗格”,每个窗格显示不同的文字。后面 是一个特殊的键,因为按下这个键后,得到的可能不仅仅是一个换行 符。根据周围文本的不同,Emacs 可能会在换行符之后插入一些空白字符,这样, -当你在新的一行开始打字时,文本会自动与前一行对齐。 +当你在新的一行开始打字时,文本会自动与前一行对齐。我们称这种行为(在按 +这个按键时不只是插入其对应字符)为“electric”,可以理解为“通电的,自动 +的”。 >> 这是一个自动缩进的例子。 在这一行的末尾输入 。 @@ -338,7 +345,8 @@ Emacs 可以有多个“窗格”,每个窗格显示不同的文字。后面 了。】重新插入被移除的文字称为“召回(yank)”。一般而言,那些可能消除很 多文字的命令会把消除掉的文字记录下来(它们被设定成了“可召回”),而那些 只消除一个字符或者只消除空白的命令就不会记录被消除的内容(自然你也就无 -法召回了)。 +法召回了)。 和 C-d 在无前缀参数的情况下进行“删除”,而有前缀参数 +时则改用“移除”。 >> 移动光标到一非空白行的行头,然后输入 C-k 移除那一行上的文字。 @@ -350,10 +358,11 @@ Emacs 可以有多个“窗格”,每个窗格显示不同的文字。后面 C-k 会把两行以及它们的换行符移除;而如果只是输入 C-k 两次显然不是这个结 果。 -重新插入被移除的文字恢复的动作称为“召回(yanking)”。(就好像把别人从你身边 -移走的东西又猛力地拉回来。)你可以在你删除文字的地方召回,也可以在别的 -地方召回,还可以多次召回同样的文字以得到它的多个拷贝。很多其它的编辑器 -把移除和召回叫做“剪切”和“粘贴” (详情可见 Emacs 使用手册里的术语表)。 +【重新插入被移除的文字恢复的动作称为“召回(yanking)”,就好像把别人 +从你身边移走的东西又猛力地拉回来。】你可以在你删除文字的地方召回,也 +可以在别的地方召回,还可以多次召回同样的文字以得到它的多个拷贝。很多其 +它的编辑器把移除和召回叫做“剪切”和“粘贴” (详情可见 Emacs 使用手册里的 +术语表)。 召回的命令是 C-y。它会在光标所在处插入你最后移除的文字。 @@ -372,8 +381,8 @@ C-y 就可以把它们都召回。 C-y 可以召回最近一次移除的内容,那如何召回前几次移除的内容呢?它们当然 没有丢,你可以用 M-y 来召回它们。在用 C-y 召回最近移除的文字之后,紧接 着再按 M-y 就可以召回再前一次被移除的内容,再按一次 M-y 又可以召回再上 -一次的……连续使用 M-y 直到找到你想要召回的东西,然后什么也不用做,继续 -编辑就行了。 +一次的内容……连续使用 M-y 直到找到你想要召回的东西,然后什么也不用做, +继续编辑就行了。 如果连续按 M-y 很多次,你可能会回到起始点,也就是最近移除的文字。 【看得出这实际上是一个环。】 @@ -401,14 +410,16 @@ C-/,你会把以前的命令也依次撤销。 >> 用 C-k 将这一行移除,然后输入 C-/ ,它会再次出现。 -C-_ 也是撤销命令;它的作用跟 C-/ 一样,但是它比较容易多次输入。在 -某些终端上,输入 C-/ 实际上向 Emacs 发送的是 C-_ 。 -另外, C-x u 和 C-/ 完全一样,但是按起来有些麻烦。 +C-_ 也是撤销命令;它的作用跟 C-/ 一样,但是它比较容易多次输入。在某些 +终端上,你可以不按 shift 键(即 C--)。在某些终端上,输入 C-/ 实际上向 +Emacs 发送的是 C-_ 。另外, C-x u 和 C-/ 完全一样,但是按起来有些麻烦。 数字参数对于 C-/ 、 C-_ 和 C-x u 的意义是执行撤销的重复次数。 +你可以撤销文字的删除,就像你能撤销文字的移除一样。删除与移除的区别只在 +于你是否能召回被影响的文字;对于撤销来说没有区别。 -* 文件(FILE) +* 文件(FILES) -------------- 想保存工作成果就要记得存盘,否则一旦退出 Emacs 你编辑的文字就会丢失。要 @@ -424,7 +435,7 @@ C-_ 也是撤销命令;它的作用跟 C-/ 一样,但是它比较容易多 在屏幕的下方,你应该能够看到头部有短线“-”的一行,行首通常是一些诸如“ -:--- TUTORIAL.cn”的文字,这些文字代表了你当前正在访问的文件。比如你现 在正在访问的文件是对 Emacs 快速指南的一份临时拷贝,叫做“TUTORIAL.cn”。 -每当Emacs 寻找到一个文件,文件名就会出现在这个位置。 +每当 Emacs 寻找到一个文件,文件名就会出现在这个位置。 寻找文件的命令有一个特点,那就是你必须给出文件名。我们称这个命令“读入 了一个参数”(在这里,这个参数显然就是文件名)。在你输入这条命令之后: @@ -435,14 +446,14 @@ Emacs 会提示你输入文件名。你输入的文件名会出现在屏幕最 行被称为小缓冲(minibuffer),在小缓冲里你可以使用通常的 Emacs 编辑命令 来编辑文件名。 -在小缓冲里输入文件名(其实输入其它东西也一样)时可以用 C-g 取消。 +在小缓冲里输入文件名(其实输入其它东西也一样)时可以用 C-g 取消这个命令。 >> 输入 C-x C-f,然后输入 C-g 这会关掉小缓冲,同时也会取消使用小缓冲的 C-x C-f 命令。 - 当然了,你也没有找任何文件。 + 当然了,你也没有找到任何文件。 -用 结束文件名的输入。之后,小缓冲会消失,C-x C-f 将会去寻找你 -指定的文件。小缓冲在 C-x C-f 命令结束之后也会消失。 +当你写完要寻找的文件名时,用 结束文件名的输入。之后,小缓冲会 +消失,C-x C-f 将会去寻找你指定的文件。 文件被显示在了屏幕上,你可以开始编辑了。存盘用这条命令: @@ -453,20 +464,21 @@ Emacs 会提示你输入文件名。你输入的文件名会出现在屏幕最 【对许多人来说,这是一个烦人的特性,关掉文件备份可以用如下命令: M-x customize-variable make-backup-files 】 -存盘结束后,Emacs 会显示写入文件的文件名。你最好养成经常存盘的习惯,这 -可以减少系统崩溃和死机给你带来的损失(也可参见下面的“自动保存”一节)。 +存盘结束后,Emacs 会显示写入文件的文件名。【你最好养成经常存盘的习惯, +这可以减少系统崩溃和死机给你带来的损失(也可参见下面的“自动保存”一 +节)。】 >> 输入 C-x C-s TUTORIAL.cn 。 这将会把该指南保存为一个名为 TUTORIAL.cn 的文件,并且在屏幕的下方显 示一条消息:“Wrote ...TUTORIAL.cn”。 你不但可以寻找一个已有的文件来查看或编辑,还可以寻找一个不存在的文件。 -实际上这正是 Emacs 创建新文件的方法:找到不存在的新文件。事实上,只有 -在存盘的时候,Emacs 才会真正创建这个文件。而在这之后的一切就跟编辑一个 -已有文件没有区别了。 +实际上这正是 Emacs 创建新文件的方法:找到不存在的新文件,它一开始是空 +的,然后你就可以开始插入文本。事实上,只有在存盘的时候,Emacs 才会真正 +创建这个文件。而在这之后的一切就跟编辑一个已有文件没有区别了。 -* 缓冲区(BUFFER) +* 缓冲区(BUFFERS) ------------------ 你可以用 C-x C-f 找到并打开第二个文件,但第一个文件仍然在 Emacs 中。要 @@ -495,7 +507,7 @@ C-x C-f 是一种办法。不过还有一个更简单的办法,那就是用 C- 然后输入 C-x b TUTORIAL.cn 回到这里。 大多数情况下,缓冲区与跟其对应的文件是同名的(不包括目录名),不过这也 -不是绝对的。用 C-x C-b 得到的缓冲区列表总是显示缓冲区名。 +不是绝对的。因此用 C-x C-b 得到的缓冲区列表总是显示缓冲区名与文件名。 缓冲区未必有对应文件。显示缓冲区列表的缓冲区(叫做“*Buffer List*”)就 是这样。这个 TUTORIAL.cn 缓冲区起初没有对应的文件,但是现在有了,因为 @@ -516,8 +528,8 @@ C-x C-f 是一种办法。不过还有一个更简单的办法,那就是用 C- C-x s 保存多个缓冲区 -C-x s 会找出所有已被修改但尚未存盘的缓冲区,然后向你逐个询问:是否需要 -存盘? +C-x s 会找出所有访问文件的、且已被修改但尚未存盘的缓冲区,然后向你逐个 +询问:是否需要存盘此文件? >> 插入一行文字,然后输入 C-x s。 它应该会问你,是否要储存名为 TUTORIAL.cn 的缓冲区? @@ -554,7 +566,9 @@ C-x 的扩展命令有很多,下面列出的是你已经学过的: C-x C-f 寻找文件。 C-x C-s 保存文件。 + C-x s 保存多个缓冲区。 C-x C-b 列出缓冲区。 + C-x b 切换缓冲区。 C-x C-c 离开 Emacs。 C-x 1 关掉其它所有窗格,只保留一个。 C-x u 撤销。 @@ -608,10 +622,10 @@ replace-string(字符串替换)这个命令,它会把一个字符串替换 状态栏显示了 Emacs 的状态和你正在编辑的文字的一些信息。 -你应该知道文件名的意思吧?就是你找到的那个文件嘛。-NN%-- 显示的是光标在 -全文中的位置。如果位于文件的开头,那么就显示 --Top-- 而不是 --00%--;如 -果位于文件的末尾,就显示 --Bot--。如果文件很小,一屏就足以显示全部内容, -那么状态栏会显示 --All--。 +你应该知道文件名的意思吧?就是你找到的那个文件嘛。NN% 显示的是光标在 +全文中的位置。如果位于文件的开头,那么就显示 Top 而不是 0%;如 +果位于文件的末尾,就显示 Bot。如果文件很小,一屏就足以显示全部内容, +那么状态栏会显示 All。 “L” 和其后的数字给出了光标所在行的行号。 @@ -723,7 +737,10 @@ C-s 是向前搜索,C-r 是向后搜索。不过手别这么快!别着急试 * 多窗格(MULTIPLE WINDOWS) ---------------------------- -Emacs 的迷人之处很多,能够在屏幕上同时显示多个窗格就是其中之一。 +Emacs 的迷人之处很多,能够在屏幕上同时显示多个窗格就是其中之一。(请注 +意在 Emacs 里的“窗口(frame)”与“窗格(window)”的定义可能与其他应用程 +序不同,详见Emacs 手册里的术语表。)【另见此教程末尾的翻译章节的术语译 +词对照表。】 >> 移动光标到这一行,然后输入 C-l C-l。 @@ -782,13 +799,13 @@ Emacs 可以创建多个窗口。窗口由许多窗格以及菜单、滚动条 在图形界面下,多个窗口可以同时显示出来。在文本终端中,只能同时显示一个 窗口。 ->> 输入 M-x make-frame 。 +>> 输入 C-x 5 2。 可以看到一个新的窗口出现在了你的屏幕上。 你可以在新的窗口里做最初的窗口里可以做的任何事情。第一个窗口没有什么特 别的。 ->> 输入 M-x delete-frame . +>> 输入 C-x 5 0。 这个命令将会关闭选中的窗口。 你也可以通过图形系统来关闭某个窗口(通常是在窗口上面的某个角落里的一个 @@ -853,9 +870,9 @@ Emacs 可以创建多个窗口。窗口由许多窗格以及菜单、滚动条 还有一些其它有用的 C-h 命令: - C-h f 解释一个函数。需要输入函数名。 + C-h x 解释一个命令。需要输入命令名。 ->> 试试看,输入 C-h f previous-line 。 +>> 试试看,输入 C-h x previous-line 。 Emacs 会给出它所知道的所有有关“实现 C-p 命令功能的函数”的信息。 C-h v 用来显示 Emacs 变量的文档。Emacs 变量可以被用来“定制 Emacs 的行 @@ -911,9 +928,9 @@ Emacs 使用手册里还有许许多多的精彩功能等着你来了解。 Emacs 社区著作了许多持有扩展性的包裹(packages),其中包括对各种语言的 支持、色彩鲜艳的主题、用于集成外部程序的包裹,等等。 -使用 M-x list-packages 便可浏览存在的包裹。这个命令显示的界面中可以安 -装和卸载包裹,以及查看包裹的简介。Emacs 使用手册中有对包裹管理更详细的 -介绍。 +使用 M-x list-packages 便可浏览所有可安装的包裹。这个命令显示的界面中 +可以安装和卸载包裹,以及查看包裹的简介。Emacs 使用手册中有对包裹管理更 +详细的介绍。 * 总结(CONCLUSION) -------------------- @@ -929,6 +946,7 @@ Emacs 社区著作了许多持有扩展性的包裹(packages),其中包括 翻译:孙一江 维护:薛富侨 +;; Ruijie Yu ; TODO 校对:水木社区(www.newsmth.net)Emacs 板众多网友及众多 Emacs 中文用户 Emacs 快速指南(Tutorial)早有两个刘昭宏的中文译本,繁简各一。其简体版本 -- 2.40.0