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

Syntax (просмотреть исходный код)

Версия 17:19, 23 января 2024

8443 байта добавлено ,  3 месяца назад
→‎Тип 2
 
(не показаны 34 промежуточные версии этого же участника)
Строка 1: Строка 1:
{{DISPLAYTITLE: Синтаксис элементов страницы}}
{{DISPLAYTITLE: Справочник по синтаксису}}


== Видимое название ==
== Как создать новую страницу ==
Ссылки на страницы с русскоязычным наименованием смотрятся плохо, поэтому мы стараемся новые страницы называть короткой англоязычной фразой.
Ссылки на страницы с русскоязычным наименованием смотрятся плохо, поэтому мы стараемся новые страницы называть короткой англоязычной фразой.


Таким страницам нужно назначать видимое название на русском языке, которое будет показано вверху страницы.
Чтобы создать страницу, введите в поле поиска название новой страницы и, если такой страницы нет, в результатах поиска будет фраза:
<pre>
Создать страницу «New Page» в этом вики-проекте!
</pre>
 
<span class="text-red">New Page</span> — это и есть ссылка на создание новой страницы: нажимаете, заполняете, сохраняете.
 
Если вы совсем не знакомы с Вики-синтаксисом, можете посмотреть живой пример в [[Sandbox | Статье-песочнице]].
 
== Видимое название ==
Страницам с англоязычным названием нужно назначать видимое название на русском языке, которое будет показано вверху страницы.


'''Код'''
'''Код'''
Строка 59: Строка 69:
</pre>
</pre>


Включения нужно изменять с большой осторожностью, так как изменение текста в одном месте повлияет на несколько страниц одновременно.
Включения нужно изменять с большой осторожностью, так как изменение текста в одном месте повлияет на несколько страниц одновременно. Чтобы отредактировать включение, скопируйте текст между фигурными скобками, вставьте в поле поиска по документации и перейдите на предложенную страницу.


Внутри включения можно использовать теги:
Внутри включения можно использовать теги:
Строка 143: Строка 153:
#* Второй пункт вложенного
#* Второй пункт вложенного
# Второй пункт
# Второй пункт
# Третий пункт
=== Пункт из нескольких строчек ===
Иногда бывает так, что один пункт нужно разбить на несколько строчек, например, привести какой-то код, или добавить картинку.
Чтобы такое провернуть, добавьте в начало строки символ <code>#:</code>:
<pre>
# Первый пункт
#: Вторая строка первого пункта
#: Третья строка первого пункта
# Второй пункт
#: [[Image: FileName.png |300px| Картинка в списке ]]
# Третий пункт
</pre>
Результат:
# Первый пункт
#: Вторая строка первого пункта
#: Третья строка первого пункта
# Второй пункт, картинка:
#: [[Image: FileName.png |300px| Картинка в списке ]]
# Третий пункт
# Третий пункт


Строка 164: Строка 195:
[[Название страницы#Название раздела | Видимый текст]]
[[Название страницы#Название раздела | Видимый текст]]
</pre>
</pre>
Но лучше добавить в страницу якорь и сослаться на него, так в случае, если заголовок раздела будет переименован, то ссылка не сломается:
# Добавляем якорь:
#:<pre>{{Anchor|anchor-name}}</pre>
# Ссылаемся на этот якорь по аналогии с заголовком:
#:<pre>[[#anchor-name]]</pre>


'''Примеры:'''
'''Примеры:'''
Строка 193: Строка 230:


== Изображение ==
== Изображение ==
По умолчанию изображения выравниваем по правому краю:
=== Как загрузить новое изображение ===
[[Image: FileName.png |300px|thumb|right| Изображение с выравниванием по правому краю]]
Чтобы ссылки на файлы смотрелись хорошо, давайте файлам имена латиницей.
 
Для добавления нового изображения, просто вставьте один из примеров ниже в текст страницы и нажмите '''Предпросмотр'''. После на странице появится ссылка на добавление нового файла. Нажмите на ссылку, откроется окно, где можно выбрать файл изображения.
 
[[Image: Add new file link.png |372px| Так выглядит ссылка на добавление нового файла]]
 
=== Примеры ===
По умолчанию изображения добавляем с выравниванием по левому краю, такое выравнивание особенно хорошо смотрится в списках:
<pre>
<pre>
[[Image: FileName |300px|thumb|right| Подпись ]]
[[Image: FileName.png |300px| Подпись ]]
</pre>
</pre>
[[Image: FileName.png |300px| Изображение в тексте по левому краю]]


Если нужно показать на изображении определенные шаги, то можно сделать выравнивание по центру:
Ещё есть выравнивание центру, так хорошо смотрятся большие изображения в абзаце:
<pre>
<pre>
[[Image: FileName |300px|thumb|none| Подпись ]]
[[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| Изображение чёткое — размер подобран верно]]


== Галерея ==
== Галерея ==
Галерея позволяет компактно разместить несколько изображений. При уменьшении ширины экрана они уедут друг под друга.  
Галерея позволяет компактно разместить несколько изображений. При уменьшении ширины экрана они уедут друг под друга.  


Можете выбрать один из вариантов ниже: <code>widths</code> и <code>heights</code> — это размеры одного изображения, <code>perrow=4</code> — это не больше четырёх изображения в ширину, <code>caption</code> — название галереи.
В зависимости от задачи, используйте один из вариантов ниже.
 
Общие атрибуты:  
* <code>widths</code> и <code>heights</code> — это размеры одного изображения
* <code>perrow=4</code> — это не больше четырёх изображения в ширину,
* <code>caption</code> — название галереи,
* <code>mode</code> — тип.
 
Параметры можно комбинировать или не указывать.
 
=== Тип 1 ===
'''traditional''' — галереи традиционного вида с рамкой вокруг изображений и ячейками одинаковой ширины.
 
<syntaxhighlight lang="html">
<syntaxhighlight lang="html">
<gallery widths=322px heights=200px perrow=4 caption="Описание">
<gallery mode="traditional" widths ="260px" heights="200px">
Image: FileName |  
Image: FileName1 | Описание
Image: FileName |  
Image: FileName2 | Описание
Image: FileName |  
Image: FileName3 | Описание
</gallery>
</gallery>
</syntaxhighlight>
</syntaxhighlight>
<gallery mode="traditional" widths ="260px" heights="200px">
Image: Installation WB-CT309.png | Выбор схемы обжима в зависимости от ориентации трансформаторной сборки
Image: WBCT_RJ12_pinout.png | Схема 1. Обжим витой пары для подключения трансформаторной сборки. Серийный вариант
Image: WBCT_RJ12_pinout invert.png | Схема 2. Обжим витой пары для подключения '''перевёрнутой''' трансформаторной сборки
</gallery>
=== Тип 2 ===
'''packed''' — ряды изображений, выровненных по высоте с равными промежутками. Ширина галереи может подстраиваться под текущее разрешение экрана, а подписи располагаются под изображениями.
В режиме ''packed'' параметры ''widths и heights'' задают не точную высоту, а работают, как рекомендации при разбиении, то есть размер картинки подстраивается так, чтобы разбивать галерею на приблизительно равные строки.


<syntaxhighlight lang="html">
<syntaxhighlight lang="html">
<gallery mode="traditional " widths ="500px" heights="250px">
<gallery mode="packed" heights="150px" caption="Галерея">
Image: FileName1 | Описание
Image: FileName1 | Описание
Image: FileName2 | Описание
Image: FileName2 | Описание
Строка 224: Строка 309:
</gallery>
</gallery>
</syntaxhighlight>
</syntaxhighlight>
<gallery mode="packed" heights="150px" caption="Галерея">
Image: Installation WB-CT309.png | Выбор схемы обжима в зависимости от ориентации трансформаторной сборки
Image: WBCT_RJ12_pinout.png | Схема 1. Обжим витой пары для подключения трансформаторной сборки. Серийный вариант
Image: WBCT_RJ12_pinout invert.png | Схема 2. Обжим витой пары для подключения '''перевёрнутой''' трансформаторной сборки
</gallery>


== Листинг команды ==
== Листинг команды ==
Строка 277: Строка 368:


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


Источник — https://wirenboard.com/wiki/Служебная:Сравнение_версий/55625...78751