linuxdoc+emacs+ispell-howto.txt

linux-bible.rar linux-bible.rar

                      LinuxDoc+Emacs+Ispell-HOWTO 中文版
                                       
作者： Philippe MARTIN ( [1][e-mail])
英译者： Sebastien Blondeel ( [2][e-mail])
中译者：李安珊 An-Shan Lee ( [3][e-mail])

   v0.4, 27 February 1998
     _________________________________________________________________
   
   这份文件主要是提供给 Linux HOWTOs 的作者与译者及其他参与 Linux 文件计划
   (Linux Documentation Project) 者参考使用。从本文大家可以找到一些有关使
   用Emacs 与 Ispell 工具的提示。 
     _________________________________________________________________
   
1. 前文 

     * 1.1 版权 
     * 1.2 铭谢 
     * 1.3 评论 
     * 1.4 版本 
       
2. 简介 

     * 2.1 SGML
     * 2.2 LinuxDoc 型态定义 
     * 2.3 SGML-Tools
       
3. 您的第一份文件 

     * 3.1 从一份纯文字档文件开始 
       
4. 设定 Emacs

     * 4.1 重音文字 (Accented Characters)
     * 4.2 SGML 模式 (SGML mode)
     * 4.3 PSGML 模式 (PSGML mode)
     * 4.4 其他相关模式 
       
5. Ispell

     * 5.1 选择您的预设辞典 (default dictionaries)
     * 5.2 为特定文件设定个别的辞典 
     * 5.3 文件的拼字检查 
     * 5.4 个人辞典与个别档案辞典 (local file dictionary) 的比较 
     * 5.5 键入时的拼字检查 
       
6. 一些投机的技巧 

     * 6.1 自动插入页首 (header)
       
Appendix

7. Insert-sgml-header程式之□例
     _________________________________________________________________
   
1. 前文

1.1 版权

   版权属於 Philippe Martin 1998
   只要您遵守第二版或之後版本的 GNU 通用公开授权 (General Public License)
   的条件，您可以重新散布 及/或 修改这份文件。
   
1.2 铭谢

   特别感谢 Sebastien Blondeel。 Sebastien 是个非常罗哩吧嗦的人，不停的问
   我一大堆有关 Emacs 安装的问题。:-) 但也由於他所问的问题都很有意义，才使
   我能更深切的了解 Emacs，并将我所学到的知识发表出来，提供给大家参考。
   
1.3 评论

   如果您有任何建议可以改善本文，请不要犹豫尽快的告诉我，我会仔细的参考您
   的意见。
   对於此文件所探讨的主题，如果您有任何问题的话，也请尽快的告诉我，我会非
   常乐意的回答您，因为您的发问或许也能帮助我改善此文件。
   
     英译者注：假如大家认为这文件的英文很难懂的话，那就怪我翻译的不好。
     中译者注：那如果大家对这中文文件有疑问的话，那还是怪罪英译者罗，因为
     我是照他的英文翻译过来的。:-P 开玩笑的，如果大家认为这份文件中文翻的
     不好，请多多包涵，并提供意见给我，以便我改善它，谢谢。
     
1.4 版本

   这份文件与下列版本相关:
     * Sgml-tools 版本 0.99，
     * Emacs 版本 19.34，
     * Ispell 版本 3.1，
     * 本文举例内相关的 Emacs 程式库都与上列的 Emacs 版本一起发行，
       iso-sgml 则与 XEmacs 一起发行，而 psgml 则是独自发行的程式库。
       
2. 简介

2.1 SGML

   Standard Generalised Mark-up Language，或称为 SGML，是一种可以定义文件
   形态的语言。
   
   譬如，您可以定义食谱的文件型态，第一部先呈现其主成分，第二部介绍佐料，
   第三部则一步一步的指示如何烘烤蛋糕，之後一幅好看的图画就可表现其可口美
   味了。
   
   这就是所谓的文件形态定义 (Document Type Definition)。它并没有定义最後的
   产品应是什麽样子，它只说明文件的内容大约包括了什麽。
   
   以此类推，您在读了我这食谱的型态定义的举例之後，您的脑子里就会有您自己
   类似的食谱，或者您想的正是您最喜欢的厨子所呈现给您的，对吧？然而，他们
   其实看起来都是不同的：在我的想像里，我的成果照片是放在浴室柜子的左上角
   ，而主成分的表单是在後花园里，介於游泳池与烤肉区之间。您的呢？
   
   多谢 SGML 的标准定义，我们可以按照其所提供的格式轻松的写一份文件，而不
   用担心最後读者会看不懂我们在写些什麽。
   
2.2 LinuxDoc 型态定义

   正如您可能猜到的，这型态适用於写作关於 Linux 的文件。
   
   此种文件通常建构如下：文件的开始是标题，接著是作者的名称，文件的版本号
   码与日期。再来是摘要（这样读者就不用在浏览过整篇文件之後才知道这并不是
   他们想看的文件），之後是目录，显示文件结构，这样一来那些急於想知道某一
   特定内容的人就可直接跳到那部分去读。
   
   然後就是一系列的章节，段落等。在这部分，您可以插入部分程式，改变字体来
   强调某个字眼或句子，或插入列表 (lists)，以导引读者至文件的另一部份读取
   相关资料，等等。
   
   要写这种文件，您只需要正确的详细说明文件的标题，作者，日期，版本，章节
   部分，及大约说明何时将插入某一列表 (list)，其包含的元件是什麽等等即可。
   
2.3 SGML-Tools

   SGML-Tools可以将一文件的特殊规格转换成您所想要的格式。假如您要将此文件
   存在您个人的程式库，您可以选择转成 PostScript 格式。假如您要将它透过网
   路与世界分享，可将它转成 HTML 格式。假如您必须在 Windows 下读取此份文件
   ，您可以把它转成 RTF 格式，并使用文书软体读取。或者您也可以将之转成上述
   所有格式，以便您任何时候使用。
   
   您可从这 FTP 站 [4]ftp://ftp.lip6.fr/pub/sgml-tools/ 取得 SGML-Tools。
   
3. 您的第一份文件

3.1 从一份纯文字档文件开始

   假如您要将一纯文字档文件转成 SGML 以便再将之转成其他的格式，做法如下：
   
    1. 再最开头时加上下列字句与标签：
        <!doctype linuxdoc system>
         <article>
          <title>标题 (Title) 放此</title>
          <author>
           作者，作者的电子邮件帐号，等等。
          </author>
          <date>
           版本及日期
          </date>

    2. 如果您要在开头时摘要此文件的内容，请将下列标签用於此段落的头尾：
       <abstract> 与 </abstract>。
    3. 之後插入这 <toc> 标签， SGML-Tools 自会显示文件的目录 (Table Of
       Contents)。
    4. 再来，在每一章 (chapter) 的开始，以下列字句与标签取代每一章的号码及
       标题：
       <sect>这一章的标题 (The Title Of The Chapter)

       再於这一章的结尾加上此 </sect> 标签。
       注 ： 您不需放上这一章的相对号码， SGML-Tools 自会帮您加上。
    5. 以相同的方法用於接下来的分节 (section)。您必须删除每一节的号码，并
       以此 <sect1> 标签标於每一节开头的标题，及在每一节的结尾标上
       </sect1>。
    6. 在每一节中，您也可以使用 <sectn> 与 </sectn> 标签，将之分层多达 4
       个层次，每一层使用同样的标签，其中 n=2,3, 或 4，依此类推。
    7. 之後，在每一段落 (paragraph) 的开始，插入 <p> 标签。
    8. 在段落中，如果您需要强调某些部分，就使用 <it> 与 </it> (斜体)，
       <bf> 与 </bf> (粗体)，或 <tt> 与 </tt> (打字体) 标签。
    9. 若要插入列表 (list)，请依下列方式：
        例子：这是一个四行的列表：

         - 第一行放在这里
         - 跟著第二行
         - 再来第三行
         - 第四行。

       请以下列方式来标明上列列表：
        这是一个四行的列表：
       <itemize>
       <item>第一行放在这里
       <item>跟著第二行
       <item>再来第三行
       <item>t第四行。
       </itemize>

   10. 当您要在段落中放进某程式的一部分，或者需要突显某些地方，请依下列方
       式：
        <verb>
        10 REM 喔，老天！这是什麽？
        20 REM 我以为这东西早就不见了！
        30 PRINT "我回到...";
        40 PRINT "拯救世界。"
        50 INPUT "你从哪得知的？ ",M$
        60 IF M$="阿呆" THEN PRINT "你很聪明。":GOTO PARADISE
        70 ELSE PRINT "虽然你仍是傻呼呼的。":GOTO RICHMOND
        </verb>

   11. 到目前为止，您所学到的 SGML 格式技术已经相当够用。假如您想再加强您
       的文件，您可以参考 SGML-Tools 的使用指引，里面详尽的介绍了有关
       LinuxDoc 文件型态的应用。
       
4. 设定 Emacs

4.1 重音文字 (Accented Characters)

   假如您需要以法文或其他西欧语言来写文件，您必须使用 8-bit 文字 (8-bit
   characters)，才可显示其有重音的文字。这样的设置才可以令 Emacs 接受这些
   文字。
   
  显示 8-bit 文字
  
   要令 Emacs 显示 8-bit 文字，您必须将下列指令加入您的 .emacs 档案：
       (standard-display-european 1)
       (load-library "iso-syntax")

   假如您在一个不支援 8-bit 的终端机上使用 Emacs，您可以使用 iso-ascii 程
   式库 ((load-library "iso-ascii"))，它会指令 Emacs 以最相似的形式来显示
   这些文字。
   
  8-bit 文字的键入
  
   假如您的键盘允许您键入有重音的文字，那就没有问题，要不然也可照下列方式
   来补救：
   
  Iso-acc 程式库
  
   Emacs iso-acc 程式库可以让您使用 7-bit 的键盘键入 8-bit 的文字。
   
   只要将下列指令加入您的 .emacs 档案：
      (load-library "iso-acc")

   然後在使用 Emacs 时，开启您所需要编辑的档案，键入 Meta-x
   iso-accents-mode。
   
   这样您若要键入法文 cafe 的 e 的话，您就可以先键入 ' 然後再键入 e。总之
   ，您需先键入那个文字的重音，之後再键入相对的字母（不论大写或小写）。以
   下是一些您可以使用的重音：
   
     ' : Acute
   
     ` : Grave
   
     ^ : Circumflex
   
     " : Dieresis
   
     ~ : Tilde, cedilla, 与其他特别的例子 (cf iso-acc.el).
   
     / : 在一字母上加线，等等。
   
   如果您只需要这些重音符号之一，但不是相对的重音字母，那就在符号之後键入
   一空白键。例如，要输出 l'elephant，就键入 l ' 空白 ' e l ' e ... 即可。
   
   您可以在 iso-acc.el 档案内找到所有您需要的重音组合。
   
  Meta 键
  
   您可以在某些终端机上使用 Meta (或 Alt) 键来键入 8-bit 文字。例如，您可
   以键入 Meta-i 来输出 e 这个字。
   
   但是就我所知， Emacs 将 Meta 键用於其他场合，其他的程式库似乎也不提供这
   种重音输入方式。
   
   不过我们还是可以以下列方式来补救：
   
      (global-set-key "\ei" '(lambda () (interactive) (insert ?\351)))
                         _                                      ___

   只要将上列指令加入您的 .emacs 档案内，您就可以用 Meta-i 来输出 e。您也
   可以重新定义您要的组合，只要您用您要的字键 (key) 取代 i，用正确的编码
   (code) 取代 351，再配对起来，就可以得到您要的重音字母。您可参考
   ISO-8859-1 character set 取得您要的编码。
   
   注意！ 某些 local modes 或许会重新定义您的字键组合。
   
  8-bit SGML 文字的显示
  
   使用 SGML 时，您可以利用巨集 (macros) 来输入重音文字。例如，要输入 e 就
   可用 &eacute;。但通常，需要读取 SGML 的应用软体都可以读取 8-bit 文字，
   所以一般都用不到这种巨集。或许有些软体仍然无法读取 8-bit 文字，那麽这时
   您就可以利用上述巨集了。
   
   一般时候，在使用 Emacs 时，您可以利用 iso-sgml 程式库来输入重音文字。当
   您要将文件档案存到磁碟时，它也会帮您把 8-bit 文字转成 SGML 的格式，以方
   便您读取。
   
   所以有了这个程式库，您就可以在使用 Emacs 时，轻松的输入或读取 8-bit 文
   字，甚至一个不接受 8-bit 文字的软体，也可以读取您编写的 8-bit 文件。