---
description: 'Предисловие о проекте документации FreeBSD'
next: books/fdp-primer/overview
params:
  path: /books/fdp-primer/preface/
prev: books/fdp-primer
showBookMenu: true
tags: ["preface", "prompts", "conventions"]
title: Предисловие
weight: 1
---

[preface]
[[preface]]
= Предисловие
:doctype: book
:toc: macro
:toclevels: 1
:icons: font
:source-highlighter: rouge
:experimental:
:images-path: books/fdp-primer/

ifdef::env-beastie[]
ifdef::backend-html5[]
:imagesdir: ../../../../images/{images-path}
endif::[]
ifndef::book[]
include::shared/authors.adoc[]
include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
include::shared/attributes/attributes-{{% lang %}}.adoc[]
include::shared/{{% lang %}}/teams.adoc[]
include::shared/{{% lang %}}/mailing-lists.adoc[]
include::shared/{{% lang %}}/urls.adoc[]
toc::[]
endif::[]
ifdef::backend-pdf,backend-epub3[]
include::../../../../../shared/asciidoctor.adoc[]
endif::[]
endif::[]

ifndef::env-beastie[]
toc::[]
include::../../../../../shared/asciidoctor.adoc[]
endif::[]

[[preface-prompts]]
== Приглашения командной оболочки

В этой таблице показаны приглашения системы по умолчанию и приглашение суперпользователя. В примерах используются эти приглашения, чтобы указать, от какого типа пользователя выполняется пример.

[.informaltable]
[cols="1,2", frame="none", options="header"]
|===
| Пользователь
| Приглашение


|Обычный пользователь
|%

|`root`
|# 
|===

[[preface-conventions]]
== Типографические соглашения

Эта таблица описывает типографские соглашения, используемые в этой книге.

[.informaltable]
[cols="1,2", frame="none", options="header"]
|===
| Значение
| Примеры


|Имена команд.
|Используйте `ls -l` для вывода списка всех файлов.

|Имена файлов.
|Измените файл [.filename]#.login#.

|Вывод компьютера на экран.
a| 

[source,shell]
....
У вас есть почта.
....


|Что вводит пользователь, в отличие от выводимого компьютером на экран.
a| 

[source,shell]
....
% date +"Время: %H:%M"
Время: 09:18
....

|Ссылки на руководства.
|Используйте man:su[1] для смены пользователя.

|Имена пользователей и групп.
|Только `root` может это сделать.

|Выделение текста.
|Пользователь _обязан_ сделать это.

|Текст, который пользователь должен заменить на фактический текст.
|Для поиска ключевого слова в руководствах введите `man -k _ключевое_слово_`

|Переменные окружения.
|`$HOME` устанавливается в домашний каталог пользователя.
|===

[[preface-notes]]
== Примечания, Советы, Важная информация, Предупреждения и Примеры

Заметки, предупреждения и примеры выделены в тексте.

[NOTE]
====
Заметки представлены следующим образом и содержат информацию, на которую следует обратить внимание, так как она может повлиять на действия пользователя.
====

[TIP]
====

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

[IMPORTANT]
====
Важная информация представлена таким образом. Обычно это дополнительные шаги, которые может потребоваться выполнить пользователю.
====

[WARNING]
====

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

.Пример примера
[example]
====
Примеры представлены следующим образом и обычно содержат пошаговые инструкции или результаты выполнения определённых действий.
====

[[preface-acknowledgements]]
== Благодарности

Моя благодарность Сью Блейк, Патрику Дурусо, Джону Гамильтону, Питеру Флинну и Кристоферу Мэдену, которые нашли время прочитать ранние черновики этого документа и предоставили множество ценных замечаний и критики.