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

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


Боковая панель

dev:main

Служебная страница

  • Navigator: свёрстанный шаблон экрана называется "сценой". Изменение оформление удобнее всего сделать переключением сцен.

Сделано

Данный раздел реструктурирован и переписан.

К удалению, или как архивная статья

  • Недописанный кусок структуры:
    • Quest Navigator

Думаю Quest Navigator задвинуть в дальний угол, пока Некс не вернётся к разработке, или пока кто-то другой не возьмётся и не избавит Навигатор от текущих недостатков. В принципе, теперь есть qSpider, поэтому предлагаю сконцентрироваться на его описании. Ниже разделы навигатора.

  • Список файлов игры
  • Файл настроек игры
  • Файл шаблона и файл стилей 1) 2)
    • Шрифты
  • Файл JS 3)
  • Нюансы переноса с предыдущих плееров, отличия.
  • Гайд по кроссплатформенности 4)

Сделать

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

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

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

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

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

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

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

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

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

  • Здесь должно быть продолжение

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

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

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

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

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

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

dev/main.txt · Последние изменения: 2024/09/15 13:00 — aleks_versus