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

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


dokuwiki_formatting_guide

Шпаргалка по разметке DokuWiki (Мои правила)

Эта страница — моя личная инструкция по форматированию, созданная на основе долгой и мучительной отладки. Цель — никогда больше не тратить часы на исправление «сбившегося» форматирования.

Золотые Правила (Самое важное!)

  • Правило №1: Один элемент — одна строка. Каждый заголовок, пункт списка или блок кода должен начинаться с новой строки.
  • Правило №2: Два пробела для списка. Чтобы создать пункт списка, нужно поставить два пробела перед звездочкой (`*`).
  • Правило №3: Пустая строка — новый абзац. Чтобы начать новый абзац, нужно оставить между ними одну пустую строку.

Основные Элементы Разметки

Заголовки

Чем больше знаков `=`, тем меньше заголовок.

====== Заголовок 1 (Обычно название страницы) ======
===== Заголовок 2 (Крупный раздел) =====
==== Заголовок 3 (Подраздел) ====

Форматирование текста

  • Жирный: `Жирный текст` → Жирный текст
  • Курсив: `Курсив` → Курсив
  • Подчеркнутый: `Подчеркнутый` → Подчеркнутый
  • Моноширинный: `Моноширинный (для команд и файлов)` → Моноширинный (для команд и файлов)

Списки

Не забывать про ДВА пробела перед звездочкой!

  * Уровень 1
    * Уровень 2 (четыре пробела)
  * Уровень 1

Ссылки

Чтобы внутренние ссылки ниже заработали, создайте две страницы: [[example_page_1]] и [[example_page_2]]. Код для них — в Шаге 2 этой инструкции.

Блоки кода

Для подсветки синтаксиса нужно указать язык (bash, sql, python и т.д.).

<code bash>
# Комментарий в Bash
sudo apt update && sudo apt upgrade -y

Другие полезные вещи

  • Горизонтальная линия: `—-`
  • Принудительный перенос строки: `Текст
    новая строка`
  • Блок-заметка: `Текст важной заметки`
dokuwiki_formatting_guide.txt · Последнее изменение: hallow