MFen: Resync with the English version of the handbook

Obtained from: FreeBSD Mongolian Documentation project
This commit is contained in:
Ganbold Tsagaankhuu 2009-05-01 15:37:27 +00:00
parent dfe24affc3
commit 9c90e11c25
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=34175

View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Mongolian Documentation Project
Original revision 1.240
Original revision 1.243
$FreeBSD$
-->
@ -82,7 +82,7 @@
</listitem>
<listitem>
<para><application>CVSup</application> ашиглан өөрийн баримтуудыг
<para><application>CVSup</application> эсвэл баримтжуулах порт ашиглан өөрийн баримтуудыг
хэрхэн сүүлийн хувилбарт байлгаж байх талаар<!-- and
<application>Docsnap</application>-->.</para>
</listitem>
@ -926,6 +926,242 @@ DOCSUPFILE?= /usr/share/examples/cvsup/doc-supfile</programlisting>
&prompt.root; <userinput>make FORMATS='html html-split' install clean</userinput></screen>
</sect2>
<sect2 id="doc-ports">
<sect2info>
<authorgroup>
<author>
<firstname>Марк</firstname>
<surname>Фонвил</surname>
<contrib>Хувь нэмэр болгосон </contrib>
</author>
</authorgroup>
</sect2info>
<title>Баримтжуулах портуудыг ашиглах нь</title>
<indexterm><primary>Updating and Upgrading</primary></indexterm>
<indexterm>
<primary>documentation package</primary>
<see>Updating and Upgrading</see>
</indexterm>
<para>Өмнөх хэсэгт &os;-ийн баримтжуулалтыг эхээс нь
шинэчлэх аргыг бид танилцуулсан. &os;-ийн бүх системүүдийн
хувьд эх дээр тулгуурласан шинэчлэлтүүд нь боломжтой эсвэл
практикийн биш байж болох юм. Баримтжуулалтын эхүүдийг
бүтээх нь нэлээн их хэмжээний хэрэгслийн цуглуулга буюу
<emphasis>баримтжуулалт бүтээх хэрэгслийн олонлог</emphasis>,
<application>CVS</application>-ийг тодорхой хэмжээгээр мэдэх,
репозиториос эхийг татаж авах болон татаж авсан эхээ
бүтээх хэд хэдэн шат дарааллуудыг шаарддаг. Энэ хэсэгт
бид &os;-ийн баримтжуулалтын суулгагдсан хуулбаруудыг
шинэчлэх өөр аргыг тайлбарлах болно. Энэ нь портын
цуглуулгыг ашиглах бөгөөд дараах боломжийг бүрдүүлнэ:</para>
<itemizedlist>
<listitem>
<para>Бүгдийг бүтээлгүйгээр баримтжуулалтын урьдчилан
бүтээсэн хормын хувилбарыг татан авч суулгах
(ингэснээр баримтжуулалт бүтээх хэрэгслийн олонлогийг
бүхэлд нь суулгах шаардлагагүй болно).</para>
</listitem>
<listitem>
<para>Баримтжуулалтын эхийг татаж аван портын тогтолцоог
ашиглан бүтээх (татаж аван бүтээх алхмуудыг арай хялбар
болгодог).</para>
</listitem>
</itemizedlist>
<para>&os;-ийн баримтжуулалтыг шинэчлэх эдгээр хоёр арга нь
&a.doceng;-ийн сар бүр шинэчилдэг <emphasis>баримтжуулалтын
портуудын</emphasis> цуглуулгаар дэмжигддэг. Эдгээр нь
&os;-ийн портын цуглуулгад <ulink
url="http://www.freshports.org/docs/">docs</ulink>
виртуал төрөлд байдаг.</para>
<sect3 id="doc-ports-install-make">
<title>Баримтжуулалтын портуудыг бүтээж суулгах нь</title>
<para>Баримтжуулалтын портууд нь баримтжуулалтын бүтээлтийг
хялбар болгохын тулд порт бүтээх тогтолцоог хэрэглэдэг.
&man.make.1;-ийг тохирох орчны тохиргоонууд болон тушаалын
мөрийн тохиргоонуудын хамтаар ажиллуулж баримтжуулалтын
эхийг татаж авах процессыг тэд автоматжуулдаг бөгөөд
баримтжуулалтын суулгалт болон устгалтыг &os;-ийн
бусад порт эсвэл багцын суулгалтын нэгэн адил хялбар
болгодог.</para>
<note>
<para>Мөн баримтжуулалтын портуудыг бүтээсний дараа тэд
хамааралтай <emphasis>баримтжуулалтыг бүтээх хэрэгслийн олонлогийн</emphasis>
портуудыг бүртгэдэг бөгөөд тэдгээрийг автоматаар бас
суулгадаг.</para>
</note>
<para>Баримтжуулалтын портуудын зохион байгуулалт нь
дараах хэлбэрийн байна:</para>
<itemizedlist>
<listitem>
<para>Баримтжуулалтын портын файлууд байдаг
<filename
role="package">misc/freebsd-doc-en</filename>
<quote>мастер порт</quote> байдаг. Энэ нь бүх
баримтжуулалтын портуудын үндэс болдог. Анхдагчаар
энэ нь Англи баримтжуулалтыг зөвхөн бүтээдэг.</para>
</listitem>
<listitem>
<para><quote>Нэг портод бүгд багтсан</quote> <filename
role="package">misc/freebsd-doc-all</filename> байдаг
бөгөөд энэ нь байгаа бүх хэл дээр бүх баримтжуулалтыг
бүтээж суулгадаг.</para>
</listitem>
<listitem>
<para>Эцэст нь орчуулга бүрийн хувьд <quote>зарц порт</quote>
байдаг, жишээ нь Унгар хэл дээрх баримтуудад зориулсан
<filename
role="package">misc/freebsd-doc-hu</filename>-г дурдаж
болно. Эдгээр нь бүгд мастер портоос хамаарах бөгөөд
тухайн хэлний орчуулсан баримтжуулалтыг суулгадаг.</para>
</listitem>
</itemizedlist>
<para>Баримтжуулалтын портыг эхээс суулгахын тулд дараах
тушаалуудыг ажиллуулна (<username>root</username> эрхээр):</para>
<screen>&prompt.root; <userinput>cd /usr/ports/misc/freebsd-doc-en</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
<para>Энэ нь Англи баримтжуулалтыг хуваагдсан <acronym>HTML</acronym>
хэлбэрээр (<ulink
url="http://www.FreeBSD.org"></ulink> дээр ашигладагийн адилаар)
бүтээж <filename
class="directory">/usr/local/share/doc/freebsd</filename> санд
суулгадаг.</para>
<sect4 id="doc-ports-options">
<title>Нийтлэг Knob болон тохируулгууд</title>
<para>Баримтжуулалтын портуудын анхдагч байдлыг өөрчлөх
олон тохиргоо байдаг. Доор цөөхөн хэдэн жагсаалтыг
дурдав:</para>
<variablelist>
<varlistentry>
<term><makevar>WITH_HTML</makevar></term>
<listitem>
<para>HTML хэлбэрээр бүтээхийг зөвшөөрдөг: баримт
бүрийн хувьд нэг HTML файл. Хэлбэршүүлсэн
баримтжуулалт нь тохирох <filename>article.html</filename> юм уу
эсвэл <filename>book.html</filename> гэсэн файлуудад зургийн
хамтаар хадгалагддаг.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><makevar>WITH_PDF</makevar></term>
<listitem>
<para>&adobe; &acrobat.reader;,
<application>Ghostscript</application> эсвэл бусад PDF уншигчдыг
ашиглах &adobe;-ийн хөрвөх баримтын хэлбэрээр бүтээхийг
зөвшөөрдөг. Хэлбэршүүлсэн
баримтжуулалт нь тохирох <filename>article.pdf</filename> юм уу
эсвэл <filename>book.pdf</filename> гэсэн файлуудад
хадгалагддаг.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><makevar>DOCBASE</makevar></term>
<listitem>
<para>Баримтжуулалтын суулгах байрлал. Энэ нь
анхдагчаар <filename
class="directory">/usr/local/share/doc/freebsd</filename>
байдаг.</para>
<note>
<para>Анхдагч суулгах сан нь <application>CVSup</application>
аргын ашигладаг сангаас ялгаатайг санаарай.
Энэ нь яагаад гэвэл бид порт суулгаж байгаа
бөгөөд портууд нь ихэвчлэн <filename
class="directory">/usr/local</filename> санд
суудаг. Үүнийг <makevar>PREFIX</makevar> хувьсагчийг
нэмэн өөрчилж болдог.</para>
</note>
</listitem>
</varlistentry>
</variablelist>
<para>Энд Унгар баримтжуулалтыг Хөрвөх Баримтын Хэлбэрээр (PDF)
суулгахын тулд дээр дурдсан хувьсагчуудыг хэрхэн
ашиглахыг харуулсан жишээг үзүүлэв:</para>
<screen>&prompt.root; cd /usr/ports/misc/freebsd-doc-hu
&prompt.root; make -DWITH_PDF DOCBASE=share/doc/freebsd/hu install clean</screen>
</sect4>
</sect3>
<sect3 id="doc-ports-install-package">
<title>Баримтжуулалтын багцуудыг ашиглах нь</title>
<para>Өмнөх хэсэгт тайлбарласнаар баримтжуулалтын портуудыг
эхээс бүтээх нь баримтжуулалтыг бүтээх хэрэгслийн
олонлогийг суулгах болон портуудыг бүтээхэд тодорхой
хэмжээний дискийн зай шаарддаг. Баримтжуулалтын
хэрэгслүүдийг суулгахад эх үүсвэр хүрэлцэхгүй үед эсвэл
эхээс бүтээх нь ихээхэн хэмжээний дискийн зай эзлэх
бол баримтжуулалтын портуудын урьдчилан бүтээсэн
хормын хувилбаруудыг суулгах боломж бас байдаг.</para>
<para>&a.doceng; нь &os;-ийн баримтжуулалтын багцуудын
сар бүрийн хормын хувилбаруудыг бэлддэг. Эдгээр
хоёртын багцуудыг &man.pkg.add.1;,
&man.pkg.delete.1; гэх зэрэг багцын хэрэгслүүдийн
хамтаар ашиглаж болдог.</para>
<note>
<para>Хоёртын багцуудыг ашиглаж байгаа үед &os;-ийн
баримтжуулалт нь тухайн хэлний хувьд байгаа
<emphasis>бүх</emphasis> хэлбэрээр суудаг.</para>
</note>
<para>Жишээ нь дараах тушаал Унгар баримтжуулалтын
хамгийн сүүлийн урьдчилан бүтээсэн багцыг суулгах
болно:</para>
<screen>&prompt.root; <userinput>pkg_add -r hu-freebsd-doc</userinput></screen>
<note>
<para>Багцууд нь харгалзах портын нэрнээсээ ялгаатай дараах
нэрийн хэлбэртэй байдаг:
<literal><replaceable>lang</replaceable>-freebsd-doc</literal>.
Энд <replaceable>lang</replaceable> нь хэлний кодын богино
хэлбэр юм, жишээ нь <literal>hu</literal> нь Унгар, эсвэл
<literal>zh_cn</literal> нь хялбаршуулсан Хятад хэл юм.</para>
</note>
</sect3>
<sect3 id="doc-ports-update">
<title>Баримтжуулалтын портуудыг шинэчлэх нь</title>
<para>Өмнө нь суулгасан баримтжуулалтын портыг шинэчлэхийн
тулд портууд шинэчлэх аль ч хэрэгсэл байхад хангалттай.
Жишээ нь дараах тушаал суулгасан Унгар баримтжуулалтыг
<filename
role="package">ports-mgmt/portupgrade</filename> хэрэгслийн
тусламжтайгаар зөвхөн багцуудыг ашиглан шинэчилнэ:</para>
<screen>&prompt.root; <userinput>portupgrade -PP hu-freebsd-doc</userinput></screen>
</sect3>
</sect2>
<!-- FIXME: Waiting for a working docsnap server... -->
<![ IGNORE [
<sect2 id="docsnap">