Користувальницькькі налаштування

Налаштування сайту


wiki:syntax

Синтаксис форматування

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

Основні конструкції форматування

«ДокуВікі» підтримує виділення тексту жирним шрифтом, курсивом, підкресленням та вивід тексту моноширинним шрифтом. Всі ці конструкції можна об'єднати.

«ДокуВікі» підтримує виділення тексту
**жирним шрифтом**, //курсивом//,
__підкресленням__ та вивід тексту
''моноширинним шрифтом''. Всі ці
конструкції можна **__//''об'єднати''//__**.

Також можна використовувати підрядковий та надрядковий індекси.

Також можна використовувати <sub>підрядковий</sub> та <sup>надрядковий</sup>
індекси.

Ще можна закреслити текст.

Ще можна <del>закреслити текст</del>.

Абзаци відбиваються порожнім рядком. Якщо потрібно примусово вставити перенос рядка, не створюючи абзац, вставте два зворотних слеша і за ним пробіл або перехід до нового рядка.

Просто текст з розривом рядків
Зверніть увагу, що два зворотних слеша діють тільки в кінці рядка
або якщо за ними стоїть
пробіл. Якщо його не поставити, \\вийде ось так.

Просто текст з розривом рядків\\ Зверніть увагу,
що два зворотних слеша діють тільки в кінці рядка\\
або якщо за ними стоїть\\ пробіл. Якщо його не поставити, \\вийде ось так.

Примусові переноси слід використовувати тільки в разі крайньої необхідності.

Посилання

Посилання в «ДокуВікі» бувають різні і створювати їх можна теж по-різному.

Зовнішні

Зовнішні посилання розпізнаються автоматично: http://www.google.com або просто www.google.com — також можна вказувати текст посилання: Це посилання на Google. Адреси електронної пошти теж розпізнаються: andi@splitbrain.org.

Зовнішні посилання розпізнаються автоматично: http://www.google.com або
просто www.google.com --- також можна вказувати текст посилання:
[[http://www.google.com|Це посилання на Google]]. Адреси електронної пошти
теж розпізнаються: <andi@splitbrain.org>.

Внутрішні

Внутрішні посилання створюються за допомогою квадратних дужок. Можна або просто вказати ім'я сторінки, або додатково прописати текст посилання. Імена вікі-статей автоматично переводяться в нижній регістр, спецсимволи використовувати не можна.

Внутрішні посилання створюються за допомогою квадратних дужок.
Можна або просто вказати [[pagename|ім'я сторінки]], або
додатково прописати [[pagename|текст посилання]]. Імена
вікі-статей автоматично переводяться в нижній регістр,
спецсимволи використовувати не можна.

Можна використовувати в посиланні простір імен через двокрапку.

Можна використовувати в посиланні [[namespaces|простір імен]]
через двокрапку.

Ставити посилання на певний розділ теж можна. Просто додайте через решітку (#) ім'я розділу, так само, як це робиться в HTML. Наприклад, посилання на цей розділ.

Наприклад, посилання на [[syntax#внутрішні|цей розділ]].

Примітки:

  • Посилання на ті статті, що існують відображаються інакше, ніж посилання на ті, що не існують.
  • «ДокуВікі» за умовчанням не використовує CamelCase (ВерблюжийРегістр) для автоматичного створення посилань, але цю можливість можна включити у файлі config. Перевірка: якщо DokuWiki — посилання, значить ця можливість включена.
  • Якщо змінюється назва розділу, посилання на нього не змінюється автоматично. Так що не дуже покладайтеся на посилання на розділи.

Interwiki

«ДокуВікі» підтримує інтервікі-посилання. Це короткі посилання на інші вікі. Наприклад, ось посилання на статтю Вікіпедії про вікі: Wiki.

«ДокуВікі» підтримує [[interwiki|інтервікі]]-посилання.
Це короткі посилання на інші вікі. Наприклад, ось посилання
на статтю Вікіпедії про вікі: [[wp>Wiki]].

Мережеві ресурси Windows

Посилання на мережеві ресурси виду \\server\share також розпізнаються. Однак врахуйте, що такі посилання мають сенс тільки в гомогенних групах користувачів, наприклад в корпоративному інтранеті.

Посилання на мережеві ресурси виду \\server\share також розпізнаються.

Примітки:

  • З міркувань безпеки безпосередній перегляд мережевих ресурсів працює за умовчанням тільки в Internet Explorer (і тільки в «локальній зоні»).
  • У браузерах Mozilla цю можливість можна включити за допомогою опції security.checkloaduri, але робити це не рекомендується.
  • Докладніше читайте тут: 151.

Картинки-посилання

Поєднавши синтаксис посилання і картинки, можна вставити в текст картинку, яка буде внутрішнім чи зовнішнім посиланням:

[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]

Врахуйте: форматування картинок — це єдина синтаксична конструкція, яку можна використовувати в тексті посилання.

Виноски

За допомогою подвійних дужок можна додати виноску1).

За допомогою подвійних дужок можна додати виноску((Виноска - примітка,
посилання, переклад, що розташовується внизу сторінки.)).

Розбивка на розділи

Для структурування тексту можна використовувати до п'яти рівнів заголовків. Якщо у тексті більше трьох заголовків, автоматично створюється список змісту. Його можна відключити, вставивши в документ рядок ~~NOTOC~~.

Заголовок 3-го рівня

Заголовок 4-го рівня

Заголовок 5-го рівня
==== Заголовок 3-го рівня ====
=== Заголовок 4-го рівня ===
== Заголовок 5-го рівня ==

Чотири та більше тире перетворюються у горизонтальну лінію:


----

Картинки та інші файли

Див. також: «Робота з зображеннями та медіафайлами».

За допомогою фігурних дужок можна вставляти в текст зовнішні та внутрішні картинки. За бажанням можна вказати їх розмір.

Нормальний розмір:

Відмасштабована до заданої ширини:

Відмасштабована до заданих розмірів:

Відмасштабована зовнішня картинка:

Нормальний розмір:                   {{wiki:dokuwiki-128.png}}
Відмасштабована до заданої ширини:   {{wiki:dokuwiki-128.png?50}}
Відмасштабована до заданих розмірів: {{wiki:dokuwiki-128.png?200x50}}
Відмасштабована зовнішня картинка:   {{http://de3.php.net/images/php.gif?200x50}}

Поставивши зліва чи справа пробіл, можна задати вирівнювання картинки:

{{wiki:dokuwiki-128.png }}  - картинка ліворуч
{{ wiki:dokuwiki-128.png}}  - праворуч
{{ wiki:dokuwiki-128.png }} - посередині

І, звичайно, зображенню можна задати назву (у більшості браузерів воно відображається у вигляді виринаючої підказки).

Логотип «ДокуВікі»

{{ wiki:dokuwiki-128.png |Логотип «ДокуВікі»}}

Якщо задати ім'я файлу (внутрішнє або зовнішнє), яке не є картинкою (gif, jpeg, png), воно буде відображатися у вигляді посилання.

Дізнатися, як вставити картинку з посиланням можна у розділі вище.

Списки

«ДокуВікі» підтримує нумеровані і маркіровані списки. Щоб створити елемент списку, поставте на початку рядка два пробіли і потім зірочку (*) у разі маркірованого списку, або дефіс (-) — у разі нумерованого.

  • Перший елемент маркірованого списку
    • Другий елемент списку
      • Можна зробити вкладений список
    • Ще один елемент
  1. Той самий список, але нумерований
  2. Ще елемент
    1. Чим більше пробілів на початку, тим глибше вкладеність
  3. Все просто
  * Перший елемент маркірованого списку
    * Другий елемент списку
      * Можна зробити вкладений список
    * Ще один елемент

  - Той самий список, але нумерований
  - Ще елемент
    - Чим більше пробілів на початку, тим глибше вкладеність
  - Все просто

Див. також FAQ по елементам списку.

Смайлики

«ДокуВікі» переробляє найбільш вживані смайлики в їх графічні еквіваленти. Додаткові смайлики можна покласти в директорію smiley і додати їх у файл conf/smileys.local.conf.

Ось смайлики, які є в «ДокуВікі»:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

Друкарські символи

«ДокуВікі» може переробляти символи, набрані простим текстом, в їх коректні типографські еквіваленти. Розпізнаються наступні символи.

→ ← ↔ ⇒ ⇐ ⇔ » « – — '640×480' © ™ ® …
“Володимир Володимирович™ — це наше всьо © не я”

-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...
"Володимир Володимирович(tm) --- це наше всьо (c) не я"

Примітка: цю конвертацію можна відключити у файлі конфігурації conf/entities.conf.

Таблиці

«ДокуВікі» підтримує спрощений синтаксис створення таблиць.

Заголовок 1 Заголовок 2 Заголовок 3
Рядок 1 Колонка 1 Рядок 1 Колонка 2 Рядок 1 Колонка 3
Рядок 2 Колонка 1 Об'єднання колонок (зверніть увагу на подвійну вертикальну риску)
Рядок 3 Колонка 1 Рядок 3 Колонка 2 Рядок 3 Колонка 3

Нормальні рядки повинні починатися і закінчуватися вертикальною рисою — |, а заголовки «кришечкою» - ^.

^ Заголовок 1        ^ Заголовок 2           ^ Заголовок 3              ^
| Рядок 1 Колонка 1  | Рядок 1 Колонка 2     | Рядок 1 Колонка 3        |
| Рядок 2 Колонка 1  | Об'єднання колонок (зверніть увагу на подвійну вертикальну риску)  ||
| Рядок 3 Колонка 1  | Рядок 3 Колонка 2     | Рядок 3 Колонка 3        |

Щоб об'єднати дві сусідні клітинки у рядку, просто залиште сусідню клітинку повністю порожньою, як показано вище. Слідкуйте, щоб кількість роздільників клітин була однаковою.

Вертикальні заголовки теж можна зробити:

Заголовок 1 Заголовок 2
Заголовок 3 Рядок 1 Колонка 2 Рядок 1 Колонка 3
Заголовок 4 Об'єднання нема
Заголовок 5 Рядок 3 Колонка 2 Рядок 3 Колонка 3

Як легко побачити, роздільник, що стоїть перед клітинкою, визначає форматування:

|              ^ Заголовок 1         ^ Заголовок 2        ^
^ Заголовок 3  | Рядок 1 Колонка 2   | Рядок 1 Колонка 3  |
^ Заголовок 4  | Об'єднання нема     |                    |
^ Заголовок 5  | Рядок 3 Колонка 2   | Рядок 3 Колонка 3  |

Можна зробити вертикально об'єднані, поєднані до низу клітинки за допомогою додавання трьох двокрапок :::

Заголовок 1 Заголовок 2 Заголовок 3
Рядок 1 Колонка 1 ця клітинка поєднана вертикально Рядок 1 Колонка 3
Рядок 2 Колонка 1 Рядок 2 Колонка 3
Рядок 3 Колонка 1 Рядок 3 Колонка 3

В цих клітинках не повинно бути нічого, окрім синтаксиса об'єднання (:::).

^ Заголовок 1         ^ Заголовок 2                        ^ Заголовок 3        ^
| Рядок 1 Колонка 1   | ця клітинка об'єднана вертикально  | Рядок 1 Колонка 3  |
| Рядок 2 Колонка 1   | :::                                | Рядок 2 Колонка 3  |
| Рядок 3 Колонка 1   | :::                                | Рядок 3 Колонка 3  |

Текст клітинки таблиці можна вирівнювати. Просто додайте мінімум два пробіли з протилежного боку: зліва - якщо треба вирівняти вправо, праворуч - якщо треба вирівняти вліво, і по два з кожного боку - якщо по центру. Можна зробити вертикально об'єднані клітинки за допомогою додавання трьох двокрапок ::: в поєднанні вниз клітинки.

^           Таблиця з вирівнюванням        ^^^
|      праворуч|   в центрі   |              |
|ліворуч       |      праворуч|   в центрі   |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Примітка: вертикальне вирівнювання не підтримується.

1)
Виноска - примітка, посилання, переклад, що розташовується внизу сторінки.
wiki/syntax.txt · Востаннє змінено: 2018/10/18 10:39 повз soockmanjuk