Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия |
wiki:syntax.my [2023/08/19 15:29] – [Скрытый текст] vladpolskiy | wiki:syntax.my [2024/08/15 01:53] (текущий) – внешнее изменение 127.0.0.1 |
---|
====== Синтаксис форматирования ====== | ====== Синтаксис форматирования ====== |
| |
«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[ru:toolbar|панели инструментов]]. | «Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «[[playground:playground|песочницу]]». Простую разметку также можно легко сделать с помощью [[wiki:toolbar|панели инструментов]]. |
| |
===== Основные конструкции форматирования ===== | ===== Основные конструкции форматирования ===== |
Ещё можно <del>зачеркнуть текст</del>. | Ещё можно <del>зачеркнуть текст</del>. |
</code> | </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> |
| |
**Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке. | **Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке. |
| |
Внутренние ссылки создаются посредством квадратных скобок. | Внутренние ссылки создаются посредством квадратных скобок. |
Можно либо просто указать [[ru:pagename|имя страницы]], либо | Можно либо просто указать [[wiki:pagename|имя страницы]], либо |
дополнительно прописать [[ru:pagename|текст ссылки]]. Имена | дополнительно прописать [[wiki:pagename|текст ссылки]]. Имена |
вики-статей автоматически переводятся в нижний регистр, | вики-статей автоматически переводятся в нижний регистр, |
спецсимволы использовать нельзя. | спецсимволы использовать нельзя. |
| |
<code>Внутренние ссылки создаются посредством квадратных скобок. | <code>Внутренние ссылки создаются посредством квадратных скобок. |
Можно либо просто указать [[ru:pagename]], либо | Можно либо просто указать [[wiki:pagename]], либо |
дополнительно прописать [[ru:pagename|текст ссылки]]. Имена | дополнительно прописать [[wiki:pagename|текст ссылки]]. Имена |
вики-статей автоматически переводятся в нижний регистр, | вики-статей автоматически переводятся в нижний регистр, |
спецсимволы использовать нельзя.</code> | спецсимволы использовать нельзя.</code> |
| |
Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие. | Можно использовать в ссылке [[wiki:namespaces|пространства имён]] через двоеточие. |
| |
<code>Можно использовать в ссылке [[ru:namespaces|пространства имён]] через двоеточие.</code> | <code>Можно использовать в ссылке [[wiki:namespaces|пространства имён]] через двоеточие.</code> |
| |
Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на [[#внутренние|этот раздел]]. | Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на [[#внутренние|этот раздел]]. |
==== Интервики ==== | ==== Интервики ==== |
| |
«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки | «Докувики» поддерживает [[wiki:interwiki|интервики]]-ссылки. Это короткие ссылки |
на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]]. | на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]]. |
| |
<code>«Докувики» поддерживает [[ru:interwiki|интервики]]-ссылки. Это короткие ссылки | <code>«Докувики» поддерживает [[wiki:interwiki|интервики]]-ссылки. Это короткие ссылки |
на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]]. | на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]]. |
</code> | </code> |
===== Картинки и другие файлы ===== | ===== Картинки и другие файлы ===== |
| |
См. также: «[[ru:images|Работа с изображениями и медиафайлами]]». | См. также: «[[wiki:images|Работа с изображениями и медиафайлами]]». |
| |
С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru:images|картинки]]. По желанию можно указать их размер. | С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[wiki:images|картинки]]. По желанию можно указать их размер. |
| |
Нормальный размер: {{wiki:dokuwiki-128.png?50}} | Нормальный размер: {{wiki:dokuwiki-128.png?50}} |
</code> | </code> |
| |
См. также [[ru:faq:lists|FAQ по элементам списка]]. | См. также [[wiki:faq:lists|FAQ по элементам списка]]. |
| |
===== Смайлики ===== | ===== Смайлики ===== |
</code> | </code> |
| |
Примечание: это конвертирование можно отключить в файле конфигурации ''[[ru:entities|conf/entities.conf]]''. | Примечание: это конвертирование можно отключить в файле конфигурации ''[[wiki:entities|conf/entities.conf]]''. |
| |
===== Таблицы ===== | ===== Таблицы ===== |
| |
**Примечание:** по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде. | **Примечание:** по умолчанию вставка 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 | :!: При установленном плагине diagram |
| |
<code> | <code> |
{{tablelayout?colwidth="20px,30px"&rowsHeaderSource=1&rowsVisible=2&float=right}} | {{tablelayout?colwidth="100px,100px"&rowsHeaderSource=2&rowsVisible=3&float=left}} |
^ header 1 ^ header 2 ^ | ^ header 1 ^ header 2 ^ |
| cell A1 | cell B1 | | | cell A1 | cell B1 | |
</code> | </code> |
| |
{{tablelayout?colwidth="20px,30px"&rowsHeaderSource=1&rowsVisible=2&float=right}} | {{tablelayout?colwidth="100px,100px"&rowsHeaderSource=2&rowsVisible=3&float=left}} |
^ header 1 ^ header 2 ^ | ^ header 1 ^ header 2 ^ |
| cell A1 | cell B1 | | | cell A1 | cell B1 | |
===== Синтаксические плагины ===== | ===== Синтаксические плагины ===== |
| |
Синтаксис «Докувики» может быть расширен за счёт [[ru:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте: | Синтаксис «Докувики» может быть расширен за счёт [[wiki:plugins|плагинов]]. Как их устанавливать и использовать --- описывается на страницах плагинов. Следующие плагины доступны в инсталляции «Докувики» на этом сайте: |
| |
~~INFO:syntaxplugins~~ | ~~INFO:syntaxplugins~~ |