Различия

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

--- wiki:syntax [2014/01/27 15:47]
mac Переведено на русский
+++ wiki:syntax [2016/05/01 18:12]
mac Перевод на русский
@@ Строка 1: / Строка 1: @@
 ====== Синтаксис форматирования ======
-«ДокуВики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]». Простую разметку также можно легко сделать с помощью панели инструментов.
+«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[ru:toolbar|панели инструментов]].
 ===== Основные конструкции форматирования =====
-«ДокуВики» поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**.
+«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**.
 <code>
-«ДокуВики» поддерживает выделение текста **жирным шрифтом**, //курсивом//,
+«Докувики» поддерживает выделение текста **жирным шрифтом**, //курсивом//,
 __подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''.
 Все эти конструкции можно **__//''объединить''//__**.
@@ Строка 40: / Строка 40: @@
 ===== Ссылки =====
-Ссылки в «ДокуВики» бывают разные и создавать их можно тоже по-разному.
+Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному.
 ==== Внешние ====
@@ Строка 57: / Строка 57: @@
 Внутренние ссылки создаются посредством квадратных скобок.
-Можно либо просто указать [[pagename|имя страницы]], либо
+Можно либо просто указать [[ru:pagename|имя страницы]], либо
-дополнительно прописать [[pagename|текст ссылки]]. Имена
+дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
 вики-статей автоматически  переводятся в нижний регистр,
 спецсимволы использовать нельзя.
 <code>Внутренние ссылки создаются посредством квадратных скобок.
-Можно либо просто указать [[pagename|имя страницы]], либо
+Можно либо просто указать [[ru:pagename|имя страницы]], либо
-дополнительно прописать [[pagename|текст ссылки]]. Имена
+дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
 вики-статей автоматически  переводятся в нижний регистр,
 спецсимволы использовать нельзя.</code>
-Можно использовать в ссылке [[some:namespaces|пространства имён]] через двоеточие.
+Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.
-<code>Можно использовать в ссылке [[some:namespaces|пространства имён]] через двоеточие.</code>
+<code>Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.</code>
 Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на [[#внутренние|этот раздел]].
@@ Строка 78: / Строка 78: @@
 Примечания:
-  * Ссылки на [[wiki:syntax|существующие статьи]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]].
+  * Ссылки на [[ru:wiki:syntax|существующие статьи]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]].
-  * «ДокуВики» по умолчанию не использует [[wp>CamelCase|CamelCase]] (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле config. Проверка: если DokuWiki --- ссылка, значит эта возможность включена.
+  * «Докувики» по умолчанию не использует [[wp>ru:CamelCase|CamelCase]] (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле [[ru:config]]. Проверка: если DokuWiki --- ссылка, значит эта возможность включена.
   * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
+  * Ссылки на разделы делаются именно на [[#Разбивка на разделы|разделы]].
 ==== Интервики ====
-«ДокуВики» поддерживает [[doku>interwiki|интервики]]-ссылки. Это короткие ссылки на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
+«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки
+на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
-<code>«ДокуВики» поддерживает [[doku>interwiki|интервики]]-ссылки. Это короткие ссылки
+<code>«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки
 на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
 </code>
@@ Строка 100: / Строка 102: @@
   * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»).
   * В браузерах Mozilla эту возможность можно включить с помощью опции [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], но делать это не рекомендуется.
+  * Подробней читайте здесь: [[bug>151]].
 ==== Картинки-ссылки ====
@@ Строка 122: / Строка 125: @@
 Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%.
-==== Заголовок 3-го уровня ====
+==== Заголовок 3 уровня ====
-=== Заголовок 4-го уровня ===
+=== Заголовок 4 уровня ===
-== Заголовок 5-го уровня ==
+== Заголовок 5 уровня ==
-<code>==== Заголовок 3-го уровня ====
+<code>==== Заголовок 3 уровня ====
-=== Заголовок 4-го уровня ===
+=== Заголовок 4 уровня ===
-== Заголовок 5-го уровня ==</code>
+== Заголовок 5 уровня ==</code>
 Четыре и более тире преобразуются в горизонтальную черту:
@@ Строка 136: / Строка 139: @@
 ===== Картинки и другие файлы =====
-С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. По желанию можно указать их размер.
+См. также: «[[ru:images|Работа с изображениями и медиафайлами]]».
+С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:images|картинки]]. По желанию можно указать их размер.
 Нормальный размер:                        {{wiki:dokuwiki-128.png}}
@@ Строка 166: / Строка 171: @@
 И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).
-{{ wiki:dokuwiki-128.png |Логотип «ДокуВики»}}
+{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}
-<code>{{ wiki:dokuwiki-128.png |Логотип «ДокуВики»}}</code>
+<code>{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}</code>
 Если задать имя файла (внутреннее или внешнее), который не является картинкой (''gif, jpeg, png''), оно будет отображаться в виде ссылки.
@@ Строка 176: / Строка 181: @@
 ===== Списки =====
-«ДокуВики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или дефис (-) --- в случае нумерованного.
+«Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или дефис (-) --- в случае нумерованного.
   * Первый элемент маркированного списка
@@ Строка 184: / Строка 189: @@
   - Тот же список, только нумерованный
-  - Ещё элемент
+    - Ещё элемент
-    - Чем больше пробелов в начале, тем глубже вложенность
+      - Чем больше пробелов в начале, тем глубже вложенность
-  - Всё просто
+    - Всё просто
 <code>
@@ Строка 199: / Строка 204: @@
   - Всё просто
 </code>
+См. также [[ru:faq:lists|FAQ по элементам списка]].
 ===== Смайлики =====
-«ДокуВики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию ''smiley'' и добавить их в файл ''conf/smileys.local.conf''. Вот смайлики, которые есть в «ДокуВики»:
+«Докувики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию ''smiley'' и добавить их в файл ''conf/smileys.local.conf''. Вот смайлики, которые есть в «Докувики»:
   * 8-) %%8-)%%
@@ Строка 227: / Строка 234: @@
 ===== Типографские символы =====
-«ДокуВики» может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.
+«Докувики» может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.
 -> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...\\
@@ Строка 237: / Строка 244: @@
 </code>
-Примечание: это конвертирование можно отключить в файле конфигурации ''[[doku>entities|conf/entities.conf]]''.
+Примечание: это конвертирование можно отключить в файле конфигурации ''[[ru:entities|conf/entities.conf]]''.
 ===== Таблицы =====
-«ДокуВики» поддерживает упрощённый синтаксис создания таблиц.
+«Докувики» поддерживает упрощённый синтаксис создания таблиц.
 ^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
@@ Строка 319: / Строка 326: @@
 ===== Подсветка синтаксиса =====
-«ДокуВики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''code'' в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%.
+«Докувики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''code'' в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%.
 <code java>
@@ Строка 386: / Строка 393: @@
 ===== Управляющие макросы =====
-Некоторый синтаксис влияет на то, как «ДокуВики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:
+Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:
 ^ Макрос          ^ Описание      |
 | %%~~NOTOC~~%%   | Если этот макрос присутствует в статье, оглавление не будет создано.  |
-| %%~~NOCACHE~~%% | «ДокуВики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис %%<php>%%), добавление этого макроса заставит «ДокуВики» обрабатывать статью при каждом вызове.  |
+| %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис %%<php>%%), добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове.  |
 ===== Синтаксические плагины =====
-Синтаксис «ДокуВики» может быть расширен за счёт [[doku>plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «ДокуВики» на этом сайте:
+Синтаксис «Докувики» может быть расширен за счёт [[ru:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:
 ~~INFO:syntaxplugins~~

Улановка вики

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

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

Различия

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