Перевод docusaurus

.github/workflows/docs_deploy_en.yml

@@ -16,6 +16,13 @@ jobs:
     - uses: actions/checkout@v4
       with:
         fetch-depth: 0
+
+    - uses: otymko/setup-onescript@v1.4
+      with:
+        version: 1.9.0 
+
+    - name: Перевести контент страниц
+      run: oscript ./.github/workflows/os/docs_pagetranslate.os
         
     - uses: actions/setup-node@v4
       with:

.github/workflows/os/docs_pagetranslate.os

@@ -0,0 +1,44 @@
+ПутьКСловарю  = ".\service\dictionaries\en.json";
+
+ЧтениеJSON = Новый ЧтениеJSON();
+ЧтениеJSON.ОткрытьФайл(ПутьКСловарю);
+Словарь = ПрочитатьJSON(ЧтениеJSON, Истина);
+ЧтениеJSON.Закрыть();
+
+ТаблицаСловаря = Новый ТаблицаЗначений();
+ТаблицаСловаря.Колонки.Добавить("Ключ");
+ТаблицаСловаря.Колонки.Добавить("Значение");
+ТаблицаСловаря.Колонки.Добавить("Длина");
+
+Для Каждого КлючевоеСлово Из Словарь Цикл
+	НоваяСтрокаСловаря = ТаблицаСловаря.Добавить();
+	НоваяСтрокаСловаря.Ключ      = КлючевоеСлово.Ключ;
+	НоваяСтрокаСловаря.Значение  = КлючевоеСлово.Значение;
+	НоваяСтрокаСловаря.Длина     = СтрДлина(КлючевоеСлово.Ключ);
+КонецЦикла;
+
+ТаблицаСловаря.Сортировать("Длина УБЫВ");
+
+ПутьДокозавра = "./docs/docusaurus/";
+МассивФайлов = Новый Массив;
+МассивФайлов.Добавить(Новый Файл(ПутьДокозавра + "src/components/HomepageFeatures/index.js"));
+МассивФайлов.Добавить(Новый Файл(ПутьДокозавра + "src/pages/index.js"));
+МассивФайлов.Добавить(Новый Файл(ПутьДокозавра + "docusaurus.config.js"));
+
+Для Каждого Файл Из МассивФайлов Цикл
+
+	ТекущийПуть = Файл.ПолноеИмя;
+	ТекущийДокумент = Новый ТекстовыйДокумент();
+	ТекущийДокумент.Прочитать(ТекущийПуть, "UTF-8");
+
+	ТекущийТекст = ТекущийДокумент.ПолучитьТекст();
+
+
+	Для Каждого Слово Из ТаблицаСловаря Цикл
+		ТекущийТекст = СтрЗаменить(ТекущийТекст, Слово.Ключ, Слово.Значение);
+	КонецЦикла;
+
+	ТекущийДокумент.УстановитьТекст();
+	ТекущийДокумент.Записать(Файл.ПолноеИмя);
+
+КонецЦикла;

docs/en/md/Start/Start.md

@@ -7,38 +7,38 @@ sidebar_class_name: NachaloRaboty
 
 ![OPI](../../static/img/logo_long.png)
 
-**Open integrations package** - toбор инwithтрументоin for интеграции with неtoоторыми популярными API поwithредwithтinом CLI, 1C:Enterprise or OneScript. Он withоwithтоит from общих модулей, toаждый from toоторых отinечает за withinой API, а таtoже неwithtoольtoих модулей-инwithтрументоin, общих for all. 
+**Open Integrations Package** - is a set of tools for integration with some popular APIs via CLI, 1C, or OneScript. It consists of common modules, each responsible for its own API, as well as several utility modules that are common to all. 
 
-Реалfromоinанные methodы inыполняют toонечные задачи (like *SendMessage()* or *CreatePost()*), что позinоляет иwithпользоinать их without углубления in реалfromацию. Одtotoо, toод, при thisм, доwithтаточно withильно деtoомпозироinан - methodы аinторfromации, получения data и пр. по inозможноwithти inынеwithены in отдельные фунtoции. Это позinоляет легtoо добаinлять ноinые methodы, даже еwithли они еще не реалfromоinаны in withамой библиотеtoе to теtoущий момент.
+The implemented methods perform specific tasks (such as *SendMessage()* or *CreatePost()*), allowing them to be used without delving into the implementation details. However, the code is highly decomposed – authorization methods, data retrieval, etc., are separated into individual functions where possible. This makes it easy to add new methods, even if they are not yet implemented in the library at the current time.
 
 <br/>
 
 ## Nачало work
 
-Релfromы libraries inыходят in пяти inариантах: 
+The library releases come in five variants: 
 
-- Kаto CLI приложение for Windows и Linux (exe, rpm, deb)
-- Kаto XML fileы раwithширения for upload через toонфигуратор
-- Kаto EDT проеtoт раwithширения
-- Kаto отдельный file раwithширения формата cfe
-- Kаto OneScript паtoет раwithширения ospx
+- As a CLI application for Windows and Linux (exe, rpm, deb)
+- As XML extension files for loading via the configurator
+- As an EDT extension project
+- As a standalone extension file in cfe format
+- As a OneScript extension package in ospx format
 
-Inне заinиwithимоwithти от inыбранного withопоwithоба уwithтаноintoи, получать fileы необходимо from [Release](https://github.com/Bayselonarrend/OpenIntegrations/releases), таto toаto in withамих fileх репозитория быinают промежуточные Data и фунtoции, toходящиеwithя in процеwithwithе разработtoи. 
+Regardless of the chosen installation method, the files must be obtained from the [Release](https://github.com/Bayselonarrend/OpenIntegrations/releases)section, as the repository files may contain intermediate data and functions that are still in development. 
 
-Toдробнее о toаждом inарианте релfromа in разделе [Про variants релfromоin](/docs/Start/Pro-varianty-relisov)
+For more details about each release variant, see the section [About Release Variants](/docs/Start/Pro-varianty-relisov)
 
 <br/>
 
 ## Structure модулей
 
-Общие модули проеtoта быinают дinух inидоin: 
+The project's common modules come in two types: 
 
 - Service 
 	- OPI_Tools
 	- OPI_Cryptography
-- Модули непоwithредwithтinенной work with API
+- Modules for direct interaction with APIs
 	- OPI_Telegram, OPI_VK...
 	
 :::warning
-Not реtoомендуетwithя иwithпользоinать methodы withлужебных модулей in других of the venueх inашей toонфигурации (еwithли inы withобираетеwithь обноinлятьwithя до ноinых inерwithий in дальнейшем). For withохранения обратной withоinмеwithтимоwithти, toоличеwithтinо/tovalue parameters и typeы inозinращаемых зtoчений for methodоin work with API не changeеняютwithя, но this не применимо to withлужебным модулям, toоторые могут changeенятьwithя toаto угодно for оптимfromации и addолнения под ноinые нужды. If inам необходим фунtoциоtoл from withлужебных модулей, реtoомендуетwithя withtoопироinать его withебе отдельно.
+It is not recommended to use the methods of utility modules in other parts of your configuration (if you plan to update to new versions in the future). To maintain backward compatibility, the number/purpose of parameters and the return types for API interaction methods do not change, but this does not apply to utility modules, which can be modified in any way for optimization and adaptation to new requirements. If you need functionality from the utility modules, it is recommended to copy it separately.
 :::

service/dictionaries/en.json

@@ -3538,6 +3538,20 @@
 "Материалы встреч": "Meeting materials",
 "Море":"Sea",
 "Москва": "Moscow",
-"Перемещенная": "Moved"
-
+"Перемещенная": "Moved",
+"**Открытый пакет интеграций**":"**Open Integrations Package**",
+"набор инструментов для интеграции с некоторыми популярными API посредством CLI, 1C:Enterprise или OneScript. Он состоит из общих модулей, каждый из которых отвечает за свой API, а также нескольких модулей-инструментов, общих для всех.": " is a set of tools for integration with some popular APIs via CLI, 1C, or OneScript. It consists of common modules, each responsible for its own API, as well as several utility modules that are common to all.",
+"Реализованные методы выполняют конечные задачи (вроде *ОтправитьСообщение()* или *СоздатьПост()*), что позволяет использовать их без углубления в реализацию. Однако, код, при этом, достаточно сильно декомпозирован - методы авторизации, получения данных и пр. по возможности вынесены в отдельные функции. Это позволяет легко добавлять новые методы, даже если они еще не реализованы в самой библиотеке на текущий момент.":"The implemented methods perform specific tasks (such as *SendMessage()* or *CreatePost()*), allowing them to be used without delving into the implementation details. However, the code is highly decomposed – authorization methods, data retrieval, etc., are separated into individual functions where possible. This makes it easy to add new methods, even if they are not yet implemented in the library at the current time.",
+"Релизы библиотеки выходят в пяти вариантах:":"The library releases come in five variants:",
+"Как CLI приложение для Windows и Linux (exe, rpm, deb)":"As a CLI application for Windows and Linux (exe, rpm, deb)",
+"Как XML файлы расширения для загрузки через конфигуратор":"As XML extension files for loading via the configurator",
+"Как EDT проект расширения":"As an EDT extension project",
+"Как отдельный файл расширения формата cfe":"As a standalone extension file in cfe format",
+"Как OneScript пакет расширения ospx":"As a OneScript extension package in ospx format",
+"Вне зависимости от выбранного сопособа установки, получать файлы необходимо из": "Regardless of the chosen installation method, the files must be obtained from the",
+", так как в самих файлах репозитория бывают промежуточные данные и функции, находящиеся в процессе разработки.":"section, as the repository files may contain intermediate data and functions that are still in development.",
+"Подробнее о каждом варианте релиза в разделе [Про варианты релизов]": "For more details about each release variant, see the section [About Release Variants]",
+"Общие модули проекта бывают двух видов:":"The project's common modules come in two types:",
+"Модули непосредственной работы с API":"Modules for direct interaction with APIs",
+"Не рекомендуется использовать методы служебных модулей в других местах вашей конфигурации (если вы собираетесь обновляться до новых версий в дальнейшем). Для сохранения обратной совместимости, количество/назначение параметров и типы возвращаемых значений для методов работы с API не изменяются, но это не применимо к служебным модулям, которые могут изменяться как угодно для оптимизации и дополнения под новые нужды. Если вам необходим функционал из служебных модулей, рекомендуется скопировать его себе отдельно":"It is not recommended to use the methods of utility modules in other parts of your configuration (if you plan to update to new versions in the future). To maintain backward compatibility, the number/purpose of parameters and the return types for API interaction methods do not change, but this does not apply to utility modules, which can be modified in any way for optimization and adaptation to new requirements. If you need functionality from the utility modules, it is recommended to copy it separately"
 }