aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/ru/books/fdp-primer/tools
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/content/ru/books/fdp-primer/tools')
-rw-r--r--documentation/content/ru/books/fdp-primer/tools/_index.adoc70
-rw-r--r--documentation/content/ru/books/fdp-primer/tools/_index.po113
2 files changed, 183 insertions, 0 deletions
diff --git a/documentation/content/ru/books/fdp-primer/tools/_index.adoc b/documentation/content/ru/books/fdp-primer/tools/_index.adoc
new file mode 100644
index 0000000000..10c5251367
--- /dev/null
+++ b/documentation/content/ru/books/fdp-primer/tools/_index.adoc
@@ -0,0 +1,70 @@
+---
+description: 'Инструменты, используемые в проекте документации FreeBSD'
+next: books/fdp-primer/working-copy
+params:
+ path: /books/fdp-primer/tools/
+prev: books/fdp-primer/overview
+showBookMenu: true
+tags: ["tools", "required tools", "optional tools"]
+title: 'Глава 2. Инструменты'
+weight: 3
+---
+
+[[tools]]
+= Инструменты
+:doctype: book
+:toc: macro
+:toclevels: 1
+:icons: font
+:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
+:source-highlighter: rouge
+:experimental:
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+
+Для управления документацией FreeBSD и её преобразования в различные выходные форматы используется несколько программных инструментов. Некоторые из них обязательны и должны быть установлены перед работой с примерами из следующих глав. Другие являются опциональными, расширяя возможности или упрощая процесс создания документации.
+
+[[tools-required]]
+== Необходимые инструменты
+
+Установите `docproj` _мета-порт_, как показано в crossref:overview[overview,обзорной главе] из Коллекции портов. Эти приложения необходимы для работы с документацией FreeBSD. Далее приведены дополнительные заметки об отдельных компонентах.
+
+[[tools-optional]]
+== Необязательные инструменты
+
+Эти приложения не обязательны, но могут упростить работу с документацией или расширить её возможности.
+
+[[tools-optional-software]]
+=== Программное обеспечение
+
+Vim (package:editors/vim[]) — популярный редактор для работы с Asciidoctor.
+
+Emacs (package:editors/emacs[]).
+
+Оба инструмента включают специальный режим, который сокращает количество необходимых нажатий клавиш и помогает снизить количество ошибок.
diff --git a/documentation/content/ru/books/fdp-primer/tools/_index.po b/documentation/content/ru/books/fdp-primer/tools/_index.po
new file mode 100644
index 0000000000..85365159eb
--- /dev/null
+++ b/documentation/content/ru/books/fdp-primer/tools/_index.po
@@ -0,0 +1,113 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR The FreeBSD Project
+# This file is distributed under the same license as the FreeBSD Documentation package.
+# Vladlen Popolitov <vladlenpopolitov@list.ru>, 2025.
+msgid ""
+msgstr ""
+"Project-Id-Version: FreeBSD Documentation VERSION\n"
+"POT-Creation-Date: 2025-09-20 14:02+0300\n"
+"PO-Revision-Date: 2025-06-01 09:10+0000\n"
+"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
+"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
+"documentation/booksfdp-primertools_index/ru/>\n"
+"Language: ru\n"
+"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"
+"X-Generator: Weblate 4.17\n"
+
+#. type: Yaml Front Matter Hash Value: description
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:1
+#, no-wrap
+msgid "Tools used in the FreeBSD Documentation Project"
+msgstr "Инструменты, используемые в проекте документации FreeBSD"
+
+#. type: Yaml Front Matter Hash Value: title
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:1
+#, no-wrap
+msgid "Chapter 2. Tools"
+msgstr "Глава 2. Инструменты"
+
+#. type: Title =
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:14
+#, no-wrap
+msgid "Tools"
+msgstr "Инструменты"
+
+#. type: Plain text
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:54
+msgid ""
+"Several software tools are used to manage the FreeBSD documentation and "
+"render it to different output formats. Some of these tools are required and "
+"must be installed before working through the examples in the following "
+"chapters. Some are optional, adding capabilities or making the job of "
+"creating documentation less demanding."
+msgstr ""
+"Для управления документацией FreeBSD и её преобразования в различные "
+"выходные форматы используется несколько программных инструментов. Некоторые "
+"из них обязательны и должны быть установлены перед работой с примерами из "
+"следующих глав. Другие являются опциональными, расширяя возможности или "
+"упрощая процесс создания документации."
+
+#. type: Title ==
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:56
+#, no-wrap
+msgid "Required Tools"
+msgstr "Необходимые инструменты"
+
+#. type: Plain text
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:61
+msgid ""
+"Install `docproj` _meta-port_ as shown in crossref:overview[overview,the "
+"overview chapter] from the Ports Collection. These applications are "
+"required to do useful work with the FreeBSD documentation. Some further "
+"notes on particular components are given below."
+msgstr ""
+"Установите `docproj` _мета-порт_, как показано в "
+"crossref:overview[overview,обзорной главе] из Коллекции портов. Эти "
+"приложения необходимы для работы с документацией FreeBSD. Далее приведены "
+"дополнительные заметки об отдельных компонентах."
+
+#. type: Title ==
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:63
+#, no-wrap
+msgid "Optional Tools"
+msgstr "Необязательные инструменты"
+
+#. type: Plain text
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:66
+msgid ""
+"These applications are not required, but can make working on the "
+"documentation easier or add capabilities."
+msgstr ""
+"Эти приложения не обязательны, но могут упростить работу с документацией или "
+"расширить её возможности."
+
+#. type: Title ===
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:68
+#, no-wrap
+msgid "Software"
+msgstr "Программное обеспечение"
+
+#. type: Plain text
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:71
+msgid ""
+"Vim (package:editors/vim[]) -- a popular editor for working with Asciidoctor."
+msgstr ""
+"Vim (package:editors/vim[]) — популярный редактор для работы с Asciidoctor."
+
+#. type: Plain text
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:73
+msgid "Emacs (package:editors/emacs[])."
+msgstr "Emacs (package:editors/emacs[])."
+
+#. type: Plain text
+#: documentation/content/en/books/fdp-primer/tools/_index.adoc:74
+msgid ""
+"Both tools include a special mode that reduces the amount of typing needed, "
+"and helps to reduce errors."
+msgstr ""
+"Оба инструмента включают специальный режим, который сокращает количество "
+"необходимых нажатий клавиш и помогает снизить количество ошибок."