Различия

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

--- wiki:syntax [2013/12/18 14:36]
barinova [Ссылки на другие разделы документации]
+++ wiki:syntax [2017/07/18 14:15] (текущий)
@@ Строка 5: / Строка 5: @@
 ==== Создание ====
 Для того, чтобы создать страницу, нужно в конкретном разделе после адресной строки ввести её название латинскими буквами.
 <code>
 [[wiki/syntax/new]]
@@ Строка 11: / Строка 11: @@
 Выдастся сообщение о том, что страница не найдена и будет предложено её создать.
-Кроме того, название страницы вписать а адресную строку, так и добавить ссылку на несуществующую страницу.
+Кроме того, название страницы можно вписать в адресную строку, добавив /имя к текущему адресу, а также можно добавить в текст статьи ссылку на несуществующую страницу, при нажатии на которую будет также предложено создать новую страницу.
 Пример:
@@ Строка 17: / Строка 17: @@
   * [[wiki/syntax]]
   * [[wiki/new]]
 ==== Удаление ====
 Для того, чтобы удалить страницу нужно:
-  - Удалить все ссылки на неё. Для этого в адресной строке добавляем к тому, что написано ?do=backlink. DоkuWiki выдаст все страницы, которые ссылаются на текущую.
+  * Удалить все ссылки на неё. Для этого в адресной строке добавляем к тому, что написано ?do=backlink. DоkuWiki выдаст все страницы, которые ссылаются на текущую. \\ В случае, если ссылки на страницу или её части могли использоваться для внедрения в другие статьи с помощью плагина Include, требуется поискать такие ссылки поиском в текстовых файлах DocuWiki (см. [[wiki/syntax#вставка_части_одной_статьи_в_другую_плагин_include|Вставка части одной статьи в другую (плагин Include)]]).
-  - На удаляемой странице нажать "Править", удалить весь текст и сохранить.
+  * На удаляемой странице нажать "Править", удалить весь текст и сохранить.
 ===== Форматирование текста =====
@@ Строка 38: / Строка 39: @@
 </code>
 //Курсив//
 При формировании списков нужно сначала ставить 2 пробела, затем спец символ (звёздочка для ненумерованного списка, минус для нумерованного). Если нужен элемент списка более нижнего уровня, то ставим перед символом на 2 пробела больше.
@@ Строка 53: / Строка 53: @@
   - Нумерованный список
   - Нумерованный список
 ===== Ссылки =====
@@ Строка 74: / Строка 75: @@
 Адреса электронной почты тоже распознаются: <andi@splitbrain.org>.
-==== Внутренние ссылки. ====
+==== Внутренние ссылки ====
 Внутренние ссылки создаются посредством квадратных скобок.
@@ Строка 87: / Строка 89: @@
 [[wiki/syntax]]
-Либо дополнительно прописать
+Либо дополнительно прописать:
 <code>
@@ Строка 176: / Строка 178: @@
 Пример:
-…описано в статье [[ru/csdesign/bpmodeling/epc_notation#команды_панели_инструментов_для_диаграммы_epc|Команды панели инструментов для диаграммы EPC]].
+…описаны в статье [[ru/csdesign/bpmodeling/epc_notation#команды_панели_инструментов_для_диаграммы_epc|Команды панели инструментов для диаграммы EPC]].
 Если в разделе одного документа дается ссылка на раздел другого документа, то перед ссылкой на раздел дается ссылка на документ. Если рядом дается 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/csdesign/csdesign]] внутри текста страницы выглядит как {{wiki/syntax/text.png?nolink}}
+==== Картинки ссылки ====
 Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:
@@ Строка 215: / Строка 225: @@
 Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.
+===== Картинки в DokuWiki =====
-===== Картинки в DokuWiki. =====
 Здесь приводятся способы вставки картинок при создании страниц в системе DokuWiki.
@@ Строка 265: / Строка 274: @@
 /media/ru/head1/img1.png.
@@ Строка 275: / Строка 283: @@
 Все большие изображение, шириной более 800 пикселей, нужно сжимать.
 Для сжатия использовать 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" (включая кавычки).\\
-Таким образом нужно прикреплять все файлы кроме картинок.
+Таким образом нужно прикреплять все файлы кроме картинок.\\
+\\
+**Внимание!** В ссылках, а также в названиях файлов не должно быть заглавных букв. Иначе ссылки на файлы не будут работать.
 ===== Прочий синтаксис. =====
@@ Строка 306: / Строка 337: @@
 Для того, чтобы вставить блок "Внимание" ("Примечания"), нужно использовать заголовок 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 =====
@@ Строка 361: / Строка 425: @@
 Если к странице нужно прикрепить несколько тагов, то разделяются они пробелами.\\
 Таги стоит вводить аккуратно, т.к. лишний символ = новый таг.
+[<contextnavigator>]