水木－Emacs 的 texinfo 模式（一）

水木－Emacs 的 texinfo 模式（一）

null ana

〖 返回〗〖转发〗

来自ana的主页 http://ana.163.net/    -------------------------------------------                    使用 Texinfo 模式        你可以以任何你喜欢的编辑器来编辑 Texinfo 文件。Texinfo 文件和其他的 ASII 文件没有任何不同。然而，GNU Emacs 有一个特殊的Texinfo 模式，它提供了许多命令和工具来改进你的工作。        这一章描述了 Emacs 的 Texinfo 模式的特征，但并不介绍 Texinfo 的格式化语言。也许你需要返回到开始目录阅读 Texinfo 格式化语言的详细介绍。    *目录:    *Texinfo Mode Overview::        Texinfo 模式有那些有用特性。  *Emacs Editing::                Texinfo 模式的编辑特征。  *Inserting::                    怎样插入经常使用的 @ 命令。  *Showing the Structure::        怎样显示文件结构。  *Updating Nodes and Menus::     怎样建立和更新节点和目录。  *Info Formatting::              怎样格式化 Info 文件。  *Printing::                     怎样格式化文件的打印部分。  *Texinfo Mode Summary::         简介所有的 Texinfo 模式命令。             第一节  Texinfo 模式概览        Texinfo 模式提供了许多有用的特性：        *插入经常使用的 @ 命令。        *自动建立 `@node' 行。        *显示 Texinfo 源文件的结构。        *自动建立或更新节点的 `Next', `Previous', `Up'的指向。        *自动建立或更新目录。        *自动的建立主要目录。        *为 Info 文档格式化部分或文件的整个部分。        *设置和打印文件的部分或整个部分。        也许最有用的两个特性是插入常用的 @ 命令和建立节点指向和目录。                   常用的 GNU Emacs 编辑命令        在多数情况下，常用的编辑命令和文本模式下一样，Texinfo 模式仅仅是加入了一些新的命令和工具。主要的区别在于段落填充。在 Texinfo 模式下，段落分隔变量和符号表被重新定义，这样导致有一些行是孤立行。也就是说，`M-q'(`fill-paragrph')(段落填充--也就是段落重排)命令在重排段落的时候，不会把一个索引命令分隔到段落中的其他行去。            另外，Texinfo 模式设置变量 `page-delimiter' 值为 `texinfo-chapter-level-regexp'; 它缺省匹配关于章节等的等价的命令。通过这样设置，你可以从一个章节跳转到另一个章节通过使用命令 `C-x ]'(`forward-page')(向前一页)、`C-x ['(`backward-page')(向后一页)和`C-xp'(`narrow-to-page')(页间跳转)。         你可以给 Texinfo 随意起名，但是最好以以下几个后缀给文件命名:`.texinfo', `.texi', `.txi', `.tex'。尽管对于许多系统来说文件扩展名的长度有限制，我们仍然推荐使用长后缀。当你查看一个以 `.texinfo',`.texi',`.txi'为后缀的文件时，GNU Emacs 自动的进入 Texinfo 模式。当你查看的文件的第一行有文本 `-*-texinfo-*-' 时，Emacs 也会自动的转入Texinfo 模式。假如你在 Emacs 的其他模式中时，你可以用 `M-xtexinfo-mode' 进入 Texinfo 模式。        就象所有其他的 Emacs 特征，你可以自已定义 Texinfo 模式。它的定义非常容易改变，这儿所说的都是缺省值。                    插入常用的命令        Texinfo 模式提供了许多命令来插入各种常用的 @ 命令。        用输入 `C-c' 两次再跟 @ 命令的第一个字母来插入命令。    `C-c C-c c'  `M-x texinfo-insert-@code'        插入 `@code{}' 并且把光标放在括号中间。    `C-c C-c d'  `M-x texinfo-insert-@dfn'         插入 `@dfn{}' 并且把光标放在括号中间。    `C-c C-c e'  `M-x texinfo-insert-@end'         插入 `@end' 并且试图插入正确的单词，就象 `example'或 `table'。(这条命令不能正确的处理嵌套列表，但是可以插入适当的单词)    `C-c C-c i'  `M-x texinfo-insert-@item'         插入 `@item' 并且把光标放在下一行的开始。    `C-c C-c k'  `M-x texinfo-insert-@kbd'         插入 `@kbd{}' 并把光标放在括号中间。    `C-c C-c n'  `M-x texinfo-insert-@node'         插入 `@node' 和一个注解行，后面列出 `Next', `Previous', `Up' 节点，  把光标放在 `@node' 后面。    `C-c C-c o'  `M-x texinfo-insert-@noindent'         插入 `@noindent' 并且把光标放在下一行的开始。    `C-c C-c s'  `M-x texinfo-insert-@samp'         插入 `@samp{}' 并把光标放在括号中间。    `C-c C-c t'  `M-x texinfo-insert-@table'         插入 `@table' 后面跟一个空格，光标放在空格后面。    `C-c C-c v'  `M-x texinfo-insert-@var'         插入 `@var{}' 并把光标放在括号中间。    `C-c C-c x'  `M-x texinfo-insert-@example'         插入 `@example' 并把光标放到下一行的开始。    `C-c C-c {'  `M-x texinfo-insert-braces'         插入 `{}' 并把光标放在括号中间。    `C-c C-c }'  `C-c C-c ]'  `M-x up-list'         从一括号对中向前移出到结束的括号后，因为输入 `C-c C-c ]' 比输入`C-c C-c }' 要容易，所以把这两个快捷键设置为同一功能。( 当然，你也可以用 `C-f' 向前移出 ),要将一个单词放入命令如 `@code{...}' 中时，把光标放在这个单词的前面，然后输入 `C-u 1 C-c C-c c'。前置参数的值告诉 Emacs 把多少个单词放入括号中间。 `1' 放入一个单词，`2' 放入二个单词，依次类推。使用负数做参数将嵌套上一个词组。假如你没有带数字参数，Emacs 插入命令字符串并把光标放在括号中间。这个特性只适用于那些在一行中对单词或词组进行操作的命令。如     `@kbd' 与 `@var'。        这些命令是在分析了 `GNU Emacs Manual' 和 `GDB Manual' 手册里常用的 @ 命令的不同来建立的。如果你想定义自已的插入命令，你可以给一个键绑定 一个快捷键，使用缩写，或者在 `texinfo.el' 加入代码。        `C-c C-c C-d' (`texinfo-start-menu-description') 插入命令与其他的插入命令工作方式不同。它在一个目录条的空白处插入节点部分或插入章节标题。    ( 一个目录条有三部分，条目名，节点名，描述。只有节点名是必须的，但是描述可以帮助解释节点。)            使用时，把光标移动到目录条所在行键入 `C-c C-c d'。这个命令以节点名字来查找节点所在章节的标题，然后把标题做为描述插入条目中。光标放在所插入的文本的开始以便于编辑。假如当前目录条目已经有了描述，它不会把标题插入。        这个命令仅仅是写描述的一个辅助。它不能代替全部的工作。一个有用的描述并不是和节点名字完全一样的。                    显示文件结构        你可以用 `C-c C-s' (`texinfo-show-structure') 命令显示 Texinfo 文件章节节构。它列出了以 `@chapter', `@section' 开头的 @ 命令所在行，以及相应的统计数字。这些行显示在另一个名叫做 `*Occur*' 的编辑窗口中。在这个窗口中，你可移动光标到其中的某一行上使用 `C-c C-c'  (`occur-mode-goto- occurrence') 跳转到 Texinfo 文件中对应位置去。    `C-c C-s'  `M-x texinfo-show-structure'        显示 `@chapter', `@section' 对应行。    `C-c C-c'  `M-x occur-mode-goto-occurrence'        对应于在 `*Occur*' 窗口中光标所在行，跳转到 Texinfo 文件中相应位置。          在使用 `texinfo-show-structure' 时，如果通过 `C-c C-c C-s'使用了前置参数，那么它不仅仅列出以 `@chapter', `section' 等 @ 命令所在行，而且将列出 `@node' 所在行。( 这是第一版 Texinfo 不带参数时的工作状态，因为`@node' 行弄乱了 `*Occur*' 窗口的显示而且不常用，所以在以后的版本改变了它的工作形式 ) 你可以通过用前置参数来检查 `@node' 所在行的 `Next',`Previous', `Up' 的指向是否正确。        当你在一个手册上工作时，也许只感兴趣于当前章节的结构。在这种情况下，你可以用命令 `C-x n n' 设置你感兴趣的部分，`texinfo-show-structure' 将只在这部分工作。想要恢复查看整个的文档，使用命令 `C-x n w '( `widen')。          对于 `texinfo-show-structure' 命令，Texinfo 模式重新设置了分页变量的值来适应章节的 @ 命令。这使得你可以使用 `C-x ]'(`forward-page')和`C-x ['(`backward-page') 命令在章节中向前或向后移动。使用 `C-x p '命令  (`narrow-to-page')限定章节。                    更新节点和目录        Texinfo 模式提供了自动建立和更新目录及节点指向的命令。这些命令都归纳为 "update" 命令因为它们最常用在更新 Texinfo 文件。但是你也可以用它们在`@node'行插入 `Next', `Previous', `Up' 以及建立一个目录。        假如你没有用过这些命令，那么你必须手工输入目录和节点指向，这是一项沉闷的工作。    *Menu:    *Updating Commands::            五个主要的更新命令。  *Updating Requirements::        怎样组织 Texinfo 的文件结构以便于使用                                  更新命令。  *Other Updating Commands::      怎样缩进描述，插入丢失的结点行，以及插                                  入结点。    -------------------------------------------    iamafan@linuxaid.com.cn 责任编辑：知识库管理员(2001-01-03 16:27)