Надуманное. Блог Михаила Баландина — 25 июня 2018

Софт: заметки по MDwiki

25 июня 2018 (07:21:56)

Некоторые заметки про движок mdwiki, главным образом для внутреннего пользования. В дополнение к основному материалу.

При просмотре в мобильных браузерах может прилично тормозить, что и неудивительно: всё крутится на javascript и HTML5, то есть на клиентской стороне.

Налицо некоторые особенности типографики, вызванные парсингом Markdown средствами того же javascript:

  • неразрывный пробел, вставленный своим истинным символом (например, с клавиатуры Apple), ломается и превращается в обычный; его нужно вставлять HTML-аббревиатурой nbsp.
  • ударения, вставленные при помощи символа U+0301 после ударной гласной, ломаются; приходится пользоваться символами с диакритикой из европейских диапазонов кодировки.

Ширина подменю определяется шириной элементов, при этом учитываются только активные элементы — если есть подзаголовки и они длиннее, то могут не очень красиво разбиваться на несколько строк. Посему лучше в подзаголовках использовать неразрывные пробелы как описано выше, это работает. В активных ссылках, собственно, тоже.

Заголовок вики задаётся в конфиге config.json, но этого мало, и по-хорошему надо его указывать непосредственной правкой главного файла движка — там оно в самом начале, сразу видно.

Сноски не поддерживаются, но ремарки к тексту страниц можно оформлять цветными боксами. Например, абзац, начинающийся с «NB:», будет подсвечен. Можно добавить свои собственные слова для генерации боксов, в файле движка это ищется элементарно, однако требуется некоторая осторожность: если задать распространённое слово, начнёт подсвечиваться всё подряд. Чтобы избежать, можно комбинировать в ключевых словах кириллицу и латиницу — например, в слове «Описание» буквы «О», «са», «е» задать латиницей, а буквы «пи», «ни» кириллицей. Такое ключевое слово можно набрать, только специально постаравшись.