texinfo笔记之（一）了解texinfo

     
   Texinfo是一个文档系统，它通过单个源文件同时生成在线信息文档和可打印的输出。也就是说，这两种类型的文档，你只需要写一份文档就行了。

使用Texinfo:创建可打印的在线输出
     使用Texinfo创建的可打印的文档包括一本书的所有普通特征，如章、节、交叉引用和索引。
通过一份Texinfo源文件，可以创建一份Info文件，一份HTML文档及一份XML文件。Texinfo源文件是
普通的ASCII文件，它包含交互的@命令文本。你可以用任何文本编辑器编辑它，但GNU Emacs编辑器
会更方便一些，因为它有一个Texinfo模式，提供了许多的Texinfo相关特性。


输出格式化：支持的输出格式概述
    下面是当前Texinfo支持的输出格式。

Info： （通过makeinfo生成）它添加了新的控制字符来分隔节点，并提供菜单导航信息，交叉引用
      索引等。可以使用Emacs info子系统，独立的info程序来阅读这些文件。

普通文本：（通过makeinfo --no-headers生成）它与Info的输出相同，但忽略了导航控制字符。

HTML: （通过makeinfo --html生成）有很多种HTML的版本，makeinfo尝试用能被任何常用浏览器
      解释的HTML语言子集。

DVI： （通过texi2dvi生成）它是由TeX排版系统输出的独立于设备的二进制格式。

PDF： （通过texi2dvi --pdf或者texi2pdf生成）Texinfo使用pdftex程序，一个不同的TeX，来输出       PDF

XML: （通过makeinfo --xml生成）makeinfo XML输出仅仅只转换Texinfo标记为XML语法，然后交给高      级的XML工具来处理。特殊的语法输出在文件texinfo.dtd中定义。

Docbook:（通过makeinfo --docbook生成）它是一种基于XML的格式，开发了许多年了。如果你想把

Docbook转换为Texinfo，请参考。Texinfo不能生成传统的Unix man手册，因为man有非常严格的传统格式，与Texinfo有很大的不同，这使得生成man手册与Texinfo的设计目标相矛盾。但man手册仍有它的生存空间，如果你想支持它们，可以使用help2man程序。它通过程序的--help输出生成一份传统的man手册。如果你是一位程序员，并希望为GNU工程捐献，为Texinfo实现另外一种输出格式，这是非常好的。但请不要写一个像texi2foo这样的转换程序来生成foo格式，因为这种方式并不好，它会增加许多额外的工作，Texinfo语言是在不断提高和更新的。最好的方法是走接修改makeinfo程序来生成新的格式。

Info文件：Info文件是怎样的？

Info文件是由Texinfo文件格式化的并可以通过info文档阅读程序打开和操作。（makeinfo和texinfo-format-buffer两个命令可以将Texinfo文件转换成Info文件。
Info文件由许多节组成，每节包含一个讨论主题。每节有一个名字，包含用户阅读的文本和指向下一节的指针
这些都是由它们的名字来标识。Info程序一次显示一节，并给用户提供移动到相关节的命令。
每节可能有许多子节，它们描述节主题的副主题。子节的名字在父节的菜单中列出;它允许你通过某个命令移动到其中一个子节上。Up,Previous,Next指针可以指向其它任何节，菜单可以包含任何其它节。
另外Info还提供另一种指针样式，即引用，它可以遍布整个文本中，它是表现链接的最好方法，但不适合层次结构。通常我们通过节Top进入Info文件，该节包含文件的简短摘要和一个大的菜单，通过这些节可以系统的浏览文件。要顺序阅读Info文件，重复按，或者通过高级Info命令 g *来得到整个文件。
info目录中的dir文件是整个Info系统的出发点，通过它你可以到达文档系统中的每个节。

印刷书：印刷书或手册的特性

生成印刷书或手册需要TeX，它有标题页，版权页，目录，前言和章，有限或无限的节和子节，页头，交叉引用，页脚和索引你可以用Texinfo写在线信息，小说，备忘录，电子邮件。
Texinfo提供文件texinfo.tex来处理生成印刷书，这个文件包含一些定义和宏，它告诉Tex怎样处理Texinfo的@命令。默认文档印刷尺寸为8.5X11 inch(216X280mm),也可以印刷7X9.25inch(178X235mm，@smallbook尺寸，或者A4,A5尺寸@afourpaper,@afivepaper）。
可以通过修改texinfo.tex文件来改变印刷尺寸，格式化样式（如字体大小和样式，段落缩进等）
你可以使用texi2roff将Texinfo源文件转换成roff源文件，但它不是标准的GNU分发一部分。

@命令：所有的@命令都是小写的（@TeX例外），命令是大小写敏感的。
@命令有以下几种形式：

1.以一行开始，后面无其它文本（如@quotation，表示开始交错环境）
2.以一行开始，后面接命令参数，后面无其它文本（如@chapter chapter tile，创建章标题）
3.可以出现在任何地方，通常在句子中（如@dots{}，创建省略号）
4.可以出现在任何地方，通常在句子中，后面带上参数（如@code{sample-code},@code将括号内的文本标记为代码）
5.以一行开始，下一行开始为body-text，最后以@end command结束（如

@example
body-text
  ....
@end example