doc/ru_RU.KOI8-R/books/fdp-primer/the-website/chapter.xml
Gabor Kovesdan a6684b4306 - Reduce the misuse of role attribute; role="directory" should actually be
class="directory"
- Add constraint to enforce this
2013-04-04 11:40:58 +00:00

211 lines
8 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="koi8-r"?>
<!--
The FreeBSD Russian Documentation Project
$FreeBSD$
$FreeBSDru: frdp/doc/ru_RU.KOI8-R/books/fdp-primer/the-website/chapter.xml,v 1.5 2005/06/02 15:18:17 andy Exp $
Original revision: r24690
-->
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
Redistribution and use in source (SGML DocBook) and 'compiled' forms
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code (SGML DocBook) must retain the above
copyright notice, this list of conditions and the following
disclaimer as the first lines of this file unmodified.
2. Redistributions in compiled form (transformed to other DTDs,
converted to PDF, PostScript, RTF and other formats) must reproduce
the above copyright notice, this list of conditions and the
following disclaimer in the documentation and/or other materials
provided with the distribution.
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
-->
<chapter id="the-website">
<title>Web-ÓÅÒ×ÅÒ</title>
<sect1 id="the-website-prep">
<title>ðÏÄÇÏÔÏ×ËÁ</title>
<para>îÁÊÄÉÔÅ 200 íÂÁÊÔ Ó×ÏÂÏÄÎÏÇÏ ÄÉÓËÏ×ÏÇÏ ÐÒÏÓÔÒÁÎÓÔ×Á. ÷ÁÍ ÐÏÔÒÅÂÕÅÔÓÑ
ÍÅÓÔÏ ÄÌÑ ÉÎÓÔÒÕÍÅÎÔÏ× SGML, ÞÁÓÔÉ ÄÅÒÅ×Á CVS, ×ÒÅÍÅÎÎÏÅ ÐÒÏÓÔÒÁÎÓÔ×Ï ÄÌÑ
ÐÏÓÔÒÏÅÎÉÑ É ÐÒÏÓÔÒÁÎÓÔ×Ï ÄÌÑ ÕÓÔÁÎÏ×ËÉ Web-ÓÔÒÁÎÉÃ. åÓÌÉ Õ ×ÁÓ ÕÖÅ
ÕÓÔÁÎÏ×ÌÅÎÙ ÉÎÓÔÒÕÍÅÎÔÙ SGML É ÄÅÒÅ×Ï CVS, ÔÏ ×ÁÍ ÎÕÖÎÏ ÔÏÌØËÏ ÏËÏÌÏ
100 íÂÁÊÔ Ó×ÏÂÏÄÎÏÇÏ ÄÉÓËÏ×ÏÇÏ ÐÒÏÓÔÒÁÎÓÔ×Á.</para>
<note>
<para>õÄÏÓÔÏ×ÅÒØÔÅÓØ, ÞÔÏ ×ÁÛÉ ÐÏÒÔÙ, ÏÔÎÏÓÑÝÉÅÓÑ Ë ÄÏËÕÍÅÎÔÁÃÉÉ,
Ñ×ÌÑÀÔÓÑ ÓÁÍÙÍÉ ÐÏÓÌÅÄÎÉÍÉ. åÓÌÉ ÓÏÍÎÅ×ÁÅÔÅÓØ, ÔÏ ÕÄÁÌÉÔÅ ÓÔÁÒÙÅ ÐÏÒÔÙ
ËÏÍÁÎÄÏÊ &man.pkg.delete.1; ÐÅÒÅÄ ÔÅÍ, ËÁË ÕÓÔÁÎÁ×ÌÉ×ÁÔØ ÐÏÒÔ. ë
ÐÒÉÍÅÒÕ, ÎÁ ÄÁÎÎÙÊ ÍÏÍÅÎÔ ÍÙ ÚÁ×ÑÚÁÎÙ ÎÁ jade-1.2, Á ÅÓÌÉ Õ ×ÁÓ
ÕÓÔÁÎÏ×ÌÅÎ ÐÁËÅÔ jade-1.1, ÔÏ, ÐÏÖÁÌÕÊÓÔÁ, ×ÙÐÏÌÎÉÔÅ</para>
<screen>&prompt.root; <userinput>pkg_delete jade-1.1</userinput></screen>
</note>
<para>îÁÓÔÒÏÊÔÅ ÈÒÁÎÉÌÉÝÅ CVS. ÷ ÄÅÒÅ×Å CVS ×ÁÍ ÎÕÖÎÙ ËÁÔÁÌÏÇÉ www, doc É
ports (ÐÌÀÓ, ËÏÎÅÞÎÏ ÖÅ, CVSROOT). ðÏÖÁÌÕÊÓÔÁ, ÐÒÏÞÔÉÔÅ ××ÅÄÅÎÉÅ ×
CVSup ÐÏ ÁÄÒÅÓÕ <ulink url="&url.books.handbook;/synching.html#CVSUP">
÷×ÅÄÅÎÉÅ × CVSup</ulink> Ï ÔÏÍ, ËÁË
ÐÏÌÕÞÁÔØ ÚÅÒËÁÌØÎÕÀ ËÏÐÉÀ ÄÅÒÅ×Á CVS ÉÌÉ ÅÇÏ ÞÁÓÔÅÊ.</para>
<para>äÏÓÔÁÔÏÞÎÏ ÉÍÅÔØ ÓÌÅÄÕÀÝÉÅ ÎÁÂÏÒÙ cvsup: <literal>www</literal>,
<literal>doc-all</literal>, <literal>cvs-base</literal> É
<literal>ports-base</literal>.</para>
<para>üÔÉ ÎÁÂÏÒÙ ÔÒÅÂÕÀÔ ÏËÏÌÏ 105 íÂÁÊÔ Ó×ÏÂÏÄÎÏÇÏ ÄÉÓËÏ×ÏÇÏ
ÐÒÏÓÔÒÁÎÓÔ×Á.</para>
<para>ðÏÌÎÏÅ ÄÅÒÅ×Ï CVS, ×ËÌÀÞÁÑ <literal>src</literal>,
<literal>doc</literal>, <literal>www</literal> É
<literal>ports</literal> × ÎÁÓÔÏÑÝÅÅ ×ÒÅÍÑ ÚÁÎÉÍÁÅÔ ÏËÏÌÏ 940
íÂÁÊÔ.</para>
</sect1>
<sect1 id="the-website-build">
<title>ðÏÓÔÒÏÅÎÉÅ Web-ÓÔÒÁÎÉÃ Ó ÎÕÌÑ</title>
<procedure>
<step>
<para>óÏÚÄÁÊÔÅ ËÁÔÁÌÏÇ ÄÌÑ ÐÏÓÔÒÏÅÎÉÑ Ó ÏÂߣÍÏÍ Ó×ÏÂÏÄÎÏÇÏ ÐÒÏÓÔÒÁÎÓÔ×Á
ÎÅ ÍÅÎÅÅ 60 íÂÁÊÔ É ÐÅÒÅÊÄÉÔÅ × ÎÅÇÏ.</para>
<screen>&prompt.root; <userinput>mkdir /var/tmp/webbuild</userinput>
&prompt.root; <userinput>cd /var/tmp/webbuild</userinput></screen>
</step>
<step>
<para>éÚ×ÌÅËÉÔÅ ÆÁÊÌÙ SGML ÉÚ ÄÅÒÅ×Á CVS.</para>
<screen>&prompt.root; <userinput>cvs -R co www doc</userinput></screen>
</step>
<step>
<para>ðÅÒÅÊÄÉÔÅ × ËÁÔÁÌÏÇ <filename class="directory">www/en</filename>
É ÚÁÐÕÓÔÉÔÅ ËÏÍÁÎÄÕ &man.make.1; <maketarget>all</maketarget> ÄÌÑ
ÓÏÚÄÁÎÉÑ Web-ÓÔÒÁÎÉÃ.</para>
<screen>&prompt.root; <userinput>cd en</userinput>
&prompt.root; <userinput>make all</userinput></screen>
</step>
</procedure>
</sect1>
<sect1 id="the-website-install">
<title>õÓÔÁÎÏ×ËÁ Web-ÓÔÒÁÎÉÃ × ×ÁÛ Web-ÓÅÒ×ÅÒ</title>
<procedure>
<step>
<para>åÓÌÉ ×Ù ×ÙÛÌÉ ÉÚ ËÁÔÁÌÏÇÁ <filename>en</filename>, ÔÏ ×ÅÒÎÉÔÅÓØ ×
ÎÅÇÏ.</para>
<screen>&prompt.root; <userinput>cd <replaceable>path</replaceable>/www/en</userinput></screen>
</step>
<step>
<para>úÁÐÕÓÔÉÔÅ ËÏÍÁÎÄÕ &man.make.1; <maketarget>install</maketarget>,
ÕÓÔÁÎÏ×É× ÐÅÒÅÍÅÎÎÕÀ <makevar>DESTDIR</makevar> × ÉÍÑ ËÁÔÁÌÏÇÁ, ×
ËÏÔÏÒÙÊ ×Ù ÈÏÔÉÔÅ ÕÓÔÁÎÏ×ÉÔØ ÆÁÊÌÙ.</para>
<screen>&prompt.root; <userinput>make DESTDIR=<replaceable>/usr/local/www</replaceable> install</userinput></screen>
</step>
<step>
<para>åÓÌÉ ÒÁÎÅÅ ×Ù ÕÓÔÁÎÁ×ÌÉ×ÁÌÉ Web-ÓÔÒÁÎÉÃÙ × ÔÏÔ ÖÅ ÓÁÍÙÊ ËÁÔÁÌÏÇ,
ÔÏ × ÐÒÏÃÅÓÓÅ ÕÓÔÁÎÏ×ËÉ ÎÅ ÂÕÄÕÔ ÕÄÁÌÅÎÙ ÎÉ ÏÄÎÁ ÉÚ ÓÔÁÒÙÈ ÉÌÉ
ÕÓÔÁÒÅ×ÛÉÈ ÓÔÒÁÎÉÃ. ë ÐÒÉÍÅÒÙ, ÅÓÌÉ ×Ù ÐÅÒÅÓÔÒÁÉ×ÁÅÔÅ É
ÕÓÔÁÎÁ×ÌÉ×ÁÅÔÅ ÎÏ×ÕÀ ËÏÐÉÀ ÓÁÊÔÁ ËÁÖÄÙÊ ÄÅÎØ, ÔÏ ÜÔÁ ËÏÍÁÎÄÁ ÎÁÊÄÅÔ É
ÕÄÁÌÉÔ ×ÓÅ ÆÁÊÌÙ, ËÏÔÏÒÙÅ ÎÅ ÂÙÌÉ ÏÂÎÏ×ÌÅÎÙ × ÔÅÞÅÎÉÅ ÔÒÅÈ
ÄÎÅÊ.</para>
<screen>&prompt.root; <userinput>find <replaceable>/usr/local/www</replaceable> -ctime 3 -print0 | xargs -0 rm</userinput></screen>
</step>
</procedure>
</sect1>
<sect1 id="the-website-env">
<title>ðÅÒÅÍÅÎÎÙÅ ÏËÒÕÖÅÎÉÑ</title>
<variablelist>
<varlistentry>
<term><envar>CVSROOT</envar></term>
<listitem>
<para>òÁÓÐÏÌÏÖÅÎÉÅ ÄÅÒÅ×Á CVS. îÕÖÎÁ.</para>
<screen><userinput>&prompt.root; CVSROOT=/home/ncvs; export CVSROOT</userinput></screen>
</listitem>
</varlistentry>
<varlistentry>
<term><makevar>ENGLISH_ONLY</makevar></term>
<listitem>
<para>åÓÌÉ ÏÎÁ ÕÓÔÁÎÏ×ÌÅÎÁ É ÎÅ ÐÕÓÔÁ, ÔÏ ÐÒÉ ×ÙÐÏÌÎÅÎÉÉ make-ÆÁÊÌÏ×
ÂÕÄÕÔ ÓÔÒÏÉÔØÓÑ É ÕÓÔÁÎÁ×ÌÉ×ÁÔØÓÑ ÄÏËÕÍÅÎÔÙ ÔÏÌØËÏ ÎÁ ÁÎÇÌÉÊÓËÏÍ
ÑÚÙËÅ. ÷ÓÅ ÐÅÒÅ×ÏÄÙ ÂÕÄÕÔ ÐÒÏÉÇÎÏÒÉÒÏ×ÁÎÙ. îÁÐÒÉÍÅÒ:</para>
<screen>&prompt.root; <userinput>make ENGLISH_ONLY=YES all install</userinput></screen>
<para>åÓÌÉ ×Ù ÈÏÔÉÔÅ ÓÎÑÔØ ÕÓÔÁÎÏ×ËÕ ÚÎÁÞÅÎÉÊ ÐÅÒÅÍÅÎÎÏÊ
<makevar>ENGLISH_ONLY</makevar> É ÐÏÓÔÒÏÉÔØ ×ÓÅ ÓÔÒÁÎÉÃÙ, ×ËÌÀÞÁÑ
ÐÅÒÅ×ÏÄÙ, ÔÏ ÚÁÄÁÊÔÅ ÐÅÒÅÍÅÎÎÏÊ <makevar>ENGLISH_ONLY</makevar>
ÐÕÓÔÏÅ ÚÎÁÞÅÎÉÅ</para>
<screen>&prompt.root; <userinput>make ENGLISH_ONLY="" all install clean</userinput></screen>
</listitem>
</varlistentry>
<varlistentry>
<term><makevar>WEB_ONLY</makevar></term>
<listitem>
<para>åÓÌÉ ÚÁÄÁÎÁ É ÎÅ ÐÕÓÔÁ, ÔÏ ÐÒÉ ×ÙÐÏÌÎÅÎÉÉ make-ÆÁÊÌÏ× ÂÕÄÕÔ
ÐÏÓÔÒÏÅÎÙ É ÕÓÔÁÎÏ×ÌÅÎÙ ÓÔÒÁÎÉÃÙ HTML ÔÏÌØËÏ ÉÚ ËÁÔÁÌÏÇÁ www. ÷ÓÅ
ÄÏËÕÍÅÎÔÙ ÉÚ ËÁÔÁÌÏÇÁ doc (òÕËÏ×ÏÄÓÔ×Ï, FAQ, õÞÅÂÎÉËÉ) ÂÕÄÕÔ
ÐÒÏÉÇÎÏÒÉÒÏ×ÁÎÙ. ë ÐÒÉÍÅÒÕ:</para>
<screen>&prompt.root; <userinput>make WEB_ONLY=YES all install</userinput></screen>
</listitem>
</varlistentry>
<varlistentry>
<term><makevar>NOPORTSCVS</makevar></term>
<listitem>
<para>åÓÌÉ ÚÁÄÁÎÁ, ÔÏ ÐÒÉ ×ÙÐÏÌÎÅÎÉÉ make-ÆÁÊÌÏ× ÆÁÊÌÙ ÐÏÒÔÏ× ÉÚ
ÈÒÁÎÉÌÉÝÁ cvs ÉÚ×ÌÅËÁÔØÓÑ ÎÅ ÂÕÄÕÔ. ÷ÍÅÓÔÏ ÜÔÏÇÏ ÂÕÄÕÔ ÓËÏÐÉÒÏ×ÁÎÙ
ÆÁÊÌÙ ÉÚ <filename>/usr/ports</filename> (ÉÌÉ ÉÚ ËÁÔÁÌÏÇÁ, ÎÁ
ËÏÔÏÒÙÊ ÕËÁÚÙ×ÁÅÔ ÐÅÒÅÍÅÎÎÁÑ <envar>PORTSBASE</envar>).</para>
</listitem>
</varlistentry>
</variablelist>
<para><envar>CVSROOT</envar> Ñ×ÌÑÅÔÓÑ ÐÅÒÅÍÅÎÎÏÊ ÏËÒÕÖÅÎÉÑ. ÷Ù ÄÏÌÖÎÙ
ÚÁÄÁÔØ Å£ × ËÏÍÁÎÄÎÏÊ ÓÔÒÏËÅ ÉÌÉ × ×ÁÛÉÈ ÎÁÓÔÒÏÅÞÎÙÈ ÆÁÊÌÁÈ (ÎÁÐÒÉÍÅÒ,
~/.profile).</para>
<para><makevar>WEB_ONLY</makevar>, <makevar>ENGLISH_ONLY</makevar> É
<makevar>NOPORTSCVS</makevar> Ñ×ÌÑÀÔÓÑ ÐÅÒÅÍÅÎÎÙÍÉ make-ÆÁÊÌÏ×. ÷Ù
ÍÏÖÅÔÅ ÚÁÄÁÔØ ÉÈ × ÆÁÊÌÁÈ <filename>/etc/make.conf</filename> É
<filename>Makefile.inc</filename>, ÒÁÂÏÔÁÔØ Ó ÎÉÍÉ ËÁË Ó ÐÅÒÅÍÅÎÎÙÍÉ
ÏËÒÕÖÅÎÉÑ × ËÏÍÁÎÄÎÏÊ ÓÔÒÏËÅ ÉÌÉ ÆÁÊÌÁÈ ËÏÍÁÎÄÎÏÇÏ ÐÒÏÃÅÓÓÏÒÁ.</para>
</sect1>
</chapter>