diff --git a/docs/en/md/Start/CLI_version.md b/docs/en/md/Start/CLI_version.md index 7e346f7b4b..e996231c4a 100644 --- a/docs/en/md/Start/CLI_version.md +++ b/docs/en/md/Start/CLI_version.md @@ -4,11 +4,11 @@ sidebar_position: 2 # Working with CLI app -OInt CLI - a command-line application that allows you to use methods of the Open Integration Package independently of 1C and OneScript. It requires .Net Framework 4.8 or a compatible Mono Runtime (automatically installed when using deb and rpm packages) +OInt CLI - a command-line application that allows you to use methods of the Open Integration Package independently of 1C and OneScript ## First start -To get started, you need to call the command `oint` from the command prompt/terminal. If app was installed from packages (Linux) or installer (Windows, after reboot), you can do this from any place without additional actions. When using the portable version (exe executable file), `oint` needs to be run with the full path to the file. In Linux distributions, you may also need to execute `chmod +x /oint beforehand` +To get started, you need to call the command `oint` from the command prompt/terminal. If app was installed from packages (Linux) or installer (Windows, after reboot), you can do this from any place without additional actions. When using the portable version (single executable file), `oint` needs to be run with the full path to the file. In Linux distributions, you may also need to execute `chmod +x /oint beforehand` To run the portable version in RHEL/Fedora/CentOS (distributions using rpm packages), use the command
`mono /oint "$@"` diff --git a/docs/en/md/Start/Release-variants.md b/docs/en/md/Start/Release-variants.md index 9f27ae2134..8c630b08dd 100644 --- a/docs/en/md/Start/Release-variants.md +++ b/docs/en/md/Start/Release-variants.md @@ -23,19 +23,23 @@ These release options are various forms of distribution for the extension for th
## CLI -these release options are various forms of distribution for OInt CLI – a cross-platform terminal/command line application that implements the full functionality of the OpenIntegrations library without being tied to the 1C/OS technology stack. The system requirements for OInt are the system requirements for OneScript: **.Net Framework 4.8 (Windows)** or **a comparable version of Mono (Linux)** - - -**oint.exe** - an executable file that, despite its Windows-oriented extension, is cross-platform. It requires .Net Framework 4.8 or a compatible version of Mono to run. In Windows and Debian-based distributions, this application is launched simply through the command line/terminal, while in RHEL-based distributions, it is launched through ```mono oint.exe "$@"``` +these release options are various forms of distribution for OInt CLI – a cross-platform terminal/command line application that implements the full functionality of the OpenIntegrations library without being tied to the 1C/OS technology stack **oint_x.x.x_installer.exe** - this is a Windows installer. It is the recommended installation method for Windows OS, as it automatically creates the program directory and sets the PATH (after restarting the computer). This allows the application to be launched from any location by simply typing oint in the command line -**oint_x.x.x_all.deb** - this is a DEB package designed for installing OInt on Debian/Ubuntu distributions. When using it, Mono dependencies are installed automatically, so no additional actions are required to start working +**oint_x.x.x_all.deb** - this is a DEB package designed for installing OInt in Debian/Ubuntu distributions. The package has no dependencies, so no additional downloads are required to get started -**oint-x.x.x-1.el7.x86_64.rpm** - this is an RPM package designed for installing OInt on RHEL/Fedora/CentOS distributions. When using it, Mono dependencies are installed automatically, so no additional actions are required to start working. Also, there is no need to run it through mono, as with the exe. +**oint-x.x.x-1.el7.x86_64.rpm** - this is an RPM package designed to install OInt in RHEL/Fedora/CentOS distributions. It automatically suggests the install libicu - the internalisation package (ICU) required for the application to work + + +**oint.exe** - an executable file that, despite its Windows-oriented extension, is cross-platform. It requires .Net Framework 4.8 or a compatible version of Mono to run. In Windows and Debian-based distributions, this application is launched simply through the command line/terminal, while in RHEL-based distributions, it is launched through ```mono oint.exe "$@"``` + +:::warning +The single file delivery is currently *`obsolete`* and is not recommended for use. It has performance issues and depends on the .Net Framework, so it only makes sense for evaluation use in cases where installing from the package/installer is undesirable or impossible for some reason +:::
diff --git a/docs/ru/md/Start/CLI_version.md b/docs/ru/md/Start/CLI_version.md index ab1e5b6e89..1bc6cd577a 100644 --- a/docs/ru/md/Start/CLI_version.md +++ b/docs/ru/md/Start/CLI_version.md @@ -4,7 +4,7 @@ sidebar_position: 2 # Работа с CLI версией -**OInt CLI** - приложение для командой строки, которое позволяет использовать методы Открытого пакета интеграций независимо от 1С и OneScript. Для его работы требуется **.Net Framework 4.8** или сопоставимый **Mono Runtime** (при использовании deb и rpm пакетов устанавливается автоматически) +**OInt CLI** - приложение для командой строки, которое позволяет использовать методы Открытого пакета интеграций независимо от 1С и OneScript ## Первый запуск diff --git a/docs/ru/md/Start/Release-variants.md b/docs/ru/md/Start/Release-variants.md index 088087aede..462121fc84 100644 --- a/docs/ru/md/Start/Release-variants.md +++ b/docs/ru/md/Start/Release-variants.md @@ -23,19 +23,23 @@ sidebar_position: 1
## CLI -Данные варианты релизов - различные формы поставки OInt CLI - кросплатформенного приложения для терминала/командной строки, реализующего полный функционал библиотеки ОПИ без привязки к тех. стеку 1С/OS. Системные требования OInt - системные требования OneScript: **.Net Framework 4.8 (Windows)** или **сопоставимая версия Mono (Linux)** - - -**oint.exe** - исполняемый файл, который, несмотря на Windows-ориентированное расширение, является кросплатформенным. Для запуска требуется .Net Framework 4.8 или Mono совместимой версии. В Windows и Debian-based дистрибутивах данное приложение запускается просто через командную строку/терминал, а в дистрибутивах, основанных на RHEL - через ```mono oint.exe "$@"``` +Данные варианты релизов - различные формы поставки OInt CLI - кросплатформенного приложения для терминала/командной строки, реализующего полный функционал библиотеки ОПИ без привязки к тех. стеку 1С/OS **oint_x.x.x_installer.exe** - это Windows-установщик. Рекомендуемый способ установки для ОС Windows, так как при его использовании автоматически создается каталог программы и прописывается PATH (после презагрузки компьютера). Это позволяет в дальнейшем запускать приложение из любого места, просто написав `oint` в командной строке -**oint_x.x.x_all.deb** - это DEB-пакет, предназанченный для установки OInt в Debian/Ubuntu дистрибутивах. При его использовании зависимости Mono устанавливаются автоматически, следовательно никаких дополнительных действий для начала работы не требуется +**oint_x.x.x_all.deb** - это DEB-пакет, предназанченный для установки OInt в Debian/Ubuntu дистрибутивах. Пакет не обладает зависимостями, следовательно никаких дополнительных подгрузок для начала работы не требуется -**oint-x.x.x-1.el7.x86_64.rpm** - это RPM-пакет, предназанченный для установки OInt в RHEL/Fedora/CentOS дистрибутивах. При его использовании зависимости Mono устанавливаются автоматически, следовательно никаких дополнительных действий для начала работы не требуется. Также не требуется запуск через `mono`, как в случае с exe +**oint-x.x.x-1.el7.x86_64.rpm** - это RPM-пакет, предназанченный для установки OInt в RHEL/Fedora/CentOS дистрибутивах. При его использовании автоматически предлогается установка libicu - пакета интернализации (ICU), необходимый для работы приложения + + +**oint.exe** - исполняемый файл, который, несмотря на Windows-ориентированное расширение, является кросплатформенным. Для запуска требуется .Net Framework 4.8 или Mono совместимой версии. В Windows и Debian-based дистрибутивах данное приложение запускается просто через командную строку/терминал, а в дистрибутивах, основанных на RHEL - через ```mono oint.exe "$@"``` + +:::warning +Поставка одним файлом на данный момент является устаревшей и не рекомендуется к использованию. Она имеет проблемы с производительностью и зависит от .Net Framework, поэтому имеет смысл только для ознакомительного использования в тех случаях, когда установка из пакета/установщика по какой-то причине нежелательна или невозможна +:::