16 809
правок
(→Галерея: Дополнил про галереи) |
(→Тип 2) |
||
(не показано 27 промежуточных версий этого же участника) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: | {{DISPLAYTITLE: Справочник по синтаксису}} | ||
== Как создать новую страницу == | == Как создать новую страницу == | ||
Строка 69: | Строка 69: | ||
</pre> | </pre> | ||
Включения нужно изменять с большой осторожностью, так как изменение текста в одном месте повлияет на несколько страниц одновременно. | Включения нужно изменять с большой осторожностью, так как изменение текста в одном месте повлияет на несколько страниц одновременно. Чтобы отредактировать включение, скопируйте текст между фигурными скобками, вставьте в поле поиска по документации и перейдите на предложенную страницу. | ||
Внутри включения можно использовать теги: | Внутри включения можно использовать теги: | ||
Строка 153: | Строка 153: | ||
#* Второй пункт вложенного | #* Второй пункт вложенного | ||
# Второй пункт | # Второй пункт | ||
# Третий пункт | |||
=== Пункт из нескольких строчек === | |||
Иногда бывает так, что один пункт нужно разбить на несколько строчек, например, привести какой-то код, или добавить картинку. | |||
Чтобы такое провернуть, добавьте в начало строки символ <code>#:</code>: | |||
<pre> | |||
# Первый пункт | |||
#: Вторая строка первого пункта | |||
#: Третья строка первого пункта | |||
# Второй пункт | |||
#: [[Image: FileName.png |300px| Картинка в списке ]] | |||
# Третий пункт | |||
</pre> | |||
Результат: | |||
# Первый пункт | |||
#: Вторая строка первого пункта | |||
#: Третья строка первого пункта | |||
# Второй пункт, картинка: | |||
#: [[Image: FileName.png |300px| Картинка в списке ]] | |||
# Третий пункт | # Третий пункт | ||
Строка 174: | Строка 195: | ||
[[Название страницы#Название раздела | Видимый текст]] | [[Название страницы#Название раздела | Видимый текст]] | ||
</pre> | </pre> | ||
Но лучше добавить в страницу якорь и сослаться на него, так в случае, если заголовок раздела будет переименован, то ссылка не сломается: | |||
# Добавляем якорь: | |||
#:<pre>{{Anchor|anchor-name}}</pre> | |||
# Ссылаемся на этот якорь по аналогии с заголовком: | |||
#:<pre>[[#anchor-name]]</pre> | |||
'''Примеры:''' | '''Примеры:''' | ||
Строка 203: | Строка 230: | ||
== Изображение == | == Изображение == | ||
По умолчанию изображения добавляем | === Как загрузить новое изображение === | ||
[[Image: FileName.png |300px|thumb|right| Изображение с выравниванием по правому краю]] | |||
Чтобы ссылки на файлы смотрелись хорошо, давайте файлам имена латиницей. | |||
Для добавления нового изображения, просто вставьте один из примеров ниже в текст страницы и нажмите '''Предпросмотр'''. После на странице появится ссылка на добавление нового файла. Нажмите на ссылку, откроется окно, где можно выбрать файл изображения. | |||
[[Image: Add new file link.png |372px| Так выглядит ссылка на добавление нового файла]] | |||
=== Примеры === | |||
По умолчанию изображения добавляем с выравниванием по левому краю, такое выравнивание особенно хорошо смотрится в списках: | |||
<pre> | <pre> | ||
[[Image: FileName |300px | [[Image: FileName.png |300px| Подпись ]] | ||
</pre> | </pre> | ||
[[Image: FileName.png |300px| Изображение в тексте по левому краю]] | |||
Ещё есть выравнивание центру, так хорошо смотрятся большие изображения в абзаце: | |||
<pre> | <pre> | ||
[[Image: FileName | | [[Image: FileName.png |500px|center| Подпись ]] | ||
</pre> | </pre> | ||
Если изображений много — оформить в виде [[#Галерея | галереи]]. | [[Image: FileName.png |500px|center| Изображение в тексте по центру]] | ||
Главное изображение страницы или раздела можно выровнять по правому краю: | |||
<pre> | |||
[[Image: FileName.png |300px|thumb|right| Подпись ]] | |||
</pre> | |||
Из-за перехода на новую тему мы глобально ограничили ширину боковых изображений 300px. Поэтому для всех новых боковых изображений указывайте ширину не больше 300px. | |||
Советы: | |||
# Если изображений много — оформить в виде [[#Галерея | галереи]]. | |||
# Не злоупотребляйте боковыми картинками — они плохо сочетаются с таблицами и небольшим количеством текста, оставляя дыры рядом с собой. Руководствуйтесь здравым смыслом и убирайте выравнивание по правому краю там, где это выглядит плохо. | |||
# Если вы выбрали вариант изображения без рамки и подписи, то подпись в коде лучше добавить — она станет всплывающей подсказкой и попадёт в тег <code>alt</code>, который отобразится на странице, если картинка вдруг не загрузится. | |||
# При масштабировании изображения может случиться так, что оно начнёт «мылить». В этом нет ничего страшного, особенно, если изображение большое и без масштабирования будет смотреться плохо, но есть ряд ситуаций, в которых этого можно избежать: изображение шириной 350 px, а мы уменьшаем его до 200px — почти всегда такое изображение можно разместить в полный рост: | |||
#:[[Image: FileName_alt.png |250px| Из-за неверного выбора размера изображение «мылит» ]] | |||
#:[[Image: FileName_alt.png |342px| Изображение чёткое — размер подобран верно]] | |||
== Галерея == | == Галерея == | ||
Строка 251: | Строка 303: | ||
<syntaxhighlight lang="html"> | <syntaxhighlight lang="html"> | ||
<gallery mode="packed"> | <gallery mode="packed" heights="150px" caption="Галерея"> | ||
Image: FileName1 | Описание | Image: FileName1 | Описание | ||
Image: FileName2 | Описание | Image: FileName2 | Описание | ||
Строка 258: | Строка 310: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<gallery mode="packed"> | <gallery mode="packed" heights="150px" caption="Галерея"> | ||
Image: Installation WB-CT309.png | Выбор схемы обжима в зависимости от ориентации трансформаторной сборки | Image: Installation WB-CT309.png | Выбор схемы обжима в зависимости от ориентации трансформаторной сборки | ||
Image: WBCT_RJ12_pinout.png | Схема 1. Обжим витой пары для подключения трансформаторной сборки. Серийный вариант | Image: WBCT_RJ12_pinout.png | Схема 1. Обжим витой пары для подключения трансформаторной сборки. Серийный вариант | ||
Строка 316: | Строка 368: | ||
== Листинг кода == | == Листинг кода == | ||
<pre> | |||
<syntaxhighlight lang="html"> | <syntaxhighlight lang="html"> | ||
код | код | ||
</syntaxhighlight> | </syntaxhighlight> | ||
</pre> | |||
Список языков: https://pygments.org/languages/, для подсветки листинга правил использовать язык ''ecmascript''. | Список языков: https://pygments.org/languages/, для подсветки листинга правил использовать язык ''ecmascript''. | ||