Различия

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

--- wiki:syntax.my [2023/08/19 13:50] – [Внутренние] vladpolskiy
+++ wiki:syntax.my [2024/08/15 01:53] (текущий) – внешнее изменение 127.0.0.1
@@ Строка 1: / Строка 1: @@
 ====== Синтаксис форматирования ======
-«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[ru:toolbar|панели инструментов]].
+«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[wiki:toolbar|панели инструментов]].
 ===== Основные конструкции форматирования =====
@@ Строка 26: / Строка 26: @@
 Ещё можно <del>зачеркнуть текст</del>.
 </code>
+:!: Цветной текст при установленном плагине Color
+<code>
+<color green>text</color>
+<color blue/lightgrey>text</color>
+<color #FF0000>text</color>
+<color /#FFff00>text</color>
+<color rgb(80%,0%,0%)/rgb(100%,80%,100%)>text</color>
+<color hsl(120,100%,30%):hsl(180,50%,90%)>text</color>
+</code>
+и вы увидите что-то вроде этого:
+<color green>text</color>
+<color blue/lightgrey>text</color>
+<color #FF0000>text</color>
+<color /#FFff00>text</color>
+<color rgb(80%,0%,0%)/rgb(100%,80%,100%)>text</color>
+<color hsl(120,100%,30%):hsl(180,50%,90%)>text</color>
 **Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.
@@ Строка 58: / Строка 78: @@
 Внутренние ссылки создаются посредством квадратных скобок.
-Можно либо просто указать [[ru:pagename|имя страницы]], либо
+Можно либо просто указать [[wiki:pagename|имя страницы]], либо
-дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
+дополнительно прописать [[wiki:pagename|текст ссылки]]. Имена
 вики-статей автоматически  переводятся в нижний регистр,
 спецсимволы использовать нельзя.
 <code>Внутренние ссылки создаются посредством квадратных скобок.
-Можно либо просто указать [[ru:pagename]], либо
+Можно либо просто указать [[wiki:pagename]], либо
-дополнительно прописать [[ru:pagename|текст ссылки]]. Имена
+дополнительно прописать [[wiki:pagename|текст ссылки]]. Имена
 вики-статей автоматически  переводятся в нижний регистр,
 спецсимволы использовать нельзя.</code>
-Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.
+Можно использовать в ссылке [[wiki:namespaces|пространства имён]] через двоеточие.
-<code>Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.</code>
+<code>Можно использовать в ссылке [[wiki:namespaces|пространства имён]] через двоеточие.</code>
 Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на [[#внутренние|этот раздел]].
@@ Строка 80: / Строка 100: @@
   * Ссылки на [[:wiki:syntax|существующие статьи]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]].
-  * «Докувики» по умолчанию не использует [[wp>ru:CamelCase|CamelCase]] (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле [[doku>config]]. Проверка: если DokuWiki --- ссылка, значит эта возможность включена.
+  * «Докувики» по умолчанию не использует [[wp>wiki:CamelCase|CamelCase]] (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле ''conf/dokuwiki.php'', см. подробнее [[:wiki:config:config]]. Проверка: если DokuWiki --- ссылка, значит эта возможность включена.
   * Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
   * Ссылки на разделы делаются именно на [[#Разбивка на разделы|разделы]].
@@ Строка 86: / Строка 106: @@
 ==== Интервики ====
-«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки
+«Докувики» поддерживает [[wiki:interwiki|интервики]]-ссылки. Это короткие ссылки
 на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
-<code>«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки
+<code>«Докувики» поддерживает [[wiki:interwiki|интервики]]-ссылки. Это короткие ссылки
 на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].
 </code>
@@ Строка 111: / Строка 131: @@
 <code>[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]</code>
-[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]
+{{tablelayout?rowsHeaderSource=auto}}
+^   ^   ^
+|<code>[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]</code>   |[[http://www.php.net/|{{wiki:dokuwiki-128.png?50}}]]   |
 Учтите: форматирование картинок --- это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.
@@ Строка 141: / Строка 164: @@
 ===== Картинки и другие файлы =====
-См. также: «[[ru:images|Работа с изображениями и медиафайлами]]».
+См. также: «[[wiki:images|Работа с изображениями и медиафайлами]]».
-С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:images|картинки]]. По желанию можно указать их размер.
+С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[wiki:images|картинки]]. По желанию можно указать их размер.
-Нормальный размер:                        {{wiki:dokuwiki-128.png}}
+Нормальный размер:                        {{wiki:dokuwiki-128.png?50}}
 Отмасштабированная до заданной ширины:    {{wiki:dokuwiki-128.png?50}}
@@ Строка 162: / Строка 185: @@
 Поставив слева или справа пробел, можно задать выравнивание картинки:
-{{wiki:dokuwiki-128.png }}
+{{wiki:dokuwiki-128.png?50 }}
-{{ wiki:dokuwiki-128.png}}
+{{ wiki:dokuwiki-128.png?50}}
-{{ wiki:dokuwiki-128.png }}
+{{ wiki:dokuwiki-128.png?50 }}
-<code>{{wiki:dokuwiki-128.png }} — картинка слева
+<code>{{wiki:dokuwiki-128.png?50 }} — картинка слева
-{{ wiki:dokuwiki-128.png }} — посередине
+{{ wiki:dokuwiki-128.png?50 }} — посередине
-{{ wiki:dokuwiki-128.png}} — справа
+{{ wiki:dokuwiki-128.png?50}} — справа
 </code>
 И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).
-{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}
+{{ wiki:dokuwiki-128.png?50 |Логотип «Докувики»}}
-<code>{{ wiki:dokuwiki-128.png |Логотип «Докувики»}}</code>
+<code>{{ wiki:dokuwiki-128.png?50 |Логотип «Докувики»}}</code>
 Если задать имя файла (внутреннее или внешнее), который не является картинкой (''gif, jpeg, png''), оно будет отображаться в виде ссылки.
@@ Строка 207: / Строка 230: @@
 </code>
-См. также [[ru:faq:lists|FAQ по элементам списка]].
+См. также [[wiki:faq:lists|FAQ по элементам списка]].
 ===== Смайлики =====
 «Докувики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию ''smiley'' и добавить их в файл ''conf/smileys.local.conf''. Вот смайлики, которые есть в «Докувики»:
-  * 8-) %%8-)%%
-  * 8-O %%8-O%%
-  * :-( %%:-(%%
-  * :-) %%:-)%%
-  * =) %%=)%%
-  * :-/ %%:-/%%
-  * :-\ %%:-\%%
-  * :-? %%:-?%%
-  * :-D %%:-D%%
-  * :-P %%:-P%%
-  * :-O %%:-O%%
-  * :-X %%:-X%%
-  * :-| %%:-|%%
-  * ;-) %%;-)%%
-  * ^_^ %%^_^%%
   * :?: %%:?:%%
   * :!: %%:!:%%
-  * LOL %%LOL%%
-  * FIXME %%FIXME%%
-  * DELETEME %%DELETEME%%
 ===== Типографские символы =====
@@ Строка 246: / Строка 251: @@
 </code>
-Примечание: это конвертирование можно отключить в файле конфигурации ''[[ru:entities|conf/entities.conf]]''.
+Примечание: это конвертирование можно отключить в файле конфигурации ''[[wiki:entities|conf/entities.conf]]''.
 ===== Таблицы =====
@@ Строка 342: / Строка 347: @@
 </code>
-На данный момент распознаются следующие языки: 4cs,  6502acme,  6502kickass,  6502tasm,  68000devpac,  abap,  actionscript3,  actionscript,  ada,  aimms,  algol68,  apache,  applescript,  apt_sources,  arm,  asm,  asp,  asymptote,  autoconf,  autohotkey,  autoit,  avisynth,  awk,  bascomavr,  bash,  basic4gl,  batch,  bf,  biblatex,  bibtex,  blitzbasic,  bnf,  boo,  caddcl,  cadlisp,  ceylon,  cfdg,  cfm,  chaiscript,  chapel,  cil,  c_loadrunner,  clojure,  c_mac,  cmake,  cobol,  coffeescript,  c,  cpp,  cpp-qt,  cpp-winapi,  csharp,  css,  cuesheet,  c_winapi,  dart,  dcl,  dcpu16,  dcs,  delphi,  diff,  div,  dos,  dot,  d,  ecmascript,  eiffel,  email,  epc,  e,  erlang,  euphoria,  ezt,  f1,  falcon,  fo,  fortran,  freebasic,  freeswitch,  fsharp,  gambas,  gdb,  genero,  genie,  gettext,  glsl,  gml,  gnuplot,  go,  groovy,  gwbasic,  haskell,  haxe,  hicest,  hq9plus,  html,  html4strict,  html5,  icon,  idl,  ini,  inno,  intercal,  io,  ispfpanel,  java5,  java,  javascript,  jcl,  j,  jquery,  julia,  kixtart,  klonec,  klonecpp,  kotlin,  latex,  lb,  ldif,  lisp,  llvm,  locobasic,  logtalk,  lolcode,  lotusformulas,  lotusscript,  lscript,  lsl2,  lua,  m68k,  magiksf,  make,  mapbasic,  mathematica,  matlab,  mercury,  metapost,  mirc,  mk-61,  mmix,  modula2,  modula3,  mpasm,  mxml,  mysql,  nagios,  netrexx,  newlisp,  nginx,  nimrod,  nsis,  oberon2,  objc,  objeck,  ocaml-brief,  ocaml,  octave,  oobas,  oorexx,  oracle11,  oracle8,  oxygene,  oz,  parasail,  parigp,  pascal,  pcre,  perl6,  perl,  per,  pf,  phix,  php-brief,  php,  pic16,  pike,  pixelbender,  pli,  plsql,  postgresql,  postscript,  povray,  powerbuilder,  powershell,  proftpd,  progress,  prolog,  properties,  providex,  purebasic,  pycon,  pys60,  python,  qbasic,  qml,  q,  racket,  rails,  rbs,  rebol,  reg,  rexx,  robots,  rpmspec,  rsplus,  ruby,  rust,  sas,  sass,  scala,  scheme,  scilab,  scl,  sdlbasic,  smalltalk,  smarty,  spark,  sparql,  sql,  standardml,  stonescript,  swift,  systemverilog,  tclegg,  tcl,  teraterm,  texgraph,  text,  thinbasic,  tsql,  twig,  typoscript,  unicon,  upc,  urbi,  uscript,  vala,  vbnet,  vb,  vbscript,  vedit,  verilog,  vhdl,  vim,  visualfoxpro,  visualprolog,  whitespace,  whois,  winbatch,  xbasic,  xml,  xojo,  xorg_conf,  xpp,  yaml,  z80,  zxbasic.
 ==== Скачиваемые блоки кода ====
@@ Строка 420: / Строка 424: @@
 **Примечание:** по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.
+===== Вставка HTML страниц =====
+:!: при установленном плагине **htmlok**
+<code html>
+<html>
+<iframe height="350" style="width: 100%;" scrolling="no" title="Untitled" src="https://book51.ru" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
+</iframe>
+</html>
+</code>
+<html>
+<iframe height="350" style="width: 100%;" scrolling="no" title="Untitled" src="https://book51.ru" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
+</iframe>
+</html>
+<code html>
+<html>
+<iframe height="300" style="width: 100%;" scrolling="no" title="Untitled" src="./demo/code/element_a.htm" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
+</iframe>
+</html>
+</code>
+<html>
+<iframe height="300" style="width: 100%;" scrolling="no" title="Untitled" src="./demo/code/element_a.htm" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
+</iframe>
+</html>
+===== Диаграммы =====
+:!: При установленном плагине diagram
+\\
+<code>
+<diagram>
+| | | Dad |y| Mom | | |Dad=Папа|Mom=Мама
+| |,|-|-|-|+|-|-|-|.| |
+| Sys | |  Me | | Bro |Sys=Сестра|Bro=Брат
+| |,|-|-|-|(||||| |
+| AAA |-| BBB |AAA=<color #22b14c>**примеры**</color>|BBB=1<sup>st</sup> верхний //регистр// и <del>ссылка</del> (see [[wp>Branch]])
+| |:| | | | | |
+| |L|~|~| CCC |CCC=2<sup>nd</sup> <color #ed1c24>нижний регистр</color>\\ **(жирный текст)**
+</diagram>
+</code>
+<diagram>
+| | | Dad |y| Mom | | |Dad=Папа|Mom=Мама
+| |,|-|-|-|+|-|-|-|.| |
+| Sys | |  Me | | Bro |Sys=Сестра|Bro=Брат
+| |,|-|-|-|(||||| |
+| AAA |-| BBB |AAA=<color #22b14c>**примеры**</color>|BBB=1<sup>st</sup> верхний //регистр// и <del>ссылка</del> (see [[wp>Branch]])
+| |:| | | | | |
+| |L|~|~| CCC |CCC=2<sup>nd</sup> <color #ed1c24>нижний регистр</color>\\ **(жирный текст)**
+</diagram>
+<code>
+<diagram>
+| AAA | | | | |F|~|~|~|7| |AAA{border-color:blue;background-color:lightgreen}=Border is blue,\\ background is lightgreen
+| |!| | | | | CCC | | DDD |CCC{border-color:#a9c}=Border is #a9c,\\ background is transparent|DDD{border-color:silver;background-color:silver;}=Border is silver,\\ background is silver
+| BBB | | | | | | | | | | |BBB{border-color:rgb(0%,50%,0%);background-color:#abcdef}=Border is green,\\ background is #abcdef
+</diagram>
+</code>
+\\
+<diagram>
+| AAA | | | | |F|~|~|~|7| |AAA{border-color:blue;background-color:lightgreen}=Border is blue,\\ background is lightgreen
+| |!| | | | | CCC | | DDD |CCC{border-color:#a9c}=Border is #a9c,\\ background is transparent|DDD{border-color:silver;background-color:silver;}=Border is silver,\\ background is silver
+| BBB | | | | | | | | | | |BBB{border-color:rgb(0%,50%,0%);background-color:#abcdef}=Border is green,\\ background is #abcdef
+</diagram>
+===== Скрытый текст =====
+:!: При установленном плагине Details Tag
+\\
+<code php>
+<details>
+<summary>«Подробности»</summary>
+Скрытый текст
+</details>
+</code>
+<details>
+<summary>«Подробности»</summary>
+Скрытый текст
+</details>
+<code php>
+<details open>
+<summary>«Подробности»</summary>
+Скрытый текст
+</details>
+</code>
+<details open>
+<summary>«Подробности»</summary>
+Скрытый текст
+</details>
+===== Ширина столбцов таблицы =====
+:!: При установленном плагине Tablelayout
+\\
+<code>
+{{tablelayout?colwidth="100px,100px"&rowsHeaderSource=2&rowsVisible=3&float=left}}
+^ header 1 ^ header 2 ^
+| cell A1 | cell B1 |
+| cell A2 | cell B2 |
+| cell A3 | cell B3 |
+</code>
+{{tablelayout?colwidth="100px,100px"&rowsHeaderSource=2&rowsVisible=3&float=left}}
+^ header 1 ^ header 2 ^
+| cell A1 | cell B1 |
+| cell A2 | cell B2 |
+| cell A3 | cell B3 |
 ===== RSS/ATOM Feed Aggregation =====
@@ Строка 455: / Строка 576: @@
 ===== Синтаксические плагины =====
-Синтаксис «Докувики» может быть расширен за счёт [[ru:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:
+Синтаксис «Докувики» может быть расширен за счёт [[wiki:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте:
 ~~INFO:syntaxplugins~~