Показать страницуИстория страницыСсылки сюдаСвернуть / развернуть всёНаверх Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно. ====== Синтаксис форматирования ====== [[doku>DokuWiki]] поддерживает простой язык разметки, который позволяет сделать файлы данных максимально читаемыми. Эта страница содержит все возможные синтаксические конструкции, которые вы можете использовать при редактировании страниц. Просто посмотрите исходный код этой страницы, нажав «Править страницу». Если вы хотите что-то попробовать, используйте страницу [[playground:playground|песочница]]. Простая разметка также доступна через [[doku>toolbar|панель инструментов]]. ===== Создайте свои первые страницы ===== Вашей вики нужна стартовая страница. Пока её не существует, ссылка будет красной: [[:temp]]. Перейдите по этой ссылке и создайте страницу. Если вам нужна помощь в использовании синтаксиса, вы всегда можете обратиться к [[wiki:syntax|странице синтаксиса]]. ===== Базовое форматирование текста ===== DokuWiki поддерживает **жирный**, //курсив//, __подчёркнутый__ и ''моноширинный'' текст. Конечно, вы можете **__//''комбинировать''//__** всё это. DokuWiki поддерживает **жирный**, //курсив//, __подчёркнутый__ и ''моноширинный'' текст. Конечно, вы можете **__//''комбинировать''//__** всё это. Вы также можете использовать <sub>нижний индекс</sub> и <sup>верхний индекс</sup>. Вы также можете использовать <sub>нижний индекс</sub> и <sup>верхний индекс</sup>. Вы можете пометить что-то как <del>удалённое</del>. Вы можете пометить что-то как <del>удалённое</del>. **Абзацы** создаются с помощью пустых строк. Если вы хотите **принудительно сделать перенос строки** без создания нового абзаца, вы можете использовать две обратные косые черты, за которыми следует пробел или конец строки. Это текст с некоторыми переносами\\ Обратите внимание, что две обратные косые черты распознаются только в конце строки\\ или если за ними следует\\ пробел \\так происходит без него. Это текст с некоторыми переносами\\ Обратите внимание, что две обратные косые черты распознаются только в конце строки\\ или если за ними следует\\ пробел \\так происходит без него. Используйте принудительные переносы строк только в случае крайней необходимости. ===== Ссылки ===== DokuWiki поддерживает несколько способов создания ссылок. ==== Внешние ==== Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com. Вы также можете задать текст ссылки: [[http://www.google.com|Эта ссылка ведёт на google]]. Адреса электронной почты, такие как <andi@splitbrain.org>, тоже распознаются. Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com. Вы также можете задать текст ссылки: [[http://www.google.com|Эта ссылка ведёт на google]]. Адреса электронной почты, такие как <andi@splitbrain.org>, тоже распознаются. ==== Внутренние ==== Внутренние ссылки создаются с помощью квадратных скобок. Вы можете просто указать [[имя_страницы]] или использовать дополнительный [[имя_страницы|текст ссылки]]. Внутренние ссылки создаются с помощью квадратных скобок. Вы можете просто указать [[имя_страницы]] или использовать дополнительный [[имя_страницы|текст ссылки]]. [[doku>имя_страницы|Имена страниц]] автоматически преобразуются в нижний регистр, специальные символы не допускаются. Вы можете использовать [[пространство:имён]] с помощью двоеточия в имени страницы. Вы можете использовать [[пространство:имён]] с помощью двоеточия в имени страницы. Подробнее о пространствах имён см. [[doku>namespaces]]. Ссылки на конкретный раздел также возможны. Просто добавьте имя раздела после символа решётки, как известно из HTML. Эта ссылка ведёт на [[syntax#internal|этот раздел]]. Эта ссылка ведёт на [[syntax#internal|этот раздел]]. Примечания: * Ссылки на [[syntax|существующие страницы]] отображаются в другом стиле, чем на [[nonexisting|несуществующие]]. * По умолчанию DokuWiki не использует [[wp>CamelCase]] для автоматического создания ссылок, но это поведение можно включить в [[doku>config|файле конфигурации]]. Подсказка: если DokuWiki является ссылкой, значит, эта функция включена. * При изменении заголовка раздела его закладка также меняется. Поэтому не стоит слишком сильно полагаться на ссылки на разделы. ==== Межвики ==== DokuWiki поддерживает ссылки [[doku>Interwiki]]. Это быстрые ссылки на другие вики. Например, это ссылка на страницу Википедии о вики: [[wp>Wiki]]. DokuWiki поддерживает ссылки [[doku>Interwiki]]. Это быстрые ссылки на другие вики. Например, это ссылка на страницу Википедии о вики: [[wp>Wiki]]. ==== Сетевые папки Windows ==== Сетевые папки Windows, такие как [[\\server\share|эта]], также распознаются. Пожалуйста, учтите, что они имеют смысл только в однородной группе пользователей, например, в корпоративном [[wp>Intranet|интранете]]. Сетевые папки Windows, такие как [[\\server\share|эта]], также распознаются. Примечания: * По соображениям безопасности прямой просмотр сетевых папок Windows по умолчанию работает только в Microsoft Internet Explorer (и только в «локальной зоне»). * Для Mozilla и Firefox это можно включить с помощью различных обходных путей, описанных в [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|базе знаний Mozilla]]. Однако при этом всё равно будет появляться предупреждение JavaScript о попытке открыть сетевую папку Windows. Чтобы убрать это предупреждение (для всех пользователей), поместите следующую строку в ''conf/lang/ru/lang.php'' (подробнее см. [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|локализацию]]): <code - conf/lang/ru/lang.php> <?php /** * Кастомизация файла русского языка * Копируйте только те строки, которые нужно изменить */ $lang['js']['nosmblinks'] = ''; </code> ==== Ссылки-картинки ==== Вы также можете использовать изображение для ссылки на другую внутреннюю или внешнюю страницу, комбинируя синтаксис ссылок и [[#images_and_other_files|изображений]] (см. ниже) следующим образом: [[http://php.net|{{wiki:dokuwiki-128.png}}]] [[http://php.net|{{wiki:dokuwiki-128.png}}]] Пожалуйста, учтите: форматирование изображений — это единственный синтаксис форматирования, который принимается в тексте ссылок. Здесь поддерживается весь синтаксис [[#images_and_other_files|изображений]] и [[#links|ссылок]] (включая изменение размера изображений, внутренние и внешние изображения и URL-адреса, а также межвики-ссылки). ===== Сноски ===== Вы можете добавлять сноски ((Это сноска)) с помощью двойных круглых скобок. Вы можете добавлять сноски ((Это сноска)) с помощью двойных круглых скобок. ===== Разделы ===== Вы можете использовать до пяти уровней заголовков для структурирования содержимого. Если у вас больше трёх заголовков, автоматически создаётся оглавление — это можно отключить, добавив в документ строку ''<nowiki>~~NOTOC~~</nowiki>''. ==== Заголовок уровня 3 ==== === Заголовок уровня 4 === == Заголовок уровня 5 == ==== Заголовок уровня 3 ==== === Заголовок уровня 4 === == Заголовок уровня 5 == С помощью четырёх и более дефисов вы можете создать горизонтальную линию: ---- ===== Медиафайлы ===== Вы можете включать внешние и внутренние [[doku>images|изображения, видео и аудиофайлы]] с помощью фигурных скобок. При желании вы можете указать их размер. Реальный размер: {{wiki:dokuwiki-128.png}} Изменить размер до указанной ширины: {{wiki:dokuwiki-128.png?50}} Изменить размер до указанной ширины и высоты((если соотношение сторон указанной ширины и высоты не соответствует соотношению сторон изображения, оно будет обрезано до нового соотношения перед изменением размера)): {{wiki:dokuwiki-128.png?200x50}} Изменённое внешнее изображение: {{https://www.php.net/images/php.gif?200x50}} Реальный размер: {{wiki:dokuwiki-128.png}} Изменить размер до указанной ширины: {{wiki:dokuwiki-128.png?50}} Изменить размер до указанной ширины и высоты: {{wiki:dokuwiki-128.png?200x50}} Изменённое внешнее изображение: {{https://www.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 |Это подпись}} О том, как сделать изображение ссылкой на другую страницу, см. [[#Ссылки-картинки]]. ==== Поддерживаемые форматы медиафайлов ==== DokuWiki может встраивать следующие форматы медиафайлов напрямую. | Изображения | ''gif'', ''jpg'', ''png'' | | Видео | ''webm'', ''ogv'', ''mp4'' | | Аудио | ''ogg'', ''mp3'', ''wav'' | | Flash | ''swf'' | Если вы укажете имя файла, который не является поддерживаемым форматом медиа, он будет отображаться как ссылка. Добавив ''?linkonly'', вы получите ссылку на медиафайл без его встраивания. {{wiki:dokuwiki-128.png?linkonly}} {{wiki:dokuwiki-128.png?linkonly}} Это просто ссылка на изображение. ==== Альтернативные форматы ==== К сожалению, не все браузеры поддерживают все видео- и аудиоформаты. Чтобы смягчить эту проблему, вы можете загрузить свой файл в разных форматах для обеспечения максимальной совместимости с браузерами. Например, рассмотрим это встроенное видео mp4: {{video.mp4|Забавное видео}} Когда вы загрузите ''video.webm'' и ''video.ogv'' рядом с указанным ''video.mp4'', DokuWiki автоматически добавит их в качестве альтернатив, чтобы один из трёх файлов был понятен вашему браузеру. Кроме того, DokuWiki поддерживает изображение-«постер», которое будет показано до начала воспроизведения видео. Это изображение должно иметь то же имя файла, что и видео, и быть в формате jpg или png. В приведённом выше примере подошёл бы файл ''video.jpg''. ===== Списки ===== DokuWiki поддерживает маркированные и нумерованные списки. Чтобы создать элемент списка, сделайте отступ текста на два пробела и используйте ''*'' для маркированных списков или ''-'' для нумерованных. * Это маркированный список * Второй пункт * Вы можете создавать разные уровни * Ещё один пункт - Это нумерованный список - Второй пункт - Просто используйте отступы для более глубоких уровней - Вот так <code> * Это маркированный список * Второй пункт * Вы можете создавать разные уровни * Ещё один пункт - Это нумерованный список - Второй пункт - Просто используйте отступы для более глубоких уровней - Вот так </code> Также ознакомьтесь с [[doku>faq:lists|FAQ по элементам списков]]. ===== Текстовые преобразования ===== DokuWiki может преобразовывать определённые предопределённые символы или строки в изображения, другой текст или HTML. Преобразование текста в изображения в основном используется для смайликов. Преобразование текста в HTML используется для типографских замен, но может быть настроено для использования и других элементов HTML. ==== Преобразование текста в изображения ==== DokuWiki преобразует часто используемые [[wp>emoticon|эмотиконы]] в их графические эквиваленты. Эти [[doku>Smileys|смайлики]] и другие изображения могут быть настроены и расширены. Вот обзор смайликов, входящих в DokuWiki: * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * m( %% m( %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% ==== Преобразование текста в HTML ==== Типографика: [[DokuWiki]] может преобразовывать простые текстовые символы в их типографски правильные сущности. Вот пример распознаваемых символов. -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) «Он подумал: «Это мир мужчин»…» <code> -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) «Он подумал: «Это мир мужчин»…» </code> То же самое можно сделать для создания любого HTML-кода, просто добавив его в [[doku>entities|файл шаблонов]]. Есть три исключения, которые не поступают из этого файла шаблонов: символ умножения (640x480), «одинарные» и «двойные» кавычки. Их можно отключить с помощью [[doku>config:typography|опции конфигурации]]. ===== Цитирование ===== Иногда вы хотите пометить текст, чтобы показать, что это ответ или комментарий. Вы можете использовать следующий синтаксис: <code> Я думаю, мы должны это сделать > Нет, не должны >> Ну, я говорю, что должны > Правда? >> Да! >>> Тогда давайте сделаем это! </code> Я думаю, мы должны это сделать > Нет, не должны >> Ну, я говорю, что должны > Правда? >> Да! >>> Тогда давайте сделаем это! ===== Таблицы ===== DokuWiki поддерживает простой синтаксис для создания таблиц. ^ Заголовок 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 | Строка 2 Кол 2 | Строка 2 Кол 3 | Как вы можете видеть, разделитель ячеек перед ячейкой определяет форматирование: | ^ Заголовок 1 ^ Заголовок 2 ^ ^ Заголовок 3 | Строка 1 Кол 2 | Строка 1 Кол 3 | ^ Заголовок 4 | нет объединения на этот раз | | ^ Заголовок 5 | Строка 2 Кол 2 | Строка 2 Кол 3 | Вы можете иметь объединения строк (вертикально соединённые ячейки), добавляя ''%%:::%%'' в ячейки под той, с которой они должны соединяться. ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Строка 1 Кол 1 | эта ячейка объединена по вертикали | Строка 1 Кол 3 | | Строка 2 Кол 1 | ::: | Строка 2 Кол 3 | | Строка 3 Кол 1 | ::: | Строка 2 Кол 3 | Помимо синтаксиса объединения строк, эти ячейки не должны содержать ничего другого. ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Строка 1 Кол 1 | эта ячейка объединена по вертикали | Строка 1 Кол 3 | | Строка 2 Кол 1 | ::: | Строка 2 Кол 3 | | Строка 3 Кол 1 | ::: | Строка 2 Кол 3 | Вы также можете выравнивать содержимое таблицы. Просто добавьте как минимум два пробела с противоположного конца вашего текста: добавьте два пробела слева для выравнивания по правому краю, два пробела справа для выравнивания по левому краю и как минимум два пробела с обоих концов для центрирования текста. ^ Таблица с выравниванием ^^^ | right| center |left | |left | right| center | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Так это выглядит в исходном коде: ^ Таблица с выравниванием ^^^ | right| center |left | |left | right| center | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Примечание: Вертикальное выравнивание не поддерживается. ===== Отмена форматирования ===== Если вам нужно отобразить текст в точности так, как он набран (без какого-либо форматирования), заключите область в теги ''%%<nowiki>%%'' или, ещё проще, в двойные знаки процента ''<nowiki>%%</nowiki>''. <nowiki> Это текст, который содержит такие адреса, как http://www.splitbrain.org, и **форматирование**, но с ним ничего не делается. </nowiki> То же самое верно для %%//__этого текста__// со смайликом ;-)%%. <nowiki> Это текст, который содержит такие адреса, как http://www.splitbrain.org, и **форматирование**, но с ним ничего не делается. </nowiki> То же самое верно для %%//__этого текста__// со смайликом ;-)%%. ===== Блоки кода ===== Вы можете включать блоки кода в свои документы, либо делая отступ как минимум на два пробела (как в предыдущих примерах), либо используя теги ''%%<code>%%'' или ''%%<file>%%''. Это текст с отступом в два пробела. <code> Это предварительно отформатированный код, все пробелы сохраняются: как <-здесь </code> <file> Это почти то же самое, но вы могли бы использовать это, чтобы показать, что вы цитируете файл. </file> Эти блоки были созданы этим исходным кодом: Это текст с отступом в два пробела. <code> Это предварительно отформатированный код, все пробелы сохраняются: как <-здесь </code> <file> Это почти то же самое, но вы могли бы использовать это, чтобы показать, что вы цитируете файл. </file> ==== Подсветка синтаксиса ==== [[wiki:DokuWiki]] может подсвечивать исходный код, что облегчает его чтение. Для этого используется [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter — поэтому поддерживается любой язык, поддерживаемый GeSHi. Синтаксис использует те же блоки кода и файлов, описанные в предыдущем разделе, но на этот раз имя языка для подсветки синтаксиса включается в тег, например ''<nowiki><code java></nowiki>'' или ''<nowiki><file java></nowiki>''. <code java> /** * Класс HelloWorldApp реализует приложение, * которое просто выводит «Hello World!» в стандартный вывод. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); // Вывод строки. } } </code> В настоящее время распознаются следующие языковые строки: //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// Для подсветки синтаксиса доступны дополнительные [[doku>syntax_highlighting|расширенные возможности]], такие как подсветка строк или добавление номеров строк. ==== Загружаемые блоки кода ==== Когда вы используете синтаксис ''%%<code>%%'' или ''%%<file>%%'', как указано выше, вы можете также сделать показанный код доступным для скачивания. Вы можете сделать это, указав имя файла после кода языка, например: <code> <file php myexample.php> <?php echo "hello world!"; ?> </file> </code> <file php myexample.php> <?php echo "hello world!"; ?> </file> Если вы не хотите подсветки синтаксиса, но хотите получить загружаемый файл, укажите дефис (''-'') в качестве кода языка: ''%%<code - myfile.foo>%%''. ===== Агрегация RSS/ATOM-лент ===== [[DokuWiki]] может интегрировать данные из внешних XML-лент. Для анализа XML-лент используется [[http://simplepie.org/|SimplePie]]. Все форматы, понятные SimplePie, также могут использоваться в DokuWiki. Вы можете влиять на отображение с помощью нескольких дополнительных параметров, разделённых пробелами: ^ Параметр ^ Описание ^ | любое число | будет использоваться как максимальное количество отображаемых элементов, по умолчанию 8 | | reverse | отображать последние элементы ленты первыми | | author | показывать имена авторов элементов | | date | показывать даты элементов | | description | показывать описание элемента. Все HTML-теги будут удалены | | nosort | не сортировать элементы в ленте | | //n//[дчм] | период обновления, где д=дни, ч=часы, м=минуты (например, 12ч = 12 часов) | Период обновления по умолчанию составляет 4 часа. Любое значение менее 10 минут будет рассматриваться как 10 минут. [[wiki:DokuWiki]] в целом старается предоставлять кэшированную версию страницы, что, очевидно, неуместно, когда страница содержит динамический внешний контент. Параметр указывает [[wiki:DokuWiki]] повторно отображать страницу, если с момента последнего отображения прошло больше //периода обновления//. По умолчанию лента будет отсортирована по дате, сначала новые. Вы можете отсортировать её по старым первыми, используя параметр ''reverse'', или отобразить ленту как есть с помощью ''nosort''. **Пример:** {{rss>http://slashdot.org/index.rss 5 author date 1ч }} {{rss>http://slashdot.org/index.rss 5 author date 1ч }} ===== Управляющие макросы ===== Некоторые синтаксические конструкции влияют на то, как DokuWiki отображает страницу, не создавая при этом собственного вывода. Доступны следующие управляющие макросы: ^ Макрос ^ Описание | | %%~~NOTOC~~%% | Если этот макрос найден на странице, оглавление создаваться не будет | | %%~~NOCACHE~~%% | По умолчанию DokuWiki кэширует весь вывод. Иногда это может быть нежелательно (например, при использовании синтаксиса %%<php>%% выше), добавление этого макроса заставит DokuWiki перерисовывать страницу при каждом вызове | ===== Плагины синтаксиса ===== Синтаксис DokuWiki может быть расширен с помощью [[doku>plugins|плагинов]]. Использование установленных плагинов описано на соответствующих страницах их описания. В данной конкретной установке DokuWiki доступны следующие плагины синтаксиса: ~~INFO:syntaxplugins~~ ru/syntax.txt Последнее изменение: 2026/03/25 15:27 — moyunni