diff options
Diffstat (limited to 'documentation/content/ru/books/developers-handbook/introduction')
3 files changed, 6 insertions, 146 deletions
diff --git a/documentation/content/ru/books/developers-handbook/introduction/_index.adoc b/documentation/content/ru/books/developers-handbook/introduction/_index.adoc index d212e92f3a..926cfbca46 100644 --- a/documentation/content/ru/books/developers-handbook/introduction/_index.adoc +++ b/documentation/content/ru/books/developers-handbook/introduction/_index.adoc @@ -9,7 +9,7 @@ next: books/developers-handbook/tools params: path: /books/developers-handbook/introduction/ prev: books/developers-handbook/parti -showBookMenu: true +showBookMenu: 'true' tags: ["introduction", "Developing on FreeBSD", "BSD Vision", "Architectural Guidelines"] title: 'Глава 1. Введение' weight: 2 diff --git a/documentation/content/ru/books/developers-handbook/introduction/_index.po b/documentation/content/ru/books/developers-handbook/introduction/_index.po index 8c010f6a5d..56512b6e95 100644 --- a/documentation/content/ru/books/developers-handbook/introduction/_index.po +++ b/documentation/content/ru/books/developers-handbook/introduction/_index.po @@ -5,7 +5,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-10-12 22:16+0300\n" +"POT-Creation-Date: 2025-05-01 19:56-0300\n" "PO-Revision-Date: 2025-07-06 04:45+0000\n" "Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n" "Language-Team: Russian <https://translate-dev.freebsd.org/projects/" @@ -18,13 +18,13 @@ msgstr "" "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 +#. type: YAML Front Matter: description #: documentation/content/en/books/developers-handbook/introduction/_index.adoc:1 #, no-wrap msgid "Introduction to the FreeBSD Developers Handbook" msgstr "Введение в Руководство разработчика FreeBSD" -#. type: Yaml Front Matter Hash Value: title +#. type: YAML Front Matter: title #: documentation/content/en/books/developers-handbook/introduction/_index.adoc:1 #, no-wrap msgid "Chapter 1. Introduction" @@ -179,7 +179,7 @@ msgid "" "README.md[README.md] file." msgstr "" "Полный исходный код FreeBSD доступен в нашем link:https://cgit.freebsd.org/" -"src/[публичном Git-репозитории]. Исходный код обычно устанавливается в " -"[.filename]#/usr/src#. Структура дерева каталогов исходного кода описана в " +"src/[публичном Git-репозитории]. Исходный код обычно устанавливается в [." +"filename]#/usr/src#. Структура дерева каталогов исходного кода описана в " "файле link:https://cgit.freebsd.org/src/tree/README.md[README.md] на верхнем " "уровне дерева." diff --git a/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc b/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc deleted file mode 100644 index c9cab95af5..0000000000 --- a/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: Глава 1. Введение -authors: - - author: Murray Stokely - - author: Jeroen Ruigrok van der Werven ---- - -[[introduction]] -= Введение -:doctype: book -:toc: macro -:toclevels: 1 -:icons: font -:sectnums: -:sectnumlevels: 6 -:sectnumoffset: 1 -:partnums: -:source-highlighter: rouge -:experimental: -:images-path: books/developers-handbook/ - -ifdef::env-beastie[] -ifdef::backend-html5[] -:imagesdir: ../../../../images/{images-path} -endif::[] -ifndef::book[] -include::shared/authors.adoc[] -include::shared/mirrors.adoc[] -include::shared/releases.adoc[] -include::shared/attributes/attributes-{{% lang %}}.adoc[] -include::shared/{{% lang %}}/teams.adoc[] -include::shared/{{% lang %}}/mailing-lists.adoc[] -include::shared/{{% lang %}}/urls.adoc[] -toc::[] -endif::[] -ifdef::backend-pdf,backend-epub3[] -include::../../../../../shared/asciidoctor.adoc[] -endif::[] -endif::[] - -ifndef::env-beastie[] -toc::[] -include::../../../../../shared/asciidoctor.adoc[] -endif::[] - -[[introduction-devel]] -== Разработка во FreeBSD - -Итак, у нас все есть. Система полностью установлена и вы готовы начать программировать. Но с чего начать? Что предоставляет FreeBSD? Что она может дать мне как программисту? - -Вот те из некоторых вопросов, на которые пытается дать ответ эта глава. Конечно, программирование, как и любая другая область деятельности, имеет разные уровни профессионального мастерства. Для некоторых это хобби, для других это профессия. Информация в этой главе может в большей степени пригодиться начинающему программисту, но может также оказаться полезной программисту, делающему первые шаги на платформе FreeBSD. - -[[introduction-bsdvision]] -== Подход BSD - -Создать самую лучшую UNIX(R)-подобную операционную систему, благодаря оригинальной идеологии программных средств, а также полезности, производительности и надёжности. - -[[introduction-archguide]] -== Архитектурные концепции - -Наша идеология может быть описана в следующих ключевых положениях - -* Не добавлять новой функциональности, кроме случаев, когда нельзя выполнить конкретную работу без нее. -* Решить, чего в системе не будет, так же важно, как и определение того, чего в системе не будет. Не пытайтесь включить в систему все; лучше сделать систему расширяемой так, что дополнительные потребности могут быть реализованы в режиме совместимости. -* Единственное, что может быть лучше обобщения на основе одного примера, это обобщение вообще без примеров. -* Если проблема до конца не понята, наверное, лучше вовсе не давать ее решения. -* Если вы можете сделать 90 процентов результата ценой 10 процентов работы, найдите более простое решение. -* Старайтесь отделять сложные вещи. -* Дайте механизм, а не правила. В частности, оставьте соглашения по пользовательскому интерфейсу клиенту. - -Из Scheifler Gettys: "X Window System" - -[[introduction-layout]] -== Структура каталога [.filename]#/usr/src# - -Полный исходный код FreeBSD располагается в нашем общедоступном хранилище CVS. Исходный код обычно устанавливается в [.filename]#/usr/src#, который содержит следующие подкаталоги: - -[.informaltable] -[cols="1,1", frame="none", options="header"] -|=== -| Каталог -| Описание - -|[.filename]#bin/# -|Исходный код файлов из [.filename]#/bin# - -|[.filename]#contrib/# -|Исходный код файлов программного обеспечения сторонних разработчиков. - -|[.filename]#crypto/# -|Исходный код криптографической подсистемы - -|[.filename]#etc/# -|Исходный код файлов из каталога [.filename]#/etc# - -|[.filename]#games/# -|Исходный код файлов из [.filename]#/usr/games# - -|[.filename]#gnu/# -|Утилиты, подпадающие под действие GNU Public License - -|[.filename]#include/# -|Исходный код файлов из [.filename]#/usr/include# - -|[.filename]#kerberosIV/# -|Исходный код Kerberos версии IV - -|[.filename]#kerberos5/# -|Исходный код Kerberos версии 5 - -|[.filename]#lib/# -|Исходный код файлов из [.filename]#/usr/lib# - -|[.filename]#libexec/# -|Исходный код файлов из [.filename]#/usr/libexec# - -|[.filename]#release/# -|Файлы, которые требуются для создания релиза FreeBSD - -|[.filename]#sbin/# -|Исходный код файлов из [.filename]#/sbin# - -|[.filename]#secure/# -|Исходный код FreeSec - -|[.filename]#share/# -|Исходный код файлов из [.filename]#/usr/share# - -|[.filename]#sys/# -|Исходный код ядра - -|[.filename]#tools/# -|Утилиты, используемые для поддержки и тестирования FreeBSD - -|[.filename]#usr.bin/# -|Исходный код файлов из [.filename]#/usr/bin# - -|[.filename]#usr.sbin/# -|Исходный код файлов из [.filename]#/usr/sbin# -|=== |