Merge pull request #2 from Bayselonarrend/main

Readme файл и картинки

Author: ahyahy

README.md

@@ -1,18 +1,53 @@
-# OneScriptDeclarativeForms
-Декларативные формы для сценарного языка OneScript.
+![cover](https://github.com/user-attachments/assets/440c47da-16d8-4419-ae59-198b7898dfe5)
 
-Данная библиотека позволяет создать оконное приложение с браузером внутри. Браузер внутри окна - это значит нам будут доступны технологии html, javascript и css. Движок браузера - Chromium. Соответственно у нас будет кроссплатформенность. В основе десктопного приложения лежат три разработки. Это [OneScript](https://oscript.io/), [NW.JS](https://nwjs.io/) и [OneScriptClientServer](https://github.com/ahyahy/OneScriptClientServer).
+# OneScript Declarative Forms
 
-OneScript дает возможность писать сценарии на языке 1С.
+**Декларативные формы для сценарного языка OneScript**
 
-NW.JS обеспечивает кроссплатформенность. Его изучать не нужно, механизм его работы и взаимодействия со сценарием скрыт внутри библиотеки декларативных форм.
+Данная библиотека позволяет создавать приложения с графическим интерфейсом (GUI), используя OneScript в качестве языка разработки. Она обеспечивает выполнение обработчиков событий и связь OS-сценария с окном программы на основе библиотеки [OneScriptClientServer ](https://github.com/ahyahy/OneScriptClientServer)
 
-OneScriptClientServer - это библиотека для OneScript. Работает фоновым заданием и обеспечивает связь сценария с окном программы.
 
-### Подробнее можно узнать на этом сайте
+## Особенности
 
-> <https://ahyahy.github.io/OneScriptDeclarativeForms/index.html>
+<img src="https://github.com/user-attachments/assets/04035547-93cb-42d0-977b-28d220f17d61" align="right" width="128">
 
-**ВАЖНО:** В разделе "Документация" кликните самый верхний пункт "Декларативные формы". Это нужно прочитать в первую очередь.
++ Для отрисовки интерфейса и элементов управления используется [nw.js](https://github.com/nwjs/nw.js) - кросплатформенный JavaScript-фреймворк, позволяющий создавать десктопные приложения на основе web-технологий. Благодаря ему готовое приложение может быть запущено на любой из основных операционных систем без внесения изменений в код
 
-Библиотека только начата, впереди ещё много работы. Сейчас есть работающий движок, обработка событий, получение аргументов событий, несколько классов для примера.
+  >Изучать nw.js для использования библиотеки не нужно: механизм работы и взаимодействия со сценарием скрыт внутри библиотеки декларативных форм.
+
+<img src="https://github.com/user-attachments/assets/26dc67d8-170b-45a2-813f-01bb75354b39" align="right" width="128">
+
+<br>
+
++ Логика приложения описывается на языкe 1С при помощи [OneScript](https://github.com/EvilBeaver/OneScript) - независимой кросс-платформенной реализации виртуальной машины, исполняющей скрипты на языке 1С:Предприятие. Интерфейс программы создается в декларативной парадигме, что позволяет работать в привычных терминах языка, не прибегая к прямой работе с HTML и JS
+
+ <br>
+
+ **Пример создания элемента интерфейса**
+ ```bsl
+
+	Кнопка1 = ДФ.Кнопка();
+	Кнопка1.Родитель = Форма1;
+	Кнопка1.Текст    = "Кнопка";
+	Кнопка1.Нажатие  = ДФ.Действие(ЭтотОбъект, "Кнопка1_Нажатие");
+ ```
+
+<br> 
+
+## Установка
+
+Для начала работы необходимо:
+1. Устанавить OneScript ([оф. сайт](https://oscript.io/))
+2. Скачать и распаковать nw.js (версия >= v0.45.6, [оф. сайт](https://nwjs.io/))
+3. Прочитать указанный ниже раздел документации и согласно этой информации организовать каталог будущей программы
+
+## Документация
+
+Документацию библиотеки можно найти [по этой ссылке](https://ahyahy.github.io/OneScriptDeclarativeForms/index.html)
+
+>**ВАЖНО:** В разделе "Документация" кликните самый верхний пункт "Декларативные формы". Это нужно прочитать в первую очередь.
+
+
+## Roadmap
+
+Библиотека только начата, впереди ещё много работы. Сейчас есть работающий движок, обработка событий, получение аргументов событий, несколько классов для примера