Ссылки, код-группы

Author: nixel2007

docs/index.md

@@ -13,9 +13,6 @@ hero:
     - theme: brand
       text: Перейти в документацию
       link: /getting-started/about-autumn
-  #   - theme: alt
-  #     text: GitHub
-  #     link: https://github.com/autumn-library/autumn
 features:
 
   - title: Компонентный подход
@@ -41,12 +38,12 @@ features:
   - title: Annotations
     details: Библиотека для работы с аннотациями, может использоваться отдельно от экосистемы ОСени
     icon: 🍁
-    link: https://autumn-library.github.io/annotations
+    link: /annotations
     linkText: Документация
   - title: Autumn-collections
     details: Модуль реализует функциональность прилепляемых коллекций для ОСени.
     icon: 🐿️
-    link: https://autumn-library.github.io/autumn-collections
+    link: /autumn-collections
     linkText: Документация
 
   - title: "Дополнительные модули общего назначения"
@@ -91,7 +88,7 @@ features:
   - title: Winow
     details: Веб-сервер на чистом OneScript.
     icon: 🍷
-    link: https://autumn-library.github.io/winow
+    link: /winow
     linkText: Документация
   - title: ovm
     details: Менеджер версий OneScript на базе autumn-cli.

docs/products/autumn/framework-elements/010-component-declaration.md

@@ -8,9 +8,9 @@ title: Объявление компонента
 
 Основной способ обозначения класса как желудя - это навешивание аннотации `&Желудь` над конструктором объекта. Вроде такого:
 
-```bsl
-// file: Классы/ПроверяторВерсий.os
+::: code-group
 
+```bsl [Классы/ПроверяторВерсий.os]
 &Желудь
 Процедура ПриСозданииОбъекта()
 
@@ -19,4 +19,6 @@ title: Объявление компонента
 ... прочая очень нужная, но абсолютно не интересная логика класса.
 ```
 
+:::
+
 Главной характеристикой желудя является его имя. По умолчанию имя берется из имени типа (`ПроверяторВерсий` для случая выше), но может быть переопределено в параметре аннотации `&Желудь`.

docs/products/autumn/framework-elements/020-component-instance.md

@@ -8,12 +8,14 @@ title: Получение экземпляра компонента
 
 В создании компонентов нам поможет `Поделка`. Зря что ли мы накидывали в нее желудей?
 
-```bsl
-// file: main.os
+::: code-group
 
+```bsl [main.os]
 ПроверяторВерсий = Поделка.НайтиЖелудь("ПроверяторВерсий");
 
 ПроверяторВерсий.ЧтоНибудьПроверить();
 ```
 
+:::
+
 В результате выполнения куска кода выше в переменную `ПроверяторВерсий` прилетит свеженький блестящий желудь, добавленный ранее под именем "ПроверяторВерсий". Легко и просто, не правда ли?

docs/products/autumn/framework-elements/030-components-binding.md

@@ -8,9 +8,9 @@ title: Связывание компонентов между собой
 
 Для указания зависимостей желудя служит аннотация `&Пластилин`.
 
-```bsl
-// file: Классы/ОбновляторВерсий.os
+::: code-group
 
+```bsl [Классы/ОбновляторВерсий.os]
 Перем _ПроверяторВерсий;
 Перем _Логин;
 Перем _Пароль;
@@ -27,16 +27,20 @@ title: Связывание компонентов между собой
 КонецПроцедуры
 ```
 
- Как же создать такой сложный желудь, сверху донизу обмазанный пластилином? Точно так же.
+:::
 
-```bsl
-// file: main.os
+Как же создать такой сложный желудь, сверху донизу обмазанный пластилином? Точно так же.
 
+::: code-group
+
+```bsl [main.os]
 ОбновляторВерсий = Поделка.НайтиЖелудь("ОбновляторВерсий");
 
 ОбновляторВерсий.ОбновисьЧтоБыТамНеСтояло();
 ```
 
+:::
+
 Заметьте, никаких зависимостей передавать не нужно. "ОСень" все взяла на себя - по именам параметров нашла зарегистрированные желуди и передала их в конструктор объекта.
 
 Если вы начитались Овидия в оригинале или в вас вселился СОТОНА, а может просто потеряли совесть и захотели греческих букв в именах переменных, вы можете подсказать "ОСени", что за зависимость нужна в данном конкретном случае.

docs/products/autumn/framework-elements/040-components-factory.md

@@ -12,9 +12,9 @@ title: Фабрика компонентов
 
 Итак, мы хотим передать Обновлятору логин и пароль в виде желудей. Для этого в новом классе, помеченном аннотацией `&Дуб`, нужно объявить два метода, помеченные аннотацией `&Завязь`. На дубе завязи, из завязей получатся желуди. Логично? Логично. Поехали!
 
-```bsl
-// file: Классы/ДанныеАвторизации.os
+::: code-group
 
+```bsl [Классы/ДанныеАвторизации.os]
 &Дуб
 Процедура ПриСозданииОбъекта()
 КонецПроцедуры
@@ -34,6 +34,8 @@ title: Фабрика компонентов
 КонецФункции
 ```
 
+:::
+
 В листинге выше объявляются две функции-конструктора, возвращающие желуди. Как вы видите, желудь может быть чем угодно, а что угодно (в данном случае - строка) может быть желудем.
 
 Т. к. `Дуб` - это тоже желудь, а методы с "Завязью" - это псевдо-конструкторы, то такой метод может быть скреплен пластилином с другими желудями. Плохие желуди могут даже хардкодить значения паролей, но мы закроем на это глаза.

docs/products/autumn/framework-elements/050-dependency-injection.md

@@ -6,9 +6,9 @@ title: Внедрение зависимостей в поля и функции
 
 Не всегда бывает удобно пихать желуди прямо в конструктор. Например, желуди могут так сильно зависеть друг от друга, что образуют циклическую зависимость. Как Заяц-Волк, только Желудь-Желудь. В таком случае внедрить зависимости через конструктор не получится. На помощь нам придут внедрение желудей через поля и функции, принимающие значения.
 
-```bsl
-// file: Классы/Обновлятор1С.os
+::: code-group
 
+```bsl [Классы/Обновлятор1С.os]
 &Пластилин
 Перем Логин;
 
@@ -24,6 +24,8 @@ title: Внедрение зависимостей в поля и функции
 КонецПроцедуры
 ```
 
+:::
+
 При получении желудя `Обновлятор1С` зависимость `Логин`  будет внедрена в поле напрямую, а зависимость `Пароль` установлена через процедуру `УстановитьПароль`.
 
 Как и в случае с подстановкой желудей в конструктор, имя конкретного желудя может быть переопределено в параметре аннотации `&Пластилин`. По умолчанию имя внедряемого желудя берется либо из имени поля ("Логин") либо из имени метода, из которого отбрасывается префикс "Установить": `УстановитьПароль` `->` `Пароль`.

docs/products/autumn/framework-elements/060-app-settings-injection.md

@@ -14,7 +14,9 @@ title: Внедрение настроек приложения
 
 Конфигурационный файл может быть в виде `json`, `yaml` или `ini` файла, называется `autumn-properties.json`/`autumn-properties.yml`/`autumn-properties.ini` соответственно и ищется ОСенью в каталоге запуска приложения или в подкаталоге `src`.
 
-```json
+::: code-group
+
+```json [autumn-properties.json]
 {
     "Логин": "user",
     "Пароль": "pass",
@@ -24,11 +26,14 @@ title: Внедрение настроек приложения
 }
 ```
 
+:::
+
+
 А вот так их можно использовать в жёлуде:
 
-```bsl
-// file: Классы/Обновлятор1С.os
+::: code-group
 
+```bsl [Классы/Обновлятор1С.os]
 &Деталька
 Перем Логин;
 
@@ -46,6 +51,8 @@ title: Внедрение настроек приложения
 КонецПроцедуры
 ```
 
+:::
+
 Вы можете добавлять к желудю любые детальки вне зависимости от того, есть они в конфигурационном файле или нет.
 
 По умолчанию "ОСень" будет пытаться найти значение настройки по имени параметра конструктора: в json есть параметры "Логин" и "Пароль", в конструкторе есть параметры "Логин" и "Пароль", искра, буря, безумие!

docs/products/autumn/framework-elements/070-custom-arguments.md

@@ -8,9 +8,9 @@ title: Произвольные аргументы конструктора
 
 Для таких случаев в ОСени есть аннотация `&Блестяшка`.
 
-```bsl
-// file: Классы/ЛенивыйЖелудь.os
+::: code-group
 
+```bsl [Классы/ЛенивыйЖелудь.os]
 &Желудь
 Процедура ПриСозданииОбъекта(
     &Пластилин ПроверяторВерсий
@@ -19,6 +19,8 @@ title: Произвольные аргументы конструктора
 КонецПроцедуры
 ```
 
+:::
+
 Как ее использовать? Двумя способами. Первый - это передать все параметры конструктора в виде массива в метод `Поделка.НайтиЖелудь()`:
 
 ```bsl
@@ -46,9 +48,9 @@ title: Произвольные аргументы конструктора
 
 `&Блестяшки` можно внедрять только в конструктор желудя. Внедрение в поля и методы жёлудя не поддерживается. Однако вы можете объявить `&Дуб` и `&Завязь`, куда `&Блестяшку` передать таки можно:
 
-```bsl
-// file: Классы/ДубСЛенивымЖелудем.os
+::: code-group
 
+```bsl [Классы/ДубСЛенивымЖелудем.os]
 &Дуб
 Процедура ПриСозданииОбъекта()
 КонецПроцедуры
@@ -65,11 +67,13 @@ title: Произвольные аргументы конструктора
 КонецПроцедуры
 ```
 
+:::
+
 И в заключение темы, `ЛенивыйЖелудь` (не важно, созданный конструктором или `&Завязью`) можно внедрить в другой желудь, воспользовавшись повторяемым параметром `Блестяшка` в аннотации `&Пластилин`:
 
-```bsl
-// file: Классы/ЛюбительЛенивыхЖелудей.os
+::: code-group
 
+```bsl [Классы/ЛюбительЛенивыхЖелудей.os]
 &Пластилин(Блестяшка = "Шестью девять?")
 Перем ЛенивыйЖелудь;
 
@@ -78,6 +82,8 @@ title: Произвольные аргументы конструктора
 КонецПроцедуры
 ```
 
+:::
+
 При поиске любителя ленивых желудей в него будет прилеплен `ЛенивыйЖелудь` с вопросом `Шестью девять?`.
 
 Повторяемые параметры аннотаций позволяют указывать один и тот же параметр аннотации несколько раз с разными значениями. Например, если у желудя в конструктор принимается несколько блестяшек, то и внедрить такой желудь можно указав несколько блестяшек в аннотации `&Пластилин`:

docs/products/autumn/framework-elements/080-instance-generator.md

@@ -6,9 +6,9 @@ title: Генератор экземпляров компонентов
 
 Иногда возникает необходимость получить желудь-зависимость отложено. Например, по какому-то условию или с передачей произвольных параметров. Эту задачу можно решить через внедрение в желудь `Поделки` целиком, но умные книжки учат нас, что зависеть от глобального контекста приложения - это вообще-то фу-фу-фу и не надо так. Для уменьшения связывания полезного кода с инфраструктурным в ОСени есть дополнительная аннотация `&Табакерка`. Если ее навесить над полем или параметром метода, над которым уже висит `&Пластилин`, `&Деталька` или `&Блестяшка`, то вместо внедрения в поле или параметр непосредственно нужного значения будет внедрен специальный объект типа `Табакерка`, который позволяет достать желудь/детальку/блестяшку по требованию.
 
-```bsl
-// file: Классы/КлассСТабакеркой.os
+::: code-group
 
+```bsl [Классы/КлассСТабакеркой.os]
 &Табакерка
 &Пластилин
 Перем ПроверяторВерсий;
@@ -24,6 +24,8 @@ title: Генератор экземпляров компонентов
 КонецПроцедуры
 ```
 
+:::
+
 В примере выше в поле `ПроверяторВерсий` будет внедрен объект типа `Табакерка`, который позволит получить желудь `ПроверяторВерсий` по требованию.
 
 В метод `Табакерка.Достать()` можно передать параметр-массив с прилепляемыми частицами, аналогично тому, как это делается для `Поделка.НайтиЖелудь(ИмяЖелудя, МассивПрилепляемыхЧастиц)`. Таким образом, можно получить желудь с прилепленными к нему блестяшками или другими рассчитываемыми желудями.

docs/products/autumn/framework-elements/090-aliases.md

@@ -6,25 +6,29 @@ title: Алиасы компонентов
 
 У желудей все как у людей. Есть свои увлечения, субкультуры и даже может быть `&Прозвище`. Желудь `Василий` в силу своего темного прошлого "у своих" зовется не иначе как `Васян`. Как это отразить в ОСени?
 
-```bsl
-// file: Классы/Василий.os
+::: code-group
 
+```bsl [Классы/Василий.os]
 &Желудь
 &Прозвище("Васян")
 Процедура ПриСозданииОбъекта()
 КонецПроцедуры
 
 ```
 
+:::
+
 Как же разные группы желудей могут обращаться к нашему Василию? Сделать это можно и по имени и по прозвищу. И отзовётся при этом один и тот же желудь:
 
-```bsl
-// file: main.os
+::: code-group
 
+```bsl [main.os]
 Василий = Поделка.НайтиЖелудь("Василий");
 Васян = Поделка.НайтиЖелудь("Васян");
 
 Ожидаем.Что(Василий).Равен(Васян);
 ```
 
+:::
+
 Василий может иметь много прозвищ. Поэтому аннотация &Прозвище повторяемая, т. е. на желудь ее можно навесить несколько раз с разными значениями и величать кого угодно и как угодно.