Некоторые заметки про движок mdwiki
, главным образом для внутреннего пользования. В дополнение к основному материалу.
При просмотре в мобильных браузерах может прилично тормозить, что и неудивительно: всё крутится на javascript и HTML5, то есть на клиентской стороне.
Налицо некоторые особенности типографики, вызванные парсингом Markdown средствами того же javascript:
- неразрывный пробел, вставленный своим истинным символом (например, с клавиатуры Apple), ломается и превращается в обычный; его нужно вставлять HTML-аббревиатурой
nbsp
. - ударения, вставленные при помощи символа
U+0301
после ударной гласной, ломаются; приходится пользоваться символами с диакритикой из европейских диапазонов кодировки.
Ширина подменю определяется шириной элементов, при этом учитываются только активные элементы — если есть подзаголовки и они длиннее, то могут не очень красиво разбиваться на несколько строк. Посему лучше в подзаголовках использовать неразрывные пробелы как описано выше, это работает. В активных ссылках, собственно, тоже.
Заголовок вики задаётся в конфиге config.json
, но этого мало, и по-хорошему надо его указывать непосредственной правкой главного файла движка — там оно в самом начале, сразу видно.
Сноски не поддерживаются, но ремарки к тексту страниц можно оформлять цветными боксами. Например, абзац, начинающийся с «NB:
», будет подсвечен. Можно добавить свои собственные слова для генерации боксов, в файле движка это ищется элементарно, однако требуется некоторая осторожность: если задать распространённое слово, начнёт подсвечиваться всё подряд. Чтобы избежать, можно комбинировать в ключевых словах кириллицу и латиницу — например, в слове «Описание» буквы «О», «са», «е» задать латиницей, а буквы «пи», «ни» кириллицей. Такое ключевое слово можно набрать, только специально постаравшись.