Архивная вики. Статьи постепенно переезжают в библиотеку портала. Когда перенос закончится, этот раздел закроем. Актуальный сайт — Dark Swords.

Dark Swords Wiki
Вы посетили:
Управление Показать страницу

Различия

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

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

Предыдущая версия справа и слева Предыдущая версия
Следующая версия 		Предыдущая версия
wiki:syntax [2016/11/20 11:28]
administrator 		wiki:syntax [2020/06/17 17:45] (текущий)
messiah [Картинки и другие файлы]
Строка 1: Строка 1:
 +Нужно перечитать и исправить FIXME
 +
 +
 ====== Синтаксис форматирования ====== ====== Синтаксис форматирования ======
  
-«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[ru:toolbar|панели инструментов]].+«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]».
  
 ===== Основные конструкции форматирования ===== ===== Основные конструкции форматирования =====
Строка 57: Строка 60:
  
 Внутренние ссылки создаются посредством квадратных скобок. Внутренние ссылки создаются посредством квадратных скобок.
-Можно либо просто указать [[ru:pagename|имя страницы]], либо +Можно либо просто указать [[pagename|имя страницы]], либо 
-дополнительно прописать [[ru:pagename|текст ссылки]]. Имена+дополнительно прописать [[pagename|текст ссылки]]. Имена
 вики-статей автоматически  переводятся в нижний регистр, вики-статей автоматически  переводятся в нижний регистр,
 спецсимволы использовать нельзя. спецсимволы использовать нельзя.
  
 <code>Внутренние ссылки создаются посредством квадратных скобок. <code>Внутренние ссылки создаются посредством квадратных скобок.
-Можно либо просто указать [[ru:pagename|имя страницы]], либо +Можно либо просто указать [[pagename|имя страницы]], либо 
-дополнительно прописать [[ru:pagename|текст ссылки]]. Имена+дополнительно прописать [[pagename|текст ссылки]]. Имена
 вики-статей автоматически  переводятся в нижний регистр, вики-статей автоматически  переводятся в нижний регистр,
 спецсимволы использовать нельзя.</code> спецсимволы использовать нельзя.</code>
  
-Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.+Можно использовать в ссылке [[namespaces|пространства имён]] через двоеточие.
  
-<code>Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.</code>+<code>Можно использовать в ссылке [[namespaces|пространства имён]] через двоеточие.</code>
  
 Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на [[#внутренние|этот раздел]]. Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на [[#внутренние|этот раздел]].
Строка 78: Строка 81:
 Примечания: Примечания:
  
-  * Ссылки на [[ru:wiki:syntax|существующие статьи]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]]. +  * Ссылки на [[wiki:syntax|существующие статьи]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]].
-  * «Докувики» по умолчанию не использует [[wp>ru:CamelCase|CamelCase]] (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле [[ru:config]]. Проверка: если DokuWiki --- ссылка, значит эта возможность включена.+
   * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.   * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
   * Ссылки на разделы делаются именно на [[#Разбивка на разделы|разделы]].   * Ссылки на разделы делаются именно на [[#Разбивка на разделы|разделы]].
  
-==== Интервики ====+==== Собирательные ссылки ==== 
 +Можно встраивать текст одной статьи в другую. Это необходимо для поддержания работоспособности как ссылок не отдельные статьи, так и для создания большой сборной статьи
  
-«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки +Например, ниже вставлена статья про Администраторов игры:
-на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].+
  
-<code>«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки +{{page>:Администратор}}
-на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]]. +
-</code>+
  
-==== Сетевые ресурсы Windows ====+<code>{{page>Администратор}}</code>
  
-Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном интранете. 
- 
-<code>Ссылки на сетевые ресурсы вида \\server\share тоже распознаются.</code> 
- 
-Примечания: 
- 
-  * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»). 
-  * В браузерах Mozilla эту возможность можно включить с помощью опции [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], но делать это не рекомендуется. 
-  * Подробней читайте здесь: [[bug>151]]. 
  
 ==== Картинки-ссылки ==== ==== Картинки-ссылки ====
Строка 140: Строка 131:
 ===== Картинки и другие файлы ===== ===== Картинки и другие файлы =====
  
-См. также: «[[ru:images|Работа с изображениями и медиафайлами]]».+См. также: «[[images|Работа с изображениями и медиафайлами]]».
  
-С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:images|картинки]]. По желанию можно указать их размер.+С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[images|картинки]]. По желанию можно указать их размер.
  
 Нормальный размер:                        {{wiki:dokuwiki-128.png}} Нормальный размер:                        {{wiki:dokuwiki-128.png}}
Строка 150: Строка 141:
 Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}} Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}}
  
-Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}+Отмасштабированная внешняя картинка:      {{http://flow.darkswords.ru/darkswords/avatars/794.jpg?200x50}}
  
 <code> <code>
Строка 156: Строка 147:
 Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}} Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}}
 Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}} Отмасштабированная до заданных размеров:  {{wiki:dokuwiki-128.png?200x50}}
-Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}+Отмасштабированная внешняя картинка:      {{http://flow.darkswords.ru/darkswords/avatars/794.jpg?200x50}}
 </code> </code>
  
Строка 206: Строка 197:
 </code> </code>
  
-См. также [[ru:faq:lists|FAQ по элементам списка]].+См. также [[faq:lists|FAQ по элементам списка]].
  
 ===== Смайлики ===== ===== Смайлики =====
Строка 245: Строка 236:
 </code> </code>
  
-Примечание: это конвертирование можно отключить в файле конфигурации ''[[ru:entities|conf/entities.conf]]''.+Примечание: это конвертирование можно отключить в файле конфигурации ''[[entities|conf/entities.conf]]''.
  
 ===== Таблицы ===== ===== Таблицы =====
Строка 343: Строка 334:
 На данный момент распознаются следующие языки: 4cs;, **a**bap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, **b**ash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, **c**, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, **d**, dcs, delphi, diff, div, dos, dot, **e**cmascript, eiffel, email, erlang, **f**o, fortran, freebasic, fsharp, **g**ambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, **h**askell, hicest, hq9plus, html, **i**con, idl, ini, inno, intercal, io, **j**, java5, java, javascript, jquery, **k**ixtart, klonec, klonecpp, **l**atex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, **m**68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, **n**ewlisp, nsis, **o**beron2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, **p**ascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, **q**, qbasic, **r**ails, rebol, reg, robots, rpmspec, rsplus, ruby, **s**as, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, **t**cl, teraterm, text, thinbasic, tsql, typoscript, **u**nicon, **v**ala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, **w**hitespace, winbatch, whois, **x**basic, xml, xorg_conf, xpp, **z**80. На данный момент распознаются следующие языки: 4cs;, **a**bap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, **b**ash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, **c**, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, **d**, dcs, delphi, diff, div, dos, dot, **e**cmascript, eiffel, email, erlang, **f**o, fortran, freebasic, fsharp, **g**ambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, **h**askell, hicest, hq9plus, html, **i**con, idl, ini, inno, intercal, io, **j**, java5, java, javascript, jquery, **k**ixtart, klonec, klonecpp, **l**atex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, **m**68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, **n**ewlisp, nsis, **o**beron2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, **p**ascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, **q**, qbasic, **r**ails, rebol, reg, robots, rpmspec, rsplus, ruby, **s**as, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, **t**cl, teraterm, text, thinbasic, tsql, typoscript, **u**nicon, **v**ala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, **w**hitespace, winbatch, whois, **x**basic, xml, xorg_conf, xpp, **z**80.
  
-==== Скачиваемые блоки кода ==== 
  
-Используя тэги ''%%<code>%%'' или ''%%<file>%%'', как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так: 
- 
-<code> 
-<file php myexample.php> 
-<?php echo "hello world!"; ?> 
-</file> 
-</code> 
- 
-<file php myexample.php> 
-<?php echo "hello world!"; ?> 
-</file> 
- 
-Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (''-'') на месте кода языка: ''%%<code - myfile.foo>%%''. 
- 
-**Особенность:** при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками например "Фоо Бар.php". 
-<file php "Фоо Бар.php"> 
-<?php echo "hello world!"; ?> 
-</file> 
- 
-===== Вставка HTML и PHP ===== 
- 
-Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов ''html'' ((''html'' --- для строчного кода; ''HTML'' --- для блочного кода)) и ''php'': 
- 
-<code html> 
-<html> 
-Тут вставлен <font color="red" size="+1">HTML-код</font> 
-</html> 
-</code> 
- 
-<html> 
-Тут вставлен <font color="red" size="+1">HTML-код</font> 
-</html> 
- 
-<code php> 
-<php> 
-echo 'Логотип, сгенерированный PHP:'; 
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />'; 
-</php> 
-</code> 
- 
-<php> 
-echo 'Логотип, сгенерированный PHP:'; 
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />'; 
-</php> 
- 
-**Примечание**: по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде. 
  
 ===== Управляющие макросы ===== ===== Управляющие макросы =====
Строка 398: Строка 342:
 ^ Макрос          ^ Описание      | ^ Макрос          ^ Описание      |
 | %%~~NOTOC~~%%   | Если этот макрос присутствует в статье, оглавление не будет создано.  | | %%~~NOTOC~~%%   | Если этот макрос присутствует в статье, оглавление не будет создано.  |
-| %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис %%<php>%%), добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове.  | +| %%~~REDIRECT>НАЗВАНИЕ_СТРАНИЦЫ~~%% | Создает перенаправление с одной страницы на другую. Необходимо для создания страниц-синонимов|
- +
-===== Синтаксические плагины ===== +
- +
-Синтаксис «Докувики» может быть расширен за счёт [[ru:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:+
  
-~~INFO:syntaxplugins~~ 
wiki/syntax.1479630531.txt.gz · Последнее изменение: 2020/03/15 19:56 (внешнее изменение)
Наверх
Показать страницу История страницы Недавние изменения Все страницы