aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGanbold Tsagaankhuu <ganbold@FreeBSD.org>2009-01-08 03:56:31 +0000
committerGanbold Tsagaankhuu <ganbold@FreeBSD.org>2009-01-08 03:56:31 +0000
commit67b3ea6ded0cc71098ecbcd3ff494fe1b3c1e4c6 (patch)
treebac237d409914dedeafc9c59d58369296820c1ce
parent346bff72fd3c3db9aa7c6a368ad071d88e87236a (diff)
downloaddoc-67b3ea6ded0cc71098ecbcd3ff494fe1b3c1e4c6.tar.gz
doc-67b3ea6ded0cc71098ecbcd3ff494fe1b3c1e4c6.zip
MFen: Resync with the English version of the handbook
Obtained from: FreeBSD Mongolian Documentation project
Notes
Notes: svn path=/head/; revision=33675
-rw-r--r--mn_MN.UTF-8/books/handbook/cutting-edge/chapter.sgml319
-rw-r--r--mn_MN.UTF-8/books/handbook/ports/chapter.sgml24
2 files changed, 320 insertions, 23 deletions
diff --git a/mn_MN.UTF-8/books/handbook/cutting-edge/chapter.sgml b/mn_MN.UTF-8/books/handbook/cutting-edge/chapter.sgml
index a1308ea5c1..62997ac6c8 100644
--- a/mn_MN.UTF-8/books/handbook/cutting-edge/chapter.sgml
+++ b/mn_MN.UTF-8/books/handbook/cutting-edge/chapter.sgml
@@ -1,7 +1,7 @@
<!--
The FreeBSD Mongolian Documentation Project
- Original revision 1.235
+ Original revision 1.236
$FreeBSD$
-->
@@ -82,6 +82,12 @@
</listitem>
<listitem>
+ <para><application>CVSup</application> ашиглан өөрийн баримтуудыг
+ хэрхэн сүүлийн хувилбарт байлгаж байх талаар<!-- and
+ <application>Docsnap</application>-->.</para>
+ </listitem>
+
+ <listitem>
<para>&os.stable; болон &os.current; хөгжүүлэлтийн
салбаруудын ялгаа.</para>
</listitem>
@@ -671,6 +677,317 @@ Fetching 133 new ports or files... done.</screen>
<screen>&prompt.root; <userinput>portsnap fetch update</userinput></screen>
</sect1>
+ <sect1 id="updating-upgrading-documentation">
+ <title>Баримтын цуглуулгыг шинэчлэх нь</title>
+
+ <indexterm><primary>Updating and Upgrading</primary></indexterm>
+
+ <indexterm>
+ <primary>Documentation</primary>
+ <see>Updating and Upgrading</see>
+ </indexterm>
+
+ <para>Үндсэн систем болон портын цуглуулгаас гадна
+ баримтууд нь &os; үйлдлийн системийн салшгүй хэсэг юм. Хэдийгээр
+ &os;-ийн хамгийн сүүлийн үеийн баримтын цуглуулга <ulink
+ url="http://www.freebsd.org/doc/">&os; вэб сайт</ulink> дээр
+ үргэлж байдаг боловч зарим хэрэглэгчид удаан сүлжээний холболттой эсвэл
+ бүр тогтмол сүлжээний холболтгүй байж болох юм. Азаар &os;-ийн хамгийн
+ сүүлийн үеийн баримтын цуглуулгын локал хуулбарыг арчлан хувилбар бүртэй цуг
+ ирдэг баримтыг шинэчлэх хэд хэдэн арга байдаг.</para>
+
+ <sect2 id="csup-doc">
+ <title>Баримтыг шинэчлэхийн тулд CVSup-г ашиглах нь</title>
+
+ <para>Үндсэн системийг шинэчлэхтэй төстэй аргыг ашиглан
+ <application>CVSup</application> хэрэглэн эх болон &os;-ийн
+ баримтуудын суулгагдсан хуулбарыг шинэчилж болно
+ (<xref linkend="makeworld">). Энэ хэсэг дараах зүйлсийг
+ тайлбарладаг:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>&os;-ийн баримтуудыг эхээс нь бүтээхэд шаардлагатай
+ хэрэгслүүд, баримтын хэрэгслүүдийг хэрхэн суулгах
+ талаар.</para>
+ </listitem>
+
+ <listitem>
+ <para><application>CVSup</application> ашиглан
+ <filename class="directory">/usr/doc</filename> дахь
+ баримтын эхийн хуулбарыг хэрхэн татаж авах талаар.</para>
+ </listitem>
+
+ <listitem>
+ <para>&os;-ийн баримтыг эхээс нь хэрхэн бүтээж
+ <filename class="directory">/usr/share/doc</filename> дотор
+ суулгах талаар.</para>
+ </listitem>
+
+ <listitem>
+ <para>Баримтыг бүтээх системийн дэмждэг бүтээлтийн
+ зарим тохируулгууд, өөрөөр хэлбэл баримтын зарим нэг
+ хэл дээрх орчуулгыг зөвхөн бүтээдэг тохируулгууд эсвэл
+ тусгай гаралтын хэлбэржүүлэлтийг сонгодог тохируулгууд.</para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+ <sect2 id="installing-documentation-toolchain">
+ <title>CVSup болон баримтын хэрэгслүүдийг суулгах нь</title>
+
+ <para>&os;-ийн баримтыг эхээс нь бүтээхэд нэлээн олон
+ тооны хэрэгслүүдийг шаарддаг. Эдгээр хэрэгслүүд нь
+ &os;-ийн үндсэн системийн хэсэг биш байдаг. Учир нь эдгээр нь
+ ихээхэн хэмжээний дискийн зай шаарддаг бөгөөд &os;-ийн бүх
+ хэрэглэгчдэд хэрэгтэй байдаггүй. Тэдгээр нь &os;-д зориулж
+ шинэ баримтууд идэвхтэй бичдэг эсвэл өөрсдийн баримтыг
+ эхээс нь байнга шинэчилдэг хэрэглэгчдэд зөвхөн хэрэгтэй
+ байдаг.</para>
+
+ <para>Бүх шаардлагатай хэрэгслүүд портын цуглуулгад байдаг.
+ Эдгээр хэрэгслүүдийн эхний суулгалт болон хожмын шинэчлэлтүүдийг
+ хялбаршуулах <filename
+ role="package">textproc/docproj</filename> порт нь &os;-ийг
+ баримтжуулах төслөөс хөгжүүлсэн мастер порт юм.</para>
+
+ <note>
+ <para>&postscript; эсвэл PDF баримт шаардлагагүй үед харин
+ <filename
+ role="package">textproc/docproj-nojadetex</filename> портыг
+ суулгаж болох юм. Баримтын хэрэгслийн энэ хувилбар нь
+ <application>teTeX</application> тайпсет хөдөлгүүрээс бусад
+ бүгдийг багтаасан байдаг. <application>teTeX</application> нь
+ маш олон хэрэгслүүдийн цуглуулга учир PDF гаралт үнэхээр
+ шаардлагагүй тохиолдолд суулгахгүй байх нь зохимжтой
+ байдаг.</para>
+ </note>
+
+ <para><application>CVSup</application>-г суулгаж ашиглах талаарх
+ дэлгэрэнгүй мэдээллийг <link
+ linkend="cvsup">CVSup-г ашиглах</link> хэсгээс үзнэ үү.</para>
+ </sect2>
+
+ <sect2 id="updating-documentation-sources">
+ <title>Баримтын эхийг шинэчлэх нь</title>
+
+ <para><application>CVSup</application> нь
+ <filename>/usr/share/examples/cvsup/doc-supfile</filename> файлыг
+ тохиргооны загвар болгон ашиглаж баримтын эхийн цэвэр хуулбарыг татан
+ авч чаддаг. Анхдагч шинэчлэлтийн хост нь <filename>doc-supfile</filename>
+ файлд зааснаар байгаа боловч &man.cvsup.1; нь тушаалын мөрөөс хостын
+ нэрийг авдаг бөгөөд баримтын эхийг аль нэг <application>CVSup</application>
+ серверээс дараах тушаалыг бичин татан авч болно:</para>
+
+ <screen>&prompt.root; <userinput>cvsup -h <replaceable>cvsup.FreeBSD.org</replaceable> -g -L 2 <filename>/usr/share/examples/cvsup/doc-supfile</filename></userinput></screen>
+
+ <para><replaceable>cvsup.FreeBSD.org</replaceable>-г хамгийн ойр
+ <application>CVSup</application> серверээр солих хэрэгтэй. Толин
+ тусгал сайтуудын бүрэн жагсаалтыг <xref
+ linkend="cvsup-mirrors">-с үзнэ үү.</para>
+
+ <para>Баримтын эхийн эхний таталт хугацаа шаардаж болох юм. Дуустал нь
+ хүлээх хэрэгтэй.</para>
+
+ <para>Баримтын эхийн дараа дараагийн шинэчлэлтүүдийг дээрх тушаалыг
+ ашиглан татан авч болно. <application>CVSup</application> хэрэгсэл нь
+ хамгийн сүүлийн удаа ажилласнаашаа хойших шинэчлэлтүүдийг зөвхөн татан
+ авч хуулдаг учир эхний удаа бүрэн ажилласнаас хойш дараа дараагийн
+ удаа <application>CVSup</application>-г ажиллуулахад илүү хурдан
+ байдаг.</para>
+
+ <para>Эхийг татан авсныхаа дараа баримтыг шинэчлэх өөр нэг арга нь
+ <filename
+ class="directory">/usr/doc</filename> сангийн
+ <filename>Makefile</filename>-аар дэмжигдсэн байдаг.
+ <filename>/etc/make.conf</filename> файлд
+ <makevar>SUP_UPDATE</makevar>, <makevar>SUPHOST</makevar> болон
+ <makevar>DOCSUPFILE</makevar>-ийг тохируулснаар доорхийг
+ ажиллуулах боломжтой болно:</para>
+
+ <screen>&prompt.root; <userinput>cd /usr/doc</userinput>
+&prompt.root; <userinput>make update</userinput></screen>
+
+ <para><filename>/etc/make.conf</filename>-д зориулсан
+ &man.make.1;-ийн эдгээр тохируулгууд ийм байдаг:</para>
+
+ <programlisting>SUP_UPDATE= yes
+SUPHOST?= cvsup.freebsd.org
+DOCSUPFILE?= /usr/share/examples/cvsup/doc-supfile</programlisting>
+
+ <note>
+ <para><makevar>SUPHOST</makevar>
+ болон <makevar>DOCSUPFILE</makevar> утгад <literal>?=</literal>-г
+ өгснөөр бүтээх тушаалын мөрөөс өөрчлөх боломжийг бүрдүүлдэг.
+ Энэ нь <filename>make.conf</filename>-д тохируулгууд нэмэх
+ зөвлөсөн арга юм. Ингэснээр өөр өөр тохируулгын утгыг тест хийх
+ болгонд файлыг засварлах шаардлагагүй болгодог.</para>
+ </note>
+ </sect2>
+
+ <sect2 id="updating-documentation-options">
+ <title>Баримтын эхийн тааруулж болох тохируулгууд</title>
+
+ <para>&os;-ийн баримтжуулалтыг бүтээж шинэчлэх систем нь баримтын
+ зөвхөн тодорхой хэсгийг шинэчлэх эсвэл тусгай орчуулгыг бүтээх
+ процессийг амарчлах хэдэн тохируулгыг дэмждэг. Эдгээр тохируулгуудыг
+ <filename>/etc/make.conf</filename> файлд бүхэл системийн
+ хувьд зааж өгөх юм уу эсвэл &man.make.1; хэрэгсэлд тушаалын
+ мөрийн тохиргоо маягаар зааж өгч болно.</para>
+
+ <para>Дараах тохируулгууд нь эдгээрийн зарим нь юм:</para>
+
+ <variablelist>
+ <varlistentry>
+ <term><makevar>DOC_LANG</makevar></term>
+
+ <listitem>
+ <para>Бүтээж суулгах хэл ба кодчилолын жагсаалт, жишээ нь
+ Англи баримтад зөвхөн зориулсан <literal>en_US.ISO8859-1</literal>
+ байна.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><makevar>FORMATS</makevar></term>
+
+ <listitem>
+ <para>Бүтээх ганц хэлбэржүүлэлт эсвэл гаралтын хэлбэржүүлэлтийн
+ жагсаалт. Одоогоор <literal>html</literal>,
+ <literal>html-split</literal>, <literal>txt</literal>,
+ <literal>ps</literal>, <literal>pdf</literal>,
+ болон <literal>rtf</literal> дэмжигдсэн байгаа.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><makevar>SUPHOST</makevar></term>
+
+ <listitem>
+ <para>Шинэчлэхэд ашиглах <application>CVSup</application>
+ серверийн хостын нэр.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ <para>&os; дээрх системийн тохируулга болон дэмжигдсэн бүтээлтийн
+ хувьсагчуудын талаар дэлгэрэнгүйг &man.make.conf.5;-с үзнэ үү.</para>
+
+ <para>&os;-ийн баримтжуулалт бүтээх системийн дэмждэг бүтээлтийн
+ хувьсагчуудын талаар дэлгэрэнгүйг
+ <ulink url="&url.doc.langbase;/books/fdp-primer">Шинэ хувь нэмэр оруулагчдад
+ зориулсан &os; баримтжуулах төслийн гарын авлагаас</ulink> үзнэ үү.</para>
+ </sect2>
+
+ <sect2 id="updating-installed-documentation">
+ <title>&os;-ийн баримтуудыг эхээс суулгах нь</title>
+
+ <para>Баримтын эхийн хамгийн сүүлийн хормын хувилбарыг
+ <filename class="directory">/usr/doc</filename> санд татаж авснаар
+ суулгагдсан баримтын шинэчлэлтийг хийхэд бүх юм бэлэн болно.</para>
+
+ <para><makevar>DOC_LANG</makevar> makefile-ийн тохиргоонд заагдсан
+ бүх хэлний бүрэн шинэчлэлтийг дараахийг бичин хийж болно:</para>
+
+ <screen>&prompt.root; <userinput>cd /usr/doc</userinput>
+&prompt.root; <userinput>make install clean</userinput></screen>
+
+ <para>Хэрэв <filename>make.conf</filename> нь зөв
+ <makevar>DOCSUPFILE</makevar>, <makevar>SUPHOST</makevar>
+ болон <makevar>SUP_UPDATE</makevar> тохиргоонуудтайгаар
+ тохируулагдсан бол суулгах алхмыг баримтын шинэчлэлттэй цуг
+ хамтатган ингэж хийж өгч болно:</para>
+
+ <screen>&prompt.root; <userinput>cd /usr/doc</userinput>
+&prompt.root; <userinput>make update install clean</userinput></screen>
+
+ <para>Хэрэв зөвхөн тусгай хэлний шинэчлэлт хэрэгтэй бол
+ <filename class="directory">/usr/doc</filename>-ийн тухайн хэлний
+ тусгай дэд санд &man.make.1;-ийг ажиллуулж болно, жишээ нь:</para>
+
+ <screen>&prompt.root; <userinput>cd /usr/doc/en_US.ISO8859-1</userinput>
+&prompt.root; <userinput>make update install clean</userinput></screen>
+
+ <para>Суулгах гаралтын хэлбэржүүлэлтийг <makevar>FORMATS</makevar>
+ бүтээлтийн хувьсагчийг зааж өгөн хийж өгч болно,
+ жишээ нь:</para>
+
+ <screen>&prompt.root; <userinput>cd /usr/doc</userinput>
+&prompt.root; <userinput>make FORMATS='html html-split' install clean</userinput></screen>
+ </sect2>
+
+<!-- FIXME: Waiting for a working docsnap server... -->
+<![ IGNORE [
+ <sect2 id="docsnap">
+ <sect2info>
+ <authorgroup>
+ <author>
+ <firstname>Пав</firstname>
+ <surname>Лукистник</surname>
+ <contrib>Мэдээллээр хангасан </contrib>
+ </author>
+ </authorgroup>
+ </sect2info>
+
+ <title>Docsnap-ийг ашиглах нь</title>
+
+ <indexterm><primary>Updating and Upgrading</primary></indexterm>
+
+ <indexterm>
+ <primary>Docsnap</primary>
+ <see>Updating and Upgrading</see>
+ </indexterm>
+
+ <para><application>Docsnap</application> нь &os;-ийн баримтуудыг
+ хялбар, хурдан аргаар шинэчлэхэд зориулагдсан &man.rsync.1;
+ репозитор юм. <quote><application>Docsnap</application> сервер</quote>
+ нь баримтын эхүүдийг дагаж тэдгээрийг цаг бүр HTML хэлбэрт бүтээж
+ байдаг. <filename role="package">textproc/docproj</filename> нь
+ <application>Docsnap</application>-д хэрэггүй байдаг. Учир нь
+ зөвхөн бүтээсэн баримтад зориулсан нөхөөсүүд байдаг болохоор тэр юм.</para>
+
+ <para>Энэ техникийг ашиглахад шаардлагатай цорын ганц зүйл нь
+ <filename role="package">net/rsync</filename> порт юм уу эсвэл багц
+ байдаг. Үүнийг нэмэхийн тулд дараах тушаалыг ашиглана:</para>
+
+ <screen>&prompt.root; <userinput>pkg_add -r rsync</userinput></screen>
+
+ <note>
+ <para><application>Docsnap</application> нь
+ <filename class="directory">/usr/share/doc</filename>-д суулгагдсан
+ баримтыг шинэчлэхэд зориулж анхлан хөгжүүлэгдсэн боловч дараах жишээнүүдийг
+ бусад сангуудын хувьд тохируулан ашиглаж болно. Хэрэглэгчийн сангуудын
+ хувьд энэ нь <username>root</username> эрхийг шаарддаггүй.</para>
+ </note>
+
+ <para>Баримтын цуглуулгыг шинэчлэхийн тулд дараах тушаалыг
+ ажиллуулна:</para>
+
+ <screen>&prompt.root; <userinput>rsync -rltvz <replaceable>docsnap.sk.FreeBSD.org</replaceable>::docsnap <replaceable>/usr/share/doc</replaceable></userinput></screen>
+
+ <note>
+ <para>Одоогоор зөвхөн нэг <application>Docsnap</application>
+ сервер байгаа, <hostid>docsnap.sk.FreeBSD.org</hostid> дээр
+ харуулагдсан байгаа.</para>
+ </note>
+
+ <para>Энд <option>--delete</option> тохируулыг ашиглах хэрэггүй,
+ учир нь <command>make installworld</command> тушаалын үеэр
+ <filename class="directory">/usr/share/doc</filename>
+ санд суулгагдсан зарим зүйлсийг санамсаргүйгээр устгаж болох юм.
+ Цэвэрлэхийн тулд энэ тушаалыг ашиглана:</para>
+
+ <screen>&prompt.root; <userinput>rsync -rltvz --delete <replaceable>docsnap.sk.FreeBSD.org</replaceable>::docsnap/??_??\.\* <replaceable>/usr/share/doc</replaceable></userinput></screen>
+
+ <para>Хэрэв баримтын хэсгийг шинэчлэх шаардлагатай бол жишээ нь
+ Англи баримтыг зөвхөн шинэчлэх бол дараах тушаалыг ашиглах
+ шаардлагатай:</para>
+
+ <screen>&prompt.root; <userinput>rsync -rltvz <replaceable>docsnap.sk.FreeBSD.org</replaceable>::docsnap/en_US.ISO8859-1 <replaceable>/usr/share/doc</replaceable></userinput></screen>
+ </sect2>
+]]>
+ </sect1>
+
<sect1 id="current-stable">
<title>Хөгжүүлэлтийн салбарыг дагах нь</title>
<indexterm><primary>-CURRENT</primary></indexterm>
diff --git a/mn_MN.UTF-8/books/handbook/ports/chapter.sgml b/mn_MN.UTF-8/books/handbook/ports/chapter.sgml
index cb62a17f88..b28a18ef37 100644
--- a/mn_MN.UTF-8/books/handbook/ports/chapter.sgml
+++ b/mn_MN.UTF-8/books/handbook/ports/chapter.sgml
@@ -1,7 +1,7 @@
<!--
The FreeBSD Mongolian Documentation Project
- Original revision 1.286
+ Original revision 1.287
$FreeBSD$
-->
@@ -628,30 +628,10 @@ docbook =
<title>Portsnap арга</title>
<para><application>Portsnap</application> нь портын цуглуулгыг шинэчлэх бас нэг арга
- билээ. Энэ програм нь анх &os;&nbsp;6.0 хувилбарт эхлэн хэрэглэгдсэн. Хуучин
- хувилбаруудад үүнийг <filename
- role="package">ports-mgmt/portsnap</filename> гэсэн багцыг суулгаж ашиглана:</para>
-
- <screen>&prompt.root; <userinput>pkg_add -r portsnap</userinput></screen>
-
- <para><link linkend="updating-upgrading-portsnap">Portsnap-г хэрэглэх нь</link> хэсгээс
+ билээ. <link linkend="updating-upgrading-portsnap">Portsnap-г хэрэглэх нь</link> хэсгээс
<application>Portsnap</application>-тай холбоотой бүх мэдээллийг харна уу.</para>
<step>
- <para>&os;&nbsp;6.1-RELEASE хувилбар болон
- <application>Portsnap</application> порт юм уу багцын сүүлийн
- хувилбартай бол энэ хэсгийг та алгасаж болно. <filename
- class="directory">/usr/ports</filename> сан нь
- &man.portsnap.8; тушаалыг анх удаагаа хэрэглэх үед автоматаар үүсгэгддэг.
- <application>Portsnap</application>-н өмнөх хувилбаруудтай бөгөөд
- <filename
- class="directory">/usr/ports</filename> сан байхгүй бол хоосон ийм
- сан үүсгэх хэрэгтэй:</para>
-
- <screen>&prompt.root; <userinput>mkdir /usr/ports</userinput></screen>
- </step>
-
- <step>
<para>Шахсан хэлбэртэй портын цуглуулгыг
<filename class="directory">/var/db/portsnap</filename> сан дотор
татаж авах хэрэгтэй. Хэрэв та хүсвэл энэ алхмын дараа интернэтээс