DokuWiki додає підтримку Markdown у новому релізі

DokuWiki — це популярне програмне забезпечення з відкритим кодом для створення вікі, яке використовують для документації, баз знань та внутрішніх нотаток проектів. Наразі розробники готують новий реліз, що надасть нативну підтримку Markdown, що дозволить користувачам вибирати між власним синтаксисом DokuWiki та Markdown для написання й редагування сторінок.

Легкість та популярність DokuWiki

DokuWiki є легким вікі-платформою. На відміну від систем, які працюють на базі баз даних, DokuWiki зберігає сторінки у вигляді простих текстових файлів. Це робить його популярним серед користувачів, яким подобаються прості інструменти, що підтримують легкі резервні копії та контроль версій. Але, здається, попереду є комфортні зміни.

MD-підтримка змінює гру для DokuWiki

Творець DokuWiki Андреас Гоор оголосив, що в новому релізі буде підтримуватися прямий парсинг та рендеринг Markdown. Ця новина важлива з простого причин: традиційно DokuWiki використовував свій власний синтаксис. Натомість Markdown став стандартним форматом для різноманітних платформ для розробників, інструментів документації, форумів та трекерів помилок.

Історія розвитку DokuWiki та Markdown

Чому раніше ця можливість не була доступна? DokuWiki та Markdown з’явилися приблизно в один і той же час, у 2004 році. DokuWiki розробив свій синтаксис незалежно, до глобального визнання Markdown, що досяг таких платформ, як Reddit, Stack Overflow та GitHub.

Проблеми впровадження Markdown в DokuWiki

Раніші спроби додати Markdown у DokuWiki залежали від плагінів, таких як плагін Markdowku. Він комбінував DokuWiki та Markdown-синтаксис, використовуючи існуючий парсер. Однак Гоор заявив, що повну підтримку Markdown неможливо було реалізувати ефективно через плагін, і її необхідно інтегрувати в ядро DokuWiki.

Основні цілі впровадження Markdown

Впровадження має три основні цілі: підтримувати якомога більше синтаксису Markdown з парсером DokuWiki, дозволити користувачам обирати між синтаксисом DokuWiki, Markdown або змішаним режимом, а також перевіряти поведінку на основі існуючих тестів Markdown.

Обмеження початкової реалізації

Однак спочатку функція не надасть повну сумісність з Markdown. Гоор зазначає, що деякі поведінки Markdown важко або неможливо підтримати через однопроходний парсер DokuWiki. Наприклад, правила для кодових блоків спрощені, впровадження зосередиться на загальному форматі з трьох зворотних лапок.

Конфігурація для підтримки Markdown

Наразі новий параметр $conf['syntax'] за замовчуванням встановлений на dw, тому синтаксис DokuWiki залишається стандартним. Користувачі, які хочуть підтримку Markdown, повинні самостійно активувати її у менеджері конфігурацій. У майбутньому установник може за замовчуванням використовувати змішаний md+dw режим або дозволити користувачам обирати улюблений синтаксис під час налаштування.

Детальніше про цю новину можна дізнатися на сайті DokuWiki та в офіційній новині.