Различия

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

--- system:синтаксис_форматирования_страниц [2015/07/02 17:34]
admin создано
+++ system:синтаксис_форматирования_страниц [2015/07/03 00:27] (текущий)
admin
@@ Строка 1: / Строка 1: @@
-====== Пространства имён ======
+====== Синтаксис форматирования ======
-В «[[dokuwiki|Докувики]]» вы можете использовать так называемые «пространства имён» или «именованные пространства» для упорядочивания ваших статей.((На сервере, который обслуживает «ДокуВики», пространство имён — это обычная директория, в которой находятся текстовые файлы — статьи «ДокуВики».))
+«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[ru:toolbar|панели инструментов]].
-===== Создание пространства имён =====
+===== Основные конструкции форматирования =====
-Для создания пространств имён не нужно предпринимать каких-то специальных действий: просто используйте двоеточие «:» в [[pagename|названиях статей]]. Часть названия после последнего двоеточия станет названием статьи (файла), а всё, что находится «до», станет именным пространством (последовательностью вложенных директорий). Если такого именного пространства ещё нет, оно создастся автоматически.
+«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**.
-^   Примеры ^^
+<code>
-|example\\ .example\\ .:example  |Статья «example» находится в **текущем** именном пространстве.  |
+«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//,
-|:example  |Статья «example» находится в **корневом** именном пространстве.  |
+__подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''.
-|..example\\ ..:example\\ .:..:example  |Статья «example» находится в **родительском** именном пространстве (директории на уровень выше).  |
+Все эти конструкции можно **__//''объединить''//__**.
-|wiki:example  |Статья «example» находится в именном пространстве «wiki». Именное пространство «wiki» вложено в **корневое** именное пространство.  |
+</code>
-|ns1:ns2:example\\ :ns1:ns2:example  |Статья «example» находится в именном пространстве «ns2». Пространство «ns2» расположено в пространстве «ns1», которое, в свою очередь, лежит в **корневом** именном пространстве. |
-|.ns1:ns2:example\\ .:ns1:ns2:example |Статья «example» находится в именном пространстве «ns2». Пространство «ns2» расположено в пространстве «ns1», лежащем, в свою очередь, в **текущем** именном пространстве.  |
-|..ns1:ns2:example\\ ..:ns1:ns2:example  |Ссылается на статью <<example>> в именном пространстве <<ns2>>. Пространство <<ns2>> расположено ниже пространства <<ns1>>; пространство <<ns1>> расположено на том же уровне, что и **текущее** именное пространство (таким образом **текущее** пространство и пространство <<ns1>> находятся ниже одного и того же **родительского** пространства).|
-|.ns1:ns2:  |Ссылается на страницу «start» в именном пространстве «ns2». Именное пространство «ns2» расположено в  именном пространстве «ns1», лежащем, в свою очередь, в текущем именном пространстве((Статья по умолчанию может называться не только «start», для этого надо указать нужное значение в [[config|настройках «ДокуВики»]].)).  |
-===== Удаление  пространства имён =====
+Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.
-Если все статьи внутри пространства имён удалены, это пространство имён логически перестаёт существовать. «ДокуВики» обычно удаляет соответствующую ему пустую директорию.
+<code>
+Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.
+</code>
-===== Как переименовать пространство имён? =====
+Ещё можно <del>зачеркнуть текст</del>.
-==== Ручной способ ====
+<code>
+Ещё можно <del>зачеркнуть текст</del>.
+</code>
-Для того, чтобы переименовать пространство имён вручную, вам придется сделать следующее:
+**Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.
-  * Переименовать директории, которые представляют данное пространство имён в:
-    * ''data/pages''
-    * ''data/media'' (если есть)
-  * Удалить метаданные этого пространства имён в ''data/meta''
-  * Удалить данные [[attic]] этого пространства имён в ''data/attic'' (или целиком переместить в другое место, если вы хотите сохранить старые версии)
-Например, на Unix-сервере вы можете:
+Просто текст с разрывом строк\\ Обратите внимание,
+что два обратных слэша действуют только в конце строки\\
+или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.
-  * ''mv /dokuwiki_base/data/pages/old_namespace /dokuwiki_base/data/pages/new_namespace''
+<code>Просто текст с разрывом строк\\ Обратите внимание,
-  * ''mv /dokuwiki_base/data/media/old_namespace /dokuwiki_base/data/media/new_namespace''
+что два обратных слэша действуют только в конце строки\\
-  * ''rm -Rf /dokuwiki_base/data/meta/old_namespace''
+или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.
-  * ''rm -Rf /dokuwiki_base/data/attic/old_namespace''
+</code>
-Обратите внимание, что возможно имена ''old_namespace'' и/или ''new_namespace'' могут быть конвертированы, если они не входят набор символов Latin (т. е. греческий, русский и т. д.).
+Принудительные переносы следует использовать только в случае крайней необходимости.
-  * Поправьте, отредактировав, все ссылки на статью в //перемещённом// пространстве имён (вы можете отыскать их перед переименованием пространства имен, просмотрев [[backlinks|обратные ссылки]] во всех статьях данного пространства.
+===== Ссылки =====
-  * Просмотрите все статьи в новом пространстве имён. Это создаст отсутствующую индексную информацию и метаданные для статей перемещённого пространства имён.
+Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному.
-Однако у вас все ещё останется достаточно всякого «хлама». Например, в ''data/changes.log'', различные файлы в кэше (включая файлы ''.idx'' и пр.). Если возможно, можете начать с «чистого состояния» как показано ниже (опять же под Unix), но предупреждаем, что это приведёт к потере всей «исторической» информации (такой как «последние изменения»):
+==== Внешние ====
-  * ''cat /dev/null > /dokuwiki_base/data/changes.log''
+Внешние ссылки распознаются автоматически: http://www.google.com или
-  * ''rm -Rf /dokuwiki_base/data/attic/*''
+просто www.google.com --- также можно указывать текст ссылки:
-  * ''rm -Rf /dokuwiki_base/data/cache/?''
+[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
-  * ''rm -Rf /dokuwiki_base/data/cache/*.idx''
+тоже распознаются: <[email protected]>.
-  * ''rm -Rf /dokuwiki_base/data/cache/purgefile''
-  * Просмотрите все статьи в вашей вики.
-**Оговорка:** Я понимаю, что это весьма замысловато (и, возможно, я пропустил или перепутал пару вещей, которые нужно было сделать). В конце концов всё это --- PITA((Шило в заднице.)). Вы также можете использовать пару доступных [[plugins|плагинов]] для построения/перестройки поисковых индексов всей вики, очистки содержимого кэша и/или старых версий, что избавит вас от ручной работы.
+<code>Внешние ссылки распознаются автоматически: http://www.google.com или
+просто www.google.com --- также можно указывать текст ссылки:
+[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
+тоже распознаются: <andi@splitbrain.org>.</code>
-==== Способ с использованием плагинов ====
+==== Внутренние ====
-Вы можете использовать сторонний плагин [[:plugin:PageMove]]((Плагин не совместим с версий «Лемминг».)) для переноса каждой страницы из старого пространства имён в новое. Пожалуйста, обратитесь к документации, чтобы убедиться, что это то, что вам нужно.
+Внутренние ссылки создаются посредством квадратных скобок.
+Можно либо просто указать [[ru:pagename|имя страницы]], либо
+дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
+вики-статей автоматически  переводятся в нижний регистр,
+спецсимволы использовать нельзя.
-===== Ссылки по умолчанию в пространстве имён =====
+<code>Внутренние ссылки создаются посредством квадратных скобок.
+Можно либо просто указать [[ru:pagename|имя страницы]], либо
+дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
+вики-статей автоматически  переводятся в нижний регистр,
+спецсимволы использовать нельзя.</code>
-Можно задавать ссылку на файл по умолчанию для пространства имён, заканчивая ссылку двоеточием: %%[[foo:bar:]]%%. На какую статью указывает ссылка, зависит от наличия файлов с определёнными именами. Для %%[[foo:bar:]]%% проверяется существование следующих страниц:
+Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.
+<code>Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.</code>
+Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на [[#внутренние|этот раздел]].
+<code>Ссылка на [[#внутренние|этот раздел]].</code>
+Примечания:
+  * Ссылки на [[ru:wiki:syntax|существующие статьи]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]].
+  * «Докувики» по умолчанию не использует [[wp>ru:CamelCase|CamelCase]] (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле [[ru:config]]. Проверка: если DokuWiki --- ссылка, значит эта возможность включена.
+  * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
+  * Ссылки на разделы делаются именно на [[#Разбивка на разделы|разделы]].
+==== Интервики ====
+«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки
+на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
+<code>«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки
+на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
+</code>
+==== Сетевые ресурсы Windows ====
+Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном интранете.
+<code>Ссылки на сетевые ресурсы вида \\server\share тоже распознаются.</code>
+Примечания:
+  * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»).
+  * В браузерах Mozilla эту возможность можно включить с помощью опции [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], но делать это не рекомендуется.
+  * Подробней читайте здесь: [[bug>151]].
+==== Картинки-ссылки ====
+Совместив синтаксис ссылки и [[#картинки и другие файлы|картинки]], можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:
+<code>[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]</code>
+[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]
+Учтите: форматирование картинок --- это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.
+==== Сноски ====
+С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, ссылка, перевод.)).
+<code>С помощью двойных скобок можно добавить сноску((Сноска —
+помещаемые внизу страницы примечание, ссылка, перевод.)).</code>
+===== Разбивка на разделы =====
+Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%.
+==== Заголовок 3-го уровня ====
+=== Заголовок 4-го уровня ===
+== Заголовок 5-го уровня ==
+<code>==== Заголовок 3-го уровня ====
+=== Заголовок 4-го уровня ===
+== Заголовок 5-го уровня ==</code>
+Четыре и более тире преобразуются в горизонтальную черту:
+----
+===== Картинки и другие файлы =====
+См. также: «[[system:images|Работа с изображениями и медиафайлами]]».
+С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:images|картинки]]. По желанию можно указать их размер.
+Нормальный размер:                        {{wiki:dokuwiki-128.png}}
+Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}}
+Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}}
+Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}
 <code>
-foo:bar:$conf['start']
+Нормальный размер:                        {{wiki:dokuwiki-128.png}}
-foo:bar:bar
+Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}}
-foo:bar
+Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}}
+Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}
 </code>
-Статьи проверяются в этом порядке и ссылка указывает на первую найденную.
+Поставив слева или справа пробел, можно задать выравнивание картинки:
-Множественное связывание не производится для таких ссылок((Autoplural linking is not done for those links.)).
+{{wiki:dokuwiki-128.png }}
+{{ wiki:dokuwiki-128.png}}
+{{ wiki:dokuwiki-128.png }}
+<code>{{wiki:dokuwiki-128.png }} — картинка слева
+{{ wiki:dokuwiki-128.png }} — посередине
+{{ wiki:dokuwiki-128.png}} — справа
+</code>
+И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).
+{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}
+<code>{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}</code>
+Если задать имя файла (внутреннее или внешнее), который не является картинкой (''gif, jpeg, png''), оно будет отображаться в виде ссылки.
+Узнать, как вставить картинку со ссылкой можно в [[#картинки-ссылки|разделе выше]].
+===== Списки =====
+«Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или дефис (-) --- в случае нумерованного.
+  * Первый элемент маркированного списка
+    * Второй элемент списка
+      * Можно сделать вложенный список
+    * Ещё один элемент
+  - Тот же список, только нумерованный
+    - Ещё элемент
+      - Чем больше пробелов в начале, тем глубже вложенность
+    - Всё просто
+<code>
+  * Первый элемент маркированного списка
+    * Второй элемент списка
+      * Можно сделать вложенный список
+    * Ещё один элемент
+  - Тот же список, только нумерованный
+  - Ещё элемент
+    - Чем больше пробелов в начале, тем глубже вложенность
+  - Всё просто
+</code>
+См. также [[ru: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) не я"
+<code>
+-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...
+"Владимир Владимирович(tm) --- это наше всё (c) не я"
+</code>
+Примечание: это конвертирование можно отключить в файле конфигурации ''[[ru:entities|conf/entities.conf]]''.
+===== Таблицы =====
+«Докувики» поддерживает упрощённый синтаксис создания таблиц.
+^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
+| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
+| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  ||
+| Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |
+Нормальные ряды должны начинаться и заканчиваться вертикальной чертой --- %%|%%, а заголовки «крышечкой» — %%^%%.
+  ^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
+  | Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
+  | Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  ||
+  | Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 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        |
+Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру.
+^           Таблица с выравниванием        ^^^
+|        вправо|   по центру  |влево         |
+|влево         |        вправо|   по центру  |
+| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
+  ^           Таблица с выравниванием        ^^^
+  |        вправо|   по центру  |влево         |
+  |влево         |        вправо|   по центру  |
+  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
+Примечание: вертикальное выравнивание не поддерживается.
+===== Неформатируемые блоки =====
+Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги ''%%<code>%%'' или ''%%<file>%%''.
+<code>Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.</code>
+<file>В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.</file>
+Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги ''nowiki'', либо ещё проще --- в двойные знаки процента ''<nowiki>%%</nowiki>''.
+Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%
+и %%**форматирование**%% --- но ничего не происходит.
+<code>Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%
+и %%**форматирование**%% --- но ничего не происходит.</code>
+Чтобы увидеть, как используются эти блоки, смотрите код статьи.
+===== Подсветка синтаксиса =====
+«Докувики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''code'' в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%.
+<code java>
+/**
+ * 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.
+    }
+}
+</code>
+На данный момент распознаются следующие языки: 4cs;, **a**bap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, **b**ash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, **c**, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, **d**, dcs, delphi, diff, div, dos, dot, **e**cmascript, eiffel, email, erlang, **f**o, fortran, freebasic, fsharp, **g**ambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, **h**askell, hicest, hq9plus, html, **i**con, idl, ini, inno, intercal, io, **j**, java5, java, javascript, jquery, **k**ixtart, klonec, klonecpp, **l**atex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, **m**68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, **n**ewlisp, nsis, **o**beron2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, **p**ascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, **q**, qbasic, **r**ails, rebol, reg, robots, rpmspec, rsplus, ruby, **s**as, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, **t**cl, teraterm, text, thinbasic, tsql, typoscript, **u**nicon, **v**ala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, **w**hitespace, winbatch, whois, **x**basic, xml, xorg_conf, xpp, **z**80.
+==== Скачиваемые блоки кода ====
+Используя тэги ''%%<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>%%''.
+**Особенность:** при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками например "Фоо Бар.php".
+<file php "Фоо Бар.php">
+<?php echo "hello world!"; ?>
+</file>
+===== Вставка HTML и PHP =====
+Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов ''html'' ((''html'' --- для строчного кода; ''HTML'' --- для блочного кода)) и ''php'':
+<code html>
+<html>
+Тут вставлен <font color="red" size="+1">HTML-код</font>
+</html>
+</code>
+<html>
+Тут вставлен <font color="red" size="+1">HTML-код</font>
+</html>
+<code php>
+<php>
+echo 'Логотип, сгенерированный PHP:';
+echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';
+</php>
+</code>
+<php>
+echo 'Логотип, сгенерированный PHP:';
+echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';
+</php>
+**Примечание**: по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.
+===== Управляющие макросы =====
+Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:
+^ Макрос          ^ Описание      |
+| %%~~NOTOC~~%%   | Если этот макрос присутствует в статье, оглавление не будет создано.  |
+| %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис %%<php>%%), добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове.  |
+===== Синтаксические плагины =====
+Синтаксис «Докувики» может быть расширен за счёт [[ru:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:
+~~INFO:syntaxplugins~~
-:!: **Это свойство доступно только в версиях 2006-09-28 RC1 и выше.**

antclub.org wiki

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

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

Различия

Инструменты страницы