====== Синтаксис форматування ====== «DokuWiki» підтримує просту мову розмітки, що за можливістю зберігає файли даних як найбільш читабельними. Тут перераховані всі можливі синтаксичні конструкції, які можна використовувати при редагуванні статей. ===== Основні конструкції форматування ===== «ДокуВікі» підтримує виділення тексту **жирним шрифтом**, //курсивом//, __підкресленням__ та вивід тексту ''моноширинним шрифтом''. Всі ці конструкції можна **__//''об'єднати''//__**. «ДокуВікі» підтримує виділення тексту **жирним шрифтом**, //курсивом//, __підкресленням__ та вивід тексту ''моноширинним шрифтом''. Всі ці конструкції можна **__//''об'єднати''//__**. Також можна використовувати підрядковий та надрядковий індекси. Також можна використовувати підрядковий та надрядковий індекси. Ще можна закреслити текст. Ще можна закреслити текст. **Абзаци** відбиваються порожнім рядком. Якщо потрібно **примусово вставити перенос рядка**, не створюючи абзац, вставте два зворотних слеша і за ним пробіл або перехід до нового рядка. Просто текст з розривом рядків\\ Зверніть увагу, що два зворотних слеша діють тільки в кінці рядка\\ або якщо за ними стоїть\\ пробіл. Якщо його не поставити, \\вийде ось так. Просто текст з розривом рядків\\ Зверніть увагу, що два зворотних слеша діють тільки в кінці рядка\\ або якщо за ними стоїть\\ пробіл. Якщо його не поставити, \\вийде ось так. Примусові переноси слід використовувати тільки в разі крайньої необхідності. ===== Посилання ===== Посилання в «ДокуВікі» бувають різні і створювати їх можна теж по-різному. ==== Зовнішні ==== Зовнішні посилання розпізнаються автоматично: http://www.google.com або просто www.google.com --- також можна вказувати текст посилання: [[http://www.google.com|Це посилання на Google]]. Адреси електронної пошти теж розпізнаються: . Зовнішні посилання розпізнаються автоматично: http://www.google.com або просто www.google.com --- також можна вказувати текст посилання: [[http://www.google.com|Це посилання на Google]]. Адреси електронної пошти теж розпізнаються: . ==== Внутрішні ==== Внутрішні посилання створюються за допомогою квадратних дужок. Можна або просто вказати [[pagename|ім'я сторінки]], або додатково прописати [[pagename|текст посилання]]. Імена вікі-статей автоматично переводяться в нижній регістр, спецсимволи використовувати не можна. Внутрішні посилання створюються за допомогою квадратних дужок. Можна або просто вказати [[pagename|ім'я сторінки]], або додатково прописати [[pagename|текст посилання]]. Імена вікі-статей автоматично переводяться в нижній регістр, спецсимволи використовувати не можна. Можна використовувати в посиланні [[ru:namespaces|простір імен]] через двокрапку. Можна використовувати в посиланні [[namespaces|простір імен]] через двокрапку. Ставити посилання на певний розділ теж можна. Просто додайте через решітку (#) ім'я розділу, так само, як це робиться в HTML. Наприклад, посилання на [[syntax#внутрішні|цей розділ]]. Наприклад, посилання на [[syntax#внутрішні|цей розділ]]. Примітки: * Посилання на ті статті, що [[syntax|існують]] відображаються інакше, ніж посилання на ті, що [[nonexisting|не існують]]. * «ДокуВікі» за умовчанням не використовує [[wp>ru:CamelCase|CamelCase]] (ВерблюжийРегістр) для автоматичного створення посилань, але цю можливість можна включити у файлі [[config]]. Перевірка: якщо DokuWiki --- посилання, значить ця можливість включена. * Якщо змінюється назва розділу, посилання на нього не змінюється автоматично. Так що не дуже покладайтеся на посилання на розділи. ==== Interwiki ==== «ДокуВікі» підтримує [[interwiki|інтервікі]]-посилання. Це короткі посилання на інші вікі. Наприклад, ось посилання на статтю Вікіпедії про вікі: [[wp>Wiki]]. «ДокуВікі» підтримує [[interwiki|інтервікі]]-посилання. Це короткі посилання на інші вікі. Наприклад, ось посилання на статтю Вікіпедії про вікі: [[wp>Wiki]]. ==== Мережеві ресурси Windows ==== Посилання на мережеві ресурси виду \\server\share також розпізнаються. Однак врахуйте, що такі посилання мають сенс тільки в гомогенних групах користувачів, наприклад в корпоративному інтранеті. Посилання на мережеві ресурси виду \\server\share також розпізнаються. Примітки: * З міркувань безпеки безпосередній перегляд мережевих ресурсів працює за умовчанням тільки в Internet Explorer (і тільки в «локальній зоні»). * У браузерах Mozilla цю можливість можна включити за допомогою опції [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], але робити це не рекомендується. * Докладніше читайте тут: [[bug>151]]. ==== Картинки-посилання ==== Поєднавши синтаксис посилання і [[#картинки та інші файли|картинки]], можна вставити в текст картинку, яка буде внутрішнім чи зовнішнім посиланням: [[http://www.php.net/|{{wiki:dokuwiki-128.png}}]] [[http://www.php.net/|{{wiki:dokuwiki-128.png}}]] Врахуйте: форматування картинок --- це єдина синтаксична конструкція, яку можна використовувати в тексті посилання. ==== Виноски ==== За допомогою подвійних дужок можна додати виноску((Виноска - примітка, посилання, переклад, що розташовується внизу сторінки.)). За допомогою подвійних дужок можна додати виноску((Виноска - примітка, посилання, переклад, що розташовується внизу сторінки.)). ===== Розбивка на розділи ===== Для структурування тексту можна використовувати до п'яти рівнів заголовків. Якщо у тексті більше трьох заголовків, автоматично створюється список змісту. Його можна відключити, вставивши в документ рядок %%~~NOTOC~~%%. ==== Заголовок 3-го рівня ==== === Заголовок 4-го рівня === == Заголовок 5-го рівня == ==== Заголовок 3-го рівня ==== === Заголовок 4-го рівня === == Заголовок 5-го рівня == Чотири та більше тире перетворюються у горизонтальну лінію: ---- ---- ===== Картинки та інші файли ===== Див. також: «[[images|Робота з зображеннями та медіафайлами]]». За допомогою фігурних дужок можна вставляти в текст зовнішні та внутрішні [[images|картинки]]. За бажанням можна вказати їх розмір. Нормальний розмір: {{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?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 }} - картинка ліворуч {{ wiki:dokuwiki-128.png}} - праворуч {{ wiki:dokuwiki-128.png }} - посередині І, звичайно, зображенню можна задати назву (у більшості браузерів воно відображається у вигляді виринаючої підказки). {{ wiki:dokuwiki-128.png |Логотип «ДокуВікі»}} {{ wiki:dokuwiki-128.png |Логотип «ДокуВікі»}} Якщо задати ім'я файлу (внутрішнє або зовнішнє), яке не є картинкою (''gif, jpeg, png''), воно буде відображатися у вигляді посилання. Дізнатися, як вставити картинку з посиланням можна у [[#картинки-посилання|розділі вище]]. ===== Списки ===== «ДокуВікі» підтримує нумеровані і маркіровані списки. Щоб створити елемент списку, поставте на початку рядка два пробіли і потім зірочку (*) у разі маркірованого списку, або дефіс (-) --- у разі нумерованого. * Перший елемент маркірованого списку * Другий елемент списку * Можна зробити вкладений список * Ще один елемент - Той самий список, але нумерований - Ще елемент - Чим більше пробілів на початку, тим глибше вкладеність - Все просто * Перший елемент маркірованого списку * Другий елемент списку * Можна зробити вкладений список * Ще один елемент - Той самий список, але нумерований - Ще елемент - Чим більше пробілів на початку, тим глибше вкладеність - Все просто Див. також [[faq:lists|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%% ===== Друкарські символи ===== «ДокуВікі» може переробляти символи, набрані простим текстом, в їх коректні типографські еквіваленти. Розпізнаються наступні символи. -> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...\\ "Володимир Володимирович(tm) --- це наше всьо (c) не я" -> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ... "Володимир Володимирович(tm) --- це наше всьо (c) не я" Примітка: цю конвертацію можна відключити у файлі конфігурації ''[[entities|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 | Примітка: вертикальне вирівнювання не підтримується.