D58805.id.diff
No OneTemporary
Actions

Size

320 KB

Referenced Files

None

Subscribers

None

D58805.id.diff
View Options

This file is larger than 256 KB, so syntax highlighting was skipped.

	diff --git a/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.adoc b/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.adoc
	--- a/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.adoc
	+++ b/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.adoc
	@@ -249,6 +249,17 @@
	Не используйте макрос `xref` или его сокращение `<<` `>>`. Они не работают хорошо во всех выходных форматах.
	====

	+[IMPORTANT]
	+====
	+Когда второй параметр макроса `crossref` содержит запятую, он должен быть заключен в двойные кавычки. В противном случае запятая интерпретируется как разделитель параметров, и текст после запятой отбрасывается.
	+
	+Для примера:
	+....
	+crossref:plist[documentation-comma, "First, second"]
	+....
	+Без кавычек в качестве текста ссылки использовалось бы только слово `First`, а остальная часть была бы потеряна.
	+====
	+
	[[asciidoctor-images-icons]]
	== Изображения и иконки

	diff --git a/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.po b/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.po
	--- a/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.po
	+++ b/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.po
	@@ -5,8 +5,8 @@
	msgid ""
	msgstr ""
	"Project-Id-Version: FreeBSD Documentation VERSION\n"
	-"POT-Creation-Date: 2025-11-08 16:17+0000\n"
	-"PO-Revision-Date: 2026-03-05 04:45+0000\n"
	+"POT-Creation-Date: 2026-08-06 22:55+0100\n"
	+"PO-Revision-Date: 2026-08-08 08:11+0000\n"
	"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
	"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
	"documentation/booksfdp-primerasciidoctor-primer_index/ru/>\n"
	@@ -37,7 +37,7 @@
	msgstr "Основы Asciidoctor"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:55
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:54
	msgid ""
	"Most FDP documentation is written with AsciiDoc. This chapter explains what "
	"that means, how to read and understand the documentation source, and the "
	@@ -57,13 +57,13 @@
	"AsciiDoc]."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:57
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:56
	#, no-wrap
	msgid "Overview"
	msgstr "Обзор"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:63
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:62
	msgid ""
	"In the original days of computers, electronic text was simple. There were a "
	"few character sets like ASCII or EBCDIC, but that was about it. Text was "
	@@ -76,7 +76,7 @@
	"получали. Никаких изысков, никакого форматирования, никакого интеллекта."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:68
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:67
	msgid ""
	"Inevitably, this was not enough. When text is in a machine-usable format, "
	"machines are expected to be able to use and manipulate it intelligently. "
	@@ -94,7 +94,7 @@
	"из множества вариантов представления."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:72
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:71
	msgid ""
	"It was once hoped that Artificial Intelligence (AI) would make this easy. "
	"The computer would read the document and automatically identify key phrases, "
	@@ -110,7 +110,7 @@
	"текст."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:75
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:74
	msgid ""
	"More precisely, they need help identifying what is what. Consider this text:"
	msgstr ""
	@@ -118,18 +118,18 @@
	"текст:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:77
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:76
	msgid "To remove [.filename]#/tmp/foo#, use man:rm[1]."
	msgstr "Для удаления [.filename]#/tmp/foo# используйте man:rm[1]."

	#. type: delimited block - 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:81
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:80
	#, no-wrap
	msgid "% rm /tmp/foo\n"
	msgstr "% rm /tmp/foo\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:86
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:85
	msgid ""
	"It is easy for the reader to see which parts are filenames, which are "
	"commands to be typed in, which parts are references to manual pages, and so "
	@@ -142,20 +142,20 @@
	"Для этого нам нужна разметка."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:88
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:87
	msgid ""
	"The previous example is actually represented in this document like this:"
	msgstr ""
	"Предыдущий пример фактически представлен в этом документе следующим образом:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:91
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:90
	#, no-wrap
	msgid "To remove /tmp/foo, use man:rm[1].\n"
	msgstr "To remove /tmp/foo, use man:rm[1].\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:96
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:95
	#, no-wrap
	msgid ""
	"[source,shell]\n"
	@@ -169,13 +169,13 @@
	"----\n"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:99
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:98
	#, no-wrap
	msgid "Headings"
	msgstr "Заголовки"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:104
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:103
	msgid ""
	"Asciidoctor supports six headings levels. If the document type is `article` "
	"only one level 0 (`=`) can be used. If the document type is `book` then "
	@@ -186,87 +186,87 @@
	"тип документа `book`, то может быть несколько заголовков уровня 0 (`=`)."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:106
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:105
	msgid "This is an example of headings in an `article`."
	msgstr "Вот пример заголовков в документе типа `article`."

	#. type: Title =
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:108
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:107
	#, no-wrap
	msgid "Document Title (Level 0)"
	msgstr "Заголовок документа (Уровень 0)"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:110
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:109
	#, no-wrap
	msgid "Level 1 Section Title"
	msgstr "Заголовок раздела на уровне 1"

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:112
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:111
	#, no-wrap
	msgid "Level 2 Section Title"
	msgstr "Заголовок раздела на уровне 2"

	#. type: Title ====
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:114
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:113
	#, no-wrap
	msgid "Level 3 Section Title"
	msgstr "Заголовок раздела на уровне 3"

	#. type: Title =====
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:116
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:115
	#, no-wrap
	msgid "Level 4 Section Title"
	msgstr "Заголовок раздела на уровне 4"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:119
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:118
	msgid "====== Level 5 Section Title"
	msgstr "====== Заголовок раздела на уровне 5"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:120
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:119
	#, no-wrap
	msgid "Another Level 1 Section Title"
	msgstr "Другой заголовок раздела на уровне 1"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:126
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:125
	msgid "Section levels cannot be skipped when nesting sections."
	msgstr "Уровни разделов нельзя пропускать при вложении разделов."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:128
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:127
	msgid "The following syntax is not correct."
	msgstr "Следующий синтаксис неверен."

	#. type: Title =
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:130
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:129
	#, no-wrap
	msgid "Document Title"
	msgstr "Заголовок документа"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:132
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:131
	#, no-wrap
	msgid "Level 1"
	msgstr "Уровень 1"

	#. type: Title ====
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:134
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:133
	#, no-wrap
	msgid "Level 3"
	msgstr "Уровень 3"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:139
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:138
	#, no-wrap
	msgid "Paragraphs"
	msgstr "Абзацы"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:144
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:143
	msgid ""
	"Paragraphs don't require special markup in AsciiDoc. A paragraph is defined "
	"by one or more consecutive lines of text. To create a new paragraph leave "
	@@ -277,34 +277,34 @@
	"абзац, оставьте одну пустую строку."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:146
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:145
	msgid "For example, this is a heading with two paragraphs."
	msgstr "Например, это заголовок с двумя абзацами."

	#. type: Title =
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:148
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:147
	#, no-wrap
	msgid "This is the heading"
	msgstr "Это заголовок"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:152
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:151
	msgid "This is the first paragraph. This is also the first paragraph."
	msgstr "Это первый абзац. Это тоже первый абзац."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:154
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:153
	msgid "And this is the second paragraph."
	msgstr "А это второй абзац."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:157
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:156
	#, no-wrap
	msgid "Lists"
	msgstr "Списки"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:161
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:160
	msgid ""
	"Asciidoctor supports a few types of lists, the most common are `ordered` and "
	"`unordered`. To get more information about lists, see link:https://docs."
	@@ -317,23 +317,23 @@
	"reference/#lists[AsciiDoc Syntax Quick Reference]."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:163
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:162
	#, no-wrap
	msgid "Ordered lists"
	msgstr "Упорядоченные списки"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:166
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:165
	msgid "To create an ordered list use the `.` character."
	msgstr "Для создания нумерованного списка используйте символ `.`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:168
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:167
	msgid "For example, this is an ordered list."
	msgstr "Например, это нумерованный список."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:174
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:173
	#, no-wrap
	msgid ""
	". First item\n"
	@@ -347,54 +347,54 @@
	". Третий пункт\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:177
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:198
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:241
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:176
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:197
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:240
	msgid "And this would be rendered as."
	msgstr "И это будет отображено как."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:179
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:200
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:178
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:199
	msgid "First item"
	msgstr "Первый пункт"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:180
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:201
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:179
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:200
	msgid "Second item"
	msgstr "Второй пункт"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:181
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:202
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:180
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:201
	msgid "Subsecond item"
	msgstr "Подпункт второго пункта"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:182
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:203
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:181
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:202
	msgid "Third item"
	msgstr "Третий пункт"

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:184
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:183
	#, no-wrap
	msgid "Unordered lists"
	msgstr "Неупорядоченные списки"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:187
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:186
	msgid "To create an unordered list use the `*` character."
	msgstr "Для создания маркированного списка используйте символ `*`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:189
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:188
	msgid "For example, this is an unordered list."
	msgstr "Например, это ненумерованный список."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:195
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:194
	#, no-wrap
	msgid ""
	"* First item\n"
	@@ -408,30 +408,30 @@
	"* Третий пункт\n"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:205
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:204
	#, no-wrap
	msgid "Links"
	msgstr "Ссылки"

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:208
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:207
	#, no-wrap
	msgid "External links"
	msgstr "Внешние ссылки"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:211
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:210
	msgid "To point to another website the `link` macro should be used."
	msgstr "Чтобы указать на другой веб-сайт, следует использовать макрос `link`."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:214
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:213
	#, no-wrap
	msgid "link:https://www.FreeBSD.org[FreeBSD]\n"
	msgstr "link:https://www.FreeBSD.org[FreeBSD]\n"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:220
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:219
	msgid ""
	"As the Asciidoctor documentation describes, the `link` macro is not required "
	"when the target starts with a URL scheme like `https`. However, it is a "
	@@ -445,13 +445,13 @@
	"как японский."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:223
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:222
	#, no-wrap
	msgid "Links to another book or article"
	msgstr "Ссылки на другую книгу или статью"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:227
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:226
	msgid ""
	"To point to another book or article the Asciidoctor variables should be "
	"used. For example, if we are in the `cups` article and we want to point to "
	@@ -462,7 +462,7 @@
	"на `ipsec-must`, необходимо выполнить следующие шаги."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:229
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:228
	msgid ""
	"Include the [.filename]#urls.adoc# file from [.filename]#~/doc/shared# "
	"folder."
	@@ -470,13 +470,13 @@
	"Включите файл [.filename]#urls.adoc# из папки [.filename]#~/doc/shared#."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:232
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:231
	#, no-wrap
	msgid "\\include::shared/{lang}/urls.adoc[]\n"
	msgstr "\\include::shared/{lang}/urls.adoc[]\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:235
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:234
	msgid ""
	"Then create a link using the Asciidoctor variable to the `ipsec-must` "
	"article."
	@@ -485,18 +485,18 @@
	"`ipsec-must`."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:238
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:237
	#, no-wrap
	msgid "extref:{ipsec-must}[IPSec-Must article]\n"
	msgstr "extref:{ipsec-must}[Статья IPSec-Must]\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:243
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:242
	msgid "extref:{ipsec-must}[IPSec-Must article]"
	msgstr "extref:{ipsec-must}[Статья IPSec-Must]"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:248
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:247
	msgid ""
	"The `extref` macro is defined as an extension. It is designed to render the "
	"correct link across the different outputs"
	@@ -505,13 +505,13 @@
	"отображения ссылки в различных выходных форматах"

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:250
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:249
	#, no-wrap
	msgid "Links to the same file or to another file in the same book"
	msgstr "Ссылки на тот же файл или на другой файл в той же книге"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:255
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:254
	msgid ""
	"Books are structured in different directories to keep a sane layout. To "
	"create a link from one subdirectory of a book to another subdirectory of the "
	@@ -522,23 +522,23 @@
	"подкаталог той же книги, используйте макрос `crossref`:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:257
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:256
	#, no-wrap
	msgid "crossref:doc-build[documentation-makefile, This link]\n"
	msgstr "crossref:doc-build[documentation-makefile, Эта ссылка]\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:259
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:258
	msgid "And this would be rendered as"
	msgstr "И это будет отображено как"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:261
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:260
	msgid "crossref:doc-build[documentation-makefile, This link]"
	msgstr "crossref:doc-build[documentation-makefile, Эта ссылка]"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:266
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:265
	msgid ""
	"The `crossref` macro is defined as an extension. It is designed to render "
	"the correct link across the different outputs"
	@@ -547,7 +547,7 @@
	"формирования корректной ссылки в различных выходных форматах"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:273
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:272
	msgid ""
	"Use the `crossref` macro for intra-document links too. Although it might be "
	"inconvenient to write the name of the current document, it ensures the "
	@@ -558,7 +558,7 @@
	"отображение ссылки в различных выходных форматах"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:279
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:278
	msgid ""
	"Do not use either the `xref` macro or its shortcut `<<` `>>`. They do not "
	"work well in all output formats."
	@@ -566,14 +566,45 @@
	"Не используйте макрос `xref` или его сокращение `<<` `>>`. Они не работают "
	"хорошо во всех выходных форматах."

	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:284
	+msgid ""
	+"When the second parameter of the `crossref` macro contains a comma, it must "
	+"be enclosed in double quotes. Otherwise, the comma is interpreted as a "
	+"parameter separator, and the text after the comma is stripped."
	+msgstr ""
	+"Когда второй параметр макроса `crossref` содержит запятую, он должен быть "
	+"заключен в двойные кавычки. В противном случае запятая интерпретируется как "
	+"разделитель параметров, и текст после запятой отбрасывается."
	+
	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:286
	+msgid "For example:"
	+msgstr "Для примера:"
	+
	+#. type: delimited block . 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:288
	+#, no-wrap
	+msgid "crossref:plist[documentation-comma, \"First, second\"]\n"
	+msgstr "crossref:plist[documentation-comma, \"First, second\"]\n"
	+
	+#. type: Plain text
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:290
	+msgid ""
	+"Without quotes, only `First` would be used as the link text, and the rest "
	+"would be lost."
	+msgstr ""
	+"Без кавычек в качестве текста ссылки использовалось бы только слово `First`, "
	+"а остальная часть была бы потеряна."
	+
	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:282
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:293
	#, no-wrap
	msgid "Images and Icons"
	msgstr "Изображения и иконки"

	-#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:286
	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:297
	msgid ""
	"Images and icons play a crucial role in enhancing the overall user "
	"experience. These visual elements are strategically integrated to convey "
	@@ -585,13 +616,13 @@
	"визуально привлекательного интерфейса."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:288
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:299
	#, no-wrap
	msgid "Images"
	msgstr "Изображения"

	-#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:291
	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:302
	msgid ""
	"Images help illustrate complex concepts, making them more accessible to "
	"users."
	@@ -599,24 +630,24 @@
	"Изображения помогают проиллюстрировать сложные концепции, делая их более "
	"понятными для пользователей."

	-#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:293
	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:304
	msgid ""
	"The first step will be to add the image in the images directory in the path:"
	msgstr "Первым шагом будет добавление изображения в каталог `images` по пути:"

	-#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:295
	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:306
	msgid "[.filename]#~/website/static/images/# for the website."
	msgstr "[.filename]#~/website/static/images/# для веб-сайта."

	-#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:296
	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:307
	msgid "[.filename]#~/documentation/static/images/# for the documentation."
	msgstr "[.filename]#~/documentation/static/images/# для документации."

	-#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:298
	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:309
	msgid ""
	"For example, to add a new image to the FreeBSD installation process, the "
	"image will be saved to the path [.filename]#~/documentation/static/images/"
	@@ -626,8 +657,8 @@
	"изображение сохраняется по пути [.filename]#~/documentation/static/images/"
	"books/handbook/bsdinstall/new-image3.png#."

	-#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:300
	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:311
	msgid ""
	"The next step will be to configure the Asciidoctor attributes `images-path` "
	"and `imagesdir`."
	@@ -635,8 +666,8 @@
	"Следующим шагом будет настройка атрибутов Asciidoctor `images-path` и "
	"`imagesdir`."

	-#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:302
	+#. type: delimited block = 4
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:313
	msgid ""
	"We are going to use as an example the header of the extref:{freebsd-releng}"
	"[FreeBSD Release Engineering] article."
	@@ -645,45 +676,45 @@
	"[Подготовка релизов FreeBSD]."

	#. type: Title =
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:305
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:316
	#, no-wrap
	msgid "FreeBSD Release Engineering"
	msgstr "Подготовка релизов FreeBSD"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:307
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:318
	msgid ":doctype: article"
	msgstr ":doctype: article"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:309
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:313
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:317
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:320
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:324
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:328
	msgid "[...]"
	msgstr "[...]"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:311
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:322
	msgid ":images-path: articles/freebsd-releng/ <1>"
	msgstr ":images-path: articles/freebsd-releng/ <1>"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:315
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:326
	msgid ":imagesdir: ../../../images/{images-path} <2>"
	msgstr ":imagesdir: ../../../images/{images-path} <2>"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:321
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:332
	msgid "Makes reference to the path inside [.filename]#/static/images# folder."
	msgstr "Ссылается на путь внутри папки [.filename]#/static/images#."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:322
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:333
	msgid "Makes reference to the Asciidoctor attribute."
	msgstr "Делает ссылку на атрибут Asciidoctor."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:324
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:335
	msgid ""
	"Once the image is in the correct path and the Asciidoctor attributes have "
	"been configured in the document, the `image` macro can be used."
	@@ -692,18 +723,18 @@
	"настроены в документе, можно использовать макрос `image`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:326
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:337
	msgid "This is an example:"
	msgstr "Вот пример:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:329
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:340
	#, no-wrap
	msgid "image::new-image3.png[New step in the FreeBSD install process]\n"
	msgstr "image::new-image3.png[New step in the FreeBSD install process]\n"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:334
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:345
	msgid ""
	"To improve accessibility, it is mandatory to add descriptive text to each "
	"image."
	@@ -712,20 +743,20 @@
	"изображению."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:337
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:348
	#, no-wrap
	msgid "Icons"
	msgstr "Иконки"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:340
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:351
	msgid "Icons serve as intuitive symbols for quick recognition and navigation."
	msgstr ""
	"Иконки служат интуитивно понятными символами для быстрого распознавания и "
	"навигации."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:342
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:353
	msgid ""
	"The first step to use icons is to add the `icons` property to the "
	"Asciidoctor properties section, at the top of each document."
	@@ -734,13 +765,13 @@
	"раздел свойств Asciidoctor в начале каждого документа."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:345
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:356
	#, no-wrap
	msgid ":icons: font\n"
	msgstr ":icons: font\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:348
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:359
	msgid ""
	"Once the Asciidoctor icon property has been set an icon supported by link:"
	"https://fontawesome.com/v4/icons/[Font Awesome] can be added."
	@@ -749,18 +780,18 @@
	"поддерживаемую link:https://fontawesome.com/v4/icons/[Font Awesome]."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:350
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:361
	msgid "This is an example about how to use the `envelope` icon:"
	msgstr "Это пример использования иконки `envelope`:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:353
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:364
	#, no-wrap
	msgid "icon:envelope[link=mailto:test@example.com, title=\"contact\"]\n"
	msgstr "icon:envelope[link=mailto:test@example.com, title=\"contact\"]\n"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:358
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:369
	msgid ""
	"To improve the accessibility of the website, the `title` attribute is "
	"mandatory."
	@@ -768,13 +799,13 @@
	"Для повышения доступности веб-сайта атрибут `title` является обязательным."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:361
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:372
	#, no-wrap
	msgid "Conclusion"
	msgstr "Заключение"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:364
	+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:375
	msgid ""
	"This is the conclusion of this Asciidoctor primer. For reasons of space and "
	"complexity, several things have not been covered in depth (or at all)."
	diff --git a/documentation/content/ru/books/fdp-primer/overview/_index.adoc b/documentation/content/ru/books/fdp-primer/overview/_index.adoc
	--- a/documentation/content/ru/books/fdp-primer/overview/_index.adoc
	+++ b/documentation/content/ru/books/fdp-primer/overview/_index.adoc
	@@ -153,10 +153,12 @@
	[source, shell]
	....
	% git commit
	-% git format-patch origin/main
	+% git format-patch -U999999 origin/main
	....
	+
	-Патч, созданный с помощью `git format-patch`, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
	+Параметр `-U999999` добавляет в файл патча максимальное количество контекста, что делает процесс рецензирования проще.
	++
	+Файл патча, созданный с помощью `git format-patch` в локальном каталоге, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
	+
	[IMPORTANT]
	======
	@@ -165,7 +167,7 @@
	+
	В приведённом выше примере были внесены изменения в раздел bsdinstall Руководства.
	+
	-. Отправьте патч или diff-файл с помощью веб-системы https://bugs.FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Problem Report]. При использовании веб-формы укажите в поле Summary _[patch] краткое описание проблемы_. Выберите Component `Documentation`. В поле Description введите краткое описание изменений и любые важные детали о них. Используйте кнопку btn:[Add an attachment], чтобы прикрепить патч или diff-файл. Наконец, нажмите кнопку btn:[Submit Bug], чтобы отправить ваш diff в систему отчётов об ошибках.
	+. Отправьте патч или diff-файл с помощью веб-системы https://bugs.FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Problem Report]. В поле `Component` выберите ту часть документации, к которой относится изменение. В поле `Summary` введите _краткое описание проблемы_. В поле `Description` введите краткое описание изменений и любые важные детали о них. Используйте кнопку btn:[Add an attachment], чтобы прикрепить патч или diff-файл. Наконец, нажмите кнопку btn:[Submit Bug], чтобы отправить ваш diff в систему отчётов об ошибках.
	====

	[[gnu-linux-installation-process]]
	@@ -177,7 +179,7 @@
	+
	[source, shell]
	....
	-# apt install hugo ruby-asciidoctor ruby-asciidoctor-pdf ruby-rouge git bmake
	+# apt install asciidoctor hugo ruby-asciidoctor-pdf ruby-rouge git bmake
	....
	+
	. Установите локальную рабочую копию документации из репозитория FreeBSD в [.filename]#~/doc# (см. crossref:working-copy[working-copy,Рабочая копия]).
	@@ -211,10 +213,12 @@
	[source, shell]
	....
	% git commit
	-% git format-patch origin/main
	+% git format-patch -U999999 origin/main
	....
	+
	-Патч, созданный с помощью `git format-patch`, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
	+Параметр `-U999999` добавляет в файл патча максимальное количество контекста, что делает процесс рецензирования проще.
	++
	+Файл патча, созданный с помощью `git format-patch` в локальном каталоге, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
	+
	[IMPORTANT]
	======
	@@ -284,10 +288,12 @@
	[source, shell]
	....
	% git commit
	-% git format-patch origin/main
	+% git format-patch -U999999 origin/main
	....
	+
	-Патч, созданный с помощью `git format-patch`, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
	+Параметр `-U999999` добавляет в файл патча максимальное количество контекста, что делает процесс рецензирования проще.
	++
	+Файл патча, созданный с помощью `git format-patch` в локальном каталоге, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
	+
	[IMPORTANT]
	======
	diff --git a/documentation/content/ru/books/fdp-primer/overview/_index.po b/documentation/content/ru/books/fdp-primer/overview/_index.po
	--- a/documentation/content/ru/books/fdp-primer/overview/_index.po
	+++ b/documentation/content/ru/books/fdp-primer/overview/_index.po
	@@ -5,8 +5,8 @@
	msgid ""
	msgstr ""
	"Project-Id-Version: FreeBSD Documentation VERSION\n"
	-"POT-Creation-Date: 2026-03-15 14:20+0300\n"
	-"PO-Revision-Date: 2026-03-05 04:45+0000\n"
	+"POT-Creation-Date: 2026-08-06 22:55+0100\n"
	+"PO-Revision-Date: 2026-08-08 04:45+0000\n"
	"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
	"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
	"documentation/booksfdp-primeroverview_index/ru/>\n"
	@@ -37,7 +37,7 @@
	msgstr "Обзор"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:53
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:52
	msgid ""
	"Welcome to the FreeBSD Documentation Project (FDP). Quality documentation "
	"is crucial to the success of FreeBSD, and we value your contributions very "
	@@ -48,7 +48,7 @@
	"вклад."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:55
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:54
	msgid ""
	"This document describes how the FDP is organized, how to write and submit "
	"documentation, and how to effectively use the available tools."
	@@ -57,7 +57,7 @@
	"документацию, а также как эффективно использовать доступные инструменты."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:58
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:57
	msgid ""
	"Everyone is welcome to contribute to the FDP. Willingness to contribute is "
	"the only membership requirement."
	@@ -66,44 +66,44 @@
	"требование для участия."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:60
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:59
	msgid "This primer shows how to:"
	msgstr "Это руководство показывает, как:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:62
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:61
	msgid "Understand the role of documentation and its place in the ecosystem."
	msgstr "Понять роль документации и её место в экосистеме."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:63
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:62
	msgid "Identify which parts of FreeBSD are maintained by the FDP."
	msgstr "Определите, какие части FreeBSD поддерживаются FDP."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:64
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:63
	msgid "Install the required documentation tools and files."
	msgstr "Установить необходимые инструменты и файлы документации."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:65
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:64
	msgid "Make changes to the documentation."
	msgstr "Внести изменения в документацию."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:66
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:65
	msgid ""
	"Submit changes back for review and inclusion in the FreeBSD documentation."
	msgstr "Представить изменения для проверки и включения в документацию FreeBSD."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:68
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:67
	#, no-wrap
	msgid "Documentation in the FreeBSD Ecosystem"
	msgstr "Документация в экосистеме FreeBSD"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:72
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:71
	msgid ""
	"All documents are for the benefit of their readers, not their writers or "
	"caretakers. They should adapt to the reader and not expect the reader to "
	@@ -114,89 +114,89 @@
	"читатель адаптируется к ним."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:74
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:73
	msgid "Never blame the reader for:"
	msgstr "Никогда не вините читателя за:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:76
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:75
	msgid "being unable to make use of a document easily or at all"
	msgstr "невозможность легко или вообще использовать документ"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:77
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:76
	msgid "finding a document confusing"
	msgstr "если документ показался ему непонятным"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:78
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:77
	msgid "not understanding a document or how to apply it"
	msgstr "непонимание документа или того, как его применить"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:79
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:78
	msgid ""
	"not finding an explicit answer or successfully bridging gaps (or connecting "
	"dots) to reason their way to one"
	msgstr "если он не нашел явный ответ или шаги, чтобы логически прийти к нему"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:81
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:80
	msgid "Instead, acknowledge that the document is:"
	msgstr "Вместо этого подтвердите, что документ:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:83
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:82
	msgid "inaccessible"
	msgstr "недоступный"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:84
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:83
	msgid "confusing"
	msgstr "запутанный"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:85
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:84
	msgid "hard to understand or apply"
	msgstr "трудно понимаемый или применимый"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:86
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:85
	msgid "incomplete"
	msgstr "неполный"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:88
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:87
	msgid "Then, make the document:"
	msgstr "Затем создайте документ:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:90
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:89
	msgid "more accessible"
	msgstr "более доступный"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:91
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:90
	msgid "less confusing"
	msgstr "менее запутанный"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:92
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:91
	msgid "clearer"
	msgstr "более ясный"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:93
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:92
	msgid "more complete"
	msgstr "более полный"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:95
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:94
	msgid "Use the following methods:"
	msgstr "Используйте следующие методы:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:97
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:96
	msgid ""
	"apply link:https://webaim.org/intro/#principles[accessibility best "
	"practices] to correct the problem reported and any similar ones you find"
	@@ -206,30 +206,30 @@
	"обнаружите"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:98
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:97
	msgid "rework or clarify the confusing structure or language"
	msgstr "переработайте или уточните запутанную структуру или язык"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:99
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:98
	msgid "add relevant examples to the part that is hard to understand or apply"
	msgstr ""
	"добавьте соответствующие примеры к части, которая трудна для понимания или "
	"применения"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:100
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:99
	msgid "fill in the gaps or add the missing stepping stones"
	msgstr "заполните пробелы или добавьте недостающие промежуточные этапы"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:102
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:101
	#, no-wrap
	msgid "Quick Start"
	msgstr "Быстрый старт"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:108
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:107
	msgid ""
	"Some preparatory steps must be taken before editing the FreeBSD "
	"documentation. First, subscribe to the {freebsd-doc}. Some team members "
	@@ -244,13 +244,13 @@
	"связанными с документацией."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:110
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:109
	#, no-wrap
	msgid "FreeBSD installation process"
	msgstr "Процесс установки FreeBSD"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:115
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:114
	msgid ""
	"Install these packages. The `docproj` _meta-port_ installs all the "
	"applications required to do useful work with the FreeBSD documentation."
	@@ -259,34 +259,34 @@
	"необходимые для работы с документацией FreeBSD."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:119
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:118
	#, no-wrap
	msgid "# pkg install docproj\n"
	msgstr "# pkg install docproj\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:122
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:196
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:278
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:121
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:202
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:286
	msgid ""
	"Install a local working copy of the documentation from the FreeBSD "
	"repository in [.filename]#~/doc# (see crossref:working-copy[working-copy,The "
	"Working Copy])."
	msgstr ""
	-"Установите локальную рабочую копию документации из репозитория FreeBSD в "
	-"[.filename]#~/doc# (см. crossref:working-copy[working-copy,Рабочая копия])."
	+"Установите локальную рабочую копию документации из репозитория FreeBSD в [."
	+"filename]#~/doc# (см. crossref:working-copy[working-copy,Рабочая копия])."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:126
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:200
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:125
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:206
	#, no-wrap
	msgid "% git clone https://git.FreeBSD.org/doc.git ~/doc\n"
	msgstr "% git clone https://git.FreeBSD.org/doc.git ~/doc\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:129
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:203
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:285
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:128
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:209
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:293
	msgid ""
	"Edit the documentation files that require changes. If a file needs major "
	"changes, consult the mailing list for input."
	@@ -295,7 +295,7 @@
	"нужны значительные изменения, обратитесь за советом в список рассылки."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:132
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:131
	msgid ""
	"Review the output and edit the file to fix any problems shown, then rerun "
	"the command to find any remaining problems. Repeat until all of the errors "
	@@ -306,31 +306,31 @@
	"пока все ошибки не будут устранены."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:134
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:133
	#, no-wrap
	msgid "_Always_ build and review the changes before submitting them. Running `make` in the `documentation` or `website` subdirectories will generate the documentation in HTML format.\n"
	msgstr "_Всегда_ собирайте и проверяйте изменения перед отправкой. Запуск команды `make` в подкаталогах `documentation` или `website` сгенерирует документацию в формате HTML.\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:138
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:137
	#, no-wrap
	msgid "% make\n"
	msgstr "% make\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:141
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:140
	msgid "To reduce compile time, only one language can be compiled:"
	msgstr ""
	"Для сокращения времени компиляции может быть скомпилирован только один язык:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:145
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:144
	#, no-wrap
	msgid "% make DOC_LANG=en\n"
	msgstr "% make DOC_LANG=en\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:148
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:147
	msgid ""
	"The build output is stored in [.filename]#~/doc/documentation/public/en/"
	"articles/# and [.filename]#~/doc/documentation/public/en/books/#."
	@@ -339,7 +339,7 @@
	"articles/# и [.filename]#~/doc/documentation/public/en/books/#."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:150
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:149
	msgid ""
	"Review the build output and ensure the edits are free from typos, layout "
	"problems, or errors. If any errors are found during the build process, edit "
	@@ -352,9 +352,9 @@
	"затем снова запустите команду сборки, пока все ошибки не будут устранены."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:152
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:215
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:296
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:151
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:221
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:304
	msgid ""
	"Add all the files with `git add .`, then review the diff with `git diff`. "
	"For example:"
	@@ -363,9 +363,9 @@
	"помощью `git diff`. Например:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:157
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:220
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:301
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:156
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:226
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:309
	#, no-wrap
	msgid ""
	"% git add .\n"
	@@ -375,9 +375,9 @@
	"% git diff --staged\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:160
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:223
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:304
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:159
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:229
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:312
	msgid ""
	"Make sure that all required files are included, then commit the change to "
	"your local branch and generate a patch with `git format-patch`"
	@@ -386,34 +386,46 @@
	"в вашей локальной ветке и создайте патч с помощью `git format-patch`"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:165
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:228
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:309
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:164
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:234
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:317
	#, no-wrap
	msgid ""
	"% git commit\n"
	-"% git format-patch origin/main\n"
	+"% git format-patch -U999999 origin/main\n"
	msgstr ""
	"% git commit\n"
	-"% git format-patch origin/main\n"
	+"% git format-patch -U999999 origin/main\n"
	+
	+#. type: Plain text
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:167
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:237
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:320
	+msgid ""
	+"The `-U999999` parameter adds as much context to the patch as possible which "
	+"makes reviewing easier."
	+msgstr ""
	+"Параметр `-U999999` добавляет в файл патча максимальное количество "
	+"контекста, что делает процесс рецензирования проще."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:169
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:232
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:313
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:170
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:240
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:323
	msgid ""
	-"Patch generated with `git format-patch` will include author identity and "
	-"email addresses, making it easier for developers to apply (with `git am`) "
	-"and give proper credit."
	+"A patch file is generated as a result of `git format-patch` in the local "
	+"directory which will include author identity and email addresses, making it "
	+"easier for developers to apply (with `git am`) and give proper credit."
	msgstr ""
	-"Патч, созданный с помощью `git format-patch`, будет содержать идентификатор "
	-"автора и адреса электронной почты, что упрощает применение разработчиками (с "
	-"помощью `git am`) и правильное указание авторства."
	+"Файл патча, созданный с помощью `git format-patch` в локальном каталоге, "
	+"будет содержать идентификатор автора и адреса электронной почты, что "
	+"упрощает применение разработчиками (с помощью `git am`) и правильное "
	+"указание авторства."

	#. type: delimited block = 6
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:174
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:237
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:318
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:175
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:245
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:328
	msgid ""
	"To make it easier for committers to apply the patch on their working copy of "
	"the documentation tree, please generate the [.filename]#.diff# from the base "
	@@ -424,7 +436,7 @@
	"вашего дерева документации."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:177
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:178
	msgid ""
	"In the example above, changes have been made to the bsdinstall portion of "
	"the Handbook."
	@@ -433,34 +445,34 @@
	"Руководства."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:179
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:185
	msgid ""
	"Submit the patch or diff file using the web-based https://bugs.FreeBSD.org/"
	-"bugzilla/enter_bug.cgi?product=Documentation[Problem Report] system. If "
	-"using the web form, enter a Summary of _[patch] short description of "
	-"problem_. Select the Component `Documentation`. In the Description field, "
	-"enter a short description of the changes and any important details about "
	-"them. Use the btn:[Add an attachment] button to attach the patch or diff "
	-"file. Finally, use the btn:[Submit Bug] button to submit your diff to the "
	-"problem report system."
	+"bugzilla/enter_bug.cgi?product=Documentation[Problem Report] system. In the "
	+"`Component` field, select the part of documentation the changes belong to. "
	+"In the `Summary` field, enter a _short description of the problem_. In the "
	+"`Description` field, enter a short description of the changes and any "
	+"important details about them. Use the btn:[Add an attachment] button to "
	+"attach the patch or diff file. Finally, use the btn:[Submit Bug] button to "
	+"submit the diff to the Problem Report system."
	msgstr ""
	"Отправьте патч или diff-файл с помощью веб-системы https://bugs.FreeBSD.org/"
	-"bugzilla/enter_bug.cgi?product=Documentation[Problem Report]. При "
	-"использовании веб-формы укажите в поле Summary _[patch] краткое описание "
	-"проблемы_. Выберите Component `Documentation`. В поле Description введите "
	-"краткое описание изменений и любые важные детали о них. Используйте кнопку "
	-"btn:[Add an attachment], чтобы прикрепить патч или diff-файл. Наконец, "
	-"нажмите кнопку btn:[Submit Bug], чтобы отправить ваш diff в систему отчётов "
	-"об ошибках."
	+"bugzilla/enter_bug.cgi?product=Documentation[Problem Report]. В поле "
	+"`Component` выберите ту часть документации, к которой относится изменение. В "
	+"поле `Summary` введите _краткое описание проблемы_. В поле `Description` "
	+"введите краткое описание изменений и любые важные детали о них. Используйте "
	+"кнопку btn:[Add an attachment], чтобы прикрепить патч или diff-файл. "
	+"Наконец, нажмите кнопку btn:[Submit Bug], чтобы отправить ваш diff в систему "
	+"отчётов об ошибках."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:182
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:188
	#, no-wrap
	msgid "GNU/Linux installation process"
	msgstr "Процесс установки GNU/Linux"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:189
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:195
	msgid ""
	"Install these packages in apt-based systems like Debian or Ubuntu. On other "
	"GNU/Linux distributions the package names may change. Consult your "
	@@ -472,14 +484,15 @@
	"дистрибутива."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:193
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:199
	#, no-wrap
	-msgid "# apt install hugo ruby-asciidoctor ruby-asciidoctor-pdf ruby-rouge git bmake\n"
	-msgstr "# apt install hugo ruby-asciidoctor ruby-asciidoctor-pdf ruby-rouge git bmake\n"
	+msgid "# apt install asciidoctor hugo ruby-asciidoctor-pdf ruby-rouge git bmake\n"
	+msgstr ""
	+"# apt install asciidoctor hugo ruby-asciidoctor-pdf ruby-rouge git bmake\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:206
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:288
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:212
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:296
	msgid ""
	"Review the output and edit the files to fix any problems shown, then rerun "
	"the command to find any remaining problems. Repeat until all of the errors "
	@@ -490,8 +503,8 @@
	"Повторяйте, пока все ошибки не будут устранены."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:208
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:290
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:214
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:298
	msgid ""
	"Always build and test the changes before submitting them. Running `bmake` in "
	"the `documentation` or `website` subdirectories will generate the "
	@@ -502,14 +515,14 @@
	"формате HTML."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:212
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:218
	#, no-wrap
	msgid "% bmake run LOCALBASE=/usr\n"
	msgstr "% bmake run LOCALBASE=/usr\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:245
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:326
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:253
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:336
	msgid ""
	"Submit the patch or diff file using the web-based https://bugs.FreeBSD.org/"
	"bugzilla/enter_bug.cgi?product=Documentation[Problem Report] system. If "
	@@ -530,33 +543,33 @@
	"систему отчётов об ошибках."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:248
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:256
	#, no-wrap
	msgid "macOS(R) installation process"
	msgstr "Процесс установки macOS(R)"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:254
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:262
	msgid ""
	-"Install these packages using link:https://brew.sh/[Homebrew] and "
	-"link:https://rubygems.org/[RubyGem]."
	+"Install these packages using link:https://brew.sh/[Homebrew] and link:"
	+"https://rubygems.org/[RubyGem]."
	msgstr ""
	-"Установите эти пакеты с помощью link:https://brew.sh/[Homebrew] и "
	-"link:https://rubygems.org/[RubyGem]."
	+"Установите эти пакеты с помощью link:https://brew.sh/[Homebrew] и link:"
	+"https://rubygems.org/[RubyGem]."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:258
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:266
	#, no-wrap
	msgid "$ brew install hugo ruby git bmake\n"
	msgstr "$ brew install hugo ruby git bmake\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:261
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:269
	msgid "Add Ruby to the Path."
	msgstr "Добавьте Ruby в Path."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:269
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:277
	#, no-wrap
	msgid ""
	"$ echo 'export PATH=\"$(brew --prefix ruby)/bin:$PATH\"' >> ~/.zshrc\n"
	@@ -572,41 +585,41 @@
	"$ source ~/.zshrc\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:271
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:279
	msgid "Install the rouge package using RubyGem."
	msgstr "Установите пакет rouge с помощью RubyGem."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:275
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:283
	#, no-wrap
	msgid "$ sudo gem install rouge asciidoctor asciidoctor-pdf asciidoctor-epub3\n"
	msgstr "$ sudo gem install rouge asciidoctor asciidoctor-pdf asciidoctor-epub3\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:282
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:290
	#, no-wrap
	msgid "$ git clone https://git.FreeBSD.org/doc.git ~/doc\n"
	msgstr "$ git clone https://git.FreeBSD.org/doc.git ~/doc\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:294
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:302
	#, no-wrap
	msgid "$ bmake run USE_RUBYGEMS=YES RUBY_CMD=\"$(brew --prefix ruby)/bin/ruby\" HUGO_CMD=\"$(brew --prefix hugo)/bin/hugo\"\n"
	msgstr "$ bmake run USE_RUBYGEMS=YES RUBY_CMD=\"$(brew --prefix ruby)/bin/ruby\" HUGO_CMD=\"$(brew --prefix hugo)/bin/hugo\"\n"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:329
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:339
	#, no-wrap
	msgid "The FreeBSD Documentation Set"
	msgstr "Набор документации FreeBSD"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:332
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:342
	msgid "The FDP is responsible for four categories of FreeBSD documentation."
	msgstr "FDP отвечает за четыре категории документации FreeBSD."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:334
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:344
	msgid ""
	"_Handbook_: The Handbook is the comprehensive online resource and reference "
	"for FreeBSD users."
	@@ -615,7 +628,7 @@
	"справочник для пользователей FreeBSD."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:335
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:345
	msgid ""
	"_FAQ_: The FAQ uses a short question and answer format to address questions "
	"that are frequently asked on the various mailing lists and forums devoted to "
	@@ -627,7 +640,7 @@
	"подразумевает длинных и развёрнутых ответов."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:336
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:346
	msgid ""
	"_Manual pages_: The English language system manual pages are usually not "
	"written by the FDP, as they are part of the base system. However, the FDP "
	@@ -640,7 +653,7 @@
	"сделать их понятнее или исправить неточности."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:337
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:347
	msgid ""
	"_Web site_: This is the main FreeBSD presence on the web, visible at https://"
	"www.freebsd.org/[https://www.FreeBSD.org/] and many mirrors around the "
	@@ -652,7 +665,7 @@
	"пользователя с FreeBSD."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:340
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:350
	msgid ""
	"Translation teams are responsible for translating the Handbook and web site "
	"into different languages. Manual pages are not translated at present."
	@@ -661,7 +674,7 @@
	"языки. На данный момент руководства (man-страницы) не переводятся."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:342
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:352
	msgid ""
	"Documentation source for the FreeBSD web site, Handbook, and FAQ is "
	"available in the documentation repository at `https://cgit.freebsd.org/doc/`."
	@@ -670,7 +683,7 @@
	"в репозитории документации по адресу `https://cgit.freebsd.org/doc/`."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:344
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:354
	msgid ""
	"Source for manual pages is available in a separate source repository located "
	"at `https://cgit.freebsd.org/src/`."
	@@ -679,7 +692,7 @@
	"расположенном по адресу `https://cgit.freebsd.org/src/`."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:347
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:357
	msgid ""
	"Documentation commit messages are visible with `git log`. Commit messages "
	"are also archived at link:{dev-commits-doc-all}."
	@@ -688,16 +701,16 @@
	"о фиксациях также архивируются по ссылке link:{dev-commits-doc-all}."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:349
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:359
	msgid ""
	-"Web frontends to both of these repositories are available at https://"
	-"cgit.freebsd.org/doc/[] and https://cgit.freebsd.org/src/[]."
	+"Web frontends to both of these repositories are available at https://cgit."
	+"freebsd.org/doc/[] and https://cgit.freebsd.org/src/[]."
	msgstr ""
	-"Веб-интерфейсы для обоих репозиториев доступны по адресам https://"
	-"cgit.freebsd.org/doc/[] и https://cgit.freebsd.org/src/[]."
	+"Веб-интерфейсы для обоих репозиториев доступны по адресам https://cgit."
	+"freebsd.org/doc/[] и https://cgit.freebsd.org/src/[]."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:353
	+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:363
	msgid ""
	"Many people have written tutorials or how-to articles about FreeBSD. Some "
	"are stored as part of the FDP files. In other cases, the author has decided "
	diff --git a/documentation/content/ru/books/fdp-primer/po-translations/_index.adoc b/documentation/content/ru/books/fdp-primer/po-translations/_index.adoc
	--- a/documentation/content/ru/books/fdp-primer/po-translations/_index.adoc
	+++ b/documentation/content/ru/books/fdp-primer/po-translations/_index.adoc
	@@ -55,7 +55,7 @@
	[[po-translations-quick-start]]
	== Быстрый старт

	-Предполагается, что процедура, описанная в crossref:overview[overview-quick-start,Быстрый старт], уже выполнена. Опция `TRANSLATOR` необходима и уже включена по умолчанию в порте package:textproc/docproj[].
	+Предполагается, что процедура, описанная в разделе crossref:overview[overview-quick-start,Быстрый старт], уже выполнена. Опция `TRANSLATOR` необходима и уже включена по умолчанию в порте package:textproc/docproj[].

	Этот пример демонстрирует создание испанского перевода краткой статьи extref:{leap-seconds}[Високосные секунды].

	@@ -79,7 +79,7 @@

	Когда создаётся новый перевод, структура каталогов должна быть создана или скопирована из оригинальной английской версии:

	-. Создайте каталог для нового перевода. Исходный текст статьи на английском находится в [.filename]#~/doc/documentation/content/en/articles/leap-seconds/#. Испанский перевод будет расположен в [.filename]#~/doc/documentation/content/es/articles/leap-seconds/#. Путь идентичен, за исключением названия языкового каталога. Исходный текст статьи на английском находится в [.filename]#~/doc/en/articles/leap-seconds/#. Испанский перевод будет расположен в [.filename]#~/doc/es/articles/leap-seconds/#. Путь идентичен, за исключением названия языкового каталога.
	+. Создайте каталог для нового перевода. Исходный текст статьи на английском находится в [.filename]#~/doc/documentation/content/en/articles/leap-seconds/#. Испанский перевод будет расположен в [.filename]#~/doc/documentation/content/es/articles/leap-seconds/#. Путь идентичен, за исключением названия языкового каталога. Исходный текст статьи на английском находится в [.filename]#~/doc/en/articles/leap-seconds/#.
	+
	[source, shell]
	....
	@@ -225,7 +225,7 @@
	\|[.filename]#zh-tw#
	\|===

	-Переводы находятся в подкаталогах основного каталога документации, который в данном случае предполагается как [.filename]#~/doc/documentation/#, как показано в crossref:overview[overview-quick-start, Быстрый старт]. Например, немецкие переводы расположены в [.filename]#~/doc/documentation/content/de/#, а французские — в [.filename]#~/doc/documentation/content/fr/#.
	+Переводы находятся в подкаталогах основного каталога документации, который в данном случае предполагается как [.filename]#~/doc/documentation/#, как показано в разделе crossref:overview[overview-quick-start, Быстрый старт]. Например, немецкие переводы расположены в [.filename]#~/doc/documentation/content/de/#, а французские — в [.filename]#~/doc/documentation/content/fr/#.

	Каждый языковой каталог содержит отдельные подкаталоги с названиями по типу документов, обычно [.filename]#articles/# и [.filename]#books/#.

	diff --git a/documentation/content/ru/books/fdp-primer/po-translations/_index.po b/documentation/content/ru/books/fdp-primer/po-translations/_index.po
	--- a/documentation/content/ru/books/fdp-primer/po-translations/_index.po
	+++ b/documentation/content/ru/books/fdp-primer/po-translations/_index.po
	@@ -5,8 +5,8 @@
	msgid ""
	msgstr ""
	"Project-Id-Version: FreeBSD Documentation VERSION\n"
	-"POT-Creation-Date: 2025-05-01 19:56-0300\n"
	-"PO-Revision-Date: 2026-03-08 09:11+0000\n"
	+"POT-Creation-Date: 2026-08-06 22:55+0100\n"
	+"PO-Revision-Date: 2026-08-08 04:45+0000\n"
	"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
	"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
	"documentation/booksfdp-primerpo-translations_index/ru/>\n"
	@@ -37,13 +37,13 @@
	msgstr "Переводы PO"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:52
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:51
	#, no-wrap
	msgid "Introduction"
	msgstr "Введение"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:58
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:57
	msgid ""
	"The http://www.gnu.org/software/gettext/[GNU gettext] system offers "
	"translators an easy way to create and maintain translations of documents. "
	@@ -60,61 +60,62 @@
	"версию исходного документа."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:60
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:59
	#, no-wrap
	msgid "Quick Start"
	msgstr "Быстрый старт"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:64
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:63
	msgid ""
	"The procedure shown in crossref:overview[overview-quick-start,Quick Start] "
	"is assumed to have already been performed. The `TRANSLATOR` option is "
	"required and already enabled by default in the package:textproc/docproj[] "
	"port."
	msgstr ""
	-"Предполагается, что процедура, описанная в crossref:overview[overview-quick-"
	-"start,Быстрый старт], уже выполнена. Опция `TRANSLATOR` необходима и уже "
	-"включена по умолчанию в порте package:textproc/docproj[]."
	+"Предполагается, что процедура, описанная в разделе crossref:"
	+"overview[overview-quick-start,Быстрый старт], уже выполнена. Опция "
	+"`TRANSLATOR` необходима и уже включена по умолчанию в порте package:textproc/"
	+"docproj[]."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:66
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:65
	msgid ""
	"This example shows the creation of a Spanish translation of the short extref:"
	"{leap-seconds}[Leap Seconds] article."
	msgstr ""
	-"Этот пример демонстрирует создание испанского перевода краткой статьи extref"
	-":{leap-seconds}[Високосные секунды]."
	+"Этот пример демонстрирует создание испанского перевода краткой статьи extref:"
	+"{leap-seconds}[Високосные секунды]."

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:71
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:70
	#, no-wrap
	msgid "Procedure: Install a PO Editor"
	msgstr "Процедура: Установка PO-редактора"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:73
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:72
	msgid ""
	-"A PO editor is needed to edit translation files. This example uses "
	-"package:editors/poedit[]."
	+"A PO editor is needed to edit translation files. This example uses package:"
	+"editors/poedit[]."
	msgstr ""
	"Редактор PO необходим для редактирования файлов переводов. В этом примере "
	"используется package:editors/poedit[]."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:77
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:76
	#, no-wrap
	msgid "# pkg install poedit\n"
	msgstr "# pkg install poedit\n"

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:83
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:82
	#, no-wrap
	msgid "Procedure: Initial Setup"
	msgstr "Процедура: Начальная настройка"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:86
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:85
	msgid ""
	"When a new translation is first created, the directory structure must be "
	"created or copied from the English original:"
	@@ -123,34 +124,29 @@
	"скопирована из оригинальной английской версии:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:91
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:90
	msgid ""
	-"Create a directory for the new translation. The English article source is in "
	-"[.filename]#~/doc/documentation/content/en/articles/leap-seconds/#. The "
	+"Create a directory for the new translation. The English article source is "
	+"in [.filename]#~/doc/documentation/content/en/articles/leap-seconds/#. The "
	"Spanish translation will go in [.filename]#~/doc/documentation/content/es/"
	-"articles/leap-seconds/#. The path is the same except for the name of the "
	-"language directory. The English article source is in [.filename]#~/doc/en/"
	-"articles/leap-seconds/#. The Spanish translation will go in [.filename]#~/"
	-"doc/es/articles/leap-seconds/#. The path is the same except for the name of "
	-"the language directory."
	+"articles/leap-seconds/#. The path is the same except for the name of the "
	+"language directory."
	msgstr ""
	"Создайте каталог для нового перевода. Исходный текст статьи на английском "
	"находится в [.filename]#~/doc/documentation/content/en/articles/leap-seconds/"
	"#. Испанский перевод будет расположен в [.filename]#~/doc/documentation/"
	"content/es/articles/leap-seconds/#. Путь идентичен, за исключением названия "
	"языкового каталога. Исходный текст статьи на английском находится в [."
	-"filename]#~/doc/en/articles/leap-seconds/#. Испанский перевод будет "
	-"расположен в [.filename]#~/doc/es/articles/leap-seconds/#. Путь идентичен, "
	-"за исключением названия языкового каталога."
	+"filename]#~/doc/en/articles/leap-seconds/#."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:95
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:94
	#, no-wrap
	msgid "% mkdir ~/doc/documentation/content/es/articles/leap-seconds\n"
	msgstr "% mkdir ~/doc/documentation/content/es/articles/leap-seconds\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:98
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:97
	msgid ""
	"Copy the [.filename]#_index.po# from the original document into the "
	"translation directory:"
	@@ -158,7 +154,7 @@
	"Скопируйте [.filename]#_index.po# из исходного документа в каталог перевода:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:103
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:102
	#, no-wrap
	msgid ""
	"% cp ~/doc/documentation/content/en/articles/leap-seconds/_index.po \\\n"
	@@ -168,7 +164,7 @@
	" ~/doc/documentation/content/es/articles/leap-seconds/\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:107
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:106
	msgid ""
	"Suppose the document or language is also being translated via Weblate. In "
	"that case, it is good to get the `.po` file from there and upload the "
	@@ -181,7 +177,7 @@
	"Weblate и избежать повторной работы."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:109
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:108
	msgid ""
	"See how to download the `.po` files in the crossref:weblate[weblate-"
	"translating-offline,Translating Offline on Weblate] chapter."
	@@ -190,13 +186,13 @@
	"offline,Перевод офлайн в Weblate]."

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:114
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:113
	#, no-wrap
	msgid "Procedure: Translation"
	msgstr "Процедура: Перевод"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:118
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:117
	msgid ""
	"Use a PO editor to enter translations in the PO file. There are several "
	"different editors available. [.filename]#poedit# from package:editors/"
	@@ -207,24 +203,24 @@
	"poedit[]."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:122
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:121
	#, no-wrap
	msgid "% poedit documentation/content/es/articles/leap-seconds/_index.po\n"
	msgstr "% poedit documentation/content/es/articles/leap-seconds/_index.po\n"

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:128
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:127
	#, no-wrap
	msgid "Procedure: Generating a Translated Document"
	msgstr "Процедура: Создание переведенного документа"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:130
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:129
	msgid "Generate the translated document:"
	msgstr "Сгенерируйте переведенный документ:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:135
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:134
	#, no-wrap
	msgid ""
	"% cd ~/doc\n"
	@@ -234,7 +230,7 @@
	"% ./tools/translate.sh documentation es articles/leap-seconds\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:138
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:137
	msgid ""
	"The name of the generated document matches the name of the English original, "
	"usually [.filename]#_index.adoc#."
	@@ -243,16 +239,16 @@
	"языке, обычно `[.filename]#_index.adoc#`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:140
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:139
	msgid ""
	"Check the generated file by rendering it to HTML and viewing it with a web "
	"browser:"
	msgstr ""
	-"Проверьте сгенерированный файл, преобразовав его в HTML и просмотрев в "
	-"веб-браузере:"
	+"Проверьте сгенерированный файл, преобразовав его в HTML и просмотрев в веб-"
	+"браузере:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:145
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:144
	#, no-wrap
	msgid ""
	"% cd ~/doc/documentation\n"
	@@ -262,13 +258,13 @@
	"% make\n"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:149
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:148
	#, no-wrap
	msgid "Creating New Translations"
	msgstr "Создание новых переводов"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:154
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:153
	msgid ""
	"The first step to creating a new translated document is locating or creating "
	"a directory to hold it. FreeBSD puts translated documents in a subdirectory "
	@@ -282,383 +278,383 @@
	"регистре."

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:156
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:155
	#, no-wrap
	msgid "Language Names"
	msgstr "Названия языков"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:160
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:159
	#, no-wrap
	msgid "Language"
	msgstr "Язык"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:161
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:160
	#, no-wrap
	msgid "Region"
	msgstr "Регион"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:163
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:162
	#, no-wrap
	msgid "Translated Directory Name"
	msgstr "Имя каталога с переводами"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:164
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:163
	#, no-wrap
	msgid "English"
	msgstr "Английский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:165
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:164
	#, no-wrap
	msgid "United States"
	msgstr "Соединённые Штаты"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:167
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:166
	#, no-wrap
	msgid "[.filename]#en#"
	msgstr "[.filename]#en#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:168
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:167
	#, no-wrap
	msgid "Bengali"
	msgstr "Бенгальский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:169
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:168
	#, no-wrap
	msgid "Bangladesh"
	msgstr "Бангладеш"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:171
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:170
	#, no-wrap
	msgid "[.filename]#bn-bd#"
	msgstr "[.filename]#bn-bd#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:172
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:171
	#, no-wrap
	msgid "Danish"
	msgstr "Датский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:173
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:172
	#, no-wrap
	msgid "Denmark"
	msgstr "Дания"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:175
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:174
	#, no-wrap
	msgid "[.filename]#da#"
	msgstr "[.filename]#da#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:176
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:175
	#, no-wrap
	msgid "German"
	msgstr "Немецкий"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:177
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:176
	#, no-wrap
	msgid "Germany"
	msgstr "Германия"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:179
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:178
	#, no-wrap
	msgid "[.filename]#de#"
	msgstr "[.filename]#de#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:180
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:179
	#, no-wrap
	msgid "Greek"
	msgstr "Греческий"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:181
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:180
	#, no-wrap
	msgid "Greece"
	msgstr "Греция"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:183
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:182
	#, no-wrap
	msgid "[.filename]#el#"
	msgstr "[.filename]#el#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:184
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:183
	#, no-wrap
	msgid "Spanish"
	msgstr "Испанский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:185
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:184
	#, no-wrap
	msgid "Spain"
	msgstr "Испания"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:187
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:186
	#, no-wrap
	msgid "[.filename]#es#"
	msgstr "[.filename]#es#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:188
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:187
	#, no-wrap
	msgid "French"
	msgstr "Французский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:189
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:188
	#, no-wrap
	msgid "France"
	msgstr "Франция"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:191
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:190
	#, no-wrap
	msgid "[.filename]#fr#"
	msgstr "[.filename]#fr#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:192
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:191
	#, no-wrap
	msgid "Hungarian"
	msgstr "Венгерский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:193
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:192
	#, no-wrap
	msgid "Hungary"
	msgstr "Венгрия"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:195
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:194
	#, no-wrap
	msgid "[.filename]#hu#"
	msgstr "[.filename]#hu#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:196
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:195
	#, no-wrap
	msgid "Italian"
	msgstr "Итальянский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:197
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:196
	#, no-wrap
	msgid "Italy"
	msgstr "Италия"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:199
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:198
	#, no-wrap
	msgid "[.filename]#it#"
	msgstr "[.filename]#it#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:200
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:199
	#, no-wrap
	msgid "Japanese"
	msgstr "Японский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:201
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:200
	#, no-wrap
	msgid "Japan"
	msgstr "Япония"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:203
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:202
	#, no-wrap
	msgid "[.filename]#ja#"
	msgstr "[.filename]#ja#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:204
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:203
	#, no-wrap
	msgid "Korean"
	msgstr "Корейский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:205
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:204
	#, no-wrap
	msgid "Korea"
	msgstr "Корея"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:207
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:206
	#, no-wrap
	msgid "[.filename]#ko#"
	msgstr "[.filename]#ko#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:208
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:207
	#, no-wrap
	msgid "Mongolian"
	msgstr "Монгольский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:209
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:208
	#, no-wrap
	msgid "Mongolia"
	msgstr "Монголия"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:211
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:210
	#, no-wrap
	msgid "[.filename]#mn#"
	msgstr "[.filename]#mn#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:212
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:211
	#, no-wrap
	msgid "Dutch"
	msgstr "Голландский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:213
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:212
	#, no-wrap
	msgid "Netherlands"
	msgstr "Нидерланды"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:215
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:214
	#, no-wrap
	msgid "[.filename]#nl#"
	msgstr "[.filename]#nl#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:216
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:215
	#, no-wrap
	msgid "Polish"
	msgstr "Польский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:217
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:216
	#, no-wrap
	msgid "Poland"
	msgstr "Польша"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:219
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:218
	#, no-wrap
	msgid "[.filename]#pl#"
	msgstr "[.filename]#pl#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:220
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:219
	#, no-wrap
	msgid "Portuguese"
	msgstr "Португальский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:221
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:220
	#, no-wrap
	msgid "Brazil"
	msgstr "Бразилия"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:223
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:222
	#, no-wrap
	msgid "[.filename]#pt-br#"
	msgstr "[.filename]#pt-br#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:224
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:223
	#, no-wrap
	msgid "Russian"
	msgstr "Русский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:225
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:224
	#, no-wrap
	msgid "Russia"
	msgstr "Россия"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:227
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:226
	#, no-wrap
	msgid "[.filename]#ru#"
	msgstr "[.filename]#ru#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:228
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:227
	#, no-wrap
	msgid "Turkish"
	msgstr "Турецкий"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:229
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:228
	#, no-wrap
	msgid "Turkey"
	msgstr "Турция"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:231
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:230
	#, no-wrap
	msgid "[.filename]#tr#"
	msgstr "[.filename]#tr#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:232
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:236
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:231
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:235
	#, no-wrap
	msgid "Chinese"
	msgstr "Китайский"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:233
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:232
	#, no-wrap
	msgid "China"
	msgstr "Китай"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:235
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:234
	#, no-wrap
	msgid "[.filename]#zh-cn#"
	msgstr "[.filename]#zh-cn#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:237
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:236
	#, no-wrap
	msgid "Taiwan"
	msgstr "Тайвань"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:238
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:237
	#, no-wrap
	msgid "[.filename]#zh-tw#"
	msgstr "[.filename]#zh-tw#"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:244
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:243
	msgid ""
	"The translations are in subdirectories of the main documentation directory, "
	-"here assumed to be [.filename]#~/doc/documentation/# as shown in "
	-"crossref:overview[overview-quick-start, Quick Start]. For example, German "
	+"here assumed to be [.filename]#~/doc/documentation/# as shown in crossref:"
	+"overview[overview-quick-start, Quick Start]. For example, German "
	"translations are located in [.filename]#~/doc/documentation/content/de/#, "
	"and French translations are in [.filename]#~/doc/documentation/content/fr/#."
	msgstr ""
	"Переводы находятся в подкаталогах основного каталога документации, который в "
	"данном случае предполагается как [.filename]#~/doc/documentation/#, как "
	-"показано в crossref:overview[overview-quick-start, Быстрый старт]. Например, "
	-"немецкие переводы расположены в [.filename]#~/doc/documentation/content/de/#"
	-", а французские — в [.filename]#~/doc/documentation/content/fr/#."
	+"показано в разделе crossref:overview[overview-quick-start, Быстрый старт]. "
	+"Например, немецкие переводы расположены в [.filename]#~/doc/documentation/"
	+"content/de/#, а французские — в [.filename]#~/doc/documentation/content/fr/#."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:246
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:245
	msgid ""
	"Each language directory contains separate subdirectories named for the type "
	"of documents, usually [.filename]#articles/# and [.filename]#books/#."
	@@ -667,11 +663,11 @@
	"документов, обычно [.filename]#articles/# и [.filename]#books/#."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:250
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:249
	msgid ""
	"Combining these directory names gives the complete path to an article or "
	-"book. For example, the French translation of the NanoBSD article is in "
	-"[.filename]#~/doc/documentation/content/fr/articles/nanobsd/#, and the "
	+"book. For example, the French translation of the NanoBSD article is in [."
	+"filename]#~/doc/documentation/content/fr/articles/nanobsd/#, and the "
	"Mongolian translation of the Handbook is in [.filename]#~/doc/documentation/"
	"content/mn/books/handbook/#."
	msgstr ""
	@@ -681,35 +677,35 @@
	"Руководства — в [.filename]#~/doc/documentation/content/mn/books/handbook/#."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:253
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:252
	msgid ""
	"A new language directory must be created when translating a document to a "
	"new language. If the language directory already exists, only a subdirectory "
	"in the [.filename]#articles/# or [.filename]#books/# directory is needed."
	msgstr ""
	"При переводе документа на новый язык необходимо создать новый каталог языка. "
	-"Если каталог языка уже существует, достаточно создать подкаталог в каталоге ["
	-".filename]#articles/# или [.filename]#books/#."
	+"Если каталог языка уже существует, достаточно создать подкаталог в каталоге "
	+"[.filename]#articles/# или [.filename]#books/#."

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:255
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:254
	#, no-wrap
	msgid "Creating a Spanish Translation of the Porter's Handbook"
	msgstr "Создание испанского перевода Руководства портировщика"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:260
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:259
	msgid ""
	"Create a new Spanish translation of the extref:{porters-handbook}[Porter's "
	"Handbook]. The original is a book in [.filename]#~/doc/documentation/"
	"content/en/books/porters-handbook/#."
	msgstr ""
	-"Создайте новый перевод на испанский язык extref:{porters-handbook}["
	-"Руководства портировщика]. Оригинал находится в книге [.filename]#~/doc/"
	+"Создайте новый перевод на испанский язык extref:{porters-handbook}"
	+"[Руководства портировщика]. Оригинал находится в книге [.filename]#~/doc/"
	"documentation/content/en/books/porters-handbook/#."

	#. type: delimited block = 6
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:265
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:264
	msgid ""
	"The Spanish language books directory [.filename]#~/doc/documentation/content/"
	"es/books/# already exists, so only a new subdirectory for the Porter's "
	@@ -720,7 +716,7 @@
	"Руководства портировщика:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:270
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:269
	#, no-wrap
	msgid ""
	"% cd ~/doc/documentation/content/es/books\n"
	@@ -730,12 +726,12 @@
	"% mkdir porters-handbook\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:273
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:272
	msgid "Copy the content from the original book:"
	msgstr "Скопируйте содержимое из переводимой книги:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:278
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:277
	#, no-wrap
	msgid ""
	"% cd porters-handbook\n"
	@@ -745,7 +741,7 @@
	"% cp -R ~/doc/documentation/content/en/books/porters-handbook/* .\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:281
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:280
	msgid ""
	"Now the document structure is ready for the translator to begin translating "
	"with `po4a` command."
	@@ -754,13 +750,13 @@
	"`po4a`."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:285
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:284
	#, no-wrap
	msgid "Translating"
	msgstr "Перевод"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:290
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:289
	msgid ""
	"The gettext system greatly reduces the number of things that must be tracked "
	"by a translator. Strings to be translated are extracted from the original "
	@@ -773,7 +769,7 @@
	"переведённые версии каждой строки."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:292
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:291
	msgid ""
	"The FreeBSD PO translation system does not overwrite PO files, so the "
	"extraction step can be run at any time to update the PO file."
	@@ -782,7 +778,7 @@
	"извлечения можно выполнять в любое время для обновления PO-файла."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:297
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:296
	msgid ""
	"A PO editor is used to edit the file. package:editors/poedit[] is shown in "
	"these examples because it is simple and has minimal requirements. Other PO "
	@@ -797,7 +793,7 @@
	"gtranslator[]."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:300
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:299
	msgid ""
	"It is important to preserve the PO file. It contains all of the work that "
	"translators have done."
	@@ -805,7 +801,7 @@
	"Важно сохранить PO-файл. Он содержит всю работу, проделанную переводчиками."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:305
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:304
	msgid ""
	"Translating documents online proves to be the easiest method for document "
	"translation on FreeBSD, as it allows multiple users to collaborate on the "
	@@ -816,34 +812,34 @@
	"Перевод документов онлайн оказывается наиболее простым способом перевода "
	"документации в FreeBSD, так как позволяет нескольким пользователям совместно "
	"работать над одним файлом, эффективно распределяя нагрузку. Для получения "
	-"дополнительной информации обратитесь к следующей главе: crossref:weblate"
	-"[weblate-introduction,Переводы в Weblate]."
	+"дополнительной информации обратитесь к следующей главе: crossref:"
	+"weblate[weblate-introduction,Переводы в Weblate]."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:308
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:307
	#, no-wrap
	msgid "Tips for Translators"
	msgstr "Советы переводчикам"

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:311
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:315
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:310
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:314
	#, no-wrap
	msgid "Preserving AsciiDoc macros"
	msgstr "Сохранение AsciiDoc макросов"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:314
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:313
	msgid "Preserve AsciiDoc macros that are shown in the English original."
	msgstr "Сохраните макросы AsciiDoc, которые указаны на английском языке."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:319
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:318
	msgid "English original:"
	msgstr "Оригинал на английском:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:325
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:324
	#, no-wrap
	msgid ""
	"msgid \"\"\n"
	@@ -855,12 +851,12 @@
	"\"extref:{leap-seconds}[Leap Seconds] article.\"\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:328
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:327
	msgid "Spanish translation:"
	msgstr "Испанский перевод:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:334
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:333
	#, no-wrap
	msgid ""
	"msgid \"\"\n"
	@@ -868,18 +864,17 @@
	"\"extref:{leap-seconds}[Leap Seconds].\"\n"
	msgstr ""
	"msgid \"\"\n"
	-"\"Este ejemplo muestra la creación de un artículo con poco contenido como el "
	-"artículo \"\n"
	+"\"Este ejemplo muestra la creación de un artículo con poco contenido como el artículo \"\n"
	"\"extref:{leap-seconds}[Leap Seconds].\"\n"

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:339
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:338
	#, no-wrap
	msgid "Preserving Spaces"
	msgstr "Сохранение пробелов"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:343
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:342
	msgid ""
	"Preserve existing spaces at the beginning and end of strings to be "
	"translated. The translated version must have these spaces also."
	@@ -888,70 +883,70 @@
	"перевести. В переведённой версии эти пробелы также должны присутствовать."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:345
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:344
	#, no-wrap
	msgid "Verbatim Tags"
	msgstr "Дословные теги"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:348
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:347
	msgid "The contents of some tags should be copied verbatim, not translated:"
	msgstr ""
	"Содержимое некоторых тегов должно быть скопировано дословно, без перевода:"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:350
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:349
	msgid "`man:man[1]`"
	msgstr "`man:man[1]`"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:351
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:350
	msgid "`package:package[]`"
	msgstr "`package:package[]`"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:352
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:351
	msgid "`link`"
	msgstr "`link`"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:353
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:352
	msgid "`image`"
	msgstr "`image`"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:354
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:353
	msgid "`include`"
	msgstr "`include`"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:355
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:354
	msgid "`Admonitions`"
	msgstr "`Admonitions`"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:356
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:355
	msgid "`id's`"
	msgstr "`id's`"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:357
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:356
	msgid "`Heading tags`"
	msgstr "`Heading tags`"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:358
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:357
	msgid "`source`"
	msgstr "`source`"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:360
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:359
	#, no-wrap
	msgid "Building a Translated Document"
	msgstr "Сборка переведенного документа"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:366
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:365
	msgid ""
	"A translated version of the original document can be created at any time. "
	"Any untranslated portions of the original will be included in English in the "
	@@ -968,22 +963,22 @@
	"документа имела смысл."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:368
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:367
	msgid ""
	-"The Weblate chapter provides a complete example of how to "
	-"crossref:weblate[weblate-building,Build the Translated Document]."
	+"The Weblate chapter provides a complete example of how to crossref:"
	+"weblate[weblate-building,Build the Translated Document]."
	msgstr ""
	"Глава о Weblate есть полный пример того, как crossref:weblate[weblate-"
	"building,Собрать переведённый документ]."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:370
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:369
	#, no-wrap
	msgid "Submitting the New Translation"
	msgstr "Отправка новой переведённой версии"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:374
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:373
	msgid ""
	"Prepare the new translation files for submission. This includes adding the "
	"files to the version control system, setting additional properties on them, "
	@@ -994,24 +989,24 @@
	"а затем создание diff-файла для отправки."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:376
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:375
	msgid ""
	-"The diff files created by these examples can be attached to a https://"
	-"bugs.freebsd.org/bugzilla/enter_bug.cgi?product=Documentation[documentation "
	-"bug report] or https://reviews.freebsd.org/[code review]."
	+"The diff files created by these examples can be attached to a https://bugs."
	+"freebsd.org/bugzilla/enter_bug.cgi?product=Documentation[documentation bug "
	+"report] or https://reviews.freebsd.org/[code review]."
	msgstr ""
	"Файлы различий, созданные в этих примерах, можно прикрепить к https://bugs."
	"freebsd.org/bugzilla/enter_bug.cgi?product=Documentation[отчёту об ошибке в "
	"документации] или https://reviews.freebsd.org/[обзору кода]."

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:378
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:377
	#, no-wrap
	msgid "Spanish Translation of the NanoBSD Article"
	msgstr "Перевод статьи NanoBSD на испанский язык"

	#. type: delimited block = 6
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:385
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:384
	msgid ""
	"Create a diff of the new files from the [.filename]#~/doc/# base directory "
	"so the full path is shown with the filenames. This helps committers identify "
	@@ -1022,21 +1017,20 @@
	"коммиттерам определить целевой языковой каталог."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:390
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:389
	#, no-wrap
	msgid ""
	"% cd ~/doc\n"
	"% git diff documentation/content/es/articles/nanobsd/ > /tmp/es_nanobsd.diff\n"
	msgstr ""
	"% cd ~/doc\n"
	-"% git diff documentation/content/es/articles/nanobsd/ > /tmp/es_nanobsd."
	-"diff\n"
	+"% git diff documentation/content/es/articles/nanobsd/ > /tmp/es_nanobsd.diff\n"

	#. type: delimited block = 6
	-#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:394
	+#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:393
	msgid ""
	-"The Weblate chapter provides a complete example of how to "
	-"crossref:weblate[weblate-submitting-translations,Submit the New Translation]."
	+"The Weblate chapter provides a complete example of how to crossref:"
	+"weblate[weblate-submitting-translations,Submit the New Translation]."
	msgstr ""
	"Глава о Weblate содержит полный пример того, как crossref:weblate[weblate-"
	"submitting-translations, отправить новый перевод]."
	diff --git a/documentation/content/ru/books/fdp-primer/structure/_index.adoc b/documentation/content/ru/books/fdp-primer/structure/_index.adoc
	--- a/documentation/content/ru/books/fdp-primer/structure/_index.adoc
	+++ b/documentation/content/ru/books/fdp-primer/structure/_index.adoc
	@@ -234,6 +234,7 @@
	---

	= Почему вы должны использовать лицензию в стиле BSD для вашего Open Source проекта
	+:doctype: article :toc: macro :toclevels: 1 :icons: font :sectnums: :source-highlighter: rouge :experimental:

	'''

	diff --git a/documentation/content/ru/books/fdp-primer/structure/_index.po b/documentation/content/ru/books/fdp-primer/structure/_index.po
	--- a/documentation/content/ru/books/fdp-primer/structure/_index.po
	+++ b/documentation/content/ru/books/fdp-primer/structure/_index.po
	@@ -5,8 +5,8 @@
	msgid ""
	msgstr ""
	"Project-Id-Version: FreeBSD Documentation VERSION\n"
	-"POT-Creation-Date: 2025-08-17 20:54+0100\n"
	-"PO-Revision-Date: 2026-04-05 04:45+0000\n"
	+"POT-Creation-Date: 2026-08-06 22:55+0100\n"
	+"PO-Revision-Date: 2026-08-08 04:45+0000\n"
	"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
	"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
	"documentation/booksfdp-primerstructure_index/ru/>\n"
	@@ -37,18 +37,18 @@
	msgstr "Структура каталогов документации"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:52
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:51
	msgid "Files and directories in the doc/ tree follow a structure meant to:"
	msgstr "Файлы и каталоги в дереве doc/ следуют структуре, преследующей цели:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:54
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:53
	msgid "Make it easy to automate converting the document to other formats."
	msgstr ""
	"Сделать удобным автоматическое преобразование документа в другие форматы."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:55
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:54
	msgid ""
	"Promote consistency between the different documentation organizations, to "
	"make it easier to switch between working on different documents."
	@@ -57,14 +57,14 @@
	"документацией, чтобы упростить переход между работой над разными документами."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:56
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:55
	msgid ""
	"Make it easy to decide where in the tree new documentation should be placed."
	msgstr ""
	"Сделать удобным выбор места в дереве для размещения новой документации."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:59
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:58
	msgid ""
	"In addition, the documentation tree must accommodate documents in many "
	"different languages. It is important that the documentation tree structure "
	@@ -75,13 +75,13 @@
	"каких-либо конкретных настроек по умолчанию или культурных предпочтений."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:61
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:60
	#, no-wrap
	msgid "The Top Level, doc/"
	msgstr "Верхний уровень, doc/"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:64
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:63
	msgid ""
	"There are three sections under doc/, documentation and website share the "
	"same structure."
	@@ -90,27 +90,27 @@
	"одинаковую структуру."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:68
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:97
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:67
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:96
	#, no-wrap
	msgid "Directory"
	msgstr "Каталог"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:70
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:100
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:69
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:99
	#, no-wrap
	msgid "Usage"
	msgstr "Использование"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:71
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:70
	#, no-wrap
	msgid "documentation"
	msgstr "documentation"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:74
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:73
	#, no-wrap
	msgid ""
	"Contains all the articles and books in AsciiDoc format.\n"
	@@ -120,14 +120,14 @@
	"Содержит подкаталоги для дальнейшей категоризации информации по языкам."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:75
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:128
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:74
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:127
	#, no-wrap
	msgid "tools"
	msgstr "tools"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:78
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:77
	#, no-wrap
	msgid ""
	"Contains a set of tools used to translate the documentation and the website using link:https://weblate.org/en/[Weblate].\n"
	@@ -137,13 +137,13 @@
	"Экземпляр Weblate доступен link:https://translate-dev.freebsd.org[здесь]."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:79
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:78
	#, no-wrap
	msgid "shared"
	msgstr "shared"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:83
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:82
	#, no-wrap
	msgid ""
	"Contains files that are not specific to the various translations of the documentation.\n"
	@@ -155,13 +155,13 @@
	"Этот каталог является общим для `documentation` и `website`."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:84
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:83
	#, no-wrap
	msgid "website"
	msgstr "* website*"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:86
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:85
	#, no-wrap
	msgid ""
	"Contains the link:https://www.FreeBSD.org[FreeBSD website] in AsciiDoc format.\n"
	@@ -171,13 +171,13 @@
	"Содержит подкаталоги для дальнейшей категоризации информации по языкам."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:89
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:88
	#, no-wrap
	msgid "The Directories"
	msgstr "Каталоги"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:93
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:92
	msgid ""
	"These directories contain the documentation and the website. The "
	"documentation is organized into subdirectories below this level, following "
	@@ -189,13 +189,13 @@
	"gohugo.io/getting-started/directory-structure/[Hugo]."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:101
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:100
	#, no-wrap
	msgid "archetypes"
	msgstr "* archetypes*"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:104
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:103
	#, no-wrap
	msgid ""
	"Contain templates to create new articles, books and webpages.\n"
	@@ -205,13 +205,13 @@
	"Дополнительную информацию смотрите link:https://gohugo.io/content-management/archetypes/[здесь]."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:105
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:104
	#, no-wrap
	msgid "config"
	msgstr "config"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:109
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:108
	#, no-wrap
	msgid ""
	"Contain the Hugo configuration files.\n"
	@@ -223,13 +223,13 @@
	"Для получения дополнительной информации смотрите link:https://gohugo.io/getting-started/configuration/[здесь]."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:110
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:109
	#, no-wrap
	msgid "content"
	msgstr "content"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:113
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:112
	#, no-wrap
	msgid ""
	"Contain the books, articles and webpages.\n"
	@@ -239,13 +239,13 @@
	"Для каждого доступного перевода документации существует отдельный каталог, например `en` и `zh-tw`."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:114
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:113
	#, no-wrap
	msgid "data"
	msgstr "data"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:118
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:117
	#, no-wrap
	msgid ""
	"Contain custom data for build the website in link:https://en.wikipedia.org/wiki/TOML[TOML] format.\n"
	@@ -257,13 +257,13 @@
	"Для получения дополнительной информации ознакомьтесь link:https://gohugo.io/templates/data-templates/[здесь]."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:119
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:118
	#, no-wrap
	msgid "static"
	msgstr "static"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:123
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:122
	#, no-wrap
	msgid ""
	"Contain static assets.\n"
	@@ -275,13 +275,13 @@
	"Подробнее смотрите link:https://gohugo.io/content-management/static-files/[здесь]."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:124
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:123
	#, no-wrap
	msgid "themes"
	msgstr "* themes*"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:127
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:126
	#, no-wrap
	msgid ""
	"Contain the templates in the form of `.html` files that specify how the website looks.\n"
	@@ -291,7 +291,7 @@
	"Для получения дополнительной информации посмотрите link:https://gohugo.io/templates/[здесь]."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:131
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:130
	#, no-wrap
	msgid ""
	"Contain tools used to enhance the documentation build.\n"
	@@ -301,49 +301,49 @@
	"Например, для генерации оглавления книг и т.д."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:132
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:131
	#, no-wrap
	msgid "beastie.png"
	msgstr "beastie.png"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:134
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:133
	#, no-wrap
	msgid "This image does not need an introduction ;)"
	msgstr "Это изображение не нуждается в представлении ;)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:135
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:134
	#, no-wrap
	msgid "LICENSE"
	msgstr "LICENSE"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:137
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:136
	#, no-wrap
	msgid "License of the documentation, shared and website. BSD 2-Clause License."
	msgstr "Лицензия документации, общих материалов и веб-сайта. Лицензия BSD с 2 пунктами."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:138
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:137
	#, no-wrap
	msgid "Makefile"
	msgstr "Makefile"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:139
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:138
	#, no-wrap
	msgid "The Makefile defines the build process of the documentation and the website."
	msgstr "Файл Makefile определяет процесс сборки документации и веб-сайта."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:142
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:141
	#, no-wrap
	msgid "Document-Specific Information"
	msgstr "Информация, относящаяся к документу"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:145
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:144
	msgid ""
	"This section contains specific notes about particular documents managed by "
	"the FDP."
	@@ -352,18 +352,18 @@
	"управляет FDP."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:147
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:146
	#, no-wrap
	msgid "The Books: books/"
	msgstr "Книги: books/"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:150
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:149
	msgid "The books are written in AsciiDoc."
	msgstr "Книги написаны в AsciiDoc."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:153
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:152
	msgid ""
	"For each FreeBSD book, the AsciiDoc document type (aka doctype) is `book`. "
	"Books have ``part``s, each of which contains several ``chapter``s."
	@@ -373,7 +373,7 @@
	"которых включает несколько ``chapter`` (глав)."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:155
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:154
	msgid ""
	"When the document is converted to HTML 5 (using the built-in `html5` "
	"backend):"
	@@ -382,14 +382,14 @@
	"`html5`):"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:157
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:156
	msgid ""
	"AsciiDoc section level 0 (`=`) at the beginning of a ``chapter`` of a `book` "
	"will be `<h1>`"
	msgstr "Уровень раздела AsciiDoc 0 (`=`) в начале `главы` `книги` будет `<h1>`"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:158
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:157
	msgid ""
	"AsciiDoc section level 1 (`==`) must be used for the first logical section "
	"of a chapter, and will be `<h2>`"
	@@ -398,7 +398,7 @@
	"логического раздела главы и будет преобразован в `<h2>`"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:159
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:158
	msgid ""
	"AsciiDoc section level 2 (`===`) must be used for the first logical "
	"subsection, and will be `<h3>`"
	@@ -407,7 +407,7 @@
	"логического подраздела и будет преобразован в `<h3>`"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:161
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:160
	msgid ""
	"– and so on. Reference: link:https://docs.asciidoctor.org/asciidoc/latest/"
	"sections/titles-and-levels/[Section Titles and Levels \| Asciidoctor Docs]."
	@@ -417,14 +417,14 @@
	"Asciidoctor]."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:163
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:223
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:162
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:222
	#, no-wrap
	msgid "Physical Organization"
	msgstr "Физическая организация"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:166
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:165
	msgid ""
	"There are a number of files and directories within the books directory, all "
	"with the same structure."
	@@ -433,14 +433,14 @@
	"структурой."

	#. type: Title ====
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:168
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:228
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:167
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:227
	#, no-wrap
	msgid "_index.adoc"
	msgstr "_index.adoc"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:171
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:170
	msgid ""
	"The _index.adoc file defines some AsciiDoc variables that affect how the "
	"AsciiDoc source is converted to other formats and list the Table of "
	@@ -453,13 +453,13 @@
	"аннотацией."

	#. type: Title ====
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:173
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:172
	#, no-wrap
	msgid "book.adoc"
	msgstr "book.adoc"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:177
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:176
	msgid ""
	"The book.adoc file defines some AsciiDoc variables that affect how the "
	"AsciiDoc source is converted to other formats and list the Table of "
	@@ -474,25 +474,25 @@
	"`asciidoctor-pdf` и для создания книги в виде одной страницы `html`."

	#. type: Title ====
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:179
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:178
	#, no-wrap
	msgid "part*.adoc"
	msgstr "part*.adoc"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:181
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:180
	msgid ""
	"The *part.adoc** files store a brief introduction of one part of the book."
	msgstr "Файлы *part.adoc** содержат краткое введение к одной части книги."

	#. type: Title ====
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:183
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:182
	#, no-wrap
	msgid "directory/_index.adoc"
	msgstr "directory/_index.adoc"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:186
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:185
	msgid ""
	"Each chapter in the Handbook is stored in a file called _index.adoc in a "
	"separate directory from the other chapters."
	@@ -501,19 +501,19 @@
	"каталоге от других глав."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:188
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:187
	msgid "For example, this is an example of the header of one chapter:"
	msgstr "Например, вот пример заголовка одной главы:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:191
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:236
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:190
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:235
	#, no-wrap
	msgid "---\n"
	msgstr "---\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:196
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:195
	#, no-wrap
	msgid ""
	"title: Chapter 8. Configuring the FreeBSD Kernel\n"
	@@ -529,23 +529,23 @@
	"---\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:199
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:198
	msgid "[[kernelconfig]]"
	msgstr "[[kernelconfig]]"

	#. type: Title =
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:199
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:198
	#, no-wrap
	msgid "Configuring the FreeBSD Kernel"
	msgstr "Настройка ядра FreeBSD"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:201
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:200
	msgid "..."
	msgstr "..."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:204
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:203
	msgid ""
	"When the HTML5 version of the Handbook is produced, this will yield "
	"kernelconfig/index.html."
	@@ -554,7 +554,7 @@
	"kernelconfig/index.html."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:206
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:205
	msgid ""
	"A brief look will show that there are many directories with individual "
	"_index.adoc files, including basics/_index.adoc, *introduction/_index."
	@@ -565,7 +565,7 @@
	"adoc* и printing/_index.adoc."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:212
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:211
	msgid ""
	"Do not name chapters or directories after their ordering within the "
	"Handbook. This ordering can change as the content within the Handbook is "
	@@ -579,18 +579,18 @@
	"иерархии."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:215
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:214
	#, no-wrap
	msgid "The Articles: articles/"
	msgstr "Статьи: articles/"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:218
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:217
	msgid "The articles are written in AsciiDoc."
	msgstr "Статьи написаны в AsciiDoc."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:221
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:220
	msgid ""
	"The articles are organized as an AsciiDoc `article`. The articles are "
	"divided into sections (`=`) and subsections (`==`, `===`) and so on."
	@@ -599,18 +599,18 @@
	"разделы (`=`), подразделы (`==`, `===`) и так далее."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:226
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:225
	msgid "There is one _index.adoc file per article."
	msgstr "На каждый статью приходится один файл _index.adoc."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:231
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:230
	msgid ""
	"The _index.adoc file contains all the AsciiDoc variables and the content."
	msgstr "Файл _index.adoc содержит все переменные AsciiDoc и контент."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:233
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:232
	msgid ""
	"For example, this is an example of one article, the structure is pretty "
	"similar to one book chapter:"
	@@ -618,7 +618,7 @@
	"Например, это образец одной статьи, структура довольно похожа на главу книги:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:242
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:241
	#, no-wrap
	msgid ""
	"title: Why you should use a BSD style license for your Open Source Project\n"
	@@ -636,55 +636,54 @@
	"---\n"

	#. type: Title =
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:244
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:243
	#, no-wrap
	msgid "Why you should use a BSD style license for your Open Source Project"
	msgstr "Почему вы должны использовать лицензию в стиле BSD для вашего Open Source проекта"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:253
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:251
	msgid ""
	-":doctype: article :toc: macro :toclevels: 1 :icons: font :sectnums: :"
	-"sectnumlevels: 6 :source-highlighter: rouge :experimental:"
	+":doctype: article :toc: macro :toclevels: 1 :icons: font :sectnums: :source-"
	+"highlighter: rouge :experimental:"
	msgstr ""
	":doctype: article\n"
	":toc: macro\n"
	":toclevels: 1\n"
	":icons: font\n"
	":sectnums:\n"
	-":sectnumlevels: 6\n"
	":source-highlighter: rouge\n"
	":experimental:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:255
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:253
	msgid "'''"
	msgstr "'''"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:257
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:255
	msgid "toc::[]"
	msgstr "toc::[]"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:259
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:257
	msgid "[[intro]]"
	msgstr "[[intro]]"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:259
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:257
	#, no-wrap
	msgid "Introduction"
	msgstr "Введение"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:262
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:260
	#, no-wrap
	msgid "Managing Contributor Lists"
	msgstr "Управление списками участников"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:266
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:264
	msgid ""
	"The FreeBSD project recognizes contributors in several different lists in "
	"the documentation and in printed materials. This section describes how the "
	@@ -695,13 +694,13 @@
	"документации управляет изменениями в этих списках."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:267
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:265
	#, no-wrap
	msgid "Mentor and New Committer Relationship Lists"
	msgstr "Списки отношений наставника и нового коммиттера"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:271
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:269
	msgid ""
	"Since FreeBSD 7.0, FreeBSD has maintained link:https://cgit.freebsd.org/src/"
	"tree/share/misc[three lists of contributor mentor / mentee relationships] - "
	@@ -717,7 +716,7 @@
	"FreeBSD."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:276
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:274
	msgid ""
	"man:dot[1] is installed as part of the package:graphics/graphviz[] package "
	"or port. The [.filename]#dot# program reads files in \".dot\" format and "
	@@ -728,7 +727,7 @@
	"графическое изображение направленного графа."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:281
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:279
	msgid ""
	"The three files often serve as a learning experience for new committers of "
	"all three teams who are instructed to add themselves, and their mentor, to "
	@@ -745,13 +744,13 @@
	"Формат каждой записи поясняется в начале файла."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:282
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:280
	#, no-wrap
	msgid "General Contributor Lists"
	msgstr "Общий список участников"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:286
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:284
	msgid ""
	"extref:{contributors}[Contributors] to FreeBSD are maintained in article "
	"format. The source file for managing the Contributors article file is "
	@@ -761,7 +760,7 @@
	"статьи. Исходный файл для управления статьёй Участники находится по адресу:"

	#. type: delimited block - 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:299
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:297
	#, no-wrap
	msgid ""
	"doc\n"
	@@ -787,7 +786,7 @@
	" [.filename]#contrib-develinmemoriam.po# – Translation page\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:302
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:300
	msgid ""
	"Copies of this contributors directory may exist in other content language "
	"directories."
	@@ -796,7 +795,7 @@
	"контентом на различных языках."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:305
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:303
	msgid ""
	"Note that the file [.filename]#contrib-develinmemoriam.adoc# is also found "
	"in this directory. See below for additional information."
	@@ -805,7 +804,7 @@
	"находится в этом каталоге. Дополнительную информацию смотрите ниже."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:310
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:308
	msgid ""
	"The [.filename]#contributors/_index.adoc# file is designed as a collection "
	"of include files. The include files are listed in the Hugo specific section "
	@@ -820,7 +819,7 @@
	"подраздел для вывода вне веб-сайта (включая PDF)."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:314
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:312
	msgid ""
	"The text for each section of the Contributors page contains an \"include::"
	"\" statement. For example, the entry for \"Port Manager Alumni\" is "
	@@ -833,12 +832,12 @@
	"участниках менеджера портов в итоговый вывод."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:316
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:314
	msgid "To make a change, edit the appropriate include file:"
	msgstr "Чтобы внести изменения, отредактируйте соответствующий include-файл:"

	#. type: delimited block - 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:325
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:323
	#, no-wrap
	msgid ""
	"include-contrib-committers: [.filename]#~/doc/shared/contrib-committers.adoc#\n"
	@@ -856,7 +855,7 @@
	"include-contrib-386bsd: [.filename]#~/doc/shared/contrib-386bsd.adoc#\n"

	#. type: delimited block - 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:328
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:326
	#, no-wrap
	msgid ""
	"Also, edit the [.filename]#authors.adoc# file: [.filename]#~/doc/shared/authors.adoc#\n"
	@@ -866,7 +865,7 @@
	"и все связанные с ним переводы.\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:334
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:332
	msgid ""
	"In general, if a person is being added, there is only one edit necessary, "
	"and they can be added to the appropriate include file. If a person is being "
	@@ -881,221 +880,221 @@
	"Порядок записей для всех файлов указан в таблице ниже."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:337
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:413
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:335
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:411
	#, no-wrap
	msgid "Purpose"
	msgstr "Назначение"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:337
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:413
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:335
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:411
	#, no-wrap
	msgid "Section Anchor"
	msgstr "Якорь раздела"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:337
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:335
	#, no-wrap
	msgid "File in ~/doc/shared/"
	msgstr "Файл в ~/doc/shared/"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:338
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:414
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:336
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:412
	#, no-wrap
	msgid "Order Specification"
	msgstr "Спецификация порядка"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:338
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:336
	#, no-wrap
	msgid "FreeBSD Developers"
	msgstr "Разработчики FreeBSD"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:338
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:336
	#, no-wrap
	msgid "include-contrib-committers"
	msgstr "include-contrib-committers"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:338
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:336
	#, no-wrap
	msgid "[.filename]#contrib-committers.adoc#"
	msgstr "[.filename]#contrib-committers.adoc#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:339
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:337
	#, no-wrap
	msgid "alphabetical order by last name"
	msgstr "упорядочено по алфавиту по фамилии"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:339
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:337
	#, no-wrap
	msgid "Core Team Alumni"
	msgstr "Бывшие члены основной команды"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:339
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:337
	#, no-wrap
	msgid "include-contrib-corealumni"
	msgstr "include-contrib-corealumni"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:339
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:337
	#, no-wrap
	msgid "[.filename]#contrib-corealumni.adoc#"
	msgstr "[.filename]#contrib-corealumni.adoc#"

	#. type: Table
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:338
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:339
	#: documentation/content/en/books/fdp-primer/structure/_index.adoc:340
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:341
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:342
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:415
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:413
	#, no-wrap
	msgid "rough reverse chronological order"
	msgstr "приблизительно в обратном хронологическом порядке"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:340
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:338
	#, no-wrap
	msgid "Development Team Alumni"
	msgstr "Бывшие члены команды разработчиков"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:340
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:338
	#, no-wrap
	msgid "include-contrib-develalumni"
	msgstr "include-contrib-develalumni"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:340
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:338
	#, no-wrap
	msgid "[.filename]#contrib-develalumni.adoc#"
	msgstr "[.filename]#contrib-develalumni.adoc#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:341
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:339
	#, no-wrap
	msgid "Ports Management Team Alumni"
	msgstr "Бывшие члены команды управления портами"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:341
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:339
	#, no-wrap
	msgid "include-contrib-portmgralumni"
	msgstr "include-contrib-portmgralumni"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:341
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:339
	#, no-wrap
	msgid "[.filename]#contrib-portmgralumni.adoc#"
	msgstr "[.filename]#contrib-portmgralumni.adoc#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:342
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:340
	#, no-wrap
	msgid "Additional FreeBSD Contributors"
	msgstr "Дополнительные участники проекта FreeBSD"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:342
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:340
	#, no-wrap
	msgid "include-contrib-additional"
	msgstr "include-contrib-additional"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:342
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:340
	#, no-wrap
	msgid "[.filename]#contrib-additional.adoc#"
	msgstr "[.filename]#contrib-additional.adoc#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:343
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:344
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:341
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:342
	#, no-wrap
	msgid "alphabetical order by first name"
	msgstr "упорядочено по алфавиту по имени"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:343
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:341
	#, no-wrap
	msgid "386BSD Patch Kit Patch Contributors"
	msgstr "Участники, предоставившие патчи для 386BSD Patch Kit"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:343
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:341
	#, no-wrap
	msgid "include-contrib-386bsd"
	msgstr "include-contrib-386bsd"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:343
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:341
	#, no-wrap
	msgid "[.filename]#contrib-386bsd.adoc#"
	msgstr "[.filename]#contrib-386bsd.adoc#"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:344
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:342
	#, no-wrap
	msgid "Contributors to the central server project"
	msgstr "Участники проекта центрального сервера"

	#. type: Table
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:342
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:343
	#: documentation/content/en/books/fdp-primer/structure/_index.adoc:344
	#: documentation/content/en/books/fdp-primer/structure/_index.adoc:345
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:346
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:347
	#, no-wrap
	msgid "No include file used"
	msgstr "Файл include не используется"

	#. type: Table
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:342
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:343
	#: documentation/content/en/books/fdp-primer/structure/_index.adoc:344
	#: documentation/content/en/books/fdp-primer/structure/_index.adoc:345
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:346
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:347
	#, no-wrap
	msgid "[.filename]#contributors/_index.adoc#"
	msgstr "[.filename]#contributors/_index.adoc#"

	#. type: Table
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:343
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:344
	#: documentation/content/en/books/fdp-primer/structure/_index.adoc:345
	#: documentation/content/en/books/fdp-primer/structure/_index.adoc:346
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:347
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:348
	#, no-wrap
	msgid "unordered"
	msgstr "неупорядоченное"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:345
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:343
	#, no-wrap
	msgid "Direct funding"
	msgstr "Прямое финансирование"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:346
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:344
	#, no-wrap
	msgid "Hardware contributors"
	msgstr "Участники, предоставившие оборудование"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:347
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:345
	#, no-wrap
	msgid "Special contributors"
	msgstr "Особые участники"

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:350
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:348
	#, no-wrap
	msgid "\"In Memoriam\" Section"
	msgstr "Раздел \"Памяти\""

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:353
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:351
	msgid ""
	"When notifying the BSD community of the death of a community member, the "
	"following procedure should be used:"
	@@ -1104,7 +1103,7 @@
	"использовать следующую процедуру:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:355
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:353
	msgid ""
	"Use the file [.filename]#~/doc/shared/authors.adoc# to look up the person's "
	"name and attribute reference, such as `{foobsd}`."
	@@ -1113,7 +1112,7 @@
	"человека и ссылки на атрибут, например `{foobsd}`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:357
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:355
	msgid ""
	"If they are a current member of one or more FreeBSD project teams in [."
	"filename]#~/doc/website/content/en/administration.adoc#, remove all "
	@@ -1124,7 +1123,7 @@
	"упоминания их атрибута. Также выполните следующие правки:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:359
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:357
	msgid ""
	"[.filename]#~/doc/shared/contrib-committers.adoc# - Remove the attribute "
	"reference."
	@@ -1133,7 +1132,7 @@
	"атрибут."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:360
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:358
	msgid ""
	"[.filename]#~/doc/shared/contrib-corealumni.adoc# - If they are a _current_ "
	"member of the core team, create an entry showing start and end dates."
	@@ -1143,7 +1142,7 @@
	"начала и окончания."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:361
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:359
	msgid ""
	"[.filename]#~/doc/shared/contrib-develalumni.adoc# - Add the attribute "
	"reference and dates of activity as a committer."
	@@ -1152,7 +1151,7 @@
	"атрибут и даты активности в качестве коммиттера."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:362
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:360
	msgid ""
	"[.filename]#~/doc/shared/contrib-portmgralumni.adoc# - Add the attribute "
	"reference if necessary."
	@@ -1161,12 +1160,12 @@
	"атрибут при необходимости."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:363
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:361
	msgid "[.filename]#~/doc/shared/contrib-additional.adoc# - Remove the entry."
	msgstr "[.filename]#~/doc/shared/contrib-additional.adoc# — Удалите запись."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:365
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:363
	msgid ""
	"[.filename]#~/doc/shared/contrib-386bsd.adoc# - This is a historical "
	"document only. No changes are needed."
	@@ -1175,7 +1174,7 @@
	"исторический документ. Изменения не требуются."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:368
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:366
	msgid ""
	"In the [.filename]#~/doc/shared/authors.adoc# file, comment out (using one "
	"backslash '\\') the email address to avoid creating the email link \"mailto:"
	@@ -1186,20 +1185,20 @@
	"создания ссылки \"mailto:\". См. пример для `itojun` ниже:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:372
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:370
	#, no-wrap
	msgid "[shared/authors.adoc]\n"
	msgstr "[shared/authors.adoc]\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:374
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:380
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:372
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:378
	#, no-wrap
	msgid "[..]\n"
	msgstr "[..]\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:378
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:376
	#, no-wrap
	msgid ""
	":itojun-name: Jun-ichiro Itoh\n"
	@@ -1211,7 +1210,7 @@
	":itojun: {itojun-name} <{itojun-email}>\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:383
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:381
	msgid ""
	"Since the member is deceased (which should be double checked), add them to "
	"the \"In Memoriam\" file [.filename]#contrib-develinmemoriam.adoc#."
	@@ -1220,7 +1219,7 @@
	"файл [.filename]#contrib-develinmemoriam.adoc# \"Памяти ушедших\"."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:386
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:384
	msgid ""
	"Try to find some factual information about their contributions to FreeBSD "
	"over the years and add it with their entry in the file. This may require "
	@@ -1233,12 +1232,12 @@
	"связь с Фондом FreeBSD или поиск в журналах коммитов."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:388
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:386
	msgid "To find the date of their first commit, use:"
	msgstr "Чтобы узнать дату их первого коммита, используйте:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:393
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:391
	#, no-wrap
	msgid ""
	"% cd ~/src\n"
	@@ -1248,7 +1247,7 @@
	"% git log --reverse --author=foobsd # search for first commit of foobsd\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:397
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:395
	msgid ""
	"This will print out their commits in reverse order. The date of the first "
	"commit will be at the top."
	@@ -1256,60 +1255,58 @@
	"Это выведет их коммиты в обратном порядке. Дата первого коммита будет вверху."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:399
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:397
	msgid "Ensure that the format of the dates match other entries:"
	msgstr "Убедитесь, что формат дат соответствует другим записям:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:403
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:401
	#, no-wrap
	msgid "(year of commit bit start - year of commit bit end; RIP year deceased)\n"
	-msgstr ""
	-"(год начала предоставления права коммита - год окончания предоставления "
	-"права коммита; RIP год ухода)\n"
	+msgstr "(год начала предоставления права коммита - год окончания предоставления права коммита; RIP год ухода)\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:405
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:403
	#, no-wrap
	msgid "For example:\n"
	msgstr "Например:\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:407
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:405
	#, no-wrap
	msgid "* Foo BSD (2007 - 2010; RIP 2016)\n"
	msgstr "* Foo BSD (2007 - 2010; RIP 2016)\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:410
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:408
	msgid "Check the ordering of the entries in the file."
	msgstr "Проверьте порядок записей в файле."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:413
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:411
	#, no-wrap
	msgid "File in ~/doc/documentation/content/{language}/articles/contributors/"
	msgstr "Файл в ~/doc/documentation/content/{язык}/articles/contributors/"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:414
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:412
	#, no-wrap
	msgid "Development Team: In Memoriam"
	msgstr "Команда разработчиков: Памяти ушедших"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:414
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:412
	#, no-wrap
	msgid "[.filename]#contrib-develinmemoriam.adoc#"
	msgstr "[.filename]#contrib-develinmemoriam.adoc#"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:418
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:416
	msgid "See the \"In Memoriam\" file for similar entries."
	msgstr "Смотрите файл \"In Memoriam\" для похожих записей."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/structure/_index.adoc:420
	+#: documentation/content/en/books/fdp-primer/structure/_index.adoc:418
	msgid ""
	"Finally, if applicable, move the committer member entry from the \"current\" "
	"section to the \"alumni\" section of the appropriate link:https://cgit."
	diff --git a/documentation/content/ru/books/fdp-primer/translations/_index.adoc b/documentation/content/ru/books/fdp-primer/translations/_index.adoc
	--- a/documentation/content/ru/books/fdp-primer/translations/_index.adoc
	+++ b/documentation/content/ru/books/fdp-primer/translations/_index.adoc
	@@ -128,8 +128,6 @@

	Во-первых, убедитесь, что ваш перевод правильно организован. Это означает, что он должен встраиваться в существующую структуру документации и сразу же собираться.

	-Каталоги ниже этого уровня именуются в соответствии с языковыми кодами, на которых они написаны, как определено в ISO639 ([.filename]#/usr/share/misc/iso639# в версии FreeBSD новее 20 января 1999 года).
	-
	[WARNING]
	====
	Hugo требует коды языков в нижнем регистре. Например, вместо `pt_BR` Hugo использует `pt-br`.
	diff --git a/documentation/content/ru/books/fdp-primer/translations/_index.po b/documentation/content/ru/books/fdp-primer/translations/_index.po
	--- a/documentation/content/ru/books/fdp-primer/translations/_index.po
	+++ b/documentation/content/ru/books/fdp-primer/translations/_index.po
	@@ -5,7 +5,7 @@
	msgid ""
	msgstr ""
	"Project-Id-Version: FreeBSD Documentation VERSION\n"
	-"POT-Creation-Date: 2025-08-17 20:54+0100\n"
	+"POT-Creation-Date: 2026-08-06 22:55+0100\n"
	"PO-Revision-Date: 2025-11-21 04:45+0000\n"
	"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
	"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
	@@ -14,8 +14,8 @@
	"MIME-Version: 1.0\n"
	"Content-Type: text/plain; charset=UTF-8\n"
	"Content-Transfer-Encoding: 8bit\n"
	-"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
	-"n%10<=4 && (n%100<10 \|\| n%100>=20) ? 1 : 2;\n"
	+"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n"
	+"%10<=4 && (n%100<10 \|\| n%100>=20) ? 1 : 2;\n"
	"X-Generator: Weblate 4.17\n"

	#. type: YAML Front Matter: description
	@@ -37,7 +37,7 @@
	msgstr "Переводы"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:52
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:51
	msgid ""
	"This is the FAQ for people translating the FreeBSD documentation (FAQ, "
	"Handbook, tutorials, manual pages, and others) to different languages."
	@@ -46,7 +46,7 @@
	"Руководство, учебные пособия, man-страницы и другие) на различные языки."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:56
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:55
	msgid ""
	"It is _very_ heavily based on the translation FAQ from the FreeBSD German "
	"Documentation Project, originally written by Frank Gründer mailto:"
	@@ -60,13 +60,13 @@
	"de]."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:57
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:56
	#, no-wrap
	msgid "What do i18n and l10n mean?"
	msgstr "Что означают i18n и l10n?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:61
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:60
	msgid ""
	"i18n means internationalization and l10n means localization. They are just "
	"a convenient shorthand."
	@@ -75,7 +75,7 @@
	"сокращения."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:64
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:63
	msgid ""
	"i18n can be read as \"i\" followed by 18 letters, followed by \"n\". "
	"Similarly, l10n is \"l\" followed by 10 letters, followed by \"n\"."
	@@ -84,13 +84,13 @@
	"Аналогично, l10n — это «l», за которым следует 10 букв, а затем «n»."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:65
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:64
	#, no-wrap
	msgid "Is there a mailing list for translators?"
	msgstr "Существует ли рассылка для переводчиков?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:70
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:69
	msgid ""
	"Yes. Different translation groups have their own mailing lists. The https://"
	"www.freebsd.org/docproj/translations[list of translation projects] has more "
	@@ -106,13 +106,13 @@
	"обсуждений, связанных с переводом."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:71
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:70
	#, no-wrap
	msgid "Are more translators needed?"
	msgstr "Нужны дополнительные переводчики?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:74
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:73
	msgid ""
	"Yes. The more people that work on translation the faster it gets done, and "
	"the faster changes to the English documentation are mirrored in the "
	@@ -123,18 +123,18 @@
	"документах."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:76
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:75
	msgid "You do not have to be a professional translator to be able to help."
	msgstr "Вам не нужно быть профессиональным переводчиком, чтобы помочь."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:77
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:76
	#, no-wrap
	msgid "What languages do I need to know?"
	msgstr "Какие языки мне нужно знать?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:80
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:79
	msgid ""
	"Ideally, you will have a good knowledge of written English, and obviously "
	"you will need to be fluent in the language you are translating to."
	@@ -143,7 +143,7 @@
	"свободно владеть языком, на который переводите."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:83
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:82
	msgid ""
	"English is not strictly necessary. For example, you could do a Hungarian "
	"translation of the FAQ from the Spanish translation."
	@@ -152,13 +152,13 @@
	"венгерский перевод FAQ из испанского перевода."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:84
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:83
	#, no-wrap
	msgid "What software do I need to know?"
	msgstr "Какой софт нужно знать?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:88
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:87
	msgid ""
	"It is strongly recommended that you maintain a local copy of the FreeBSD Git "
	"repository (at least the documentation part). This can be done by running:"
	@@ -167,24 +167,24 @@
	"Git (по крайней мере, документации). Это можно сделать, выполнив:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:92
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:91
	#, no-wrap
	msgid "% git clone https://git.FreeBSD.org/doc.git ~/doc\n"
	msgstr "% git clone https://git.FreeBSD.org/doc.git ~/doc\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:95
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:94
	msgid "https://git.FreeBSD.org/[git.FreeBSD.org] is a public `git` server."
	msgstr ""
	"https://git.FreeBSD.org/[git.FreeBSD.org] — это публичный `git` сервер."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:99
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:98
	msgid "This will require the package:git-lite[] package to be installed."
	msgstr "Для этого потребуется установка пакета package:git-lite[] package."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:103
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:102
	msgid ""
	"You should be comfortable using git. This will allow you to see what has "
	"changed between different versions of the files that make up the "
	@@ -195,7 +195,7 @@
	"документация."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:105
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:104
	msgid ""
	"For example, to view the differences between revisions `abff932fe8` and "
	"`2191c44469` of [.filename]#documentation/content/en/articles/committers-"
	@@ -206,13 +206,13 @@
	"guide/_index.adoc#, выполните:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:109
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:108
	#, no-wrap
	msgid "% git diff abff932fe8 2191c44469 documentation/content/en/articles/committers-guide/_index.adoc\n"
	msgstr "% git diff abff932fe8 2191c44469 documentation/content/en/articles/committers-guide/_index.adoc\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:112
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:111
	msgid ""
	"Please see the complete explanation of using Git in FreeBSD in the extref:"
	"{handbook}mirrors[FreeBSD Handbook, git]."
	@@ -221,13 +221,13 @@
	"extref:{handbook}mirrors[Руководстве FreeBSD, git]."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:113
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:112
	#, no-wrap
	msgid "How do I find out who else might be translating to the same language?"
	msgstr "Как узнать, кто ещё, может быть, переводит на тот же язык?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:118
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:117
	msgid ""
	"The https://www.FreeBSD.org/docproj/translations/[Documentation Project "
	"translations page] lists the translation efforts that are currently known "
	@@ -242,7 +242,7 @@
	"узнать, как вы можете помочь."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:120
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:119
	msgid ""
	"If no one is listed on that page as translating for your language, then send "
	"a message to the {freebsd-doc} in case someone else is thinking of doing a "
	@@ -253,13 +253,13 @@
	"сделать перевод, но ещё не объявил об этом."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:121
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:120
	#, no-wrap
	msgid "No one else is translating to my language. What do I do?"
	msgstr "Никто не переводит на мой язык. Что мне делать?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:125
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:124
	msgid ""
	"Congratulations, you have just started the \"FreeBSD _your-language-here_ "
	"Documentation Translation Project\". Welcome aboard."
	@@ -268,7 +268,7 @@
	"на ваш язык\". Добро пожаловать на борт."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:128
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:127
	msgid ""
	"First, decide whether or not you have got the time to spare. Since you are "
	"the only person working on your language at the moment it is going to be "
	@@ -281,7 +281,7 @@
	"возможно, захотят вам помочь."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:130
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:129
	msgid ""
	"Write an email to the Documentation Project mailing list, announcing that "
	"you are going to translate the documentation, so the Documentation Project "
	@@ -292,7 +292,7 @@
	"документации могла быть актуальной."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:132
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:131
	msgid ""
	"If there is already someone in your country providing FreeBSD mirroring "
	"services you should contact them and ask if you can have some webspace for "
	@@ -304,7 +304,7 @@
	"адрес или услуги рассылки."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:135
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:134
	msgid ""
	"Then pick a document and start translating. It is best to start with "
	"something fairly small - either the FAQ, or one of the tutorials."
	@@ -313,13 +313,13 @@
	"относительно небольшого — например, с FAQ или одного из руководств."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:136
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:135
	#, no-wrap
	msgid "I have translated some documentation, where do I send it?"
	msgstr "Я перевел часть документации, куда мне её отправить?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:140
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:139
	msgid ""
	"That depends. If you are already working with a translation team (such as "
	"the Japanese team, or the German team) then they will have their own "
	@@ -331,7 +331,7 @@
	"обработки представленной документации, которые описаны на их веб-страницах."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:142
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:141
	msgid ""
	"If you are the only person working on a particular language (or you are "
	"responsible for a translation project and want to submit your changes back "
	@@ -344,13 +344,13 @@
	"следующий вопрос)."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:143
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:142
	#, no-wrap
	msgid "I am the only person working on translating to this language, how do I submit my translation?"
	msgstr "Я единственный, кто работает над переводом на этот язык, как мне отправить свой перевод?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:147
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:146
	msgid ""
	"First, make sure your translation is organized properly. This means that it "
	"should drop into the existing documentation tree and build straight away."
	@@ -359,19 +359,8 @@
	"что он должен встраиваться в существующую структуру документации и сразу же "
	"собираться."

	-#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:150
	-msgid ""
	-"Directories below this are named according to the language code they are "
	-"written in, as defined in ISO639 ([.filename]#/usr/share/misc/iso639# on a "
	-"version of FreeBSD newer than 20th January 1999)."
	-msgstr ""
	-"Каталоги ниже этого уровня именуются в соответствии с языковыми кодами, на "
	-"которых они написаны, как определено в ISO639 ([.filename]#/usr/share/misc/"
	-"iso639# в версии FreeBSD новее 20 января 1999 года)."
	-
	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:155
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:151
	msgid ""
	"Hugo needs the language codes in lowercase. For example, instead of `pt_BR` "
	"Hugo uses `pt-br`."
	@@ -380,7 +369,7 @@
	"использует `pt-br`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:159
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:155
	msgid ""
	"Currently, the FreeBSD documentation is stored in a top level directory "
	"called [.filename]#documentation/#. Directories below this are named "
	@@ -395,7 +384,7 @@
	"года)."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:161
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:157
	msgid ""
	"If your language can be encoded in different ways (for example, Chinese) "
	"then there should be directories below this, one for each encoding format "
	@@ -406,17 +395,17 @@
	"предоставленных форматов кодировки."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:163
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:159
	msgid "Finally, you should have directories for each document."
	msgstr "Наконец, у вас должны быть каталоги для каждого документа."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:165
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:161
	msgid "For example, a hypothetical Swedish translation might look like:"
	msgstr "Например, гипотетический перевод на шведский язык может выглядеть так:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:174
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:170
	#, no-wrap
	msgid ""
	"documentation/\n"
	@@ -434,7 +423,7 @@
	" _index.adoc\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:178
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:174
	msgid ""
	"`sv` is the name of the translation, in [.filename]#lang# form. Note the "
	"two Makefiles, which will be used to build the documentation."
	@@ -443,7 +432,7 @@
	"на два Makefile, которые будут использоваться для сборки документации."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:180
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:176
	msgid ""
	"Use git diff command to generate a diff and send it to the link:https://"
	"reviews.freebsd.org/[reviews system]."
	@@ -452,13 +441,13 @@
	"link:https://reviews.freebsd.org/[рецензирования]."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:184
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:180
	#, no-wrap
	msgid "% git diff > sv-faq.diff\n"
	msgstr "% git diff > sv-faq.diff\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:188
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:184
	msgid ""
	"You should use Bugzilla to link:https://bugs.freebsd.org/bugzilla/enter_bug."
	"cgi[submit a report] indicating that you have submitted the documentation. "
	@@ -473,7 +462,7 @@
	"его применять, свободно владеет языком."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:191
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:187
	msgid ""
	"Someone (probably the Documentation Project Manager, currently {doceng}) "
	"will then take your translation and confirm that it builds. In particular, "
	@@ -484,12 +473,12 @@
	"будут проверены следующие моменты:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:193
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:189
	msgid "Does `make` in the [.filename]#root# directory work correctly?"
	msgstr "Работает ли `make` в каталоге [.filename]#root# корректно?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:195
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:191
	msgid ""
	"If there are any problems then whoever is looking at the submission will get "
	"back to you to work them out."
	@@ -498,25 +487,25 @@
	"с вами для их решения."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:197
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:193
	msgid ""
	"If there are no problems your translation will be committed as soon as "
	"possible."
	msgstr "Если проблем не возникнет, ваш перевод будет включён как можно скорее."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:198
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:194
	#, no-wrap
	msgid "Can I include language or country specific text in my translation?"
	msgstr "Можно ли включать в перевод текст, специфичный для языка или страны?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:201
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:197
	msgid "We would prefer that you did not."
	msgstr "Мы бы предпочли, чтобы вы этого не делали."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:203
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:199
	msgid ""
	"For example, suppose that you are translating the Handbook to Korean, and "
	"want to include a section about retailers in Korea in your Handbook."
	@@ -525,7 +514,7 @@
	"добавить раздел о розничных продавцах в Корее в ваш Handbook."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:207
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:203
	msgid ""
	"There is no real reason why that information should not be in the English "
	"(or German, or Spanish, or Japanese, or ...) versions as well. It is "
	@@ -540,7 +529,7 @@
	"воспринимаемое присутствие FreeBSD по всему миру, что не так уж и плохо."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:209
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:205
	msgid ""
	"If you have country specific information, please submit it as a change to "
	"the English Handbook (using Bugzilla) and then translate the change back to "
	@@ -552,18 +541,18 @@
	"Руководства."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:211
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:207
	msgid "Thanks."
	msgstr "Спасибо."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:212
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:208
	#, no-wrap
	msgid "Addressing the reader"
	msgstr "Обращение к читателю"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:215
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:211
	msgid ""
	"In the English documents, the reader is addressed as \"you\", there is no "
	"formal/informal distinction as there is in some languages."
	@@ -572,7 +561,7 @@
	"между формальным и неформальным обращением, как в некоторых языках."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:218
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:214
	msgid ""
	"If you are translating to a language which does distinguish, use whichever "
	"form is typically used in other technical documentation in your language. "
	@@ -583,18 +572,18 @@
	"языке. Если сомневаетесь, используйте умеренно вежливую форму."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:219
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:215
	#, no-wrap
	msgid "Do I need to include any additional information in my translations?"
	msgstr "Нужно ли включать какую-либо дополнительную информацию в мои переводы?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:222
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:218
	msgid "Yes."
	msgstr "Да."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:224
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:220
	msgid ""
	"The header of the English version of each document will look something like "
	"this:"
	@@ -602,7 +591,7 @@
	"Заголовок английской версии каждого документа будет выглядеть примерно так:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:232
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:228
	#, no-wrap
	msgid ""
	" ---\n"
	@@ -618,13 +607,13 @@
	" ---\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:234
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:230
	#, no-wrap
	msgid " = Why you should use a BSD style license for your Open Source Project\n"
	msgstr " = Why you should use a BSD style license for your Open Source Project\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:238
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:234
	msgid ""
	"The exact boilerplate may change, but it will always include a $FreeBSD$ "
	"line and the phrase `The FreeBSD Documentation Project`. Note that the "
	@@ -637,7 +626,7 @@
	"должна быть пустой (просто `$FreeBSD$`)."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:240
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:236
	msgid ""
	"Your translated documents should include their own FreeBSD line, and change "
	"the `FreeBSD Documentation Project` line to `The FreeBSD _language_ "
	@@ -648,7 +637,7 @@
	"FreeBSD_язык_Documentation Project`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:242
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:238
	msgid ""
	"In addition, you should add a third line which indicates which revision of "
	"the English text this is based on."
	@@ -657,12 +646,12 @@
	"английского текста опирается перевод."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:244
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:240
	msgid "So, the Spanish version of this file might start:"
	msgstr "Итак, испанская версия этого файла может начинаться с:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:251
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:247
	#, no-wrap
	msgid ""
	" ---\n"
	@@ -676,7 +665,16 @@
	" ---\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/translations/_index.adoc:253
	+#: documentation/content/en/books/fdp-primer/translations/_index.adoc:249
	#, no-wrap
	msgid " = Soporte para segundos intercalares en FreeBSD\n"
	msgstr " = Soporte para segundos intercalares en FreeBSD\n"
	+
	+#~ msgid ""
	+#~ "Directories below this are named according to the language code they are "
	+#~ "written in, as defined in ISO639 ([.filename]#/usr/share/misc/iso639# on "
	+#~ "a version of FreeBSD newer than 20th January 1999)."
	+#~ msgstr ""
	+#~ "Каталоги ниже этого уровня именуются в соответствии с языковыми кодами, "
	+#~ "на которых они написаны, как определено в ISO639 ([.filename]#/usr/share/"
	+#~ "misc/iso639# в версии FreeBSD новее 20 января 1999 года)."
	diff --git a/documentation/content/ru/books/fdp-primer/weblate/_index.adoc b/documentation/content/ru/books/fdp-primer/weblate/_index.adoc
	--- a/documentation/content/ru/books/fdp-primer/weblate/_index.adoc
	+++ b/documentation/content/ru/books/fdp-primer/weblate/_index.adoc
	@@ -78,7 +78,7 @@

	Предоставьте краткое самопредставление в рассылке {freebsd-translators}, чтобы начать процесс предоставления доступа. Это позволит координатору языка или администратору выдать необходимые права новому пользователю Weblate для начала перевода.

	-Ниже приведен пример того, как может выглядеть такое письмо.
	+Ниже приведён пример того, как может выглядеть такое письмо.

	[.programlisting]
	....
	diff --git a/documentation/content/ru/books/fdp-primer/weblate/_index.po b/documentation/content/ru/books/fdp-primer/weblate/_index.po
	--- a/documentation/content/ru/books/fdp-primer/weblate/_index.po
	+++ b/documentation/content/ru/books/fdp-primer/weblate/_index.po
	@@ -5,8 +5,8 @@
	msgid ""
	msgstr ""
	"Project-Id-Version: FreeBSD Documentation VERSION\n"
	-"POT-Creation-Date: 2025-05-01 19:56-0300\n"
	-"PO-Revision-Date: 2026-03-09 04:45+0000\n"
	+"POT-Creation-Date: 2026-08-06 22:55+0100\n"
	+"PO-Revision-Date: 2026-05-18 04:45+0000\n"
	"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
	"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
	"documentation/booksfdp-primerweblate_index/ru/>\n"
	@@ -14,17 +14,15 @@
	"MIME-Version: 1.0\n"
	"Content-Type: text/plain; charset=UTF-8\n"
	"Content-Transfer-Encoding: 8bit\n"
	-"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
	-"n%10<=4 && (n%100<10 \|\| n%100>=20) ? 1 : 2;\n"
	+"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n"
	+"%10<=4 && (n%100<10 \|\| n%100>=20) ? 1 : 2;\n"
	"X-Generator: Weblate 4.17\n"

	#. type: YAML Front Matter: description
	#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:1
	#, no-wrap
	msgid "How to join the FreeBSD translators team and translate online on Weblate"
	-msgstr ""
	-"Как присоединиться к команде переводчиков FreeBSD и переводить онлайн в "
	-"Weblate"
	+msgstr "Как присоединиться к команде переводчиков FreeBSD и переводить онлайн в Weblate"

	#. type: YAML Front Matter: title
	#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:1
	@@ -39,13 +37,13 @@
	msgstr "Переводы в Weblate"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:52
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:51
	#, no-wrap
	msgid "Introduction"
	msgstr "Введение"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:56
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:55
	msgid ""
	"This chapter describes some basic steps for joining the FreeBSD translators "
	"team, translating online on Weblate or offline, and some simple suggestions "
	@@ -58,7 +56,7 @@
	"части, связанной с переводом."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:58
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:57
	msgid ""
	"The original documents (articles and books) are in the {main-site}"
	"[documentation portal]."
	@@ -67,7 +65,7 @@
	"документации]."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:60
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:59
	msgid ""
	"https://weblate.org/en/[Weblate] is web-based open-source software focused "
	"on localization; the FreeBSD project runs a local instance."
	@@ -77,13 +75,13 @@
	"Проект FreeBSD поддерживает собственный экземпляр."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:62
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:61
	#, no-wrap
	msgid "How to Become a FreeBSD Translator"
	msgstr "Как стать переводчиком FreeBSD"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:65
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:64
	msgid ""
	"Following are simple steps to start translating articles and books of the "
	"FreeBSD Documentation Project."
	@@ -92,7 +90,7 @@
	"FreeBSD."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:67
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:66
	msgid ""
	"Create an account on the https://translate-dev.freebsd.org/[FreeBSD Weblate "
	"instance] with an email address or your GitHub account."
	@@ -101,12 +99,12 @@
	"Weblate] с помощью электронной почты или вашего аккаунта GitHub."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:68
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:67
	msgid "Subscribe to the {freebsd-translators}."
	msgstr "Подписаться на список рассылки {freebsd-translators}."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:72
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:71
	msgid ""
	"Introduce yourself and ask to join a language team. If the language team "
	"does not exist, ask to create it. The self-introduction is essential. It "
	@@ -117,19 +115,19 @@
	"обязательно. Оно увеличивает шансы на одобрение доступа на запись."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:73
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:72
	msgid ""
	"Login to https://translate-dev.freebsd.org/[Weblate] with the new account."
	msgstr ""
	"Войдите в https://translate-dev.freebsd.org/[Weblate] с новым аккаунтом."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:74
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:73
	msgid "Find the language team and choose an initial document to translate."
	msgstr "Найдите языковую команду и выберите первый документ для перевода."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:76
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:75
	msgid ""
	"Create a Bugzilla account to submit the translations after finishing a "
	"document. The Documentation project is also accepting GitHub Pull Requests "
	@@ -140,7 +138,7 @@
	"Requests на GitHub с переводами."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:80
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:79
	msgid ""
	"All translation files and documents must follow https://www.freebsd.org/"
	"copyright/freebsd-doc-license/[The FreeBSD Documentation License]; if this "
	@@ -152,13 +150,13 @@
	"исправлений или переводов."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:83
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:82
	#, no-wrap
	msgid "Introduce Yourself"
	msgstr "Представьтесь"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:87
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:86
	msgid ""
	"Please provide a brief self-introduction on the {freebsd-translators} to "
	"initiate the process of granting access. This will enable a language "
	@@ -171,18 +169,18 @@
	"Weblate для начала перевода."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:89
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:88
	msgid "Following is an example of how such an email could look."
	-msgstr "Ниже приведен пример того, как может выглядеть такое письмо."
	+msgstr "Ниже приведён пример того, как может выглядеть такое письмо."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:93
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:92
	#, no-wrap
	msgid "Subject: Self-Introduction: Name and language\n"
	msgstr "Subject: Self-Introduction: Name and language\n"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:105
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:104
	#, no-wrap
	msgid ""
	"Name: Name (use preferred name)\n"
	@@ -203,46 +201,44 @@
	"Language: Language to translate (essential)\n"
	"Profession or student status: (optional)\n"
	"About You: (free format -- info which you feel comfortable sharing with\n"
	-" others: company, school, other affiliation, historical qualifications, "
	-"other\n"
	-" projects you have worked on, level and type of computer skills, other "
	-"relevant skills,\n"
	+" others: company, school, other affiliation, historical qualifications, other\n"
	+" projects you have worked on, level and type of computer skills, other relevant skills,\n"
	" etc.)\n"
	"You and the FreeBSD Project: (free format: other FreeBSD projects of\n"
	" interest, comments, etc.)\n"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:108
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:107
	#, no-wrap
	msgid "Login to Weblate"
	msgstr "Вход в Weblate"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:111
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:110
	msgid "Open https://translate-dev.freebsd.org/[] and `Sign in`."
	msgstr "Откройте https://translate-dev.freebsd.org/[] и `Войдите` (Sign in)."

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:112
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:111
	#, no-wrap
	msgid "Weblate Login"
	msgstr "Логин в Webleate"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:112
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:111
	#, no-wrap
	msgid "weblate-login.png"
	msgstr "weblate-login.png"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:115
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:114
	msgid "Use a username, email address, or GitHub account to log in."
	msgstr ""
	"Используйте имя пользователя, адрес электронной почты или учётную запись "
	"GitHub для входа."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:118
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:117
	msgid ""
	"The user profile contains your preferences, name, and email address. The "
	"name and address will be used in commits; keep this information accurate."
	@@ -252,28 +248,28 @@
	"информацию актуальной."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:122
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:121
	msgid ""
	"On the FreeBSD Weblate instance, all translations will be committed to "
	"https://github.com/freebsd/freebsd-doc-translate[freebsd-doc-translate] (an "
	"intermediate repository on GitHub), not directly to https://github.com/"
	"freebsd/freebsd-doc[freebsd-doc]. Translators must take the PO gettext "
	-"files (`.po`), converting them to `.adoc` and submit it via https://"
	-"bugs.freebsd.org/bugzilla/[Bugzilla] or https://github.com/freebsd/freebsd-"
	-"doc/pulls[GitHub] to get the translated document published or updated in the "
	+"files (`.po`), converting them to `.adoc` and submit it via https://bugs."
	+"freebsd.org/bugzilla/[Bugzilla] or https://github.com/freebsd/freebsd-doc/"
	+"pulls[GitHub] to get the translated document published or updated in the "
	"documentation portal. See more in the following sections."
	msgstr ""
	-"На экземпляре Weblate FreeBSD все переводы будут зафиксированы в "
	-"https://github.com/freebsd/freebsd-doc-translate[freebsd-doc-translate] ("
	-"промежуточном репозитории на GitHub), а не напрямую в https://github.com/"
	+"На экземпляре Weblate FreeBSD все переводы будут зафиксированы в https://"
	+"github.com/freebsd/freebsd-doc-translate[freebsd-doc-translate] "
	+"(промежуточном репозитории на GitHub), а не напрямую в https://github.com/"
	"freebsd/freebsd-doc[freebsd-doc]. Переводчики должны брать файлы PO gettext "
	-"(`.po`), преобразовывать их в `.adoc` и отправлять через https://bugs.freebsd"
	-".org/bugzilla/[Bugzilla] или https://github.com/freebsd/freebsd-doc/"
	+"(`.po`), преобразовывать их в `.adoc` и отправлять через https://bugs."
	+"freebsd.org/bugzilla/[Bugzilla] или https://github.com/freebsd/freebsd-doc/"
	"pulls[GitHub], чтобы переведённый документ был опубликован или обновлён в "
	"портале документации. Подробнее см. в следующих разделах."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:124
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:123
	msgid ""
	"Weblate will commit daily, at least to `freebsd-doc-translate`, if any new "
	"strings are translated."
	@@ -282,13 +278,13 @@
	"translate`, если есть новые переведённые строки."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:126
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:125
	#, no-wrap
	msgid "Find a Language Team to Join In"
	msgstr "Найти команду локализации для участия"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:129
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:128
	msgid ""
	"Click `Projects`, choose `Documentation`, then click `Languages`, and see "
	"all the available languages."
	@@ -297,19 +293,19 @@
	"все доступные языки."

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:130
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:129
	#, no-wrap
	msgid "Weblate Languages"
	msgstr "Языки в Weblate"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:130
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:129
	#, no-wrap
	msgid "weblate-languages.png"
	msgstr "weblate-languages.png"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:133
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:132
	msgid ""
	"Note that some languages and translated documents already exist in the "
	"documentation portal and repositories."
	@@ -318,7 +314,7 @@
	"в портале документации и репозиториях."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:136
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:135
	msgid ""
	"If the desired language for translation is not available in Weblate, please "
	"contact the https://www.freebsd.org/docproj/translations/[language "
	@@ -331,13 +327,13 @@
	"обратитесь по адресу: {doceng}."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:138
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:137
	#, no-wrap
	msgid "Translating Online on Weblate"
	msgstr "Перевод онлайн на Weblate"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:141
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:140
	msgid ""
	"Translating documents online proves to be the easiest method for document "
	"translation on FreeBSD, as it allows users to collaborate on the same file, "
	@@ -348,7 +344,7 @@
	"над одним файлом, распределяя нагрузку."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:143
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:142
	msgid ""
	"Once a coordinator or administrator grants access to a specific language for "
	"a username, the save button will be enabled, so that this user can start "
	@@ -359,31 +355,31 @@
	"сможет начать перевод."

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:144
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:143
	#, no-wrap
	msgid "Weblate Documents"
	msgstr "Weblate Документы"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:144
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:143
	#, no-wrap
	msgid "weblate-documents.png"
	msgstr "weblate-documents.png"

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:145
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:144
	#, no-wrap
	msgid "Weblate Translate"
	msgstr "Weblate Translate"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:145
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:144
	#, no-wrap
	msgid "weblate-translate.png"
	msgstr "weblate-translate.png"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:151
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:150
	msgid ""
	"Weblate has a set of links that lead to actual translation. The translation "
	"is further divided into individual checks, like `Untranslated` or `Needing "
	@@ -399,7 +395,7 @@
	"воспользоваться полем поиска, чтобы найти конкретную строку или термин."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:153
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:152
	msgid ""
	"In the https://docs.weblate.org/en/latest/user/translating.html#translation-"
	"projects[Weblate documentation], there is more info about translations, like "
	@@ -411,13 +407,13 @@
	"инструментом перевода."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:155
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:154
	#, no-wrap
	msgid "Translating Offline"
	msgstr "Перевод в автономном режиме"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:159
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:158
	msgid ""
	"Weblate on FreeBSD uses PO gettext files for translations. Users familiar "
	"with PO gettext files that want to translate offline can download and upload "
	@@ -430,25 +426,25 @@
	"в меню `Files`."

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:160
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:159
	#, no-wrap
	msgid "Weblate Offline"
	msgstr "Weblate Offline"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:160
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:159
	#, no-wrap
	msgid "weblate-offline.png"
	msgstr "weblate-offline.png"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:163
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:162
	#, no-wrap
	msgid "Translation based on Automatic Suggestions"
	msgstr "Перевод на основе автоматических предложений"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:166
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:165
	msgid ""
	"Languages using Weblate before the migration to Hugo/Asciidoctor can use "
	"this feature from Weblate to save time."
	@@ -457,7 +453,7 @@
	"использовать эту функцию в Weblate для экономии времени."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:169
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:168
	msgid ""
	"This feature from Weblate uses the Translation Memory generated by the other "
	"components and projects on the same server. The former Weblate translations "
	@@ -468,7 +464,7 @@
	"Weblate сохранены на том же сервере в режиме только для чтения."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:172
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:171
	msgid ""
	"Strings that match `100/100` in similarity can be copied and saved "
	"directly. Other strings will need at least minor adjustment."
	@@ -478,24 +474,24 @@
	"незначительная корректировка."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:174
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:173
	msgid "Some examples:"
	msgstr "Некоторые примеры:"

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:175
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:174
	#, no-wrap
	msgid "Weblate Automatic Suggestions 01"
	msgstr "Weblate Автоматические предложения 01"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:175
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:174
	#, no-wrap
	msgid "weblate_automatic_suggestion_01.png"
	msgstr "weblate_automatic_suggestion_01.png"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:180
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:179
	msgid ""
	"With the migration to Hugo/Asciidoctor, documents use UTF-8. Some HTML "
	"entities should be replaced. Some strings, such as links, require changes "
	@@ -506,42 +502,42 @@
	"изменений в разметке."

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:181
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:180
	#, no-wrap
	msgid "Weblate Automatic Suggestions 02"
	msgstr "Weblate Автоматические предложения 02"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:181
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:180
	#, no-wrap
	msgid "weblate_automatic_suggestion_02.png"
	msgstr "weblate_automatic_suggestion_02.png"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:184
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:183
	msgid "Links:"
	msgstr "Ссылки:"

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:185
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:184
	#, no-wrap
	msgid "Weblate Automatic Suggestions 03"
	msgstr "Weblate Автоматические предложения 03"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:185
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:184
	#, no-wrap
	msgid "weblate_automatic_suggestion_03.png"
	msgstr "weblate_automatic_suggestion_03.png"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:188
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:187
	#, no-wrap
	msgid "Proofreading and Weblate Quality Checks"
	msgstr "Вычитка и проверка качества в Weblate"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:192
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:191
	msgid ""
	"The document dashboard `Project/Language/Document` shows the translation "
	"status and string status for that document. This page is handy for "
	@@ -552,19 +548,19 @@
	"проверки качества."

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:193
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:192
	#, no-wrap
	msgid "Weblate Revision 01"
	msgstr "Weblate Ревизия 01"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:193
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:192
	#, no-wrap
	msgid "weblate-revision1.png"
	msgstr "weblate-revision1.png"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:196
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:195
	msgid ""
	"In this example, two strings are missing the full stop; following that link "
	"will show only those strings to be revised/translated."
	@@ -573,19 +569,19 @@
	"только те строки, которые нужно пересмотреть/перевести."

	#. type: Positional ($1) AttributeList argument for macro 'image'
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:197
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:196
	#, no-wrap
	msgid "Weblate Revision 02"
	msgstr "Weblate Ревизия 02"

	#. type: Target for macro image
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:197
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:196
	#, no-wrap
	msgid "weblate-revision2.png"
	msgstr "weblate-revision2.png"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:200
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:199
	msgid ""
	"Translators and reviewers often value observing translated strings in "
	"context."
	@@ -594,13 +590,13 @@
	"в контексте."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:202
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:201
	#, no-wrap
	msgid "Building the Translated Document"
	msgstr "Сборка переведенного документа"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:206
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:205
	msgid ""
	"The project does not use continuous integration and continuous delivery to "
	"build translations. There are studies to make it available."
	@@ -609,7 +605,7 @@
	"сборки переводов. Ведутся исследования по внедрению этой возможности."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:211
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:210
	msgid ""
	"The following example uses GitHub, as Weblate is also on GitHub. Note that "
	"this repository is a read-only mirror, but Pull Requests are accepted."
	@@ -619,48 +615,46 @@
	"но Pull Requests принимаются."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:214
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:213
	msgid "To build the translation locally, follow these steps:"
	msgstr "Для локальной сборки перевода выполните следующие шаги:"

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:219
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:218
	#, no-wrap
	msgid "Procedure: Clone the necessary repositories"
	msgstr "Процедура: Клонирование необходимых репозиториев"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:221
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:220
	msgid "Clone the `freebsd-doc` repository:"
	msgstr "Клонирование репозитория `freebsd-doc`:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:225
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:224
	#, no-wrap
	msgid "% git clone https://github.com/freebsd/freebsd-doc.git ~/freebsd-doc\n"
	msgstr "% git clone https://github.com/freebsd/freebsd-doc.git ~/freebsd-doc\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:228
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:227
	msgid "Clone the `freebsd-doc-translate` repository:"
	msgstr "Клонирование репозитория `freebsd-doc-translate`:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:232
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:231
	#, no-wrap
	msgid "% git clone https://github.com/freebsd/freebsd-doc-translate.git ~/freebsd-doc-translate\n"
	-msgstr ""
	-"% git clone https://github.com/freebsd/freebsd-doc-translate.git ~/freebsd-"
	-"doc-translate\n"
	+msgstr "% git clone https://github.com/freebsd/freebsd-doc-translate.git ~/freebsd-doc-translate\n"

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:239
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:238
	#, no-wrap
	msgid "Procedure: Copy a translation file to `freebsd-doc`"
	msgstr "Процедура: Копирование файла перевода в `freebsd-doc`"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:243
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:242
	msgid ""
	"With both repositories in place, copy the translation from `freebsd-doc-"
	"translate` to `freebsd-doc`. Example of the Committer's Guide article "
	@@ -671,46 +665,45 @@
	"испанском языке."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:248
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:247
	#, no-wrap
	msgid ""
	"% cp ~/freebsd-doc-translate/documentation/content/es/articles/committers-guide/_index.po \\\n"
	"~/freebsd-doc/documentation/content/es/articles/committers-guide/\n"
	msgstr ""
	-"% cp ~/freebsd-doc-translate/documentation/content/es/articles/"
	-"committers-guide/_index.po \\\n"
	+"% cp ~/freebsd-doc-translate/documentation/content/es/articles/committers-guide/_index.po \\\n"
	"~/freebsd-doc/documentation/content/es/articles/committers-guide/\n"

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:255
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:254
	#, no-wrap
	msgid "Procedure: Convert a translation file (`.po`) to `.adoc`"
	msgstr "Процедура: Преобразование файла перевода (`.po`) в `.adoc`"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:258
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:257
	msgid "Go to the root of `freebsd-doc`."
	msgstr "Перейдите в корень `freebsd-doc`."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:262
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:261
	#, no-wrap
	msgid "% cd ~/freebsd-doc\n"
	msgstr "% cd ~/freebsd-doc\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:265
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:264
	msgid "Translate (convert) the `.po` file to `.adoc`"
	msgstr "Преобразовать файл `.po` в `.adoc`"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:269
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:268
	#, no-wrap
	msgid "% ./tools/translate.sh documentation es articles/committers-guide\n"
	msgstr "% ./tools/translate.sh documentation es articles/committers-guide\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:272
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:271
	msgid ""
	"By default: only files with more than eighty percent of strings translated "
	"will be converted to `.adoc`."
	@@ -719,20 +712,18 @@
	"переведённых строк будут преобразованы в `.adoc`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:274
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:273
	msgid "To ignore that limit:"
	msgstr "Чтобы игнорировать это ограничение:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:278
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:277
	#, no-wrap
	msgid "% KEEP_ENV=0 ./tools/translate.sh documentation es articles/committers-guide\n"
	-msgstr ""
	-"% KEEP_ENV=0 ./tools/translate.sh documentation es articles/committers-"
	-"guide\n"
	+msgstr "% KEEP_ENV=0 ./tools/translate.sh documentation es articles/committers-guide\n"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:285
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:284
	msgid ""
	"Some documents, like books, have many PO gettext files. Always copy all of "
	"them when translating and building. Files that weren't translated will be "
	@@ -743,7 +734,7 @@
	"переведены, будут преобразованы с исходными (английскими) строками."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:290
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:289
	msgid ""
	"The directory structure is fundamental. Always follow the English document "
	"directory structure."
	@@ -752,18 +743,18 @@
	"каталогов английского документа."

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:296
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:295
	#, no-wrap
	msgid "Procedure: Build the translated document"
	msgstr "Процедура: Сборка переведенного документа"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:299
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:298
	msgid "Last, the building part."
	msgstr "Наконец, часть сборки."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:301
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:300
	msgid ""
	"Enter the documentation directory because there is no need to build the "
	"FreeBSD website."
	@@ -772,13 +763,13 @@
	"требуется."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:305
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:304
	#, no-wrap
	msgid "% cd documentation\n"
	msgstr "% cd documentation\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:309
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:308
	msgid ""
	"And build the documentation. Note that `en` is always added by default when "
	"building any other language."
	@@ -787,13 +778,13 @@
	"умолчанию при сборке любого другого языка."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:313
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:312
	#, no-wrap
	msgid "% DOC_LANG=es make\n"
	msgstr "% DOC_LANG=es make\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:318
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:317
	msgid ""
	"This command will build only the English and Spanish documents of the "
	"FreeBSD documentation portal. The output will be in the [.filename]#public# "
	@@ -806,7 +797,7 @@
	"перенаправлять браузер на онлайн-страницу."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:320
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:319
	msgid ""
	"Another good option is to build and serve the content with Hugo's internal "
	"webserver:"
	@@ -815,13 +806,13 @@
	"встроенного веб-сервера Hugo:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:324
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:323
	#, no-wrap
	msgid "% DOC_LANG=es make run\n"
	msgstr "% DOC_LANG=es make run\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:327
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:326
	msgid ""
	"By default, the webserver listens on `localhost`; To override this behavior, "
	"specify the desired IP address in the `BIND` parameter value."
	@@ -830,13 +821,13 @@
	"поведение, укажите нужный IP-адрес в значении параметра `BIND`."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:331
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:330
	#, no-wrap
	msgid "% DOC_LANG=es make run BIND=192.168.15.10\n"
	msgstr "% DOC_LANG=es make run BIND=192.168.15.10\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:334
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:333
	msgid ""
	"This builds and serves the content with Hugo's internal webserver and lets "
	"it open, and if any file changes, it rebuilds them automatically."
	@@ -846,7 +837,7 @@
	"пересобирает их."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:337
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:336
	msgid ""
	"To make any necessary adjustments in the translation, follow the steps below "
	"to re-sync all components:"
	@@ -855,21 +846,21 @@
	"повторной синхронизации всех компонентов:"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:339
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:338
	msgid ""
	"Fix the translation string on https://translate-dev.freebsd.org/[Weblate]."
	msgstr ""
	"Исправьте строку перевода на https://translate-dev.freebsd.org/[Weblate]."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:340
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:339
	msgid ""
	"Force Weblate to commit the changes on `Document/Manage/Commit` section."
	msgstr ""
	"Заставьте Weblate зафиксировать изменения в разделе `Document/Manage/Commit`."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:341
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:340
	msgid ""
	"Sync the local Weblate repository `freebsd-doc-translate` with a `git pull "
	"origin main` command."
	@@ -878,18 +869,18 @@
	"помощью команды `git pull origin main`."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:342
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:341
	msgid "Copy the translation again to `freebsd-doc`."
	msgstr "Скопируйте перевод снова в `freebsd-doc`."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:343
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:342
	msgid ""
	"Convert the translation to .adoc with the `./tools/translate.sh` script."
	msgstr "Преобразуйте перевод в .adoc с помощью скрипта `./tools/translate.sh`."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:344
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:343
	msgid ""
	"Hugo will rebuild the file and not build the entire set if `make run` was "
	"used; or re-execute `make`."
	@@ -898,7 +889,7 @@
	"команда `make run`, или повторно выполнит `make`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:348
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:347
	msgid ""
	"Follow the previous steps as many times as is necessary until the document "
	"is ready to be published."
	@@ -907,7 +898,7 @@
	"будет готов к публикации."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:351
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:350
	msgid ""
	"The crossref:doc-build[doc-build-rendering,Documentation Build Process] "
	"chapter includes information about rendering to HTML and PDF."
	@@ -916,13 +907,13 @@
	"содержит информацию о преобразовании в HTML и PDF."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:353
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:352
	#, no-wrap
	msgid "Submitting Translations"
	msgstr "Отправка переводов"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:356
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:355
	msgid ""
	"Example of submitting an update to the Brazilian Portuguese article "
	"Committer's Guide."
	@@ -931,13 +922,13 @@
	"Committer's Guide."

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:362
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:361
	#, no-wrap
	msgid "Check the repository"
	msgstr "Проверка репозитория"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:366
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:365
	msgid ""
	"After following the steps in crossref:weblate[weblate-building,Building the "
	"Translated Document], go to the root of `freebsd-doc` and preview what's to "
	@@ -950,7 +941,7 @@
	"файлов и различий в их содержимом:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:371
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:370
	#, no-wrap
	msgid ""
	"% git status\n"
	@@ -960,7 +951,7 @@
	"% git diff\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:374
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:373
	msgid ""
	"Review the output, and if any files unrelated to the Committer's Guide "
	"translation update were changed or added, take the appropriate action of "
	@@ -972,7 +963,7 @@
	"чем продолжить."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:376
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:375
	msgid ""
	"Always include the PO gettext file (`.po`) and the translated document in "
	"Hugo/Asciidoctor (`.adoc`)."
	@@ -981,13 +972,13 @@
	"Asciidoctor (`.adoc`)."

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:382
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:381
	#, no-wrap
	msgid "Create a new branch and commit"
	msgstr "Создать новую ветку и зафиксировать изменения"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:385
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:384
	msgid ""
	"Create another branch to separate the work, which will help with future "
	"updates in the local repository."
	@@ -996,18 +987,18 @@
	"обновлениях в локальном репозитории."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:389
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:388
	#, no-wrap
	msgid "% git checkout -b committers-guide_pt-br\n"
	msgstr "% git checkout -b committers-guide_pt-br\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:392
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:391
	msgid "Register the local commit."
	msgstr "Зарегистрировать локальный коммит."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:397
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:396
	#, no-wrap
	msgid ""
	"% git add .\n"
	@@ -1017,18 +1008,18 @@
	"% git commit\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:400
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:399
	msgid "Example of commit messages for translations:"
	msgstr "Пример сообщений коммитов для переводов:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:404
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:403
	#, no-wrap
	msgid "pt-br/committers-guide: Sync with en XXXXXXX\n"
	msgstr "pt-br/committers-guide: Sync with en XXXXXXX\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:407
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:406
	msgid ""
	"Where `XXXXXXX` is the man:git[1] revision stored in the Weblate repository "
	"[.filename]#~/freebsd-doc-translate/revision.txt#."
	@@ -1037,18 +1028,18 @@
	"файле [.filename]#~/freebsd-doc-translate/revision.txt#."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:409
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:408
	msgid "If it is the first translation of an article:"
	msgstr "Если это первый перевод статьи:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:413
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:412
	#, no-wrap
	msgid "Add Korean translation of Leap Seconds article\n"
	msgstr "Add Korean translation of Leap Seconds article\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:418
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:417
	msgid ""
	"A message will be displayed after the commit if man:git[1] has not been "
	"configured previously. Please follow the instructions and provide the name "
	@@ -1061,7 +1052,7 @@
	"участников."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:420
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:419
	msgid ""
	"Then check the entire commit, review changes, and author name and email."
	msgstr ""
	@@ -1069,24 +1060,24 @@
	"адрес электронной почты."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:424
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:423
	#, no-wrap
	msgid "% git show\n"
	msgstr "% git show\n"

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:431
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:430
	#, no-wrap
	msgid "Generate a patch"
	msgstr "Сгенерировать патч"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:434
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:433
	msgid "Next, generate a man:git-format-patch[1] file."
	msgstr "Далее создайте файл man:git-format-patch[1]."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:439
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:438
	#, no-wrap
	msgid ""
	"% git format-patch main\n"
	@@ -1096,7 +1087,7 @@
	"0001-pt-br-committers-guide-Sync-with-en-XXXXXXX.patch\n"

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:443
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:442
	msgid ""
	"Attach the patch [.filename]#0001-pt-br-committers-guide-Sync-with-en-"
	"XXXXXXX.patch# to a problem report in https://bugs.freebsd.org/bugzilla/"
	@@ -1107,111 +1098,107 @@
	"Bugzilla]."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:445
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:444
	msgid "Include the following information in the report:"
	msgstr "Включите следующую информацию в отчёт:"

	#. type: Block title
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:447
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:446
	#, no-wrap
	msgid "Bugzilla Fields"
	msgstr "Поля Bugzilla"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:451
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:450
	#, no-wrap
	msgid "Field"
	msgstr "Поле"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:453
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:452
	#, no-wrap
	msgid "Value"
	msgstr "Значение"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:454
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:453
	#, no-wrap
	msgid "product"
	msgstr "продукт (product)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:456
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:455
	#, no-wrap
	msgid "Documentation"
	msgstr "Documentation"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:457
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:456
	#, no-wrap
	msgid "Component"
	msgstr "Компонент (Component)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:459
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:458
	#, no-wrap
	msgid "Books & Articles"
	msgstr "Books & Articles"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:460
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:459
	#, no-wrap
	msgid "Summary"
	msgstr "Сводка (Summary)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:462
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:461
	#, no-wrap
	msgid "Same as the local commit"
	msgstr "Тот же текст, что и в локальном коммите"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:463
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:462
	#, no-wrap
	msgid "Description"
	msgstr "Описание (Description)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:467
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:466
	#, no-wrap
	msgid ""
	"State that instructions in this guide were followed, including proofreading and other necessary steps.\n"
	"Include things that may help with triage and progression of the report."
	msgstr ""
	-"Укажите, что инструкции в этом руководстве были выполнены, включая вычитку и "
	-"другие необходимые шаги.\n"
	+"Укажите, что инструкции в этом руководстве были выполнены, включая вычитку и другие необходимые шаги.\n"
	"Включите сведения, которые могут помочь с анализом и продвижением отчёта."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:468
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:467
	#, no-wrap
	msgid "CC (Optional)"
	msgstr "СС (Необязательно)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:469
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:468
	#, no-wrap
	msgid "If the language has coordinators, include their email addresses in the CC field."
	-msgstr ""
	-"Если в языке есть координаторы, укажите их адреса электронной почты в поле "
	-"CC."
	+msgstr "Если в языке есть координаторы, укажите их адреса электронной почты в поле CC."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:472
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:471
	msgid ""
	"For people familiar with man:git[1] and GitHub: instead of submitting the "
	-"patch through https://bugs.freebsd.org/bugzilla/[Bugzilla], a https://"
	-"github.com/freebsd/freebsd-doc/pulls[GitHub pull request] can be used (use "
	-"the name and address that you use with Weblate)."
	+"patch through https://bugs.freebsd.org/bugzilla/[Bugzilla], a https://github."
	+"com/freebsd/freebsd-doc/pulls[GitHub pull request] can be used (use the name "
	+"and address that you use with Weblate)."
	msgstr ""
	"Для тех, кто знаком с man:git[1] и GitHub: вместо отправки исправления через "
	-"https://bugs.freebsd.org/bugzilla/[Bugzilla], можно использовать "
	-"https://github.com/freebsd/freebsd-doc/pulls[запрос на включение изменений ("
	-"pull request) в GitHub] (укажите имя и адрес, которые вы используете в "
	-"Weblate)."
	+"https://bugs.freebsd.org/bugzilla/[Bugzilla], можно использовать https://"
	+"github.com/freebsd/freebsd-doc/pulls[запрос на включение изменений (pull "
	+"request) в GitHub] (укажите имя и адрес, которые вы используете в Weblate)."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:475
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:474
	msgid ""
	"https://github.com/freebsd/freebsd-doc/ is a secondary mirror. Changes to "
	"the `doc` tree can be made only by people who have a `doc` commit bit."
	@@ -1221,7 +1208,7 @@
	"(`doc commit bit`)."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:477
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:476
	msgid ""
	"When translators keep sending good-quality patches, they can be nominated by "
	"other committers to receive write-access (a extref:{committers-guide}[doc "
	@@ -1229,12 +1216,12 @@
	"associated perks."
	msgstr ""
	"Когда переводчики продолжают присылать качественные исправления, другие "
	-"коммиттеры могут выдвинуть их для получения прав на запись (extref"
	-":{committers-guide}[бит коммита для документации, committer.types] для "
	+"коммиттеры могут выдвинуть их для получения прав на запись (extref:"
	+"{committers-guide}[бит коммита для документации, committer.types] для "
	"переводов), учётной записи FreeBSD и сопутствующих привилегий."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:479
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:478
	msgid ""
	"The list of extref:{contributors}[Additional FreeBSD Contributors, contrib-"
	"additional] includes non-committers whose contributions are committed to the "
	@@ -1245,25 +1232,25 @@
	"`doc`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:481
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:480
	msgid "If in doubt about any procedure, write to the {freebsd-translators}."
	msgstr ""
	"Если вы сомневаетесь в каком-либо действии, напишите в {freebsd-translators}."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:483
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:482
	#, no-wrap
	msgid "FAQ (Frequently Asked Questions)"
	msgstr "FAQ (Часто задаваемые Вопросы)"

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:486
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:485
	#, no-wrap
	msgid "Is it necessary to translate all the Copyright messages?"
	msgstr "Нужно ли переводить все сообщения об авторских правах?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:488
	+#: documentation/content/en/books/fdp-primer/weblate/_index.adoc:487
	msgid ""
	"Every language team decides this for their language; in `pt-br` (Brazilian "
	"Portuguese) team, it was decided not to translate those messages."
	diff --git a/documentation/content/ru/books/fdp-primer/writing-style/_index.adoc b/documentation/content/ru/books/fdp-primer/writing-style/_index.adoc
	--- a/documentation/content/ru/books/fdp-primer/writing-style/_index.adoc
	+++ b/documentation/content/ru/books/fdp-primer/writing-style/_index.adoc
	@@ -100,7 +100,7 @@
	Используйте серийную запятую::
	В списке элементов внутри абзаца разделяйте каждый элемент запятой. Последний элемент отделяйте от остальных запятой и словом "and".
	+
	-Например:
	+Для примера:
	+
	This is a list of one, two and three items (Вот список из одного, двух и трёх элементов).
	+
	diff --git a/documentation/content/ru/books/fdp-primer/writing-style/_index.po b/documentation/content/ru/books/fdp-primer/writing-style/_index.po
	--- a/documentation/content/ru/books/fdp-primer/writing-style/_index.po
	+++ b/documentation/content/ru/books/fdp-primer/writing-style/_index.po
	@@ -5,8 +5,8 @@
	msgid ""
	msgstr ""
	"Project-Id-Version: FreeBSD Documentation VERSION\n"
	-"POT-Creation-Date: 2025-05-01 19:56-0300\n"
	-"PO-Revision-Date: 2026-03-08 09:11+0000\n"
	+"POT-Creation-Date: 2026-08-06 22:55+0100\n"
	+"PO-Revision-Date: 2026-08-08 08:11+0000\n"
	"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
	"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
	"documentation/booksfdp-primerwriting-style_index/ru/>\n"
	@@ -22,9 +22,7 @@
	#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:1
	#, no-wrap
	msgid "Writing Style and some conventions used in the FreeBSD Documentation Project"
	-msgstr ""
	-"Стиль написания и некоторые соглашения, используемые в проекте документации "
	-"FreeBSD"
	+msgstr "Стиль написания и некоторые соглашения, используемые в проекте документации FreeBSD"

	#. type: YAML Front Matter: title
	#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:1
	@@ -39,13 +37,13 @@
	msgstr "Стиль написания"

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:52
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:51
	#, no-wrap
	msgid "Tips"
	msgstr "Советы"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:58
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:57
	msgid ""
	"Technical documentation can be improved by consistent use of several "
	"principles. Most of these can be classified into three goals: _be clear_, "
	@@ -59,13 +57,13 @@
	"между ними."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:60
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:59
	#, no-wrap
	msgid "Be Clear"
	msgstr "Будьте понятны"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:65
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:64
	msgid ""
	"Clarity is extremely important. The reader may be a novice, or reading the "
	"document in a second language. Strive for simple, uncomplicated text that "
	@@ -76,7 +74,7 @@
	"который чётко объясняет концепции."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:69
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:68
	msgid ""
	"Avoid flowery or embellished speech, jokes, or colloquial expressions. "
	"Write as simply and clearly as possible. Simple text is easier to "
	@@ -86,7 +84,7 @@
	"Пишите как можно проще и яснее. Простой текст легче понять и перевести."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:74
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:73
	msgid ""
	"Keep explanations as short, simple, and clear as possible. Avoid empty "
	"phrases like \"in order to\", which usually just means \"to\". Avoid "
	@@ -101,7 +99,7 @@
	"пределами академических или научных кругов."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:78
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:77
	msgid ""
	"Write in a formal style. Avoid addressing the reader as \"you\". For "
	"example, say \"copy the file to [.filename]#/tmp#\" rather than \"you can "
	@@ -112,7 +110,7 @@
	"filename]#/tmp#\", а не \"вы можете скопировать файл в [.filename]#/tmp#\"."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:85
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:84
	msgid ""
	"Give clear, correct, _tested_ examples. A trivial example is better than no "
	"example. A good example is better yet. Do not give bad examples, "
	@@ -130,7 +128,7 @@
	"всего, воспользуется им как есть."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:88
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:87
	msgid ""
	"Avoid _weasel words_ like \"should\", \"might\", \"try\", or \"could\". "
	"These words imply that the speaker is unsure of the facts, and create doubt "
	@@ -141,22 +139,22 @@
	"уверен в фактах, и вызывают сомнения у читателя."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:90
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:89
	msgid ""
	-"Similarly, give instructions as imperative commands: not \"you should do "
	-"this\", but merely \"do this\"."
	+"Similarly, give instructions as imperative commands: not \"you should do this"
	+"\", but merely \"do this\"."
	msgstr ""
	"Аналогично, давайте инструкции в виде повелительных команд: не \"вам следует "
	"сделать это\", а просто \"сделайте это\"."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:92
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:91
	#, no-wrap
	msgid "Be Complete"
	msgstr "Будьте полными"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:98
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:97
	msgid ""
	"Do not make assumptions about the reader's abilities or skill level. Tell "
	"them what they need to know. Give links to other documents to provide "
	@@ -170,13 +168,13 @@
	"вопросы, которые у него возникнут, и ответьте на них."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:100
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:99
	#, no-wrap
	msgid "Be Concise"
	msgstr "Будьте краткими"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:105
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:104
	msgid ""
	"While features should be documented completely, sometimes there is so much "
	"information that the reader cannot easily find the specific detail needed. "
	@@ -186,19 +184,19 @@
	"section."
	msgstr ""
	"Хотя функции должны быть описаны полностью, иногда информации так много, что "
	-"читателю сложно найти нужную деталь. Баланс между полнотой и лаконичностью —"
	-" это непростая задача. Один из подходов — включить введение, затем раздел «"
	-"быстрый старт» с описанием наиболее распространённого сценария, а после "
	+"читателю сложно найти нужную деталь. Баланс между полнотой и лаконичностью "
	+"— это непростая задача. Один из подходов — включить введение, затем раздел "
	+"«быстрый старт» с описанием наиболее распространённого сценария, а после "
	"него — подробный справочный раздел."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:107
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:106
	#, no-wrap
	msgid "Guidelines"
	msgstr "Рекомендации"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:110
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:109
	msgid ""
	"To promote consistency between the myriad authors of the FreeBSD "
	"documentation, some guidelines have been drawn up for authors to follow."
	@@ -207,13 +205,13 @@
	"были разработаны рекомендации, которым следует придерживаться при написании."

	#. type: Labeled list
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:111
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:110
	#, no-wrap
	msgid "Use American English Spelling"
	msgstr "Используйте американское написание английских слов"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:115
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:114
	msgid ""
	"There are several variants of English, with different spellings for the same "
	"word. Where spellings differ, use the American English variant. \"color\", "
	@@ -225,7 +223,7 @@
	"«rationalise», и так далее."

	#. type: delimited block = 4
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:120
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:119
	msgid ""
	"The use of British English may be accepted in the case of a contributed "
	"article, however the spelling must be consistent within the whole document. "
	@@ -239,13 +237,13 @@
	"английского языка."

	#. type: Labeled list
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:122
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:121
	#, no-wrap
	msgid "Do not use contractions"
	msgstr "Не используйте сокращения"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:126
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:125
	msgid ""
	"Do not use contractions. Always spell the phrase out in full. \"Don't use "
	"contractions\" is wrong."
	@@ -254,7 +252,7 @@
	"contractions\" является неправильным вариантом."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:128
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:127
	msgid ""
	"Avoiding contractions makes for a more formal tone, is more precise, and is "
	"slightly easier for translators."
	@@ -263,13 +261,13 @@
	"и немного облегчает работу переводчиков."

	#. type: Labeled list
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:129
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:128
	#, no-wrap
	msgid "Use the serial comma"
	msgstr "Используйте серийную запятую"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:132
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:131
	msgid ""
	"In a list of items within a paragraph, separate each item from the others "
	"with a comma. Separate the last item from the others with a comma and the "
	@@ -279,19 +277,19 @@
	"Последний элемент отделяйте от остальных запятой и словом \"and\"."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:134
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:133
	msgid "For example:"
	-msgstr "Например:"
	+msgstr "Для примера:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:136
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:135
	msgid "This is a list of one, two and three items."
	msgstr ""
	"This is a list of one, two and three items (Вот список из одного, двух и "
	"трёх элементов)."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:138
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:137
	msgid ""
	"Is this a list of three items, \"one\", \"two\", and \"three\", or a list of "
	"two items, \"one\" and \"two and three\"?"
	@@ -300,64 +298,64 @@
	"двух элементов: \"one\" и \"two and three\"?"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:140
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:139
	msgid "It is better to be explicit and include a serial comma:"
	msgstr "Лучше быть точным и включать серийную запятую:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:142
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:141
	msgid "This is a list of one, two, and three items."
	msgstr ""
	"This is a list of one, two, and three items (Вот список из одного, двух и "
	"трёх элементов)."

	#. type: Labeled list
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:142
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:141
	#, no-wrap
	msgid "Avoid redundant phrases"
	msgstr "Избегайте избыточных фраз"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:145
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:144
	msgid ""
	"Do not use redundant phrases. In particular, \"the command\", \"the file\", "
	"and \"man command\" are often redundant."
	msgstr ""
	-"Избегайте избыточных фраз. В частности, \"команда\", \"файл\" и \"man "
	-"команда\" часто избыточны."
	+"Избегайте избыточных фраз. В частности, \"команда\", \"файл\" и \"man команда"
	+"\" часто избыточны."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:147
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:146
	msgid "For example, commands:"
	msgstr "Например, команды:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:149
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:148
	msgid "Wrong: Use the `git` command to update sources."
	msgstr "Неверно: Используйте команду `git` для обновления исходного кода."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:151
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:150
	msgid "Right: Use `git` to update sources."
	msgstr "Правильно: Используйте `git` для обновления исходников."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:153
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:152
	msgid "Filenames:"
	msgstr "Имена файлов:"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:155
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:154
	msgid "Wrong: ... in the filename [.filename]#/etc/rc.local#..."
	msgstr "Неверно: ... в имени файла [.filename]#/etc/rc.local#..."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:157
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:156
	msgid "Right: ... in [.filename]#/etc/rc.local#..."
	msgstr "Правильно: ... в [.filename]#/etc/rc.local#..."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:159
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:158
	msgid ""
	"Manual page references (the second example uses `man:[]` with the man:csh[1] "
	"entity):"
	@@ -366,32 +364,32 @@
	"сущностью man:csh[1]):"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:161
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:160
	msgid "Wrong: See `man csh` for more information."
	msgstr "Неправильно: Дополнительную информацию смотрите в `man csh`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:163
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:162
	msgid "Right: See man:csh[1]."
	msgstr "Правильно: См. man:csh[1]."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:165
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:164
	msgid ""
	"For more information about writing style, see http://www.bartleby.com/141/"
	"[Elements of Style] by William Strunk."
	msgstr ""
	-"Для получения дополнительной информации о стиле написания текстов см. "
	-"http://www.bartleby.com/141/[«Элементы стиля»] Уильяма Странка."
	+"Для получения дополнительной информации о стиле написания текстов см. http://"
	+"www.bartleby.com/141/[«Элементы стиля»] Уильяма Странка."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:167
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:166
	#, no-wrap
	msgid "Style Guide"
	msgstr "Руководство по стилю"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:170
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:169
	msgid ""
	"To keep the source for the documentation consistent when many different "
	"people are editing it, please follow these style conventions."
	@@ -400,13 +398,13 @@
	"множеством разных людей, пожалуйста, следуйте этим стилевым соглашениям."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:172
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:171
	#, no-wrap
	msgid "One sentence per line"
	msgstr "Одно предложение на строку"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:177
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:176
	msgid ""
	"Use Semantic Line Breaks in the documentation, a technique called \"one "
	"sentence per line\". The idea of this technique is to help the users to "
	@@ -420,67 +418,63 @@
	"org/[Semantic Line Breaks]."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:179
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:178
	msgid "This is an example which does not use \"one sentence per line\"."
	msgstr "Это пример, который не использует \"одно предложение на строку\"."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:182
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:181
	#, no-wrap
	msgid "All human beings are born free and equal in dignity and rights. They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.\n"
	-msgstr ""
	-"All human beings are born free and equal in dignity and rights. They are "
	-"endowed with reason and conscience and should act towards one another in a "
	-"spirit of brotherhood.\n"
	+msgstr "All human beings are born free and equal in dignity and rights. They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.\n"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:185
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:184
	msgid "And this is an example which uses the technique."
	msgstr "И вот пример, использующий этот метод."

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:189
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:188
	#, no-wrap
	msgid ""
	"All human beings are born free and equal in dignity and rights.\n"
	"They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.\n"
	msgstr ""
	"All human beings are born free and equal in dignity and rights.\n"
	-"They are endowed with reason and conscience and should act towards one "
	-"another in a spirit of brotherhood.\n"
	+"They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.\n"

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:192
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:191
	#, no-wrap
	msgid "Acronyms"
	msgstr "Аббревиатуры"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:197
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:196
	msgid ""
	"Acronyms should be defined the first time they appear in a document, as in: "
	"\"Network Time Protocol (NTP)\". After the acronym has been defined, use "
	"the acronym alone unless it makes more sense contextually to use the whole "
	"term. Acronyms are usually defined only once per chapter or per document."
	msgstr ""
	-"Акроним должен быть определён при первом упоминании в документе, например: «"
	-"Network Time Protocol (NTP)». После того как акроним определён, используйте "
	+"Акроним должен быть определён при первом упоминании в документе, например: "
	+"«Network Time Protocol (NTP)». После того как акроним определён, используйте "
	"только акроним, если контекст не требует полного термина. Обычно акроним "
	"определяется один раз в главе или документе."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:199
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:198
	msgid "All acronyms should be enclosed using the ` character."
	msgstr "Все аббревиатуры должны быть заключены в символ `."

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:201
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:200
	#, no-wrap
	msgid "Special Character List"
	msgstr "Список специальных символов"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:205
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:204
	msgid ""
	"This list of special characters shows the correct syntax and the output when "
	"used in FreeBSD documentation. If a character is not on this list, ask "
	@@ -491,194 +485,194 @@
	"задайте вопрос на {freebsd-doc}."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:210
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:265
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:209
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:264
	#, no-wrap
	msgid "Name"
	msgstr "Имя"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:211
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:210
	#, no-wrap
	msgid "Syntax"
	msgstr "Синтаксис"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:214
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:213
	#, no-wrap
	msgid "Rendered"
	msgstr "Выводится"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:215
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:214
	#, no-wrap
	msgid "Copyright"
	msgstr "Авторское право (copyright)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:216
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:215
	#, no-wrap
	msgid "+(C)+"
	msgstr "+(C)+"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:218
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:217
	#, no-wrap
	msgid "(C)"
	msgstr "(С)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:219
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:218
	#, no-wrap
	msgid "Registered"
	msgstr "Зарегистрировано"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:220
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:219
	#, no-wrap
	msgid "+(R)+"
	msgstr "+(R)+"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:222
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:221
	#, no-wrap
	msgid "(R)"
	msgstr "(R)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:223
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:222
	#, no-wrap
	msgid "Trademark"
	msgstr "Товарный знак"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:224
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:223
	#, no-wrap
	msgid "+(TM)+"
	msgstr "+(TM)+"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:226
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:225
	#, no-wrap
	msgid "(TM)"
	msgstr "(TM)"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:227
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:226
	#, no-wrap
	msgid "Em dash"
	msgstr "Тире"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:228
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:227
	#, no-wrap
	msgid "+--+"
	msgstr "+--+"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:230
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:229
	#, no-wrap
	msgid "--"
	msgstr "--"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:231
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:230
	#, no-wrap
	msgid "Ellipses"
	msgstr "Многоточия"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:232
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:231
	#, no-wrap
	msgid "+...+"
	msgstr "+...+"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:234
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:233
	#, no-wrap
	msgid "..."
	msgstr "..."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:235
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:234
	#, no-wrap
	msgid "Single right arrow"
	msgstr "Одиночная стрелка вправо"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:236
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:235
	#, no-wrap
	msgid "+->+"
	msgstr "+->+"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:238
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:237
	#, no-wrap
	msgid "->"
	msgstr "->"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:239
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:238
	#, no-wrap
	msgid "Double right arrow"
	msgstr "Двойная правая стрелка"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:240
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:239
	#, no-wrap
	msgid "+=>+"
	msgstr "+=>+"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:242
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:241
	#, no-wrap
	msgid "=>"
	msgstr "=>"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:243
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:242
	#, no-wrap
	msgid "Single left arrow"
	msgstr "Одиночная стрелка влево"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:244
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:243
	#, no-wrap
	msgid "+<-+"
	msgstr "+<-+"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:246
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:245
	#, no-wrap
	msgid "<-"
	msgstr "<-"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:247
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:246
	#, no-wrap
	msgid "Double left arrow"
	msgstr "Двойная левая стрелка"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:248
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:247
	#, no-wrap
	msgid "+<=+"
	msgstr "+<=+"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:250
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:249
	#, no-wrap
	msgid "<="
	msgstr "<="

	#. type: Title ==
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:253
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:252
	#, no-wrap
	msgid "Linting with Vale"
	msgstr "Проверка стиля с помощью Vale"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:258
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:257
	msgid ""
	"To maintain clarity and consistency across all documentation and website "
	"pages, link:https://vale.sh[Vale] styles have been introduced in the "
	@@ -696,7 +690,7 @@
	"в предпочитаемый редактор."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:260
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:259
	msgid ""
	"The following table describes the current rule names and their respective "
	"severity."
	@@ -705,118 +699,118 @@
	"степень серьёзности."

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:267
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:266
	#, no-wrap
	msgid "Severity"
	msgstr "Степень серьезности"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:268
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:267
	#, no-wrap
	msgid "FreeBSD.BrandTerms"
	msgstr "FreeBSD.BrandTerms"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:270
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:288
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:294
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:297
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:300
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:303
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:269
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:287
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:293
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:296
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:299
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:302
	#, no-wrap
	msgid "error"
	msgstr "ошибка"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:271
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:270
	#, no-wrap
	msgid "FreeBSD.ConsciousLanguage"
	msgstr "FreeBSD.ConsciousLanguage"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:273
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:279
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:282
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:285
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:272
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:278
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:281
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:284
	#, no-wrap
	msgid "warning"
	msgstr "warning"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:274
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:273
	#, no-wrap
	msgid "FreeBSD.Contractions"
	msgstr "FreeBSD.Contractions"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:276
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:291
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:275
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:290
	#, no-wrap
	msgid "suggestion"
	msgstr "предложение"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:277
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:276
	#, no-wrap
	msgid "FreeBSD.EOLSpacing"
	msgstr "FreeBSD.EOLSpacing"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:280
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:279
	#, no-wrap
	msgid "FreeBSD.Hang"
	msgstr "FreeBSD.Hang"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:283
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:282
	#, no-wrap
	msgid "FreeBSD.Hyphens"
	msgstr "FreeBSD.Hyphens"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:286
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:285
	#, no-wrap
	msgid "FreeBSD.Spacing"
	msgstr "FreeBSD.Spacing"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:289
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:288
	#, no-wrap
	msgid "FreeBSD.SuperfluousOptArgInLinks"
	msgstr "FreeBSD.SuperfluousOptArgInLinks"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:292
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:291
	#, no-wrap
	msgid "Vale.Avoid"
	msgstr "Vale.Avoid"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:295
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:294
	#, no-wrap
	msgid "Vale.Repetition"
	msgstr "Vale.Repetition"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:298
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:297
	#, no-wrap
	msgid "Vale.Spelling"
	msgstr "Vale.Spelling"

	#. type: Table
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:301
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:300
	#, no-wrap
	msgid "Vale.Terms"
	msgstr "Vale.Terms"

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:306
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:305
	#, no-wrap
	msgid "Current Vale Rules"
	msgstr "Текущие правила Vale"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:312
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:311
	msgid ""
	"FreeBSD.BrandTerms: According to the copyright rules of The FreeBSD "
	"Foundation, freebsd should be written as FreeBSD. Similarly, every "
	@@ -835,7 +829,7 @@
	"styles/FreeBSD/BrandTerms.yml# в репозитории `doc`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:314
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:313
	msgid ""
	"FreeBSD.ConsciousLanguage: This rule proposes use of conscious language so "
	"that sensitive words pointing to the color, age, race, or sexual orientation "
	@@ -846,7 +840,7 @@
	"кожи, возраст, расу или сексуальную ориентацию людей."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:317
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:316
	msgid ""
	"FreeBSD.Contractions: Contracted words should not be used. This rule avoids "
	"all contractions and suggests full words."
	@@ -855,7 +849,7 @@
	"правило исключает все сокращения и рекомендует использовать полные слова."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:319
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:318
	msgid ""
	"FreeBSD.EOLSpacing: In most of the documents EOL spacing is present which is "
	"not the desirable situation."
	@@ -864,7 +858,7 @@
	"строк, что не является желательной ситуацией."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:322
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:321
	msgid ""
	"FreeBSD.Hang: `Hang` is often used to mean that the application has stopped "
	"responding. This rule proposes better wording."
	@@ -874,7 +868,7 @@
	"подходящую формулировку."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:324
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:323
	msgid ""
	"FreeBSD.Hyphens: Often adverbs ending with 'ly' are added with a hyphen "
	"which is wrong."
	@@ -883,7 +877,7 @@
	"дефисом, что является ошибкой."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:326
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:325
	msgid ""
	"FreeBSD.Spacing: Often double spaces are hard to catch with the naked eye "
	"and this is addressed here."
	@@ -892,16 +886,16 @@
	"и здесь это решается."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:328
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:327
	msgid ""
	-"FreeBSD.SuperfluousOptArgInLinks: Suggest to empty square brackets in "
	-"`link:` macros when the displayed text coincides with the URL."
	+"FreeBSD.SuperfluousOptArgInLinks: Suggest to empty square brackets in `link:"
	+"` macros when the displayed text coincides with the URL."
	msgstr ""
	"FreeBSD.SuperfluousOptArgInLinks: Рекомендуется оставлять квадратные скобки "
	"пустыми в макросах `link:`, если отображаемый текст совпадает с URL."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:332
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:331
	msgid ""
	"Vale.Avoid: Enforces the DO NOT USE vocabulary terms for The FreeBSD "
	"Project. If any word is found that should not be in the documentation, the "
	@@ -915,7 +909,7 @@
	"пуст."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:335
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:334
	msgid ""
	"Vale.Repetition: Same words are often typed twice when leaving the keyboard "
	"and rejoining the work again. This rule finds repeated words and warns the "
	@@ -926,7 +920,7 @@
	"предупреждает пользователей."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:338
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:337
	msgid ""
	"Vale.Spelling: At the moment there is a mix of en_US and en_GB spellings in "
	"the documentation and website. Vale comes with an in built dictionary from "
	@@ -938,13 +932,13 @@
	"любых слов."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:342
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:341
	msgid ""
	"Vale.Terms: Enforces the PREFERRED vocabulary terms for The FreeBSD "
	"Project. At the moment the list of terms is empty and the FreeBSD specific "
	"terms will be added gradually. If any word is found to be correct and not "
	-"available in the dictionary the word should be added to the "
	-"[.filename]#.vale/styles/Vocab/Terms/accept.txt# in the `doc` repository."
	+"available in the dictionary the word should be added to the [.filename]#."
	+"vale/styles/Vocab/Terms/accept.txt# in the `doc` repository."
	msgstr ""
	"Vale.Terms: Обеспечивает соблюдение ПРЕДПОЧТИТЕЛЬНЫХ терминов для проекта "
	"FreeBSD. В настоящее время список терминов пуст, и специфичные для FreeBSD "
	@@ -953,19 +947,19 @@
	"filename]#.vale/styles/Vocab/Terms/accept.txt# в репозитории `doc`."

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:344
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:343
	msgid ""
	"More rules will be introduced in the upcoming days when and where required."
	msgstr "Дополнительные правила будут введены в будущем по мере необходимости."

	#. type: Title ===
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:346
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:345
	#, no-wrap
	msgid "Using Vale"
	msgstr "Использование Vale"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:350
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:349
	msgid ""
	"link:https://vale.sh[Vale] can be used from the command line and from within "
	"an editor or IDE. package:textproc/vale[] can be installed as following:"
	@@ -975,19 +969,19 @@
	"образом:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:354
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:353
	#, no-wrap
	msgid "$ pkg install vale\n"
	msgstr "$ pkg install vale\n"

	#. type: Title ====
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:357
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:356
	#, no-wrap
	msgid "Using Vale on the command line"
	msgstr "Использование Vale в командной строке"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:360
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:359
	msgid ""
	"Assuming that the `doc` repository was cloned into [.filename]#~/doc# the "
	"following commands are required to run:"
	@@ -996,7 +990,7 @@
	"запуска потребуются следующие команды:"

	#. type: delimited block . 4
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:365
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:364
	#, no-wrap
	msgid ""
	"% cd ~/doc\n"
	@@ -1006,7 +1000,7 @@
	"% vale .\n"

	#. type: delimited block = 6
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:371
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:370
	msgid ""
	"link:https://vale.sh[Vale] is a CPU and memory intensive program due to the "
	"nature of the application and can take a while to show any output on the "
	@@ -1020,19 +1014,19 @@
	"не для всего репозитория `doc`, так как это уже выполняется в CI-пайплайне."

	#. type: Title ====
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:374
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:373
	#, no-wrap
	msgid "Using Vale in editors"
	msgstr "Использование Vale в редакторах"

	#. type: Plain text
	-#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:378
	+#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:377
	msgid ""
	-"link:https://vale.sh[Vale] works with major mainstream editors like "
	-"package:editors/vim[], package:editors/emacs[], package:editors/vscode[]. "
	-"At the moment the necessary configuration for package:editors/vim[] is "
	-"described in crossref:editor-config[editor-config-vim, Vim]. A "
	-"configuration for package:editors/emacs[] is being worked on."
	+"link:https://vale.sh[Vale] works with major mainstream editors like package:"
	+"editors/vim[], package:editors/emacs[], package:editors/vscode[]. At the "
	+"moment the necessary configuration for package:editors/vim[] is described in "
	+"crossref:editor-config[editor-config-vim, Vim]. A configuration for package:"
	+"editors/emacs[] is being worked on."
	msgstr ""
	"link:https://vale.sh[Vale] работает с основными популярными редакторами, "
	"такими как package:editors/vim[], package:editors/emacs[], package:editors/"

File Metadata

Mime Type: text/plain
Expires: Thu, Sep 10, 6:31 PM (20 h, 25 m)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 38660792
Default Alt Text: D58805.id.diff (320 KB)

D58805.id.diffNo OneTemporaryActions

D58805.id.diffView Options

File Metadata

Event Timeline

D58805.id.diff
No OneTemporary
Actions

D58805.id.diff
View Options