HOWTO HOWTO

�@��: Mark F. Komarinski [1][email protected]
Ķ��: Ĭ���� [2][email protected]

  v0.13, 19 September 1999 ½Ķ��: 09 Feb 1998
    _________________________________________________________________

  �����@�ӷs�� LDP �@�̡A�x�� LDP �ϥΪ��u��B���M���w�C
    _________________________________________________________________

1. ���z

    * 1.1 ���v
    * 1.2 �s����
    * 1.3 ���v�M�Ӽ�
    * 1.4 �P��

2. LDP �M SGML �I�����

    * 2.1 LDP
    * 2.2 SGML
    * 2.3 �u��

3. ��ڭ̶}�l

    * 3.1 �g���s�@��
    * 3.2 �l��C��
    * 3.3 �U���æw�ˤu��
    * 3.4 ��u�Ѽg SGML
    * 3.5 �ϥΨ䥦�u��Ѽg SGML
    * 3.6 CVS ��¦
    * 3.7 �o���A�����

4. �����n

5. ��� LDP ���`�����D

    * 5.1 �ڷQ�� LDP �X�@���O�A�ڸӦp��h�@�H
    * 5.2 �ڷQ�X�� LDP ��ɡCLDP ����ɳ\�i�O��˳W�w���H
    * 5.3 �ڦb�@�� LDP ��ɤ����@�ӿ��~�C�گ�ץ����ܡH
    _________________________________________________________________

1. ���z

1.1 ���v

  ����O1999�~8��26�� Mark F. Komarinski [3][email protected] �b��O�F���
  ��M�u�㪺�N����}�l�g�@���C�p�G���@�� LDP �@�̯�q���o���U�A�ڴN�F
  ��ڪ��@��F�C

1.2 �s����

  ���媺�̷s�����i�H�b�ڪ��D�� [4]http://www.cgipc.com/~markk ��� SGML
  �����C �䥦���P�榡�������i�H�b LDP �D�� [5]http://www.linuxdoc.org/
  ���C

 �������v

  v0.25, 20 September 1999

    * �״_�F�@���_�}���챵
    * ���s�@�̼W�[���`
    * �q�̪�o�檩���W�[�@������ק�
    * �W�[���v�������N�H�e�� URL �챵

  v0.12, 2 September 1999
    * �����j�h�Ƴ��`
    * �Q�צC����X�ק�

  v0.10, 27 August 1999
    * Got up to section 3.4 written
    * Added to the outline some
    * Changed location of LDP mailing list to lists.debian.org from
      thepuffingroup.com.

  v0.01, 27 August 27 1999
    * ��B�����A�W�ǥD���A²��j���g�@
    * Take some of what I wrote with a grain of salt. Some things need
      to be verified.

1.3 ���v�M�Ӽ�

  (c) 1999 Mark F. Komarinski

  �����n�i�H�Q�����γ����_��A���ݭn�I�O�A���������H�U����G

    * The copyright notice above and this permission notice must be
      preserved complete on all complete or partial copies
    * Any translation or derived work must be approved by the author in
      writing before distribution.
    * If you distribute this work in part, instructions for obtaining
      the complete version of this manual must be included, and a means
      for obtaining a complete version provided.
    * Small portions may be reproduced as illustrations for reviews or
      quotes in other works without this permission notice if proper
      citation is given.

  Exceptions to these rules may be granted for academic purposes: Write
  to the author and ask. These restrictions are here to protect us as
  authors, not to restrict you as learners and educators. All source
  code in this document is placed under the GNU General Public License,
  available via anonymous FTP from [6]the GNU archive site.

1.4 �P��

  �P�©Ҧ��b�ڼg�@�L�{����������U���H�A�]�A Deb Richardson �M Daniel
  Barlow �H�� LDP �Q�צC��W���䥦�H�C

  �������`�ڨ��� HOWTO Index �M sgmltools ��ɡC�b���媺�䥦������������
  ��B���o sgmltools �M LDP�C

2. LDP �M SGML �I�����

2.1 LDP

  Linux ��ɭp�� (LDP) �O�ΨӴ��ѵ��s�Τ�H�ֳt���o�Y�ӸԲӥD�D����H���C
  ���ä��ȶȥ]�t�@�t�C���޲z�B��B�s�{�������y�A�ӬO�]�e�F�j�q���Ѩ�
  �ιL���H�Ѽg�����Y�ӭӧO�D�D���ѨM��k�C�p�G�A�Q�d����󥴦L����ơA
  �A�i�H�d�\ Printing HOWTO�C�p�G�A�Q�d���������ơA�A�i�H�d�\
  Ethernet HOWTO�A�����C

  ��}�l�A�\�h�o�Ǥ�ɬO�奻�� HTML �榡�C�H�ۮɶ��������A������X�@�Ӻ�
  �z�o�Ǥ�ɪ��n��k�C�@�د���A�q Web ��W�\Ū�B�q���L���奻���\Ū�A
  �Ʀܱq�A���ӤH�Ʀr�U�z�W�\Ū����k�C���פw�g���F�A�N�O SGML�C

2.2 SGML

  Standard Generalized Markup Language (SGML) �O�@�ذ��O���奻���y���C
  �b�o�譱�A������� Tex �Ϊ� groff �Ϊ� HTML�C SGML ���j�j���b�󥦤��H
  WYSIWYG (�Ҩ��Y�ұo)���ˡA�A���ݭn�w�q�H�C��B�r�鵥�榡�A�A�u�ݩw�q��
  ��(�q���B���`�B�s���C��)�� ��̲׳B�z�{�ǨӳB�z�H��m�B�C��B�r�鵥�Ф�
  ���Ʊ��CHTML �]�O�o�򰵪��A��ڤW���O SGML ���@�Ӥl���C

  SGML �]�t�ⳡ���C�����O�@�Ӻ٬� DTD (�κ٬��������w�q Document Type
  Definition) �����c�C DTD �w�q�C�@�Ӥ�����������t�CThe LinuxDoc DTD,
  used to create this document, is an example of this. DTD ���C�@�Өϥ�
  DTD �Ыت���ɤ@�ӳq�Ϊ���ı�M�Pı�ĪG�C�䦸�O���e(content)�A�N�O�N�n��
  SGML �B�z���B�z�óQ�Τ�\Ū�������C���q���N�O���e�A���]�i�H�]�t�Ϲ��B��
  ��B�s���C�����C���e�Q�аO(tag)�]��ΨӤ��}���P�������C

  �H�ۮɶ��������ALinuxDoc DTD �N�Q DocBook DTD �Ҩ��N�A���䥦�� SGML ��
  �ɴ��Ѥ@�ӲΤ@����ı�M�Pı�ĪG�C �p�G��{�F�o�@�B�A�ڭ̱N�q�L�� HOWTO
  �Ϊ̶l��C���A�ɯšC LinuxDoc �M DocBook �����̤j�����P�b�� DocBook
  ���t�аO�����P��������e(�N�H�R�O�B���W�B�a�}�ؿ�����)�A�� LinuxDoc
  ���t�аO���奻�N�n��ܪ��覡(��p�A�i�H���t�j�թΥ��r)

 ������� SGML ���N HTML �Ψ䥦�榡�H

  SGML ���Ѫ����ȶȬO�榡�C�A�i�H�۰ʫإ߯��ޡB���e��H�Τ�ɤ����챵�Ϊ�
  �O�j���Csgmltools �]�]�i�H��A��X LaTeX �B info �B text �B HTML �M
  RTF�C�q�o�ǰ򥻮榡�A�A�i�H�Ыب䥦�榡���(DOC�BPostScript����)�CSGML
  ���|�H HTML ���ˤ����C�ڤ��{���A�ܧַ|�b SGML ���ݨ�{�G���аO�C�o���U
  ��s�X���ȶȩ���B�z�A�ӥB����Ѽg�C�H LyX (�ڦܤ��ϥΪ��Ҩ��Y�ұo�s��
  ��)�o�˪��n��i�H���U�A�Ѽg TeX�榡��ɨÿ�X�� SGML �榡�A�M��A�N�i�H
  �q SGML �ͦ����A�ݭn���榡�C

  �̫�ASGML ��`���������u�@�ʯ�Ӥ��O��������ܡC�o�O�@����۪��S�ʡA��
  �U�A��֦a�Ѽg�A�]���A������߬q������m�B�r��j�p�����C

2.3 �u��

  �b�����`�A�ڱN���Ф@�ǥΨӳЫاA�ۤw�� LDP ��ɪ��u��C�ڱN��²�椶�СA
  �M��Բӻ����A�]�A�p��w�˥��̡C�p�G�A�ϥΨ䥦���@�Ǥu��ӮѼg LDP�A��
  �i�D�ڡA�ڷ|�b�o�̬����̰��s�i���C

 sgmltools

  ����

  sgmltools �]�]�t�ΨӳB�z SGML ���H�W�һ��榡�� SGML �u��C���]�]�t�Ы�
  LDP ��ɩһݪ� LinuxDoc DTD�C�p�G�u�Ы� SGML ��ɡA�o�Ǥw�g�����F�C�p�G
  �A�Q�B�z����p TeX �榡�A�A�ٻݭn�@�Ǥu��]�Csgmltools �]�b�A�� linux
  �o�檩�����i�H���A�Ϊ̨� [7]http://www.sgmltools.org/ �U���C

 TeX

  �i��

  TeX (rhymes with blech!) �O�@�إi�Ѽs�x��ܪ��аO�y���A�Ʀܥ]�A���Ǽƾ�
  �@�ɤ����H�̡C ��ٰO�o�\�h�L�n���ҸլO�� TeX �g�����C���]�O�ܤ����b��
  �Ϊ��̦����аO�y�����@�C TeX ��ڤW�M SGML ��Ƴ\�h�P�˪������CTeX �B�z
  ������� DVI (�]�ƵL�)�q�ӥi��B�z���䥦�榡�C �������O�ADVI����e��
  �a�ഫ�����L�y��(PostScript�BPCL)�H�~���䥦�榡�A����ͦ� HTML�C TeX �b
  �h�� Linux �o�檩�������w�w�˩γQ���ѡC

 LyX

  �i��

  LyX �{�ǬO�@�ӹϧΤƩҨ��Y�ұo�n��A���ѫD�`���ݪ����ιϧ���λP SGML
  �B�z���������p�t�CLyX�O�Ω�Ѽg TeX ��ɡA��{�F�\�h TeX �W�h�C�|�ӨҤl
  �A���`�Q�۰ʽs���A�A�L�k�����a���J�Ů�C�o�Q TeX �]�p���T��C�� SGML
  �q�`�����P�˪��Ů�CLyX��Ū�J LinuxDoc DTD �åB���Ѥ�ɼҪO�H���U�A��
  �ߺD���覡�ЫاA�� LDP ��ɡA�Ӥ��ݭn�H vi ���˭n�O��\�h�аO�C LyX �i
  �H�b [8]http://www.lyx.org/ ���C

  �b KDE �����@�Өϥ� Qt �w�� LyX�C �A�i�H�q�H�U�a�}�o���h�H���G
  [9]http://www.devel.lyx.org/~ettrich/klyx.html�C �p�G�A�ϥ� KLyX �Ӽg
  SGML �A�гq�L [10]�l�� �i�D�ڧA���ϥθg��C

3. ��ڭ̶}�l

  �����`��ܦp������p��Ѽg�A�ۤv�� LDP ��ɪ��H���C��æw�ˤu��A
  �P LDP �p�t�A�q���̦V�Ҧ� Linux �Τ�o���A�Ҵx�������ѡC

3.1 �g���s�@��

  �p�G�A���F�� LDP �åB�Q�n��ܤ@�ӨS�H���@�� HOWTO �Ϊ̷Q�g�@�ӷs��
  HOWTO �Ϊ� mini-HOWTO ��ɡA��p�t [11][email protected] �C

  �o�N� HOWTO ��դH�x���֦b���@���g��ɡC�P�ɭn�`�N�Ҧ��� HOWTO ���ϥ�
  SGML �榡(��e�ϥ� LinuxDoc DTD)�Cmini-HOWTO �ϥ� SGML �Ϊ� HTML �榡�A
  ���u�� SGML �榡�N�Q�]�t�i HOWTO �����L�������C

3.2 �l��C��

  ���@�Ƕl��C��i�H�q�\�H��A�F�� LDP �ثe�u�@���p�C�����O
  [12][email protected]�A�o�O LDP ���D�n�Q�ײաC�p�G�n�q�\�A
  �o�e�D�D�� "subscribe" ���l���
  [13][email protected]�C�h�q�h�o�e�D�D��
  "unsubscribe" ���l��� [14][email protected]�C

3.3 �U���æw�ˤu��

 sgmltools

  �q [15]http://www.sgmltools.org/�U�� sgmltools �]�A�Ϊ̪����q�A��
  Linux �o�檩�������o�C�q sgmltools.org ���o���n��O���X�榡�A�]���A����
  �b�A�������W�sĶ�o�Ƿ��X�C�q�A�� Linux �o�檩�������o���w�إߦn���]��e
  ���ǡA�A�i�H���νsĶ�Ӫ����}�l�s��u�@�C(�S�O�O�p�G�A���O�@�ӵ{�ǭ�)

  RedHat ���]�t sgmltools�C �p�G�S���A�A�i�H�q ftp.redhat.com �Ϊ̨䥦��
  �����I�U���C

  �p�G�A�ϥ� Debian�A�b�зǵo�檩�����]�]�t sgmltools �C�p�G�A�S���w�w��
  ���]�A�A�i�H�ϥ� apt-get �R�O�U���æw�ˡG
    _________________________________________________________________

# apt-get install sgml-tools
    _________________________________________________________________

  �n�F�ѧ�h��� Debian �]���H���A�A�i�H�d�\
  [16]http://www.debian.org/Packages/stable/text/sgml-tools.html

  �p�G�q���X�sĶ�A�Ҧ��A�ݭn�����O�G

# tar -zxvf sgmltools-x.x.x.tar.gz
# cd sgmltools-x.x.x
# ./configure
# make
# make install


  ���� sgmltools-x.x.x ���A��e sgmltools ���������C�� LinuxDoc ����e
  �������O 1.0.9�C�� DocBook ����e�������O 2.0.2�C��̦b�H�W�ҭz���I��
  ���i�H���C

  �@���u��w�˦n��A�A�N�i�H�ϥΫܦh�R�O�F�C

  sgmlcheck file.sgml- �ˬd���w��ɪ��y�k�C

  sgml2html file.sgml- �ഫ SGML ��� HTML�C �Ыؤ@�ӦW�� file.html ��
  ���]�t���e��A�M��Ыؤ@�t�C�W�� file-x.html �����A�o�� x �O���`��
  �C

  sgml2rtf file.sgml- �ഫ SGML ��� Rich Text Format (RTF)�C�Ыب�Ӥ�
  ��A�Ĥ@�ӬO file.rtf �]�t TOC�A�H�� file-0.rtf �]�t�Ҧ������`�C

  sgml2txt file.sgml- �ഫ SGML ��� ASCII �奻�C�Ҧ����e��b file.txt
  ���C

  sgml2info file.sgml- Blah SGML blah INFO, ��Q info �R�O�ϥΡC�Ҧ�����
  �X�ǰe�� file.info�C

  sgml2latex file.sgml- Blah SGML blah TeX.

  sgml2lyx file.sgml- SGML yadda LyX graphical editor. This is great if
  you have pre-generated SGML files and want to convert them for use in
  LyX.

3.4 ��u�Ѽg SGML

  �D�`�H HTML�A�A�i�H��u�Ѽg SGML , �u�n�A�x���F�Ҧ��ݭn�ϥΪ��аO�N�X��
  ���`�N���z�ɥi��h���o�ǥN�X�A�ì��C�@�Ӵ��ѨҤl�C�}�l���̦n���a��N�O
  ���媺���X�A�i�H�q�o�̬ݬݡG [17]Introduction. �]�� SGML ���B�z�覡�̿�
  ����榡�����P�Ӥ��P�A�ڱN�ɥi�໡���b���g�@�����Ӫ��D���Ʊ��C

 �X�o

  �{�b�}�l�g�@�F�A�����ΧA�߷R���s�边�Ыؤ@�ӷs���A��󪺶}�Y�p�U�G

<!doctype linuxdoc system>

  �o�N�w�q SGML �B�z��X���ɨϥΪ�������(�ڭ̳o�ӨҤl�ϥ� LinuxDoc)�C
  �o�ӼаO���������ͥ���X�C

  ���U�ӧA�ݭn��A��E�����e�]�t�b�аO <article> �M </article> �����C�o�N
  ���ۤ��e���}�l�C�p�G�A��x HTML ���ܡA�o�����N�Ҧ����e�]�t�b�аO
  <html> �M </html> �����C

 �Y���H��Header information

  ���e���Ĥ@�������ӥ]�t���e��E���������A�H���C�o�����@���Ѫ��Y�X���A
  ���̦����D��(�ѥ������D�B�@�̡B�X�����B���e�ؿ�����)�C

  ���e�����D�]�t�b�аO <title> �M </title> �����C�@�̥]�t�b�аO <author>
  �M </author> �����C���h�ϥμаO <date> �M </date> �C

  ����ӫO�d�����`�O�G <abstract> �M </abstract> �аO�y�z���e�K�n�F<toc>
  �аO���X���e�ؿ�����m�C���e�ؿ�(TOC)�O�� SGML �۰ʥͦ����C�ڭ̫᭱�N��
  �J���`�C

  �{�b�ڭ̩Ұ����@���ݰ_�ӬO����ˤl�O�H���~���L�� SGML �N�X�զX�_�ӡA
  �N�H�G

<!doctype linuxdoc system>
<!-- LinuxDoc file was created by LyX 1.0 (C) 1995-1999 by <markk>
Fri Aug 27 09:42:28 1999 -->
<article>
<title>HOWTO HOWTO
</title>
<author>Mark F. Komarinski
</author>
<date>Aug 27, 1999
</date>
<abstract>Getting a new LDP author up and running with tools, ideas,
and conventions used by the LDP
</abstract>
<toc>

  ��A�ϥ� RTF �� HTML �榡�ݳo�q�ЫإD���������e�ɡA�Ҧ����H�����b�@����
  �C

 ���`(Sections)

  ���F�إߤ��e�ؿ��A�A�������@�ǼаO�C �b SGML �������`(Sections)������
  �ΥX���������������C�A�i�H���h�ӳ��`�A�C�ӳ��`�i�H���l���`�A�l���`�U��
  �i�H���l���`�C

  �b�A����ɤ��ϥγ��`�A���U��A�إߥD�D�j���C�A�i�H�N�D�D���j���h�Ӥp��
  �`�C�ڦb�g����ɴN�O�o�˰����C

  ���`�O SGML ���ּƴX�Ӥ��ݭn����X�{���аO�C�]�N�O���A�S�� </sect> �аO
  �C �A������󳹸`���s���ASGML �b��X���䥦�榡�ɷ|�۰ʳB�z���C

  ���`�O�ϥ� <sect> �аO�@���}�l���C�C�@�ӷs���`�}�l��@�� <sect> �аO�C
  �Ĥ@�ӳ��`�Q�s���� 1�C

  �Ыؤl���` (��p 1.1) �i�H�ϥ� <sect1> �аO�C���]�q 1 �}�l�s���C

  �l���` (1.1.1) �ϥ� <sect2> �аO�A�åB���]�q 1 �}�l�s���C

  �� SGML �B�z���B�z�� <toc> �аO�ɡA���}�l���y��ɪ���E�����A�Q�Ψ䤤��
  ���`�аO�s���Ыؤ�ɥؿ��C���`�Q�s���ƦC�b���e�ؿ�(TOC)���A�M��Q��ɪ�
  ��E�����ϥΡC�l���` (1.1.1) �ä��X�{�b TOC ���A���p�G�i�઺�ܷ|�Q�m��
  �j�դ奻�榡�C

 �зǬq��

  �g���e�q���N�H HTML�@�ˡC�ϥΤ@�� <p> �аO�����@�ӷs�檺�}�l�CSGML �|��
  �� TAB�B�Ů�B�Ŧ�C�� SGML �ˬd�� <p> �аO�ɡA���}�l�@�ӷs��C��m
  </p> �аO����Ӭq���C

 �W�j�奻

  �A���ӷ|�ݭn��@�Ǥ奻���㤣�P��䥦�奻�C�i��O���n�N�X�Ϊ̩R�O�C��C
  �j�դ奻�i�H�ϥ� <em> �M </em> �аO�C����r�i�H�ϥ� <tt> �M </tt> �аO
  �C

 �C��

  �b SGML ������اΦ����C��C�Ĥ@�جO�C�|�C��A�q1�}�l���C�@�ӦC���s��
  �C

   1. This is the first entry in the enumerated list.
   2. This is the second.
   3. Third.

  �H�W���N�X�p�U�G

<enum>
<item>This is the first entry in the enumerated list.
<item>This is the second.
<item>Third.
</enum>


  <enum> �аO���X��H��᪺�C���n�}�l�s���C

  �t�@�اΦ��O�v���C��A�C�@�ӦC���e���u��@�ӬP�ζ����I�Ψ䥦�F��C

    * This is the first entry in the itemized list
    * This is the second
    * Third

  �H�W���N�X�p�U�G

<itemize>
<item>This is the first entry in the itemized list
<item>This is the second.
<item>Third.
</itemize>

  �N�H�A�Ҭݨ쪺�A<item> �аO�b��اΦ��C�����@�ˡC

  �ĤT�اΦ��O�y�z�C��A�]�A�Q�y�z���N�y�H�δy�z�ӳN�y���u�y�C

  LDP
         The Linux Documentation Project

  SGML
         Standard Generalized Markup Language

  �H�W���N�X�p�U�G

<descrip>
<tag>LDP</tag>The Linux Documentation Project
<tag>SGML</tag>Standard
Generalized Markup Language
</descrip>

  �o�اΦ����P��e����ءA��ӦC��]�t�b�аO <descrip> �M </descrip> ���A
  �C�@�椤���C�@���A�]�N�O�w�q���u�y�A�Q�]�t�b <tag> �M </tag> ���C�檺��
  �E�����O��u�y���w�q�C

 �v�r�奻

  ���ɧA�ݭn������ܧA�Ҽg�����e�A�A�i�H�ϥ� <verb> �M </verb> �аO�ӥ]�t
  �q���C�b</verb> �аO���e���Ů�B�^���H�Ψ䥦�奻(�]�A�S�O�r��)���N�Q�O
  �d�C

�H�U�N�O�v�r�奻

 �Τ@�귽�w��(URL)

  SGML �]���\�Τ@�귽�w��(URL)�C�`�N�o�b��X�� HTML �榡�ɤ~���ΡA�䥦��
  ���i��]���@�ǥΡA��p�� RTF �榡�C

  �@�� URL �S������аO�A�Ҧ��H������b <url> �аO�̭��C�o�O�@�ӫ��V LDP
  �D���� URL�G [18]http://www.linuxdoc.org/ �C�H�U�O�N�X�G

<url url="http://www.linuxdoc.org/" name="http://www.linuxdoc.org/">

  url="http://www.linuxdoc.org/" �i�D�s����ؼЦa�}�A��
  name="http://www.linuxdoc.org/" �h�i�D�s����p����ܡC�b���Ҥ���̬O�@
  �˪��A���ڥi�H�Ыؤ@�Ӧp�U�� URL �аO�G

<url url="http://www.linuxdoc.org/" name="LDP">

  �b�����W����ܴN�H�o�ˡG [19]LDP.

 �Ѧ�(References)

  URL �A�X���챵�� LDP ��ɤ��~�����e�A�����A�X���챵���ɤ��e�ۨ��C����
  �{�o�@�\��A�i�H�ϥ� <label> �M <ref> �аO�C<label> �аO�Ыؤ@�ӱN�ӯ�
  ����^�Ӫ��O���A�D�`�H�@�Ӯ�ñ�C �Ы� <label> ��²��C���H��ݭn����
  �^�Ӫ���m�A�M�ᴡ�J�H�U�G

<label id="Introduction">

  �A�{�b�w�g�b��ɤ��e���ЫؤF�@�ӥi�H����^�Ӫ��O�� "Introduction"�C�o��
  ��ñ�T��X�{�b��ɪ��}�Y�C��A�H��ݭn����^�ӮɡA���J�H�U�G

<ref id="Introduction" name="here">

  SGML �N���թ�J�@�ӥs "here" ���챵�i�H����� Introduction ���`����m
  �C

  �ѦҪ��t�@�����O���� (indexing)�C�ѩ� LDP ��ɸg�`�O�j�q��ɡA�����b��
  ���᭱�إ߰����M�D�D�����ޡC

 �S��r��(Special characters)

  �D�`�H HTML�A�A�����קK�\�h�D��r�r�ťH���� SGML �N������ SGML �N�X�C
  �o�̦��@�� SGML �N�X���C��C��h���i�H�d�\ sgmltools �Τ��n�G
  [20]http://www.sgmltools.org/guide/guide.html�C

    * Use &amp; for the ampersand (&)
    * Use &lt; for a left bracket (<)
    * Use &gt; for a right bracket (>)
    * Use &etago; for a left bracket with a slash (</)
    * Use &dollar; for a dollar sign ($)
    * Use &num; for a hash (#)
    * Use &percnt; for a percent (%)
    * Use &tilde; for a tilde (~)
    * Use `` and '' for quotes, or use &dquot for "
    * Use &shy; for a soft hyphen (that is, an indication that this is a
      good place to break a word for horizontal justification).

3.5 �ϥΨ䥦�u��Ѽg SGML

 LyX

  �ڤ@���Q���߷R LyX�A�]���ڰ��R�o�ӳn��C�����ѱ`�W�r�B�z������ϥΪ���
  ���Ѽg SGML�C�����O�@�өҨ��Y�ұo�{�ǡA�ӬO�ұo�Y�ҷQ���ΡC

  �n�� LyX �Ыؤ@�� LinuxDoc ��ɡA�U���æw����ε{�ǡC�T�O�A�w�w�� TeX
  �M sgmltools (�Ѩ� [21]�w�ˤu�� )�C�M��Ұ� LyX �åB��� "file->new
  from template..."�C��� "Templates" �M���I�� linuxdoctemplate.lyx �A�o
  �˧A�N�o��@�ӱa LDP ���Y�H������ɼҪO�C���X�A�A���ƾ�(�]�N�O�A��
  �g���D�B�@�̡B���B�K�n����)�A�M��}�l�g�@�C���W�����U�Ե��i�H�Ψӿ�
  �ܤ��e�����(�зǡB�C��B���`)�C�P�ĸ��Ψӱj�դ奻�C�A�J�i�H�I�����i�J
  �j�ռҦ��A�]�i�H�ι��а��G��ܤ奻�A�I�����A�N��ܪ��奻�m���j�դ奻�C
  �\�h�䥦�� SGML �S�ʥi�H�b Insert ��������C �A�i�H���J URL�B��e��
  �ҡB���ޥH�Ψ䥦������ƾڡC�����A����ɫ�A�A�i�H�O�s�� LyX �榡�A�M
  ���X�� LinuxDoc �o�� .sgml ��󪺤��C�o�Ӥ��i�H�Q sgmlcheck �ˬd
  �M��X���A�Q�n���榡�C

 Emacs

  �ڤ��ϥ� Emacs�A���ڨä��ƥ����C�� Emacs �ϥθg�窺�H�|ı�o���D�`���ΡC

 �䥦 SGML �u��

  �p�G���������~���䥦 SGML �u��A�Ϊ̧Y�ϬO�ӷ~�����A�u�n�O��Q
  LinuxDoc DTD �ΨӳЫ� LDP ��ɡA�Чi�D�ڡC

3.6 CVS ��¦

  ��{�b����ALDP �٨S���@�Ӧ@�ɭܮw�i�ѧA�b�u�O�s�A����ɤ��e�C�D�`�Ʊ�
  ���ܳo�ت��p�C���ܦh�ݭn�ϥ� CVS ����]�G

   1. CVS �N�O�s�@�ӧA����ɪ��~���ƥ��C�b�A�N��ɶǵ��t�~�@�ӧ@�̮ɡA�L
      �u�ݭn�q CVS ���o��ɴN�i�H�~��u�@�C�b�A�ݭn���o�@�Ӥ�ɪ���������
      �A�A�]�i�H�ܧֱo��C
   2. �b�h�H���@�P�@��ɮɫD�`���ΡC�A�i�H�q CVS �o���b�A�s��A�������ɨ�
      �L�@�̰��F���ǭק�A�q�ӱN�Ҧ����ק�ܦn�a���X�b�@�_�C
   3. �O�s�ק諸�O���C�b SGML �B�z���B�z���e�A�A�i�H�ϥΤ@�ǯS���аO�A
      �o�ǰO��(�H�Τ@�Ӯɶ��W)�|�Q�۰ʦa���J���ɤ��C
   4. ���Ѥ@�ӳ~�|�A�b�s��ɧ����ô����q�L�@�ӵ{�Ǧ۰ʦa��s LDP ���I�C

3.7 �o���A�����

 �o�����e

  �b�A�N��ɵo�������d�W�U����bŪ�̤��e�A�ڥ������@�ǨƱ��C

  �����A��A����ɰ����g�ˬd�C�S�������g���~�����Hı�o�O�b���p��@
  �ɤ������K�A�ڬO�̥ʡ��C�\�h�A�i�H�ΨӼg SGML �����ε{��(emacs
  �BLyX...)�����m�����g�ˬd�\��C�p�G�S���A�N�b�Ҧ���linux�o�檩�������w
  �ˤF�@�� ispell �{�ǡC�P�˭n�ϥ� sgmltools ���� sgmlcheck �R�O�ˬd
  SGML �аO�C

  �䦸�A��@�ǤH�����A����ɡC�� LDP �o���������ɥi��O���u��B���T�A�]
  �������d�W�U��Linux�Τ�i��|Ū���C�p�G�A�ѥ[�F�@�Ӭ���D�D�����j�W�Ҫ�
  �l��C��A�i�H�ШD�C������L�H���U�A�C

  �ĤT�A�إߤ@�ӵo���A����ɪ���C�o�ä��O�������A�����U��H�̧��A��
  ��ɪ���l�X�B�C

 ���v�M�\�i

  In order for an LDP document to be accepted by the LDP, it must be
  licensed to allow for free (as in beer) distribution and publishing.
  As an author, you may retain the copyright and add other restrictions
  (for example, you must approve any translations or derivative works).
  A sample license is available at
  [22]http://www.linuxdoc.org/COPYRIGHT.html. If you choose to use the
  boilerplate copyright, simply copy it into your source code under a
  section called "Copyright and Licenses" or similar. Also include a
  copyright statement of your own (since you still own it). If you are a
  new maintainer for an already-existing HOWTO, you must include the
  previous copyright statements of the previous author(s) and the dates
  they maintained that document.

 ��q LDP

  �@���A����ɳQ�@�����H�ݹL�åB�A�w�l���F�L�̪��N���A�A�N�i�H�N��ɰe��
  LDP�C�o�e�l��� [23][email protected] �C24�p�ɤ����A�N�i�H
  ���D���O�_�w�Q�����ðe���D�n�� LDP ���I�C

4. �����n

  �o�ä��O�@�Ӽg�X���ɪ��j��M�ֳt�����n�A����A���g�@������U�C

    * �M���C�Ҧ��H�ݭn���D�A�b������C
    * �b�i�઺�a��ϥΨҤl�C�o��Ҧ��H�ݨ�A�b������C
    * ��´�C���n�b�P�@���`���A�b��Ӥ�����D�D�����Ӹ��h�C

  �A�i�H�q�H�U�a�}�o���h�� LDP �����n�G
  [24]http://www.linuxdoc.org/HOWTO/LDP-Style-Guide.html.

5. ��� LDP ���`�����D

5.1 �ڷQ�� LDP �X�@���O�A�ڸӦp��h�@�H

  ��²�檺��k�N�O��X�@�ǪF��M��g�X�ӡC�]�i�H�d��S�H���@�� HOWTO �M��
  �ݬݬO�_���@�ӧA�F�Ѫ��D�D�i�H�~��g�U�h�C

5.2 �ڷQ�X�� LDP ��ɡCLDP ����ɳ\�i�O��˳W�w���H

  �аѾ\ [25]http://www.linuxdoc.org/COPYRIGHT.html.

5.3 �ڦb�@�� LDP ��ɤ����@�ӿ��~�C�گ�ץ����ܡH

  �p�t��ɪ��@�̡A�Ϊ� LDP ��´�̡A�i�D�L�̦s�b�����D�H�Φp��ץ��C

References

  1. mailto:[email protected]
  2. mailto:[email protected]
  3. mailto:[email protected]
  4. http://www.cgipc.com/~markk
  5. http://www.linuxdoc.org/
  6. ftp://prep.ai.mit.edu/pub/GNU/COPYING
  7. http://www.sgmltools.org/
  8. http://www.lyx.org/
  9. http://www.devel.lyx.org/~ettrich/klyx.html
 10. mailto:[email protected]
 11. mailto:[email protected]
 12. mailto:[email protected]
 13. mailto:[email protected]
 14. mailto:[email protected]
 15. http://www.sgmltools.org/
 16. http://www.debian.org/Packages/stable/text/sgml-tools.html
 17. file://localhost/tmp/zh-sgmltools.31452/HOWTO-HOWTO.txt.html#Introduction
 18. http://www.linuxdoc.org/
 19. http://www.linuxdoc.org/
 20. http://www.sgmltools.org/guide/guide.html
 21. file://localhost/tmp/zh-sgmltools.31452/HOWTO-HOWTO.txt.html#tools
 22. http://www.linuxdoc.org/COPYRIGHT.html
 23. mailto:[email protected]
 24. http://www.linuxdoc.org/HOWTO/LDP-Style-Guide.html
 25. http://www.linuxdoc.org/COPYRIGHT.html