diff options
Diffstat (limited to 'documentation/content/ru/books/fdp-primer/preface/_index.adoc')
-rw-r--r-- | documentation/content/ru/books/fdp-primer/preface/_index.adoc | 155 |
1 files changed, 155 insertions, 0 deletions
diff --git a/documentation/content/ru/books/fdp-primer/preface/_index.adoc b/documentation/content/ru/books/fdp-primer/preface/_index.adoc new file mode 100644 index 0000000000..6cc88df8af --- /dev/null +++ b/documentation/content/ru/books/fdp-primer/preface/_index.adoc @@ -0,0 +1,155 @@ +--- +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]] +== Благодарности + +Моя благодарность Сью Блейк, Патрику Дурусо, Джону Гамильтону, Питеру Флинну и Кристоферу Мэдену, которые нашли время прочитать ранние черновики этого документа и предоставили множество ценных замечаний и критики. |