Build offline documentation using Hugo and other improvements

* Allow to build the documentation offline using Hugo * Fix link problems * Remove SVN entities * Fix lang problems to help weblate * Move all the AsciiDoctor translations to the shared folder to help weblate * Allow the possibility to build each document. For example each document can be edited in and watched the result in real time in VS Code or Vim/NeoVim. Breaking changes: Eliminate the possibility of building books or articles. They must be builded at the same time. This functionality will be restored when version 0.89.0 is in the repositories in a couple of weeks. Reviewed by: dbaio@ Differential Revision: https://reviews.freebsd.org/D31926
author: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org> 2021-11-03 16:39:08 +0000
committer: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org> 2021-11-03 16:44:52 +0000
commit: 64acd169b82416fe39ad8c4b1be106680d4a3eb3 (patch)
tree: 05b8bc3182dc4cfcf0a8a0964b4303903a4abf56 /documentation/content/ru/books
parent: 0636d709faeb6b7d1a44882ae33a02015d32774b (diff)
download: doc-64acd169b82416fe39ad8c4b1be106680d4a3eb3.tar.gz
doc-64acd169b82416fe39ad8c4b1be106680d4a3eb3.zip
67 files changed, 1602 insertions, 1319 deletions
diff --git a/documentation/content/ru/books/arch-handbook/book.adoc b/documentation/content/ru/books/arch-handbook/book.adoc
index 863d9aa451..02fb3a4420 100644
--- a/documentation/content/ru/books/arch-handbook/book.adoc
+++ b/documentation/content/ru/books/arch-handbook/book.adoc
@@ -13,48 +13,35 @@ tags: ["Arch Handbook", "FreeBSD"]
 :toc: macro
 :toclevels: 2
 :icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :sectnums:
 :sectnumlevels: 6
 :partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
 :book: true
 :pdf: false
+:images-path: books/arch-handbook/
 
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:chapters-path: content/ru/books/arch-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
 endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 endif::[]
 
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
 
 '''
@@ -63,10 +50,9 @@ toc::[]
 
 // Section one
 
-include::{chapters-path}locking/chapter.adoc[]
+include::{chapters-path}locking/chapter.adoc[leveloffset=+1]
 
 // Section two
 
-include::{chapters-path}driverbasics/chapter.adoc[]
-include::{chapters-path}sound/chapter.adoc[]
-
+include::{chapters-path}driverbasics/chapter.adoc[leveloffset=+1]
+include::{chapters-path}sound/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/ru/books/arch-handbook/driverbasics/chapter.adoc b/documentation/content/ru/books/arch-handbook/driverbasics/chapter.adoc
index 5a94438d17..d845e849be 100644
--- a/documentation/content/ru/books/arch-handbook/driverbasics/chapter.adoc
+++ b/documentation/content/ru/books/arch-handbook/driverbasics/chapter.adoc
@@ -10,16 +10,35 @@ authors:
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+
+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::[]
 
 Эту главу написал {murray} на основе множества источников, включая справочную страницу intro(4), которую создал {joerg}.
 
diff --git a/documentation/content/ru/books/arch-handbook/locking/chapter.adoc b/documentation/content/ru/books/arch-handbook/locking/chapter.adoc
index be6faecad7..bdb37f8e29 100644
--- a/documentation/content/ru/books/arch-handbook/locking/chapter.adoc
+++ b/documentation/content/ru/books/arch-handbook/locking/chapter.adoc
@@ -10,16 +10,35 @@ authors:
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+
+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::[]
 
 _Эта глава поддерживается проектом FreeBSD SMP Next Generation Project. Комментарии и пожелания направляйте в link:{freebsd-smp}._
 
diff --git a/documentation/content/ru/books/arch-handbook/sound/chapter.adoc b/documentation/content/ru/books/arch-handbook/sound/chapter.adoc
index bce3a61d3e..4bb8b82ea9 100644
--- a/documentation/content/ru/books/arch-handbook/sound/chapter.adoc
+++ b/documentation/content/ru/books/arch-handbook/sound/chapter.adoc
@@ -10,16 +10,35 @@ authors:
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+
+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::[]
 
 [[oss-intro]]
 == Введение
diff --git a/documentation/content/ru/books/design-44bsd/_index.adoc b/documentation/content/ru/books/design-44bsd/_index.adoc
index f7d41c42de..34459e978b 100644
--- a/documentation/content/ru/books/design-44bsd/_index.adoc
+++ b/documentation/content/ru/books/design-44bsd/_index.adoc
@@ -6,8 +6,8 @@ authors:
   - author: Michael J. Karels
   - author: John S. Quarterman
 copyright: 1996 Addison-Wesley Longman, Inc
-releaseinfo: "$FreeBSD$" 
-trademarks: ["design-44bsd"] 
+trademarks: ["design-44bsd"]
+isIndex: true
 ---
 
 = Архитектура и реализация операционной системы 4.4BSD
@@ -15,52 +15,35 @@ trademarks: ["design-44bsd"]
 :toc: macro
 :toclevels: 2
 :icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :sectnums:
 :sectnumlevels: 6
 :partnums:
+:sectnumoffset: 2
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:sectnumoffset: 2
+:images-path: books/design-44bsd/
 
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../images/{images-path}
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:imagesdir: ../../../../images/books/design-44bsd/
-:chapters-path: content/ru/books/design-44bsd/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/design-44bsd/
 endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../../static/images/books/design-44bsd/
+ifdef::backend-pdf,backend-epub3[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 endif::[]
 
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../../static/images/books/design-44bsd/
+ifndef::env-beastie[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
 
 '''
diff --git a/documentation/content/ru/books/developers-handbook/_index.adoc b/documentation/content/ru/books/developers-handbook/_index.adoc
index 3071e05dfa..98a3fbc883 100644
--- a/documentation/content/ru/books/developers-handbook/_index.adoc
+++ b/documentation/content/ru/books/developers-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: Руководство FreeBSD для разработчиков
 authors:
   - author: The FreeBSD Documentation Project
 copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$" 
-trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"] 
+trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+isIndex: true
 ---
 
 = Руководство FreeBSD для разработчиков
@@ -12,51 +12,35 @@ trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "
 :toc: macro
 :toclevels: 2
 :icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :sectnums:
 :sectnumlevels: 6
 :partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:book: true
+:pdf: false
+:images-path: books/developers-handbook/
 
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:imagesdir: ../../images/books/developers-handbook/
-:chapters-path: content/ru/books/developers-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
 endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../static/images/books/developers-handbook/
+ifdef::backend-pdf,backend-epub3[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 endif::[]
 
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../static/images/books/developers-handbook/
+ifndef::env-beastie[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
 
 [.abstract-title]
diff --git a/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc b/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc
index ca3d0c852c..c9cab95af5 100644
--- a/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc
+++ b/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc
@@ -12,16 +12,36 @@ authors:
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+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::[]
 
 [[introduction-devel]]
 == Разработка во FreeBSD
diff --git a/documentation/content/ru/books/developers-handbook/kerneldebug/chapter.adoc b/documentation/content/ru/books/developers-handbook/kerneldebug/chapter.adoc
index 88e5a643c5..6e116cfec2 100644
--- a/documentation/content/ru/books/developers-handbook/kerneldebug/chapter.adoc
+++ b/documentation/content/ru/books/developers-handbook/kerneldebug/chapter.adoc
@@ -13,16 +13,36 @@ authors:
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+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::[]
 
 [[kerneldebug-obtain]]
 == Получение аварийного дампа ядра
@@ -358,7 +378,7 @@ makeoptions    DEBUG=-g                #Build kernel with gdb(1) debug symbols
 options DDB
 ....
 
-в ваш конфигурационный файл, и перестройте ядро. (Обратитесь к link:{handbook}[Руководству по FreeBSD] для выяснения подробностей о конфигурации ядра FreeBSD).
+в ваш конфигурационный файл, и перестройте ядро. (Обратитесь к extref:{handbook}[Руководству по FreeBSD] для выяснения подробностей о конфигурации ядра FreeBSD).
 
 [NOTE]
 ====
diff --git a/documentation/content/ru/books/developers-handbook/policies/chapter.adoc b/documentation/content/ru/books/developers-handbook/policies/chapter.adoc
index cf2c5c3594..970a4b9921 100644
--- a/documentation/content/ru/books/developers-handbook/policies/chapter.adoc
+++ b/documentation/content/ru/books/developers-handbook/policies/chapter.adoc
@@ -12,16 +12,36 @@ authors:
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+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::[]
 
 В этой главе описываются различные рекомендации и требования, которые должны соблюдаться в дереве исходных текстов FreeBSD.
 
@@ -138,18 +158,18 @@ obrien@FreeBSD.org - 30 March 1997
 . Любой файл, интерпретируемый или выполняемый системным(и) CPU, не в форме исходного кода, является нежелательным.
 . Любой файл с лицензией, ограничивающей более, чем BSD или GNU, является нежелательным.
 . Файл, содержащий загружаемые двоичные данные, используемые аппаратным обеспечением, не являются нежелательными, если только к нему не применимы условия (1) или (2). Он должен быть сохранен в нейтральном к архитектуре формате ASCII (рекомендуется применить утилиты file2c или uuencode).
-. Любой нежелательный файл требует особого одобрения со стороны link:{contributors}#staff-core/[Правления] до того, как он будет добавлен в хранилище CVS.
+. Любой нежелательный файл требует особого одобрения со стороны extref:{contributors}[Правления, staff-core] до того, как он будет добавлен в хранилище CVS.
 . Нежелательные файлы помещаются в каталог [.filename]#src/contrib# или [.filename]#src/sys/contrib#.
 . Части одного модуля должны храниться вместе. Нет необходимости разбивать их, если только нет совместного использования с кодом, не являющимся нежелательным.
 . Объектные файлы именуются [.filename]#arch/filename.o.uu>#.
 . Файлы ядра;
 .. Должны всегда упоминаться в [.filename]#conf/files.*# (для упрощения построения).
-.. Должны всегда присутствовать в [.filename]#LINT#, но link:{contributors}#staff-core/[Правление] решает в каждом конкретном случае, должны ли они быть раскомментированы или нет. Конечно, позже link:{contributors}#staff-core/[Правление] может изменить свое решение.
+.. Должны всегда присутствовать в [.filename]#LINT#, но extref:{contributors}[Правление, staff-core] решает в каждом конкретном случае, должны ли они быть раскомментированы или нет. Конечно, позже extref:{contributors}[Правление, staff-core] может изменить свое решение.
 .. Вопрос о вхождении в состав релиза решается _Группой Выпусков Релизов_.
 
 . Файлы уровня пользователя:
-.. link:{contributors}#staff-core/[Правление] решает, должен ли код стать частью выполнения команды `make world`.
-.. link:{contributors}#staff-who/[Релиз инженер] решает, войдут ли они в релиз.
+.. extref:{contributors}[Правление, staff-core] решает, должен ли код стать частью выполнения команды `make world`.
+.. extref:{contributors}[Релиз инженер, staff-who] решает, войдут ли они в релиз.
 
 [[policies-shlib]]
 == Динамические библиотеки
diff --git a/documentation/content/ru/books/developers-handbook/secure/chapter.adoc b/documentation/content/ru/books/developers-handbook/secure/chapter.adoc
index 0d2a138544..28ff3ac158 100644
--- a/documentation/content/ru/books/developers-handbook/secure/chapter.adoc
+++ b/documentation/content/ru/books/developers-handbook/secure/chapter.adoc
@@ -11,16 +11,36 @@ authors:
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+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::[]
 
 [[secure-synopsis]]
 == Обзор
diff --git a/documentation/content/ru/books/faq/_index.adoc b/documentation/content/ru/books/faq/_index.adoc
index 8f644a518e..40da854402 100644
--- a/documentation/content/ru/books/faq/_index.adoc
+++ b/documentation/content/ru/books/faq/_index.adoc
@@ -3,8 +3,8 @@ title: Часто задаваемые вопросы по FreeBSD 11.X и 12.X
 authors: 
   - author: Проект документации FreeBSD
 copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$" 
-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"] 
+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+isIndex: true
 ---
 
 = Часто задаваемые вопросы по FreeBSD {rel2-relx} и {rel-relx}
@@ -12,60 +12,46 @@ trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "
 :toc: macro
 :toclevels: 1
 :icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :sectnums:
 :sectnumlevels: 6
 :partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
 :rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
 :rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
 endif::[]
 
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
 
 [.abstract-title]
@@ -73,7 +59,7 @@ endif::[]
 
 Этот документ является так называемым FAQ (Frequently Asked Questions), то есть списком Часто Задаваемых Вопросов по FreeBSD версий {rel3-relx}, {rel2-relx} и {rel-relx}. Мы прилагаем все усилия, чтобы сделать этот FAQ максимально информативным; если у вас есть идеи по его усовершенствованию, шлите их на адрес {freebsd-doc}.
 
-Последняя редакция этого документа всегда доступна с link:{faq}[Web-сервера FreeBSD]. Его также можно получить в виде одного большого link:.[ HTML-файла] по HTTP или в ряде других форматов с link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FTP-сервера].
+Последняя редакция этого документа всегда доступна с extref:{faq}[Web-сервера FreeBSD]. Его также можно получить в виде одного большого link:.[ HTML-файла] по HTTP или в ряде других форматов с link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FTP-сервера].
 
 '''
 
@@ -89,7 +75,7 @@ FreeBSD - это современная операционная система
 
 FreeBSD используется компаниями, Интернет-провайдерами, научными работниками, профессионалами в вычислительной технике, студентами и рядовыми пользователями по всему миру для работы, образования и отдыха.
 
-Для более детального знакомства с FreeBSD обратитесь к link:{handbook}/[Руководству по FreeBSD].
+Для более детального знакомства с FreeBSD обратитесь к extref:{handbook}/[Руководству по FreeBSD].
 
 [[FreeBSD-goals]]
 === Какова цель FreeBSD?
@@ -116,7 +102,7 @@ FreeBSD используется компаниями, Интернет-пров
 
 Если приложение доступно только для одной операционной системы, то нельзя всего лишь заменить эту операционную систему. Однако есть вероятность, что похожая программа существует для FreeBSD. В качестве сервера для офиса, или сервера Интернет, или надежной рабочей станции FreeBSD практически всегда справится со всем, что вам нужно. Многие пользователи по всему миру, включая как новичков, так и опытных администраторов UNIX(R), используют FreeBSD в качестве своей единственной настольной операционной системы.
 
-Пользователи при переходе на FreeBSD с другого варианта UNIX(R) найдут для себя FreeBSD очень похожей. Пользователей Windows(R) и Mac OS(R), напротив, может заинтересовать http://www.pcbsd.org/[PC-BSD], дистрибутив на основе FreeBSD. Пользователям, которые не использовали до этого UNIX(R), понадобится затратить дополнительное время на изучение подхода UNIX(R) к работе. Этот FAQ и link:{handbook}[Руководство по FreeBSD] являются прекрасным способом начать это изучение.
+Пользователи при переходе на FreeBSD с другого варианта UNIX(R) найдут для себя FreeBSD очень похожей. Пользователей Windows(R) и Mac OS(R), напротив, может заинтересовать http://www.pcbsd.org/[PC-BSD], дистрибутив на основе FreeBSD. Пользователям, которые не использовали до этого UNIX(R), понадобится затратить дополнительное время на изучение подхода UNIX(R) к работе. Этот FAQ и extref:{handbook}[Руководство по FreeBSD] являются прекрасным способом начать это изучение.
 
 === Почему система называется именно FreeBSD?
 
@@ -154,7 +140,7 @@ FreeBSD используется компаниями, Интернет-пров
 
 === Что такое FreeBSD-CURRENT?
 
-link:{handbook}#current[ FreeBSD-CURRENT] - это версия операционной системы, находящаяся в стадии разработки, которая должна потом стать новой веткой FreeBSD-STABLE. Таким образом, она представляет реальный интерес только для разработчиков системы и её фанатов. Обратитесь к link:{handbook}#current[соответствующему разделу] link:{handbook}[Руководства] для прояснения деталей работы с _-CURRENT_.
+extref:{handbook}updating-upgrading, current[FreeBSD-CURRENT] - это версия операционной системы, находящаяся в стадии разработки, которая должна потом стать новой веткой FreeBSD-STABLE. Таким образом, она представляет реальный интерес только для разработчиков системы и её фанатов. Обратитесь к extref:{handbook}updating-upgrading[соответствующему разделу, current] extref:{handbook}[Руководства] для прояснения деталей работы с _-CURRENT_.
 
 Пользователям, не знакомым с FreeBSD, не следует использовать FreeBSD-CURRENT. Эта ветвь зачастую меняется очень быстро и иногда из-за ошибок может быть не работоспособна. Те, кто используют FreeBSD-CURRENT, должны быть в состоянии изучить проблему, найти причину и сообщить о этом.
 
@@ -173,7 +159,7 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
 
 === В чём смысл FreeBSD-STABLE?
 
-После того, как была выпущена FreeBSD 2.0.5, разработка FreeBSD разделилась на две части. Одна ветка получила название link:{handbook}#stable[-STABLE], а другая link:{handbook}#current[-CURRENT]. _FreeBSD-STABLE_ предназначена для провайдеров услуг Интернет и других коммерческих пользователей, для которых неожиданные изменения или экспериментальные возможности весьма нежелательны. В неё вносятся только хорошо оттестированные исправления и другие небольшие последовательные усовершенствования. С другой стороны, _FreeBSD-CURRENT_ являлась единой веткой, не разрываемой с момента выхода версии 2.0 и ведущей к {rel120-current}-RELEASE и последующим релизам. Для получения более подробной информации по веткам обратитесь к разделу статьи "link:{releng}#rel-branch[ Подготовка релизов FreeBSD: Создание ветки релиза]". Статус веток и расписание предстоящих релизов можно получить на странице http://www.FreeBSD.org/releng[Информация о подготовке релизов].
+После того, как была выпущена FreeBSD 2.0.5, разработка FreeBSD разделилась на две части. Одна ветка получила название extref:{handbook}updating-upgrading[-STABLE, stable], а другая extref:{handbook}updating-upgrading[-CURRENT, current]. _FreeBSD-STABLE_ предназначена для провайдеров услуг Интернет и других коммерческих пользователей, для которых неожиданные изменения или экспериментальные возможности весьма нежелательны. В неё вносятся только хорошо оттестированные исправления и другие небольшие последовательные усовершенствования. С другой стороны, _FreeBSD-CURRENT_ являлась единой веткой, не разрываемой с момента выхода версии 2.0 и ведущей к {rel120-current}-RELEASE и последующим релизам. Для получения более подробной информации по веткам обратитесь к разделу статьи "extref:{releng}[Подготовка релизов FreeBSD: Создание ветки релиза, rel-branch]". Статус веток и расписание предстоящих релизов можно получить на странице http://www.FreeBSD.org/releng[Информация о подготовке релизов].
 
 Активно разрабатываемой веткой _-STABLE_ является {rel120-current}-STABLE. Последним релизом в ветке {rel120-current}-STABLE является {rel120-current}-RELEASE, выпущенный {rel120-current-date}.
 
@@ -189,7 +175,7 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
 
 === Кто разрабатывает FreeBSD?
 
-Решения, которые касаются ключевых моментов в проекте FreeBSD, такие, как общее направление развития проекта или кто может добавлять код к дереву исходных текстов, принимаются link:https://www.FreeBSD.org/administration/#t-core[основной командой] разработчиков (Core Team), состоящей из 9 человек. Также существует многочисленная группа, состоящая из более чем 350 так называемых link:{contributors}#staff-committers[коммиттеров] (committers), которые могут вносить изменения прямо в дерево исходных текстов FreeBSD.
+Решения, которые касаются ключевых моментов в проекте FreeBSD, такие, как общее направление развития проекта или кто может добавлять код к дереву исходных текстов, принимаются link:https://www.FreeBSD.org/administration/#t-core[основной командой] разработчиков (Core Team), состоящей из 9 человек. Также существует многочисленная группа, состоящая из более чем 350 так называемых extref:{contributors}[коммиттеров, staff-committers] (committers), которые могут вносить изменения прямо в дерево исходных текстов FreeBSD.
 
 Однако большинство нетривиальных изменений широко обсуждается в <<mailing,списках рассылки>>, и не существует никаких ограничений на участие в подобных дискуссиях.
 
@@ -201,7 +187,7 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
 * link:https://www.FreeBSD.org/snapshots/[Снэпшот-релизы] для веток <<current,-CURRENT>> и <<stable,-STABLE>> выпускаются ежемесячно, но они нужны исключительно для разработчиков и тех, кто тестирует самые последние наработки.
 * Последний релиз {rel2-stable}, {rel112-current}-RELEASE, можно найти в link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/{rel112-current}-RELEASE/[каталоге {rel112-current}-RELEASE].
 
-Информация о получении/приобретении FreeBSD на CD, DVD и других носителях доступна в link:{handbook}#mirrors/[Руководстве].
+Информация о получении/приобретении FreeBSD на CD, DVD и других носителях доступна в extref:{handbook}mirrors/[Руководстве, mirrors].
 
 === Как можно получить доступ к базе сообщений о проблемах (Problem Report)?
 
@@ -209,13 +195,13 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
 
 Можно использовать link:https://www.FreeBSD.org/support/bugreports/[Web-интерфейс] для отсылки сообщений об ошибках через браузер.
 
-Перед тем, как посылать сообщение об ошибке, прочтите статью link:{problem-reports}[Составление сообщений о проблеме во FreeBSD] о том, как писать хорошие сообщения об ошибках.
+Перед тем, как посылать сообщение об ошибке, прочтите статью extref:{problem-reports}[Составление сообщений о проблеме во FreeBSD] о том, как писать хорошие сообщения об ошибках.
 
 == Документация и поддержка
 
 === Есть ли хорошие книги по FreeBSD?
 
-В рамках проекта создан широкий спектр документации, которая доступна on-line по следующей ссылке: http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/docs/]. Кроме того, в <<bibliography,Библиографии>> в конце этого FAQ и в link:{handbook}#bibliography/[Руководстве] имеются ссылки на другие рекомендуемые для чтения книги.
+В рамках проекта создан широкий спектр документации, которая доступна on-line по следующей ссылке: http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/docs/]. Кроме того, в <<bibliography,Библиографии>> в конце этого FAQ и в extref:{handbook}bibliography/[Руководстве, bibliography] имеются ссылки на другие рекомендуемые для чтения книги.
 
 === Есть ли версии документации в другом формате, например, в виде обычного текста ASCII или PostScript(R)?
 
@@ -352,7 +338,7 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
 
 === Где найти информацию по спискам рассылки FreeBSD? Какие существуют телеконференции по FreeBSD?
 
-Исчерпывающая информация содержится в link:{handbook}#eresources-mail[разделе] Руководства, который посвящён спискам рассылки, и в link:{handbook}#eresources-news/[разделе] Руководства, касающемся телеконференций.
+Исчерпывающая информация содержится в extref:{handbook}eresources[разделе, eresources-mail] Руководства, который посвящён спискам рассылки, и в extref:{handbook}eresources/[разделе, eresources-news] Руководства, касающемся телеконференций.
 
 === Существуют ли каналы IRC (Internet Relay Chat) по FreeBSD?
 
@@ -414,7 +400,7 @@ amd64 - это термин, применяемый во FreeBSD для обоз
 
 Пользователям pc98 нужны образы дискет: [.filename]#floppies/boot.flp#, [.filename]#floppies/kern1.flp#, [.filename]#floppies/kern2.flp# и [.filename]#floppies/mfsroot1.flp#. Эти образы нужно перенести на дискеты с помощью таких утилит, как man:dd[1].
 
-Полные инструкции по этой процедуре и об установке вообще можно найти в link:{handbook}#install/[ разделе] Руководства, посвящённом установке FreeBSD.
+Полные инструкции по этой процедуре и об установке вообще можно найти в extref:{handbook}install/[разделе, install] Руководства, посвящённом установке FreeBSD.
 
 === Помогите! Установочный образ не загружается!
 
@@ -426,7 +412,7 @@ amd64 - это термин, применяемый во FreeBSD для обоз
 
 === Где инструкции по установке FreeBSD?
 
-Инструкции по установке FreeBSD 9.0 и более поздних версий могут быть найдены в link:{handbook}#bsdinstall/[главе] Руководства, посвящённой установке FreeBSD. Также имеются инструкции по установке link:{handbook}#install/[предыдущих] версий FreeBSD.
+Инструкции по установке FreeBSD 9.0 и более поздних версий могут быть найдены в extref:{handbook}bsdinstall/[главе, bsdinstall] Руководства, посвящённой установке FreeBSD. Также имеются инструкции по установке extref:{handbook}install/[предыдущих, install] версий FreeBSD.
 
 === Какие минимальные требования для запуска FreeBSD?
 
@@ -434,7 +420,7 @@ amd64 - это термин, применяемый во FreeBSD для обоз
 
 === Как сделать собственный установочный диск?
 
-Индивидуальный установочный носитель FreeBSD можно создать, запустив процедуру построения индивидуального релиза. Следуйте инструкциям в статье о link:{releng}[подготовке релизов FreeBSD].
+Индивидуальный установочный носитель FreeBSD можно создать, запустив процедуру построения индивидуального релиза. Следуйте инструкциям в статье о extref:{releng}[подготовке релизов FreeBSD].
 
 === Может ли Windows(R) сосуществовать с FreeBSD?
 
@@ -530,7 +516,7 @@ PAE не является широко используемым в настоя�
 
 ==== Поддерживает ли FreeBSD аппаратные платформы, отличные от x86?
 
-Да. Поддержка FreeBSD подразделяется на множество классов. Архитектуры первого класса, такие как i386 или amd64, полностью поддерживаются. Архитектуры 2 и 3 класса поддерживаются по мере возможности. Полное описание классов доступно в link:{committers-guide}#archs/[справочнике коммиттера].
+Да. Поддержка FreeBSD подразделяется на множество классов. Архитектуры первого класса, такие как i386 или amd64, полностью поддерживаются. Архитектуры 2 и 3 класса поддерживаются по мере возможности. Полное описание классов доступно в extref:{committers-guide}[справочнике коммиттера, archs].
 
 Полный список поддерживаемых архитектур находится на http://www.FreeBSD.org/ru/platforms/[странице], посвящённой платформам.
 
@@ -705,7 +691,7 @@ FreeBSD поддерживает функции ACPI, реализованные
 
 Ядро FreeBSD позволяет одновременно существовать ограниченному числу процессов. Это зависит от значения переменной man:sysctl[8] `kern.maxusers`. `kern.maxusers` также влияет на другие ограничения ядра, такие как буферы работы с сетью. Если система сильно загружена, поднимите `kern.maxusers`. Кроме максимального числа процессов это также увеличит значения других параметров, ограничивающих систему.
 
-Для корректировки значения `kern.maxusers` обратитесь к разделу link:{handbook}#kern-maxfiles[ Ограничения файлов/процессов] Руководства. В нём говорится об открытых файлах, но те же ограничения касаются процессов.
+Для корректировки значения `kern.maxusers` обратитесь к разделу extref:{handbook}config-tuning[Ограничения файлов/процессов, kern-maxfiles] Руководства. В нём говорится об открытых файлах, но те же ограничения касаются процессов.
 
 Если система загружена слабо, но в ней запущено слишком много процессов, поправьте параметр `kern.maxproc`, определив его значение в [.filename]#/boot/loader.conf#. Изменение не вступит в силу до перезагрузки системы. За дополнительной информацией, касающейся настройки параметров, обращайтесь к странице Справочника man:loader.conf[5]. Если эти процессы запущены одним и тем же пользователем, поправьте значение `kern.maxprocperuid`, чтобы оно было на единицу меньше, чем новое значение `kern.maxproc`. Оно должно быть меньше по крайней мере на единицу, потому что системная программа man:init[8] должна работать всегда.
 
@@ -735,7 +721,7 @@ FreeBSD поддерживает функции ACPI, реализованные
 
 === Почему в man:dmesg[8] регулярно выводятся сообщения file: table is full?
 
-Такое сообщение об ошибке сигнализирует о том, что в системе закончились доступные файловые дескрипторы. Обратитесь к разделу link:{handbook}#kern-maxfiles[ kern.maxfiles] главы о link:{handbook}#configtuning-kernel-limits/[ Настройке ограничений ядра] Руководства для выяснения всех подробностей и устранения этой проблемы.
+Такое сообщение об ошибке сигнализирует о том, что в системе закончились доступные файловые дескрипторы. Обратитесь к разделу extref:{handbook}config-tuning[kern.maxfiles, kern-maxfiles] главы о extref:{handbook}config-tuning/[Настройке ограничений ядра, configtuning-kernel-limits] Руководства для выяснения всех подробностей и устранения этой проблемы.
 
 === Почему часы на моем компьютере показывают неправильное время?
 
@@ -833,9 +819,9 @@ FreeBSD умеет работать со сжатыми двоичными па�
 
 Любым из указанных способов:
 
-* Используйте portsnap в большинстве случаев. Обратитесь к разделу link:{handbook}#ports-using/[Использование Коллекции Портов] для получения инструкций по использованию этого инструмента.
-* Используйте SVN, если нужны собственные патчи для дерева портов. Обратитесь к разделу link:{handbook}#svn/[Использование Subversion] для получения дополнительной информации.
-* Используйте CTM как это описано в разделе link:{handbook}#ctm/[Использование CTM] для получения изменений по почте при нестабильном соединении.
+* Используйте portsnap в большинстве случаев. Обратитесь к разделу extref:{handbook}ports/[Использование Коллекции Портов, ports-using] для получения инструкций по использованию этого инструмента.
+* Используйте SVN, если нужны собственные патчи для дерева портов. Обратитесь к разделу extref:{handbook}mirrors/[Использование Subversion, svn] для получения дополнительной информации.
+* Используйте CTM как это описано в разделе extref:{handbook}[Использование CTM] для получения изменений по почте при нестабильном соединении.
 
 === Поддерживает ли FreeBSD среду Java(TM)?
 
@@ -843,7 +829,7 @@ FreeBSD умеет работать со сжатыми двоичными па�
 
 === Почему этот порт не компилируется на моей машине с {rel2-relx} - или {rel-relx} -STABLE?
 
-Если установленная версия FreeBSD, значительно отстаёт от _-CURRENT_ или _-STABLE_, обновите Коллекцию Портов с использованием указаний в разделе link:{handbook}#ports-using/[Использование Коллекции Портов]. Если система в актуальном состоянии, значит кто-то мог внести изменение в порт, с которым он работает в _-CURRENT_, но не работает в _-STABLE_. https://bugs.FreeBSD.org/submit/[Пошлите] сообщение об ошибке, так как Коллекция Портов должна работать как в _-CURRENT_, так и в ветках _-STABLE_.
+Если установленная версия FreeBSD, значительно отстаёт от _-CURRENT_ или _-STABLE_, обновите Коллекцию Портов с использованием указаний в разделе extref:{handbook}ports/[Использование Коллекции Портов, ports-using]. Если система в актуальном состоянии, значит кто-то мог внести изменение в порт, с которым он работает в _-CURRENT_, но не работает в _-STABLE_. https://bugs.FreeBSD.org/submit/[Пошлите] сообщение об ошибке, так как Коллекция Портов должна работать как в _-CURRENT_, так и в ветках _-STABLE_.
 
 === Я попытался сформировать файл INDEX командой make index, однако попытка окончилась неудачей. Почему?
 
@@ -853,7 +839,7 @@ FreeBSD умеет работать со сжатыми двоичными па�
 
 === Я обновил исходные тексты. Как теперь обновить установленные порты?
 
-С FreeBSD не поставляется инструмент обновления портов, но есть несколько инструментов, немного облегчающих этот процесс. Кроме того, для упрощения работы с портами доступны дополнительные инструменты; смотрите раздел Руководства FreeBSD link:{handbook}#ports-using/[Использование Коллекции Портов].
+С FreeBSD не поставляется инструмент обновления портов, но есть несколько инструментов, немного облегчающих этот процесс. Кроме того, для упрощения работы с портами доступны дополнительные инструменты; смотрите раздел Руководства FreeBSD extref:{handbook}ports/[Использование Коллекции Портов, ports-using].
 
 === Нужно ли мне перекомпилировать все порты каждый раз, когда я выполняю мажорное обновление (со сменой старшей версии FreeBSD)?
 
@@ -882,14 +868,14 @@ FreeBSD умеет работать со сжатыми двоичными па�
 % timidity -Ow -s 44100 -o /tmp/juke/01.wav 01.mid
 ....
 
-WAV-файлы затем могут быть преобразованы в другие форматы или записаны как аудио-CD, что описано в link:{handbook}#creating-cds/[Руководстве FreeBSD].
+WAV-файлы затем могут быть преобразованы в другие форматы или записаны как аудио-CD, что описано в extref:{handbook}disks/[Руководстве FreeBSD, creating-cds].
 
 == Конфигурирование ядра
 
 [[make-kernel]]
 === Я хочу изменить настройки ядра. Это сложно?
 
-Вовсе нет! Обратитесь к link:{handbook}#kernelconfig/[соответствующему разделу] Руководства, который посвящён этому вопросу.
+Вовсе нет! Обратитесь к extref:{handbook}kernelconfig/[соответствующему разделу, kernelconfig] Руководства, который посвящён этому вопросу.
 
 [NOTE]
 ====
@@ -935,7 +921,7 @@ MODULES_OVERRIDE= accf_http ipfw
 
 Для дальнейшего уменьшения размера также можно удалить ненужные устройства из ядра. Для получения дополнительной информации смотрите <<make-kernel>>.
 
-Для вступления любого из этих действий в силу следуйте указаниям по link:{handbook}#kernelconfig-building/[сборке и установке] нового ядра.
+Для вступления любого из этих действий в силу следуйте указаниям по extref:{handbook}kernelconfig/[сборке и установке, kernelconfig-building] нового ядра.
 
 Большинство ядер ([.filename]#/boot/kernel/kernel#), как правило, занимают от 12 до 16 Мбайт.
 
@@ -965,7 +951,7 @@ kern.sched.name: ULE
 
 === Как добавить в систему новый диск?
 
-Обратитесь к разделу link:{handbook}#disks-adding/[Добавление дисков] Руководства FreeBSD.
+Обратитесь к разделу extref:{handbook}disks/[Добавление дисков, disks-adding] Руководства FreeBSD.
 
 === Как перенести систему на большой новый диск?
 
@@ -1072,7 +1058,7 @@ FreeBSD включает сетевую файловую систему NFS. В
 
 === Существует ли криптографическая файловая система для FreeBSD?
 
-Да, man:gbde[8] и man:geli[8]. Смотрите раздел link:{handbook}#disks-encrypting/[Шифрование дисковых разделов] Руководства FreeBSD.
+Да, man:gbde[8] и man:geli[8]. Смотрите раздел extref:{handbook}disks/[Шифрование дисковых разделов, disks-encrypting] Руководства FreeBSD.
 
 === Как загрузить FreeBSD и Linux(R) с помощью GRUB?
 
@@ -1138,23 +1124,23 @@ kernel /boot/loader
 
 === При монтировании компакт-диска выдаётся сообщение Incorrect super block.
 
-Необходимо указать тип монтируемого устройства. Это описано в в разделе Руководства link:{handbook}#creating-cds/#mounting-cd[Использование CD с данными].
+Необходимо указать тип монтируемого устройства. Это описано в в разделе Руководства extref:{handbook}disks[Использование CD с данными, creating-cds].
 
 === При монтировании компакт-диска выдаётся сообщение Device not configured.
 
-Обычно это означает, что в приводе нет компакт-диска либо устройство не обнаружено на шине. Обратитесь к разделу link:{handbook}#mounting-cd[Использование CD с данными] в Руководстве, где подробно обсуждается этот вопрос.
+Обычно это означает, что в приводе нет компакт-диска либо устройство не обнаружено на шине. Обратитесь к разделу extref:{handbook}disks[Использование CD с данными, mounting-cd] в Руководстве, где подробно обсуждается этот вопрос.
 
 === Когда я монтирую CD-ROM, все неанглийские символы в именах файлов выводятся как ?.
 
-Скорее всего, на компакт-диске для хранения информации о файлах и каталогах используется расширение "Joliet". Это описано в разделе Руководства об link:{handbook}#mounting-cd[использовании CD с данными].
+Скорее всего, на компакт-диске для хранения информации о файлах и каталогах используется расширение "Joliet". Это описано в разделе Руководства об extref:{handbook}disks[использовании CD с данными, mounting-cd].
 
 === Записанный во FreeBSD CD не читается ни в какой другой операционной системой. Почему?
 
-Это означает, что на CD был записан непосредственно необработанный файл без создания файловой системы ISO 9660. Прочтите раздел Руководства о link:{handbook}#rawdata-cd[записи данных непосредственно на компакт-диски].
+Это означает, что на CD был записан непосредственно необработанный файл без создания файловой системы ISO 9660. Прочтите раздел Руководства о extref:{handbook}disks[записи данных непосредственно на компакт-диски, rawdata-cd].
 
 === Как создать образ CD с данными?
 
-Это описано в разделе Руководства о link:{handbook}#imaging-cd[копировании CD с данными]. Более полную информацию о работе с компакт-дисками можно найти в разделе о link:{handbook}#creating-cds/[создании компакт-дисков] в главе Руководства об устройствах хранения данных.
+Это описано в разделе Руководства о extref:{handbook}disks[копировании CD с данными, imaging-cd]. Более полную информацию о работе с компакт-дисками можно найти в разделе о extref:{handbook}disks/[создании компакт-дисков, creating-cds] в главе Руководства об устройствах хранения данных.
 
 === Почему я не могу смонтировать (командой mount аудио CD?
 
@@ -1220,7 +1206,7 @@ kernel /boot/loader
 
 === Как добавить дополнительную виртуальную память?
 
-В этом разделе link:{handbook}#adding-swap-space/[Руководства] описывается, как это сделать.
+В этом разделе extref:{handbook}config-tuning/[Руководства, adding-swap-space] описывается, как это сделать.
 
 === Почему FreeBSD считает, что размер моего диска меньше, чем заявляет его производитель?
 
@@ -1357,11 +1343,11 @@ ZFS TRIM может не работать на всех конфигурация
 
 === У меня проблемы с установкой принтера.
 
-Обратитесь к соответствующему link:{handbook}#printing/[разделу] Руководства, посвящённому печати, за советами по разрешению проблем.
+Обратитесь к соответствующему extref:{handbook}printing/[разделу, printing] Руководства, посвящённому печати, за советами по разрешению проблем.
 
 === Раскладка клавиатуры неверна.
 
-Обратитесь к разделу Руководства, посвящённому link:{handbook}#using-localization/[использованию локализации], а именно к части, описывающей link:{handbook}#setting-console[ настройку консоли].
+Обратитесь к разделу Руководства, посвящённому extref:{handbook}l10n/[использованию локализации, using-localization], а именно к части, описывающей extref:{handbook}l10n[настройку консоли, setting-console].
 
 === Почему не получается заставить работать дисковые квоты?
 
@@ -1373,7 +1359,7 @@ options QUOTA
 ....
 
 + 
-Прочтите link:{handbook}#quotas/[главу руководства по квотам] для полной информации.
+Прочтитеextref:{handbook}disks/[главу руководства по квотам, quotas] для полной информации.
 . Не включайте квотирование на разделе [.filename]#/#.
 . Помещайте файл с квотами в ту файловую систему, которую он обслуживает:
 +
@@ -1421,7 +1407,7 @@ options    SYSVMSG	  # enable for messaging
 
 [NOTE]
 ====
-Если корневой раздел не получается смонтировать в однопользовательском режиме, то возможно, что разделы являются зашифрованными, и смонтировать их без ключей доступа не представляется возможным. За дополнительной информацией обращайтесь к разделу link:{handbook}#disks-encrypting/[Руководства], посвященному шифрованию дисков во FreeBSD.
+Если корневой раздел не получается смонтировать в однопользовательском режиме, то возможно, что разделы являются зашифрованными, и смонтировать их без ключей доступа не представляется возможным. За дополнительной информацией обращайтесь к разделу extref:{handbook}disks/[Руководства, disks-encrypting], посвященному шифрованию дисков во FreeBSD.
 ====
 
 === Как запретить перезагрузку по нажатию Control Alt Delete?
@@ -1486,7 +1472,7 @@ options SC_DISABLE_REBOOT
 
 Когда делается релиз, то ветвь, из которой он выпускается, подвергается некоторой подготовке. Частью этого процесса является замораживание кода. Когда инициируется замораживание кода, то имя ветки изменяется для того, чтобы отразить факт близости релиза. Например, если ветка называлась 6.2-STABLE, то её имя будет изменено на 6.3-PRERELEASE, чтобы обозначить момент прекращения внесения изменений в код системы и период дополнительного тестирования перед выходом релиза. В это время исправления ошибок могут быть внесены в код системы для того, чтобы быть включенными в релиз. Когда исходный код подготовлен к выпуску релиза, имя будет изменено на 6.3-RC для обозначения того, что релиз будет сделан, скорее всего, именно из этого кода. Когда код находится на этапе RC, в нём могут исправляться только самые критичные ошибки. Как только релиз (в нашем примере 6.3-RELEASE) и ветка релиза будут созданы, ветвь будет переименована в 6.3-STABLE.
 
-Для получения дополнительной информации о номерах версий и различных ветках Subversion обратитесь к статье о link:{releng}[выпуске релизов].
+Для получения дополнительной информации о номерах версий и различных ветках Subversion обратитесь к статье о extref:{releng}[выпуске релизов].
 
 === Я попытался установить новое ядро, однако утилита man:chflags[1] не сработала. Как это обойти?
 
@@ -1584,7 +1570,7 @@ X Window System (обычно `X11`) является наиболее обще�
 #  pkg install xorg
 ....
 
-После установки Xorg следуйте указаниям в разделе link:{handbook}#x-config/[Конфигурация X11] Руководства FreeBSD.
+После установки Xorg следуйте указаниям в разделе extref:{handbook}x11/[Конфигурация X11, x-config] Руководства FreeBSD.
 
 === Я попытался запустить X, но получил сообщение No devices detected. после ввода команды startx. Что мне теперь делать?
 
@@ -1798,7 +1784,7 @@ psmintr: out of sync (xxxx != yyyy)
 
 === Как установить экранную заставку и где такие заставки можно найти?
 
-Подробный ответ находится в разделе link:{handbook}#boot-blocks[Загрузочные экранные заставки] Руководства FreeBSD.
+Подробный ответ находится в разделе extref:{handbook}boot[Загрузочные экранные заставки, boot-blocks] Руководства FreeBSD.
 
 === Можно ли в X использовать клавишу Windows?
 
@@ -1864,29 +1850,29 @@ nVidia предоставляет подробную информацию о т�
 
 === Где можно найти информацию о бездисковой загрузке?
 
-"Бездисковая загрузка" означает, что машина с FreeBSD загружается по сети и читает необходимые файлы с сервера, а не со своего диска. Подробное описание есть в link:{handbook}#network-diskless/[ соответствующей главе] Руководства.
+"Бездисковая загрузка" означает, что машина с FreeBSD загружается по сети и читает необходимые файлы с сервера, а не со своего диска. Подробное описание есть в extref:{handbook}advanced-networking/[ соответствующей главе, network-diskless] Руководства.
 
 === Может ли машина с FreeBSD использоваться как маршрутизатор?
 
-Да. Обратитесь к разделу Руководства, посвящённому link:{handbook}#advanced-networking/[сложным вопросам работы в сети], особенно в той части, что касается link:{handbook}#network-routing/[маршрутизации и маршрутизаторов].
+Да. Обратитесь к разделу Руководства, посвящённому extref:{handbook}advanced-networking/[сложным вопросам работы в сети, advanced-networking], особенно в той части, что касается extref:{handbook}advanced-networking/[маршрутизации и маршрутизаторов, network-routing].
 
 === Можно ли подключить машину с Windows(R) к Internet с помощью FreeBSD?
 
 Как правило, те, кто задают такие вопросы, имеют дома два компьютера, один с FreeBSD, а другой с какой-то версией Windows(R). Идея состоит в использовании FreeBSD для подключения к Internet, а затем осуществлять выход в Internet из Windows(R) через FreeBSD. На самом деле это просто частный случай предыдущего вопроса, который хорошо отработан.
 
-Для подключения к Internet с использованием коммутируемого соединения нужно указать параметр `-nat` и установить в файле [.filename]#/etc/rc.conf# переменную `gateway_enable` в значение _YES_. Для получения дополнительной информации обратитесь к страницам справочной системы по команде man:ppp[8] или link:{handbook}#userppp/[ разделу Руководства о PPP режима пользователя].
+Для подключения к Internet с использованием коммутируемого соединения нужно указать параметр `-nat` и установить в файле [.filename]#/etc/rc.conf# переменную `gateway_enable` в значение _YES_. Для получения дополнительной информации обратитесь к страницам справочной системы по команде man:ppp[8] или extref:{handbook}ppp-and-slip/[ разделу Руководства о PPP режима пользователя, userppp].
 
-Если подключение к Internet выполняется через Ethernet, используйте man:natd[8]. Вводная информация находится в разделе Руководства link:{handbook}#network-natd/[natd].
+Если подключение к Internet выполняется через Ethernet, используйте man:natd[8]. Вводная информация находится в разделе Руководства extref:{handbook}/[natd, network-natd].
 
 === Поддерживает ли FreeBSD протокол PPP?
 
 Да. man:ppp[8] может обслуживать как входящие, так и исходящие соединения.
 
-Более подробная информация об их использовании находится в link:{handbook}#ppp-and-slip/[разделе Руководства о протоколе PPP].
+Более подробная информация об их использовании находится в extref:{handbook}ppp-and-slip/[разделе Руководства о протоколе PPP, ppp-and-slip].
 
 === Поддерживает ли FreeBSD технологию NAT или Masquerading?
 
-Да. Для получения указаний по использованию NAT через подключение PPP обратитесь к link:{handbook}#userppp/[разделу Руководства о PPP]. Чтобы использовать NAT вместе с другим типом сетевого подключения, взгляните на раздел Руководства link:{handbook}#network-natd/[natd].
+Да. Для получения указаний по использованию NAT через подключение PPP обратитесь к extref:{handbook}ppp-and-slip/[разделу Руководства о PPP, userppp]. Чтобы использовать NAT вместе с другим типом сетевого подключения, взгляните на раздел Руководства extref:{handbook}/[natd, network-natd].
 
 === Как настроить алиас в сети Ethernet?
 
@@ -1904,7 +1890,7 @@ nVidia предоставляет подробную информацию о т�
 # ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
 ....
 
-Дополнительная информация находится в link:{handbook}#configtuning-virtual-hosts/[Руководстве] FreeBSD.
+Дополнительная информация находится в extref:{handbook}config-tuning/[Руководстве, configtuning-virtual-hosts] FreeBSD.
 
 === Почему я не могу смонтировать диск Linux(R) по NFS?
 
@@ -1917,7 +1903,7 @@ nVidia предоставляет подробную информацию о т�
 
 === Почему mountd продолжает выдавать сообщения can't change attributes и bad exports list на моём сервере NFS, работающем под управлением FreeBSD?
 
-В большинстве случаев проблема заключается в недостаточном понимании корректного формата файла [.filename]#/etc/exports#. Просмотрите ещё раз справочную информацию по man:exports[5] и раздел об link:{handbook}#network-nfs/[NFS] в Руководстве, особенно в части link:{handbook}#configuring-nfs[настройки NFS].
+В большинстве случаев проблема заключается в недостаточном понимании корректного формата файла [.filename]#/etc/exports#. Просмотрите ещё раз справочную информацию по man:exports[5] и раздел об extref:{handbook}network-servers/[NFS, network-nfs] в Руководстве, особенно в части extref:{handbook}[настройки NFS, configuring-nfs].
 
 === Как включить поддержку multicast IP?
 
@@ -1925,7 +1911,7 @@ nVidia предоставляет подробную информацию о т�
 
 === Почему я должен использовать FQDN для хостов не в моей сети?
 
-За ответом на этот вопрос обращайтесь к link:{handbook}#mail-trouble/[Руководству] FreeBSD.
+За ответом на этот вопрос обращайтесь к extref:{handbook}mail/[Руководству, mail-trouble] FreeBSD.
 
 === Permission denied для любых действий, связанных с работой сети.
 
@@ -1940,7 +1926,7 @@ nVidia предоставляет подробную информацию о т�
 
 Рассмотрите использование `firewall_type='open'` в файле [.filename]#/etc/rc.conf#.
 
-Дополнительная информация о настройке данного межсетевого экрана находится в link:{handbook}#firewalls-ipfw/[соответствующей главе] Руководства.
+Дополнительная информация о настройке данного межсетевого экрана находится в extref:{handbook}firewalls/[соответствующей главе, firewalls-ipfw] Руководства.
 
 === Почему моё правило fwd для ipfw по перенаправлению сервиса на другую машину не работает?
 
@@ -2099,7 +2085,7 @@ device bpf	# Berkeley Packet Filter
 
 === Не могу заставить работать ppp. Что я делаю не так?
 
-Первым делом прочтите страницу Справочника man:ppp[8] и link:{handbook}#ppp-and-slip[раздел PPP] Руководства. Для помощи с устранением неполадок включите протоколирование следующей командой:
+Первым делом прочтите страницу Справочника man:ppp[8] и extref:{handbook}ppp-and-slip[раздел PPP, ppp-and-slip] Руководства. Для помощи с устранением неполадок включите протоколирование следующей командой:
 
 [.programlisting]
 ....
@@ -2149,7 +2135,7 @@ default 	10.0.0.2    UGSc	0	0      tun0
 delete ALL
 ....
 
-В таком случае обратитесь к соответствующему link:{handbook}#userppp-final[разделу] Руководства.
+В таком случае обратитесь к соответствующему extref:{handbook}ppp-and-slip[разделу, userppp-final] Руководства.
 
 === Что означает сообщение No route to host?
 
@@ -2170,7 +2156,7 @@ delete ALL
 add 0 0 HISADDR
 ....
 
-Обратитесь к разделу link:{handbook}#userppp-dynamicip[PPP и динамические IP адреса] Руководства за подробной информацией.
+Обратитесь к разделу extref:{handbook}[PPP и динамические IP адреса, userppp-dynamicip] Руководства за подробной информацией.
 
 === Соединение разрывается через 3 минуты
 
@@ -2345,7 +2331,7 @@ set dfilter 3 permit 0/0 0/0
 
 Это не всегда удобно, так как закрывает возможность дозвона по запросу. Большинству программ нужно обратиться к DNS до того, как начать работать.
 
-В случае DNS попытайтесь установить, что именно пытается определить имя хоста. В большинстве случаев виновным оказывается Sendmail. Проверьте, чтобы в конфигурационном файле программы Sendmail не было указано обращаться к DNS. Обратитесь к разделу об link:{handbook}#smtp-dialup/[использовании электронной почты при коммутируемом соединении] в Руководстве FreeBSD за подробным описанием. Вам может понадобиться добавить в файл [.filename]#.mc# строку:
+В случае DNS попытайтесь установить, что именно пытается определить имя хоста. В большинстве случаев виновным оказывается Sendmail. Проверьте, чтобы в конфигурационном файле программы Sendmail не было указано обращаться к DNS. Обратитесь к разделу об extref:{handbook}mail/[использовании электронной почты при коммутируемом соединении, smtp-dialup] в Руководстве FreeBSD за подробным описанием. Вам может понадобиться добавить в файл [.filename]#.mc# строку:
 
 [.programlisting]
 ....
@@ -2468,7 +2454,7 @@ FCS является сокращением от Frame Check Sequence (конт�
 
 === Какие многопортовые последовательные адаптеры поддерживаются во FreeBSD?
 
-Список таких устройств находится в главе Руководства link:{handbook}#serial/[Последовательные соединения].
+Список таких устройств находится в главе Руководства extref:{handbook}serialcomms/[Последовательные соединения, serial].
 
 Большинство многопортовых PCI адаптеров на базе 16550 и их клоны поддерживаются без дополнительных усилий.
 
@@ -2478,7 +2464,7 @@ FCS является сокращением от Frame Check Sequence (конт�
 
 === Как сделать, чтобы приглашение boot: выводилось на консоль на последовательном порту?
 
-Подробная информация находится в link:{handbook}#serialconsole-setup/[этом разделе Руководства].
+Подробная информация находится в extref:{handbook}serialcomms/[этом разделе Руководства, serialconsole-setup].
 
 === Как узнать, обнаружила ли FreeBSD последовательные порты или внутренние модемы?
 
@@ -2535,15 +2521,15 @@ hint.sio.7.irq="12"
 
 === Можно ли настроить для порта режим работы по умолчанию?
 
-Смотрите раздел Руководства FreeBSD, посвящённый link:{handbook}#serial/#serial-hw-config[последовательным соединениям].
+Смотрите раздел Руководства FreeBSD, посвящённый extref:{handbook}serialcomms[последовательным соединениям, serial].
 
 === Как сделать вход через модем?
 
-Ознакомьтесь с разделом Руководства FreeBSD, посвящённым link:{handbook}#dialup/[входящим соединениям].
+Ознакомьтесь с разделом Руководства FreeBSD, посвящённым extref:{handbook}serialcomms/[входящим соединениям, dialup].
 
 === Как подключить терминал к FreeBSD?
 
-Информация по этому вопросу находится в разделе link:{handbook}#term/[Терминалы] Руководства FreeBSD.
+Информация по этому вопросу находится в разделе extref:{handbook}serialcomms/[Терминалы, term] Руководства FreeBSD.
 
 === Почему не удаётся запустить tip или cu?
 
@@ -2605,7 +2591,7 @@ FreeBSD активно перемещает неиспользуемые стр�
 
 === Что мне нужно сделать, чтобы перевести документацию FreeBSD на родной язык?
 
-Ознакомьтесь с link:{fdp-primer}#translations/[FAQ по Переводам] из FreeBSD Documentation Project Primer.
+Ознакомьтесь с extref:{fdp-primer}[FAQ по Переводам, translations] из FreeBSD Documentation Project Primer.
 
 === Почему возвращается моя электронная почта, отправленная на любой из адресов FreeBSD.org?
 
@@ -2645,7 +2631,7 @@ http://www.arbornet.org/[Arbornet, Inc], также известный как _M
 
 === При просмотре списков рассылки, я встретил акроним или другой термин, который мне не понятен. Где я должен посмотреть, что он значит?
 
-Пожалуйста, обращайтесь к link:{handbook}#freebsd-glossary/[Глоссарию FreeBSD].
+Пожалуйста, обращайтесь к extref:{handbook}glossary/[Глоссарию FreeBSD, freebsd-glossary].
 
 === Почему я должен беспокоиться о цвете велосипедных навесов (bikeshed)?
 
@@ -2770,13 +2756,13 @@ _Пол Робинсон (Paul Robinson) добавляет:_
 
 === Как можно узнать больше о внутреннем устройстве FreeBSD?
 
-Список относящихся к делу книг можно найти в разделе Руководства link:{handbook}#bibliography-osinternals/[ Библиография по внутреннему устройству операционной системы].
+Список относящихся к делу книг можно найти в разделе Руководства extref:{handbook}bibliography/[ Библиография по внутреннему устройству операционной системы, bibliography-osinternals].
 
 Кроме того, большинство общих знаний о UNIX(R) непосредственно применимо к FreeBSD.
 
 === Как можно оказать помощь проекту FreeBSD?
 
-Пожалуйста, обратитесь к соответствующей link:{contributing}[статье], в которой вы получите советы относительно того, как это сделать. Ваша помощь более чем приветствуется!
+Пожалуйста, обратитесь к соответствующей extref:{contributing}[статье], в которой вы получите советы относительно того, как это сделать. Ваша помощь более чем приветствуется!
 
 === Что такое снапшоты и релизы?
 
@@ -2793,11 +2779,11 @@ _Пол Робинсон (Paul Robinson) добавляет:_
 
 === Можно ли работать с -CURRENT при ограниченном доступе в Internet?
 
-Да, это можно делать _без_ скачивания полного дерева исходных текстов с помощью link:{handbook}#ctx[системы CTM].
+Да, это можно делать _без_ скачивания полного дерева исходных текстов с помощью extref:{handbook}[системы CTM].
 
 === Я написал некоторое добавление к ядру, кому его послать?
 
-Обратитесь к статье о том, как link:{contributing}[помочь проекту FreeBSD], чтобы выяснить, как это сделать.
+Обратитесь к статье о том, как extref:{contributing}[помочь проекту FreeBSD], чтобы выяснить, как это сделать.
 
 И спасибо Вам за Ваши усилия!
 
@@ -2941,7 +2927,7 @@ options KVA_PAGES=N
 
 Этот небольшой скромный документ с ответами на часто задаваемые вопросы создавался, переписывался, редактировался, сокращался, растягивался, уродовался, потрошился, пристально разглядывался, полностью перетряхивался, обдумывался, отвергался, перестраивался, критиковался и снова укреплялся в течение последнего десятилетия силами сотен, если не тысяч, людей. Постоянно.
 
-Мы хотим поблагодарить всех их и приглашаем вас link:{contributing}[присоединиться], чтобы сделать этот FAQ ещё лучше.
+Мы хотим поблагодарить всех их и приглашаем вас extref:{contributing}[присоединиться], чтобы сделать этот FAQ ещё лучше.
 
 [bibliography]
 [[bibliography]]
diff --git a/documentation/content/ru/books/handbook/_index.adoc b/documentation/content/ru/books/handbook/_index.adoc
index aaed2e9cfb..c6065e3328 100644
--- a/documentation/content/ru/books/handbook/_index.adoc
+++ b/documentation/content/ru/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: Руководство FreeBSD
 authors:
   - author: Проект Документации FreeBSD
 copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$" 
 trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"] 
 next: books/handbook/preface
+isIndex: true
 ---
 
 = FreeBSD Handbook
@@ -15,18 +15,32 @@ next: books/handbook/preface
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:images-path: books/handbook/
 
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 
 [.abstract-title]
 Аннотация
@@ -35,10 +49,10 @@ include::shared/ru/mailing-lists.adoc[]
 
 '''
 
-include::content/ru/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
 
-include::content/ru/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
 
-include::content/ru/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
 
-include::content/ru/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/ru/books/handbook/advanced-networking/_index.adoc b/documentation/content/ru/books/handbook/advanced-networking/_index.adoc
index 6e718c4bd5..0b13ef22b2 100644
--- a/documentation/content/ru/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/ru/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[advanced-networking-synopsis]]
 == Краткий обзор
@@ -1469,7 +1467,7 @@ TA полностью полагаются на даемон PPP, который
 
 Как и в случае модемов проблемой использования внешнего TA является потребность в хорошем последовательном адаптере на вашем компьютере.
 
-Вы должны прочесть учебник link:{serial-uart}[Последовательные устройства во FreeBSD] для того, чтобы в деталях понять работу последовательных устройств и осознать различие между асинхронными и синхронными последовательными портами.
+Вы должны прочесть учебник extref:{serial-uart}[Последовательные устройства во FreeBSD] для того, чтобы в деталях понять работу последовательных устройств и осознать различие между асинхронными и синхронными последовательными портами.
 
 TA, работающий со стандартным последовательным (асинхронным) портом PC, ограничивает вас скоростью 115.2 Кбит/с, хотя реально у вас соединение на скорости 128 Кбит/с. Чтобы использовать 128 Кбит/с, которые обеспечивает ISDN, полностью, вы должны подключить TA к синхронному последовательному адаптеру.
 
diff --git a/documentation/content/ru/books/handbook/audit/_index.adoc b/documentation/content/ru/books/handbook/audit/_index.adoc
index 5e07d56c80..39417a94f6 100644
--- a/documentation/content/ru/books/handbook/audit/_index.adoc
+++ b/documentation/content/ru/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[audit-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/basics/_index.adoc b/documentation/content/ru/books/handbook/basics/_index.adoc
index d484276b1d..5937f782e0 100644
--- a/documentation/content/ru/books/handbook/basics/_index.adoc
+++ b/documentation/content/ru/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[basics-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/bibliography/_index.adoc b/documentation/content/ru/books/handbook/bibliography/_index.adoc
index 5429f378bb..0eb08ff175 100644
--- a/documentation/content/ru/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/ru/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
 [[bibliography]]
 = Библиография
 :doctype: book
+:toc: macro
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
 
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Так как страницы Справочника FreeBSD предоставляют лишь описание отдельных частей операционной системы FreeBSD, они не очень удобны для иллюстрации объединения этих частей вместе для того, чтобы настроить ОС и сделать ее работу более гладкой. Для этого незаменимы хорошая книга по системному администрированию UNIX(R) и хорошее руководство пользователя.
 
@@ -118,7 +132,7 @@ _Книги и журналы на английском языке:_
 * Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
 * McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
 + 
-(глава 2 этой книги доступна link:{design-44bsd}[онлайн] как часть Проекта документирования FreeBSD, и глава 9 доступна http://www.netapp.com/tech_library/nfsbook.html[ здесь].)
+(глава 2 этой книги доступна extref:{design-44bsd}[онлайн] как часть Проекта документирования FreeBSD, и глава 9 доступна http://www.netapp.com/tech_library/nfsbook.html[ здесь].)
 * Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
 * Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
 * Schimmel, Curt. _Unix Systems for Modern Architectures_. Reading, Mass. : Addison-Wesley, 1994. ISBN 0-201-63338-8
diff --git a/documentation/content/ru/books/handbook/book.adoc b/documentation/content/ru/books/handbook/book.adoc
index 306ad325bc..d687fa02e0 100644
--- a/documentation/content/ru/books/handbook/book.adoc
+++ b/documentation/content/ru/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: Руководство FreeBSD
 authors:
   - author: Проект Документации FreeBSD
 copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$" 
 trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"] 
 ---
 
@@ -12,54 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
 :toc: macro
 :toclevels: 2
 :icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :sectnums:
 :sectnumlevels: 6
 :partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
 :book: true
 :pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
 
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:chapters-path: content/ru/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
 endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 endif::[]
 
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
 
 [.abstract-title]
@@ -74,87 +54,87 @@ toc::[]
 
 :sectnums!:
 
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
 
 :sectnums:
 
 // Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
 
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..26;36..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
 
 // Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
 
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
 
 // Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
 
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
 
 // Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
 
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
 
 // Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
 
 :sectnums!:
 
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
 
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
 
 :sectnums:
diff --git a/documentation/content/ru/books/handbook/boot/_index.adoc b/documentation/content/ru/books/handbook/boot/_index.adoc
index bd26d1a2d9..d762459194 100644
--- a/documentation/content/ru/books/handbook/boot/_index.adoc
+++ b/documentation/content/ru/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[boot-synopsis]]
 == Описание
diff --git a/documentation/content/ru/books/handbook/bsdinstall/_index.adoc b/documentation/content/ru/books/handbook/bsdinstall/_index.adoc
index c9792dffef..988fb67cb7 100644
--- a/documentation/content/ru/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/ru/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[bsdinstall-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/config/_index.adoc b/documentation/content/ru/books/handbook/config/_index.adoc
index c407a483f1..343c8754a9 100644
--- a/documentation/content/ru/books/handbook/config/_index.adoc
+++ b/documentation/content/ru/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/config/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/config/
-endif::[]
+:images-path: books/handbook/config/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/config/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[config-synopsis]]
 == Введение
@@ -304,7 +302,7 @@ HOME=/var/log
 
 [IMPORTANT]
 ====
-Вы не должны использовать процедуру, описанную здесь, для установки системного crontab. Просто используйте свой любимый текстовый редактор: утилита `cron` узнает о том, что файл изменился и сразу начнет использовать обновленную версию. Обратитесь к link:{faq}#ROOT-NOT-FOUND-CRON-ERRORS[этой части FAQ] за дальнейшей информацией.
+Вы не должны использовать процедуру, описанную здесь, для установки системного crontab. Просто используйте свой любимый текстовый редактор: утилита `cron` узнает о том, что файл изменился и сразу начнет использовать обновленную версию. Обратитесь к extref:{faq}[этой части FAQ, ROOT-NOT-FOUND-CRON-ERRORS] за дальнейшей информацией.
 ====
 
 Для установки готового [.filename]#crontab# пользователя, сначала создайте в вашем любимом редакторе файл соответствующего формата, а затем воспользуйтесь утилитой `crontab`. Обычно она запускается так:
diff --git a/documentation/content/ru/books/handbook/cutting-edge/_index.adoc b/documentation/content/ru/books/handbook/cutting-edge/_index.adoc
index ed8e4b9dec..e69e4e27df 100644
--- a/documentation/content/ru/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/ru/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[updating-upgrading-synopsis]]
 == Краткий обзор
@@ -388,7 +386,7 @@ before running "/usr/sbin/freebsd-update install"
 
 В этом разделе описывается, как использовать исходный текст или Коллекцию Портов FreeBSD для организации актуальной локальной копии документации FreeBSD.
 
-За информацией о редактировании и отправке изменений для документации обращайтесь к FreeBSD Documentation Project Primer for New Contributors (link:{fdp-primer}[FreeBSD Documentation Project Primer]).
+За информацией о редактировании и отправке изменений для документации обращайтесь к FreeBSD Documentation Project Primer for New Contributors (extref:{fdp-primer}[FreeBSD Documentation Project Primer]).
 
 [[updating-installed-documentation]]
 === Обновление документации из исходного кода
diff --git a/documentation/content/ru/books/handbook/desktop/_index.adoc b/documentation/content/ru/books/handbook/desktop/_index.adoc
index 944f7d8a09..6835d78603 100644
--- a/documentation/content/ru/books/handbook/desktop/_index.adoc
+++ b/documentation/content/ru/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[desktop-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/disks/_index.adoc b/documentation/content/ru/books/handbook/disks/_index.adoc
index 08a870808e..46d6f6129b 100644
--- a/documentation/content/ru/books/handbook/disks/_index.adoc
+++ b/documentation/content/ru/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[disks-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/eresources/_index.adoc b/documentation/content/ru/books/handbook/eresources/_index.adoc
index e542e6e826..7c259b633a 100644
--- a/documentation/content/ru/books/handbook/eresources/_index.adoc
+++ b/documentation/content/ru/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
 [[eresources]]
 = Ресурсы в интернет
 :doctype: book
+:toc: macro
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Высокая скорость прогресса FreeBSD делает непрактичным использование печатных изданий для информирования о последних разработках. Электронные ресурсы это лучший, а зачастую и единственный способ информирования о новых возможностях. Поскольку FreeBSD основывается на усилиях добровольцев, сообщество пользователей само по себе зачастую выполняет роль "службы технической поддержки", а электронная почта, веб форумы и новости USENET это наиболее эффективный способ обращения к этому сообществу.
 
@@ -53,9 +66,9 @@ include::shared/ru/urls.adoc[]
 _Если вы желаете проверить возможность отправки сообщений в списки рассылки FreeBSD, пошлите тестовое сообщение на {freebsd-test}._ Пожалуйста, не шлите тестовые сообщения в любой другой список рассылки.
 ====
 
-Если вы сомневаетесь, в какой именно список рассылки нужно направить вопрос, то прочтите статью link:{freebsd-questions-article}[Как эффективно использовать список рассылки FreeBSD-questions].
+Если вы сомневаетесь, в какой именно список рассылки нужно направить вопрос, то прочтите статью extref:{freebsd-questions-article}[Как эффективно использовать список рассылки FreeBSD-questions].
 
-Перед тем, как направлять сообщение в любой список рассылки, пожалуйста, выясните, как лучше всего их использовать, например, как избежать частого повторения одних и тех же дискуссий, прочитав документ link:{mailing-list-faq}[Часто задаваемые вопросы о списках рассылки] (FAQ).
+Перед тем, как направлять сообщение в любой список рассылки, пожалуйста, выясните, как лучше всего их использовать, например, как избежать частого повторения одних и тех же дискуссий, прочитав документ extref:{mailing-list-faq}[Часто задаваемые вопросы о списках рассылки] (FAQ).
 
 Архивы поддерживаются для всех списков рассылки и поиск по ним организован на link:https://www.FreeBSD.org/ru/search/[WWW сервере FreeBSD]. Поиск в архиве по ключевым словам дает отличный способ получения ответов на часто задаваемые вопросы и должен быть выполнен перед отправкой вопроса. Следует также отметить то, что отправленные в списки рассылок сообщения сохраняются в архивах навсегда. Если есть необходимость сохранить приватность, то задействуйте любой доступный вам второстепенный адрес электронной почты, предоставляя в сообщении лишь публичную информацию.
 
diff --git a/documentation/content/ru/books/handbook/filesystems/_index.adoc b/documentation/content/ru/books/handbook/filesystems/_index.adoc
index a4dbb0283e..732d7dcfb1 100644
--- a/documentation/content/ru/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/ru/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[filesystems-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/firewalls/_index.adoc b/documentation/content/ru/books/handbook/firewalls/_index.adoc
index a1807e4eb2..d7ec9d8c1d 100644
--- a/documentation/content/ru/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/ru/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[firewalls-intro]]
 == Введение
diff --git a/documentation/content/ru/books/handbook/geom/_index.adoc b/documentation/content/ru/books/handbook/geom/_index.adoc
index 632cc9b3ea..b06bf0b2fa 100644
--- a/documentation/content/ru/books/handbook/geom/_index.adoc
+++ b/documentation/content/ru/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[GEOM-synopsis]]
 == Краткий обзор
@@ -561,4 +559,4 @@ options	GEOM_JOURNAL
 
 Для увеличения производительности может потребоваться хранение журнала на отдельном диске. В таких случаях необходимо указать имя поставщика журнала или устройства хранения после имени устройства, на котором планируется включение журналирования. Журналирование также может быть активировано утилитой `tunefs` на действующих файловых системах; однако, всегда создавайте резервную копию перед попытками изменить настройки файловой системы. В большинстве случаев, выполнение команды `gjournal` завершится ошибкой, если создание журнала невозможно, в то время как некорректное использование команды `tunefs` не защитит против потери данных.
 
-Также возможно журналирование загрузочного диска системы FreeBSD. За детальными инструкциями по этой возможности обратитесь к статье link:{gjournal-desktop}[Настройка журналирования UFS для настольного компьютера].
+Также возможно журналирование загрузочного диска системы FreeBSD. За детальными инструкциями по этой возможности обратитесь к статье extref:{gjournal-desktop}[Настройка журналирования UFS для настольного компьютера].
diff --git a/documentation/content/ru/books/handbook/install/_index.adoc b/documentation/content/ru/books/handbook/install/_index.adoc
index 4ef12b4b14..30ea7ec96c 100644
--- a/documentation/content/ru/books/handbook/install/_index.adoc
+++ b/documentation/content/ru/books/handbook/install/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/bsdinstall
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[install-synopsis]]
 == Краткий обзор
@@ -2324,7 +2322,7 @@ ISO образы для каждого релиза могут быть загр
 
 [NOTE]
 ====
-Если вы интересуетесь созданием собственных вариантов релизов FreeBSD, пожалуйста, прочтите статью о link:{releng}[Процессе подготовки релизов].
+Если вы интересуетесь созданием собственных вариантов релизов FreeBSD, пожалуйста, прочтите статью о extref:{releng}[Процессе подготовки релизов].
 ====
 
 [[install-ftp]]
@@ -2438,7 +2436,7 @@ C:\> xcopy e:\manpages c:\freebsd\manpages\ /s
 
 Если вы используете модем, PPP это конечно почти единственный выбор. Убедитесь что у вас есть информация о провайдере, так как она понадобится на довольно ранней стадии процесса установки.
 
-Если вы используете PAP или CHAP для соединения с провайдером (другими словами, вы можете соединяться с провайдером из Windows(R) без использования скрипта), все что вам понадобится это ввести `dial` в приглашении ppp. Иначе вам нужно знать, как дозвониться до провайдера с помощью "AT команд", специфичных для вашего модема, так как программа дозвона PPP предоставляет только очень простой эмулятор терминала. Обратитесь к crossref:ppp-and-slip[userppp,руководству] user-ppp и link:{faq}#ppp/[FAQ] для получения более подробных сведений. Если у вас проблемы, логи могут быть выведены на экран с помощью команды `set log local ...`.
+Если вы используете PAP или CHAP для соединения с провайдером (другими словами, вы можете соединяться с провайдером из Windows(R) без использования скрипта), все что вам понадобится это ввести `dial` в приглашении ppp. Иначе вам нужно знать, как дозвониться до провайдера с помощью "AT команд", специфичных для вашего модема, так как программа дозвона PPP предоставляет только очень простой эмулятор терминала. Обратитесь к crossref:ppp-and-slip[userppp,руководству] user-ppp и extref:{faq}[FAQ, ppp] для получения более подробных сведений. Если у вас проблемы, логи могут быть выведены на экран с помощью команды `set log local ...`.
 
 Если доступно постоянное соединение с другой машиной FreeBSD, вы можете также подумать об установке через параллельный порт "laplink" кабелем. Скорость соединения через параллельный порт значительно выше, чем обычно возможно через последовательную линию (до 50 кбайт/с), это приведет к ускорению установки.
 
diff --git a/documentation/content/ru/books/handbook/introduction/_index.adoc b/documentation/content/ru/books/handbook/introduction/_index.adoc
index 01bfb6462f..3ebb52bf4f 100644
--- a/documentation/content/ru/books/handbook/introduction/_index.adoc
+++ b/documentation/content/ru/books/handbook/introduction/_index.adoc
@@ -13,25 +13,35 @@ next: books/handbook/install
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
 
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[introduction-synopsis]]
 == Краткий обзор
@@ -49,7 +59,7 @@ toc::[]
 [[nutshell]]
 == Добро пожаловать во FreeBSD!
 
-FreeBSD - это основанная на 4.4BSD-Lite операционная система для компьютеров Intel (x86 и Itanium(R)), AMD64, Alpha(TM) и Sun UltraSPARC(R). Ведется работа по портированию и на другие архитектуры. Вы можете также прочесть об <<history,истории FreeBSD>>, или о <<relnotes,текущем релизе>>. Если вы заинтересованы в помощи проекту (кодом, аппаратным обеспечением, деньгами), прочтите статью link:{contributing}[Помощь FreeBSD].
+FreeBSD - это основанная на 4.4BSD-Lite операционная система для компьютеров Intel (x86 и Itanium(R)), AMD64, Alpha(TM) и Sun UltraSPARC(R). Ведется работа по портированию и на другие архитектуры. Вы можете также прочесть об <<history,истории FreeBSD>>, или о <<relnotes,текущем релизе>>. Если вы заинтересованы в помощи проекту (кодом, аппаратным обеспечением, деньгами), прочтите статью extref:{contributing}[Помощь FreeBSD].
 
 === Что может FreeBSD?
 
@@ -161,7 +171,7 @@ FreeBSD 2.2 была ответвлена от основной линии ра�
 [[development]]
 === Модель Разработки FreeBSD
 
-Разработка FreeBSD - это очень открытый и гибкий процесс. FreeBSD в буквальном смысле создана из кода, предоставленного сотнями людей со всего мира, в чем вы можете убедится, взглянув на link:{contributors}[список этих людей]. Инфраструктура разработки FreeBSD позволяет этим сотням разработчиков сотрудничать с помощью Интернета. Мы постоянно ищем новых разработчиков и новые идеи, и те, кто заинтересован в более тесном взаимодействии и хочет принять участие в проекте, должны просто связаться с нами в рассылке link:{freebsd-hackers-url}[freebsd-hackers]. Для тех, кто желает уведомить других пользователей FreeBSD об основных направлениях работы, доступен {freebsd-announce}.
+Разработка FreeBSD - это очень открытый и гибкий процесс. FreeBSD в буквальном смысле создана из кода, предоставленного сотнями людей со всего мира, в чем вы можете убедится, взглянув на extref:{contributors}[список этих людей]. Инфраструктура разработки FreeBSD позволяет этим сотням разработчиков сотрудничать с помощью Интернета. Мы постоянно ищем новых разработчиков и новые идеи, и те, кто заинтересован в более тесном взаимодействии и хочет принять участие в проекте, должны просто связаться с нами в рассылке link:{freebsd-hackers-url}[freebsd-hackers]. Для тех, кто желает уведомить других пользователей FreeBSD об основных направлениях работы, доступен {freebsd-announce}.
 
 Для независимой работы или тесного сотрудничества, полезно знать о проекте и процессе разработки FreeBSD следующее:
 
@@ -174,7 +184,7 @@ _Коммиттеры_ - это люди, которые имеют доступ
 Core-группа FreeBSD [[development-core]]::
 _Core-группа FreeBSD_ могла бы быть эквивалентом Совета Директоров, если бы Проект FreeBSD был компанией. Главная задача Core-группы - гарантировать, что проект в целом в хорошем состоянии и движется в правильном направлении. Приглашение постоянных и ответственных разработчиков присоединиться к группе коммиттеров - одна из функций Core-группы, так же, как и приглашение новых членов в Core-группу по мере того, как другие уходят. Нынешний состав команды был выбран из рядов коммиттеров путем общего голосования в июле 2006 года. Выборы проходят каждые 2 года. 
 +
-Некоторые члены Core-группы имеют особые области ответственности, то есть, они являются ответственными за работу отдельной большой части системы. Полный список разработчиков FreeBSD и областей их ответственности можно найти в link:{contributors}[Списке участников].
+Некоторые члены Core-группы имеют особые области ответственности, то есть, они являются ответственными за работу отдельной большой части системы. Полный список разработчиков FreeBSD и областей их ответственности можно найти в extref:{contributors}[Списке участников].
 +
 [NOTE]
 ====
@@ -184,7 +194,7 @@ _Core-группа FreeBSD_ могла бы быть эквивалентом С
 Внешняя помощь::
 Последней, но однозначно не менее значимой, и наибольшей группой разработчиков являются сами пользователи, которые предоставляют комментарии и исправления ошибок нам на почти постоянной основе. Основной путь участвовать в не централизованной разработке - это подписка на {freebsd-hackers}, где обсуждаются подобные вещи. Обратитесь к crossref:eresources[eresources, Ресурсы в интернет] за дальнейшей информацией о различных списках рассылки FreeBSD.
 +
-link:{contributors}[Список участников проекта FreeBSD] очень длинный и постоянно растет, так почему бы вам не присоединится к нему, предоставив что-нибудь проекту FreeBSD сегодня?
+extref:{contributors}[Список участников проекта FreeBSD] очень длинный и постоянно растет, так почему бы вам не присоединится к нему, предоставив что-нибудь проекту FreeBSD сегодня?
 +
 Предоставление кода - не единственный способ помочь проекту; более полный список того, что необходимо сделать, можно найти на link:https://www.FreeBSD.org/ru/[Web-сайте проекта FreeBSD].
 
diff --git a/documentation/content/ru/books/handbook/kernelconfig/_index.adoc b/documentation/content/ru/books/handbook/kernelconfig/_index.adoc
index 1fbf8a622d..990e719811 100644
--- a/documentation/content/ru/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/ru/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[kernelconfig-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/l10n/_index.adoc b/documentation/content/ru/books/handbook/l10n/_index.adoc
index 342a19e653..eb05bbd4fc 100644
--- a/documentation/content/ru/books/handbook/l10n/_index.adoc
+++ b/documentation/content/ru/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[l10n-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/linuxemu/_index.adoc b/documentation/content/ru/books/handbook/linuxemu/_index.adoc
index be1c1717f3..13d23674a8 100644
--- a/documentation/content/ru/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/ru/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[linuxemu-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/mac/_index.adoc b/documentation/content/ru/books/handbook/mac/_index.adoc
index e871bb056e..e05b95c9b2 100644
--- a/documentation/content/ru/books/handbook/mac/_index.adoc
+++ b/documentation/content/ru/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[mac-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/mail/_index.adoc b/documentation/content/ru/books/handbook/mail/_index.adoc
index 46d6b069c2..2864b6f20d 100644
--- a/documentation/content/ru/books/handbook/mail/_index.adoc
+++ b/documentation/content/ru/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[mail-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/mirrors/_index.adoc b/documentation/content/ru/books/handbook/mirrors/_index.adoc
index 90a160b7cd..eb38c487ed 100644
--- a/documentation/content/ru/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/ru/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
 [[mirrors]]
 = Получение FreeBSD
 :doctype: book
+:toc: macro
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[mirrors-cdrom]]
 == Наборы CD и DVD
diff --git a/documentation/content/ru/books/handbook/multimedia/_index.adoc b/documentation/content/ru/books/handbook/multimedia/_index.adoc
index acde2e23d4..e9b78574b2 100644
--- a/documentation/content/ru/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/ru/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[multimedia-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/network-servers/_index.adoc b/documentation/content/ru/books/handbook/network-servers/_index.adoc
index eed8b3510d..6a50f45f47 100644
--- a/documentation/content/ru/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/ru/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[network-servers-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/parti.adoc b/documentation/content/ru/books/handbook/parti.adoc
index e3f0b633fb..18e1c4bcb5 100644
--- a/documentation/content/ru/books/handbook/parti.adoc
+++ b/documentation/content/ru/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
 next: books/handbook/introduction
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[getting-started]]
 = В начале
 
@@ -17,4 +25,4 @@ next: books/handbook/introduction
 
 Мы попытались сократить множество ссылок в тексте до минимума для того, чтоб вы могли прочитать этот раздел Руководства с начала до конца с минимумом перелистываний страниц.
 
-include::content/ru/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/ru/books/handbook/partii.adoc b/documentation/content/ru/books/handbook/partii.adoc
index 12e5e9e1cc..ca91c03bb5 100644
--- a/documentation/content/ru/books/handbook/partii.adoc
+++ b/documentation/content/ru/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
 next: books/handbook/desktop
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[common-tasks]]
 = Общие задачи
 
@@ -17,4 +25,4 @@ next: books/handbook/desktop
 
 Перед прочтением некоторых из этих глав необходимо ознакомиться с предварительной информацией, что указано в кратком обзоре в начале каждой главы.
 
-include::content/ru/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/ru/books/handbook/partiii.adoc b/documentation/content/ru/books/handbook/partiii.adoc
index fb2f658e28..708ae66408 100644
--- a/documentation/content/ru/books/handbook/partiii.adoc
+++ b/documentation/content/ru/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
 next: books/handbook/config
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[system-administration]]
 = Системное администрирование
 
@@ -11,4 +19,4 @@ next: books/handbook/config
 
 Эти главы спланированы так, что вы можете прочитать их когда вам нужно узнать какую-либо информацию. Вам не нужно читать их в определенном порядке, и не нужно прочитать их все перед тем, как начать пользоваться FreeBSD.
 
-include::content/ru/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/ru/books/handbook/partiv.adoc b/documentation/content/ru/books/handbook/partiv.adoc
index 32323a2268..a30715de4a 100644
--- a/documentation/content/ru/books/handbook/partiv.adoc
+++ b/documentation/content/ru/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/cutting-edge
 next: books/handbook/serialcomms
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[network-communication]]
 = Сетевые коммуникации
 
@@ -18,4 +26,4 @@ FreeBSD это одна из наиболее широко используем�
 
 Эти главы предназначены для получения дополнительной информации. Нет необходимости читать их в определенной последовательности, или читать их все перед тем, как начать использовать FreeBSD в сети.
 
-include::content/ru/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/ru/books/handbook/partv.adoc b/documentation/content/ru/books/handbook/partv.adoc
index 28dbdc2163..26d460f7f6 100644
--- a/documentation/content/ru/books/handbook/partv.adoc
+++ b/documentation/content/ru/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
 next: books/handbook/mirrors
 ---
 
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
 [[appendices]]
 = Приложения
 
-include::content/ru/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/ru/books/handbook/pgpkeys/_index.adoc b/documentation/content/ru/books/handbook/pgpkeys/_index.adoc
index 9b85e25682..0ebbe4b851 100644
--- a/documentation/content/ru/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/ru/books/handbook/pgpkeys/_index.adoc
@@ -9,28 +9,44 @@ next: books/handbook/freebsd-glossary
 [[pgpkeys]]
 = PGP ключи
 :doctype: book
+:toc: macro
+:toclevels: 1
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
 
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
 
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 
 В случае, если вам нужно проверить подпись или послать зашифрованное электронное письмо одному из офицеров или разработчиков, то для вашего удобства здесь представлено некоторое количество ключей. Полный список ключей пользователей `FreeBSD.org` доступен для скачивания с link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
 
diff --git a/documentation/content/ru/books/handbook/ports/_index.adoc b/documentation/content/ru/books/handbook/ports/_index.adoc
index a201ecc246..8821c85bd7 100644
--- a/documentation/content/ru/books/handbook/ports/_index.adoc
+++ b/documentation/content/ru/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[ports-synopsis]]
 == Обзор
@@ -663,7 +661,7 @@ Portsnap это быстрый и удобный инструмент для п�
 ====
 *Procedure: Метод Subversion*
 
-Если необходим контроль за деревом портов (например, для поддержания локальных изменений), то для получения Коллекции Портов может быть задействован Subversion. Обратитесь к link:{committers-guide}#subversion-primer/[Subversion Primer] за детальным описанием Subversion.
+Если необходим контроль за деревом портов (например, для поддержания локальных изменений), то для получения Коллекции Портов может быть задействован Subversion. Обратитесь к extref:{committers-guide}[Subversion Primer, subversion-primer] за детальным описанием Subversion.
 
 . Для создания рабочей копии дерева портов необходимо иметь установленный Subversion. Если порты есть в наличии, то установите Subversion выполнив следующее:
 +
@@ -687,7 +685,7 @@ Portsnap это быстрый и удобный инструмент для п�
 # pkg install subversion
 ....
 +
-. Создайте рабочую копию дерева портов. Для ускорения процесса вместо _svn0.us-east.FreeBSD.org_ укажите ближайшее к вам crossref:mirrors[svn-mirrors,зеркало Subversion]. Коммиттерам необходимо сначала прочитать link:{committers-guide}#subversion-primer/[Subversion Primer], чтобы удостовериться, что выбран корректный протокол.
+. Создайте рабочую копию дерева портов. Для ускорения процесса вместо _svn0.us-east.FreeBSD.org_ укажите ближайшее к вам crossref:mirrors[svn-mirrors,зеркало Subversion]. Коммиттерам необходимо сначала прочитать extref:{committers-guide}[Subversion Primer, subversion-primer], чтобы удостовериться, что выбран корректный протокол.
 +
 [source,shell]
 ....
@@ -795,7 +793,7 @@ Portsnap это быстрый и удобный инструмент для п�
 * [.filename]#pkg-descr#: этот файл содержит более подробное описание программы.
 * [.filename]#pkg-plist#: это список всех файлов, которые будут установлены портом. В нем также содержатся указания системе портов на удаление определенных файлов во время удаления порта.
 
-В некоторых портах присутствуют и другие файлы, такие, как [.filename]#pkg-message#. Система портов использует эти файлы для обработки особых ситуаций. Если вы хотите узнать более подробно об этих файлах и о портах вообще, то обратитесь к link:{porters-handbook}[Руководству по созданию портов для FreeBSD].
+В некоторых портах присутствуют и другие файлы, такие, как [.filename]#pkg-message#. Система портов использует эти файлы для обработки особых ситуаций. Если вы хотите узнать более подробно об этих файлах и о портах вообще, то обратитесь к extref:{porters-handbook}[Руководству по созданию портов для FreeBSD].
 
 Порт не содержит собственно исходного кода, также известного как "дистрибутивный файл" (distfile). Способ распространения исходного кода определяется предпочтениями автора программы. Ниже описаны два способа установки порта FreeBSD.
 
@@ -1171,11 +1169,11 @@ Portmaster делит порты на четыре категории:
 +
 [NOTE]
 ====
-Некоторые порты поддерживаются группой людей из link:{mailing-list-faq}[списка рассылки], а не отдельными людьми. В большинстве таких случаев адрес мейнтейнера выглядит подобно следующему: mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Пожалуйста, учтите это при формулировании ваших вопросов.
+Некоторые порты поддерживаются группой людей из extref:{mailing-list-faq}[списка рассылки], а не отдельными людьми. В большинстве таких случаев адрес мейнтейнера выглядит подобно следующему: mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Пожалуйста, учтите это при формулировании ваших вопросов.
 
 В частности, если мейнтейнер порта - mailto:ports@FreeBSD.org[ports@FreeBSD.org], то такой порт вообще никем не поддерживается. Решение проблем и поддержка, если и имеют место, то приходят от общества, которое подписано на тот список рассылки. Волонтёры требуются всегда!
 ====
 + 
-Если вы не получили ответ, то воспользуйтесь командой man:send-pr[1] для посылки сообщения о проблеме (изучите link:{problem-reports}[составление сообщений о проблеме во FreeBSD]).
-. Исправьте его! В link:{porters-handbook}[Руководстве по созданию портов] содержится подробная информация об инфраструктуре портов, так что вы сможете исправить редкий неработающий порт или даже предложить свой собственный!
+Если вы не получили ответ, то воспользуйтесь командой man:send-pr[1] для посылки сообщения о проблеме (изучите extref:{problem-reports}[составление сообщений о проблеме во FreeBSD]).
+. Исправьте его! В extref:{porters-handbook}[Руководстве по созданию портов] содержится подробная информация об инфраструктуре портов, так что вы сможете исправить редкий неработающий порт или даже предложить свой собственный!
 . Воспользуйтесь man:pkg_add[1] и установите пакет вместо порта.
diff --git a/documentation/content/ru/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/ru/books/handbook/ppp-and-slip/_index.adoc
index 514273ab34..f9497cb803 100644
--- a/documentation/content/ru/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/ru/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[ppp-and-slip-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/preface/_index.adoc b/documentation/content/ru/books/handbook/preface/_index.adoc
index a85343fe94..7dc28183ba 100644
--- a/documentation/content/ru/books/handbook/preface/_index.adoc
+++ b/documentation/content/ru/books/handbook/preface/_index.adoc
@@ -11,17 +11,33 @@ next: books/handbook/parti
 :toc: macro
 :toclevels: 1
 :icons: font
-:sectnums!:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+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-audience]]
 == Целевая аудитория
diff --git a/documentation/content/ru/books/handbook/printing/_index.adoc b/documentation/content/ru/books/handbook/printing/_index.adoc
index 05ebe2ceda..bdcfd51a9f 100644
--- a/documentation/content/ru/books/handbook/printing/_index.adoc
+++ b/documentation/content/ru/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[printing-synopsis]]
 == Краткий обзор
diff --git a/documentation/content/ru/books/handbook/security/_index.adoc b/documentation/content/ru/books/handbook/security/_index.adoc
index 7dd23310d5..0d89a1c6f5 100644
--- a/documentation/content/ru/books/handbook/security/_index.adoc
+++ b/documentation/content/ru/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[security-synopsis]]
 == Краткое описание
diff --git a/documentation/content/ru/books/handbook/serialcomms/_index.adoc b/documentation/content/ru/books/handbook/serialcomms/_index.adoc
index 6d411132e8..a58042a338 100644
--- a/documentation/content/ru/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/ru/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[serial-synopsis]]
 == Краткое описание
@@ -1126,7 +1124,7 @@ FreeBSD может загружаться при использовании в �
 Включает поддержку консоли на устройстве (если нет другой консоли с более высоким приоритетом), независимо от наличия описываемой ниже опции `-h`. Флаг `0x20` должен использоваться вместе с флагом `0x10`.
 
 `0x40`:::
-Резервирует это устройство (совместно с флагом `0x10`) и делает устройство недоступным для обычной работы. Вы не должны использовать этот флаг для устройства последовательного порта, которое будет использоваться в качестве последовательной консоли. Используйте этот флаг только если устройство предназначено для удаленной отладки ядра. Обратитесь к link:{developers-handbook}[Руководству для разработчиков] за дополнительной информацией по удаленной отладке.
+Резервирует это устройство (совместно с флагом `0x10`) и делает устройство недоступным для обычной работы. Вы не должны использовать этот флаг для устройства последовательного порта, которое будет использоваться в качестве последовательной консоли. Используйте этот флаг только если устройство предназначено для удаленной отладки ядра. Обратитесь к extref:{developers-handbook}[Руководству для разработчиков] за дополнительной информацией по удаленной отладке.
 + 
 Пример:
 +
diff --git a/documentation/content/ru/books/handbook/x11/_index.adoc b/documentation/content/ru/books/handbook/x11/_index.adoc
index 69b5ed898c..72279770e7 100644
--- a/documentation/content/ru/books/handbook/x11/_index.adoc
+++ b/documentation/content/ru/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
 
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[x11-synopsis]]
 == Обзор
diff --git a/documentation/content/ru/books/porters-handbook/_index.adoc b/documentation/content/ru/books/porters-handbook/_index.adoc
index 4469e6ad49..1b6f7d092c 100644
--- a/documentation/content/ru/books/porters-handbook/_index.adoc
+++ b/documentation/content/ru/books/porters-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: Руководство FreeBSD по созданию портов
 authors: 
   - author: The FreeBSD Documentation Project
 copyright: 2000-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$" 
-trademarks: ["freebsd", "sun", "unix", "general"] 
+trademarks: ["freebsd", "sun", "unix", "general"]
+isIndex: true
 ---
 
 = Руководство FreeBSD по созданию портов
@@ -12,51 +12,34 @@ trademarks: ["freebsd", "sun", "unix", "general"]
 :toc: macro
 :toclevels: 2
 :icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :sectnums:
 :sectnumlevels: 6
 :partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:book: true
+:pdf: false
 
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:chapters-path: content/ru/books/porters-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
 endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 endif::[]
 
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
 :chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
 endif::[]
 
 '''
@@ -67,19 +50,19 @@ include::{chapters-path}toc-tables.adoc[]
 
 include::{chapters-path}toc-examples.adoc[]
 
-include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}new-port/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1, lines=7..25;36..-1]
-include::{chapters-path}special/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}plist/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}security/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}uses/chapter.adoc[leveloffset=+1, lines=7..25;36..-1]
-include::{chapters-path}versions/chapter.adoc[leveloffset=+1, lines=6..23;34..-1]
+include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1]
+include::{chapters-path}new-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1]
+include::{chapters-path}special/chapter.adoc[leveloffset=+1]
+include::{chapters-path}plist/chapter.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
+include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1]
+include::{chapters-path}security/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1]
+include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1]
+include::{chapters-path}uses/chapter.adoc[leveloffset=+1]
+include::{chapters-path}versions/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc
index b01dc6c3e1..8a69b0487e 100644
--- a/documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/uses
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Коллекция Портов FreeBSD постоянно изменяется. Здесь находится некоторая информация о том, как поддерживать её в актуальном состоянии.
 
diff --git a/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc b/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc
index 546ce1a2fb..721539ccb6 100644
--- a/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc
@@ -11,27 +11,37 @@ next: books/porters-handbook/special
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :gcc-plus-plus: g++
-:sectnumoffset: 5
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Настройка файла [.filename]#Makefile# достаточно проста, и мы снова предполагаем, что перед тем, как начать, вы посмотрите на существующие примеры. К тому же в этом руководстве имеется <<porting-samplem,примерный Makefile>>, так что взгляните на него и, пожалуйста, следуйте порядку переменных и разделов в этом образце, чтобы облегчить чтение вашего порта другими людьми.
 
@@ -691,7 +701,7 @@ PORTEPOCH=	1
 
 В соответствие с существующей практикой мы избегаем создания новой физической категории, пока достаточно большое число портов логически ей не принадлежит или же порты, которые могли бы ей принадлежать, не являются логически обособленной группой, представляющей для всех ограниченный интерес (в частности, категории, относящиеся к естественным языкам); предпочтительно выполнение обоих условий.
 
-Основной причиной для этого является то, что такое изменение создает link:{committers-guide}#ports[изрядное количество работы] и для коммиттеров, и для всех тех пользователей, которые отслеживают изменения в Коллекции Портов. В дополнение, предложенная категория создает естественное разногласие. (Пожалуй, потому что не существует четкого соглашения, является ли категория "слишком большой", или должны ли категории предоставлять себя для просмотра (и, таким образом, какое количество категорий было бы идеальным значением), и так далее.)
+Основной причиной для этого является то, что такое изменение создает extref:{committers-guide}[изрядное количество работы, ports] и для коммиттеров, и для всех тех пользователей, которые отслеживают изменения в Коллекции Портов. В дополнение, предложенная категория создает естественное разногласие. (Пожалуй, потому что не существует четкого соглашения, является ли категория "слишком большой", или должны ли категории предоставлять себя для просмотра (и, таким образом, какое количество категорий было бы идеальным значением), и так далее.)
 
 Процедура:
 
@@ -707,7 +717,7 @@ PORTEPOCH=	1
 ** (в дополнение, вы можете включить другие файлы, требующие изменений, согласно процедуре из Руководства Коммиттера.)
 
 . Поскольку это затрагивает инфраструктуру портов и охватывает не только выполнение репозиторного копирования, но также, возможно, и выполнение регрессивных тестов на кластере построения, то PR должна назначать себе {portmgr}.
-. Если этот PR одобрен, то коммиттеру нужно продолжить остальную часть процедуры, которая link:{committers-guide}#PORTS[изложена в Руководстве Коммиттера].
+. Если этот PR одобрен, то коммиттеру нужно продолжить остальную часть процедуры, которая extref:{committers-guide}[изложена в Руководстве Коммиттера, ports].
 ====
 
 Предложение новой виртуальной категории должно быть схожим с вышеизложенным, но при этом затрагивать намного меньше, поскольку ни один из портов не будет перемещен в действительности. В этом случае единственными патчами, включенными в PR, будут те, что добавляют новую категорию в `CATEGORIES` каждого из затрагиваемых портов.
@@ -1211,7 +1221,7 @@ ALWAYS_KEEP_DISTFILES=	yes
 
 Заметьте, что в качестве значения для `MAINTAINER` допустимо использование только одного адреса без поля комментария. Должен использоваться формат `user@hostname.domain`. Пожалуйста, не включайте никакого описательного текста, например, вашего настоящего имени в эту строку-это несколько сбивает с толку [.filename]#bsd.port.mk#.
 
-Сопровождающий ответственен за поддержание порта в актуальном состоянии и обеспечение правильной работы порта. За подробным описанием обязанностей сопровождающего порт обращайтесь к главе link:{contributing}#maintain-port/[The challenge for port maintainers].
+Сопровождающий ответственен за поддержание порта в актуальном состоянии и обеспечение правильной работы порта. За подробным описанием обязанностей сопровождающего порт обращайтесь к главе extref:{contributing}[The challenge for port maintainers, maintain-port].
 
 Перед фиксацией в репозитории изменения в порте будут отправлены сопровождающему для просмотра и одобрения. Если сопровождающий порта не ответил на запрос пользователя об обновлении в течение двух недель (исключая большие праздники), то это можно считать тайм-аутом сопровождающего, и обновление может быть выполнено без явного подтверждения от сопровождающего. Если сопровождающий не отвечает в течение трёх месяцев, то считается, что он отсутствует, и как сопровождающий порта, о котором идёт речь, может быть заменён. Исключениями из этого правила является всё, что сопровождает {portmgr} или {security-officer}. Запрещено делать любые несанкционированные изменения в портах, которые ведут эти группы.
 
diff --git a/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc b/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc
index 316d15a4f6..43b61bce99 100644
--- a/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/quick-porting
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Итак, вы интересуетесь, как создать собственный порт или обновить существующий? Великолепно!
 
diff --git a/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc
index d24b172a7d..5f98929394 100644
--- a/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/testing
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Есть несколько приёмов работы с файлами [.filename]#pkg-*#, которые мы ещё не описали, но они иногда могут быть очень кстати.
 
diff --git a/documentation/content/ru/books/porters-handbook/plist/chapter.adoc b/documentation/content/ru/books/porters-handbook/plist/chapter.adoc
index 86369ed7cb..db57d34ca3 100644
--- a/documentation/content/ru/books/porters-handbook/plist/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/plist/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/pkg-files
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[plist-sub]]
 == Изменение содержимого [.filename]#pkg-plist# в зависимости от make-переменных
diff --git a/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc
index d9e73bd5b7..1960a211a4 100644
--- a/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc
@@ -11,38 +11,48 @@ next: books/porters-handbook/porting-samplem
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :freebsd-version: __FreeBSD_version
 :freebsd: __FreeBSD__
-:sectnumoffset: 12
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[dads-intro]]
 == Введение
 
-Вот список часто встречающихся действий, которые нужно и которые нельзя делать во время процесса портирования. Проверьте порт по этому списку, и также проверьте порты в http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[базе сообщений PR], которые присланы другими людьми. Присылайте любые комментарии о портах, которые вы проверили, так, как это описано в статье о link:{contributing}#CONTRIB-GENERAL[ Сообщениях об ошибках и общих замечаниях]. Проверка портов в базе сообщений PR позволит нам быстрее коммиттить их и удостовериться, что вы знаете, что делаете.
+Вот список часто встречающихся действий, которые нужно и которые нельзя делать во время процесса портирования. Проверьте порт по этому списку, и также проверьте порты в http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[базе сообщений PR], которые присланы другими людьми. Присылайте любые комментарии о портах, которые вы проверили, так, как это описано в статье о extref:{contributing}[Сообщениях об ошибках и общих замечаниях, CONTRIB-GENERAL]. Проверка портов в базе сообщений PR позволит нам быстрее коммиттить их и удостовериться, что вы знаете, что делаете.
 
 [[porting-wrkdir]]
 == `WRKDIR`
 
-Не пишите ничего в файлы вне каталога `WRKDIR`. Каталог `WRKDIR` является единственным местом, которое гарантированно будет доступно для записи во время построения порта (обратитесь к главе об link:{handbook}#PORTS-CD[установке портов с CDROM] за примером построения портов из дерева, доступного только для чтения). Если вам нужно изменить какой-либо из файлов [.filename]##pkg-*##, сделайте это, <<porting-pkgfiles,переопределив переменную>>, но не перезаписывая их.
+Не пишите ничего в файлы вне каталога `WRKDIR`. Каталог `WRKDIR` является единственным местом, которое гарантированно будет доступно для записи во время построения порта (обратитесь к главе об extref:{handbook}ports[установке портов с CDROM, PORTS-CD] за примером построения портов из дерева, доступного только для чтения). Если вам нужно изменить какой-либо из файлов [.filename]##pkg-*##, сделайте это, <<porting-pkgfiles,переопределив переменную>>, но не перезаписывая их.
 
 [[porting-wrkdirprefix]]
 == `WRKDIRPREFIX`
diff --git a/documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc
index d6c984a099..62b7c06914 100644
--- a/documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/keeping-up
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Вот примерный [.filename]#Makefile#, который можно использовать при создании нового порта. Обязательно удалите все дополнительные комментарии (те, которые в скобках)!
 
diff --git a/documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc b/documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc
index 3826351cc4..ad292b3d14 100644
--- a/documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/new-port
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Коллекция портов FreeBSD является способом, используемым практически каждым для установки приложений ("портов") на FreeBSD. Как и почти всё остальное во FreeBSD, эта система в основном является добровольно поддерживаемым начинанием. Важно иметь это в виду при чтении данного документа.
 
diff --git a/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc
index 820f5cc187..87e1275c42 100644
--- a/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/slow-porting
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 В этом разделе описано, как создать новый порт на скорую руку. Во многих случаях этого бывает не достаточно, так что вам нужно будет прочитать документ дальше.
 
@@ -217,7 +227,7 @@ PLIST_DIRS=	lib/X11/oneko
 
 Затем получите файл man:shar[1]. Предполагая, что порт называется oneko, перейдите в каталог выше, где находится каталог `oneko`, и наберите: `shar find oneko > oneko.shar`
 
-Включите [.filename]#oneko.shar# в сообщение об ошибке и пошлите его с помощью man:send-pr[1]. Обратитесь к разделу link:{contributing}#CONTRIB-GENERAL[Сообщения об ошибках и общие замечания] для получения подробной информации о man:send-pr[1]).
+Включите [.filename]#oneko.shar# в сообщение об ошибке и пошлите его с помощью man:send-pr[1]. Обратитесь к разделу extref:{contributing}[Сообщения об ошибках и общие замечания, CONTRIB-GENERAL] для получения подробной информации о man:send-pr[1]).
 
 Укажите в сообщении категорию `ports` и класс `change-request`. _Не_ указывайте, что сообщение имеет статус `confidential`! Добавьте краткое описание программы в поле "Description" отправляемого PR (например, содержимое `COMMENT` в сокращённом варианте) и сам файл в виде архива [.filename]#.shar# в поле "Fix".
 
@@ -230,4 +240,4 @@ PLIST_DIRS=	lib/X11/oneko
 
 После отправки порта, пожалуйста, потерпите. Время, необходимое для включения нового порта во FreeBSD, может занимать от нескольких дней до нескольких месяцев. http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports[ Здесь] можно увидеть список ожидающих PR для портов.
 
-После рассмотрения нового порта мы при необходимости вам ответим, а затем включим порт в наше дерево. Ваше имя также будет добавлено в список link:{contributors}#contrib-additional/[Дополнительных контрибуторов проекта FreeBSD] и другие файлы.
+После рассмотрения нового порта мы при необходимости вам ответим, а затем включим порт в наше дерево. Ваше имя также будет добавлено в список extref:{contributors}[Дополнительных контрибуторов проекта FreeBSD, contrib-additional] и другие файлы.
diff --git a/documentation/content/ru/books/porters-handbook/security/chapter.adoc b/documentation/content/ru/books/porters-handbook/security/chapter.adoc
index bb78f84cf1..a9b6e5a63f 100644
--- a/documentation/content/ru/books/porters-handbook/security/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/security/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/porting-dads
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[security-intro]]
 == Почему безопасность так важна
diff --git a/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc b/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc
index d0baaf0906..1d7cbc61e7 100644
--- a/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/makefiles
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Итак, все оказалось не так уж и просто, и порт потребовал некоторых модификаций для того, чтобы заставить его работать. В этом разделе мы расскажем, шаг за шагом, как его модифицировать, чтобы он работал с нашей системой портов.
 
diff --git a/documentation/content/ru/books/porters-handbook/special/chapter.adoc b/documentation/content/ru/books/porters-handbook/special/chapter.adoc
index 88ea8112df..c46eb9a002 100644
--- a/documentation/content/ru/books/porters-handbook/special/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/special/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/plist
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Имеется ещё несколько вещей, которые вы должны иметь в виду при создании порта. Этот раздел описывает наиболее часто встречающиеся из них.
 
@@ -2381,7 +2391,7 @@ USE_XFCE=	mcsmanager configenv
 [[rc-scripts]]
 == Запуск и остановка служб (сценарии `rc`)
 
-Сценарии [.filename]#rc.d# используются для запуска служб при запуске системы и дают администратору стандартный способ остановки, запуска и перезапуска службы. Порты интегрируются в системную инфраструктуру [.filename]#rc.d#. Подробности по её использованию можно найти в link:{handbook}#configtuning-rcd/[главе rc.d Руководства]. Подробное объяснение доступных команд находится в man:rc[8] и man:rc.subr[8]. Наконец, есть link:{rc-scripting}[статья]о практических аспектах написания сценариев [.filename]#rc.d#.
+Сценарии [.filename]#rc.d# используются для запуска служб при запуске системы и дают администратору стандартный способ остановки, запуска и перезапуска службы. Порты интегрируются в системную инфраструктуру [.filename]#rc.d#. Подробности по её использованию можно найти в extref:{handbook}config-tuning/[главе rc.d Руководства, configtuning-rcd]. Подробное объяснение доступных команд находится в man:rc[8] и man:rc.subr[8]. Наконец, есть extref:{rc-scripting}[статья]о практических аспектах написания сценариев [.filename]#rc.d#.
 
 Установить можно один или более сценариев [.filename]#rc.d#:
 
diff --git a/documentation/content/ru/books/porters-handbook/testing/chapter.adoc b/documentation/content/ru/books/porters-handbook/testing/chapter.adoc
index 76a490ef8c..98b7c82e1f 100644
--- a/documentation/content/ru/books/porters-handbook/testing/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/testing/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/upgrading
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[make-describe]]
 == Запуск `make describe`
diff --git a/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc b/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc
index 4efbe63a5a..8996df3362 100644
--- a/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc
@@ -11,28 +11,38 @@ next: books/porters-handbook/security
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
-Если вы заметите, что ваш порт устарел по сравнению с последней авторской версией, первым делом вы должны получить самую последнюю версия порта. Вы можете найти их в каталоге [.filename]#ports/ports-current# на зеркальных FTP-серверах FreeBSD. Однако если вы работаете с достаточно большим количеством портов, наверное, будет проще использовать Subversion или man:portsnap[8] для поддержания всей коллекции портов в актуальном состоянии, как это описано в link:{handbook}#ports-using/[Руководстве]. К тому же это даст возможность отслеживать все зависимости портов.
+Если вы заметите, что ваш порт устарел по сравнению с последней авторской версией, первым делом вы должны получить самую последнюю версия порта. Вы можете найти их в каталоге [.filename]#ports/ports-current# на зеркальных FTP-серверах FreeBSD. Однако если вы работаете с достаточно большим количеством портов, наверное, будет проще использовать Subversion или man:portsnap[8] для поддержания всей коллекции портов в актуальном состоянии, как это описано в extref:{handbook}ports/[Руководстве, ports-using]. К тому же это даст возможность отслеживать все зависимости портов.
 
 На следующем шаге необходимо выяснить, нет ожидает ли уже это обновление своей очереди. Для этого у вас есть две возможности. Существует интерфейс к http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[базе данных сообщений о проблемах FreeBSD (PR)] (известной также как `GNATS`) с поисковыми возможностями. Выберите из выпадающего списка `ports` и введите название порта.
 
@@ -53,11 +63,11 @@ toc::[]
 
 Для упрощения повторяющихся операций с файлами заплаток вы можете воспользоваться скриптом [.filename]#/usr/ports/Tools/scripts/patchtool.py#. Перед тем, как его запускать, пожалуйста, прочтите [.filename]#/usr/ports/Tools/scripts/README.patchtool#.
 
-Если порт никем не поддерживается, а вы активно его используете, пожалуйста, подумайте над тем, чтобы добровольно стать его сопровождающим. Во FreeBSD имеется более 4000 портов без поддержки, и это как раз та область, где всегда нужны добровольцы. (Детальное описание обязанностей сопровождающего можно найти в разделе link:{developers-handbook}#POLICIES-MAINTAINER[Руководства Разработчика].)
+Если порт никем не поддерживается, а вы активно его используете, пожалуйста, подумайте над тем, чтобы добровольно стать его сопровождающим. Во FreeBSD имеется более 4000 портов без поддержки, и это как раз та область, где всегда нужны добровольцы. (Детальное описание обязанностей сопровождающего можно найти в разделе extref:{developers-handbook}[Руководства Разработчика, POLICIES-MAINTAINER].)
 
 Лучше всего послать нам diff-файл, включив его в посылку по команде man:send-pr[1] (категория `ports`). Если вы сопровождаете порт, обязательно поместите текст `[maintainer update]` в начале строки описания и задайте в поле "Class" вашего PR строчку `maintainer-update`. В противном случае в поле "Class" вашего PR должно быть указано `change-request`. Будьте добры, в сообщении отметьте все добавленные или удалённые файлы, так как они будут непосредственно указаны man:svn[1] при выполнении операции коммита. Если diff-файл имеет размер, превышающий 20КБ, сожмите его и обработайте утилитой uuencode; в противном случае просто включите его как есть в PR.
 
-Прежде чем пользоваться man:send-pr[1] просмотрите раздел о link:{problem-reports}#pr-writing/[Написании сообщений о проблемах] в статье о Сообщениях об ошибках. Он содержит гораздо больше информации о том, как писать полезные сообщения о проблемах.
+Прежде чем пользоваться man:send-pr[1] просмотрите раздел о extref:{problem-reports}[Написании сообщений о проблемах, pr-writing] в статье о Сообщениях об ошибках. Он содержит гораздо больше информации о том, как писать полезные сообщения о проблемах.
 
 [IMPORTANT]
 ====
@@ -85,7 +95,7 @@ toc::[]
 
 <.> Это может быть где угодно; место, в котором производится построение портов, не привязано к [.filename]#/usr/ports/#.
 
-<.> https://svn0.us-west.FreeBSD.org/[svn0.us-west.FreeBSD.org] - это общедоступный сервер Subversion. Выберите ближайшее зеркало и проверьте сертификат зеркалирующего сервера на наличие в перечне link:{handbook}#svn-mirrors/[зеркалирующих сайтов Subversion].
+<.> https://svn0.us-west.FreeBSD.org/[svn0.us-west.FreeBSD.org] - это общедоступный сервер Subversion. Выберите ближайшее зеркало и проверьте сертификат зеркалирующего сервера на наличие в перечне extref:{handbook}mirrors/[зеркалирующих сайтов Subversion, svn-mirrors].
 
 Находясь в рабочем каталоге, вносите любые изменения, которые обычно делают для порта. При добавлении или удалении файла используйте `svn` для отслеживания этих изменений:
 
diff --git a/documentation/content/ru/books/porters-handbook/uses/chapter.adoc b/documentation/content/ru/books/porters-handbook/uses/chapter.adoc
index fa5d32de3f..2862084668 100644
--- a/documentation/content/ru/books/porters-handbook/uses/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/uses/chapter.adoc
@@ -11,27 +11,37 @@ next: books/porters-handbook/versions
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
 :c-plus-plus: c++
-:sectnumoffset: 15
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 [[uses-intro]]
 == An Introduction to `USES`
diff --git a/documentation/content/ru/books/porters-handbook/versions/chapter.adoc b/documentation/content/ru/books/porters-handbook/versions/chapter.adoc
index f9234dac57..5878273db8 100644
--- a/documentation/content/ru/books/porters-handbook/versions/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/versions/chapter.adoc
@@ -10,26 +10,36 @@ prev: books/porters-handbook/uses
 :toclevels: 1
 :icons: font
 :sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
+:images-path: books/porters-handbook/
 
-include::shared/mirrors.adoc[]
+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/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.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::[]
 
 Here is a convenient list of `__FreeBSD_version` values as defined in http://svnweb.FreeBSD.org/base/head/sys/sys/param.h?view=markup[sys/param.h]:
author	Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>	2021-11-03 16:39:08 +0000
committer	Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>	2021-11-03 16:44:52 +0000
commit	64acd169b82416fe39ad8c4b1be106680d4a3eb3 (patch)
tree	05b8bc3182dc4cfcf0a8a0964b4303903a4abf56 /documentation/content/ru/books
parent	0636d709faeb6b7d1a44882ae33a02015d32774b (diff)
download	doc-64acd169b82416fe39ad8c4b1be106680d4a3eb3.tar.gz doc-64acd169b82416fe39ad8c4b1be106680d4a3eb3.zip