Различия

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

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

Both sides previous revision Предыдущая версия
Следущая версия
Предыдущая версия
wiki:syntax [15.07.2015 18:50]
Игорь Дёмин
wiki:syntax [29.10.2022 21:26] (текущий)
Строка 1: Строка 1:
 ====== Синтаксис форматирования ====== ====== Синтаксис форматирования ======
  
-«Докувики» поддерживает простой язык разметки,​ который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции,​ которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи,​ нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться,​ просто используйте «[[playground:​playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[ru:​toolbar|панели инструментов]].+«Докувики» поддерживает простой язык разметки,​ который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции,​ которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи,​ нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться,​ просто используйте «[[playground:​playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[wiki:​toolbar|панели инструментов]].
  
 ===== Основные конструкции форматирования ===== ===== Основные конструкции форматирования =====
Строка 324: Строка 324:
 Чтобы увидеть,​ как используются эти блоки, смотрите код статьи. Чтобы увидеть,​ как используются эти блоки, смотрите код статьи.
  
-===== Подсветка синтаксиса ===== 
  
-«Докувики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека [[http://​qbnz.com/​highlighter/​|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''​code''​ в предыдущем разделе,​ но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%. 
- 
-<code java> 
-/**  
- * The HelloWorldApp class implements an application that 
- * simply displays "Hello World!"​ to the standard output. 
- */ 
-class HelloWorldApp { 
-    public static void main(String[] args) { 
-        System.out.println("​Hello World!"​);​ //Display the string. 
-    } 
-} 
-</​code>​ 
- 
-На данный момент распознаются следующие языки: 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 запрещена. Когда она запрещена,​ код не исполняется,​ а выводится в исходном виде. 
- 
-===== Управляющие макросы ===== 
- 
-Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:​ 
- 
-^ Макрос ​         ^ Описание ​     | 
-| %%~~NOTOC~~%% ​  | Если этот макрос присутствует в статье,​ оглавление не будет создано. ​ | 
-| %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например,​ когда выше был использован синтаксис %%<​php>​%%),​ добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове. ​ | 
- 
-===== Синтаксические плагины ===== 
- 
-Синтаксис «Докувики» может быть расширен за счёт [[ru:​plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте: 
- 
-~~INFO:​syntaxplugins~~ 
wiki/syntax.1436975422.txt.gz · Последние изменения: 29.10.2022 21:23 (внешнее изменение)
CC Attribution-Share Alike 3.0 Unported
Powered by PHP Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0 Valid HTML5