Дописал еще несколько разделов

EvilBeaver · EvilBeaver · commit e2e06d387e3c · 2024-12-31T13:00:07.000+03:00
diff --git a/.vitepress/config.mts b/.vitepress/config.mts
@@ -23,7 +23,7 @@ export default defineConfig({
 
   lang: 'ru-RU',
 
-  base: '/OneScript.WebSite',
+  base: '/',
 
   srcDir: 'docs',
 
diff --git a/docs/images/vscode-launch.png b/docs/images/vscode-launch.png
diff --git a/docs/images/vscode-plugins.png b/docs/images/vscode-plugins.png
diff --git a/docs/learn/debug.md b/docs/learn/debug.md
@@ -0,0 +1,63 @@
+# Отладка
+
+Для отладки применяется стандартный отладчик OneScript для Visual Studio Code.
+
+## Подготовка
+
+Если у вас уже установлены VS Code, плагин языка 1С и отладчик OneScript, пропустите раздел "Подготовка".
+
+### Установка Visual Studio Code и плагинов
+
+Скачайте среду разработки с [сайта производителя](https://code.visualstudio.com/download) и установите. Затем, запустите и нажмите в ней `Ctrl+Shift+X` чтобы перейти к окну установки расширений.
+
+Вам потребуется установить 2 расширения: поддержку языка 1С и отладчик OneScript. В окне поиска наберите bsl и установите расширения, показанные на картинке.
+
+![](/images/vscode-plugins.png)
+
+### Создание папки с решением
+
+Для начала нам понадобится место, где мы будем писать наш проект. Ознакомьтесь с разделом [Новый проект](/learn/new-project), чтобы его подготовить.
+
+## Конфигурация запуска
+
+Для отладки нам потребуется `конфигурация запуска`. Конфигураций запуска может быть несколько, вы сами создаете варианты запуска с разными параметрами командной строки, с разными переменными окружения и т.п.
+
+Запустите отладку и выберите пункт `Отладка 1Script`. IDE создаст файл `.vscode/launch.json` и откроет его в редакторе. Если что-то не сработает (а такое бывает), создайте в корне вашего проекта каталог `.vscode` (обратите внимание на точку в имени) и в нем файл `launch.json`, откройте его.
+
+![](/images/vscode-launch.png)
+
+В файле launch.json можно задать несколько так называемых "профилей" отладки - наборов комбинаций параметров, под которым будет запускаться отлаживаемое приложение.
+
+Каждый профиль отладки представляет собой настройку запуска отлаживаемого приложения, его аргументы командной строки и версию интерпретатора 1script, которая будет выполнять приложение.
+
+Подробное описание каждого параметра выводится при наведении мышки на опцию в файле launch.json.
+
+```json
+{
+    "name": "Отладка 1Script",
+    "type": "oscript",
+    "request": "launch",
+    "cwd": "${workspaceRoot}/src",
+    "program": "my-program.os",
+    "args": ["arg1", "arg2"],
+    "env": {
+        "OSCRIPT_CONFIG": "lib.system=D:/myOsLibraries",
+        "JAVA_HOME": "D:/MyJava/JDK_29_Full"
+    },
+    "debugPort": 2801
+}
+```
+
+::: warning ВНИМАНИЕ
+Если по какой-либо причине на вашей машине занят порт `2801` - укажите в свойстве `debugPort` любой другой свободный порт.
+:::
+
+## Старт отладки
+
+После того, как конфигурация запуска выбрана в окне VS Code можно нажать кнопку F5 и среда разработки запустит отладку, согласно настроенной конфигурации.
+
+Если взять пример конфига, приведенный выше, то будет запущен для отладки файл `my-program-os`, рабочим каталогом запущенного процесса будет каталог `${workspaceRoot}/src`, где ${workspaceRoot} это корень папки с проектом.
+
+Далее, в запущенный процесс будут переданы 2 аргумента командной строки: "arg1" и "arg2", при этом процесс получит две переменные окружения OSCRIPT_CONFIG и JAVA_HOME.
+
+Создавая таким образом разные варианты запуска, вы можете отлаживать различные сценарии вашей программы.
diff --git a/docs/learn/enterprise.md b/docs/learn/enterprise.md
@@ -0,0 +1,36 @@
+# Документы и полезная информация для организаций и учреждений
+
+## Применимость в корпоративной среде
+
+1Script популярный открытый движок, который используется в корпоративной среде, в т.ч. в крупных компаниях, корпорациях, банках. Авторам известно, что он используется как минимум:
+
+* В операторе сотовой связи из "большой тройки"
+* федеральном банке из ТОП-5
+* федеральной компании со словом "Газ" в названии
+* судостроении
+* и много где еще
+
+На данной странице публикуются материалы, которые вы можете найти материалы, помогающие в работе с корпоративными службами при внедрении 1Script
+
+## Материалы по информационной безопасности
+
+Типовые требования служб ИБ к информационным системам
+
+|Требование|Реализация в 1Script|
+|-|-|
+|Методы оповещения пользователей об уязвимостях решения и рекомендациях по их устранению.|Пользователи уведомляются в канале https://t.me/oscript_library. Информация о критичных уязвимостях показывается на [главной странице сайта](https://oscript.io) |
+|Политика устранения уязвимостей|Обнаруживаемые уязвимости устраняются в приоритетном порядке, как только авторы уязвимых библиотек, фреймворков выпускают исправление. Как правило, это 2-3 дня после появления исправления. Уязвимости в самом движке так же исправляются в приоритетном порядке. Гарантии по срокам исправления доступны только на базе платной поддержки.|
+|Политика обновления используемых библиотек, платформ|Движок основан на последних актуальных релизах .NET Framework и .NET. При выходе LTS-релизов осуществляется переход на них в плановом порядке|
+|Отсутствие недокументированных возможностей (НДВ)|НДВ отсутствуют, исходный код открыт|
+|Отсутствие неотключаемых функций взаимодействия с Интернет|Неотключаемые функции отсутствуют, при блокировании доступа в Интернет работоспособность 1Script сохраняется. Перестанут работать только попытки пользователя явно выйти в интернет средствами программы.|
+|Параметры резервного копирования, перечень компонентов, подлежащих резервному копированию.|Неприменимо, т.к. отсутствует база данных и какое-либо хранимое состояние, требующее резервного копирования.|
+|Релизная политика, сроки выпуска релизов.|Стабильные номерные релизы выпускаются в среднем каждые 3-4 месяца. Версии с долгосрочной поддержкой (LTS) выпускаются каждые 6-8 месяцев, ошибки в них исправляются в течение года с момента выпуска. Релизы выпускаются по мере накопления полезной функциональности или исправления ошибок. Кроме того, на сайте публикуются ночные сборки. В них включены самые свежие изменения. Можно сказать, что публикация исправлений происходит немедленно после внесения исправления в код.|
+|Change Logs и описания изменений.|К каждому релизу прилагается Changelog, кроме того, за счет открытости кода, все изменения видны в логе коммитов git. Увидеть changelog каждой версии можно на странице версии (см. "Предыдущие версии" страницы скачивания релизов)|
+
+## Информационная поддержка
+
+Мы будем признательны, если Ваша компания разрешит нам опубликовать на сайте информацию о том, что Вы применяете 1Script. Нам доверяют многие крупные компании, но мы не вели с ними переговоров об использовании нами брендов на сайте, поэтому не называем имен. Если вы хотите дать нам такое разрешение или знаете, к кому в Вашей компании можно обратиться за таким разрешением, [напишите нам, пожалуйста](https://t.me/oscript_library).
+
+## Платная поддержка
+
+У команды разработчиков на данный момент отсутствует функция платной поддержки, т.к. за таковой никто не обращался, но мы открыты к предложениям. Напишите в Telegram-канал https://t.me/oscript_library или создайте [issue на github](https://github.com/EvilBeaver/OneScript/issues).
diff --git a/docs/learn/infra.md b/docs/learn/infra.md
@@ -0,0 +1,43 @@
+# Устройство и инфраструктура
+
+## Архитектура
+
+1Script написан на языке C# и работает на платформе .NET Актуальная версия платформы - NET6. По мере необходимости, версия платформы поднимается до актуальных.
+
+::: info
+Предыдущие версии 1Script за номером 1.x используют версию .NET Framework 4.8 на Windows и Mono 6.12 на Linux
+:::
+
+1Script поставляется в двух вариантах дистрибутивов:
+
+* SCD (self-contained-deployment) - самостоятельный дистрибутив для конкретной операционной системы
+* FDD (framework-dependent-deployment) - универсальный дистрибутив, не зависящий от ОС, но требующий установки .NET на целевой машине
+
+Для каждого сценария использования могут подходить разные варианты поставки, решать вам.
+
+Если вам нужно "просто 1Скрипт" ставьте SCD для вашей ОС. Если вы, например, собираете docker-образ, в котором уже есть .NET нужной версии, то полный дистрибутив SCD вам не нужен, и вам будет достаточно маленького легковесного FDD.
+
+Также, вам будет достаточно FDD, если у вас на машине уже стоит .NET нужной версии.
+
+### Принцип работы
+
+1Script исполняется посредством стековой машины с собственным байт-кодом. Также существует специальный режим компиляции `native`, который компилирует код 1С в байткод непосредственно машины dotnet. Этот режим является экспериментальным и несовместим по поведению с языком 1С (код должен быть написан в строго-типизированном стиле). Документирование режима native пока в разработке.
+
+Виртуальная машина способна подключать внутрь себя сторонние файлы скриптов, на этом основана модульность исполняющей среды и организованы библиотеки.
+
+## Хаб пакетов
+
+Сообщество поддерживает [облачное хранилище повторно используемых библиотек](https://hub.oscript.io), называемое "Хаб пакетов". В это хранилище разработчики публикуют свои решения, которые так или иначе могут использоваться повторно всеми желающими. Хаб пакетов имеет несколько зеркал в случае выхода из строя основного сайта.
+
+Пакеты распространяются в виде файлов с расширением `.ospx`, которые технически представляют собой zip-архивы специального формата. Упаковка решения в архив `.ospx` выполняется утилитой opm (OneScript Package Manager). В дальнейшем, опубликованный пакет с помощью той же утилиты устанавливается на машины конечных пользователей. Подробнее об этом механизме можно почитать в разделе ["Библиотеки"](/learn/libraries)
+
+## Основной сайт
+
+Сайт, на котором вы сейчас находитесь имеет открытые исходные коды и может так же дорабатываться сообществом (например, Вами).
+Инфраструктура сайта построена вокруг docker-compose.
+
+## Информационная безопасность
+
+Проект имеет открытый исходный код и мы стремимся к тому, чтобы он мог беспрепятственно использоваться в различных организациях и государственных учреждениях. Мы стараемся идти на встречу запросам от корпоративного сектора, если они у вас есть, вы можете их задать [напрямую авторам](https://t.me/oscript_library).
+
+Также мы подготовили [ответы на наиболее часто встречающиеся вопросы](/learn/enterprise) от отделов информ.безопасности, вы можете предоставить эту информацию вашей службе infosec.
diff --git a/docs/learn/libraries.md b/docs/learn/libraries.md
@@ -0,0 +1 @@
+# Библиотеки
