Различия

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

--- wiki:syntax [2012/08/25 06:54] – [Internal] Щеглов С.В.
+++ 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 бывают разные, и создавать их можно тоже по-разному.
+DokuWiki supports multiple ways of creating links.
-==== Внешние ====
+==== External ====
-Внешние ссылки распознаются автоматически: http://www.google.com или
+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.
-просто www.google.com --- также можно указывать текст ссылки:
-[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
-тоже распознаются: <andi@splitbrain.org>.
-<code>Внешние ссылки распознаются автоматически: http://www.google.com или
-просто www.google.com --- также можно указывать текст ссылки:
-[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
-тоже распознаются: <andi@splitbrain.org>.</code>
-==== Внутренние ====
+  DokuWiki supports multiple ways of creating links. External links are recognized
+  automagically: http://www.google.com or simply www.google.com - You can set
+  link text as well: [[http://www.google.com|This Link points to google]]. Email
+  addresses like this one: <andi@splitbrain.org> are recognized, too.
-Внутренние ссылки создаются посредством квадратных скобок.
+==== Internal ====
-Можно либо просто указать [[Имя страницы]], либо дополнительно прописать
-[[Имя страницы|Текст ссылки]]. Имена Wiki-страниц автоматически
-переводятся в нижний регистр, спецсимволы использовать нельзя.
-<code>Внутренние ссылки создаются посредством квадратных скобок.
+Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].
-Можно либо просто указать [[Имя страницы]], либо дополнительно прописать
-[[Имя страницы|Текст ссылки]]. Имена Wiki-страниц автоматически
-переводятся в нижний регистр, спецсимволы использовать нельзя.</code>
-Можно использовать в ссылке [[namespaces]] (пространство имён) через двоеточие.
+  Internal links are created by using square brackets. You can either just give
+  a [[pagename]] or use an additional [[pagename|link text]].
-<code>Можно использовать в ссылке [[namespaces]] (пространство имён) через двоеточие.</code>
+[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
-Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку имя раздела, также как это делается в HTML. Ссылка на [[syntax#внутренние|этот раздел]].
+You can use [[some:namespaces]] by using a colon in the pagename.
-<code>Ссылка на [[syntax#внутренние|этот раздел]].</code>
+  You can use [[some:namespaces]] by using a colon in the pagename.
-Примечания:
+For details about namespaces see [[doku>namespaces]].
-  * Ссылки на [[syntax|существующие страницы]] отображаются иначе, чем ссылки на [[несуществующие]]
+Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax#internal|this Section]].
-  * Внутренние ссылки без указанного текста могут отображаться по разному в зависимости от настроек - в качестве текста может использоваться название страницы или заголовок первого уровня((именно такая настройка используется на этом сайте)). Так что лучше каждый раз указывать текст ссылки.
-  * DokuWiki по умолчанию не использует [[wp>CamelCase]] для автоматического создания ссылок, но эту возможность можно включить в файле [[doku>wiki:config]]. Проверка: Если DokuWiki — ссылка, значит эта возможность включена.
-  * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
+  This links to [[syntax#internal|this Section]].
+Notes:
+  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones.
+  * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled.
+  * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.
 ==== Interwiki ====
@@ Строка 101: / Строка 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 ====
@@ Строка 149: / Строка 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}}
@@ Строка 270: / Строка 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 =====
@@ Строка 386: / Строка 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>
@@ Строка 400: / Строка 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>