Syntax: различия между версиями

4079 байт добавлено ,  3 месяца назад
 
(не показано 17 промежуточных версий этого же участника)
Строка 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: FileName.png |300px|thumb|right| Изображение с выравниванием по правому краю]]
Чтобы ссылки на файлы смотрелись хорошо, давайте файлам имена латиницей.
 
Для добавления нового изображения, просто вставьте один из примеров ниже в текст страницы и нажмите '''Предпросмотр'''. После на странице появится ссылка на добавление нового файла. Нажмите на ссылку, откроется окно, где можно выбрать файл изображения.
 
[[Image: Add new file link.png |372px| Так выглядит ссылка на добавление нового файла]]
 
=== Примеры ===
По умолчанию изображения добавляем с выравниванием по левому краю, такое выравнивание особенно хорошо смотрится в списках:
<pre>
<pre>
[[Image: FileName.png |300px| Подпись ]]
[[Image: FileName.png |300px| Подпись ]]
Строка 210: Строка 245:
[[Image: FileName.png |300px| Изображение в тексте по левому краю]]
[[Image: FileName.png |300px| Изображение в тексте по левому краю]]


Если картинка большая, то можно сделать по центру.
Ещё есть выравнивание центру, так хорошо смотрятся большие изображения в абзаце:
<pre>
<pre>
[[Image: FileName.png |300px|center| Подпись ]]
[[Image: FileName.png |500px|center| Подпись ]]
</pre>
</pre>


[[Image: FileName.png |300px|center| Изображение в тексте по центру]]
[[Image: FileName.png |500px|center| Изображение в тексте по центру]]


Главное изображение страницы или раздела можно выровнять по правому краю:
Главное изображение страницы или раздела можно выровнять по правому краю:
Строка 224: Строка 259:
Из-за перехода на новую тему мы глобально ограничили ширину боковых изображений 300px. Поэтому для всех новых боковых изображений указывайте ширину не больше 300px.
Из-за перехода на новую тему мы глобально ограничили ширину боковых изображений 300px. Поэтому для всех новых боковых изображений указывайте ширину не больше 300px.


Не злоупотребляйте боковыми картинками — они плохо сочетаются с таблицами и небольшим количеством текста, оставляя дыры рядом с собой. Руководствуйтесь здравым смыслом и убирайте выравнивание по правому краю там, где это выглядит плохо.
Советы:
 
# Если изображений много — оформить в виде [[#Галерея | галереи]].
Если изображений много оформить в виде [[#Галерея | галереи]].
# Не злоупотребляйте боковыми картинками — они плохо сочетаются с таблицами и небольшим количеством текста, оставляя дыры рядом с собой. Руководствуйтесь здравым смыслом и убирайте выравнивание по правому краю там, где это выглядит плохо.
# Если вы выбрали вариант изображения без рамки и подписи, то подпись в коде лучше добавить — она станет всплывающей подсказкой и попадёт в тег <code>alt</code>, который отобразится на странице, если картинка вдруг не загрузится.
# При масштабировании изображения может случиться так, что оно начнёт «мылить». В этом нет ничего страшного, особенно, если изображение большое и без масштабирования будет смотреться плохо, но есть ряд ситуаций, в которых этого можно избежать: изображение шириной 350 px, а мы уменьшаем его до 200px почти всегда такое изображение можно разместить в полный рост:
#:[[Image: FileName_alt.png |250px| Из-за неверного выбора размера изображение «мылит» ]]
#:[[Image: FileName_alt.png |342px| Изображение чёткое — размер подобран верно]]


== Галерея ==
== Галерея ==
Строка 264: Строка 303:


<syntaxhighlight lang="html">
<syntaxhighlight lang="html">
<gallery mode="packed" heights="150px">
<gallery mode="packed" heights="150px" caption="Галерея">
Image: FileName1 | Описание
Image: FileName1 | Описание
Image: FileName2 | Описание
Image: FileName2 | Описание
Строка 271: Строка 310:
</syntaxhighlight>
</syntaxhighlight>


<gallery mode="packed" heights="150px">
<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. Обжим витой пары для подключения трансформаторной сборки. Серийный вариант
Строка 329: Строка 368:


== Листинг кода ==
== Листинг кода ==
<pre>
<syntaxhighlight lang="html">
<syntaxhighlight lang="html">
код
код
</syntaxhighlight>
</syntaxhighlight>
 
</pre>
Список языков:  https://pygments.org/languages/, для подсветки листинга правил использовать язык ''ecmascript''.
Список языков:  https://pygments.org/languages/, для подсветки листинга правил использовать язык ''ecmascript''.