====== Синтаксис форматування ====== «ДокуВікі» підтримує просту мову розмітки, що за можливістю зберігає файли даних як найбільш читабельними. Тут перераховані всі можливі синтаксичні конструкції, які можна використовувати при редагуванні статей. Просто подивіться на вихідний код цієї статті, натиснувши кнопку «Відредагувати статтю» вгорі чи внизу сторінки. Якщо хочете поекпериментувати, просто використовуйте «[[playground:playground|пісочницю]]». Просту розмітку також можна легко зробити за допомогою [[uk:toolbar|панелі інструментів]]. ===== Основні конструкції форматування ===== «ДокуВікі» підтримує виділення тексту **жирним шрифтом**, //курсивом//, __підкресленням__ та вивід тексту ''моноширинним шрифтом''. Всі ці конструкції можна **__//''об'єднати''//__**. «ДокуВікі» підтримує виділення тексту **жирним шрифтом**, //курсивом//, __підкресленням__ та вивід тексту ''моноширинним шрифтом''. Всі ці конструкції можна **__//''об'єднати''//__**. Також можна використовувати підрядковий та надрядковий індекси. Також можна використовувати підрядковий та надрядковий індекси. Ще можна закреслити текст. Ще можна закреслити текст. **Абзаци** відбиваються порожнім рядком. Якщо потрібно **примусово вставити перенос рядка**, не створюючи абзац, вставте два зворотних слеша і за ним пробіл або перехід до нового рядка. Просто текст з розривом рядків\\ Зверніть увагу, що два зворотних слеша діють тільки в кінці рядка\\ або якщо за ними стоїть\\ пробіл. Якщо його не поставити, \\вийде ось так. Просто текст з розривом рядків\\ Зверніть увагу, що два зворотних слеша діють тільки в кінці рядка\\ або якщо за ними стоїть\\ пробіл. Якщо його не поставити, \\вийде ось так. Примусові переноси слід використовувати тільки в разі крайньої необхідності. ===== Посилання ===== Посилання в «ДокуВікі» бувають різні і створювати їх можна теж по-різному. ==== Зовнішні ==== Зовнішні посилання розпізнаються автоматично: 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 ==== «ДокуВікі» підтримує [[doku>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-го рівня == Чотири і більше тире перетворюються в горизонтальну риску: ---- ---- ===== Картинки та інші файли ===== Див. також: «[[doku>images|Робота з зображеннями та медіафайлами]]». За допомогою фігурних дужок можна вставляти в текст зовнішні та внутрішні [[doku>images|картинки]]. За бажанням можна вказати їх розмір. Нормальний розмір: {{wiki:dokuwiki-128.png}} Відмасштабована до заданої ширини: {{wiki:dokuwiki-128.png?50}} Відмасштабована до заданих розмірів: {{wiki:dokuwiki-128.png?200x50}} Відмасштабована зовнішня картинка: {{https://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 | Примітка: вертикальне вирівнювання не підтримується. ===== Неформатовані блоки ===== Якщо вам потрібно відобразити текст точно так, як він набраний (без будь-якого форматування), обмежте область тегами ''%%%%'' або навіть простіше подвійними знаками відсотків ''%%''. Це деякий текст, який містить такі адреси: http://www.splitbrain.org і **форматування**, але з ним нічого не зроблено. Це деякий текст, який містить такі адреси: http://www.splitbrain.org і **форматування**, але з ним нічого не зроблено. Те саме стосується %%//__цього__ тексту// зі смайликом ;-).%% Те саме стосується %%//__this__ текст// зі смайликом ;-)%%. ===== Кодові блоки ===== Ви можете включити блоки коду до своїх документів, зробивши для них відступ принаймні на два пробіли (як у попередніх прикладах) або використовуючи теги '''' або ''''. Це текст із відступом у два пробіли. Це попередньо відформатований код, усі пробіли збережено: ось <-так Це майже те саме, але ви можете використовувати це виділення, щоб показати, що цитується вміст файлу. Ці блоки були створені цим джерелом: Це текст із відступом у два пробіли. Це попередньо відформатований код, усі пробіли збережено: ось <-так Це майже те саме, але ви можете використовувати це виділення, щоб показати, що цитується вміст файлу. Щоб детально побачити, як створюються ці блоки, дивіться код статті. ===== Підсвічування синтаксису ===== DokuWiki може виділяти вихідний код, що полегшує його читання. Він використовує GeSHi Generic Syntax Highlighter, тому підтримується будь-яка мова, яку підтримує GeSHi. Синтаксис використовує ті самі блоки '''' і '''', які описані в попередньому розділі, але для підсвічування, ім’я синтаксису мови включено в тег, //наприклад// '''' або ''''. /** * The HelloWorldApp class implements an application that * simply displays "Hello World!" to the standard output. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); //Display the string. } } Наразі розпізнаються такі мови://4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic// ==== Завантажувальні Блоки коду ==== Якщо ви використовуєте синтаксис або, як описано вище, ви можете також зробити вказаний код доступним для завантаження. Це можна зробити, вказавши назву файлу після коду мови: Якщо вам не потрібне підсвічування коду, але бажаєте отримати файл для завантаження, вкажіть тире (''-'') як код мови: %%%%. **Особливість:** при написанні імені файлу українською для формування корректного імені файлу, обрамляйте назву файлу подвійними лапками наприклад "Фоо Бар.php". ==== Агрегація каналів RSS/ATOM ==== DokuWiki може інтегрувати дані із зовнішніх каналів XML. Для аналізу XML-каналів використовується [[http://simplepie.org/|SimplePie]]. Усі формати, зрозумілі SimplePie, також можна використовувати в DokuWiki. Ви можете вплинути на відтворення за допомогою кількох додаткових параметрів, розділених пробілами: ^Параметр ^ опис ^ |будь-яке число | буде використано як максимальну кількість елементів для показу, за замовчуванням 8| |reverse | спочатку відображати останні елементи в стрічці| |author показати імена авторів елементів| |date | показати дати елементів| |description | показати опис елементів. Усі теги HTML буде видалено| |nosort | не сортовані елементи в стрічці| | //n//[dhm] | період оновлення, де d=дні, h=години, m=хвилини. (наприклад, 12h = 12 годин).| //Період оновлення// за замовчуванням становить 4 години. Будь-яке значення меньше 10 хвилин розглядатиметься, як 10 хвилин. DokuWiki зазвичай намагатиметься надати кешовану версію сторінки, хоча очевидно, це й недоречно, якщо сторінка містить динамічний зовнішній вміст. Параметр повідомляє DokuWiki повторно відобразити сторінку, якщо минуло більше, ніж //період оновлення// з моменту останнього відтворення сторінки. За замовчуванням канал буде відсортовано за датою, спочатку найновіші елементи. Ви можете відсортувати його спочатку за найстарішим за допомогою //reverse// параметра або відобразити канал як є за допомогою //nosort//. приклад: {{rss>http://slashdot.org/index.rss 5 5 author date 1h}} {{rss>http://slashdot.org/index.rss 5 author date 1h}} ===== Управляючі макроси ===== Деякий синтаксис впливає на те, як DokuWiki відтворює сторінку, не створюючи самих виводів. Доступні наступні керуючі макроси: ^ Макрос ^ Опис | | %%~~NOTOC~~%% | Якщо цей макрос знайдено на сторінці, зміст не буде створено. | | %%~~NOCACHE~~%% | DokuWiki за замовчуванням кешує весь вихід. Іноді це може бути небажаним (наприклад, коли використовується синтаксис %%%% вище), додавання цього макросу змусить DokuWiki повторно відображати сторінку під час кожного виклику | ===== Синтаксичні плагіни ===== Синтаксис DokuWiki можна розширити за допомогою [[doku>plugins|плагінів (Plugins)]]. Як використовувати ті, чи інші встановлені плагіни, описано на відповідних сторінках опису плагіну. У цій установці DokuWiki доступні наступні синтаксичні модулі: ~~INFO:syntaxplugins~~