====== Особые случаи ======

===== Подпись =====

Зарегистрированный участник вики может при необходимости оставить свою подпись, используя __пиктограмму__ {{wiki:pg:sig.png}} на панели инструментов

===== Необрабатываемый текст =====

Необрабатываемый текст можно добавить в документ либо отделив его по крайней мере двумя пробелами от начала строки (как в случае с почти всеми примерами Справки), либо с использованием тэгов ''%%<code>%%'' ''%%</code>%%'' или ''%%<file>%%'' ''%%</file>%%''

  Это текст с двумя пробелами в начале строки

<code>
В этой строке сохранены все                 <- 17 пробелов
</code>

<file>
Применение тэга <file> указывает на то, что вы приводите содержание файла
</file>

Вот как это выглядит при правке:

    Это текст с двумя пробелами в начале строки

  <code>
  В этой строке сохранены все                 <- 17 пробелов
  </code>

  <file>
  Применение тэга <file> указывает на то, что вы приводите содержание файла
  </file>

===== Необрабатываемый текст-2 =====

Чтобы заставить парсер игнорировать участки текста (то есть не форматировать их), используйте тэги ''%%<nowiki>%%'' ''%%</nowiki>%%'' или два знака "процент" - ''<nowiki>%%</nowiki>''

<nowiki>
В этой строке содержатся URL http://www.splitbrain.org и **форматирование**.
А еще перенос. Но ничего не происходит
</nowiki>
То же верно для %%//__этого__ текста// со смайлом ;-)%%.

  <nowiki>
  В этой строке содержатся URL http://www.splitbrain.org и **форматирование**.
  А еще перенос. Но ничего не происходит
  </nowiki>
  То же верно для %%//__этого__ текста// со смайлом ;-)%%.

Вы можете просмотреть код этой страницы, чтобы лучше понять эффект тегов

===== Подсветка синтаксиса =====

DokuWiki может подсвечивать исходный код для разных языков программирования, тем самым облегчая его чтение и понимание. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] -- то есть все языки, поддерживаемые ею, подсвечиваются в DokuWiki. Для подсветки нужно добавить в тэги ''code'' и ''file'' атрибут - метку языка, например, ''%%<code java>%%'' или ''%%<file 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>

  <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>

<spoiler|В настоящее время поддерживаются следующие языки>
4cs\\
abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk\\
bash, 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\\
ecmascript, eiffel, email, erlang\\
fo, fortran, freebasic, fsharp\\
gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic\\
haskell, hicest, hq9plus, html\\
icon, idl, ini, inno, intercal, io\\
j, java5, java, javascript, jquery\\
kixtart, klonec, klonecpp\\
latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua\\
m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql\\
newlisp, nsis\\
oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz\\
pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python\\
q, qbasic\\
rails, rebol, reg, robots, rpmspec, rsplus, ruby\\
sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog\\
tcl, teraterm, text, thinbasic, tsql, typoscript\\
unicon\\
vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog\\
whitespace, winbatch, whois\\
xbasic, xml, xorg_conf, xpp\\
z80
</spoiler>

===== Ссылки на скачивание =====

При использовании тегов ''code'' и ''file'' можно добавить возможность скачать исходный код в виде файла, задав его имя после метки языка

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>

  <file php myexample.php>
  <?php echo "hello world!"; ?>
  </file>

Если нужна только ссылка на скачивание без подсветки, вместо метки языка поставьте тире - ''%%<code - myfile.foo>%%''

===== Встраивание HTML и PHP =====

Код HTML и PHP можно встроить в код страницы с помощью тэгов ''%%<html>%%'' ''%%</html>%%'' и ''%%<php>%%'' ''%%</php>%%''. Вставка HTML- и PHP-кода могут быть выключены администратором, в этом случае соответствующий код не обрабатывается, а просто отображается на странице

<spoiler|HTML-пример>
<html>
Здесь немного <span style="color:red;font-size:150%;">HTML-кода</span>
</html>

  <html>
  Здесь немного <span style="color:red;font-size:150%;">HTML-кода</span>
  </html>
</spoiler>
<spoiler|PHP-пример>
<php>
echo 'Логотип, сгенерированный PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
echo '(генерация логотипа)';
</php>

  <php>
  echo 'Логотип, сгенерированный PHP:';
  echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
  echo '(генерация логотипа)';
  </php>
</spoiler>
**Примечание**: PHP-код сейчас отключен, его пример недееспособен
===== RSS/ATOM Feed Aggregation =====
[[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://simplepie.org/|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:

^ Parameter  ^ Description ^
| any number | will be used as maximum number items to show, defaults to 8 |
| reverse    | display the last items in the feed first |
| author     | show item authors names |
| date       | show item dates |
| description| show the item description. If [[doku>config:htmlok|HTML]] is disabled all tags will be stripped |
| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |

The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.

**Example:**

  {{rss>http://slashdot.org/index.rss 5 author date 1h }}

{{rss>http://slashdot.org/index.rss 5 author date 1h }}


===== Control Macros =====

Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:

^ Macro           ^ Description |
| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |

[[8symbols|Назад]] : [[10plug-ins|Далее]]