Различия

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

--- wiki:syntax [2012/08/25 06:52] – [External] Щеглов С.В.
+++ wiki:syntax [2025/07/04 04:56] (текущий) – внешнее изменение 127.0.0.1
@@ Строка 1: / Строка 1: @@
-====== Синтаксис форматирования ======
+====== Formatting Syntax ======
-DokuWiki поддерживает язык разметки, который по возможности сохраняет файлы данных как можно более читабельными! Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании страниц. Просто посмотрите на исходный код этой страницы, нажав кнопку Отредактировать страницу вверху или внизу страницы. Простую разметку также можно легко сделать с помощью [[quickbuttons|панели инструментов]]
+[[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing "Edit this page". If you want to try something, just use the [[playground:playground|playground]] page. The simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.
-===== Основные конструкции форматирования =====
+===== Basic Text Formatting =====
-DokuWiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчеркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**.
+DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
-<code>
+  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts.
-DokuWiki поддерживает выделение текста
+  Of course you can **__//''combine''//__** all these.
-**жирным шрифтом**,
-//курсивом//,
-__подчеркниванием текста__
-и вывод текста ''моноширинным шрифтом''.
-Все эти конструкции можно **__//''объединить''//__**.
-</code>
-Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.
+You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
-<code>
+  You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
-Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.
-</code>
-Ещё можно <del>зачеркнуть текст</del>.
+You can mark something as <del>deleted</del> as well.
-<code>
+  You can mark something as <del>deleted</del> as well.
-Ещё можно <del>зачеркнуть текст</del>.
-</code>
-**Параграфы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, не создавая параграф, вставьте два обратных слэша и за ним пробел или энтер.
+**Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
-Просто текст с разрывом строк\\ Обратите внимание,
+This is some text with some linebreaks\\ Note that the
-что два обратных слэша действуют только в конце строки\\
+two backslashes are only recognized at the end of a line\\
-или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.
+or followed by\\ a whitespace \\this happens without it.
-<code>Просто текст с разрывом строк\\ Обратите внимание,
+  This is some text with some linebreaks\\ Note that the
-что два обратных слэша действуют только в конце строки\\
+  two backslashes are only recognized at the end of a line\\
-или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.
+  or followed by\\ a whitespace \\this happens without it.
-</code>
+You should use forced newlines only if really needed.
-:!: Принудительные переносы следует использовать только в случае крайней необходимости.
+===== Links =====
-===== Ссылки =====
+DokuWiki supports multiple ways of creating links.
-Ссылки в DokuWiki бывают разные, и создавать их можно тоже по-разному.
+==== External ====
-==== Внешние ====
+External links are recognized automagically: http://www.google.com or simply www.google.com - You can set the link text as well: [[http://www.google.com|This Link points to google]]. Email addresses like this one: <andi@splitbrain.org> are recognized, too.
-Внешние ссылки распознаются автоматически: http://www.google.com или
+  DokuWiki supports multiple ways of creating links. External links are recognized
-просто www.google.com --- также можно указывать текст ссылки:
+  automagically: http://www.google.com or simply www.google.com - You can set
-[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
+  link text as well: [[http://www.google.com|This Link points to google]]. Email
-тоже распознаются: <andi@splitbrain.org>.
+  addresses like this one: <andi@splitbrain.org> are recognized, too.
-{{:dokuwiki-128.png|}}
-<code>Внешние ссылки распознаются автоматически: http://www.google.com или
-просто www.google.com --- также можно указывать текст ссылки:
-[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
-тоже распознаются: <andi@splitbrain.org>.</code>
 ==== Internal ====
@@ Строка 98: / Строка 84: @@
   * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone").
-  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/local.protected.php'':
+  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/userscript.js'':
-  $lang['js']['nosmblinks'] = '';
 ==== Image Links ====
@@ Строка 146: / Строка 132: @@
 Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)): {{wiki:dokuwiki-128.png?200x50}}
-Resized external image:           {{http://de3.php.net/images/php.gif?200x50}}
   Real size:                        {{wiki:dokuwiki-128.png}}
@@ Строка 267: / Строка 252: @@
   >>> Then lets do it!
-I think we should do it
-> No we shouldn't
->> Well, I say we should
-> Really?
->> Yes!
->>> Then lets do it!
 ===== Tables =====
@@ Строка 383: / Строка 357: @@
 ==== Syntax Highlighting ====
-[[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax is the same like in the code and file blocks in the previous section, but this time the name of the used language is inserted inside the tag. Eg. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
+[[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag, e.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
 <code java>
@@ Строка 397: / Строка 371: @@
 </code>
-The following language strings are currently recognized: //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//
+The following language strings are currently recognized: //4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, 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, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic//
 ==== Downloadable Code Blocks ====
-When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as above, you might want to make the shown code available for download as well. You can to this by specifying a file name after language code like this:
+When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this:
 <code>