Различия

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

wiki:syntax [2011/01/16 21:04]
127.0.0.1 внешнее изменение
wiki:syntax [2011/03/24 04:24] (текущий)
ViRUS
Строка 1: Строка 1:
-====== Formatting Syntax ======+====== Синтаксис форматирования ======
  
-[[doku>DokuWiki]] supports some simple markup languagewhich tries to make the datafiles to be as readable as possibleThis page contains all possible syntax you may use when editing the pagesSimply have a look at the source of this page by pressing the //Edit this page// button at the top or bottom of the pageIf you want to try somethingjust use the [[playground:playground|playground]] pageThe simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.+[[doku>DokuWiki]] поддерживает простой язык разметкикоторый позволяет делать статьи настолько удобочитаемыми насколько это возможноЭта статья содержит описание всего синтаксиса, который вы можете использовать при редактировании страницЧтобы начать редактирование, нажмите кнопку //Править страницу// сверху или снизу статьиЕсли вы хотите попробовать какой-либо элемент синтаксисакоторым ещё ни разу не применяли, воспользуйтесь [[playground:playground|песочницей]] для своих экспериментовТакже для разметки страницы вы можете использовать [[doku>toolbar|quickbuttons]].
  
-===== Basic Text Formatting =====+===== Базовое форматирование текста =====
  
-DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' textsOf course you can **__//''combine''//__** all these.+DokuWiki поддерживает **полужирный**, //курсив//, __подчёркнутый__ и ''моноширинный'' текстКонечно, вы можете всё это **__//''комбинировать''//__**.
  
-  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts+  DokuWiki поддерживает **полужирный**, //курсив//, __подчёркнутый__ и ''моноширинный'' текст
-  Of course you can **__//''combine''//__** all these.+  Конечно, вы можете всё это **__//''комбинировать''//__**.
  
-You can use <sub>subscript</sub> and <sup>superscript</sup>, too.+Вы можете использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> текст.
  
-  You can use <sub>subscript</sub> and <sup>superscript</sup>, too.+  Вы можете использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> текст.
  
-You can mark something as <del>deleted</del> as well.+Что-то вы можете пометить как <del>зачёркнутое</del>.
  
-  You can mark something as <del>deleted</del> as well.+  Что-то вы можете пометить как <del>зачёркнутое</del>.
  
-**Paragraphs** are created from blank linesIf you want to **force a newline** without a paragraphyou 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.+или если после них поставлен \пробел.
  
-  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.+  или если после них поставлен \пробел.
  
-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 или просто www.google.com. Вы можете установить название для ссылки: [[http://www.google.com|Эта ссылка ведёт на google]]. Аналогично для адресов электронной почты: <andi@splitbrain.org>.
  
-  DokuWiki supports multiple ways of creating linksExternal links are recognized +  DokuWiki поддерживает несколько способов создания ссылокВнешние ссылки распознаются 
-  automagically: http://www.google.com or simply www.google.com - You can set +  автоматически: http://www.google.com или просто www.google.com. Вы можете установить 
-  link text as well: [[http://www.google.com|This Link points to google]]. Email +  название для ссылки: [[http://www.google.com|Эта ссылка ведёт на google]]. 
-  addresses like this one: <andi@splitbrain.org> are recognized, too.+  Аналогично для адресов электронной почты: <andi@splitbrain.org>.
  
-==== Internal ====+==== Внутренние ====
  
-Internal links are created by using square bracketsYou can either just give a [[pagename]] or use an additional [[pagename|link text]].+Внутренние ссылки создаются с помощью квадратных скобокВы можете использовать просто [[имя страницы]] или установить [[pagename|название ссылки]].
  
-  Internal links are created by using square bracketsYou can either just give +  Внутренние ссылки создаются с помощью квадратных скобокВы можете использовать просто 
-  [[pagename]] or use an additional [[pagename|link text]].+  [[имя страницы]] или установить [[pagename|название ссылки]].
  
-[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.+[[doku>pagename|Названия страниц Wiki]] автоматически конвертируются в нижний регистр. Специальные символы не разрешены
  
-You can use [[some:namespaces]] by using a colon in the pagename.+Вы можете применять [[some:namespaces]], используя двоеточие в имени ссылки.
  
-  You can use [[some:namespaces]] by using a colon in the pagename.+  Вы можете применять [[some:namespaces]], используя двоеточие в имени ссылки.
  
-For details about namespaces see [[doku>namespaces]].+Детальную информацию читайте в документации по [[doku>namespaces]].
  
-Linking to a specific section is possible, tooJust add the section name behind a hash character as known from HTMLThis links to [[syntax#internal|this Section]].+Ссылки на конкретный раздел статьи также возможенПросто добавьте имя раздела после символа #Это ссылка на [[syntax#внутренние|этот раздел]].
  
-  This links to [[syntax#internal|this Section]].+  Это ссылка на [[syntax#внутренние|этот раздел]].
  
-Notes:+Примечание:
  
-  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. +  * Ссылки на [[syntax|существующие страницы]] отображаются в ином стиле нежели на [[несуществующие]]; 
-  * DokuWiki does not use [[wp>CamelCase]] to automatically create links by defaultbut this behavior can be enabled in the [[doku>config]] fileHintIf DokuWiki is a linkthen it's enabled. +  * DokuWiki не использует по умолчанию [[wp>CamelCase]] для автоматического создания ссылокоднако, это можно настроить в файле [[doku>config]]. Примечаниеесли DokuWiki является ссылкойзначит это включено; 
-  * When a section's heading is changed, its bookmark changestooSo don't rely on section linking too much.+  * Когда название раздела изменяетсяссылка на него так же претерпевает измененияПоэтому с осторожностью используйте их.
  
 ==== Interwiki ==== ==== Interwiki ====
  
-DokuWiki supports [[doku>Interwiki]] linksThese are quick links to other WikisFor example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].+DokuWiki поддерживает ссылки [[doku>Interwiki]]. Это ссылки на другие WikiНапример, ссылка на страницу Wikipedia о Wiki: [[wp>Wiki]]. 
 + 
 +  DokuWiki поддерживает ссылки [[doku>Interwiki]]. Это ссылки на другие Wiki. 
 +  Например, ссылка на страницу Wikipedia о Wiki: [[wp>Wiki]].
  
-  DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. 
-  For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]]. 
  
 ==== Windows Shares ==== ==== Windows Shares ====
  
-Windows shares like [[\\server\share|this]] are recognizedtoo. Please note that these only make sense in a homogeneous user group like a corporate [[wp>Intranet]]. +Ссылки Windows shares подобные [[\servershare|этой]] также распознаются. Помнитечто это имеет смысл только в однородной группе, например, в корпоративной [[wp>Intranet]].
- +
-  Windows Shares like [[\\server\share|this]] are recognized, too. +
- +
-Notes:+
  
-  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). +  Ссылки Windows shares подобные [[\servershare|этой]] также распознаются.
-  * 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'':+
  
-  $lang['js']['nosmblinks'= '';+Примечание: 
 +  * По соображениям безопасности прямой просмотр windows shares работает по умолчанию только в Microsoft Internet Explorer (и только в локальной зоне); 
 +  * Для Mozilla и Firefox это может быть включено с помощью параметра [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], но это не рекомендуется; 
 +  * Смотрите баг [[dokubug>151]], чтобы узнать больше информации.
  
-==== Image Links ====+==== Ссылки на изображениях ====
  
-You can also use an image to link to another internal or external page by combining the syntax for links and [[#images_and_other_files|images]] (see below) like this:+Вы можете использовать изображение как ссылку на какую-либо внутреннюю или внешнюю страницу, используя вместе синтаксис ссылки и [[wiki:syntax#изображения_и_другие_файлы|изображения]]. Например:
  
   [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]   [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
Строка 96: Строка 95:
 [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
  
-Please noteThe image formatting is the only formatting syntax accepted in link names.+Примечаниеформатирование изображений является единственным синтаксисом, разрешённым в ссылках.
  
-The whole [[#images_and_other_files|image]] and [[#links|link]] syntax is supported (including image resizinginternal and external images and URLs and interwiki links).+Синтаксис [[wiki:syntax#изображения_и_другие_файлы|изображений]] и [[wiki:syntax#ссылки|ссылок]] полностью поддерживается (включая изменения размера изображения, внутренние и внешние изображенияссылки и interwiki ссылки).
  
-===== Footnotes =====+===== Сноски =====
  
-You can add footnotes ((This is a footnote)) by using double parentheses.+Вы можете добавлять сноски ((это сноска)), используя двойные круглые скобки.
  
-  You can add footnotes ((This is a footnote)) by using double parentheses.+  Вы можете добавлять сноски ((это сноска)), используя двойные круглые скобки.
  
-===== Sectioning =====+===== Заголовки =====
  
-You can use up to five different levels of headlines to structure your contentIf you have more than three headlinesa table of contents is generated automatically -- this can be disabled by including the string ''<nowiki>~~NOTOC~~</nowiki>'' in the document.+Для структурирования статей вы можете использовать 5 разных типов заголовковЕсли вы применяете более чем 3 заголовкатаблица содержимого генерируется автоматически. Это может быть отключено с помощью включения строки ''<nowiki>~~NOTOC~~</nowiki>'' в документ.
  
-==== Headline Level 3 ==== +==== Заголовок. Уровень 3 ==== 
-=== Headline Level 4 === +=== Заголовок. Уровень 4 === 
-== Headline Level 5 ==+== Заголовок. Уровень 5 ==
  
-  ==== Headline Level 3 ==== +  ==== Заголовок. Уровень 3 ==== 
-  === Headline Level 4 === +  === Заголовок. Уровень 4 === 
-  == Headline Level 5 ==+  == Заголовок. Уровень 5 ==
  
-By using four or more dashesyou can make a horizontal line:+Использовав 4 или более дефисавы можете создавать горизонтальную линию:
  
 ---- ----
  
-===== Images and Other Files =====+===== Изображения и другие файлы =====
  
-You can include external and internal [[doku>images]] with curly bracketsOptionally you can specify the size of them.+Вы можете добавлять внешние или внутренние изображения с помощью фигурных скобокВ дополнение вы можете указать их размер.
  
-Real size:                        {{wiki:dokuwiki-128.png}}+Настоящий размер:                        {{wiki:dokuwiki-128.png}}
  
-Resize to given width:            {{wiki:dokuwiki-128.png?50}}+Изменение размера до указанной ширины:            {{wiki:dokuwiki-128.png?50}}
  
-Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the imageit will be cropped to the new ratio before resizing)): {{wiki:dokuwiki-128.png?200x50}}+Изменение размера до указанной ширины и высоты((когда соотношение заданных высоты и ширины не совпадает с соотношением сторон рисункаон обрезается до указанного соотношения перед масштабированием)): {{wiki:dokuwiki-128.png?200x50}}
  
-Resized external image:           {{http://de3.php.net/images/php.gif?200x50}}+Внешнее изображение с изменённым размером:           {{http://de3.php.net/images/php.gif?200x50}}
  
-  Real size                       {{wiki:dokuwiki-128.png}} +  Настоящий размер                                   {{wiki:dokuwiki-128.png}} 
-  Resize to given width           {{wiki:dokuwiki-128.png?50}} +  Изменение размера до указанной ширины              {{wiki:dokuwiki-128.png?50}} 
-  Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}} +  Изменение размера до указанной ширины и высоты     {{wiki:dokuwiki-128.png?200x50}} 
-  Resized external image:           {{http://de3.php.net/images/php.gif?200x50}}+  Внешнее изображение с изменённым размером:           {{http://de3.php.net/images/php.gif?200x50}}
  
  
-By using left or right whitespaces you can choose the alignment.+Используя пробелы, вы можете выбрать расположение изображения.
  
 {{ wiki:dokuwiki-128.png}} {{ wiki:dokuwiki-128.png}}
Строка 152: Строка 151:
   {{ wiki:dokuwiki-128.png }}   {{ wiki:dokuwiki-128.png }}
  
-Of course, you can add a title (displayed as a tooltip by most browsers), too.+Также вы можете указать заголовок (обычно отображаемый в виде всплывающей подсказки).
  
-{{ wiki:dokuwiki-128.png |This is the caption}}+{{ wiki:dokuwiki-128.png |Это сопроводительная надпись}}
  
-  {{ wiki:dokuwiki-128.png |This is the caption}}+  {{ wiki:dokuwiki-128.png |Это сопроводительная надпись}}
  
-If you specify a filename (external or internalthat is not an image (''gif, jpeg, png''), then it will be displayed as a link instead.+Если вы укажите файл (внешний или внутренний), который не является изображением (''gif, jpeg, png''), он будет отображён как ссылка.
  
-For linking an image to another page see [[#Image Links]] above.+Для сопровождения изображений ссылкой смотрите раздел [[wiki:syntax#ссылки_на_изображениях|ссылки на изображениях]].
  
-===== Lists =====+===== Списки =====
  
-Dokuwiki supports ordered and unordered listsTo create a list item, indent your text by two spaces and use a ''*'' for unordered lists or a ''-'' for ordered ones.+Dokuwiki поддерживает упорядоченные и неупорядоченные спискиДля создания списка сделайте отступ в 2 пробела и используйте ''*'' для неупорядоченного списка или ''-'' для упорядоченного.
  
-  * This is a list +  * Это список. Пункт 1; 
-  * The second item +  * Пункт 2; 
-    * You may have different levels +    * Вы можете делать ветвления; 
-  * Another item+  * Следующий пункт.
  
-  - The same list but ordered +  - Ещё один список, но с нумерованными пунктами; 
-  - Another item +  - Следующий пункт; 
-    - Just use indention for deeper levels +    - Здесь также доступны ветвления; 
-  - That's it+  - Последний пункт.
  
 <code> <code>
-  * This is a list +  * Это список. Пункт 1; 
-  * The second item +  * Пункт 2; 
-    * You may have different levels +    * Вы можете делать ветвления; 
-  * Another item+  * Следующий пункт.
  
-  - The same list but ordered +  - Ещё один список, но с нумерованными пунктами; 
-  - Another item +  - Следующий пункт; 
-    - Just use indention for deeper levels +    - Здесь также доступны ветвления; 
-  - That's it+  - Последний пункт.
 </code> </code>
  
-Also take a look at the [[doku>faq:lists|FAQ on list items]].+===== Смайлы =====
  
-===== Text Conversions ===== +DokuWiki преобразует часто используемые смайлы в их графические аналогиДополнительно смайлы могут быть помещены в папку ''smiley'' и настроены с помощью редактирования файла ''conf/smileys.conf''. Далее представлен список смайловкоторые включены в DokuWiki.
- +
-DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML. +
- +
-The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacementsbut can be configured to use other HTML as well. +
- +
-==== Text to Image Conversions ==== +
- +
-DokuWiki converts commonly used [[wp>emoticon]]s to their graphical equivalentsThose [[doku>Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki:+
  
   * 8-) %%  8-)  %%   * 8-) %%  8-)  %%
Строка 206: Строка 197:
   * =)  %%  =)   %%   * =)  %%  =)   %%
   * :-/ %%  :-/  %%   * :-/ %%  :-/  %%
-  * :-%%  :- %%+  * :- %%  :-  %%
   * :-? %%  :-?  %%   * :-? %%  :-?  %%
   * :-D %%  :-D  %%   * :-D %%  :-D  %%
Строка 221: Строка 212:
   * DELETEME %% DELETEME %%   * DELETEME %% DELETEME %%
  
-==== Text to HTML Conversions ====+===== Типографические символы =====
  
-Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entitiesHere is an example of recognized characters.+[[DokuWiki]] может преобразовывать простые текстовые символы в типографически корректныеДалее представлен список распознаваемых символов.
  
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
-"He thought 'It's a man's world'..."+"Он подумал: 'Это мужской мир'..."
  
 <code> <code>
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
-"He thought 'It's a man's world'..."+"Он подумал: 'Это мужской мир'..."
 </code> </code>
  
-The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]].+Примечание: преобразование может быть отключено с помощью редактирования [[doku>config:typography|файла конфигурации]] и [[doku>entities|файла шаблонов]].
  
-There are three exceptions which do not come from that pattern file: multiplication entity (640x480), 'single' and "double quotes". They can be turned off through a [[doku>config:typography|config option]].+===== Цитирование =====
  
-===== Quoting =====+Иногда возникает необходимость обозначить в тексте чью-то цитату. Для этого используется следующий синтаксис:
  
-Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: +  Я думаю, мы должны сделать это
- +
-  I think we should do it+
      
-  > No we shouldn't+  > Нет, не должны
      
-  >> WellI say we should+  >> Да нуя сказал, что должны
      
-  > Really?+  > Действительно?
      
-  >> Yes!+  >> Да!
      
-  >>> Then lets do it!+  >>> Ну тогда давай сделаем!
  
-I think we should do it+Я думаю, мы должны сделать это
  
-No we shouldn't+Нет, не должны
  
->> WellI say we should+>> Да нуя сказал, что должны
  
-Really?+Действительно?
  
->> Yes!+>> Да!
  
->>> Then lets do it!+>>> Ну, тогда давай сделаем!
  
-===== Tables =====+===== Таблицы =====
  
-DokuWiki supports a simple syntax to create tables.+DokuWiki поддерживает синтаксис для создания таблиц
  
-Heading      Heading       Heading 3          +Заголовок           Заголовок            Заголовок                 
-Row Col 1    | Row Col 2     | Row Col 3        | +Строка Стоблец 1    | Строка Стоблец 2     | Строка Стоблец 3        | 
-Row Col 1    | some colspan (note the double pipe) || +Строка Стоблец 1    | Объединённые ячейки                               || 
-Row Col 1    | Row 3 Col 2     | Row 3 Col 3        |+Строка Стоблец 1    | Строка 2 Стоблец 2     | Строка 2 Стоблец 3        |
  
-Table rows have to start and end with a ''|'' for normal rows or a ''^'' for headers.+Строки таблицы должны начинаться и заканчиваться на ''|'', заголовки --- ''^''.
  
-  ^ Heading      Heading       Heading 3          +  ^ Заголовок           Заголовок            Заголовок                 
-  | Row Col 1    | Row Col 2     | Row Col 3        | +  | Строка Стоблец 1    | Строка Стоблец 2     | Строка Стоблец 3        | 
-  | Row Col 1    | some colspan (note the double pipe) || +  | Строка Стоблец 1    | Объединённые ячейки                               || 
-  | Row Col 1    | Row 3 Col 2     | Row 3 Col 3        |+  | Строка Стоблец 1    | Строка 2 Стоблец 2     | Строка 2 Стоблец 3        |
  
-To connect cells horizontallyjust make the next cell completely empty as shown aboveBe sure to have always the same amount of cell separators!+Чтобы объединить соседние ячейки на одной строкедостаточно оставить следующую ячейку пустой, как это показано на примере вышеУдостоверьтесь, что у вас на каждой строке одинаковое количество разделителей!
  
-Vertical tableheaders are possible, too.+Вертикальные заголовки также возможны.
  
-             Heading            Heading          +            Заголовок                       Заголовок         
-Heading    Row Col          Row Col        +Заголовок 3 | Строка Столбец                Строка Столбец  
-Heading    no colspan this time                    +Заголовок 4 | На этот раз объединения ячеек нет                     
-Heading    Row Col          Row Col        |+Заголовок 5 | Строка Столбец                Строка Столбец  |
  
-As you can seeit's the cell separator before a cell which decides about the formatting:+Как вы можете видетьздесь форматирование произведено по-другому и объединения ячеек не происходит:
  
-  |              Heading            Heading          +  |             Заголовок                       Заголовок         
-  ^ Heading    Row Col          Row Col        +  ^ Заголовок 3 | Строка Столбец                Строка Столбец  
-  ^ Heading    no colspan this time                    +  ^ Заголовок 4 | На этот раз объединения ячеек нет                     
-  ^ Heading    Row Col          Row Col        |+  ^ Заголовок 5 | Строка Столбец                Строка Столбец  |
  
-You can have rowspans (vertically connected cells) by adding '':::'' into the cells below the one to which they should connect.+Примечаниеобъединение соседних ячеек в одном столбце невозможно.
  
-^ Heading 1      ^ Heading                  ^ Heading 3          ^ +Вы можете выравнивать содержимое в таблице. Просто добавьте как минимум пробела на противоположном конце текста. Добавьте или более пробела слева, чтобы выровнять по правому краю, справа --- чтобы выровнять по левому краю. Чтобы отцентровать текст, добавьте по или более пробела с каждой из сторон.
-| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | +
-| Row Col 1    | :::                        | Row Col 3        | +
-| Row 3 Col 1    | :::                        | Row 2 Col 3        |+
  
-Apart from the rowspan syntax those cells should not contain anything else.+^             Таблица с выравниванием             ^^^ 
 +|         справа|    по центру    |слева            | 
 +|слева          |           справа|    по центру    | 
 +| xxxxxxxxxxxxx | xxxxxxxxxxxxxxx | xxxxxxxxxxxxxxx |
  
-  ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ +Так эта таблица выглядит в исходнике:
-  | Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | +
-  | Row 2 Col 1    | :::                        | Row 2 Col 3        | +
-  | Row 3 Col 1    | :::                        | Row 2 Col 3        |+
  
-You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.+  ^             Таблица с выравниванием             ^^^ 
 +  |         справа|    по центру    |слева            | 
 +  |слева          |           справа|    по центру    | 
 +  | xxxxxxxxxxxxx | xxxxxxxxxxxxxxx | xxxxxxxxxxxxxxx |
  
-^           Table with alignment           ^^^ +===== Неформатируемые блоки =====
-|         right|    center    |left          | +
-|left          |         right|    center    | +
-| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |+
  
-This is how it looks in the source: +Вы можете добавлять блоки неформатируемого текста в свою статьюсделав отступ перед ним как минимум в 2 пробела (подобно предыдущим примерамили использовав теги ''code'' или ''file''.
- +
-  ^           Table with alignment           ^^^ +
-  |         right|    center    |left          | +
-  |left          |         right|    center    | +
-  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | +
- +
-Note: Vertical alignment is not supported. +
- +
-===== No Formatting ===== +
- +
-If you need to display text exactly like it is typed (without any formatting)enclose the area either with ''%%<nowiki>%%'' tags or even simpler, with double percent signs ''<nowiki>%%</nowiki>''. +
- +
-<nowiki> +
-This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. +
-</nowiki> +
-The same is true for %%//__this__ text// with a smiley ;-)%%. +
- +
-  <nowiki> +
-  This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. +
-  </nowiki> +
-  The same is true for %%//__this__ text// with a smiley ;-)%%. +
- +
-===== Code Blocks ===== +
- +
-You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examplesor by using the tags ''%%<code>%%'' or ''%%<file>%%''+
- +
-  This is text is indented by two spaces.+
  
 <code> <code>
-This is preformatted code all spaces are preserved: like              <-this+Это преформатированный текст, в котором все пробелы сохранены. Подобно              <-этому
 </code> </code>
  
 <file> <file>
-This is pretty much the samebut you could use it to show that you quoted a file.+Здесь практически тоже самоено вы можете показать, что цитируете документ 
 </file> </file>
  
-Those blocks were created by this source:+Чтобы игнорировать всю область полностью (то есть полностью исключить форматирование), заключите её тегом ''nowiki'' или двойным знаком процента (''<nowiki>%%</nowiki>'').
  
-    This is text is indented by two spaces.+<nowiki> 
 +Этот текст содержит адрес: http://www.splitbrain.org и **форматирование текста**, но никаких преобразований не выполняется. 
 +</nowiki>
  
-  <code> +Смотрите исходный текст этой страницы, чтобы увидеть, как эти блоки используются.
-  This is preformatted code all spaces are preserved: like              <-this +
-  </code>+
  
-  <file> +===== Подсветка синтаксиса =====
-  This is pretty much the same, but you could use it to show that you quoted a file. +
-  </file>+
  
-==== Syntax Highlighting ==== +[[wiki:DokuWiki]] может подсвечивать исходный кодчто позволяет делать его более удобным для восприятияДля этого используется [[http://qbnz.com/highlighter/|GeSHi]] (Generic Syntax Highlighter)Синтаксис аналогичен томучто разбирается в предыдущем разделе, но на этот раз в тег необходимо добавить имя используемого языкаНапример: ''<nowiki><code java></nowiki>''.
- +
-[[wiki:DokuWiki]] can highlight sourcecodewhich makes it easier to readIt uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supportedThe syntax is the same like in the code and file blocks in the previous sectionbut this time the name of the used language is inserted inside the tag. Eg. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.+
  
 <code java> <code java>
-/**+/** 
  * The HelloWorldApp class implements an application that  * The HelloWorldApp class implements an application that
  * simply displays "Hello World!" to the standard output.  * simply displays "Hello World!" to the standard output.
Строка 383: Строка 338:
 </code> </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//+Следующие языки на данный момент распознаются: //abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoit, bash, basic4gl, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, cil, cobol, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, dot, d, eiffel, fortran, freebasic, genero, glsl, gml, gnuplot, groovy, gettext, haskell, html, idl, ini, inno, io, java5, java, javascript, kixtart, klonec, klonecpp, latex, lisp, lotusformulas, lotusscript, lua, m68k, matlab, mirc, mpasm, mxml, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, per, php-brief, php, pic16, plsql, povray, powershell, progress, python, qbasic, rails, reg, robots, ruby, sas, scala, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, typoscript, vbnet, vb, verilog, vhdl, visualfoxpro, winbatch, xml, xorg_conf, xpp, z80//
  
-==== Downloadable Code Blocks ==== 
  
-When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as aboveyou might want to make the shown code available for download as wellYou can to this by specifying a file name after language code like this:+===== Ленты новостей в формате RSS/ATOM ===== 
 +В [[DokuWiki]] могут быть интегрированы данные из внешних XML-лент. Для их анализа используется [[http://simplepie.org/|SimplePie]]. Все форматыподдерживаемые SimplePie, могут быть использованы и в DokuWikiВы можете влиять на отображение с помощью добавления перечисленных далее параметров, разделённых с помощью пробелов:
  
-<code> +^ Параметр   ^ Описание ^ 
-<;file php myexample.php> +| any number | Используется для отображения максимального числа записейпо умолчанию 8| 
-<?php echo "hello world!"; ?> +| reverse    | Показывать первой в ленте новостей последнюю написанную запись. | 
-</file+| author     | Показывать имя автора записи. | 
-</code>+| date       | Показывать дату написания записи. | 
 +| description| Показывать описание записи. Если [[doku>config:htmlok|HTML]] отключён, то все теги будут игнорироваться. | 
 +| //n//[dhm] | Период обновления, где d=дни, h=часы, m=минуты (например 12h = 12 часов). |
  
-<file php myexample.php> +По умолчанию период обновления составляет 4 часаЛюбое значение обновления, установленное менее чем на 10 минут, будет округлено до него. [[wiki:DokuWiki]], как правило, кэширует статьи. Очевидно, что это неподходяще, когда статья содержит динамически обновляемый материал из внешнего источника. Данный параметр заставляет [[wiki:DokuWiki]] заново отображать страницу, если она хранится более, чем //период обновления//.
-<?php echo "hello world!"; ?> +
-</file>+
  
-If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code''%%<code - myfile.foo>%%''.+**Пример:**
  
 +  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
  
-===== Embedding HTML and PHP =====+{{rss>http://slashdot.org/index.rss 5 author date 1h }}
  
-You can embed raw HTML or PHP code into your documents by using the ''%%<html>%%'' or ''%%<php>%%'' tags. (Use uppercase tags if you need to enclose block level elements.) 
  
-HTML example:+===== Добавление кода HTML и PHP =====
  
 +Вы можете встраивать строки кода HTML или PHP в ваши статьи, используя теги ''html'' или ''php''. Например:
 <code> <code>
 <html> <html>
Строка 423: Строка 379:
 <p style="border:2px dashed red;">And this is some block HTML</p> <p style="border:2px dashed red;">And this is some block HTML</p>
 </HTML> </HTML>
- 
-PHP example: 
  
 <code> <code>
Строка 450: Строка 404:
 </PHP> </PHP>
  
-**Please Note**: HTML and PHP embedding is disabled by default in the configurationIf disabledthe code is displayed instead of executed.+**Примечание**: Встраивание кода HTML и 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 ^ +Некоторый синтаксис влияет на токак DokuWiki обрабатывает статьи без создания каких-либо результатов для себяДоступны следующие макросы:
-| any number | will be used as maximum number items to showdefaults to 8 | +
-| reverse    | display the last items in the feed first | +
-| author     | show item authors names | +
-| date       | show item dates | +
-| description| show the item descriptionIf [[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 hoursAny value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a pageobviously this is inappropriate when the page contains dynamic external contentThe parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.+^ Макрос          ^ Описание | 
 +| %%~~NOTOC~~%%   | Если этот макрос найден на странице, то оглавление таблицы не будет показано
 +| %%~~NOCACHE~~%% | DokuWiki по умолчанию кэширует все выходные данные. Иногда это нежелательно (например когда используется синтаксис %%<php>%%)Добавление этого макроса заставит DokuWiki каждый раз заново создавать страницу|
  
-**Example:**+===== Заметки =====
  
-  {{rss>http://slashdot.org/index.rss 5 author date 1h }} +Позволяет создавать акцентирующие внимание блоки текстазаметки, предупреждения и т.пВнутри заметок можно использовать некоторые инструменты wiki-синтаксиса.\ 
- +**Примеры использования:** 
-{{rss>http://slashdot.org/index.rss 5 author date 1h }}+<note>Это простая заметка</note> 
 +  <note>Это простая заметка</note>
  
 +<note important>Это заметка типа "Внимание!"</note>
 +  <note important>Это заметка типа "Внимание!"</note>
  
-===== Control Macros =====+<note tip>Замечание, совет, подсказка</note> 
 +  <note tip>Замечание, совет, подсказка</note>
  
-Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:+<note warning>Предупреждение 
 +  * Список 
 +  * **__форматирование текста__** 
 +</note>
  
-^ Macro           ^ Description | +  <note warning>Предупреждение 
-| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created | +  * Список 
-| %%~~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 |+  * **__форматирование текста__** 
 +  </note>
  
-===== Syntax Plugins =====+===== Плагины для расширения синтаксиса =====
  
-DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pagesThe following syntax plugins are available in this particular DokuWiki installation:+Синтаксис DokuWiki может быть расширен с помощью [[doku>plugins|плагинов]]. Как использовать установленные плагины, вы можете узнать на страницах их описанияВ данной установке DokuWiki доступны следующие плагины для расширения синтаксиса:
  
 ~~INFO:syntaxplugins~~ ~~INFO:syntaxplugins~~
  
wiki/syntax.txt · Последние изменения: 2011/03/24 04:24 — ViRUS
CC Attribution-Share Alike 3.0 Unported
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0