<para>One of the packages that you might need is the JadeTeX macro set.

    <para>¦b³o¨Ç packages ·í¤¤¡A§A¥i¯à·|»Ý­n¨Ï¥Î JadeTeX ³o­Ó macro ³]©w¡A

      In turn, this macro set requires &tex; to be installed.  &tex; is a large

      ¤@¥¹¿ï¾Ü¨Ï¥Î¸Ó macro ªº¸Ü¡A¥¦·|±µµÛ¥h¸Ë &tex;¡C¥Ñ©ó &tex; ºâ¬O­ÓÆZ¤jªº®M¥ó¡A

      package, and you only need it if you want to produce Postscript or PDF

      °£«D§A»Ý­n¿é¥X Postscript ©Î PDF ®æ¦¡¡A§_«h´N¤£¥²¸Ë¤F¡C</para>

      output.</para>

    <para>©Ò¥H½Ð¦Ò¼{¬O§_­n¸`¬Ù½sĶ®É¶¡¡BµwºÐªÅ¶¡¡A¥H§P©w­n¤£­n¸Ë JadeTeX (¥H¤Î &tex;) 

    <para>To save yourself time and space you must specify whether or not you

      ¤F¡C­Y­n¤@¨Ö¸Ë°_¨Óªº¸Ü¡G</para>

      want JadeTeX (and therefore &tex;) installed when you install this port.

      Either do:</para>

    <para>or</para>

    <para>©Î¬O¡A¤£¸Ëªº¸Ü¡G</para>

    <para>as necessary.  Alternatively you may install <filename

    <para>©ÎªÌ¡A¤]¥i¥H¿ï¾Ü <filename

      role="package">textproc/docproj-jadetex</filename> or <filename

      role="package">textproc/docproj-jadetex</filename> ©Î¬O <filename

      role="package">textproc/docproj-nojadetex</filename>.  These slave ports

      role="package">textproc/docproj-nojadetex</filename> ³o¨â­Ó¤§¤@¨Ó¸Ë¡A

      define the <makevar>JADETEX</makevar> variable for you, therefore they

      ¥¦­Ì³£¬O¤w¨Æ¥ý³]©w  <makevar>JADETEX</makevar> Åܼƪº slave ports¡A

      will install the same suite of applications on your machine.

      ³£¤@¼Ë·|¸Ë docproj ®t§O¶È¦b©ó¦³¨S¦³ JadeTeX ¦Ó¤w¡C

      Note that you can produce only HTML or ASCII

      ½Ðª`·N¡G­Y¥u­n¿é¥X HTML ©Î ASCII ®æ¦¡¤å¥ó¡A¨º´N¤£¥Î¸Ë <application>JadeTeX</application>¡A

      text output if you do not install <application>JadeTeX</application>.

      ¦Ó­Y­n¿é¥X PostScript¡BPDF ®æ¦¡¡A´N»Ý­n¸Ë &tex; ¤~¦æ¡C</para>

      PostScript or PDF output require &tex;.</para>

      <para>These programs are required before you can usefully work with the

      <para>³o¨Ç³£¬O¦b¶i¦æ FreeeBSD ¤å¥ó­p¹º®É©Ò·|»Ý­n¥Î¤Wªº¤u¨ãµ{¦¡¡A

	FreeBSD documentation, and they will allow you to convert the

	¦Ó¥B¥i¥H¥Î¨ÓÂà´«¤å¥ó¬° HTML¡Bplain text¥H¤Î RTF ®æ¦¡¡C³o¨Ç¬ÛÃö®M¥ó¦b

	documentation to HTML, plain text, and RTF formats.  They are all

	<filename role="package">textproc/docproj</filename> ³£¤w¸g¥þ³¡¦¬¿ý¤F¡C</para>

	included in <filename role="package">textproc/docproj</filename>.</para>

	    <para>A DSSSL implementation.  Used for converting marked up

	    <para>DSSSL ³W®æªº¹ê§@µ{¦¡¡A¥i¥Î¨Ó§â¼Ð°O»y¨¥ªº¤å¥ó(marked up)Âà´«¬°¨ä¥L®æ¦¡¡A¹³¬O¡GHTML ¤Î &tex;¡C</para>

	      documents to other formats, including HTML and &tex;.</para>

	    <para>An HTML <quote>pretty printer</quote>, used to reformat some of the

	    <para>HTML <quote>pretty printer</quote>¡A¥i¥Î¨Ó§â¦Û°Ê²£¥Íªº HTML ¤º®e¾ã²z±o§ó©ö¾\Ū¡B¥H«K¤é«áºûÅ@¡C</para>

	      automatically generated HTML so that it is easier to

	      follow.</para>

	    <para>A text-mode WWW browser that can also convert

	    <para>¤å¦r¾Þ§@¼Ò¦¡ªº WWW ÂsÄý¾¹(browser)¥i¥H§â HTML ÀÉÂର plain text ®æ¦¡¡C</para>

	      HTML files to plain text.</para>

	    <para>Some of the documentation includes images, some of which are

	    <para>¤å¥ó¤¤¦³¨Ç¹Ï¬O¦s¦¨ EPS ®æ¦¡ªº¡A³o¨Ç¥²¶·­nÂର PNG ®æ¦¡¡A

	      stored as EPS files.  These must be converted to PNG before most

	      ¤~¯àÅý¤@¯ëÂsÄý¾¹¥i¥H¥¿±`Æ[¬Ý¡C</para>

	      web browsers will display them.</para>

      <title>DTDs ¤Î Entities</title>

      <title>DTD ¤Î Entity</title>

      <para>These are the DTDs and entity sets used by the FDP.  They need to

      <para>¥Ñ©ó FDP ¦³¥Î¨ì³\¦h DTD ¸ò Entity¡A¦]¦¹¦b¶}¤u«e¡A­n¸Ë¤W³o¨Ç¤~¦æ¡C</para>

	be installed before you can work with any of the documentation.</para>

	    <para>HTML is the markup language of choice for the World Wide

	    <para>HTML ¬O¥Î©ó WWW ªº¼Ð°O»y¨¥¡A¥B¤]¬O FreeBSD ºô­¶©Ò¨Ï¥Îªº®æ¦¡¡C</para>

	      Web, and is used throughout the FreeBSD web site.</para>

	    <para>DocBook is designed for marking up technical documentation.

	    <para>DocBook ¬O±Mªù¥Î¨Ó»s§@§Þ³N¤å¥óªº¼Ð¥Ü»y¨¥ª©¥»¡A

	      All the FreeBSD documentation is written in DocBook.</para>

	      FreeBSD ¥þ³¡¤å¥ó³£¬O¥H DocBook ©Ò¼g¦¨ªº¡C</para>

	    <para>19 of the ISO 8879:1986 character entity sets used by many

	    <para>¦b ISO 8879:1986 ¤§¤¤¦³ 19 ­Ó entity ³Q³\¦h DTD ©Ò¤j¶q¨Ï¥Î¡A

	      DTDs.  Includes named mathematical symbols, additional

	      ¥]¬A¤F¼Æ¾Ç²Å¸¹¡B©Ô¤B¦r¥À²Å¸¹(¦y­«­µµ¥­µ¸`²Å¸¹¤]¬O)¥H¤Î§Æþ²Å¸¹¡C</para>

	      characters in the Latin character set (accents, diacriticals,

	      and so on), and Greek symbols.</para>

      <para>The stylesheets are used when converting and formatting the

      <para>³o¨Ç¼Ë¦¡ªí³£¬O¥Î¨ÓÂà´«¡B­«±Æ¤å¥óªº¿Ã¹õÅã¥Ü¡B¦C¦Lµ¥®ÄªG³B²z</para>

	documentation for display on screen, printing, and so on.</para>

	  <term>Modular DocBook Stylesheets

	  <term>Modular DocBook ¼Ë¦¡ªí

	    <para>The Modular DocBook Stylesheets are used when converting

	    <para>Modular DocBook ¼Ë¦¡ªí¡A¬O¥Î¨Ó§â DocBook ªº¼Ð°O»y¨¥¤å¥óÂà´«¬°¨ä¥L®æ¦¡¡A¹³¬O¡G

	      documentation marked up in DocBook to other formats, such as

	      HTML ©Î RTF¡C</para>

	      HTML or RTF.</para>

    <title>Optional tools</title>

    <title>»²§U¤u¨ã</title>

    <para>You do not need to have any of the following installed.  However,

    <para>¤£¤@©w±o¸Ë¤U¦Cªº¤u¨ã¤~¦æ¡A¦ý¬O¡A¸Ë¤F¤§«á·|§ó®e©ö¶i¦æ¦U¶µ¤u§@¡A

      you may find it easier to work with the documentation if you do, and

      ¦Ó¥B¥i¿é¥Xªº®æ¦¡¤]§ó¨ã¼u©Ê¡C</para>

      they may give you more flexibility in the output formats that can be

      generated.</para>

      <title>Software</title>

      <title>³nÅé</title>

	  <term><application>JadeTeX</application> and

	  <term><application>JadeTeX</application> ¤Î

	    (<filename role="package">print/jadetex</filename> and

	    (<filename role="package">print/jadetex</filename> ¤Î

	    <para><application>Jade</application> and

	    <para><application>Jade</application> »P

	      <application>teTeX</application> are used to convert DocBook

	      <application>teTeX</application> ¥i¥Î¨Ó§â DocBook ®æ¦¡¤å¥óÂର 

	      documents to DVI, Postscript, and PDF formats.  The

	      DVI, Postscript ¤Î PDF ®æ¦¡¡C¦w¸Ë®É½Ð°O±o¥[¤W 

	      <application>JadeTeX</application> macros are needed in order to

	      <application>JadeTeX</application> ³o­Ó macro¡A³o¼Ë¤~·|¶¶«K¸Ë¤W³o¨â­Ó®M¥ó¡C</para>

	      do this.</para>

	    <para>­YµL·N§â¤å¥óÂà´«§ó¦h®æ¦¡ªº¸Ü(Á|¨Ò¡G¥u­n HTML, plain text, RTF ³o¨Ç®æ¦¡´N°÷ªº¸Ü)

	    <para>If you do not intend to convert your documentation to one of

	      ¡A¨º»ò´N¤£¥Î¸Ë

	      these formats (i.e., HTML, plain text, and RTF are sufficient)

	      <application>JadeTeX</application> »P

	      then you do not need to install

	      <application>teTeX</application>¡C  ¦p¦¹¤@¨Ó¥i¬Ù¤U¤@¨Çªº½sĶ®É¶¡¡B¦w¸ËªÅ¶¡¡A

	      <application>JadeTeX</application> and

	      ¦]¬° <application>teTeX</application> ¤j¬ù­n¦Ü¤Ö 30MB ªÅ¶¡¡C</para>

	      <application>teTeX</application>.  This can be a significant

	      space and time saver, as <application>teTeX</application> is

	      over 30MB in size.</para>

	      <para>If you decide to install

	      <para>­Y¨M©w­n¸Ë

		<application>JadeTeX</application> and

		<application>JadeTeX</application> ¥H¤Î

		<application>teTeX</application> then you will need to

		<application>teTeX</application> ªº¸Ü¡A¨º»ò¦b¸Ë§¹ <application>JadeTeX</application> ¤§«á¡A

		configure <application>teTeX</application> after

		­n°O±o³]©w <application>teTeX</application> ¤~¦æ¡C

		<application>JadeTeX</application> has been installed.

		<filename>print/jadetex/pkg-message</filename> ¤º¦³¸Ô²Ó¤¶²Ð¬ÛÃö¨BÆJ¡C</para>

		<filename>print/jadetex/pkg-message</filename> contains

		detailed instructions explaining what you need to do.</para>

	  <term><application>Emacs</application> or

	  <term><application>Emacs</application> ©Î

	    (<filename role="package">editors/emacs</filename> or

	    (<filename role="package">editors/emacs</filename> ©Î

	    <para>Both these editors include a special mode for editing

	    <para>³o¨âªÌ½s¿è¾¹³£¨ã¦³³B²z SGML DTD ¼Ð°O¤å¥óªº¯S®í¼Ò¦¡¡C

	      documents marked up according to an SGML DTD.  This mode

	      ¸Ó¼Ò¦¡´£¨Ñ¤@¨Ç«ü¥O¡A¨Ó²¤Æ©Ò»Ýªº¥´¦r¦¸¼Æ¡A¦Ó¥B¥i¥H´î¤Ö¥i¯àµo¥Íªº¿ù»~¡C</para>

	      includes commands to reduce the amount of typing you need, and

	      help reduce the possibility of errors.</para>

	    <para>¤£¹L¡A³o¨Ç½s¿è¾¹¨Ã¤£¬O¥²³Æªº¡F¥ô¦ó¤å¦r½s¿è¾¹³£¥i¥H¥Î¨Ó½s¿è¼Ð°O»y¨¥¤å¥ó¡C

	      ¤£¹L¡A§A¥i¥H³z¹LÃþ¦ü¤W­z³o¼Ëªº½s¿è¾¹¡A¨ÓÅý³o¨ÇÁcº¾§@·~§ó»´ÃP¦³®Ä²v¨Ç¡C</para>

	    <para>You do not need to use them; any text editor can be used to

	      edit marked up documents.  You may find they make you more

	      efficient.</para>

      <para>If anyone has recommendations for other software that is useful

      <para>­Y¦³±ÀÂ˨ä¥L¦n¥Îªº³B²z SGML ¤å¥óµ{¦¡¡A½Ð¨Ó«HÅý &a.doceng; ª¾¹D¡A

	when manipulating SGML documents, please let &a.doceng; know, so they

        ¦p¦¹¤@¨Ó¡A¸Ó³nÅé´N·|¦C¤J³o¸Ì¤¶²Ð¤F¡C</para>

	can be added to this list.</para>