Syntax: различия между версиями
(Чуть изменил описание, что бы было понятнее) |
(→Видимый заголовок: Добавил про заголовки) |
||
(не показано 50 промежуточных версий 1 участника) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: | {{DISPLAYTITLE: Синтаксис элементов страницы}} | ||
== | == Видимое название == | ||
Ссылки на страницы с русскоязычным наименованием смотрятся плохо, поэтому мы стараемся новые страницы называть короткой англоязычной фразой. | Ссылки на страницы с русскоязычным наименованием смотрятся плохо, поэтому мы стараемся новые страницы называть короткой англоязычной фразой. | ||
Таким страницам нужно назначать видимое название на русском языке, которое будет показано вверху страницы. | |||
'''Код''' | '''Код''' | ||
Строка 20: | Строка 10: | ||
<pre> | <pre> | ||
{{DISPLAYTITLE: Название }} | {{DISPLAYTITLE: Название }} | ||
</pre> | </pre> | ||
== Заголовки == | == Заголовки == | ||
Чтобы страницу было легко читать, мы структурируем её заголовками, начиная со второго уровня. Первый уровень — это название статьи, оно есть всегда и в теле статьи мы его не используем. | |||
Текст, выделенный тегом <code>=</code> становится заголовком, количество чёрточек показывает его уровень. Тег парный, поэтому он ставится и до и после текста: | |||
Текст, выделенный тегом <code>=</code> становится заголовком, количество чёрточек показывает его уровень. Тег парный, поэтому он ставится до и после текста | |||
<pre> | <pre> | ||
== Заголовок второго уровня == | == Заголовок второго уровня == | ||
Строка 47: | Строка 21: | ||
=== Заголовок третьего уровня === | === Заголовок третьего уровня === | ||
==== Заголовок | ==== Заголовок четвертого уровня ==== | ||
</pre> | </pre> | ||
Строка 60: | Строка 34: | ||
</pre> | </pre> | ||
== | == Включение == | ||
Если какой-то текст повторяется в нескольких статьях, то мы выносим его во включения. | Если какой-то текст повторяется в нескольких статьях, то мы выносим его во включения. | ||
Строка 69: | Строка 42: | ||
</pre> | </pre> | ||
Включения нужно изменять с большой осторожностью, так как изменение текста в одном месте повлияет на несколько страниц одновременно | Включения нужно изменять с большой осторожностью, так как изменение текста в одном месте повлияет на несколько страниц одновременно. | ||
Внутри включения можно использовать теги: | Внутри включения можно использовать теги: | ||
Строка 80: | Строка 53: | ||
Список включений можно посмотреть на [[Список_шаблонов | странице с шаблонами]]. | Список включений можно посмотреть на [[Список_шаблонов | странице с шаблонами]]. | ||
== Выделение текста == | == Выделение текста == | ||
Строка 153: | Строка 117: | ||
#* Второй пункт вложенного | #* Второй пункт вложенного | ||
# Второй пункт | # Второй пункт | ||
# Третий пункт | # Третий пункт | ||
Строка 195: | Строка 138: | ||
[[Название страницы#Название раздела | Видимый текст]] | [[Название страницы#Название раздела | Видимый текст]] | ||
</pre> | </pre> | ||
'''Примеры:''' | '''Примеры:''' | ||
Строка 230: | Строка 167: | ||
== Изображение == | == Изображение == | ||
По умолчанию изображения выравниваем по правому краю: | |||
По умолчанию изображения | |||
<pre> | <pre> | ||
[[Image: FileName | [[Image: FileName |300px|thumb|right| Подпись ]] | ||
</pre> | </pre> | ||
Если нужно показать на изображении определенные шаги, то можно сделать выравнивание по центру: | |||
<pre> | <pre> | ||
[[Image: FileName | [[Image: FileName |300px|thumb|none| Подпись ]] | ||
</pre> | </pre> | ||
Если изображений много — оформить в виде [[#Галерея | галереи]]. | |||
== Галерея == | == Галерея == | ||
Галерея позволяет компактно разместить несколько изображений. При уменьшении ширины экрана они уедут друг под друга | Галерея позволяет компактно разместить несколько изображений. При уменьшении ширины экрана они уедут друг под друга. | ||
<syntaxhighlight lang="html"> | <syntaxhighlight lang="html"> | ||
<gallery mode=" | <gallery mode="traditional " widths ="500px" heights="250px"> | ||
Image: FileName1 | Описание | Image: FileName1 | Описание | ||
Image: FileName2 | Описание | Image: FileName2 | Описание | ||
Строка 309: | Строка 189: | ||
</gallery> | </gallery> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Листинг команды == | == Листинг команды == | ||
Строка 334: | Строка 208: | ||
=== Команда с выводом === | === Команда с выводом === | ||
Если вы хотите показать вывод, то копировать команды нужно с куском приглашения, без пользователя и имени хоста. | |||
'''Код''' | '''Код''' | ||
<pre> | <pre> | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="bash"> | ||
# dpkg -s wb-hwconf-manager |grep Version | ~# dpkg -s wb-hwconf-manager |grep Version | ||
Version: 1.37.0 | Version: 1.37.0 | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Строка 345: | Строка 219: | ||
'''Результат''' | '''Результат''' | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="bash"> | ||
# dpkg -s wb-hwconf-manager |grep Version | ~# dpkg -s wb-hwconf-manager |grep Version | ||
Version: 1.37.0 | Version: 1.37.0 | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Листинг кода == | == Листинг кода == | ||
<syntaxhighlight lang="html"> | <syntaxhighlight lang="html"> | ||
код | код | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Список языков: https://pygments.org/languages/, для подсветки листинга правил использовать язык ''ecmascript''. | Список языков: https://pygments.org/languages/, для подсветки листинга правил использовать язык ''ecmascript''. | ||
Строка 440: | Строка 296: | ||
|} | |} | ||
Полезно почитать про [https://www.mediawiki.org/wiki/Help:Tables/ru синтаксис создания таблиц | Полезно почитать про [https://www.mediawiki.org/wiki/Help:Tables/ru синтаксис создания таблиц]. |
Версия 16:41, 25 августа 2021
Видимое название
Ссылки на страницы с русскоязычным наименованием смотрятся плохо, поэтому мы стараемся новые страницы называть короткой англоязычной фразой.
Таким страницам нужно назначать видимое название на русском языке, которое будет показано вверху страницы.
Код
{{DISPLAYTITLE: Название }}
Заголовки
Чтобы страницу было легко читать, мы структурируем её заголовками, начиная со второго уровня. Первый уровень — это название статьи, оно есть всегда и в теле статьи мы его не используем.
Текст, выделенный тегом =
становится заголовком, количество чёрточек показывает его уровень. Тег парный, поэтому он ставится и до и после текста:
== Заголовок второго уровня == === Заголовок третьего уровня === ==== Заголовок четвертого уровня ====
Перенаправление
Иногда, на страницах может встретиться перенаправление, которое лучше не трогать — это может нарушить связи между страницами.
Перенаправление ставят администраторы Wiki.
Код
#REDIRECT [[название_страницы]]
Включение
Если какой-то текст повторяется в нескольких статьях, то мы выносим его во включения.
В тексте это выглядит так:
{{Wbincludes:Name}}
Включения нужно изменять с большой осторожностью, так как изменение текста в одном месте повлияет на несколько страниц одновременно.
Внутри включения можно использовать теги:
- onlyinclude — будет вставлен текст из этого тега, но он не будет отображаться на странице включения.
<onlyinclude> Этот текст будет включен в другую страницу </onlyinclude>
- noinclude — текст из этого тега будет виден на странице включения, но не будет вставлен в другую страницу.
<noinclude> Этот текст не будет включен в другую страницу </noinclude>
По умолчанию, весь текст на странице включения будет вставлен в другую страницу.
Список включений можно посмотреть на странице с шаблонами.
Выделение текста
Для выделения текста нужно использовать wiki-разметку.
Наклонный текст
''Наклонный текст''
Жирный текст
'''Жирный текст'''
Жирный наклонный текст
'''''Жирный наклонный текст'''''
Списки
Список может быть нумерованным и маркированным, а также иметь вложения любого типа.
Нумерованный
Нумерованный список:
# Первый пункт # Второй пункт # Третий пункт
Результат:
- Первый пункт
- Второй пункт
- Третий пункт
Маркированный
Маркированный список:
* Первый пункт * Второй пункт * Третий пункт
Результат:
- Первый пункт
- Второй пункт
- Третий пункт
Вложенный
Обычно внутрь нумерованного списка нужно вложить маркированный:
# Первый пункт #* Первый пункт вложенного #* Второй пункт вложенного # Второй пункт # Третий пункт
Результат:
- Первый пункт
- Первый пункт вложенного
- Второй пункт вложенного
- Второй пункт
- Третий пункт
Ссылка
Внутренняя
Все ссылки на страницы и ресурсы на Wiki оформляем как внутренние:
[[Название страницы]]
[[Название страницы | Отображаемое имя]]
Также можно сослаться на определённый раздел:
[[#Название раздела]]
[[Название страницы#Название раздела | Видимый текст]]
Примеры:
[[Заглавная страница]]
[[Заглавная страница | Главная страница Wiki]]
[[#Списки]]
[[Заглавная страница#Диммеры | Раздел «Диммеры» на главной странице]]
Раздел «Диммеры» на главной странице
Внешняя
Ссылки на интернет-магазин и внешние ресурсы оформляем как внешние:
[https://wirenboard.com Отображаемое имя]
Изображение
По умолчанию изображения выравниваем по правому краю:
[[Image: FileName |300px|thumb|right| Подпись ]]
Если нужно показать на изображении определенные шаги, то можно сделать выравнивание по центру:
[[Image: FileName |300px|thumb|none| Подпись ]]
Если изображений много — оформить в виде галереи.
Галерея
Галерея позволяет компактно разместить несколько изображений. При уменьшении ширины экрана они уедут друг под друга.
<gallery mode="traditional " widths ="500px" heights="250px">
Image: FileName1 | Описание
Image: FileName2 | Описание
Image: FileName3 | Описание
</gallery>
Листинг команды
Команда
Команды оформляются с помощью тега syntaxhighlight
, в свойстве lang
указываем bash
.
Код
<syntaxhighlight lang="bash"> apt update </syntaxhighlight>
Результат
apt update
Команда с выводом
Если вы хотите показать вывод, то копировать команды нужно с куском приглашения, без пользователя и имени хоста.
Код
<syntaxhighlight lang="bash"> ~# dpkg -s wb-hwconf-manager |grep Version Version: 1.37.0 </syntaxhighlight>
Результат
~# dpkg -s wb-hwconf-manager |grep Version
Version: 1.37.0
Листинг кода
код
Список языков: https://pygments.org/languages/, для подсветки листинга правил использовать язык ecmascript.
Путь к файлу и команды в тексте
В тексте пути к файлу оборачиваем в тег code:
<code>/etc/wb-mqtt-serial.conf</code>
/etc/wb-mqtt-serial.conf
Горячие клавиши
Горячие клавиши можно выделять тегом kbd:
<kbd>Ctrl</kbd>+<kbd>A</kbd>
Ctrl+A
Возведение в степень
Код
4<sup>2</sup>
Результат
42
Предупреждения
Блоки предупреждений формируются с помощью шаблона Шаблон:Note. Синтаксис смотрите на странице шаблона.
Оформлять текст в блоки следует только в крайнем случае, например, если действия пользователя потенциально опасно или может привести к ошибке, которую трудно отловить.
Цитата
<blockquote> Цитата </blockquote>
Таблица
Ниже приведён пример простой таблицы из двух строк, заголовка и семи колонок.
Код
{| border="1" class="wikitable"
! Head1 || Head2 || Head3 || Head4 || Head5 || Head6 || Head7
|-
| Col1 || Col2 || Col3 || Col4 || Col5 || Col6 || Col7
|-
| Col1 || Col2 || Col3 || Col4 || Col5 || Col6 || Col7
|-
|}
Результат
Head1 | Head2 | Head3 | Head4 | Head5 | Head6 | Head7 |
---|---|---|---|---|---|---|
Col1 | Col2 | Col3 | Col4 | Col5 | Col6 | Col7 |
Col1 | Col2 | Col3 | Col4 | Col5 | Col6 | Col7 |
Полезно почитать про синтаксис создания таблиц.