<!--
     The FreeBSD Russian Documentation Project

     $FreeBSD$
     $FreeBSDru: frdp/doc/ru_RU.KOI8-R/books/fdp-primer/book.sgml,v 1.9 2005/05/04 18:23:39 andy Exp $

     Original revision: 1.27
-->

<!-- 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.
-->

<!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [

<!ENTITY % books.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Books Entity Set//EN">
%books.ent;
<!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
<!ENTITY % not.published "INCLUDE">
<!-- ENTITY index SYSTEM "index.sgml" -->
]>

<book lang="ru">
  <bookinfo>
    <title>Учебник по Проекту Документирования FreeBSD для новых
      участников</title>

    <corpauthor>The FreeBSD Documentation Project</corpauthor>

    <copyright>
      <year>1998</year>
      <year>1999</year>
      <year>2000</year>
      <year>2001</year>
      <year>2002</year>
      <year>2003</year>
      <year>2004</year>
      <year>2005</year>
      <holder role="mailto:doceng@FreeBSD.org">DocEng</holder>
    </copyright>

    <pubdate role="rcs">$FreeBSD$</pubdate>

    <releaseinfo>$FreeBSD$</releaseinfo>

    &bookinfo.legalnotice;

    <abstract>
      <para>Благодарим вас за то, что вы стали частью Проекта Документирования
	FreeBSD.  Ваше участие чрезвычайно нужно.</para>

      <para>Этот учебник описывает все, что вам нужно знать для того, чтобы
	принять участие в Проекте Документирования FreeBSD, от инструментов
	и программного обеспечения, которое вы будете использовать (как
	обязательное, так и рекомендуемое), до философии Проекта
	Документирования.</para>

      <para>Этот документ все время подвергается изменениям, и не полон.
	Еще не законченные разделы помечены знаком <literal>*</literal> в
	названии.</para>
    </abstract>
  </bookinfo>

  <preface id="preface">
    <title>Используемые сокращения</title>

    <sect1 id="preface-prompts">
      <title>Приглашения командных процессоров</title>

      <para>В следующей таблице показано системное приглашение по умолчанию и
	приглашение администратора.  В примерах такое будет использоваться для
	обозначения того, каким пользователем должен выполняться пример.</para>

      <informaltable frame="none" pgwide="1">
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>Пользователь</entry>
	      <entry>Приглашение</entry>
	    </row>
	  </thead>
	
	  <tbody>
	    <row>
	      <entry>Обычный пользователь</entry>
	      <entry>&prompt.user;</entry>
	    </row>

	    <row>
	      <entry><username>root</username></entry>
	      <entry>&prompt.root;</entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </sect1>

    <sect1 id="preface-conventions">
      <title>Типографские соглашения</title>

      <para>В следующей таблице описаны типографские соглашения, используемые
	в этой книге.</para>

      <informaltable frame="none" pgwide="1">
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>Значение</entry>
	      <entry>Примеры</entry>
	    </row>
	  </thead>
	
	  <tbody>
	    <row>
	      <entry>Названия команд, имена файлов и каталогов.  Выдача на
	        экран.</entry>

	      <entry><para>Отредактируйте ваш
		файл <filename>.login</filename>.</para><para>Используйте
		команду <command>ls -a</command> для выдачи списка всех файлов.
		</para><para><screen>You have mail.</screen></para></entry>
	    </row>

	    <row>
	      <entry>То, что набираете вы, когда это отличается от экранной
	        выдачи компьютером.</entry>

	      <entry><screen>&prompt.user; <userinput>su</userinput>
Password:</screen></entry>
	    </row>

	    <row>
	      <entry>Ссылки на страницы справочной системы.</entry>

	      <entry>Воспользуйтесь командой <citerefentry>
		  <refentrytitle>su</refentrytitle>
		  <manvolnum>1</manvolnum>
		</citerefentry> для смены имени пользователя.</entry>
	    </row>

	    <row>
	      <entry>Имена пользователей и групп</entry>

	      <entry>Только <username>root</username> может это делать.</entry>
	    </row>

	    <row>
	      <entry>Выделение</entry>

	      <entry>Вы <emphasis>должны</emphasis> это сделать.</entry>
	    </row>

	    <row>
	      <entry>Переменные параметры командной строки; заменяйте их
	        реальными названиями или значениями.</entry>

	      <entry>Для удаления файла наберите <command>rm
	        <filename><replaceable>filename</replaceable></filename></command></entry>
	    </row>

	    <row>
	      <entry>Переменные окружения</entry>

	      <entry><envar>$HOME</envar> является вашим домашним
	        каталогом.</entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </sect1>

    <sect1 id="preface-notes">
      <title>Замечания, советы, важная информация, предупреждения и
	примеры</title>

      <para>Внутри текста встречаются замечания, предупреждения и
	примеры.</para>

      <note>
	<para>Замечания имеют такой вид, и содержат информацию, которую вы
	  должны принять к сведению, так как она может затронуть ваши
	  действия.</para>
      </note>

      <tip>
	<para>Советы имеют такой вид, и содержат информацию, которая может
	  оказаться полезной для вас, или предлагают более простой способ
	  сделать что-либо.</para>
      </tip>

      <important>
	<para>Важная информация имеет такой вид.  Обычно здесь обращается
	  внимание на дополнительные действия, которые вам может потребоваться
	  выполнить.</para>
      </important>

      <warning>
	<para>Предупреждения имеют примерно такой вид и содержат информацию,
	  в которой вы предупреждаетесь о возможных последствиях того, что вы
	  не будете следовать инструкциям.  Эти опасности могут быть как
	  физическими, связанными с вами или оборудованием, так и не
	  физическими, такими, как безусловное удаление важных файлов.</para>
      </warning>

      <example>
	<title>Пример</title>

	<para>Примеры имеют такой вид и обычно содержат примеры, которым вы
	  должны следовать, или показывают результаты, которые должны
	  получиться при выполнении некоторых действий.</para>
      </example>
    </sect1>

    <sect1 id="preface-acknowledgements">
      <title>Благодарности</title>

      <para>Я благодарю Sue Blake, Patrick Durusau, Jon Hamilton, Peter
	Flynn и Christopher Maden, которые выбрали время для чтения ранних
	черновиков этого документа и дали много ценных замечаний и
	критики.</para>
    </sect1>
  </preface>

  &chap.overview;
  &chap.tools;
  &chap.sgml-primer;
  &chap.sgml-markup;
  &chap.stylesheets;
  &chap.structure;
  &chap.doc-build;
  &chap.the-website;
  &chap.translations;
  &chap.writing-style;
  &chap.psgml-mode;
  &chap.see-also;

  &app.examples;

<!--
  &index;
-->
</book>

<!--
     Local Variables:
     mode: sgml
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     End:
-->
