# 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, 2026.
msgid ""
msgstr ""
"Project-Id-Version: FreeBSD Documentation VERSION\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"
"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: description
#: 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"

#. type: YAML Front Matter: title
#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:1
#, no-wrap
msgid "Chapter 12. Writing Style"
msgstr "Глава 12. Стиль написания"

#. type: Title =
#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:14
#, no-wrap
msgid "Writing Style"
msgstr "Стиль написания"

#. type: Title ==
#: 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:57
msgid ""
"Technical documentation can be improved by consistent use of several "
"principles.  Most of these can be classified into three goals: _be clear_, "
"_be complete_, and _be concise_.  These goals can conflict with each other.  "
"Good writing consists of a balance between them."
msgstr ""
"Техническая документация может быть улучшена за счёт последовательного "
"применения нескольких принципов. Большинство из них можно разделить на три "
"цели: _быть понятным_, _быть полным_ и _быть кратким_. Эти цели могут "
"противоречить друг другу. Хорошее изложение заключается в нахождении баланса "
"между ними."

#. type: Title ===
#: 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: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 "
"clearly explains the concepts."
msgstr ""
"Ясность чрезвычайно важна.  Читатель может быть новичком или изучать "
"документ на неродном языке.  Стремитесь к простому, понятному тексту, "
"который чётко объясняет концепции."

#. type: Plain text
#: 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 "
"understand and translate."
msgstr ""
"Избегайте витиеватой или украшенной речи, шуток или разговорных выражений.  "
"Пишите как можно проще и яснее.  Простой текст легче понять и перевести."

#. type: Plain text
#: 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 "
"potentially patronizing words like \"basically\".  Avoid Latin terms like "
"\"i.e.,\" or \"cf.\", which may be unknown outside of academic or scientific "
"groups."
msgstr ""
"Делайте объяснения как можно короче, проще и понятнее.  Избегайте пустых "
"фраз вроде \"для того чтобы\", которые обычно можно заменить на \"чтобы\".  "
"Не используйте снисходительные слова вроде \"по сути\".  Избегайте латинских "
"терминов, таких как \"i.e.\" или \"cf.\", которые могут быть непонятны за "
"пределами академических или научных кругов."

#. type: Plain text
#: 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 "
"copy the file to [.filename]#/tmp#\"."
msgstr ""
"Следует писать в формальном стиле. Необходимо избегать прямого обращения к "
"читателю. Например, следует использовать формулировку \"скопировать файл в [."
"filename]#/tmp#\", а не \"вы можете скопировать файл в [.filename]#/tmp#\"."

#. type: Plain text
#: 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, "
"identifiable by apologies or sentences like \"but really it should never be "
"done that way\".  Bad examples are worse than no examples.  Give good "
"examples, because _even when warned not to use the example as shown_, the "
"reader will usually just use the example as shown."
msgstr ""
"Приводите понятные, корректные и _проверенные_ примеры.  Простой пример "
"лучше, чем отсутствие примера.  Хороший пример ещё лучше.  Не приводите "
"плохих примеров, которые можно распознать по извинениям или фразам вроде «но "
"на самом деле так делать не стоит».  Плохие примеры хуже, чем их "
"отсутствие.  Приводите хорошие примеры, потому что _даже если предупредить "
"читателя, чтобы он не использовал пример в таком виде_, он всё равно, скорее "
"всего, воспользуется им как есть."

#. type: Plain text
#: 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 "
"in the reader."
msgstr ""
"Избегайте _неопределённых выражений_, таких как «должен», «может», "
"«попытаться» или «смог бы».  Эти слова создают впечатление, что автор не "
"уверен в фактах, и вызывают сомнения у читателя."

#. type: Plain text
#: 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\"."
msgstr ""
"Аналогично, давайте инструкции в виде повелительных команд: не \"вам следует "
"сделать это\", а просто \"сделайте это\"."

#. type: Title ===
#: 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: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 "
"background information without having to recreate it.  Put yourself in the "
"reader's place, anticipate the questions they will ask, and answer them."
msgstr ""
"Не делайте предположений о способностях или уровне навыков читателя.  "
"Сообщите им то, что им необходимо знать.  Давайте ссылки на другие "
"документы, чтобы предоставить справочную информацию без необходимости её "
"повторного изложения.  Поставьте себя на место читателя, предугадайте "
"вопросы, которые у него возникнут, и ответьте на них."

#. type: Title ===
#: 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:104
msgid ""
"While features should be documented completely, sometimes there is so much "
"information that the reader cannot easily find the specific detail needed.  "
"The balance between being complete and being concise is a challenge.  One "
"approach is to have an introduction, then a \"quick start\" section that "
"describes the most common situation, followed by an in-depth reference "
"section."
msgstr ""
"Хотя функции должны быть описаны полностью, иногда информации так много, что "
"читателю сложно найти нужную деталь.  Баланс между полнотой и лаконичностью "
"— это непростая задача.  Один из подходов — включить введение, затем раздел "
"«быстрый старт» с описанием наиболее распространённого сценария,  а после "
"него — подробный справочный раздел."

#. type: Title ==
#: 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:109
msgid ""
"To promote consistency between the myriad authors of the FreeBSD "
"documentation, some guidelines have been drawn up for authors to follow."
msgstr ""
"Для обеспечения единообразия среди множества авторов документации FreeBSD "
"были разработаны рекомендации, которым следует придерживаться при написании."

#. type: Labeled list
#: 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:114
msgid ""
"There are several variants of English, with different spellings for the same "
"word.  Where spellings differ, use the American English variant.  \"color\", "
"not \"colour\", \"rationalize\", not \"rationalise\", and so on."
msgstr ""
"Существует несколько вариантов английского языка с разным написанием одних и "
"тех же слов. Если варианты написания отличаются, используйте американский "
"английский. Например, «color», а не «colour», «rationalize», а не "
"«rationalise», и так далее."

#. type: delimited block = 4
#: 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.  "
"The other documents such as books, web site, manual pages, etc. must use "
"American English."
msgstr ""
"Использование британского варианта английского языка может быть допустимо в "
"случае предоставленной статьи, однако орфография должна быть единообразной "
"во всем документе. Остальные документы, такие как книги, веб-сайты, "
"справочные страницы и т. д., должны использовать американский вариант "
"английского языка."

#. type: Labeled list
#: 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:125
msgid ""
"Do not use contractions.  Always spell the phrase out in full.  \"Don't use "
"contractions\" is wrong."
msgstr ""
"Не используйте сокращения. Всегда пишите фразу полностью. \"Don't use "
"contractions\" является неправильным вариантом."

#. type: Plain text
#: 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."
msgstr ""
"Избегание сокращений способствует более формальному тону, повышает точность "
"и немного облегчает работу переводчиков."

#. type: Labeled list
#: 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: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 "
"word \"and\"."
msgstr ""
"В списке элементов внутри абзаца разделяйте каждый элемент запятой.  "
"Последний элемент отделяйте от остальных запятой и словом \"and\"."

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

#. type: Plain text
#: 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:137
msgid ""
"Is this a list of three items, \"one\", \"two\", and \"three\", or a list of "
"two items, \"one\" and \"two and three\"?"
msgstr ""
"Это список из трёх элементов: \"one\", \"two\" и \"three\" или список из "
"двух элементов: \"one\" и \"two and three\"?"

#. type: Plain text
#: 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: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:141
#, no-wrap
msgid "Avoid redundant phrases"
msgstr "Избегайте избыточных фраз"

#. type: Plain text
#: 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 команда"
"\" часто избыточны."

#. type: Plain text
#: 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: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:150
msgid "Right: Use `git` to update sources."
msgstr "Правильно: Используйте `git` для обновления исходников."

#. type: Plain text
#: 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: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: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:158
msgid ""
"Manual page references (the second example uses `man:[]` with the man:csh[1] "
"entity):"
msgstr ""
"Ссылки на страницы Справочника (во втором примере используется `man:[]` с "
"сущностью man:csh[1]):"

#. type: Plain text
#: 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:162
msgid "Right: See man:csh[1]."
msgstr "Правильно: См. man:csh[1]."

#. type: Plain text
#: 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/[«Элементы стиля»] Уильяма Странка."

#. type: Title ==
#: 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:169
msgid ""
"To keep the source for the documentation consistent when many different "
"people are editing it, please follow these style conventions."
msgstr ""
"Чтобы сохранить единообразие исходного кода документации при редактировании "
"множеством разных людей, пожалуйста, следуйте этим стилевым соглашениям."

#. type: Title ===
#: 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: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 "
"write and read documentation.  To get more information about this technique "
"read the link:https://sembr.org/[Semantic Line Breaks] page."
msgstr ""
"Используйте семантические разрывы строк в документации, метод, называемый "
"\"одно предложение на строку\".    Идея этого метода заключается в том, "
"чтобы помочь пользователям писать и читать документацию.    Для получения "
"дополнительной информации об этом методе прочитайте страницу https://sembr."
"org/[Semantic Line Breaks]."

#. type: Plain text
#: 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: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"

#. type: Plain text
#: 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: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"

#. type: Title ===
#: 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: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)». После того как акроним определён, используйте "
"только акроним, если контекст не требует полного термина. Обычно акроним "
"определяется один раз в главе или документе."

#. type: Plain text
#: 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:200
#, no-wrap
msgid "Special Character List"
msgstr "Список специальных символов"

#. type: Plain text
#: 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 "
"about it on the {freebsd-doc}."
msgstr ""
"Этот список специальных символов показывает правильный синтаксис и результат "
"их использования в документации FreeBSD. Если нужного символа нет в списке, "
"задайте вопрос на {freebsd-doc}."

#. type: Table
#: 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:210
#, no-wrap
msgid "Syntax"
msgstr "Синтаксис"

#. type: Table
#: 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:214
#, no-wrap
msgid "Copyright"
msgstr "Авторское право (copyright)"

#. type: Table
#: 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:217
#, no-wrap
msgid "(C)"
msgstr "(С)"

#. type: Table
#: 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:219
#, no-wrap
msgid "+(R)+"
msgstr "+(R)+"

#. type: Table
#: 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:222
#, no-wrap
msgid "Trademark"
msgstr "Товарный знак"

#. type: Table
#: 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:225
#, no-wrap
msgid "(TM)"
msgstr "(TM)"

#. type: Table
#: 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:227
#, no-wrap
msgid "+--+"
msgstr "+--+"

#. type: Table
#: 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:230
#, no-wrap
msgid "Ellipses"
msgstr "Многоточия"

#. type: Table
#: 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:233
#, no-wrap
msgid "..."
msgstr "..."

#. type: Table
#: 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:235
#, no-wrap
msgid "+->+"
msgstr "+->+"

#. type: Table
#: 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:238
#, no-wrap
msgid "Double right arrow"
msgstr "Двойная правая стрелка"

#. type: Table
#: 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:241
#, no-wrap
msgid "=>"
msgstr "=>"

#. type: Table
#: 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:243
#, no-wrap
msgid "+<-+"
msgstr "+<-+"

#. type: Table
#: 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:246
#, no-wrap
msgid "Double left arrow"
msgstr "Двойная левая стрелка"

#. type: Table
#: 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:249
#, no-wrap
msgid "<="
msgstr "<="

#. type: Title ==
#: 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:257
msgid ""
"To maintain clarity and consistency across all documentation and website "
"pages, link:https://vale.sh[Vale] styles have been introduced in the "
"documentation tree.  link:https://vale.sh[Vale] is a powerful linter for "
"writing customized rules and can be used in multiple scenarios.  Currently "
"link:https://vale.sh[Vale] can be used as a command line tool, for CI/CD "
"pipelines, and integrated into an editor of choice."
msgstr ""
"Для обеспечения ясности и единообразия во всей документации и на страницах "
"веб-сайта в дерево документации были добавлены стили link:https://vale."
"sh[Vale].  link:https://vale.sh[Vale] — это мощный линтер для создания "
"пользовательских правил написания текста, который можно использовать в "
"различных сценариях.  В настоящее время link:https://vale.sh[Vale] можно "
"применять как инструмент командной строки, в CI/CD-процессах и интегрировать "
"в предпочитаемый редактор."

#. type: Plain text
#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:259
msgid ""
"The following table describes the current rule names and their respective "
"severity."
msgstr ""
"Следующая таблица описывает текущие названия правил и их соответствующую "
"степень серьёзности."

#. type: Table
#: 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:267
#, no-wrap
msgid "FreeBSD.BrandTerms"
msgstr "FreeBSD.BrandTerms"

#. type: Table
#: 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:270
#, no-wrap
msgid "FreeBSD.ConsciousLanguage"
msgstr "FreeBSD.ConsciousLanguage"

#. type: Table
#: 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:273
#, no-wrap
msgid "FreeBSD.Contractions"
msgstr "FreeBSD.Contractions"

#. type: Table
#: 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:276
#, no-wrap
msgid "FreeBSD.EOLSpacing"
msgstr "FreeBSD.EOLSpacing"

#. type: Table
#: 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:282
#, no-wrap
msgid "FreeBSD.Hyphens"
msgstr "FreeBSD.Hyphens"

#. type: Table
#: 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:288
#, no-wrap
msgid "FreeBSD.SuperfluousOptArgInLinks"
msgstr "FreeBSD.SuperfluousOptArgInLinks"

#. type: Table
#: 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:294
#, no-wrap
msgid "Vale.Repetition"
msgstr "Vale.Repetition"

#. type: Table
#: 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:300
#, no-wrap
msgid "Vale.Terms"
msgstr "Vale.Terms"

#. type: Title ===
#: 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:311
msgid ""
"FreeBSD.BrandTerms: According to the copyright rules of The FreeBSD "
"Foundation, *freebsd* should be written as *FreeBSD*.  Similarly, every "
"major vendor and company has specific rules on writing their brand names and "
"trademarks.  Care should be taken to be respectful to the brand value of "
"others and to take time to write PostgreSQL, Node.js, Let's Encrypt etc.  "
"Missing brand names should be added to the [.filename]#.vale/styles/FreeBSD/"
"BrandTerms.yml# in the `doc` repository."
msgstr ""
"FreeBSD.BrandTerms: В соответствии с правилами авторского права Фонда "
"FreeBSD, *freebsd* следует писать как *FreeBSD*.   Аналогично, у каждого "
"крупного поставщика и компании есть свои правила написания их торговых марок "
"и брендов.  Следует проявлять уважение к брендам других и уделять время "
"правильному написанию PostgreSQL, Node.js, Let's Encrypt и т. д.  "
"Отсутствующие названия брендов следует добавлять в файл [.filename]#.vale/"
"styles/FreeBSD/BrandTerms.yml# в репозитории `doc`."

#. type: Plain text
#: 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 "
"of people are avoided where possible."
msgstr ""
"FreeBSD.ConsciousLanguage: Это правило предлагает использовать осознанный "
"язык, чтобы по возможности избегать чувствительных слов, указывающих на цвет "
"кожи, возраст, расу или сексуальную ориентацию людей."

#. type: Plain text
#: 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."
msgstr ""
"FreeBSD.Contractions: Не следует использовать сокращенные слова.  Это "
"правило исключает все сокращения и рекомендует использовать полные слова."

#. type: Plain text
#: 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."
msgstr ""
"FreeBSD.EOLSpacing: В большинстве документов присутствуют пробелы в конце "
"строк, что не является желательной ситуацией."

#. type: Plain text
#: 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."
msgstr ""
"FreeBSD.Hang: Термин `Hang` часто используется для обозначения ситуации, "
"когда приложение перестает отвечать.  Это правило предлагает более "
"подходящую формулировку."

#. type: Plain text
#: 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."
msgstr ""
"FreeBSD.Hyphens: Часто наречия, оканчивающиеся на 'ly', добавляются с "
"дефисом, что является ошибкой."

#. type: Plain text
#: 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."
msgstr ""
"FreeBSD.Spacing: Часто двойные пробелы трудно заметить невооруженным глазом, "
"и здесь это решается."

#. type: Plain text
#: 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."
msgstr ""
"FreeBSD.SuperfluousOptArgInLinks: Рекомендуется оставлять квадратные скобки "
"пустыми в макросах `link:`, если отображаемый текст совпадает с URL."

#. type: Plain text
#: 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 "
"word should be added to [.filename]#.vale/styles/Vocab/Terms/reject.txt# in "
"the `doc` repository.  The list is empty at the moment."
msgstr ""
"Vale.Avoid: Запрещает использование терминов из списка *НЕ ИСПОЛЬЗОВАТЬ* в "
"документации The FreeBSD Project. Если обнаружено слово, которое не должно "
"присутствовать в документации, его следует добавить в файл [.filename]#.vale/"
"styles/Vocab/Terms/reject.txt# в репозитории `doc`. На данный момент список "
"пуст."

#. type: Plain text
#: 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 "
"users."
msgstr ""
"Vale.Repetition: Одни и те же слова часто набираются дважды при отходе от "
"клавиатуры и возвращении к работе. Это правило находит повторяющиеся слова и "
"предупреждает пользователей."

#. type: Plain text
#: 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 "
"which uses strictly en_US and do not accept the en_GB variant of any words."
msgstr ""
"Vale.Spelling: В настоящее время в документации и на веб-сайте используется "
"смесь написания en_US и en_GB. Vale поставляется со встроенным словарем, "
"который использует строго en_US и не принимает варианты написания en_GB для "
"любых слов."

#. type: Plain text
#: 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."
msgstr ""
"Vale.Terms: Обеспечивает соблюдение *ПРЕДПОЧТИТЕЛЬНЫХ* терминов для проекта "
"FreeBSD. В настоящее время список терминов пуст, и специфичные для FreeBSD "
"термины будут добавляться постепенно. Если какое-либо слово считается "
"правильным, но отсутствует в словаре, его следует добавить в файл [."
"filename]#.vale/styles/Vocab/Terms/accept.txt# в репозитории `doc`."

#. type: Plain text
#: 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:345
#, no-wrap
msgid "Using Vale"
msgstr "Использование Vale"

#. type: Plain text
#: 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:"
msgstr ""
"link:https://vale.sh[Vale] можно использовать из командной строки, а также "
"из редактора или IDE. Установить package:textproc/vale[] можно следующим "
"образом:"

#. type: delimited block . 4
#: 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: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:359
msgid ""
"Assuming that the `doc` repository was cloned into [.filename]#~/doc# the "
"following commands are required to run:"
msgstr ""
"Предполагая, что репозиторий `doc` был склонирован в [.filename]#~/doc#, для "
"запуска потребуются следующие команды:"

#. type: delimited block . 4
#: documentation/content/en/books/fdp-primer/writing-style/_index.adoc:364
#, no-wrap
msgid ""
"% cd ~/doc\n"
"% vale .\n"
msgstr ""
"% cd ~/doc\n"
"% vale .\n"

#. type: delimited block = 6
#: 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 "
"screen.  A better way to run the application is on specific folders or files "
"rather than the entire `doc` repository as that is already done in the CI "
"pipeline."
msgstr ""
"link:https://vale.sh[Vale] — это программа с высокой нагрузкой на процессор "
"и память из-за специфики приложения, и она может долго не выводить "
"результаты на экран. Лучше запускать её для конкретных папок или файлов, а "
"не для всего репозитория `doc`, так как это уже выполняется в CI-пайплайне."

#. type: Title ====
#: 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: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."
msgstr ""
"link:https://vale.sh[Vale] работает с основными популярными редакторами, "
"такими как package:editors/vim[], package:editors/emacs[], package:editors/"
"vscode[]. В настоящее время необходимая конфигурация для package:editors/"
"vim[] описана в crossref:editor-config[editor-config-vim, Vim]. Конфигурация "
"для package:editors/emacs[] находится в разработке."