2022-05-14 22:51:14 +03:00
|
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
|
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
|
|
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
|
|
|
|
%general-entities;
|
|
|
|
|
]>
|
|
|
|
|
|
|
|
|
|
<sect1 id="pre-typography">
|
|
|
|
|
<?dbhtml filename="typography.html"?>
|
|
|
|
|
|
|
|
|
|
<title>Оформление</title>
|
|
|
|
|
|
|
|
|
|
<para>Чтобы облегчить понимание, в этой книге используются условные
|
2023-08-02 23:14:31 +03:00
|
|
|
|
обозначения. Этот раздел содержит примеры оформления, используемые в Linux From
|
|
|
|
|
Scratch.</para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
|
|
|
|
<screen role="nodump"><userinput>./configure --prefix=/usr</userinput></screen>
|
|
|
|
|
|
2023-06-11 01:06:41 +03:00
|
|
|
|
<para>Такое оформление предназначено для ввода именно так, как показано, если
|
2022-05-14 22:51:14 +03:00
|
|
|
|
иное не сказано в тексте рядом. Это оформление также используется в разделах
|
|
|
|
|
пояснений, чтобы указать, на какую команду ссылается.</para>
|
|
|
|
|
|
2022-05-21 23:04:03 +03:00
|
|
|
|
<para>В некоторых случаях логическая строка расширяется до двух или более физических
|
|
|
|
|
строк с обратной косой чертой в конце строки.</para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
|
|
|
|
<screen role="nodump"><userinput>CC="gcc -B/usr/bin/" ../binutils-2.18/configure \
|
|
|
|
|
--prefix=/tools --disable-nls --disable-werror</userinput></screen>
|
|
|
|
|
|
2022-05-21 23:04:03 +03:00
|
|
|
|
<para>Обратите внимание, что за обратной косой чертой должен следовать перевод строки.
|
|
|
|
|
Другие символы, такие как пробелы или символы табуляции, приведут к неправильным результатам.</para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
|
|
|
|
<screen><computeroutput>install-info: unknown option '--dir-file=/mnt/lfs/usr/info/dir'</computeroutput></screen>
|
|
|
|
|
|
2023-06-11 01:06:41 +03:00
|
|
|
|
<para>Такое оформление (текст фиксированной ширины) показывает вывод на экран, как правило, в
|
2023-08-02 23:14:31 +03:00
|
|
|
|
результате выполнения команд. Этот формат также используется для отображения имен файлов,
|
|
|
|
|
таких как <filename>/etc/ld.so.conf</filename>.</para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
2022-08-12 00:08:15 +03:00
|
|
|
|
<note>
|
|
|
|
|
<para>Пожалуйста, настройте свой браузер для отображения текста фиксированной ширины
|
|
|
|
|
с хорошим моноширинным шрифтом, с помощью которого вы сможете четко различать символы
|
|
|
|
|
<literal>Il1</literal> или <literal>O0</literal>.</para>
|
|
|
|
|
</note>
|
|
|
|
|
|
2022-05-14 22:51:14 +03:00
|
|
|
|
<para><emphasis>Акцент</emphasis></para>
|
|
|
|
|
|
2022-05-21 23:04:03 +03:00
|
|
|
|
<para>Эта форма текста используется в книге для нескольких целей. Его основная
|
|
|
|
|
цель — подчеркнуть важные моменты.</para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
|
|
|
|
<para><ulink url="&lfs-root;"/></para>
|
|
|
|
|
|
2023-09-08 15:58:53 +03:00
|
|
|
|
<para>Этот формат используется для гиперссылок как на сайт сообщества LFS, так и
|
2022-05-21 23:04:03 +03:00
|
|
|
|
на внешние ресурсы. Может включать справочную информацию, места загрузки и веб-сайты.</para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
|
|
|
|
<screen role="nodump"><userinput>cat > $LFS/etc/group << "EOF"
|
|
|
|
|
<literal>root:x:0:
|
|
|
|
|
bin:x:1:
|
|
|
|
|
......</literal>
|
|
|
|
|
EOF</userinput></screen>
|
|
|
|
|
|
2022-05-21 23:04:03 +03:00
|
|
|
|
<para>Этот формат используется при создании файлов конфигурации. Первая команда
|
|
|
|
|
указывает системе создать файл <filename>$LFS/etc/group</filename> из всего, что
|
|
|
|
|
введено далее, пока не встретится последовательность End Of File (EOF). Поэтому
|
|
|
|
|
весь этот раздел обычно печатается как есть.</para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
2023-06-11 01:06:41 +03:00
|
|
|
|
<para><replaceable><ЗАМЕНЯЕМЫЙ ТЕКСТ></replaceable></para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
2022-05-21 23:04:03 +03:00
|
|
|
|
<para>Этот формат используется для текста, который не должен быть напечатан так,
|
2023-06-11 01:06:41 +03:00
|
|
|
|
как отображается, или для операций копирования и вставки.</para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
|
|
|
|
<para><replaceable>[НЕОБЯЗАТЕЛЬНЫЙ ТЕКСТ]</replaceable></para>
|
|
|
|
|
|
|
|
|
|
<para>Этот формат используется для текста, который является необязательным.</para>
|
|
|
|
|
|
2024-02-01 14:39:54 +03:00
|
|
|
|
<para><ulink role='man' url='&man;passwd.5'>passwd(5)</ulink></para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
2022-05-21 23:04:03 +03:00
|
|
|
|
<para>Этот формат используется для ссылки на определенную страницу руководства (man).
|
|
|
|
|
Число в скобках указывает на конкретный раздел внутри руководств. Например, у
|
|
|
|
|
<command>passwd</command> есть две справочные страницы. В соответствии с
|
|
|
|
|
инструкциями по установке LFS эти две справочные страницы будут расположены
|
|
|
|
|
в <filename>/usr/share/man/man1/passwd.1</filename> и <filename>/usr/share/man/man5/passwd.5</filename>.
|
2024-02-01 14:39:54 +03:00
|
|
|
|
Когда в книге используется <ulink role='man' url='&man;/passwd.5'>passwd(5)</ulink>, имеется
|
|
|
|
|
в виду конкретно <filename>/usr/share/man/man5/passwd.5</filename>. <command>man passwd</command>
|
2024-02-01 20:12:23 +03:00
|
|
|
|
напечатает первую найденную справочную страницу, совпадающую с <quote>passwd</quote> -
|
|
|
|
|
это будет <filename>/usr/share/man/man1/passwd.1</filename>. В этом примере вам
|
2022-05-21 23:04:03 +03:00
|
|
|
|
нужно будет запустить <command>man 5 passwd</command>, чтобы прочитать указанную
|
|
|
|
|
страницу. Обратите внимание, что большинство справочных страниц не имеют
|
2023-08-02 23:14:31 +03:00
|
|
|
|
повторяющихся страниц в разных разделах. Поэтому обычно достаточно
|
2024-02-01 14:39:54 +03:00
|
|
|
|
<command>man <replaceable><имя программы></replaceable></command>. В книге LFS ссылки
|
|
|
|
|
на справочные страницы также являются гиперссылками, поэтому нажатие на такую ссылку откроет
|
|
|
|
|
справочную страницу, в формате HTML, со
|
|
|
|
|
<ulink url='https://man.archlinux.org/'>страниц руководства Arch Linux</ulink>.</para>
|
2022-05-14 22:51:14 +03:00
|
|
|
|
|
|
|
|
|
</sect1>
|
|
|
|
|
|