Заголовки страниц

autumn-library · Oct 30, 2024 · 8b62dae · 8b62dae
1 parent 664d371
commit 8b62dae
Show file tree

Hide file tree

Showing 22 changed files with 87 additions and 0 deletions.
diff --git a/docs/framework-elements/additional-processing.md b/docs/framework-elements/additional-processing.md
@@ -1,3 +1,7 @@
+---
+title: Дополнительная обработка компонента
+---
+
 # Дополнительная обработка компонента
 
 Предположим, вы хотите сделать лошадку из желудей. Что для этого нужно? Для начала надо взять несколько желудей. Они будут немного отличаться друг от друга: тот, что покрупнее, пойдет на тело лошадки, тонкие желуди пойдут ноги, а вот этот смешной желудь в виде конуса будет мордой нашей лошадки. Конечно же, обмажем все пластилином, чтобы оно держалось вместе.

diff --git a/docs/framework-elements/aliases-grouping.md b/docs/framework-elements/aliases-grouping.md
@@ -1,3 +1,7 @@
+---
+title: Группировка компонентов по алиасу
+---
+
 # Группировка компонентов по алиасу
 
 Представьте себе компанию панков. Каждый из них уникален, каждый - личность. Но при этом у них есть и что-то общее - все они панки. К каждому можно обратиться как: "Эй, ты, панк!", и он не только отзовется громогласным "Хой!", но возможно даже предложит Вам пива.

diff --git a/docs/framework-elements/aliases.md b/docs/framework-elements/aliases.md
@@ -1,3 +1,7 @@
+---
+title: Алиасы компонентов
+---
+
 # Алиасы компонентов
 
 У желудей все как у людей. Есть свои увлечения, субкультуры и даже может быть `&Прозвище`. Желудь `Василий` в силу своего темного прошлого "у своих" зовется не иначе как `Васян`. Как это отразить в ОСени?

diff --git a/docs/framework-elements/annotation-inheritance.md b/docs/framework-elements/annotation-inheritance.md
@@ -1,3 +1,7 @@
+---
+title: Наследование аннотаций
+---
+
 # Наследование аннотаций
 
 Представьте себе ситуацию, когда над несколькими компонентами системы нужно развесить несколько аннотаций по одному и тому же принципу. Например, объявить много компанейских `&Желудей` с одинаковыми `&Прозвищами`. Чтобы упростить себе жизнь, можно создать новую аннотацию, в которой скомбинировать несколько других. Например:

diff --git a/docs/framework-elements/annotations-processing.md b/docs/framework-elements/annotations-processing.md
@@ -1,3 +1,7 @@
+---
+title: Обработка аннотаций
+---
+
 # Обработка аннотаций
 
 Если Вы уже попробовали делать свои `&Напильники`, то скорее всего ознакомились с классом `ОпределениеЖелудя`. Помимо хранения метаинформации о собственно желуде, методы `Свойства()` и `Методы()` возвращают информацию об аннотациях над свойствами и методами уже в "развернутом" и плоском виде.

diff --git a/docs/framework-elements/app-context.md b/docs/framework-elements/app-context.md
@@ -1,3 +1,7 @@
+---
+title: Использование контекста приложения
+---
+
 # Использование контекста приложения
 
 `Поделка` является входной точкой для работы вашего приложения. Через него вы собираете информацию о ваших желудях, инициализируете их. Приятной особенностью "поделки" является то, что он сам по себе тоже является желудем! Все есть желудь, помните же?

diff --git a/docs/framework-elements/app-settings-injection.md b/docs/framework-elements/app-settings-injection.md
@@ -1,3 +1,7 @@
+---
+title: Внедрение настроек приложения
+---
+
 # Внедрение настроек приложения
 
 Хорошая поделка состоит не только из желудей и пластилина, но и обвешана маленькими приятными глазу детальками. Причем разные поделки, собранные по одному и тому же чертежу, могут только этими детальками и отличаться.

diff --git a/docs/framework-elements/component-declaration.md b/docs/framework-elements/component-declaration.md
@@ -1,3 +1,7 @@
+---
+title: Объявление компонента
+---
+
 # Объявление компонента
 
 Как вы, наверное, догадались по словосочетанию "компонентное приложение", основой вашего приложения становится `Желудь`. Жёлудь - это всё, и всё есть жёлудь. `ОбновляторВерсии1С`? Жёлудь. `ПроверяторУстановленныхВерсий`? Тоже Жёлудь. И даже логин с паролем - это тоже в некотором роде жёлуди.

diff --git a/docs/framework-elements/component-instance.md b/docs/framework-elements/component-instance.md
@@ -1,3 +1,7 @@
+---
+title: Получение экземпляра компонента
+---
+
 # Получение экземпляра компонента
 
 Мы определили желудь, настало время его создать!

diff --git a/docs/framework-elements/component-overriding.md b/docs/framework-elements/component-overriding.md
@@ -1,3 +1,7 @@
+---
+title: Переопределение компонента по имени
+---
+
 # Переопределение компонента по имени
 
 Сила Верховного желудя настолько велика, что он может вытеснить данные о более слабом желуде из Поделки.

diff --git a/docs/framework-elements/component-post-initialization.md b/docs/framework-elements/component-post-initialization.md
@@ -1,3 +1,7 @@
+---
+title: Пост-инициализация компонента
+---
+
 # Пост-инициализация компонента
 
 Если вы все еще внимательно следите за нитью документации, у вас мог возникнуть вопрос вида ~~"Что за херня тут происходит"~~ "В каком порядке внедряются зависимости желудя?". И это очень хороший вопрос.

diff --git a/docs/framework-elements/component-uniqueness.md b/docs/framework-elements/component-uniqueness.md
@@ -1,3 +1,7 @@
+---
+title: Уникальность экземпляров компонентов
+---
+
 # Уникальность экземпляров компонентов
 
 Желуди почти как люди. У каждого есть свой `&Характер`. Кто-то показывает его явно, а кто-то ведет себя "как все".

diff --git a/docs/framework-elements/components-binding.md b/docs/framework-elements/components-binding.md
@@ -1,3 +1,6 @@
+---
+title: Связывание компонентов между собой
+---
 
 # Связывание компонентов между собой
 

diff --git a/docs/framework-elements/components-factory.md b/docs/framework-elements/components-factory.md
@@ -1,3 +1,7 @@
+---
+title: Фабрика компонентов
+---
+
 # Фабрика компонентов
 
 Не все желуди обязаны являться полноценными классами с точки зрения системы типов 1Script. Согласитесь, странно заводить целый класс для хранения логина от ИТС, просто потому что кто-то пережарил желудей.

diff --git a/docs/framework-elements/components-prioritization.md b/docs/framework-elements/components-prioritization.md
@@ -1,3 +1,7 @@
+---
+title: Приоритизация компонентов с общим алиасом
+---
+
 # Приоритизация компонентов с общим алиасом
 
 Но давайте будем честны. Когда мы говорим про Sex Pistols, то в первую очередь вспоминаем Сида Вишеса, и только потом уже Джонни Роттена и остальных. А какой у него получился алко-my-way, ух! Аннотация `&Верховный` подскажет "ОСени", кого вы считаете панком "по умолчанию":

diff --git a/docs/framework-elements/components-sorting.md b/docs/framework-elements/components-sorting.md
@@ -1,3 +1,7 @@
+---
+title: Упорядочивание компонентов при получении в виде сортированных коллекций
+---
+
 # Упорядочивание компонентов при получении в виде сортированных коллекций
 
 Если вы прилепляете себе несколько желудей с общим прозвищем в виде массива или таблицы значений, вам может понадобиться расставить их по некоторому порядку. Не будем вдаваться в подробности, кто в SexPistols третий панк, а кто второй, но точно можно предположить, что сессионные музыканты должны быть в самом конце массива панков. В этом нам поможет аннотация `&Порядок`, принимающая числовое значение порядка.

diff --git a/docs/framework-elements/conditional-registration.md b/docs/framework-elements/conditional-registration.md
@@ -1,3 +1,7 @@
+---
+title: Условная регистрация компонентов в контексте приложения
+---
+
 # Условная регистрация компонентов в контексте приложения
 
 Иногда вам может потребоваться выбирать, какие именно классы вы хотите добавлять в свою поделку. Например, вы хотите загружать определенный класс только при выполнении какого-нибудь условия (из-за конфликта имен, к примеру). На помощь придёт объект `&Заготовка`, который можно расценивать как готовый набор желудей, добавляемый в поделку.

diff --git a/docs/framework-elements/custom-annotations.md b/docs/framework-elements/custom-annotations.md
@@ -1,3 +1,7 @@
+---
+title: Собственные аннотации
+---
+
 # Собственные аннотации
 
 OneScript могуч. В отличие от материнской платформы, над любым методом может быть любое количество произвольных аннотаций, у них могут быть именованные и неименованные параметры. Аннотации даже могут быть над `Перем`енными модуля и параметрами методов! Как тебе такое, УанЭс Энтерпрайз?

diff --git a/docs/framework-elements/custom-arguments.md b/docs/framework-elements/custom-arguments.md
@@ -1,3 +1,7 @@
+---
+title: Произвольные аргументы конструктора
+---
+
 # Произвольные аргументы конструктора
 
 Иногда понимание того, что же еще добавить в поделку, приходит в самый последний момент. Буквально после запуска приложения, кодом, на основании какой-то хитрой логики. Да, можно сделать хитрый `&Дуб`, передать в него в виде желудя расчетчик этой самой бизнес-логики, который выдаст нужную циферку, но порой хочется просто передать `42` в конструктор желудя.

diff --git a/docs/framework-elements/dependency-injection.md b/docs/framework-elements/dependency-injection.md
@@ -1,3 +1,7 @@
+---
+title: Внедрение зависимостей в поля и функции-сеттеры
+---
+
 # Внедрение зависимостей в поля и функции-сеттеры
 
 Не всегда бывает удобно пихать желуди прямо в конструктор. Например, желуди могут так сильно зависеть друг от друга, что образуют циклическую зависимость. Как Заяц-Волк, только Желудь-Желудь. В таком случае внедрить зависимости через конструктор не получится. На помощь нам придут внедрение желудей через поля и функции, принимающие значения.

diff --git a/docs/framework-elements/instance-generator.md b/docs/framework-elements/instance-generator.md
@@ -1,3 +1,7 @@
+---
+title: Генератор экземпляров компонентов
+---
+
 # Генератор экземпляров компонентов
 
 Иногда возникает необходимость получить желудь-зависимость отложено. Например, по какому-то условию или с передачей произвольных параметров. Эту задачу можно решить через внедрение в желудь `Поделки` целиком, но умные книжки учат нас, что зависеть от глобального контекста приложения - это вообще-то фу-фу-фу и не надо так. Для уменьшения связывания полезного кода с инфраструктурным в ОСени есть дополнительная аннотация `&Табакерка`. Если ее навесить над полем или параметром метода, над которым уже висит `&Пластилин`, `&Деталька` или `&Блестяшка`, то вместо внедрения в поле или параметр непосредственно нужного значения будет внедрен специальный объект типа `Табакерка`, который позволяет достать желудь/детальку/блестяшку по требованию.

diff --git a/docs/framework-elements/launch-control-inversion.md b/docs/framework-elements/launch-control-inversion.md
@@ -1,3 +1,7 @@
+---
+title: Инверсия управления запуском приложения
+---
+
 # Инверсия управления запуском приложения
 
 Одной из конечных точкой использования фреймворка для внедрения зависимостей является отказ от какой-либо логики при запуске приложения. В конце концов мы же жёлуди в поделку добавляем не просто так, а чтобы они могли `Сообщить("Привет, мир!")`.