Документация QSP
Сайт Форум

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Служебная страница ======


	*  [[dev:stats|Статистика]]
	*  Navigator: свёрстанный шаблон экрана называется "сценой". Изменение оформление удобнее всего сделать переключением сцен.
===== Сделано =====
	*  Добавить ссылку [[https://htmlacademy.ru/|https://htmlacademy.ru/]] в справку.
		*  В общую нельзя - в классике HTML неполный.
		*  Нужно куда-нибудь в Навигатор. **Добавлено в qSpider**
	*  Дописать [[help:qsp|Что такое QSP?]] и картинки туда.
		* X Дописано. Без картинок пока.
	*  Общие слова к статьям:
		*  [[help:conditional|Условия]]
		*  [[help:organizing|Пользовательские функции и процедуры]]
		*  [[help:jump|Переходы внутри локации, циклы]]??
		*  [[help:dynamical|Динамический код]]
		*  [[help:msgbox|Диалоговое окно]]??
		*  [[help:sound|Звук]]??
		*  [[help:interface|Настройки интерфейса]]??
		*  [[help:modules|Работа с файлами, использование модулей]]
		*  [[help:realtime|Реальное время]]
	*  Переделать [[help:menu|Меню]]
	*  Переделать [[help:principle|Порядок работы интерпретатора]]
	*  Переделать [[help:regexp|Регулярные выражения]]
	*  Утилиты или средства разработки
		*  [[help:txt2gam|TXT2GAM]]
		*  [[help:qgen|QGen]] - пока оставлю тут, потом подумаю, нужна ли статья
		*  [[help:qgen|qgen]]
		*  [[help:txt2gam|txt2gam]]
	*  Добавить куда-нибудь все способы экранирования в одном месте:	<sxh qsp>
	'<a href="exec:GOTO ''верстак''">версак</a>' 
	"<a href=""exec:GOTO 'верстак'"">версак</a>" 
	{<a href="exec:GOTO 'верстак'">версак</a>} 
	'<a href="exec:GOTO \"верстак\"">версак</a>' 
	'<a href="exec:GOTO &quot;верстак&quot;">версак</a>'

	!Ещё способ, который может пригодиться с глубокими уровнями вложенности:
	! КСТАТИ: надо исправить. Хреново подхватывается форматирование:
	'<a href="exec:GOTO '+"'верстак'"+'">версак</a>' 
</sxh>
	*  Возможно перенести подвыражения:
		*  Разбить строковые константы и строковые функции на две статьи
		*  Строки сразу после переменных
		*  Подвыражения в выражениях
	Данный раздел реструктурирован и переписан. 


===== К удалению, или как архивная статья =====
	*  Недописанный кусок структуры:
		*  Quest Navigator
		Думаю Quest Navigator задвинуть в дальний угол, пока Некс не вернётся к разработке, или пока кто-то другой не возьмётся и не избавит Навигатор от текущих недостатков. В принципе, теперь есть qSpider, поэтому предлагаю сконцентрироваться на его описании. Ниже разделы навигатора.
			*  Список файлов игры
			*  Файл настроек игры
			*  Файл шаблона и файл стилей [[#fn__1|1)]] [[#fn__2|2)]]
				*  Шрифты
			*  Файл JS [[#fn__3|3)]]
			*  Нюансы переноса с предыдущих плееров, отличия.
			*  Гайд по кроссплатформенности [[#fn__4|4)]]

===== Сделать =====

	*  Жизненно необходим раздел справочного описания всех ключевых слов, системных переменных и синтаксем, как это сделано сейчас в справочнике "Как сделать?" с примерами, с большим количеством примеров. Фактически нужна, как мне кажется, по каждому ключевому слову статья, либо - операторы, функции, системные переменные, операции и т.д.
    * В связи с этим предлагаю в **ключевые слова.указатель** вставить все ключевые слова именно в виде таблички. Из этой таблички давать ссылки на разделы отдельно: основной справки, отдельно: справочника ключевых слов. Таким образом в wiki будет реализована и серия статей к обучению-ознакомлению и серия статей по операторам. В первую очередь нужно вносить изменения об операторах именно в раздел справочника ключевых слов, и уже потом в разделы основной справки, если это необходимо. Таким образом можно будет разгрузить основную справку от различных тонкостей и нюансов в работе операторов, функций и т.д., а нагрузить все эти тонкости на отдельные фрагменты справки, описывающие конкретные операторы функции и т.д. Ссылки из основной справки опять же можно бужет делаь имеено в раздел справочника-указателя.
	*  Статья по навешиванию событий на различные объекты в qSpider, чтобы можно было управлять содержимым и делать "подвижный" интерфейс в qSpider. Короче, надо больше информации по qSpider.

	*  Доработки навигации
		*  Ссылки вперед/назад и сверху и снизу
			*  Как первую половину строки прижать влево, а вторую - вправо?
		*  К **Nex**у: выделение текущей страницы в левом меню.
			*  Жирностью, выключением ссылки, цветом?
		*  К **Nex**у: баг - в левом меню выделяется жирным последняя отредактированная страница
		*  К **Nex**у: нужна более заметная ссылка на вики в разделе сайта "Разработчикам".
	*  Сделать выделение символов ''%%~&!%*^|-+=,./?<>;:()[]{}%%'' в sxh.	
	*  Впихнуть куда-нибудь статью "Как писать игры" - в каком порядке удобнее обдумывать и писать, что изначально лучше локации прописать на листочке и т.п.
	*  Самоучители
		*  regexp
	*  [[help:regexp|Регулярные выражения]] - выглядит не очень
		*  Нужен самоучитель
		

===== Подумать/обсудить =====

	*  [[help:html|HTML]] - выглядит не очень
		*  Можно отложить до релиза Навигатора.
	*  Самоучители - отдельный неймспейс, отдельные неймспейсы или howto?
	*  Как хранить файлы с примерами кода, там же или перезалить в wiki (все яйца в одну корзину)?
	*  Возможно статью "Известные баги"
	*  Возможно отдельные статьи по концепциям "блоков кода" <и "переменных с двумя значениями"> переменные с двумя значениями больше не актуальны. Отдельная статья по блокам кода актуальна.
	*  Возможно вынести базовые функции из [[help:coding|программного кода]]
	*  В какой момент обрабатываются подвыражения?
	*  На странице циклов сделать примеры циклов do-while и while-do.

===== Статьи вне меню =====

Добавить в меню обязательно обновлённые лицензии

	*  %%**[[#qsp_license|О лицензиях]]** <<<---------------------------------------%%

После раздела утилиты и средства разработки вставить раздел модули

	*  %%**Модули** <<<-------%% здесь будет раздел, посвящённый отдельным модулям с краткой информацией и примерами по их использованию
	*  %%[]   <<<-------%% этот раздел не должен быть доступен через ссылки вперёд-назад, так как логически он не относится к обуч
	*  %%[]   <<<-------%% ающей информации. Это лишь дополнительная информация.

	*  [[help:qsp_license|Лицензионное соглашение Quest Soft Player]]
		*  [[help:gnu_gpl_eng|GNU GPL]]
		*  [[help:gnu_gpl_rus|GNU GPL на русском]]
	*  [[dev:razbor_izmenenij_dvizhka|Разбор изменений движка]]
	*  %%[[sidebar.html|sidebar]] <--- это боковое меню.%%

===== Список плагинов =====

	*  [[https://www.dokuwiki.org/plugin%3Astatdisplay|statdisplay]]
	*  Здесь должно быть продолжение

===== Общие принципы для статей =====

==== Как можно читать справку ====

	*  **Последовательно** читать ВСЕ статьи подряд, пропуская неинтересные.
		*  Ссылки сверху и снизу статей
		*  Возможно стоит реализовать другой вариант, но нет идей.
		*  Последовательное изложение информации
			*  Т.е. минимальное количество отсылок "вперёд"
			*  Если не ошибаюсь, то у меня это нарушается только с регэкспами, но так лучше.
			*  Возможно стоит перенести вывод на экран, предметы и действия до программирования в структуре
	*  **Искать необходимое**
		*  Оглавление
			*  Удобная структура
			*  Ссылки на оглавление
				*  В каждой статье
				*  Или в меню слева
			*  Говорящие названия статей
		*  Список ключевых слов со ссылками на статьи.
		*  Перекрёстные ссылки между статьями
		*  Словарь терминов

==== Удобочитаемость ====

	*  Разбиение материала по статьям должно быть удобным и логичным.
		*  Пока существует несколько актуальных плееров, приходится на это оглядываться.
			*  Должно легко сводиться к одному плееру в будущем.
	*  **Выделение** новых ключевых слов, чтобы взгляд мог зацепиться.
		*  Реализовано **жирным**
	*  Выделение ключевых моментов
		*  В каждой статье индивидуально
		*  Но так, чтобы не пестрило
	*  Характерные примеры
		*  Нужно будет многие переделать
			*  Пока на это нет сил, времени и воображения

[[#fnt__1|1)]] 
Похоже будет лучше объединить эти две статьи, не могу придумать, как будет  хорошо в разделенном виде
[[#fnt__2|2)]] 
Список id, классов и кусочков body. Разные варианты для разных целей. Возможно ссылки на самоучители
[[#fnt__3|3)]] 
Список колбэков и переменных. Возможно ссылки на самоучители типа [[https://learn.javascript.ru/|https://learn.javascript.ru/]] . Возможно примеры кода для разных целей.
[[#fnt__4|4)]] 
я не возмусь писать, но статья нужная для тех, кто будет шаблоны править
Документация QSPСайтФорум

Инструменты пользователя

Инструменты сайта

Инструменты страницы

Документация QSP
Сайт Форум
