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

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


ru:intro:syntax

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
ru:intro:syntax [2025/04/14 00:22] boris_rru:intro:syntax [2025/04/14 18:50] (текущий) boris_r
Строка 1: Строка 1:
 ====== Синтаксис форматирования ====== ====== Синтаксис форматирования ======
-Сайт работает на движке ДокуВики+ 
-DokuWiki поддерживает язык разметки, который по возможности сохраняет файлы данных как можно более читабельнымиЗдесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании страниц. Просто посмотрите на исходный код этой страницы, нажав кнопку Отредактировать страницу вверху или внизу страницы. Если хотите поупражняться, используйте [[ru:intro:playground|песочницу]]. Простую разметку также можно легко сделать с помощью [[.:quickbuttons|панели инструментов]]+«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельнымиЗдесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[ru:intro:playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[ru:intro:toolbar|панели инструментов]].
  
 ===== Основные конструкции форматирования ===== ===== Основные конструкции форматирования =====
  
-DokuWiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчеркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**.+«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**.
  
 <code> <code>
-DokuWiki поддерживает выделение текста +«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//,  
-**жирным шрифтом**, +__подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''.  
-//курсивом//, +Все эти конструкции можно **__//''объединить''//__**. 
-__подчеркниванием текста__ +
-и вывод текста ''моноширинным шрифтом''.  +
-Все эти конструкции можно **__//''объединить''//__**.+
 </code> </code>
  
Строка 28: Строка 25:
 </code> </code>
  
- **Параграфы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, не создавая параграф, вставьте два обратных слэша и за ним пробел или энтер.+**Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.
  
 Просто текст с разрывом строк\\ Обратите внимание,  Просто текст с разрывом строк\\ Обратите внимание, 
Строка 39: Строка 36:
 </code> </code>
  
-:!: Принудительные переносы следует использовать только в случае крайней необходимости.+Принудительные переносы следует использовать только в случае крайней необходимости.
  
 ===== Ссылки ===== ===== Ссылки =====
  
-Ссылки в DokuWiki бывают разныеи создавать их можно тоже по-разному.+Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному.
  
 ==== Внешние ==== ==== Внешние ====
Строка 51: Строка 48:
 [[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты [[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
 тоже распознаются: <andi@splitbrain.org>. тоже распознаются: <andi@splitbrain.org>.
-{{:dokuwiki-128.png|}}+
 <code>Внешние ссылки распознаются автоматически: http://www.google.com или <code>Внешние ссылки распознаются автоматически: http://www.google.com или
 просто www.google.com --- также можно указывать текст ссылки: просто www.google.com --- также можно указывать текст ссылки:
 [[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты [[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
 тоже распознаются: <andi@splitbrain.org>.</code> тоже распознаются: <andi@splitbrain.org>.</code>
- 
  
 ==== Внутренние ==== ==== Внутренние ====
  
 Внутренние ссылки создаются посредством квадратных скобок. Внутренние ссылки создаются посредством квадратных скобок.
-Можно либо просто указать [[wiki:имя_страницы]], либо дополнительно прописать +Можно либо просто указать [[ru:pagename|имя страницы]], либо 
-[[wiki:имя_страницы|Текст ссылки]]. Имена Wiki-страниц автоматически  +дополнительно прописать [[ru:pagename|текст ссылки]]. Имена 
-переводятся в нижний регистр, спецсимволы использовать нельзя.+вики-статей автоматически  переводятся в нижний регистр, 
 +спецсимволы использовать нельзя.
  
 <code>Внутренние ссылки создаются посредством квадратных скобок. <code>Внутренние ссылки создаются посредством квадратных скобок.
-Можно либо просто указать [[Имя страницы]], либо дополнительно прописать +Можно либо просто указать [[ru:pagename]], либо 
-[[Имя страницы|Текст ссылки]]. Имена Wiki-страниц автоматически  +дополнительно прописать [[ru:pagename|текст ссылки]]. Имена 
-переводятся в нижний регистр, спецсимволы использовать нельзя.</code>+вики-статей автоматически  переводятся в нижний регистр, 
 +спецсимволы использовать нельзя.</code>
  
-Можно использовать в ссылке [[wiki:namespaces]] (пространство имёнчерез двоеточие.+Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.
  
-<code>Можно использовать в ссылке [[namespaces]] (пространство имёнчерез двоеточие.</code>+<code>Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.</code>
  
-Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку имя раздела, также как это делается в HTML. Ссылка на [[syntax#внутренние|этот раздел]].+Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так жекак это делается в HTML. Ссылка на [[#внутренние|этот раздел]].
  
-<code>Ссылка на [[syntax#внутренние|этот раздел]].</code>+<code>Ссылка на [[#внутренние|этот раздел]].</code>
  
 Примечания: Примечания:
  
-  * Ссылки на [[syntax|существующие страницы]] отображаются иначе, чем ссылки на [[wiki:несуществующие_страницы]] +  * Ссылки на [[ru:wiki:syntax|существующие статьи]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]]. 
-  * Внутренние ссылки без указанного текста могут отображаться по разному в зависимости от настроек - в качестве текста может использоваться название страницы или заголовок первого уровня((именно такая настройка используется на этом сайте)). Так что лучше каждый раз указывать текст ссылки. +  * «Докувики» по умолчанию не использует [[wp>ru:CamelCase|CamelCase]] (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле [[doku>config]]. Проверка: если DokuWiki --- ссылка, значит эта возможность включена.
-  * DokuWiki по умолчанию не использует [[wp>CamelCase]] для автоматического создания ссылок, но эту возможность можно включить в файле [[doku>wiki:config]]. Проверка: Если DokuWiki — ссылка, значит эта возможность включена.+
   * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.   * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
 +  * Ссылки на разделы делаются именно на [[#Разбивка на разделы|разделы]].
  
 +==== Интервики ====
  
 +«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки
 +на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
  
- +<code>«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки 
-==== InterWiki ==== +на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
- +
-DokuWiki поддерживает [[doku>wiki:interwiki|InterWiki]]-ссылки. Это короткие ссылки +
-на другие Wiki. Например, вот ссылка на страницу Википедии о Wiki: [[wp>Wiki]]. +
- +
-<code> +
-Например, вот ссылка на страницу Википедии о Wiki: [[wp>Wiki]].+
 </code> </code>
  
 ==== Сетевые ресурсы Windows ==== ==== Сетевые ресурсы Windows ====
  
-Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном Интранете.+Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном интранете.
  
-<code>Ссылки на виндовые шары вида \\server\share тоже распознаются.</code>+<code>Ссылки на сетевые ресурсы вида \\server\share тоже распознаются.</code>
  
 Примечания: Примечания:
  
-  * Из соображений безопасности непосредственный просмотр виндовых шар работает по умолчанию только в Internet Explorer (и только в локальной зоне). +  * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»). 
-  * В Mozilla и Firefox эту возможность можно включить с помощью опции [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], но делать это не рекомендуется.+  * В браузерах Mozilla эту возможность можно включить с помощью опции [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], но делать это не рекомендуется.
   * Подробней читайте здесь: [[bug>151]].   * Подробней читайте здесь: [[bug>151]].
- 
  
 ==== Картинки-ссылки ==== ==== Картинки-ссылки ====
  
-Совместив синтаксис ссылки и [[syntax#картинки и другие файлы|картинки]], можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:+Совместив синтаксис ссылки и [[#картинки и другие файлы|картинки]], можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:
  
-<code>[[http://www.php.net|{{dokuwiki-128.png}}]]</code>+<code>[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]</code>
  
-[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]+[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]
  
-Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.+Учтите: форматирование картинок --- это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.
  
-===== Сноски =====+==== Сноски ====
  
-С помощью двойных скобок можно добавить сноску((Это сноска)).+С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, ссылка, перевод.)).
  
-<code>С помощью двойных скобок можно добавить сноску ((Это сноска)).</code>+<code>С помощью двойных скобок можно добавить сноску((Сноска — 
 +помещаемые внизу страницы примечание, ссылка, перевод.)).</code>
  
 ===== Разбивка на разделы ===== ===== Разбивка на разделы =====
  
-Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков 3-го уровня и выше, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%.+Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%.
  
  
 +==== Заголовок 3 уровня ====
 +=== Заголовок 4 уровня ===
 +== Заголовок 5 уровня ==
  
-==== Заголовок 3-го уровня ==== +<code>==== Заголовок 3 уровня ==== 
-=== Заголовок 4-го уровня === +=== Заголовок 4 уровня === 
-== Заголовок 5-го уровня == +== Заголовок 5 уровня ==</code>
- +
-<code>==== Заголовок 3-го уровня ==== +
-=== Заголовок 4-го уровня === +
-== Заголовок 5-го уровня ==</code>+
  
 Четыре и более тире преобразуются в горизонтальную черту: Четыре и более тире преобразуются в горизонтальную черту:
  
 ---- ----
-\\ 
  
-<code> +===== Картинки и другие файлы =====
----- +
-</code>+
  
 +См. также: «[[ru:images|Работа с изображениями и медиафайлами]]».
  
-===== Картинки и другие файлы ===== +С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:images|картинки]]. По желанию можно указать их размер.
- +
-С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[doku>wiki:images|картинки]]. По желанию можно указать их размер.+
  
 Нормальный размер:                        {{wiki:dokuwiki-128.png}} Нормальный размер:                        {{wiki:dokuwiki-128.png}}
Строка 158: Строка 148:
 Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}} Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}}
  
-Отмасштабированная до заданных размеров:{{wiki:dokuwiki-128.png?200x50}}+Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}}
  
-Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}+Отмасштабированная внешняя картинка:      {{https://www.php.net/images/php.gif?200x50}}
  
 <code> <code>
-Нормальный размер:                        {{dokuwiki-128.png}} +Нормальный размер:                        {{wiki:dokuwiki-128.png}} 
-Отмасштабированная до заданной ширины:    {{dokuwiki-128.png?50}} +Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}} 
-Отмасштабированная до заданных размеров:  {{dokuwiki-128.png?200x50}} +Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}} 
-Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}+Отмасштабированная внешняя картинка:      {{https://www.php.net/images/php.gif?200x50}}
 </code> </code>
  
-Поставив слева или справа пробел можно задать выравнивание картинки:+Поставив слева или справа пробелможно задать выравнивание картинки:
  
 {{wiki:dokuwiki-128.png }} {{wiki:dokuwiki-128.png }}
Строка 175: Строка 165:
 {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
  
-<code>{{dokuwiki-128.png }} +<code>{{wiki:dokuwiki-128.png }} — картинка слева 
-{{ dokuwiki-128.png}} +{{ wiki:dokuwiki-128.png }} — посередине 
-{{ dokuwiki-128.png }}+{{ wiki:dokuwiki-128.png}} — справа
 </code> </code>
  
 И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки). И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).
  
-{{ wiki:dokuwiki-128.png |Название картинки}}+{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}
  
-<code>{{ dokuwiki-128.png |Название картинки}}</code>+<code>{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}</code>
  
-Если задать имя файла (внутреннее или внешнее), который не является картинкой (''gif, jpeg, png''), оно будет отображаться в виде ссылки.+Узнать, как вставить картинку со ссылкой можно в [[#картинки-ссылки|разделе выше]].
  
 +==== Поддерживаемые форматы медиа ====
  
 +«Докувики» поддерживает следующие форматы данных:
 +
 +| Изображение | ''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'', «Докувики» автоматически добавит их в качестве альтернативных файлов, чтобы один из трех файлов был понятен вашему браузеру.
 +
 +Кроме того, «Докувики» поддерживает изображение "poster", которое будет показано перед запуском видео. Это изображение должно иметь то же имя, что и видео, и быть в формате jpg или png. В приведенном выше примере подойдет файл ''video.jpg''.
  
  
 ===== Списки ===== ===== Списки =====
  
-Dokuwiki поддерживает нумерованные и ненумерованные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом * в случае ненумерованного списка, или - в случае нумерованного.+«Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*в случае маркированного списка, или дефис (-) --- в случае нумерованного.
  
-  * Это список+  * Первый элемент маркированного списка
     * Второй элемент списка     * Второй элемент списка
       * Можно сделать вложенный список       * Можно сделать вложенный список
Строка 201: Строка 218:
  
   - Тот же список, только нумерованный   - Тот же список, только нумерованный
-  - Ещё элемент +    - Ещё элемент 
-    - Чем больше пробелов в начале, тем глубже вложенность +      - Чем больше пробелов в начале, тем глубже вложенность 
-  - Всё просто+    - Всё просто
  
 <code> <code>
-  * Это список+  * Первый элемент маркированного списка
     * Второй элемент списка     * Второй элемент списка
       * Можно сделать вложенный список       * Можно сделать вложенный список
Строка 212: Строка 229:
  
   - Тот же список, только нумерованный   - Тот же список, только нумерованный
-  - Ещё элемент +    - Ещё элемент 
-    - Чем больше пробелов в начале, тем глубже вложенность +      - Чем больше пробелов в начале, тем глубже вложенность 
-  - Всё просто+    - Всё просто
 </code> </code>
  
 +См. также [[ru:faq:lists|FAQ по элементам списка]].
  
 ===== Смайлики ===== ===== Смайлики =====
  
-DokuWiki преобразует наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию ''smiley'' и внести изменения в файл ''conf/smileys.conf''. Вот смайлики, которые есть в DokuWiki:+«Докувики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию ''smiley'' и добавить их в файл ''conf/smileys.local.conf''. Вот смайлики, которые есть в «Докувики»:
  
   * 8-) %%8-)%%   * 8-) %%8-)%%
Строка 243: Строка 260:
   * FIXME %%FIXME%%   * FIXME %%FIXME%%
   * DELETEME %%DELETEME%%   * DELETEME %%DELETEME%%
- 
- 
  
 ===== Типографские символы ===== ===== Типографские символы =====
  
-DokuWiki может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.+«Докувики» может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.
  
--> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r)\\ +-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...\\ 
-"Владимир Владимирович(tm) --- это наше всё (c) не я"+"Александр Сергеевич(tm) --- это наше всё (c) не я"
  
 <code> <code>
--> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) +-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ... 
-"Владимир Владимирович(tm) --- это наше всё (c) не я"+"Александр Сергеевич(tm) --- это наше всё (c) не я"
 </code> </code>
  
-Примечание: Это конвертирование можно отключить в файле конфигурации.\\ +Примечание: это конвертирование можно отключить в файле конфигурации ''[[ru:entities|conf/entities.conf]]''.
-Примечание 2: Если потребуется вставить двойные кавычки (%%"%% или ''%%"%%''), например как знак дюйма :-), можно их экранировать ''<nowiki>%%</nowiki>''+
-  %%"%% или ''%%"%%'' +
- +
  
 ===== Цитирование ===== ===== Цитирование =====
  
-Иногда нужно пометить некоторый текст в качестве ответа или комментарияДля этого можно использовать следующий синтаксис:+Иногда требуется пометить какой-либо текст, чтобы показать, что это ответ или комментарийВы можете использовать следующий синтаксис:
  
-  Я думаю, мы должны это сделать. +<code> 
-  > Нет, мы не должны. +Я думаю, мы должны это сделать 
-  >> Ну, я говорю, что мы должны. + 
-  > Действительно? +> Нет, не должны 
-  >> Да+ 
-  >>> Тогда сделаем это!+>> Ну, а я говорю, что должны 
 + 
 +Правда?
  
-Я думаю, мы должны это сделать. 
-> Нет, мы не должны. 
->> Ну, я говорю, что мы должны. 
-> Действительно? 
 >> Да! >> Да!
->>> Тогда сделаем это!+ 
 +>>> Тогда давайте сделаем это! 
 +</code> 
 + 
 +Я думаю, мы должны это сделать 
 + 
 +> Нет, не должны 
 + 
 +>> Ну, а я говорю, что должны 
 + 
 +> Правда? 
 + 
 +>> Да! 
 + 
 +>>> Тогда давайте сделаем это!
  
 ===== Таблицы ===== ===== Таблицы =====
  
-DokuWiki поддерживает упрощённый синтаксис создания таблиц.+«Докувики» поддерживает упрощённый синтаксис создания таблиц.
  
-^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            +^ Заголовок 1      ^ Заголовок 2                                                            ^ Заголовок 3      
-| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        +| Ряд 1 Колонка 1  | Ряд 1 Колонка 2                                                        | Ряд 1 Колонка 3  
-| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  || +| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)                    || 
-| Ряд 3 Колонка 1  | Ряд Колонка 2     | Ряд Колонка 3        |+| Ряд 3 Колонка 1  | Ряд Колонка 2                                                        | Ряд Колонка 3  |
  
-Нормальные ряды должны начинаться и заканчиваться символом |, а заголовки — ^.+Обычные ряды должны начинаться и заканчиваться вертикальной чертой --- %%|%%, а заголовки «крышечкой» (циркумфлекс) — %%^%%.
  
-<code> +  ^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^ 
-^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^ +  | Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        | 
-| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        | +  | Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  || 
-| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  || +  | Ряд 3 Колонка 1  | Ряд Колонка 2     | Ряд Колонка 3        |
-| Ряд 3 Колонка 1  | Ряд Колонка 2     | Ряд Колонка 3        | +
-</code>+
  
-Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток было одинаковым!+Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток было одинаковым.
  
-Вертикальные заголовки тоже можно сделать.+Вертикальные заголовки тоже можно сделать:
  
-|              ^ Заголовок 1       ^ Заголовок 2      ^ +|              ^ Заголовок 1      ^ Заголовок 2      ^ 
-^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  | +^ Заголовок 3  | Ряд 1 Колонка 2  | Ряд 1 Колонка 3  | 
-^ Заголовок 4  | Объединения нет   |                  | +^ Заголовок 4  | Объединения нет  |                  | 
-^ Заголовок 5  | Ряд Колонка 2   | Ряд Колонка 3  |+^ Заголовок 5  | Ряд Колонка 2  | Ряд Колонка 3  |
  
-Как легко увидеть, разделитель стоящий перед клеткой определяет форматирование:+Как легко увидеть, разделительстоящий перед клеткойопределяет форматирование:
  
-<code> +  |              ^ Заголовок 1       ^ Заголовок 2      ^ 
-|              ^ Заголовок 1       ^ Заголовок 2      ^ +  ^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  | 
-^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  | +  ^ Заголовок 4  | Объединения нет                    | 
-^ Заголовок 4  | Объединения нет                    | +  ^ Заголовок 5  | Ряд Колонка 2   | Ряд Колонка 3  |
-^ Заголовок 5  | Ряд Колонка 2   | Ряд Колонка 3  | +
-</code>+
  
 Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий '':::'' в объединяемые нижележащие ячейки. Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий '':::'' в объединяемые нижележащие ячейки.
  
-^ Заголовок 1        ^ Заголовок 2                       ^ Заголовок 3            +^ Заголовок 1      ^ Заголовок 2                        ^ Заголовок 3      
-| Ряд 1 Колонка 1    | эта ячейка объединена вертикально | Ряд 1 Колонка 3        +| Ряд 1 Колонка 1  | эта ячейка объединена вертикально  | Ряд 1 Колонка 3  
-| Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        +| Ряд 2 Колонка 1  | :::                                | Ряд 2 Колонка 3  
-| Ряд 3 Колонка 1    | :::                               | Ряд Колонка 3        |+| Ряд 3 Колонка 1  | :::                                | Ряд Колонка 3  |
  
 В этих ячейках не должно быть ничего, кроме синтаксиса объединения ('':::''). В этих ячейках не должно быть ничего, кроме синтаксиса объединения ('':::'').
Строка 330: Строка 350:
   | Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        |   | Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        |
   | Ряд 3 Колонка 1    | :::                               | Ряд 2 Колонка 3        |   | Ряд 3 Колонка 1    | :::                               | Ряд 2 Колонка 3        |
-   + 
-Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа – если надо выравнять влево, и по два с каждой стороны — если по центру. +Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру. 
  
 ^           Таблица с выравниванием        ^^^ ^           Таблица с выравниванием        ^^^
Строка 342: Строка 362:
   |влево                вправо|   по центру  |   |влево                вправо|   по центру  |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
 +
 +Примечание: вертикальное выравнивание не поддерживается.
  
 ===== Неформатируемые блоки ===== ===== Неформатируемые блоки =====
  
-Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги ''%%<code>%%'' или ''%%<file>%%''. При этом пробелы в начале строки являются эквивалентом применения тега ''%%<code>%%'' к одной строке, но без подсветки кода. Если несколько подряд идущих строк начинаются более чем с одного пробела, они объединяются в один блок ''%%<code>%%''.+Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги ''%%<code>%%'' или ''%%<file>%%''.
  
-Пример использования ''%%<code>%%''..''%%</code>%%''. 
 <code>Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.</code> <code>Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.</code>
  
-Пример использования ''%%<file>%%''..''%%</file>%%''+<file>В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.</file>
-<file>В принципе то же самое, но этим выделением можно показать,  +
-что цитируется содержимое файла.</file>+
  
-Чтобы парсер полностью проигнорировал некий текст (т.е. не форматировал его), либо заключите его в тэги ''%%<nowiki>%%'', либо ещё проще — в двойные знаки процента ''<nowiki>%%</nowiki>''.+Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги ''nowiki'', либо ещё проще --- в двойные знаки процента ''<nowiki>%%</nowiki>''.
  
-Это просто текст, в котором есть адрес %%http://www.splitbrain.org%% +Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%% 
 и %%**форматирование**%% --- но ничего не происходит. и %%**форматирование**%% --- но ничего не происходит.
  
-<code>Это просто текст, в котором есть адрес %%http://www.splitbrain.org%% +<code>Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%
 и %%**форматирование**%% --- но ничего не происходит.</code> и %%**форматирование**%% --- но ничего не происходит.</code>
  
 Чтобы увидеть, как используются эти блоки, смотрите код страницы. Чтобы увидеть, как используются эти блоки, смотрите код страницы.
  
 +===== Подсветка синтаксиса =====
  
 +«Докувики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''code'' в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%.
  
-===== Подсветка синтаксиса ===== 
- 
-DokuWiki может подсвечивать <hi>программный код</hi>, чтобы его было проще читать. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''code'' в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%. 
-<code> 
-<hi>текст</hi> 
-</code> 
 <code java> <code java>
 /**  /** 
Строка 384: Строка 399:
 </code> </code>
  
-[[doku>ru:wiki:syntax#подсветка_синтаксиса|Перейдя по ссылке]] можно посмотреть поддерживаемые языки.+На данный момент распознаются следующие языки: 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,  rpmspec,  rsplus,  ruby,  rust,  sas,  sass,  scala,  scheme,  scilab,  scl,  sdlbasic,  smalltalk,  smarty,  spark,  sparql,  sql,  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,  xbasic,  xml,  xojo,  xorg_conf,  xpp,  yaml,  z80,  zxbasic.
  
 ==== Скачиваемые блоки кода ==== ==== Скачиваемые блоки кода ====
 +
 Используя тэги ''%%<code>%%'' или ''%%<file>%%'', как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так: Используя тэги ''%%<code>%%'' или ''%%<file>%%'', как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:
  
Строка 399: Строка 415:
 </file> </file>
  
-Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (''-'') на месте кода языка: ''%%<code - myfile.foo>%%''.+Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (дефис) (''-'') на месте кода языка: ''%%<code - myfile.foo>%%''. 
 + 
 +**Особенность:** при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками. Например, %%"Фоо Бар.php"%%. 
 +<file php "Фоо Бар.php"> 
 +<?php echo "hello world!"; ?> 
 +</file>
  
 ===== Вставка HTML и PHP ===== ===== Вставка HTML и PHP =====
  
-Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов ''html'' и ''php'':+Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов ''html'' и ''php''. Используйте заглавные буквы для блочных элементов.
  
 <code html> <code html>
 <html> <html>
-Тут вставлен <font color="red" size="+1">HTML-код</font>+Тут вставлен <font color="red" size="+1">код HTML</font>
 </html> </html>
 +
 +<HTML>
 +<p style="border:2px dashed red;">И здесь блочная вставка HTML</p>
 +</HTML>
 </code> </code>
 +
 +Получается:
  
 <html> <html>
Строка 415: Строка 442:
 </html> </html>
  
-<code php>+<HTML> 
 +<p style="border:2px dashed red;">И здесь блочная вставка HTML</p> 
 +</HTML> 
 + 
 +---- 
 + 
 +<code>
 <php> <php>
-echo 'Логотип, сгенерированный PHP:'; +echo 'Версия PHP: '
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';+echo phpversion()
 +echo ' (прямая вставка в HTML).';
 </php> </php>
 +
 +<PHP>
 +echo '<table class="inline"><tr><td>То же самое — в элементе блочного уровня:</td>';
 +echo '<td>'.phpversion().'</td>';
 +echo '</tr></table>';
 +</PHP>
 </code> </code>
 +
 +Получается:
  
 <php> <php>
-echo 'Логотип, сгенерированный PHP:'; +echo 'Версия PHP: '
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';+echo phpversion()
 +echo ' (прямая вставка в HTML).';
 </php> </php>
  
-**Примечание**: по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.+<PHP> 
 +echo '<table class="inline"><tr><td>То же самое — в элементе блочного уровня:</td>'; 
 +echo '<td>'.phpversion().'</td>'; 
 +echo '</tr></table>'; 
 +</PHP>
  
-===== Управляющие макросы =====+**Примечание:** по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.
  
-Некоторый синтаксис влияет на то, как «ДокуВики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:+===== RSS/ATOM Feed Aggregation =====
  
-^ Макрос          ^ Описание      | +===== Агрегация каналов RSS/ATOM =====
-| %%~~NOTOC~~%%   | Если этот макрос присутствует в статье, оглавление не будет создано. +
-| %%~~NOCACHE~~%% | «ДокуВики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис %%<php>%%), добавление этого макроса заставит «ДокуВики» обрабатывать статью при каждом вызове.  |+
  
-===== Интеграция с RSS/ATOM фидами  =====+Докувики может интегрировать данные из внешних XML-каналов. Для анализа XML-каналов, используется [[http://simplepie.org/|SimplePie]]. Все форматы, понятные SimplePie, также могут быть использованы в Докувики. Вы можете влиять на рендеринг с помощью нескольких дополнительных параметров, разделенных пробелами:
  
-DokuWiki может отображать на своих страницах данные из внешних XML-фидов. Для парсинга XML-фидов используется библиотека [[http://simplepie.org/|SimplePie]], соответственно, все форматы, распознаваемые этой библиотекой поддерживаются в DokuWiki. Вывод информации можно настроить, используя следующие параметры (параметры надо разделять пробелами):+^ Параметр  ^ Описание ^ 
 +| any number | Отображается максимальное количество элиментовпо умолчанию 8 | 
 +| reverse    | Сначала отобразите последние элементы в ленте 
 +| author     | Показывать имена авторов элементов | 
 +| date       | Показывать даты элиментов 
 +| description| Покажите описание элиментов. Если HTML отключенвсе теги будут удалены 
 +| nosort     | Не сортируйте элементы в ленте | 
 +| //n//[dhm] | Период обновления, где d=дни, h=часы, m=минуты. (например 12h = 12 часов). |
  
-Параметр ^ Описание ^ +Период обновления по умолчанию равен 4 часам. Любое значение ниже 10 минут будет рассматриваться как 10 минут. Докувики обычно пытается предоставить кэшированную версию страницы, очевидно, что это неуместнокогда страница содержит динамический внешний контент. Параметр указывает Докувики повторно отобразить страницуесли прошло больше //периода обновления// с момента последнего отображения страницы.
-| любое число | максимальное кол-во отображаемых элементов, по умолчанию - 8 | +
-| reverse    | вывести список новостей в обратном порядке - самые старые записи выводятся первыми | +
-| author     | показывать имена авторов (если указаны в фиде) | +
-| date       | показывать даты записей (если указаны в фиде) | +
-| description| показывать описание записи. Если в настройках DokuWiki выключено отображение HTML кодов, то из описания будут удалены все HTML коды | +
-//n//[dhm] | период обновления фида, где d=дни, h=часы, m=минуты. (т.е. 12h = 12 часов, а 2d = 2 дня)|+
  
-По умолчанию период обновления равен 4 часам. Если указать значение меньше 10 минут, то DokuWiki всё-равно будет обновлять не чаще, чем раз в 10 минутПо умолчанию DokuWiki выдаёт пользователю сохранённую версию страницы, однако указание периода обновления фида приводит к повторному рендерингу страницы.+По умолчанию лента будет отсортирована по дате, сначала по самым новым элементам. Вы можете сначала отсортировать его по возрастуиспользуя параметр "reverse", или отобразить ленту как есть с "nosort".
  
 **Пример:** **Пример:**
  
-  {{rss>http://wsrss.bbc.co.uk/russian/index.xml 7 author date 10h }}+  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
  
-{{rss>http://wsrss.bbc.co.uk/russian/index.xml 7 author date 10h }}+{{rss>http://slashdot.org/index.rss 5 author date 1h }} 
 +===== Управляющие макросы =====
  
-====== Дополнительное форматирование (синтаксические плагины) ======+Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:
  
-Синтаксис «ДокуВики» может быть расширен за счёт [[doku>plugins|плагинов]].  +^ Макрос          ^ Описание      | 
-Как их устанавливать и использовать --- описывается на страницах описания. На этом сайте установлены следующие модуликоторые расширяют стандартное форматирование DokuWiki:+| %%~~NOTOC~~%%   | Если этот макрос присутствует в статье, оглавление не будет создано. 
 +| %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис %%<php>%%), добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове.  |
  
-~~INFO:syntaxplugins~~+===== Синтаксические плагины =====
  
-===== Выделение цветом аркер) =====+Синтаксис «Докувики» может быть расширен за счёт [[ru:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:
  
-Текст можно выделять цветом. +~~INFO:syntaxplugins~~
-<hi>Цвет по умолчанию</hi> может быть заменён на какой-либо другой,  +
-например <hi red>красный</hi> или <hi lightblue>голубой</hi>+
- +
-<code> +
-Текст можно выделять цветом. +
-<hi>Цвет по умолчанию</hi> может быть заменён на какой-либо другой,  +
-например <hi red>красный</hi> или <hi lightblue>голубой</hi>+
-</code> +
- +
-===== Форматирование химических формул ===== +
- +
-С помощью плагина **chem** простые химические формулы форматируются автоматически, например: <chem>10C2H5OH, 2H3PO4, Al(OH)3, Fe3+, 15[Cat]3|2+[Anion]2|3-, 238^Pu, N0, N+1, N-3, e-</chem> +
- +
-  <chem>10C2H5OH, 2H3PO4, Al(OH)3, Fe3+, 15[Cat]3|2+[Anion]2|3-, 238^Pu, N0, N+1, N-3, e-</chem> +
- +
- +
- +
-===== Заметки ===== +
- +
-Плагин **Note** позволяет легко оформлять всевозможные комментарии и заметки: +
- +
-<note>обычная заметка  </note> +
-<note tip>заметка-подсказка</note> +
-<note important>важная заметка</note> +
-<note warning>заметка-предупреждение</note> +
- +
-<code> +
-<note>обычная заметка</note> +
-<note tip>заметка-подсказка</note> +
-<note important>важная заметка</note> +
-<note warning>заметка-предупреждение</note> +
-</code> +
- +
-ссылка на плагин: [[http://www.dokuwiki.org/plugin:note]] +
- +
-~~DISCUSSION:off~~+
ru/intro/syntax.txt · Последнее изменение: boris_r