LSS Техническая документация

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Особенности использования библиотеки Dojo Toolkit в  LSS визуализаторе ======
[[start:|lss]]
===== Введение =====
Наша реализация **LSS визуализатора** опирается на открытую свободную библиотеку [[https://dojotoolkit.org/|Dojo Toolkit ]] версии 1.10, лицензия BSD. В исходном виде эта библиотека велика, состоит из огромного количества отдельных файлов, что сильно затрудняет ее использование. 

Однако, в состав библиотеки **Dojo Toolkit** входит специальный инструментарий, позволяющий вычленить и упаковать требуемое для работы подмножество функционала библиотеки.

В комплект поставки нашего **LSS визуализатора** входит именно такой, сжатый кусок библиотеки **Dojo Toolkit**. В этой инструкции мы опишем, как его можно получить из исходников.
===== Инструкция по сборке =====
  * Установить **Java** последней актуальной версии, например **OpenJDK 18**.
  * Скачать и распаковать исходники библиотеки **Dojo Toolkit версии 1.10**.
  * В папке **/dojotoolkit/util/buildscripts/profiles** создать файл профиля **lss.profile.js** с описанием требуемого подмножества библиотеки:
<code>
dependencies = {
	stripConsole: "normal",
	layers: [
		{
			name: 'lss-dojo.js',
			action: 'clean, release',
			dependencies: [
				'dojo.dom-geometry',
				'dojo.aspect',
				'dojo._base.fx',
				'dojo._base.lang',
				'dojo.dom-class',
				'dojo.sniff',
				'dojo.topic',
				'dojo.when',
				'dojo.cookie',
				'dijit.registry',
				'dojo.on',
				'dojo._base.kernel',
				'dojo.string',
				'dojo.selector.acme',
				'dojo.selector.lite',
				'dojox.xml.parser',
				'dojox.grid.DataGrid',
				'dojox.grid.cells',
				'dojox.grid.cells.dijit',
				'dijit.Tree',
				'dijit._Widget',
				'dijit._TemplatedMixin',
				'dijit.layout.BorderContainer',
				'dijit.layout.ContentPane',
				'dijit.layout.StackContainer',
				'dijit.layout.TabContainer',
				'dijit.layout.AccordionContainer',
				'dijit.TitlePane',
				'dijit.form.TextBox',
				'dijit.form.DateTextBox',
				'dijit.form.CheckBox',
				'dijit.form.RadioButton',
				'dijit.form.SimpleTextarea',
				'dijit.form.ComboBox',
				'dijit.Toolbar',
				'dijit.ToolbarSeparator',
				'dijit.form.Button',
				'dijit.form.DropDownButton',
				'dijit.Menu',
				'dijit.MenuItem',
				'dijit.PopupMenuItem',
				'dijit.MenuSeparator',
				'dijit.MenuBar',
				'dijit.MenuBarItem',
				'dijit.PopupMenuBarItem'
			]
		}
	],
	prefixes: [
		[ "dijit", "../dijit" ],
		[ "dojox", "../dojox" ]
	]
};
</code>
  * из папки **/dojotoolkit/util/buildscripts** выполнить файл **build.bat** с параметрами **profile=lss action=clean,release**
<code>
build.bat profile=lss action=clean,release
</code>
  * В результате работы скрипта формируется папка **/dojotoolkit/release**. Для работы **LSS визуализатора** (см. папку визуализатора **lss-viewer/dojocompressed**) понадобятся  следующие файлы и папки:
    * в папке **/dojotoolkit/release/dojo/dojo** файлы dojo.js, dojo.js.uncompressed.js, lss-dojo.js, lss-dojo.js.uncompressed.js
    * в папке **/dojotoolkit/release/dojo/dojo** подпапки nls, resources, selector
Итак, мы описали, как из исходников открытой свободной библиотеки **Dojo Toolkit** нами была получена урезанная компактная версия библиотеки, входящая в комплект **LSS визуализатора** в виде папки **dojocompressed**.
===== Материалы для скачивания =====
Для скачивания материалов необходимо наличие пароля ftp сервера ЦТИ.
  * **адрес**: [[ftp://79.170.154.8]]
  * **login**: ftpuserlss
  * **password**: пароль для доступа к ftp серверу ЦТИ (пароль указан в инструкции по установке ПО LSS)
На ftp сервере размещены следующие файлы:
  * **dojotoolkit.zip** - используемая в визуализаторе платформы LSS библиотека Dojo Toolkit версии 1.10