mirror of
https://github.com/Poltern/lfs-ru.git
synced 2024-10-18 11:50:21 +03:00
treewide: Use <ulink> instead of <filename> for man pages
"gcc(1)" is really not a file name. Use <ulink> and link to the online man page on https://man.archlinux.org/ so the user can refer to the man pages more easily. The change is done via a sed command and long lines are wrapped manually.
This commit is contained in:
parent
aec038d85e
commit
6ffa2cb043
@ -41,9 +41,10 @@
|
||||
<filename class="devicefile">/dev/sda</filename> для основного диска.
|
||||
Создайте раздел Linux и
|
||||
<systemitem class="filesystem">раздел подкачки</systemitem>, если это
|
||||
необходимо. Пожалуйста, обратитесь к справке по <filename>cfdisk(8)</filename>
|
||||
или <filename>fdisk(8)</filename>, если вы еще не знаете, как пользоваться
|
||||
этими программами.</para>
|
||||
необходимо. Пожалуйста, обратитесь к справке
|
||||
<ulink role='man' url='&man;cfdisk.8'>cfdisk(8)</ulink> или
|
||||
<ulink role='man' url='&man;fdisk.8'>fdisk(8)</ulink>, если вы еще не знаете,
|
||||
как пользоваться этими программами.</para>
|
||||
|
||||
<note><para>Для опытных пользователей возможны и другие схемы разбиения.
|
||||
Система LFS может располагаться на программном <ulink
|
||||
|
@ -100,7 +100,7 @@ esac</userinput></screen>
|
||||
|
||||
<para>Аргумент <quote><parameter>-</parameter></quote> передает значение команде
|
||||
<command>su</command> для запуска оболочки входа в систему, а не обычной оболочки.
|
||||
Разница между этими двумя типами оболочек подробно описана в <filename>bash(1)</filename>
|
||||
и <command>info bash</command>.</para>
|
||||
Разница между этими двумя типами оболочек подробно описана в
|
||||
<ulink role='man' url='&man;bash.1'>bash(1)</ulink> и <command>info bash</command>.</para>
|
||||
|
||||
</sect1>
|
||||
|
@ -79,8 +79,8 @@ EOF</userinput></screen>
|
||||
<para>Установка значения пользовательской маски создания файлов (umask) 022 гарантирует,
|
||||
что вновь созданные файлы и каталоги доступны для записи только их владельцу, но
|
||||
будут доступны для чтения и выполнения остальным пользователям (при условии, что
|
||||
системный вызов <filename>open(2)</filename> использует режим по умолчанию, новые
|
||||
файлы получат разрешения 644, а каталоги 755).</para>
|
||||
системный вызов <ulink role='man' url='&man;open.2'>open(2)</ulink> использует режимы по
|
||||
умолчанию, новые файлы получат разрешения 644, а каталоги 755).</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
@ -59,7 +59,7 @@ esac</userinput></screen>
|
||||
<para>
|
||||
Приведенная выше команда верна. Команда <command>ln</command> имеет несколько
|
||||
вариантов синтаксиса, поэтому обязательно ознакомьтесь с <command>info coreutils ln</command>
|
||||
и <filename>ln(1)</filename>, прежде чем сообщать об ошибке.
|
||||
и <ulink role='man' url='&man;ln.1'>ln(1)</ulink>, прежде чем сообщать об ошибке.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
|
@ -155,7 +155,7 @@ install-info --dir-file=/usr/share/info/dir /usr/share/info/com_err.info</userin
|
||||
<screen role='nodump'><userinput>sed 's/metadata_csum_seed,//' -i /etc/mke2fs.conf</userinput></screen>
|
||||
|
||||
<para>
|
||||
Подробности читайте в справочной странице <filename>mke2fs.conf(5)</filename>.
|
||||
Подробности читайте на странице руководства <ulink role='man' url='&man;mke2fs.conf.5'>mke2fs.conf(5)</ulink>.
|
||||
</para>
|
||||
</sect2>
|
||||
<sect2 id="contents-e2fsprogs" role="content">
|
||||
|
@ -159,7 +159,8 @@ make MANSUFFIX=ssl install</userinput></screen>
|
||||
<para>
|
||||
это инструмент командной строки для использования различных криптографических
|
||||
функций библиотеки <application>OpenSSL</application> из оболочки. Его можно
|
||||
использовать для различных функций, которые задокументированы в <filename>openssl(1)</filename>
|
||||
использовать для различных функций, которые задокументированы в
|
||||
<ulink role='man' url='&man;openssl.1'>openssl(1)</ulink>
|
||||
</para>
|
||||
<indexterm zone="ch-system-openssl openssl-prog">
|
||||
<primary sortas="b-openssl">openssl</primary>
|
||||
@ -189,7 +190,7 @@ make MANSUFFIX=ssl install</userinput></screen>
|
||||
<para>
|
||||
реализует протокол безопасности транспортного уровня (TLS v1). Он
|
||||
предоставляет богатый API, документацию по которому можно найти в руководстве
|
||||
<filename>ssl(7)</filename>
|
||||
<ulink role='man' url='&man;ssl.7'>ssl(7)</ulink>
|
||||
</para>
|
||||
<indexterm zone="ch-system-openssl libssl">
|
||||
<primary sortas="c-libssl">libssl.so</primary>
|
||||
|
@ -194,8 +194,8 @@ make -C man install-man</userinput></screen>
|
||||
группы в системе. Если такое поведение нежелательно, вам нужно передать один из параметров
|
||||
<parameter>-g</parameter> или <parameter>-N</parameter> в <command>useradd</command> или
|
||||
изменить настройку <parameter>USERGROUPS_ENAB</parameter> в файле <filename>/etc/login.defs</filename>.
|
||||
Смотрите справочную страницу <filename>useradd(8)</filename> для получения дополнительной
|
||||
информации.</para>
|
||||
Смотрите справочную страницу <ulink role='man' url='&man;useradd.8'>useradd(8)</ulink> для
|
||||
получения дополнительной информации.</para>
|
||||
|
||||
<para>Во-вторых, чтобы изменить параметры по умолчанию, необходимо создать файл
|
||||
<filename>/etc/default/useradd</filename> и настроить его в соответствии с вашими
|
||||
|
@ -573,7 +573,7 @@ su tester -c "make -k check"</userinput></screen>
|
||||
<term><command>irqtop</command></term>
|
||||
<listitem>
|
||||
<para>Отображает информацию о счетчике прерываний ядра в стиле
|
||||
<filename>top(1)</filename></para>
|
||||
<ulink role='man' url='&man;top.1'>top(1)</ulink></para>
|
||||
<indexterm zone="ch-system-util-linux irqtop">
|
||||
<primary sortas="b-irqtop">irqtop</primary>
|
||||
</indexterm>
|
||||
|
@ -45,9 +45,9 @@
|
||||
<filename class="extension">.netdev</filename> и
|
||||
<filename class="extension">.network</filename>. Для получения подробной информации с описанием
|
||||
и примерами содержимого этих конфигурационных файлов ознакомьтесь с руководствами
|
||||
<filename>systemd-link(5)</filename>,
|
||||
<filename>systemd-netdev(5)</filename> и
|
||||
<filename>systemd-network(5)</filename>.</para>
|
||||
<ulink role='man' url='&man;systemd-link.5'>systemd-link(5)</ulink>,
|
||||
<ulink role='man' url='&man;systemd-netdev.5'>systemd-netdev(5)</ulink> и
|
||||
<ulink role='man' url='&man;systemd-network.5'>systemd-network(5)</ulink>.</para>
|
||||
|
||||
<sect3 id="systemd-network-devices">
|
||||
<title>Именование сетевых устройств</title>
|
||||
@ -79,16 +79,18 @@
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Замаскируйте файл .link для политики по умолчанию:
|
||||
Замаскируйте файл <filename class='extension'>.link</filename> для политики по умолчанию:
|
||||
<screen role="nodump"><userinput>ln -s /dev/null /etc/systemd/network/99-default.link</userinput></screen>
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
Создайте собственную схему именования интерфейсов, например назвав интерфейсы "internet0",
|
||||
"dmz0" или "lan0". Для этого создайте файл .link в каталоге /etc/systemd/network/, в
|
||||
котором явно укажите новое имя интерфейса или более подходящую схема именования. Например:
|
||||
Создайте собственную схему именования интерфейсов, например назвав интерфейсы
|
||||
<literal>internet0</literal>, <literal>dmz0</literal> или <literal>lan0</literal>.
|
||||
Для этого создайте файл <filename class='extension'>.link</filename> в каталоге
|
||||
/etc/systemd/network/, в котором явно укажите новое имя интерфейса или более
|
||||
подходящую схему именования. Например:
|
||||
</para>
|
||||
|
||||
<screen role="nodump"><userinput>cat > /etc/systemd/network/10-ether0.link << "EOF"
|
||||
@ -101,8 +103,8 @@ Name=ether0</literal>
|
||||
EOF</userinput></screen>
|
||||
|
||||
<para>
|
||||
Смотрите справочную страницу <filename>systemd.link(5)</filename> для получения дополнительной
|
||||
информации.
|
||||
Смотрите справочную страницу <ulink role='man' url='&man;systemd.link.5'>systemd.link(5)</ulink>
|
||||
для получения дополнительной информации.
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
@ -325,7 +327,8 @@ EOF</userinput></screen>
|
||||
<literal>localhost</literal>, <literal>localhost.localdomain</literal> или имени хоста
|
||||
(без домена), поскольку они обрабатываются модулем NSS
|
||||
<systemitem class='library'>myhostname</systemitem>, прочтите справочную страницу
|
||||
<filename>nss-myhostname(8)</filename> для получения подробной информации.</para>
|
||||
<ulink role='man' url='&man;nss-myhostname.8'>nss-myhostname(8)</ulink> для получения подробной
|
||||
информации.</para>
|
||||
|
||||
<para>Запись ::1 является IPv6-аналогом 127.0.0.1 и представляет loopback-интерфейс IPv6.</para>
|
||||
|
||||
|
@ -21,8 +21,8 @@
|
||||
основными операциями systemd. Изначально все записи в этом файле закомментированы с
|
||||
указанием настроек по умолчанию. В этом файле может быть изменен уровень логирования, а также
|
||||
некоторые базовые настройки ведения файлов логов. Смотрите страницу руководства
|
||||
<filename>systemd-system.conf(5)</filename> для получения подробной информации по каждому
|
||||
параметру.</para>
|
||||
<ulink role='man' url='&man;systemd-system.conf.5'>systemd-system.conf(5)</ulink> для
|
||||
получения подробной информации по каждому параметру.</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
@ -83,7 +83,7 @@ EOF</userinput></screen>
|
||||
<filename class="directory">/etc/tmpfiles.d</filename>. Файлы в
|
||||
<filename class="directory">/etc/tmpfiles.d</filename> переопределяют файлы с таким же именем в
|
||||
<filename class="directory">/usr/lib/tmpfiles.d</filename>. Смотрите подробности по формату файла
|
||||
в руководстве <filename>tmpfiles.d(5)</filename>.</para>
|
||||
в руководстве <ulink role='man' url='&man;tmpfiles.d.5'>tmpfiles.d(5)</ulink>.</para>
|
||||
|
||||
<para>
|
||||
Обратите внимание, что синтаксис файлов в
|
||||
@ -124,8 +124,8 @@ RestartSec=30</literal>
|
||||
EOF</userinput></screen>
|
||||
|
||||
<para>Дополнительную информацию смотрите на странице руководства
|
||||
<filename>systemd.unit(5)</filename>. После создания файла конфигурации запустите
|
||||
<userinput>systemctl daemon-reload</userinput> и <userinput>systemctl
|
||||
<ulink role='man' url='&man;systemd.unit.5'>systemd.unit(5)</ulink>. После создания файла
|
||||
конфигурации запустите <userinput>systemctl daemon-reload</userinput> и <userinput>systemctl
|
||||
restart foobar</userinput>, чтобы активировать изменения в службе.</para>
|
||||
|
||||
</sect2>
|
||||
@ -233,9 +233,9 @@ MaxUse=5G</literal>
|
||||
EOF</userinput></screen>
|
||||
|
||||
<para>Смотрите следующие страницы руководства для получения дополнительной информации
|
||||
информация <filename>systemd-coredump(8)</filename>,
|
||||
<filename>coredumpctl(1)</filename>, и
|
||||
<filename>coredump.conf.d(5)</filename>.</para>
|
||||
информация <ulink role='man' url='&man;systemd-coredump.8'>systemd-coredump(8)</ulink>,
|
||||
<ulink role='man' url='&man;coredumpctl.1'>coredumpctl(1)</ulink> и
|
||||
<ulink role='man' url='&man;coredump.conf.d.5'>coredump.conf.d(5)</ulink>.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
|
@ -207,8 +207,8 @@
|
||||
<para>Обратите внимание, что команда <quote>softdep</quote> разрешает добавлять
|
||||
<literal>pre:</literal> зависимости, или одновременно
|
||||
<literal>pre:</literal> и <literal>post:</literal> зависимости. Обратитесь к документации
|
||||
<filename>modprobe.d(5)</filename> для изучения синтаксиса и возможностей
|
||||
<quote>softdep</quote>.</para>
|
||||
<ulink role='man' url='&man;modprobe.d.5'>modprobe.d(5)</ulink> для изучения синтаксиса и
|
||||
возможностей <quote>softdep</quote>.</para>
|
||||
|
||||
<para revision="sysv">Если рассматриваемый модуль не является обёрткой, и полезен сам по
|
||||
себе, настройте загрузочный скрипт <command>modules</command>, чтобы он инициализировался
|
||||
|
@ -33,9 +33,10 @@
|
||||
<para>SysVinit (в дальнейшем именуемый <quote>init</quote>) использует схему уровней выполнения.
|
||||
Существует семь уровней выполнения, пронумерованных от 0 до 6. (На самом деле уровней
|
||||
больше, но они предназначены для особых случаев и обычно не используются. Подробности смотрите в
|
||||
руководстве <filename>init(8)</filename>). Каждый из них соответствует действиям, которые компьютер
|
||||
должен выполнить при запуске и выключении. Уровень выполнения по умолчанию — 3. Ниже приведено
|
||||
описание различных уровней в том виде, в каком они реализованы в LFS:</para>
|
||||
руководстве <ulink role='man' url='&man;init.8'>init(8)</ulink>). Каждый из них соответствует
|
||||
действиям, которые компьютер должен выполнить при запуске и выключении. Уровень выполнения по
|
||||
умолчанию — 3. Ниже приведено описание различных уровней в том виде, в каком они реализованы в
|
||||
LFS:</para>
|
||||
|
||||
<literallayout>0: выключение компьютера
|
||||
1: однопользовательский режим
|
||||
@ -316,8 +317,9 @@ EOF</userinput></screen>
|
||||
смотрите <ulink url="https://tldp.org/HOWTO/HOWTO-INDEX/other-lang.html"/>. Если вы все еще
|
||||
сомневаетесь, посмотрите в каталогах <filename class="directory">/usr/share/keymaps</filename>
|
||||
и <filename class="directory">/usr/share/consolefonts</filename> допустимые раскладки и экранные
|
||||
шрифты. Прочтите справочные страницы <filename>loadkeys(1)</filename> и
|
||||
<filename>setfont(8)</filename>, чтобы определить правильные аргументы для этих программ.</para>
|
||||
шрифты. Прочтите справочные страницы <ulink role='man' url='&man;loadkeys.1'>loadkeys(1)</ulink> и
|
||||
<ulink role='man' url='&man;setfont.8'>setfont(8)</ulink>, чтобы определить правильные аргументы
|
||||
для этих программ.</para>
|
||||
|
||||
<para>Файл <filename>/etc/sysconfig/console</filename> должен содержать строки вида:
|
||||
ПЕРЕМЕННАЯ="значение". Допустимы следующие переменные:</para>
|
||||
|
@ -56,7 +56,7 @@ EOF</userinput></screen>
|
||||
class="partition">sda2</filename>, <filename
|
||||
class="partition">sda5</filename>, и <systemitem
|
||||
class="filesystem">ext4</systemitem>. Для получения подробной информации о параметрах в этом
|
||||
файле, смотрите <filename>fstab(5)</filename>.</para>
|
||||
файле, смотрите <ulink role='man' url='&man;fstab.5'>fstab(5)</ulink>.</para>
|
||||
|
||||
<para>Файловым системам операционных систем MS DOS и Windows (таким как vfat, ntfs, smbfs,
|
||||
cifs, iso9660, udf) требуется специальная опция utf8, чтобы не-ASCII символы в именах файлов
|
||||
|
@ -305,7 +305,7 @@
|
||||
каталоге <filename class="directory">/etc/modprobe.d</filename>. Информация о модулях и конфигурации
|
||||
ядра находится в <xref linkend="ch-config-udev"/> и в документации к ядру <filename
|
||||
class="directory">linux-&linux-version;/Documentation</filename>. Кроме этого, стоит ознакомиться с
|
||||
руководством <filename>modprobe.d(5)</filename>.</para>
|
||||
руководством <ulink role='man' url='&man;modprobe.d.5'>modprobe.d(5)</ulink>.</para>
|
||||
|
||||
<para>Если поддержка модулей не была отключена в параметрах ядра, установите модули с помощью:</para>
|
||||
|
||||
|
@ -127,6 +127,7 @@
|
||||
<!ENTITY github "https://github.com">
|
||||
<!ENTITY pypi-home "https://pypi.org/project">
|
||||
<!ENTITY pypi-src "https://pypi.org/packages/source">
|
||||
<!ENTITY man "https://man.archlinux.org/man/">
|
||||
|
||||
<!ENTITY root "<systemitem class='username'>root</systemitem>">
|
||||
<!ENTITY lfs-user "<systemitem class='username'>lfs</systemitem>">
|
||||
|
@ -71,21 +71,24 @@ EOF</userinput></screen>
|
||||
|
||||
<para>Этот формат используется для текста, который является необязательным.</para>
|
||||
|
||||
<para><filename>passwd(5)</filename></para>
|
||||
<para><ulink role='man' url='&man;passwd.5'>passwd(5)</ulink></para>
|
||||
|
||||
<para>Этот формат используется для ссылки на определенную страницу руководства (man).
|
||||
Число в скобках указывает на конкретный раздел внутри руководств. Например, у
|
||||
<command>passwd</command> есть две справочные страницы. В соответствии с
|
||||
инструкциями по установке LFS эти две справочные страницы будут расположены
|
||||
в <filename>/usr/share/man/man1/passwd.1</filename> и <filename>/usr/share/man/man5/passwd.5</filename>.
|
||||
Когда в книге используется <filename>passwd(5)</filename>, имеется в виду
|
||||
конкретно <filename>/usr/share/man/man5/passwd.5</filename>. <command>man passwd</command>
|
||||
Когда в книге используется <ulink role='man' url='&man;/passwd.5'>passwd(5)</ulink>, имеется
|
||||
в виду конкретно <filename>/usr/share/man/man5/passwd.5</filename>. <command>man passwd</command>
|
||||
напечатает первую найденную справочную страницу, совпадающую с <quote>passwd</quote>,
|
||||
которая будет <filename>/usr/share/man/man1/passwd.1</filename>. В этом примере вам
|
||||
нужно будет запустить <command>man 5 passwd</command>, чтобы прочитать указанную
|
||||
страницу. Обратите внимание, что большинство справочных страниц не имеют
|
||||
повторяющихся страниц в разных разделах. Поэтому обычно достаточно
|
||||
<command>man <replaceable><имя программы></replaceable></command>.</para>
|
||||
<command>man <replaceable><имя программы></replaceable></command>. В книге LFS ссылки
|
||||
на справочные страницы также являются гиперссылками, поэтому нажатие на такую ссылку откроет
|
||||
справочную страницу, в формате HTML, со
|
||||
<ulink url='https://man.archlinux.org/'>страниц руководства Arch Linux</ulink>.</para>
|
||||
|
||||
</sect1>
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user