dokuwiki_formatting_guide
Содержание
Шпаргалка по разметке DokuWiki (Мои правила)
Эта страница — моя личная инструкция по форматированию, созданная на основе долгой и мучительной отладки. Цель — никогда больше не тратить часы на исправление «сбившегося» форматирования.
Золотые Правила (Самое важное!)
- Правило №1: Один элемент — одна строка. Каждый заголовок, пункт списка или блок кода должен начинаться с новой строки.
- Правило №2: Два пробела для списка. Чтобы создать пункт списка, нужно поставить два пробела перед звездочкой (`*`).
- Правило №3: Пустая строка — новый абзац. Чтобы начать новый абзац, нужно оставить между ними одну пустую строку.
Основные Элементы Разметки
Заголовки
Чем больше знаков `=`, тем меньше заголовок.
====== Заголовок 1 (Обычно название страницы) ====== ===== Заголовок 2 (Крупный раздел) ===== ==== Заголовок 3 (Подраздел) ====
Форматирование текста
- Жирный: `Жирный текст` → Жирный текст
- Курсив: `Курсив` → Курсив
- Подчеркнутый: `Подчеркнутый` → Подчеркнутый
- Моноширинный: `
Моноширинный (для команд и файлов)` →Моноширинный (для команд и файлов)
Списки
Не забывать про ДВА пробела перед звездочкой!
* Уровень 1
* Уровень 2 (четыре пробела)
* Уровень 1
Ссылки
Чтобы внутренние ссылки ниже заработали, создайте две страницы: [[example_page_1]] и [[example_page_2]]. Код для них — в Шаге 2 этой инструкции.
- Внутренняя ссылка на страницу: `пример_страницы_1`
- Внутренняя ссылка с другим текстом: `Это ссылка с другим текстом`
- Внешняя ссылка: `Поиск в Google`
Блоки кода
Для подсветки синтаксиса нужно указать язык (bash, sql, python и т.д.).
<code bash> # Комментарий в Bash sudo apt update && sudo apt upgrade -y
Другие полезные вещи
- Горизонтальная линия: `—-`
- Принудительный перенос строки: `Текст
новая строка` - Блок-заметка: `Текст важной заметки`
dokuwiki_formatting_guide.txt · Последнее изменение: — hallow
