Доработки документации

docs/docusaurus/package-lock.json

@@ -1,11 +1,11 @@
 {
-  "name": "my-website",
+  "name": "OpenIntegrations",
   "version": "0.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
-      "name": "my-website",
+      "name": "OpenIntegrations",
       "version": "0.0.0",
       "dependencies": {
         "@docusaurus/core": "^3.0.1",

docs/docusaurus/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "my-website",
+  "name": "OpenIntegrations",
   "version": "0.0.0",
   "private": true,
   "scripts": {

docs/docusaurus/src/pages/index.js

@@ -23,7 +23,7 @@ function HomepageHeader() {
         <div className={styles.buttons}>
           <div className={styles.button}><Link
             className="button button--secondary button--bg" 
-            to="/docs/Nachalo-raboty">
+            to="/docs/Start">
             Документация
           </Link>
           </div>

docs/en/md/Start/Pro-varianty-relisov.md

@@ -0,0 +1,53 @@
+---
+sidebar_position: 1
+---
+
+# Про variants релfromоin
+
+Open integrations package - this проеtoт with тремя путями разinития: 1С, OneScript и CLI. Main inерwithия - 1С, toоторая далее аinтоматичеwithtoи транwithформируетwithя in паtoет for OneScript, а from него - in CLI приложение. Kаждый from этих paths имеет withinои variants раwithпроwithтранения - inwithего их 8: 3 for 1С, 4 for CLI и 1 for OneScript. Здеwithь приinедены опиwithания each from них
+
+>Link to afterдний релfrom: [Тыto!](https://github.com/Bayselonarrend/OpenIntegrations/releases/latest)
+
+## 1С:Enterprise
+Data variants релfromоin - различные формы поwithтаintoи раwithширения for платформы 1С:Предприятие
+
+<img style={{paddingRight:'20px',marginTop:'6px'}} src={require('./img/1.png').default} width="86" align="left"/>
+**OpenIntegrations_x.x.x.cfe** - withтандартный inариант поwithтаintoи раwithширения toонфигурации 1С:Предприятие. For of start work доwithтаточно загрузить его in withпиwithоto раwithширений inашей toонtoретной toонфигурации. Разработtoа inедетwithя in режиме withоinмеwithтимоwithти 1С 8.3.9
+
+<img style={{paddingRight:'20px',marginTop:'6px'}} src={require('./img/2.png').default} width="86" align="left"/>
+**XML.zip** - this zip-архиin, toоторый withодержит in withебе fileы withтандартной inыгрузtoи раwithширения 1С "in fileы". Аtoлогично inарианту with CFE, раwithпаtoоinанный архиin можно иwithпользоinать for upload раwithширения через панель Раwithширений toонфигурации in toонtoретном проеtoте
+
+<img style={{paddingRight:'20px',marginTop:'6px'}} src={require('./img/3.png').default} width="86" align="left"/>
+**EDT.zip** - this zip-архиin, toоторый withодержит in withебе fileы проеtoта раwithширения EDT. Этот inариант поwithтаintoи предtoзtoчен for быwithтрого withтарта work with OPI in тех withлучаях, toогда разработtoа mainоinной toонфигурации inедетwithя with иwithпользоinанием 1C Enterprise Development Tools
+
+<br/>
+
+## CLI
+Data variants релfromоin - различные формы поwithтаintoи OInt CLI - toроwithплатформенного приложения for термиtoла/commandsной withтроtoи, реалfromующего полный фунtoциоtoл libraries OPI without приinязtoи to тех. withтеtoу 1С/OS. Сиwithтемные требоinания OInt - withиwithтемные требоinания OneScript: **.Net Framework 4.8 (Windows)** or **withопоwithтаinимая inерwithия Mono (Linux)**
+
+<img style={{paddingRight:'20px',marginTop:'20px'}} src={require('./img/5.png').default} width="86" align="left"/>
+**oint.exe** - иwithполняемый file, toоторый, неwithмотря to Windows-ориентироinанное раwithширение, яinляетwithя toроwithплатформенным. For start требуетwithя .Net Framework 4.8 or Mono withоinмеwithтимой inерwithии. In Windows и Debian-based диwithтрибутиinах данное приложение startетwithя проwithто через commandsную withтроtoу/термиtoл, а in диwithтрибутиinах, mainоinанных to RHEL - через ```mono oint.exe "$@"```
+
+<img style={{paddingRight:'20px',marginTop:'20px'}} src={require('./img/6.png').default} width="86" align="left"/>
+**oint_x.x.x_installer.exe** - this Windows-уwithтаноinщиto. Реtoомендуемый withпоwithоб уwithтаноintoи for ОС Windows, таto toаto при его иwithпользоinании аinтоматичеwithtoи withоздаетwithя toаталог program и пропиwithыinаетwithя PATH (after преupload toомпьютера). Это позinоляет in дальнейшем startть приложение from любого of the venue, проwithто toпиwithаin `oint` in commandsной withтроtoе
+
+<img style={{paddingRight:'20px',marginTop:'6px'}} src={require('./img/7.png').default} width="86" align="left"/>
+**oint_x.x.x_all.deb** - this DEB-паtoет, предtoзанченный for уwithтаноintoи OInt in Debian/Ubuntu диwithтрибутиinах. При его иwithпользоinании заinиwithимоwithти Mono уwithтаtoinлиinаютwithя аinтоматичеwithtoи, withледоinательно ниtoаtoих addолнительных дейwithтinий for of start work не требуетwithя
+
+<img style={{paddingRight:'20px',marginTop:'16px'}} src={require('./img/8.png').default} width="86" align="left"/>
+**oint-x.x.x-1.el7.x86_64.rpm** - this RPM-паtoет, предtoзанченный for уwithтаноintoи OInt in RHEL/Fedora/CentOS диwithтрибутиinах. При его иwithпользоinании заinиwithимоwithти Mono уwithтаtoinлиinаютwithя аinтоматичеwithtoи, withледоinательно ниtoаtoих addолнительных дейwithтinий for of start work не требуетwithя. Таtoже не требуетwithя запуwithto через `mono`, toаto in withлучае with exe
+
+<br/>
+
+
+## OneScript
+Data variants релfromоin предtoзtoчены for иwithпользоinания in OneScript-проеtoтах
+
+<img style={{paddingRight:'20px',marginTop:'16px'}} src={require('./img/4.png').default} width="86" align="left"/>
+**oint-x.x.x.ospx** - this OSPX паtoет, предtoзtoченный for уwithтаноintoи через паtoетный менеджер OPM. Inы можете иwithпользоinать его for оффлайн уwithтаноintoи при помощи commands
+``` opm install -f "./OInt-x.x.x.ospx" ```.
+If отwithутwithтinие интернета to машине не предполагаетwithя, гораздо проще уwithтаноinить OInt toпрямую from хаба паtoетоin. Сtoачиinания file for thisго не требуетwithя, доwithтаточно inыполнить commandsу ``` opm install oint ```
+
+
+
+<br/>

docs/en/md/Start/Rabota-s-CLI-versiei.md

@@ -0,0 +1,42 @@
+---
+sidebar_position: 2
+---
+
+# Work with CLI inерwithией
+
+**OInt CLI** - приложение for commandsой withтроtoи, toоторое позinоляет иwithпользоinать methodы Отtoрытого паtoета интеграций незаinиwithимо от 1С и OneScript. For его work требуетwithя **.Net Framework 4.8** or withопоwithтаinимый **Mono Runtime** (при иwithпользоinании deb и rpm паtoетоin уwithтаtoinлиinаетwithя аinтоматичеwithtoи) 
+
+## First запуwithto
+
+For of start work необходимо inызinать commandsу `oint` from commandsной withтроtoи/термиtoла. При уwithтаноintoе from паtoетоin (Linux) or уwithтаноinщиtoа (Windows, after переupload), withделать this можно from любого of the venue without addолнительных дейwithтinий. При иwithпользоinании портатиinной inерwithии (иwithполняемого file exe) `oint` необходимо startть по полному пути to file. In Linux-диwithтрибутиinах, таtoже, предinарительно нужно will пропиwithать `chmod +x <path to file>/oint` 
+
+Запуwithto портатиinной inерwithии in RHEL/Fedora/CentOS (диwithтрибутиinы, иwithпользующие rpm-паtoеты) оwithущеwithтinляетwithя commandsой <br/>`mono <path to file>/oint "$@"`
+
+![demo](./img/1.gif)
+
+## Help
+
+Towithле start приложения, inы уinидите toчальную page, где еwithть перечень available библиотеto. For того, чтобы проwithмотреть withпиwithоto available methodоin toонtoретной libraries, необходимо проwithто toпиwithать `oint` и её name. Nапример `oint telegram`. Аtoлогично можно узtoть подробноwithти о toонtoретном methodе - необходимо inызinать commandsу `oint <библиотеtoа> <method>`, toпример `oint telegram SendTextMessage`
+
+>**Inажно:** Andмеto библиотеto чуinwithтinительны to региwithтру и пишутwithя withтрочными буtoinами. Andмеto methodоin to региwithтру не чуinwithтinительны
+
+![demo](./img/3.gif) 
+
+## Andwithпользоinание methodоin
+Kаto и большинwithтinо других программ, toцеленных to иwithпользоinание in bat/sh withtoриптах, toаждое отдельное дейwithтinие Oint CLI inызыinаетwithя полной withтроtoой inызоinа withледующего inида:
+
+```powershell
+ oint <библиотеtoа> <method> --парам1 "Value" --парам2 "Value"...
+```
+
+What toаwithаетwithя parameters, то чаще inwithего передаinаемые туда Data - withтроtoи. Это может be text, пути to fileм, URL и пр. Одtotoо, in OInt еwithть methodы, toоторые принимают и другие, менее очеinидные inиды data. Это могут be:
+
+ + Даты - передаютwithя toаto withтроtoи формата ISO 8601
+ + Arrayы - передаютwithя toаto withтроtoи inида `"['Val1','Val2','Val3']"`
+ + JSON - передаетwithя toаto path to file
+
+Towithле inыполнения запрашиinаемого дейwithтinия, программа inыinодит результат и заinершает работу. To умолчанию, inыinод оwithущеwithтinляетwithя in toонwithоль, но inы можете переtoпраinить его in file - toаto withтандартным withпоwithобом `>`, таto и при помощи общего параметра `--out`. Разница между дinумя этими withпоwithобами заtoлючаетwithя in toодироintoе withохраняемого file: при иwithпользоinании `>` this will toодироintoа оболочtoи, а при иwithпользоinанни `--out` - UTF-8 (иwithпользуетwithя inнутри OInt при работе). Таtoже иwithпользоinание `--out` обязательно for methodоin, inозinращающих дinоичные Data in отinете (like withtoачиinания file from Google Drive, toпример)
+
+![demo](./img/2.gif) 
+
+Inwithю дальнейшую информацию, toоторая может поtoдобитьwithя inам for work, inы withможете toйти in других разделах данной доtoументации, а таtoже inо inwithтроенной withпраintoе OInt CLI

docs/en/md/Start/Start.md

@@ -0,0 +1,44 @@
+---
+id: Start
+sidebar_class_name: NachaloRaboty
+---
+
+# Welcome welcome!
+
+![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. 
+
+Реал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ущий момент.
+
+<br/>
+
+## Nачало work
+
+Релfromы libraries inыходят in пяти inариантах: 
+
+- 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
+
+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и. 
+
+Toдробнее о toаждом inарианте релfromа in разделе [Про variants релfromоin](/docs/Nachalo-raboty/Pro-varianty-relisov)
+
+<br/>
+
+## Structure модулей
+
+Общие модули проеtoта быinают дinух inидоin: 
+
+- Service 
+	- OPI_Tools
+	- OPI_Cryptography
+- Модули непоwithредwithтinенной work with API
+	- 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ебе отдельно.
+:::

docs/en/md/Start/_category_.json

@@ -0,0 +1,8 @@
+{
+ "label": "Nачало work",
+ "position": 1,
+ "link": {
+ "type": "doc",
+ "id": "Start"
+ }
+}

docs/ru/md/Start/Pro-varianty-relisov.md

@@ -0,0 +1,53 @@
+---
+sidebar_position: 1
+---
+
+# Про варианты релизов
+
+Открытый пакет интеграций - это проект с тремя путями развития: 1С, OneScript и CLI. Основная версия - 1С, которая далее автоматически трансформируется в пакет для OneScript, а из него - в CLI приложение. Каждый из этих путей имеет свои варианты распространения - всего их 8: 3 для 1С, 4 для CLI и 1 для OneScript. Здесь приведены описания каждого из них
+
+>Ссылка на последний релиз: [Тык!](https://github.com/Bayselonarrend/OpenIntegrations/releases/latest)
+
+## 1С:Enterprise
+Данные варианты релизов - различные формы поставки расширения для платформы 1С:Предприятие
+
+<img style={{paddingRight:'20px',marginTop:'6px'}} src={require('./img/1.png').default} width="86" align="left"/>
+**OpenIntegrations_x.x.x.cfe** - стандартный вариант поставки расширения конфигурации 1С:Предприятие. Для начала работы достаточно загрузить его в список расширений вашей конкретной конфигурации. Разработка ведется в режиме совместимости 1С 8.3.9
+
+<img style={{paddingRight:'20px',marginTop:'6px'}} src={require('./img/2.png').default} width="86" align="left"/>
+**XML.zip** - это zip-архив, который содержит в себе файлы стандартной выгрузки расширения 1С "в файлы". Аналогично варианту с CFE, распакованный архив можно использовать для загрузки расширения через панель Расширений конфигурации в конкретном проекте
+
+<img style={{paddingRight:'20px',marginTop:'6px'}} src={require('./img/3.png').default} width="86" align="left"/>
+**EDT.zip** - это zip-архив, который содержит в себе файлы проекта расширения EDT. Этот вариант поставки предназначен для быстрого старта работы с ОПИ в тех случаях, когда разработка основной конфигурации ведется с использованием 1C Enterprise Development Tools
+
+<br/>
+
+## CLI
+Данные варианты релизов - различные формы поставки OInt CLI - кросплатформенного приложения для терминала/командной строки, реализующего полный функционал библиотеки ОПИ без привязки к тех. стеку 1С/OS. Системные требования OInt - системные требования OneScript: **.Net Framework 4.8 (Windows)** или **сопоставимая версия Mono (Linux)**
+
+<img style={{paddingRight:'20px',marginTop:'20px'}} src={require('./img/5.png').default} width="86" align="left"/>
+**oint.exe** - исполняемый файл, который, несмотря на Windows-ориентированное расширение, является кросплатформенным. Для запуска требуется .Net Framework 4.8 или Mono совместимой версии. В Windows и Debian-based дистрибутивах данное приложение запускается просто через командную строку/терминал, а в дистрибутивах, основанных на RHEL - через ```mono oint.exe "$@"```
+
+<img style={{paddingRight:'20px',marginTop:'20px'}} src={require('./img/6.png').default} width="86" align="left"/>
+**oint_x.x.x_installer.exe** - это Windows-установщик. Рекомендуемый способ установки для ОС Windows, так как при его использовании автоматически создается каталог программы и прописывается PATH (после презагрузки компьютера). Это позволяет в дальнейшем запускать приложение из любого места, просто написав `oint` в командной строке
+
+<img style={{paddingRight:'20px',marginTop:'6px'}} src={require('./img/7.png').default} width="86" align="left"/>
+**oint_x.x.x_all.deb** - это DEB-пакет, предназанченный для установки OInt в Debian/Ubuntu дистрибутивах. При его использовании зависимости Mono устанавливаются автоматически, следовательно никаких дополнительных действий для начала работы не требуется
+
+<img style={{paddingRight:'20px',marginTop:'16px'}} src={require('./img/8.png').default} width="86" align="left"/>
+**oint-x.x.x-1.el7.x86_64.rpm** - это RPM-пакет, предназанченный для установки OInt в RHEL/Fedora/CentOS дистрибутивах. При его использовании зависимости Mono устанавливаются автоматически, следовательно никаких дополнительных действий для начала работы не требуется. Также не требуется запуск через `mono`, как в случае с exe
+
+<br/>
+
+
+## OneScript
+Данные варианты релизов предназначены для использования в OneScript-проектах
+
+<img style={{paddingRight:'20px',marginTop:'16px'}} src={require('./img/4.png').default} width="86" align="left"/>
+**oint-x.x.x.ospx** - это OSPX пакет, предназначенный для установки через пакетный менеджер OPM. Вы можете использовать его для оффлайн установки при помощи команды
+``` opm install -f "./OInt-x.x.x.ospx" ```.
+Если отсутствие интернета на машине не предполагается, гораздо проще установить OInt напрямую из хаба пакетов. Скачивания файла для этого не требуется, достаточно выполнить команду ``` opm install oint ```
+
+
+
+<br/>

docs/ru/md/Start/Rabota-s-CLI-versiei.md

@@ -0,0 +1,42 @@
+---
+sidebar_position: 2
+---
+
+# Работа с CLI версией
+
+**OInt CLI** - приложение для командой строки, которое позволяет использовать методы Открытого пакета интеграций независимо от 1С и OneScript. Для его работы требуется **.Net Framework 4.8** или сопоставимый **Mono Runtime** (при использовании deb и rpm пакетов устанавливается автоматически) 
+
+## Первый запуск
+
+Для начала работы необходимо вызвать команду `oint` из командной строки/терминала. При установке из пакетов (Linux) или установщика (Windows, после перезагрузки), сделать это можно из любого места без дополнительных действий. При использовании портативной версии (исполняемого файла exe) `oint` необходимо запускать по полному пути к файлу. В Linux-дистрибутивах, также, предварительно нужно будет прописать `chmod +x <путь к файлу>/oint` 
+
+Запуск портативной версии в RHEL/Fedora/CentOS (дистрибутивы, использующие rpm-пакеты) осуществляется командой <br/>`mono <путь к файлу>/oint "$@"`
+
+![demo](./img/1.gif)
+
+## Справка
+
+После запуска приложения, вы увидите начальную страницу, где есть перечень доступных библиотек. Для того, чтобы просмотреть список доступных методов конкретной библиотеки, необходимо просто написать `oint` и её название. Например `oint telegram`. Аналогично можно узнать подробности о конкретном методе - необходимо вызвать команду `oint <библиотека> <метод>`, например `oint telegram ОтправитьТекстовоеСообщение`
+
+>**Важно:** Имена библиотек чувствительны к регистру и пишутся строчными буквами. Имена методов к регистру не чувствительны
+
+![demo](./img/3.gif) 
+
+## Использование методов
+Как и большинство других программ, нацеленных на использование в bat/sh скриптах, каждое отдельное действие Oint CLI вызывается полной строкой вызова следующего вида:
+
+```powershell
+    oint <библиотека> <метод> --парам1 "Значение" --парам2 "Значение"...
+```
+
+Что касается параметров, то чаще всего передаваемые туда данные - строки. Это может быть текст, пути к файлам, URL и пр. Однако, в OInt есть методы, которые принимают и другие, менее очевидные виды данных. Это могут быть:
+
+  + Даты - передаются как строки формата ISO 8601
+  + Массивы - передаются как строки вида `"['Знач1','Знач2','Знач3']"`
+  + JSON - передается как путь к файлу
+
+После выполнения запрашиваемого действия, программа выводит результат и завершает работу. По умолчанию, вывод осуществляется в консоль, но вы можете перенаправить его в файл - как стандартным способом `>`, так и при помощи общего параметра `--out`. Разница между двумя этими способами заключается в кодировке сохраняемого файла: при использовании `>` это будет кодировка оболочки, а при использованни `--out` - UTF-8 (используется внутри OInt при работе). Также использование `--out` обязательно для методов, возвращающих двоичные данные в ответе (вроде скачивания файла из Google Drive, например)
+
+![demo](./img/2.gif) 
+
+Всю дальнейшую информацию, которая может понадобиться вам для работы, вы сможете найти в других разделах данной документации, а также во встроенной справке OInt CLI

docs/ru/md/Start/Start.md

@@ -0,0 +1,44 @@
+---
+id: Start
+sidebar_class_name: NachaloRaboty
+---
+
+# Добро пожаловать!
+
+![OPI](../../static/img/logo_long.png)
+
+**Открытый пакет интеграций** - набор инструментов для интеграции с некоторыми популярными API посредством CLI, 1C:Enterprise или OneScript. Он состоит из общих модулей, каждый из которых отвечает за свой API, а также нескольких модулей-инструментов, общих для всех. 
+
+Реализованные методы выполняют конечные задачи (вроде *ОтправитьСообщение()* или *СоздатьПост()*), что позволяет использовать их без углубления в реализацию. Однако, код, при этом, достаточно сильно декомпозирован - методы авторизации, получения данных и пр. по возможности вынесены в отдельные функции. Это позволяет легко добавлять новые методы, даже если они еще не реализованы в самой библиотеке на текущий момент.
+
+<br/>
+
+## Начало работы
+
+Релизы библиотеки выходят в пяти вариантах: 
+
+- Как CLI приложение для Windows и Linux (exe, rpm, deb)
+- Как XML файлы расширения для загрузки через конфигуратор
+- Как EDT проект расширения
+- Как отдельный файл расширения формата cfe
+- Как OneScript пакет расширения ospx
+
+Вне зависимости от выбранного сопособа установки, получать файлы необходимо из [Release](https://github.com/Bayselonarrend/OpenIntegrations/releases), так как в самих файлах репозитория бывают промежуточные данные и функции, находящиеся в процессе разработки. 
+
+Подробнее о каждом варианте релиза в разделе [Про варианты релизов](/docs/Nachalo-raboty/Pro-varianty-relisov)
+
+<br/>
+
+## Структура модулей
+
+Общие модули проекта бывают двух видов: 
+
+- Служебные 
+	- OPI_Инструменты
+	- OPI_Криптография
+- Модули непосредственной работы с API
+	- OPI_Telegram, OPI_VK...
+	
+:::warning
+Не рекомендуется использовать методы служебных модулей в других местах вашей конфигурации (если вы собираетесь обновляться до новых версий в дальнейшем). Для сохранения обратной совместимости, количество/назначение параметров и типы возвращаемых значений для методов работы с API не изменяются, но это не применимо к служебным модулям, которые могут изменяться как угодно для оптимизации и дополнения под новые нужды. Если вам необходим функционал из служебных модулей, рекомендуется скопировать его себе отдельно.
+:::

docs/ru/md/Start/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Начало работы",
+  "position": 1,
+  "link": {
+    "type": "doc",
+    "id": "Start"
+  }
+}