diff --git a/ru_RU.KOI8-R/books/fdp-primer/writing-style/chapter.sgml b/ru_RU.KOI8-R/books/fdp-primer/writing-style/chapter.sgml new file mode 100644 index 0000000000..d2453ad864 --- /dev/null +++ b/ru_RU.KOI8-R/books/fdp-primer/writing-style/chapter.sgml @@ -0,0 +1,497 @@ +<!-- + The FreeBSD Russian Documentation Project + + $FreeBSD$ + $FreeBSDru: frdp/doc/ru_RU.KOI8-R/books/fdp-primer/writing-style/chapter.sgml,v 1.7 2005/06/14 13:02:03 andy Exp $ + + Original revision: 1.46 +--> + +<!-- Copyright (c) 1998 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="writing-style"> + <title>����� ���������</title> + + <para>��� ����, ����� �������� �������� ����� ���������� ������� ������������ + FreeBSD, ��� ��� ���� �������� ��������� ����������� ��������, ������� ��� + ������ ���������.</para> + + <variablelist> + <varlistentry> + <term>����������� ������������ ������� ����������� �����</term> + + <listitem> + <para>���������� ��������� ��������� ����������� �����, � + ������������� ���������� ������ ���������� ����. � ������, + ���� ��������� ���������� - ����������� ������������ �������. + <quote>color</quote>, � �� <quote>colour</quote>, + <quote>rationalize</quote>, � �� <quote>rationalise</quote>, � ��� + �����.</para> + + <note> + <para>������������� ����������� ����������� ����� ���� ������� ��� + �������������� ������, �� ��������� ������ ���� ���������� �� �ӣ� + ���������. ������ ���������, ����� ��� �����, �������� Web-�����, + ���������� �������� � ��� �����, ������ ������������ ������������ + ����������.</para> + </note> + </listitem> + </varlistentry> + + <varlistentry> + <term>�� ����������� ����������</term> + + <listitem> + <para>�� ����������� ������� ���� � ���������� ������. ������ ������ + ����� ���������. ����� ����������� �������� <quote>Don't use + contractions</quote>.</para> + + <para>��������� ������� ���� ��������� ����������� ����� ���������� + ���, ����� ����� ����� � �� ������� ����� ��������� �� ������ + ����.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>����������� ��������� �������</term> + + <listitem> + <para>� ������ �������� ������ ��������� ��������� ������ ����� �� + ������� ��� ������ �������. � ���������� ������ ��������� ��������� + ����� �� ������ ��� ������ ������� � ����� <quote>and</quote>.</para> + + <para>� �������, ���������� ���������:</para> + + <blockquote> + <para>This is a list of one, two and three items.</para> + </blockquote> + + <para>��� ������ �� ���� �������� <quote>one</quote>, + <quote>two</quote> � <quote>three</quote>, ��� ������ �� ���� ������� + <quote>one</quote> � <quote>two and three</quote>?</para> + + <para>����� ���� ������ � �������� �������:</para> + + <blockquote> + <para>This is a list of one, two, and three items.</para> + </blockquote> + </listitem> + </varlistentry> + + <varlistentry> + <term>��������� ������ ����</term> + + <listitem> + <para>����������� �� ������������ �������� ����. � ���������, + <quote>the command</quote>, <quote>the file</quote> � <quote>man + command</quote>, ��������, �������.</para> + + <para>��� ��� ������� ���������� ��� ��� ������. ������ ������� + ��������������.</para> + + <informalexample> + <para>Use the command <command>cvsup</command> to update your + sources</para> + </informalexample> + + <informalexample> + <para>Use <command>cvsup</command> to update your sources</para> + </informalexample> + + <para>��� ��� ������� ���������� ��� ��� ���� ������. �������������� + ������ �������.</para> + + <informalexample> + <para>… in the filename + <filename>/etc/rc.local</filename>…</para> + </informalexample> + + <informalexample> + <para>… in + <filename>/etc/rc.local</filename>…</para> + </informalexample> + + <para>��� ��� ������� ���������� ��� ��� ������ �� ���������� �������. + �������������� ������ ������� (������ ������� ���������� + <sgmltag>citerefentry</sgmltag>).</para> + + <informalexample> + <para>See <command>man csh</command> for more + information.</para> + </informalexample> + + <informalexample> + <para>See &man.csh.1;</para> + </informalexample> + </listitem> + </varlistentry> + + <varlistentry> + <term>��� ������� � ����� �����������</term> + + <listitem> + <para>������ ����������� ��� ������� � ����� �����������, ��� ��� ��� + ��������� �������������, � ��������� ������������� ����� + ������������, ��� <application>Emacs</application>.</para> + + <para>���� ����� ���� ����������, ��� ��������� �����, ������� ������� + �� ������, ���������� ����� �����������, ��� �� ��� ������, �������� + ��� ������������� ����. <quote>Jordan K. Hubbard</quote> �������� + ������� ��������; � ���� ����� ���� ��������� <literal>H</literal>, + ������� ������� �� ������ � ��������, �� ��� �� ����� + �����������.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>����� ��������� ���������� � ����� ��������� ����� ����� � ������ + ������� ������� <ulink url="http://www.bartleby.com/141/">Elements of + Style</ulink>.</para> + + <sect1 id="writing-style-guide"> + <title>����������� �� �����</title> + + <para>��� ����, ����� �������� ����� ����������� ��� �������� � ����� + �����, ����� ����� ������ ����� ��� �����������, ����������, �������� + ��������� ����������� � �����.</para> + + <sect2> + <title>������� ����</title> + + <para>����� �������� � ������ ��������, <literal><para></literal>, + � <emphasis>��</emphasis> <literal><PARA></literal>.</para> + + <para>�����, ������� �������� � ��������� SGML, ������ ������� � ������� + ��������, <literal><!ENTITY…></literal> � + <literal><!DOCTYPE…></literal>, �� <emphasis>��</emphasis> + <literal><!entity…></literal> � + <literal><!doctype…></literal>.</para> + </sect2> + + <sect2> + <title>��������</title> + + <para>�������� ������ ������ ���������������� ��� ������ ��������� + � �����, ��������: "Network Time Protocol (<acronym + role="Network Time Protocol">NTP</acronym>)." ����� + ����������� ��������, ������ ������������ ������ ��, + (� �� ������ �������, ���� ������ � ������ ������ + ������������� ������� ������� �� ����������������). ������ + �������� ������������ ������ ���� ��� �� ���� �����. �� + ���� �������, �� ������ ���������� �� � ������ �����.</para> + + <para>������ ��� ���� ������� ������ ���������� ������ ����� + <acronym>, � ��������� <literal>role</literal>, + ��� ��������� ������ ������. ��� ��������� ��������� ������ + �� ���������, � �������� ������ �������� ��� ��������� �� + ������ ������� ����.</para> + </sect2> + + <sect2> + <title>�������</title> + + <para>������ ���� ���������� � ������� � ������� 0, + <emphasis>����������</emphasis> �� ������� �����, ������� ����� + �������� ���� ����.</para> + + <para>����������� ����� ����������� ������ �� 2 �������. ����������� + ����� � ���� ������� ��������� ������ �� 2 �������. ��������� ��������� + ������� ��������� ���������, ��������� ��� ��������. �� ����������� + ������� ����� ��������� ���������, � �� ���������� �������������� + �������� � ����� ������. ���������� ��������� ������ ����� ������ � + ��� �������, ���� ���������� ��������� �� ������� ���� ������.</para> + + <para>��������, �������� ��� ����� ������� �������� �������� ���:</para> + + <programlisting><![ CDATA [+--- This is column 0 +V +<chapter> + <title>...</title> + + <sect1> + <title>...</title> + + <sect2> + <title>�������</title> + + <para>������ ���� ���������� � ������� � ������� 0, + <emphasis>����������</emphasis> �� ������� �����, ������� ����� + �������� ���� ����.</para> + + <para>������ ����������� ����� ����������� ������ �� 2 �������, � ������ + ����������� ����� ��������� ��� �� 2 �������. ��������� ��������� + ������� ��������� ���������, ��������� ��� ��������. �� ����������� + ������� ����� ��������� ���������, � �� ���������� �������������� + �������� � ����� ������. ���������� ��������� ������ ����� ������ � + ��� �������, ���� ���������� ��������� �� ������� ���� ������.</para> + + ... + </sect2> + </sect1> +</chapter>]]></programlisting> + + <para>���� ��� �������������� ������ �� ����������� + <application>Emacs</application> ��� <application>XEmacs</application>, + �� ������ ���� ������������� �������� <literal>sgml-mode</literal>, � + ��������� ���������� <application>Emacs</application> � ����� + ������� ����� ������ ��������� �������� ��� �����.</para> + + <para>������������ <application>Vim</application> ����� ������������ + ��������� ������� ��� ������������: + + <programlisting>augroup sgmledit + autocmd FileType sgml set formatoptions=cq2l " Special formatting options + autocmd FileType sgml set textwidth=70 " Wrap lines at 70 columns + autocmd FileType sgml set shiftwidth=2 " Automatically indent + autocmd FileType sgml set softtabstop=2 " Tab key indents 2 spaces + autocmd FileType sgml set tabstop=8 " Replace 8 spaces with a tab + autocmd FileType sgml set autoindent " Automatic indentation +augroup END</programlisting> + + </sect2> + + <sect2> + <title>����� �����</title> + + <sect3> + <title>��������� �����</title> + + <para>�����, ������� ��������� �� ��� �� ������, ��� � ���������� + �����, ������ ���������� ������ �������, � ��, ��� �� ��������� �� + ��� �� ����� �������, ��� � ���������� �����, �� ������:</para> + + <informalexample> + <programlisting><![ CDATA [<article> + <articleinfo> + <title>NIS</title> + + <pubdate>������� 1999</pubdate> + + <abstract> + <para>... + ... + ...</para> + </abstract> + </articleinfo> + + <sect1> + <title>...</title> + + <para>...</para> + </sect1> + + <sect1> + <title>...</title> + + <para>...</para> + </sect1> +</article>]]></programlisting> + </informalexample> + </sect3> + + <sect3> + <title>��������� �����</title> + + <para>����� �����, ��� <sgmltag>itemizedlist</sgmltag>, ������� ������ + ����� ����� ����� ������ ���, � �� ����� ���� ���� � ���� ��������� + ������ �� ��������, ������ ������������� �� ����� ������.</para> + + <para>����� ������, ��� <sgmltag>para</sgmltag> � + <sgmltag>term</sgmltag>, �� ����� ������ ����� ��� ������� ���������� + ������, � �� ���������� ���������� ����� �� ����� �����, <emphasis>�� + ��� �� ����� ������</emphasis>.</para> + + <para>�� �� ����� ��������� � �������� ���� ���� ����� �����.</para> + + <para>��� �������� � ��������� �������� ��� ���������� ���� + �����.</para> + + <para>� ������, ����� ��������� �����, ������� �� ����� ��������� + ���������� ������, ��������������� ������� �� ������ ����, ���������� + ������ ����� ������ ��� ��� ������������� ���������� ������, ��� + ������������� �� ��������� �������. ������ ����� ������ ���� + ��������� � ��������.</para> + + <para>����� �����, ������� ����� ��������� ���������� ������, + ����������� ����� ����� ����������� �����, ������� �� ����� ��������� + ���������� ������, �� ��� ������������� �� ����� � ��� �� + ������.</para> + </sect3> + </sect2> + + <sect2> + <title>���������, ������������� ������ ���������� ��������</title> + + <para>��� ������� ��������� <emphasis>�� ������� ��������� � ���������� + ������������ � ����������� � ��������������</emphasis>.</para> + + <para>��� �����, ������ ��� �������, ������� ��������� ����������� �� + ������ �����, ����� ������ �������, ��� ���������� ���������� � ����� + �������� ��� �������� ��� ���, ���������� �� ������ ��-�� ���������� + ��� ��-�� ������� ������������ ��������.</para> + + <para>� �������, ���� �� �������� ��� ����������� � �����, � ��� ���� + ����� ����� � ������ ������ ��������� 80 ��������, ������� ��������� + ������ ����� ��������� � �������� ��������. ����� �������� ������� + ����� � ����������� ������ ���������. � ���������, ����������� ������ + �� ������� ���������, ����������� �������, ��� ��� �������������� + ���������, � ��� ������� ������������ ����� ��� ������������.</para> + </sect2> + + <sect2> + <title>������������� �������</title> + + <para>���������� �������� ��������� ����� ���, ��� ��� ����� ��������� + ��������� ��� ������ ��������� ������������ ������ �����. �������� + ����� ������� �� ������ ���������� ������� ������. � ���������, + ������ HTML ������������ � ��������� ���������� ����� �������� � + ��������� ����� ���������������� �������, ��� ��������:</para> + + <literallayout class="monospaced">Data capacity ranges from 40 MB to 15GB. Hardware compression …</literallayout> + + <para>����� �������� <literal>&nbsp;</literal> ��������� ������� + ������ ����� ������� ������������ ���� � �����. ����������� + ����������� ������� � �������� �������:</para> + + <itemizedlist> + <listitem> + <para>����� ������� � ����������:</para> + <programlisting><![ CDATA [57600 bps]]></programlisting> + </listitem> + + <listitem> + <para>����� ��������� ��������� � ������� ������:</para> + <programlisting><![ CDATA [FreeBSD 4.7]]></programlisting> + </listitem> + + <listitem> + <para>����� ������������� ���������� (����������� ���������, ����� + ���������� ��� ������� � ������ ���������� 3-4 � ����� ����. + ��������: <quote>The FreeBSD Brazilian + Portuguese Documentation Project</quote>):</para> + <programlisting><![ CDATA [Sun Microsystems]]></programlisting> + </listitem> + </itemizedlist> + + </sect2> + </sect1> + + <sect1 id="writing-style-word-list"> + <title>�������</title> + + <para>����� ������� ������� ������ ����, ��������� ������� ���� � ����, + ������� ������ �������������� � ������� ���������������� FreeBSD. ���� + � ���� ������ ��� �����, ������� �� �����, �� ���������� � <ulink + url="http://www.oreilly.com/oreilly/author/stylesheet.html">������� + O'Reilly</ulink>.</para> + + <itemizedlist> + <listitem> + <para>2.2.X</para> + </listitem> + + <listitem> + <para>4.X-STABLE</para> + </listitem> + + <listitem> + <para>CD-ROM</para> + </listitem> + + <listitem> + <para>DoS <emphasis>(Denial of Service)</emphasis> </para> + </listitem> + + <listitem> + <para>Ports Collection</para> + </listitem> + + <listitem> + <para>IPsec</para> + </listitem> + + <listitem> + <para>Internet</para> + </listitem> + + <listitem> + <para>MHz</para> + </listitem> + + <listitem> + <para>Soft Updates</para> + </listitem> + + <listitem> + <para>Unix</para> + </listitem> + + <listitem> + <para>disk label</para> + </listitem> + + <listitem> + <para>email</para> + </listitem> + + <listitem> + <para>file system</para> + </listitem> + + <listitem> + <para>manual page</para> + </listitem> + + <listitem> + <para>mail server</para> + </listitem> + + <listitem> + <para>name server</para> + </listitem> + + <listitem> + <para>web server</para> + </listitem> + </itemizedlist> + </sect1> +</chapter> + +<!-- + Local Variables: + mode: sgml + sgml-declaration: "../chapter.decl" + sgml-indent-data: t + sgml-omittag: nil + sgml-always-quote-attributes: t + sgml-parent-document: ("../book.sgml" "part" "chapter") + End: +-->