MFen: Resync with the English version of the handbook
Obtained from: FreeBSD Mongolian Documentation project
This commit is contained in:
Ganbold Tsagaankhuu
parent
346bff72fd
commit
67b3ea6ded
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=33675
2 changed files with 320 additions and 23 deletions
|
|
@ -1,7 +1,7 @@
|
|||
<!--
|
||||
The FreeBSD Mongolian Documentation Project
|
||||
|
||||
Original revision 1.235
|
||||
Original revision 1.236
|
||||
|
||||
$FreeBSD$
|
||||
-->
|
||||
|
|
@ -81,6 +81,12 @@
|
|||
хэрхэн харьцуулах талаар.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><application>CVSup</application> ашиглан өөрийн баримтуудыг
|
||||
хэрхэн сүүлийн хувилбарт байлгаж байх талаар<!-- and
|
||||
<application>Docsnap</application>-->.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>&os.stable; болон &os.current; хөгжүүлэлтийн
|
||||
салбаруудын ялгаа.</para>
|
||||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
<!--
|
||||
The FreeBSD Mongolian Documentation Project
|
||||
|
||||
Original revision 1.286
|
||||
Original revision 1.287
|
||||
|
||||
$FreeBSD$
|
||||
-->
|
||||
|
|
@ -628,29 +628,9 @@ docbook =
|
|||
<title>Portsnap арга</title>
|
||||
|
||||
<para><application>Portsnap</application> нь портын цуглуулгыг шинэчлэх бас нэг арга
|
||||
билээ. Энэ програм нь анх &os; 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; 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> сан дотор
|
||||
|
|
|
|||
Loading…
Reference in a new issue