Knowledge WiKibase

…collecting bit by bit!

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

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

Вы находитесь здесь: Оглавление » Хостинг Beget » DokuWiki » Синтаксис форматирования
Вы посетили:
beget:dokuwiki:syntax

Различия

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

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

Предыдущая версия справа и слева Предыдущая версия
Следующая версия 		Предыдущая версия
beget:dokuwiki:syntax [2020/10/15 15:13]
Николай Солошин 		beget:dokuwiki:syntax [2022/02/12 11:40] (текущий)
Строка 1: Строка 1:
 ====== Синтаксис форматирования ====== ====== Синтаксис форматирования ======
  
-Шпаргалка по синтаксису. Выдержки из [[https://www.dokuwiki.org/wiki:syntax|официальной инструкции]].+Шпаргалка по синтаксису. Практически все выдрано из соответствующего контекста.
  
-===== Основные конструкции форматирования =====+===== DokuWiki =====
  
-«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**.+[[https://www.dokuwiki.org/ru:wiki:syntax|Официальная русская инструкция]]
  
-<code> +===== Cloud Plugin =====
-«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//,  +
-__подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''.  +
-Все эти конструкции можно **__//''объединить''//__**.  +
-</code>+
  
-Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.+This is a very simple plugin that shows a cloud of the most frequently used words in your wiki:
  
-<code> +  ~~CLOUD~~ 
-Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы. +  ~~CLOUD:number~~
-</code>+
  
-Ещё можно <del>зачеркнуть текст</del>.+Optionally you can specify the number of words to display. Default is 50. Allowed are numbers between 1 and 999. Each of the words is linked to the search result page for it. The words are styled in a way that more frequent words are bigger and have a darker link color.
  
-<code> +You can exclude words from the word cloud by adding them each on its own line to ''inc/lang/[lang-code]/stopwords.txt'' or to ''conf/stopwords.txt''. Remember that last line in file should be empty to work correctly.
-Ещё можно <del>зачеркнуть текст</del>. +
-</code>+
  
-**Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.+This plugin can also make a "tag cloud" now! ([[plugin:tag]] plugin must be installed) The syntax is also simple:
  
-Просто текст с разрывом строк\\ Обратите внимание,  +  ~~TAGCLOUD~~ 
-что два обратных слэша действуют только в конце строки\\ +  ~~TAGCLOUD:number~~ 
-или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.+  ~~TAGCLOUD:number>namespace1:subns11|.|namespace2~~
  
-<code>Просто текст с разрывом строк\\ Обратите внимание, +It also supports clouds for the most searched words in the wiki ([[plugin:searchstats]] plugin must be installed):
-что два обратных слэша действуют только в конце строки\\ +
-или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так. +
-</code>+
  
-Принудительные переносы следует использовать только в случае крайней необходимости.+  ~~SEARCHCLOUD~~ 
 +  ~~SEARCHCLOUD:number~~
  
-===== Ссылки =====+Since release 2017-08-05 the number of occurrences can also be output by adding the ''showCount'' option like this:
  
-Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному.+  ~~CLOUD[showCount]~~
  
-==== Внешние ====+===== Comment Syntax Plugin =====
  
-Внешние ссылки распознаются автоматически: http://www.google.com или +==== 1. 'C' style comments ==== 
-просто www.google.com --- также можно указывать текст ссылки: +'C' style comments start with ''%%/*%%'' and ends with ''%%*/%%''. The comment-start markup ''%%/*%%'' must be placed at the start of line, or after a white-space letter. Comments can also span multiple lines:
-[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты +
-тоже распознаются: <andi@splitbrain.org>.+
  
-<code>Внешние ссылки распознаются автоматически: http://www.google.com или +  /* This is a comment */
-просто www.google.com --- также можно указывать текст ссылки: +
-[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты +
-тоже распознаются: <andi@splitbrain.org>.</code>+
  
-==== Внутренние ====+  /* This is  
 +  a multi-line 
 +  comment */
  
-Внутренние ссылки создаются посредством квадратных скобок. +The **comment syntax** mode has priority to list block mode. You may comment-out some list item without breaking the whole list structure.
-Можно либо просто указать [[ru:pagename|имя страницы]], либо +
-дополнительно прописать [[ru:pagename|текст ссылки]]. Имена +
-вики-статей автоматически  переводятся в нижний регистр, +
-спецсимволы использовать нельзя.+
  
-<code>Внутренние ссылки создаются посредством квадратных скобок. +<file> 
-Можно либо просто указать [[ru:pagename]], либо +  - item 1 /* A white space is necessary before comment-start markup */ 
-дополнительно прописать [[ru:pagename|текст ссылки]]. Имена +/*- item 2    will be eliminated from this list without breaking it */ 
-вики-статей автоматически  переводятся в нижний регистр, +  - item 3 /* will be numbered as 2 in the list */  
-спецсимволы использовать нельзя.</code>+</file> 
 +  - item 1 
 +  - item 3 
  
-Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.+Note that 'C' style comments end at the first ''%%*/%%'' encountered. If you however wish that **nested comments** should be treated correctly, you can change the behavior through the configuration. In case the ''use_cstyle_nest'' option is enabled (default off), the whole part enclosed in outmost pair of ''%%/*%%'' and ''%%*/%%'' recognized as a comment: 
 +  /* There is an another comment /* in this comment */ (nested comment)*/
  
-<code>Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.</code>+==== 2. one-line comment ==== 
 +The "one-line" comment syntax will be available if the ''use_oneline_style'' option is enabled (default off). 
 +<file> 
 +  * non-ordered list item // comment  
 +</file>
  
-Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на [[#внутренние|этот раздел]].+  * non-ordered list item
  
-<code>Ссылка на [[#внутренние|этот раздел]].</code>+<file> 
 +  - item 1 // A white space is necessary before One-line comment markup 
 +//- item 2    will be eliminated from this list without breaking it 
 +  - item 3 // will be numbered as 2 in the list 
 +</file> 
 +  - item 1 
 +  - item 3 
  
-Примечания:+:!: **Adverse effect:** The one-line comment syntax ''%%//%%'' may interfere with the markup for //italics//. The use of //italic// formatting markup ''%%//...//%%'' will be restricted so that it can not go over next line.   
 +<file> 
 +This text //in italics.  
 +is rendered as normal // due to broken double-slash pairs 
 +</file>
  
-  * Ссылки на [[ru:wiki:syntax|существующие статьи]] отображаются иначе, чем ссылки на [[wiki:nonexisting|несуществующие]]. +This text is rendered as normal
-  * «Докувики» по умолчанию не использует [[wp>ru:CamelCase|CamelCase]] (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле [[doku>config]]. Проверка: если DokuWiki --- ссылка, значит эта возможность включена. +
-  * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы. +
-  * Ссылки на разделы делаются именно на [[#Разбивка на разделы|разделы]].+
  
-==== Интервики ====+==== 3. Control Macro like Comments ==== 
 +There are so-called [[beget:dokuwiki:syntax#control_macros|control macros]] syntax, such as ''%%~~NOCACHE~~%%''. It may be convenient if you put a white space between ''%%~~%%'' and ''%%NOCACHE~~%%'', it becomes a comment without displaying ''~~ NOCACHE~~'' in the page.
  
-«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки +  ~~ This is a comment without affecting other macros in the page. ~~
-на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].+
  
-<code>«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки +==== CustomButtons Plugin ====
-на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]]. +
-</code>+
  
-==== Сетевые ресурсы Windows ====+=== Multiline Codes ===
  
-Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном интранете.+If you want to have a shortcut for a common used multiline template (eg. a table) you can use "\n" in the code field to denote the line change.
  
-<code>Ссылки на сетевые ресурсы вида \\server\share тоже распознаются.</code>+Example: 
  
-Примечания:+<code> 
 +Label: 3x3 Table 
 +Code: ^ header1  ^ header2  ^ header3  ^\n|  valueA1  |  valueA2  |  valueA3  |\n|  valueB1  |  valueB2  |  valueB3  | 
 +</code>
  
-  * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»). +==== Discussion Plugin ====
-  * В браузерах Mozilla эту возможность можно включить с помощью опции [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], но делать это не рекомендуется. +
-  * Подробней читайте здесь: [[bug>151]].+
  
-==== Картинки-ссылки ====+=== Comments-section ===
  
-Совместив синтаксис ссылки и [[#картинки и другие файлы|картинки]], можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:+This is the main part of the plugin. By including the ''%%~~DISCUSSION~~%%'' instruction in your wiki page, a discussion section will be appended after the normal wiki page content. To turn it off again, use ''%%~~DISCUSSION:off~~%%''. If you want to show the existing discussion but don't want to allow new comments / replies, use ''%%~~DISCUSSION:closed~~%%''. 
 +  ~~DISCUSSION~~ 
 +  ~~DISCUSSION:off~~ 
 +  ~~DISCUSSION:closed~~
  
-<code>[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]</code>+A custom title can be appended after the separator %%|%%. 
 +  ~~DISCUSSION|Custom Title String~~ 
 +  ~~DISCUSSION:closed|Custom Title String~~
  
-[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]+After each comment in the discussion section there may be up to three buttons (depending on your rights):
  
-Учтите: форматирование картинок --- это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.+  * Reply: To reply to a comment (vs. commenting on the wiki page content), click the ''Reply'' button. The comment entry form will then be placed accordingly. 
 +  * Edit: Registered users can edit their comments; admins can edit all comments. To remove a comment, just edit it, clear the text and save the empty comment -- like you would do with a wiki page. 
 +  * Delete: Registered users and admin all comments.\\ //Attention: If there are replies to a comment, removing it will also remove all replies!// 
 +  * Hide / Show: Admins can deactivate and reactivate comments easily by this button. Hidden comments aren't shown to normal users and are displayed dimmed to admins. Registered users can only hide their own comments.
  
-==== Сноски ====+Of course, the whole DokuWiki [[beget:dokuwiki:syntax|syntax]] can be used in comments as well. But there are problems with headers and footnotes as they may produce conflicting IDs and thus invalid XHTML. I'm looking for a way to either allow only a subset of the wiki syntax or automatically create unique IDs.
  
-С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, ссылка, перевод.)).+=== Threads syntax ===
  
-<code>С помощью двойных скобок можно добавить сноску((Сноска — +This displays a list of all pages of the given namespace with a discussion section. The list is sorted by the most recent comment.
-помещаемые внизу страницы примечание, ссылка, перевод.)).</code>+
  
-===== Разбивка на разделы =====+  {{threads>[namespace]&[count=n]&[flags]&skipempty}}
  
-Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%.+^ [namespace] | the namespace for which you want a discussion thread list; '':'' is the top namespace, ''.'' is the same namespace as the page lies in, ''*'' the whole wiki | required | 
 +^ [count=n] | the number of discussions which should be displayed (valid values: n > 0) | optional | 
 +^ [flags] | pagelist flags delimited by ''&'', see [[pagelist#flags]] | optional | 
 +^ skipempty | Do not print discussions with no comments | optional |
  
  
-==== Заголовок 3 уровня ==== +Default a //new thread form// is shown below the list. See ''threads_formposition'' setting for moving it to the top of the list, or to disable this form.
-=== Заголовок 4 уровня === +
-== Заголовок 5 уровня ==+
  
-<code>==== Заголовок 3 уровня ==== +==== QnA Plugin ====
-=== Заголовок 4 уровня === +
-== Заголовок 5 уровня ==</code>+
  
-Четыре и более тире преобразуются в горизонтальную черту:+The basic QnA block starts with a question and is followed by one or more optional answers. The questions are marked by triple question mark at the start of a line, the answers --- with triple exclamation mark:
  
-----+<code> 
 +??? How do I format a question? 
 +!!! Put triple question mark at the start of a line followed by the question title. 
 +</code>
  
-===== Картинки и другие файлы =====+The first line of the question (must be on the same line as the ''???'' marker) is used as the question title and like DokuWiki headlines does not support any formatting. The rest of the text between the title and the first answer is treated as the question details and can contain almost any DokuWiki syntax (except of headers). This also applies to the answer block --- no syntax limitations.
  
-См. также: «[[ru:images|Работа с изображениями и медиафайлами]]».+Normally question and answer blocks span until the start of the next block or to the next section. If you want to mix QnA syntax with plain text you can explicitly terminate the block by the question block marker without the question title:
  
-С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:images|картинки]]. По желанию можно указать их размер.+<code> 
 +??? How do I terminate a QnA block? 
 +What if I want to put some text after the block and that text doesn't 
 +belong to the answer?
  
-Нормальный размер:                        {{wiki:dokuwiki-128.png}}+!!! Put triple question mark at the start of a line. 
 +???
  
-Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}} +This text is not part of the answer. 
- +</code>
-Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}}+
  
-Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}+You can organize multiple questions into sections using slightly modified headline syntax:
  
 <code> <code>
-Нормальный размер:                        {{wiki:dokuwiki-128.png}} +=?==== Level 1 headline ====== 
-Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}} +=?=== Level 2 headline ===== 
-Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}} +=?== Level 3 headline ==== 
-Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}+=?= Level 4 headline ===
 </code> </code>
  
-Поставив слева или справа пробел, можно задать выравнивание картинки:+The normal headlines are still respected and may be used together with customized ones. The only difference is that they are not shown in the QnA table of contents.
  
-{{wiki:dokuwiki-128.png }} +The QnA TOC can be inserted with ''~~QNA~~'' or ''~~FAQ~~'' syntax. It will be rendered as an unordered list of all questions on the current page. Note that due to implementation constrains the TOC for the current page may be not properly updated in preview during the page editing. Instead of the current page you can insert TOC for other pages by adding the page names to the ''~~QNA~~'' syntax:
-{{ wiki:dokuwiki-128.png}} +
-{{ wiki:dokuwiki-128.png }}+
  
-<code>{{wiki:dokuwiki-128.png }} — картинка слева +<code> 
-{{ wiki:dokuwiki-128.png }} — посередине +~~QNA faq:installation faq:sequrity faq:usage~~
-{{ wiki:dokuwiki-128.png}} — справа+
 </code> </code>
  
-И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).+When multiple page names are specified the plugin will combine information from all pages into a single TOC.
  
-{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}+==== Stars2 Plugin ====
  
-<code>{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}</code>+Stars can be created with two methods: 
 +  - With the Toolbarbutton Stars 1-5 
 +  - With **Syntax code as shown below**
  
-Если задать имя файла (внутреннее или внешнее), который не является картинкой (''gif, jpeg, png''), оно будет отображаться в виде ссылки.+<code> 
 +{{stars>num}} 
 +{{stars>}} 
 +{{stars>-1/5}} 
 +{{stars>-5/5}} 
 +{{stars>1/5}} 
 +{{stars>2/5}} 
 +{{stars>3/5}} 
 +{{stars>4/5}} 
 +{{stars>5/5}} 
 +{{stars>5.5/7}} 
 +{{stars>700/1000}} 
 +</code>
  
-Узнать, как вставить картинку со ссылкой можно в [[#картинки-ссылки|разделе выше]].+==== flowcharts Plugin ====
  
-===== Списки ===== +**With the current version of the plugin it is crucial to remove the following lines from the DokuWiki file conf/entities.conf** 
- +
-«Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или дефис (-) --- в случае нумерованного. +
- +
-  * Первый элемент маркированного списка +
-    * Второй элемент списка +
-      * Можно сделать вложенный список +
-    * Ещё один элемент +
- +
-  - Тот же список, только нумерованный +
-    - Ещё элемент +
-      - Чем больше пробелов в начале, тем глубже вложенность +
-    - Всё просто+
  
 <code> <code>
-  * Первый элемент маркированного списка +<->     ↔ 
-    * Второй элемент списка +->      → 
-      * Можно сделать вложенный список +<-      ← 
-    * Ещё один элемент +---     — 
- +--      –
-  - Тот же список, только нумерованный +
-  - Ещё элемент +
-    - Чем больше пробелов в начале, тем глубже вложенность +
-  - Всё просто+
 </code> </code>
  
-См. также [[ru:faq:lists|FAQ по элементам списка]].+Otherwise, DokuWiki will render ''%%->%%'' to -> and then the diagrams are not rendered correctly since, e.g. -> is the wrong syntax and we need ''%%->%%'' etc. (For more information, see [[:entities]] and also [[https://github.com/splitbrain/dokuwiki/blob/master/conf/entities.conf]])
  
-===== Смайлики =====+Alternatively, you can add the arrows in the diagram using
  
-«Докувики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию ''smiley'' и добавить их в файл ''conf/smileys.local.conf''. Вот смайлики, которые есть в «Докувики»:+<code>%%-->%%</code>
  
-  * 8-) %%8-)%% +=== Examples/Usage ===
-  * 8-O %%8-O%% +
-  * :-( %%:-(%% +
-  * :-) %%:-)%% +
-  * =) %%=)%% +
-  * :-/ %%:-/%% +
-  * :-\ %%:-\%% +
-  * :-? %%:-?%% +
-  * :-D %%:-D%% +
-  * :-P %%:-P%% +
-  * :-O %%:-O%% +
-  * :-X %%:-X%% +
-  * :-| %%:-|%% +
-  * ;-) %%;-)%% +
-  * ^_^ %%^_^%% +
-  * :?: %%:?:%% +
-  * :!: %%:!:%% +
-  * LOL %%LOL%% +
-  * FIXME %%FIXME%% +
-  * DELETEME %%DELETEME%%+
  
-===== Типографские символы =====+<code> 
 +<flow> 
 +graph TD; 
 +    A-->B; 
 +    A-->C; 
 +    B-->D; 
 +    C-->D; 
 +</flow> 
 +</code>
  
-«Докувики» может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.+Will be rendered to
  
--> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...\\ +{{https://github.com/jakob1111/dokuwiki-plugin-flowcharts/raw/master/examplediagram.png}} 
-"Александр Сергеевич(tm) --- это наше всё (c) не я"+ 
 +A nice feature is that each element of a diagram can be made clickable by using
  
 <code> <code>
--> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ... +<flow> 
-"Александр Сергеевич(tm) --- это наше всё (c) не я"+graph TD; 
 +    A-->B; 
 +    A-->C; 
 +    B-->D; 
 +    C-->D; 
 +click A "SOMEPAGE" 
 +</flow>
 </code> </code>
  
-Примечание: это конвертирование можно отключить в файле конфигурации ''[[ru:entities|conf/entities.conf]]''.+Clicking on ''A'' will take you to %%http://yoururl.com/SOMEPAGE%%.
  
-===== Таблицы =====+=== Syntax ===
  
-«Докувики» поддерживает упрощённый синтаксис создания таблиц.+[[https://mermaid-js.github.io/mermaid/diagrams-and-syntax-and-examples/|Полный синтаксис]]
  
-^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^ +[[https://mermaidjs.github.io/mermaid-live-editor/|Визуальный редактор]]
-| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        | +
-| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  || +
-| Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |+
  
-Обычные ряды должны начинаться и заканчиваться вертикальной чертой --- %%|%%, а заголовки «крышечкой» (циркумфлекс) — %%^%%.+For further details on the syntax, see [[https://mermaidjs.github.io/|mermaidjs.github.io]].
  
-  ^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^ +==== Bookmark ====
-  | Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        | +
-  | Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  || +
-  | Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |+
  
-Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток было одинаковым.+With this plugin you can insert a bookmark to your page. The format is
  
-Вертикальные заголовки тоже можно сделать:+  <BOOKMARK:bookmarkname>
  
-|              ^ Заголовок 1       ^ Заголовок 2      ^ +This will insert code 
-^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  | +
-^ Заголовок 4  | Объединения нет   |                  | +
-^ Заголовок 5  | Ряд 2 Колонка 2   | Ряд 2 Колонка 3  |+
  
-Как легко увидеть, разделитель, стоящий перед клеткой, определяет форматирование:+<code> 
 +<a name='bookmarkname' id='bookmarkname'></a> 
 +</code>
  
-  |              ^ Заголовок 1       ^ Заголовок 2      ^ +To link to the bookmark from the same page (i.e. to use the bookmark as an anchor link within the page), use this syntax:
-  ^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  | +
-  ^ Заголовок 4  | Объединения нет   |                  | +
-  ^ Заголовок 5  | Ряд 2 Колонка 2   | Ряд 2 Колонка 3  |+
  
-Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий '':::'' в объединяемые нижележащие ячейки.+<code> 
 +[[namespace:page_name#bookmarkname|anchor_text]] 
 +</code>
  
-^ Заголовок 1      ^ Заголовок 2                        ^ Заголовок 3      ^ +Where anchor_text is the text-link your visitors will see.
-| Ряд 1 Колонка 1  | эта ячейка объединена вертикально  | Ряд 1 Колонка 3  | +
-| Ряд 2 Колонка 1  | :::                                | Ряд 2 Колонка 3  | +
-| Ряд 3 Колонка 1  | :::                                | Ряд 2 Колонка 3  |+
  
-В этих ячейках не должно быть ничего, кроме синтаксиса объединения ('':::'').+==== Gallery ====
  
-  ^ Заголовок 1        ^ Заголовок 2                       ^ Заголовок 3            ^ +=== Syntax ===
-  | Ряд 1 Колонка 1    | эта ячейка объединена вертикально | Ряд 1 Колонка 3        | +
-  | Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        | +
-  | Ряд 3 Колонка 1    | :::                               | Ряд 2 Колонка 3        |+
  
-Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру. +A basic gallery can be added by selecting a [[:namespaces|namespace]] like this:
  
-^           Таблица с выравниванием        ^^^ +  {{gallery>:namespace}}
-|        вправо|   по центру  |влево         | +
-|влево         |        вправо|   по центру  | +
-| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |+
  
-  ^           Таблица с выравниванием        ^^^ +All image files in the selected namespace will be added to the image gallery. Don't forget the ":" in front of the namespace.
-  |        вправо|   по центру  |влево         | +
-  |влево         |        вправо|   по центру  | +
-  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |+
  
-Примечание: вертикальное выравнивание не поддерживается.+Instead of using a whole namespace of images, you can also specify a single image -- this makes more sense when combined with the lightbox mode (see below).
  
-===== Неформатируемые блоки =====+  {{gallery>:namespace:someimage.jpg}}
  
-Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги ''%%<code>%%'' или ''%%<file>%%''.+The created gallery can be aligned by using white space (defaults to centered):
  
-<code>Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.</code>+  {{gallery> namespace}} (right aligned) 
 +  {{gallery>namespace }} (left aligned) 
 +  {{gallery> namespace }} (centered)
  
-<file>В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.</file>+Instead of a namespace, you can also give an HTTP(s) URL to any [[wp>Media RSS]] or ATOM feed with enclosures (as produced by most photo sharing sites like Flickr). The images will then be pulled from that feed instead:
  
-Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги ''nowiki'', либо ещё проще --- в двойные знаки процента ''<nowiki>%%</nowiki>''.+  {{gallery>http://www.23hq.com/rss/schabloni}}
  
-Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%  +Note: since the question mark is used to separate the parameters (see next section) the URL can not contain any question mark. To use such a feed URL with the gallery plugin, just use one of the many short URL services like [[http://bit.ly]].
-и %%**форматирование**%% --- но ничего не происходит.+
  
-<code>Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%% +E.g. instead of ''%%http://api.flickr.com/services/feeds/photos_public.gne?id=22019303@N00&lang=en-us&format=rss_200%%'' use a shortened URL like ''%%http://bit.ly/HurZM%%''.
-и %%**форматирование**%% --- но ничего не происходит.</code>+
  
-Чтобы увидеть, как используются эти блоки, смотрите код страницы.+Additionally, to have thumbnail creation correctly working you need to set [[config:fetchsize]] big enough to get the remote images downloaded.
  
-===== Подсветка синтаксиса =====+== Parameters ==
  
-«Докувики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''code'' в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%.+A number of parameters can be set by appending them with ''?'' character to the namespace or image. Each parameter needs to be separated with a ''&'' character. Defaults for all parameters can be set in the config manager. If a parameter is enabled by default it can be disabled in the syntax by prefixing it with the syllable ''no''. E.g. the parameter ''cache'' is usually enabled and can be disabled using the keyword ''nocache''. Below is a list of all recognized parameters
  
-<code java> +^ Parameter                      ^ Default         ^ Description    ^ 
-/**  +| ''//<number>//x//<number>//''  | ''%%120x120%%'' | Sets the size for thumbnails. Unless the crop option is set, this is a boundary box into which the thumbnail will be fitted, maintaining the correct aspect ratio. | 
- * The HelloWorldApp class implements an application that +| ''//<number>//X//<number>//''  | ''%%800X600%%'' | Sets the size for the linked images in ''direct'' mode. This is a boundary box into which the image will be fitted, maintaining the correct aspect ratio. Note the uppercase ''X''.| 
- * simply displays "Hello World!" to the standard output. +| ''//<number>//''               | ''5''           | The number images per row in the gallery table. If you specify a 0 no table is used instead all thumbnails are added in a sequence. | 
- */ +| ''=//<number>//''              | ''=0''          | Limits the output to the given number of images. ''0'' means all. | 
-class HelloWorldApp { +| ''+//<number>//''              | ''+0''          | Skip the first number of images. Useful with the option above. | 
-    public static void main(String[] args) { +| ''~//<number>//''              | ''~0''          | Add a pagination for the thumbnails displaying the number of given thumbnails per page. ''0'' disables pagination. Pagination is added through JavaScript - when no JavaScript is available all thumbnails are displayed | 
-        System.out.println("Hello World!"); //Display the string. +| ''cache''                      | enabled         | Usually the output of the created gallery is cached. When the images in your selected namespace change, you have to manually force an update of the gallery page's [[:caching|cache]]. To disable the cache for the page showing the gallery, set ''nocache'' as option. | 
-    } +| ''crop''                       | disabled        | Make thumbnails the exact given thumbnail size big, cropping when needed. | 
-} +| ''direct''                     | disabled        | Link thumbnails with the bigger sized images not with their detail page | 
-</code>+| ''lightbox''                   | disabled        | Show images in a fancy JavaScript modal browsing window, see below for details. Setting this option automatically implies the ''direct'' mode | 
 +| ''reverse''                    | disabled        | Reverse the order of the displayed images | 
 +| ''recursive''                  | enabled         | Find images in the given namespace and all sub namespaces | 
 +| ''random''                     | disabled        | Sort images randomly. You might want to use ''nocache'' as well | 
 +| ''modsort''                    | disabled        | Sort images by file modification date | 
 +| ''datesort''                   | disabled        | Sort images by EXIF date | 
 +| ''titlesort''                  | disabled        | Sort images by EXIF title | 
 +| ''showname''                   | disabled        | Show filename below thumbnails | 
 +| ''showtitle''                  | disabled        | Show the EXIF tag ''Headline'' as title below thumbnails | 
 +| anything containing a ''*''    | jpg,gif,png images | This can be used to filter the list of files found in the given namespace. ''*'' work as simple wildcard symbol. |
  
-На данный момент распознаются следующие языки: 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.+== Example ==
  
-==== Скачиваемые блоки кода ====+  {{gallery>images:vacation?image_*.jpg&80x80&crop&lightbox}}
  
-Используя тэги ''%%<code>%%'' или ''%%<file>%%'', как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:+This displays all images beginning with ''image_'' and ending in ''.jpg'' from the namespace ''images:vacation''. Thumbnails are cropped to 80x80 pixels and images will be opened in lightbox mode.
  
-<code> +== Example ==
-<file php myexample.php> +
-<?php echo "hello world!"; ?> +
-</file> +
-</code>+
  
-<file php myexample.php> +  {{gallery>?crop&lightbox}}
-<?php echo "hello world!"; ?> +
-</file>+
  
-Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (дефис) (''-'') на месте кода языка: ''%%<code - myfile.foo>%%''.+This displays all images in the current namespace using 2 parameters. Parameterlist begins with ''?'' additional ones are concatenated with ''&''.
  
-**Особенность:** при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками. Например, %%"Фоо Бар.php"%%. +=== About the Lightbox mode ===
-<file php "Фоо Бар.php"> +
-<?php echo "hello world!"; ?> +
-</file>+
  
-===== Вставка HTML и PHP =====+This mode will open the clicked picture inside the current browser window without leaving the current page.
  
-Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов ''html'' и ''php''. Используйте заглавные буквы для блочных элементов.+You can close the picture view by clicking the X button in the upper right corner. You can move to the next or previous image by using the arrow buttons in the lower bar. You can also use the keyboard shortcuts listed below for navigation and closing. Mobile users can swipe to navigate and use the back button to close the gallery.
  
-<code html> +The following keys can be used to navigate:
-<html> +
-Тут вставлен <font color="red" size="+1">код HTML</font> +
-</html>+
  
-<HTML> +^ Key     ^ Action ^ 
-<p style="border:2px dashed red;">И здесь блочная вставка HTML</p> +| ''->''  | next image | 
-</HTML> +| ''<-''  | previous image | 
-</code>+| ''ESC'' | close the image view |
  
-Получается:+==== Footer ====
  
-<html> +=== Footer template ===
-Тут вставлен <font color="red" size="+1">HTML-код</font> +
-</html>+
  
-<HTML> +To add footer text to pages in a namespace, you need to create a file named ''%%_%%footer.txt'' in this namespace.\\ 
-<p style="border:2px dashed red;">И здесь блочная вставка HTML</p> +And to add footer text to pages in the namespace directory and its subdirectories create a file named ''%%__%%footer.txt'' in the namespace directory.
-</HTML>+
  
-----+Files beginning with "%%_%%" cannot be created or changed within dokuwiki. Instead you have to create a file and upload it into the wanted namespace. If you don't want this behaviour and you want to maintain data from within dokuwiki you have to define prefixes in the plugin settings, e.g. "hf" and "hfu". In this case you have to create the pages ''hf_footer'' and ''hfu_footer'' in the namespace directory.
  
-<code> +=== Additional syntax ===
-<php> +
-echo 'Версия PHP: '; +
-echo phpversion(); +
-echo ' (прямая вставка в HTML).'; +
-</php>+
  
-<PHP> +To avoid a certain page from the footer template (e.g. the start page) you can insert this special command 
-echo '<table class="inline"><tr><td>То же самое — в элементе блочного уровня:</td>'; +  ~~NOFOOTER~~ 
-echo '<td>'.phpversion().'</td>'; +to the content of this page. Please note that this command is only removed from the page text if there is a footer template exactly for the namespace of this page.
-echo '</tr></table>'; +
-</PHP> +
-</code>+
  
-Получается:+=== Example ===
  
-<php> +{{https://raw.githubusercontent.com/Juergen-aus-Zuendorf/dokuwiki-plugin-footer/main/footer01.png}}
-echo 'Версия PHP: '; +
-echo phpversion(); +
-echo ' (прямая вставка в HTML).'; +
-</php>+
  
-<PHP> +The screenshot above shows this syntax:
-echo '<table class="inline"><tr><td>То же самое — в элементе блочного уровня:</td>'; +
-echo '<td>'.phpversion().'</td>'; +
-echo '</tr></table>'; +
-</PHP>+
  
-**Примечание:** по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.+a) The content of the page "mynamespace:example" is:
  
-===== RSS/ATOM Feed Aggregation =====+==== HtmlMetaTags Plugin ====
  
-[[wiki:dokuwiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://simplepie.org/|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:+<code> 
 +  {{htmlmetatags>metatag-keywords=(values) metatag-og:description=(open graph description.)}} 
 +</code>
  
-^ Параметр   ^ Описание ^ +**Note:** Linebreaks can add inside the <nowiki>{{ }}</nowiki> without any trouble. 
-| any number | will be used as maximum number items to show, defaults to 8 | +<code> 
-| reverse    | display the last items in the feed first | +  {{htmlmetatags>metatag-keywords=(values) 
-| author     | show item authors names | +    metatag-og:description=(open graph description.) 
-| date       | show item dates | +  }} 
-| description| show the item description. If [[doku>config:htmlok|HTML]] is disabled all tags will be stripped | +</code>
-| nosort     | do not sort the items in the feed | +
-| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |+
  
-The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.+=== Syntax ===
  
-By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the ''reverse'' parameter, or display the feed as is with ''nosort''.+With the string ''%%{{htmlmetatags>...}}%%'' on the page level you activate the plugin. The leading string "metatag-" marks a tag for the web site. After this leading string followed the key from tag. In ''%%=(...)%%'' write the value of the tag.
  
-**Example:**+Also, the plugin is on page level.
  
-  {{rss>http://slashdot.org/index.rss 5 author date 1h }}+Example to activate the plugin on your page write:
  
-{{rss>http://slashdot.org/index.rss 5 author date 1h }}+<code> 
 +{{htmlmetatags>metatag-mytag=(some usefull text)}} 
 +</code>
  
 +The meta tag: //mytag// is any word. This word is the name of the new meta tag, e.g. keyword. Followed on this name is to write ''='' with ''%%('...')%%''. This brackets contains the text required for the value of the new meta tag.
  
-===== Управляющие макросы =====+You can write more than once meta tag on the page separate by space.
  
-Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:+<code> 
 +{{htmlmetatags>metatag-robots=()  
 +metatag-keywords=(apfel,bananne,birne)  
 +metatag-description=(Allgemeiner Obstbauer) 
 +metatag-media-og:image=(:wiki:image.jpg) 
 +metatag-og:description=(anything else) 
 +metatag-og:any=(anything else 2) 
 +}}
  
-^ Макрос          ^ Описание      | +</code>
-| %%~~NOTOC~~%%   | Если этот макрос присутствует в статье, оглавление не будет создано.  | +
-| %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис %%<php>%%), добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове.  |+
  
-===== Синтаксические плагины =====+The **result** on web page is:
  
-Синтаксис «Докувики» может быть расширен за счёт [[ru:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:+<code html> 
 +<meta name="robots" content="noindex,nofollow"/> 
 +<meta name="keywords" content="apfel,bananne,birne"/> 
 +<meta name="description" content="Allgemeiner Obstbauer"/> 
 +<meta property="og:image" content="http://localhost/lib/exe/fetch.php?media=wiki:image.jpg"/> 
 +<meta property="og:description" content="anything else"/> 
 +<meta property="og:any" content="anything else 2"/> 
 +</code>
  
-~~INFO:syntaxplugins~~+~~DISCUSSION:off~~
Последнее изменение: 2022/02/12 11:40 (внешнее изменение)

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

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International