Различия

Здесь показаны различия между двумя версиями данной страницы.

--- dev:main [2013/11/10 19:27]
newsash [Сделать]
+++ dev:main [2024/09/15 13:00] (текущий)
aleks_versus [Статьи вне меню]
@@ Строка 1: / Строка 1: @@
-=====Служебная страница=====
+====== Служебная страница ======
-  * [[:todo|План]]
-    * [[help:todo|]]
-  * [[:requests_from_newsash_to_nex|Просьбы от newsash к Nex'у]]
-  * [[:razbor_izmenenij_dvizhka|Разбор изменений движка]]
-====Сделать====
+	*  [[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)]]
+я не возмусь писать, но статья нужная для тех, кто будет шаблоны править
-  * Доработки навигации
-    * Ссылки вперед/назад и сверху и снизу
-      * Как первую половину строки прижать влево, а вторую - вправо?
-    * **К Nex'у**: выделение текущей страницы в левом меню.
-      * Жирностью, выключением ссылки, цветом?
-    * **К Nex'у**: баг - в левом меню выделяется жирным последняя отредактированная страница
-  * Сделать выделение символов **~&!%*^|-+=,./?<>;:()[]{}** в sxh.
-  * Дописать [[help:qsp]] и картинки туда.
-  * Общие слова к статьям:
-    * [[help:conditional]]
-    * [[help:organizing]]
-    * //[[help:jump]]//??
-    * [[help:dynamical]]
-    * //[[help:msgbox]]//??
-    * //[[help:sound]]//??
-    * //[[help:graphics]]//??
-    * //[[help:fonts]]//??
-    * [[help:modules]]
-    * [[help:realtime]]
-  * Переделать [[help:menu]]
-  * Переделать [[help:principle]]
-  * Переделать [[help:regexp]]
-    * Сделать самоучитель
-====Подумать/обсудить====
-  * [[help:graphics]] - REFINT и VIEW. Выглядит неочень
-  * [[help:html]] - выглядит неочень
-    * Можно отложить до релиза Навигатора.

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

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

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

Различия

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

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