Различия

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

--- wiki:syntax [2014/05/27 11:48]
barinova [Ссылки на другие разделы документации]
+++ wiki:syntax [2017/07/18 14:15] (текущий)
@@ Строка 5: / Строка 5: @@
 ==== Создание ====
 Для того, чтобы создать страницу, нужно в конкретном разделе после адресной строки ввести её название латинскими буквами.
 <code>
 [[wiki/syntax/new]]
@@ Строка 11: / Строка 11: @@
 Выдастся сообщение о том, что страница не найдена и будет предложено её создать.
-Кроме того, название страницы можно вписать в адресную строку, добавив \имя к текущему адресу, а также можно добавить в текст статьи ссылку на несуществующую страницу, при нажатии на которую будет также предложено создать новую страницу.
+Кроме того, название страницы можно вписать в адресную строку, добавив /имя к текущему адресу, а также можно добавить в текст статьи ссылку на несуществующую страницу, при нажатии на которую будет также предложено создать новую страницу.
 Пример:
@@ Строка 22: / Строка 22: @@
 Для того, чтобы удалить страницу нужно:
-  * Удалить все ссылки на неё. Для этого в адресной строке добавляем к тому, что написано ?do=backlink. DоkuWiki выдаст все страницы, которые ссылаются на текущую.
+  * Удалить все ссылки на неё. Для этого в адресной строке добавляем к тому, что написано ?do=backlink. DоkuWiki выдаст все страницы, которые ссылаются на текущую. \\ В случае, если ссылки на страницу или её части могли использоваться для внедрения в другие статьи с помощью плагина Include, требуется поискать такие ссылки поиском в текстовых файлах DocuWiki (см. [[wiki/syntax#вставка_части_одной_статьи_в_другую_плагин_include|Вставка части одной статьи в другую (плагин Include)]]).
   * На удаляемой странице нажать "Править", удалить весь текст и сохранить.
@@ Строка 206: / Строка 206: @@
 (см. [[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}}
 ==== Картинки ссылки ====
@@ Строка 280: / Строка 287: @@
 Для сжатия использовать 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" (включая кавычки).\\
-Таким образом нужно прикреплять все файлы кроме картинок.
+Таким образом нужно прикреплять все файлы кроме картинок.\\
+\\
+**Внимание!** В ссылках, а также в названиях файлов не должно быть заглавных букв. Иначе ссылки на файлы не будут работать.
 ===== Прочий синтаксис. =====
@@ Строка 307: / Строка 338: @@
 Для того, чтобы вставить блок "Внимание" ("Примечания"), нужно использовать заголовок 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 =====