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

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

Writing /var/www/qsp.su/public_html/wiki/data/meta/access.log failed

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

dev:main

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

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

Сделать

  • Добавить ссылку http://htmlacademy.ru/ в справку.
    • В общую нельзя - в классике HTML неполный.
    • Нужно куда-нибудь в Навигатор.
  • Доработки навигации
    • Ссылки вперед/назад и сверху и снизу
      • Как первую половину строки прижать влево, а вторую - вправо?
    • К Nex'у: выделение текущей страницы в левом меню.
      • Жирностью, выключением ссылки, цветом?
    • К Nex'у: баг - в левом меню выделяется жирным последняя отредактированная страница
    • К Nex'у: нужна более заметная ссылка на вики в разделе сайта "Разработчикам".
  • Сделать выделение символов ~&!%*^|-+=,./?<>;:()[]{} в sxh.
  • Дописать Что такое QSP? и картинки туда.
  • Общие слова к статьям:
  • Переделать Меню
  • Впихнуть куда-нибудь статью "Как писать игры" - в каком порядке удобнее обдумывать и писать, что изначально лучше локации прописать на листочке и т.п.
  • Самоучители
    • regexp
  • Недописанный кусок структуры:
    • Quest Navigator
      • Список файлов игры
      • Файл настроек игры
      • Файл шаблона и файл стилей 1) 2)
        • Шрифты
      • Файл JS 3)
      • Нюансы переноса с предыдущих плееров, отличия.
      • Гайд по кроссплатформенности 4)
    • Утилиты или средства разработки
      • QGen - пока оставлю тут, потом подумаю, нужна ли статья
  • Добавить куда-нибудь все способы экранирования в одном месте:
    '<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>' 
    

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

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

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

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

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

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

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

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

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

  • Разбиение материала по статьям должно быть удобным и логичным.
    • Пока существует несколько актуальных плееров, приходится на это оглядываться.
      • Должно легко сводиться к одному плееру в будущем.
  • Выделение новых ключевых слов, чтобы взгляд мог зацепиться.
    • Реализовано жирным
  • Выделение ключевых моментов
    • В каждой статье индивидуально
    • Но так, чтобы не пестрило
  • Характерные примеры
    • Нужно будет многие переделать
      • Пока на это нет сил, времени и воображения
1) Похоже будет лучше объединить эти две статьи, не могу придумать, как будет хорошо в разделенном виде
2) Список id, классов и кусочков body. Разные варианты для разных целей. Возможно ссылки на самоучители
3) Список колбэков и переменных. Возможно ссылки на самоучители типа http://learn.javascript.ru/ . Возможно примеры кода для разных целей.
4) я не возмусь писать, но статья нужная для тех, кто будет шаблоны править
dev/main.txt · Последние изменения: 2017/11/24 23:18 — newsash