Различия

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

--- dev:main [2017/11/24 20:18]
newsash
+++ dev:main [2024/09/15 13:00] (текущий)
aleks_versus [Статьи вне меню]
@@ Строка 1: / Строка 1: @@
-=====Служебная страница=====
+====== Служебная страница ======
-  * [[dev:stats]]
-  * Navigator: свёрстанный шаблон экрана называется "сценой". Изменение оформление удобнее всего сделать переключением сцен.
-====Сделать====
+	*  [[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>'
-  * Добавить ссылку [[https://htmlacademy.ru/]] в справку.
+	!Ещё способ, который может пригодиться с глубокими уровнями вложенности:
-    * В общую нельзя - в классике HTML неполный.
+	! КСТАТИ: надо исправить. Хреново подхватывается форматирование:
-    * Нужно куда-нибудь в Навигатор.
+	'<a href="exec:GOTO '+"'верстак'"+'">версак</a>'
-  * Доработки навигации
-    * Ссылки вперед/назад и сверху и снизу
-      * Как первую половину строки прижать влево, а вторую - вправо?
-    * **К Nex'у**: выделение текущей страницы в левом меню.
-      * Жирностью, выключением ссылки, цветом?
-    * **К Nex'у**: баг - в левом меню выделяется жирным последняя отредактированная страница
-    * **К Nex'у**: нужна более заметная ссылка на вики в разделе сайта "Разработчикам".
-  * Сделать выделение символов **~&!%*^|-+=,./?<>;:()[]{}** в sxh.
-  * Дописать [[help:qsp]] и картинки туда.
-  * Общие слова к статьям:
-    * [[help:conditional]]
-    * [[help:organizing]]
-    * //[[help:jump]]//??
-    * [[help:dynamical]]
-    * //[[help:msgbox]]//??
-    * //[[help:sound]]//??
-    * //[[help:fonts]]//??
-    * [[help:modules]]
-    * [[help:realtime]]
-  * Переделать [[help:menu]]
-  * Переделать [[help:principle]]
-  * Переделать [[help:regexp]]
-  * Впихнуть куда-нибудь статью "Как писать игры" - в каком порядке удобнее обдумывать и писать, что изначально лучше локации прописать на листочке и т.п.
-  * Самоучители
-    * regexp
-  * Недописанный кусок структуры:
-    * //Quest Navigator//
-      * //Список файлов игры//
-      * //Файл настроек игры//
-      * //Файл шаблона и файл стилей// ((Похоже будет лучше объединить эти две статьи, не могу придумать, как будет  хорошо в разделенном виде)) ((Список id, классов и кусочков body. Разные варианты для разных целей. Возможно ссылки на самоучители))
-        * //Шрифты//
-      * //Файл JS// ((Список колбэков и переменных. Возможно ссылки на самоучители типа https://learn.javascript.ru/ . Возможно примеры кода для разных целей.))
-      * //Нюансы переноса с предыдущих плееров, отличия.//
-      * //Гайд по кроссплатформенности// ((я не возмусь писать, но статья нужная для тех, кто будет шаблоны править))
-    * //Утилиты или средства разработки//
-      * //[[help:txt2gam|TXT2GAM]]//
-      * //[[help:qgen|QGen]] - пока оставлю тут, потом подумаю, нужна ли статья//
-  * Добавить куда-нибудь все способы экранирования в одном месте:<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]]
+	*  Здесь должно быть продолжение
+===== Общие принципы для статей =====
-====Подумать/обсудить====
+==== Как можно читать справку ====
-  * [[help:regexp]] - выглядит не очень
-    * Нужен самоучитель
-  * [[help:html]] - выглядит не очень
-    * Можно отложить до релиза Навигатора.
-  * Самоучители - отдельный неймспейс, отдельные неймспейсы или howto?
-  * Как хранить файлы с примерами кода, там же или перезалить в wiki (все яйца в одну корзину)?
-  * Возможно статью "Известные баги"
-  * Возможно перенести подвыражения:
-    * Разбить строковые константы и строковые функции на две статьи
-    * Строки сразу после переменных
-    * Подвыражения в выражениях
-  * Возможно отдельные статьи по концепциям "блоков кода" и "переменных с двумя значениями"
-  * Возможно вынести базовые функции из [[help:coding|программного кода]]
-  * В какой момент обрабатываются подвыражения?
-  * Распределить локации-обработчики по соответствующим статьям (ONNEWLOC - в локации и т.д.)?
-  * На странице циклов сделать примеры циклов do-while и while-do.
-====Статьи вне меню====
+	*  **Последовательно** читать ВСЕ статьи подряд, пропуская неинтересные.
-  * [[help:dummy]]
+		*  Ссылки сверху и снизу статей
-  * [[help:qsp_license]]
+		*  Возможно стоит реализовать другой вариант, но нет идей.
-    * [[help:gnu_gpl_eng]]
+		*  Последовательное изложение информации
-    * [[help:gnu_gpl_rus]]
+			*  Т.е. минимальное количество отсылок "вперёд"
-  * [[help:qgen]]
+			*  Если не ошибаюсь, то у меня это нарушается только с регэкспами, но так лучше.
-  * [[help:txt2gam]]
+			*  Возможно стоит перенести вывод на экран, предметы и действия до программирования в структуре
-  * [[dev:razbor_izmenenij_dvizhka]]
+	*  **Искать необходимое**
-  * [[:sidebar]]
+		*  Оглавление
+			*  Удобная структура
+			*  Ссылки на оглавление
+				*  В каждой статье
+				*  Или в меню слева
+			*  Говорящие названия статей
+		*  Список ключевых слов со ссылками на статьи.
+		*  Перекрёстные ссылки между статьями
+		*  Словарь терминов
-====Список плагинов====
+==== Удобочитаемость ====
-  * [[doku>plugin:statdisplay|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
Сайт Форум