mirrors/lfs-ru
3
0
Fork 0
mirror of https://github.com/Poltern/lfs-ru.git synced 2024-10-18 11:50:21 +03:00
Code Issues Packages Projects Releases Wiki Activity

treewide: Use <ulink> instead of <filename> for man pages

Browse Source 
"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:
Poltern 2024-02-01 16:39:54 +05:00
parent aec038d85e
commit 6ffa2cb043
16 changed files with 56 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
chapter02/creatingpartition.xml
View File

@ -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

4
chapter04/addinguser.xml
View File

@ -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>

4
chapter04/settingenviron.xml
View File

@ -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>

2
chapter05/glibc.xml
View File

@ -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>

2
chapter08/e2fsprogs.xml
View File

@ -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">

5
chapter08/openssl.xml
View File

@ -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>

4
chapter08/shadow.xml
View File

@ -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> и настроить его в соответствии с вашими

2
chapter08/util-linux.xml
View File

@ -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>

23
chapter09/networkd.xml
View File

@ -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 &gt; /etc/systemd/network/10-ether0.link &lt;&lt; "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>

16
chapter09/systemd-custom.xml
View File

@ -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>

4
chapter09/udev.xml
View File

@ -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>, чтобы он инициализировался

12
chapter09/usage.xml
View File

@ -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>

2
chapter10/fstab.xml
View File

@ -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 символы в именах файлов

2
chapter10/kernel.xml
View File

@ -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>

1
general.ent
View File

@ -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>">

11
prologue/typography.xml
View File

@ -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>&lt;имя программы&gt;</replaceable></command>.</para>
<command>man <replaceable>&lt;имя программы&gt;</replaceable></command>. В книге LFS ссылки
на справочные страницы также являются гиперссылками, поэтому нажатие на такую ссылку откроет
справочную страницу, в формате HTML, со
<ulink url='https://man.archlinux.org/'>страниц руководства Arch Linux</ulink>.</para>
</sect1>