Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
wiki:syntax [2013/12/18 12:42] admin [Внутренние ссылки.] |
wiki:syntax [2017/07/18 14:15] (текущий) |
||
---|---|---|---|
Строка 5: | Строка 5: | ||
==== Создание ==== | ==== Создание ==== | ||
- | Для того, чтобы создать страницу, нужно в конкретном разделе после адресной строки ввести её название латинскими буквами. | + | Для того, чтобы создать страницу, нужно в конкретном разделе после адресной строки ввести её название латинскими буквами. |
<code> | <code> | ||
[[wiki/syntax/new]] | [[wiki/syntax/new]] | ||
Строка 11: | Строка 11: | ||
Выдастся сообщение о том, что страница не найдена и будет предложено её создать. | Выдастся сообщение о том, что страница не найдена и будет предложено её создать. | ||
- | Кроме того, название страницы вписать а адресную строку, так и добавить ссылку на несуществующую страницу. | + | Кроме того, название страницы можно вписать в адресную строку, добавив /имя к текущему адресу, а также можно добавить в текст статьи ссылку на несуществующую страницу, при нажатии на которую будет также предложено создать новую страницу. |
Пример: | Пример: | ||
Строка 17: | Строка 17: | ||
* [[wiki/syntax]] | * [[wiki/syntax]] | ||
* [[wiki/new]] | * [[wiki/new]] | ||
+ | |||
==== Удаление ==== | ==== Удаление ==== | ||
Для того, чтобы удалить страницу нужно: | Для того, чтобы удалить страницу нужно: | ||
- | - Удалить все ссылки на неё. Для этого в адресной строке добавляем к тому, что написано ?do=backlink. DоkuWiki выдаст все страницы, которые ссылаются на текущую. | + | * Удалить все ссылки на неё. Для этого в адресной строке добавляем к тому, что написано ?do=backlink. DоkuWiki выдаст все страницы, которые ссылаются на текущую. \\ В случае, если ссылки на страницу или её части могли использоваться для внедрения в другие статьи с помощью плагина Include, требуется поискать такие ссылки поиском в текстовых файлах DocuWiki (см. [[wiki/syntax#вставка_части_одной_статьи_в_другую_плагин_include|Вставка части одной статьи в другую (плагин Include)]]). |
- | - На удаляемой странице нажать "Править", удалить весь текст и сохранить. | + | * На удаляемой странице нажать "Править", удалить весь текст и сохранить. |
===== Форматирование текста ===== | ===== Форматирование текста ===== | ||
Строка 38: | Строка 39: | ||
</code> | </code> | ||
//Курсив// | //Курсив// | ||
- | |||
При формировании списков нужно сначала ставить 2 пробела, затем спец символ (звёздочка для ненумерованного списка, минус для нумерованного). Если нужен элемент списка более нижнего уровня, то ставим перед символом на 2 пробела больше. | При формировании списков нужно сначала ставить 2 пробела, затем спец символ (звёздочка для ненумерованного списка, минус для нумерованного). Если нужен элемент списка более нижнего уровня, то ставим перед символом на 2 пробела больше. | ||
Строка 53: | Строка 53: | ||
- Нумерованный список | - Нумерованный список | ||
- Нумерованный список | - Нумерованный список | ||
+ | |||
===== Ссылки ===== | ===== Ссылки ===== | ||
Строка 74: | Строка 75: | ||
Адреса электронной почты тоже распознаются: <andi@splitbrain.org>. | Адреса электронной почты тоже распознаются: <andi@splitbrain.org>. | ||
- | ==== Внутренние ссылки. ==== | + | |
+ | ==== Внутренние ссылки ==== | ||
Внутренние ссылки создаются посредством квадратных скобок. | Внутренние ссылки создаются посредством квадратных скобок. | ||
Строка 87: | Строка 89: | ||
[[wiki/syntax]] | [[wiki/syntax]] | ||
- | Либо дополнительно прописать | + | Либо дополнительно прописать: |
<code> | <code> | ||
Строка 129: | Строка 131: | ||
Внутренние ссылки первого типа полагается писать следующим образом: | Внутренние ссылки первого типа полагается писать следующим образом: | ||
- | ([[ссылка_на_раздел]]) | + | [[ссылка_на_раздел]] |
Никаких названий дописывать не нужно, они подставятся автоматически. | Никаких названий дописывать не нужно, они подставятся автоматически. | ||
Строка 143: | Строка 145: | ||
Ссылки второго типа полагается писать следующим образом: | Ссылки второго типа полагается писать следующим образом: | ||
- | [[ссылка_на_раздел#ссылка_на_статью|этот раздел]] | + | [[ссылка_на_раздел#ссылка_на_статью|эта статья]] |
В этом случае нужно в ссылке статьи обязательно дописывать название статьи. | В этом случае нужно в ссылке статьи обязательно дописывать название статьи. | ||
Строка 176: | Строка 178: | ||
Пример: | Пример: | ||
- | …описано в статье [[ru/csdesign/bpmodeling/epc_notation#команды_панели_инструментов_для_диаграммы_epc|Команды панели инструментов для диаграммы EPC]]. | + | …описаны в статье [[ru/csdesign/bpmodeling/epc_notation#команды_панели_инструментов_для_диаграммы_epc|Команды панели инструментов для диаграммы EPC]]. |
Если в разделе одного документа дается ссылка на раздел другого документа, то перед ссылкой на раздел дается ссылка на документ. Если рядом дается 2 и более ссылок на разделы из разных документов, то перед ссылкой на раздел также дается ссылка на документ. | Если в разделе одного документа дается ссылка на раздел другого документа, то перед ссылкой на раздел дается ссылка на документ. Если рядом дается 2 и более ссылок на разделы из разных документов, то перед ссылкой на раздел также дается ссылка на документ. | ||
Строка 182: | Строка 184: | ||
Пример: | Пример: | ||
- | …описано в главе [[ru/csdesign/csdesign|Проектирование системы управления]] --> [[ru/csdesign/bpmodeling/epc_notation|Нотация EPC]]. | + | …описаны в главе [[ru/csdesign/csdesign|Проектирование системы управления]] -> [[ru/csdesign/bpmodeling/epc_notation|Нотация EPC]]. |
- | …описано в главах [[ru/manual/manual|Руководство пользователя]] --> [[ru/manual/creating_model/epc_notation|Нотация EPC]], [[ru/csdesign/csdesign|Проектирование системы управления]] --> [[ru/csdesign/bpmodeling/epc_notation|Нотация EPC]]. | + | …описаны в главах [[ru/manual/manual|Руководство пользователя]] --> [[ru/manual/creating_model/epc_notation|Нотация EPC]], [[ru/csdesign/csdesign|Проектирование системы управления]] --> [[ru/csdesign/bpmodeling/epc_notation|Нотация EPC]]. |
**Использование оборота (см. ….)** | **Использование оборота (см. ….)** | ||
Строка 203: | Строка 205: | ||
(см. [[ru/manual/manual]] --> [[ru/manual/creating_model/epc_notation]], [[ru/csdesign/csdesign]] --> [[ru/csdesign/bpmodeling/epc_notation]]) | (см. [[ru/manual/manual]] --> [[ru/manual/creating_model/epc_notation]], [[ru/csdesign/csdesign]] --> [[ru/csdesign/bpmodeling/epc_notation]]) | ||
- | ==== Картинки ссылки. ==== | + | |
+ | **Просто текст** | ||
+ | |||
+ | Если требуется вставить текс, содержащий служебные символы (тэги), то чтобы вставить их как обычный текст, нужно открывающиеся скобки тэга обрамить в символы процентов, т.е. %%{{%%. | ||
+ | |||
+ | Пример: | ||
+ | |||
+ | Текст %%[[%%ru/csdesign/csdesign]] внутри текста страницы выглядит как {{wiki/syntax/text.png?nolink}} | ||
+ | ==== Картинки ссылки ==== | ||
Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой: | Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой: | ||
Строка 215: | Строка 225: | ||
Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки. | Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки. | ||
- | + | ===== Картинки в DokuWiki ===== | |
- | ===== Картинки в DokuWiki. ===== | + | |
Здесь приводятся способы вставки картинок при создании страниц в системе DokuWiki. | Здесь приводятся способы вставки картинок при создании страниц в системе DokuWiki. | ||
Строка 265: | Строка 274: | ||
/media/ru/head1/img1.png. | /media/ru/head1/img1.png. | ||
- | |||
Строка 275: | Строка 283: | ||
- | |||
Все большие изображение, шириной более 800 пикселей, нужно сжимать. | Все большие изображение, шириной более 800 пикселей, нужно сжимать. | ||
Для сжатия использовать FastStown Wiever. Использовать фильтр Lanczos3.\\ \\ | Для сжатия использовать FastStown Wiever. Использовать фильтр Lanczos3.\\ \\ | ||
+ | |||
+ | ==== Вставка картинок с рамкой и заголовком (плагин Imagebox) ==== | ||
+ | |||
+ | Вставка рисунка внутри рамки с помощью плагина Imagebox осуществляется с помощью тага | ||
+ | |||
+ | %%[{{ путь?nolink |Рисунок 1. Описание}}]%% | ||
+ | |||
+ | Здесь: | ||
+ | |||
+ | - Путь -- путь к файлу. | ||
+ | - ? -- разделитель. | ||
+ | - nolink -- команда с помощью которой изображение перестаёт быть ссылкой на само себя (по умолчанию в ДокуВики при нажатии на любое изображение осуществляется переход на него) | ||
+ | - %%|%% - разделитель. | ||
+ | - Рисунок 1. Описание -- подпись к рисунку. Структура подписи следующая: | ||
+ | * Сначала пишется "Рисунок 1." обычным шрифтом (без подчёркивания и курсива) с точкой на конце. | ||
+ | * Описание, если такое присутствует. Шрифт обычный (без подчёркивания и курсива). | ||
+ | |||
+ | **Пример**: %%[{{ wiki/syntax/dokuwiki-128.png |Логотип DokuWiki}}]%% | ||
+ | |||
+ | [{{ wiki/syntax/dokuwiki-128.png |Логотип DokuWiki}}] | ||
+ | |||
+ | Ограничения по размеру вставляемых изображений сохраняются и при работе с данным плагином. | ||
===== Прикрепление файлов к статьям ===== | ===== Прикрепление файлов к статьям ===== | ||
Строка 294: | Строка 323: | ||
Поиск файлов осуществлять через ".zip" (включая кавычки).\\ | Поиск файлов осуществлять через ".zip" (включая кавычки).\\ | ||
- | Таким образом нужно прикреплять все файлы кроме картинок. | + | Таким образом нужно прикреплять все файлы кроме картинок.\\ |
+ | \\ | ||
+ | **Внимание!** В ссылках, а также в названиях файлов не должно быть заглавных букв. Иначе ссылки на файлы не будут работать. | ||
===== Прочий синтаксис. ===== | ===== Прочий синтаксис. ===== | ||
Строка 306: | Строка 337: | ||
Для того, чтобы вставить блок "Внимание" ("Примечания"), нужно использовать заголовок 5-го уровня ( == Внимание! == ), затем продолжать писать, как обычные раздел, а завершать блок пустым заголовком второго уровня ( ===== ===== ). | Для того, чтобы вставить блок "Внимание" ("Примечания"), нужно использовать заголовок 5-го уровня ( == Внимание! == ), затем продолжать писать, как обычные раздел, а завершать блок пустым заголовком второго уровня ( ===== ===== ). | ||
- | |||
- | ===== Правила вставки картинок с использованием плагина imagebox. ===== | ||
- | Вставка рисунка внутри рамки с помощью плагина imagebox осуществляется с помощью тага | ||
- | %%[{{ путь?nolink |Рисунок 1. Описание}}]%% | + | ===== Вставка таблиц с рамкой и заголовком (плагин Tablebox) ===== |
- | + | ||
- | Здесь: | + | |
- | + | ||
- | - Путь -- путь к файлу. | + | |
- | - ? -- разделитель. | + | |
- | - nolink -- команда с помощью которой изображение перестаёт быть ссылкой на само себя (по умолчанию в ДокуВики при нажатии на любое изображение осуществляется переход на него) | + | |
- | - %%|%% - разделитель. | + | |
- | - Рисунок 1. Описание -- подпись к рисунку. Структура подписи следующая: | + | |
- | * Сначала пишется "Рисунок 1." обычным шрифтом (без подчёркивания и курсива) с точкой на конце. | + | |
- | * Описание, если такое присутствует. Шрифт обычный (без подчёркивания и курсива). | + | |
- | + | ||
- | **Пример**: %%[{{ wiki/syntax/dokuwiki-128.png |Логотип ДокуВики}}]%% | + | |
- | + | ||
- | [{{ wiki/syntax/dokuwiki-128.png |Логотип ДокуВики}}] | + | |
- | ===== Правила вставки таблиц с помощью плагина tablebox (таблицы с обрамлением рамкой) ===== | + | |
Вставка таблиц внутри рамки осуществляется с помощью следующих тагов: | Вставка таблиц внутри рамки осуществляется с помощью следующих тагов: | ||
Строка 353: | Строка 366: | ||
* Описание, если такое присутствует. Шрифт обычный (без подчёркивания и курсива). | * Описание, если такое присутствует. Шрифт обычный (без подчёркивания и курсива). | ||
+ | ===== Вставка текста кода в статьи ===== | ||
+ | |||
+ | Для вставки кода в статьи нужно воспользоватьмя тегами | ||
+ | |||
+ | <cоde _наименование_языка>\\ | ||
+ | Текст кода\\ | ||
+ | </cоde>\\ | ||
+ | |||
+ | **Пример**\\ | ||
+ | Вставка "Hello world!" на C# будет выглядеть так: | ||
+ | <code Csharp> | ||
+ | // A Hello World! program in C#. | ||
+ | using System; | ||
+ | namespace HelloWorld | ||
+ | { | ||
+ | class Hello | ||
+ | { | ||
+ | static void Main() | ||
+ | { | ||
+ | Console.WriteLine("Hello World!"); | ||
+ | |||
+ | // Keep the console window open in debug mode. | ||
+ | Console.WriteLine("Press any key to exit."); | ||
+ | Console.ReadKey(); | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | Перечень всех поддерживаемых языков (код которых надо вставлять в открывающий тэг вместо "_наименование_языка") для подсветки синтаксиса внутри блока можно посмотреть [[http://www.dokuwiki.ru/syntax#podsvetka_sintaksisa|здесь]]. | ||
+ | |||
+ | ===== Вставка части одной статьи в другую (плагин Include) ===== | ||
+ | |||
+ | Для вставки части текста из другой статьи в текущую нужно воспользоваться тэгами | ||
+ | |||
+ | %%{{%%page>страница#якорь&noheader&noeditbutton&nouser&nodate}} | ||
+ | |||
+ | Здесь: | ||
+ | - page> - стартовый тег. Обозначает, что в результате работы тэга будет выведена часть другой страницы. | ||
+ | - страница#якорь - путь до страницы и конкретного куска текста на ней. | ||
+ | - noheader - запрещает вывод заголовка раздела, который вставляется данной командой. | ||
+ | - noeditbutton - убирает кнопку редактирования со вставляемого текста. | ||
+ | - nouser&nodate - убирают информацию в нижней части экрана о авторе и дате написания вставляемого текста. | ||
+ | |||
+ | **Пример**\\ | ||
+ | Вставим часть статьи по ссылке [[ru/terms/terms_modeling_notations#нотация]], как встраиваемый текст. | ||
+ | Результат команды %%{{%%page>ru/terms/terms_modeling_notations#нотация&noheader&noeditbutton&nouser&nodate}}, будет выглядеть как (результат работы только следующая строка): | ||
+ | |||
+ | {{page>ru/terms/terms_modeling_notations#нотация&noheader&noeditbutton&nouser&nodate}} | ||
+ | |||
+ | **Примечание.** Ссылки внутри данного плагина невозможно найти с помощью стандартных средств поиска DokuWiki, поэтому в случае необходимости (например, при удалении или переименовании статьи или её раздела, ссылки на которые могли использоваться внутри такого плагина) требуется использовать поиск в текстовых файлах DokuWiki. | ||
===== Плагин Tag ===== | ===== Плагин Tag ===== | ||
Строка 361: | Строка 425: | ||
Если к странице нужно прикрепить несколько тагов, то разделяются они пробелами.\\ | Если к странице нужно прикрепить несколько тагов, то разделяются они пробелами.\\ | ||
Таги стоит вводить аккуратно, т.к. лишний символ = новый таг. | Таги стоит вводить аккуратно, т.к. лишний символ = новый таг. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | [<contextnavigator>] | ||