Создание и оформление страниц вики

Кто может добавлять свои материалы?

Любой, кто хочет и имеет нужные навыки! У нас нет ограничений по «уровню вхождения», и, при необходимости, мы отредактируем и отформатируем любой интересный материал, это не проблема.

По корректировке текста и всем сомнениям «а получится ли» смело пишите в личку telegram @arkrusinov, всегда поддержу и помогу с текстом, графикой и оформлением.

По предложениям развития wiki (новые расширения, настройки, и т.д.) — к @ZioSHik

Как создать страницу?

Самый быстрый способ — впишите желаемое название прямо в строку поиска вики.

Если такой страницы нет — вики автоматически предложит создать новую (нужно быть авторизованным в этот момент):

Пример:

Ссылка, выделенная желтым, приведёт в редактор, уже настроенный для создания страницы с таким именем.

Подумайте над названием несколько раз, прежде чем начнёте создавать свою страницу. Оно должно точно отражать тематику и быть как можно более коротким.

Как назвать страницу?

Рассмотрим на паре практических примеров.

Страница о настройках поиска Алисы через приложение Яндекс

• "Настройка поиска Алисы через приложение Яндекс" — слишком длинно, содержит лишнюю информацию. Вряд ли кто-то ищет, как настроить именно через приложение. Хотя бы потому, что если он это знает — ему уже нечего рассказать.
• "Настройка поиска" — слишком коротко, ничего не объясняет. Где поиск? По вики? В Яндекс.Телефоне? На любом устройстве с Алисой?
• "Настройка поиска в Алисе" — твёрдая «четвёрка». Ничего лишнего, есть все уточнения. Но все ли? С какой целью люди ищут настройки поискового фильтра? И мы приходим к:
• "Безопасный поиск с Алисой" — выделена причина, по которой наверняка будет разыскиваться информация, уточнена область применения статьи.

Страница о подключении Яндекс.Телефона к MacOS

• "Как подключить через USB к MacOS" — что подключить? Умную колонку? Навигатор?
• "Как подключить Яндекс.Телефон через USB к MacOS" — подробно, точно. Был бы лучшим вариантом. Но длинновато, и не входит в одну строки колонки на главной, например.
• "Как подключить Телефон к MacOS по USB" — разумный компромисс, так как в пределах нашей вики Телефон с заглавной буквы подразумевает именно Телефон Яндекса. При этом не потеряна ни целевая ОС, ни способ подключения. «Через» заменено на более короткое «по».

Содержание и оформление

А правила у нас самые простые:

• Если информация — не ваш личный опыт, указывайте источник информации.

• Если используете главы, то ПЕРЕД каждым заголовком и ПОСЛЕ делайте по ДВА ПЕРЕНОСА строки.
  <button type="button" class="spoilers-button" aria-expanded="false">Вот так</button>

  
  Текст
  
  == Заголовок ==
  
  снова текст.

• Не забывайте о форматировании: списки, отступы, выделение жирным шрифтом.

• Не размещайте ссылки внутри == Заголовка ==
  Это неочевидно, дезориентирует читателя. Вместо этого напишите в тексте самой главы однозначное пояснение ("Скачать данную версию можно здесь", или "Информация взята отсюда").

• Не злоупотребляйте, но и не забывайте присваивать новым страницам категории (пример: [[Category:Своими руками]]).

• В начале каждой страницы обязательно вставляйте один из вариантов metadesc:
  
  • {{metadesc| Вступительный абзац или краткое описание статьи }} (будет подставлено ваше описание, без названия страницы, но плюс общее описание сайта)
  • {{metadesc| Вступительный абзац или краткое описание статьи | }} (будет подставлено только ваше описание, без названия страницы)
  • {{metadesc|{{PAGENAME}} }} (автоподстановка названия страницы и общего описания сайта) или
  • {{metadesc|{{PAGENAME}} | Вступительный абзац или расширенное описание статьи }} (название страницы + ваше расширенное описание статьи)

• Следом за metadecs вставляйте волшебное слово __NOEDITSECTION__, оно отключает правку отдельных секций (а при этом сбрасываются отступы между секциями).

На тех страницах, где правка секций не отключена, используйте правку всей страницы, и тоже сразу вставляйте в начало страницы директиву __NOEDITSECTION__, заранее спасибо )

• Если разделов немного, но оглавление необходимо, впишите в следующей строке волшебное слово __TOC__, и оглавление появится в указанном месте.

• Создав статью, обязательно отпишитесь нам об этом: @ZioSHik, @arkrusinov (Telegram).

• И не забудьте поделиться новой страницей:
  • в наших telegram-сообществах (@station_yandex, @yandex_phone, @yandexflood), а также в
  • официальном сообществе Диалогов (@yadialogschat)!

Быстрые шаблоны оформления

Плашки

Какая вики без плашек )) У нас их немного; как правило, они предупреждающие. Это:

{{Skills}}, {{Hands}}, {{Unofficial}}, {{HighVoltage}}, {{Underconstruct}} и {{Obsolete}}.

Стили и выделение цветом

Конечно, можно выделить текст примерно так: <b class="red">Текст</b>, но предпочтительнее использовать отдельный блок (в вики для этого строка должна начинаться с пробела. Можно обрамить этот блок тегом <pre> и задать улучшенное цветовое оформление через класс). Пример:

<pre class="red">

Текст (эта строка начинается с пробела)

</pre>

Поддерживаются три класса с простыми цветами: red, green, blue:

 Красный

 Жёлтый

 Зелёный :)

Простая строка, начинающаяся с пробела и не обрамлённая в <pre>, выглядит так.
Вторая строка следом, начинающаяся с пробела, блок не разрывает.

Таблицы

Подробная официальная справка по таблицам в Mediawiki находится здесь. Но можете взять как пример любую таблицу с любой из страниц вики (Справочник_команд_Алисы_(неофициальный), Как пользоваться Доской yaboard.com итд)

Видео и изображения

Перед загрузкой фото сразу подготовьте их:

• Приведите к нужному разрешению (чтобы файл не был избыточно большим, но нужные детали изображения были чётко видны);
• Сразу дайте файлам осмысленные имена (это необходимо как для уникальности, так и удобства);
• Выберите формат сохранения. Если это схема подключения на сплошном белом фоне - при сходных размерах лучше выбрать png, а не jpg, он не вносит видимых искажений. Полноцветные фото намного компактнее сохранит формат jpg.
• Удалите информацию из секции EXIF, если считаете, что она не нужна;
• Выберите подходящую компрессию для JPG (в большинстве программ достаточно выбрать готовый пресет "Высокое качество").

Примеры названий: 1.jpg, Pic.jpg, Photo.jpg - плохо. Doorhan_scheme_01.jpg, iobroker_Pulaski.png - хорошо.

Примеры разрешений:
Разрешение для фото общего вида устройства в 4к (3840х2160) наверняка окажется излишним (если только не надо рассматривать мелкие детали). Скорее всего, достаточно будет 1024х768(576), итд.
Разрешение скриншотов мобильных экранов - наверняка достаточно 300, 400 пиксел по меньшей стороне (как правило, в ширину).

Мы используем такие правила форматирования:

Воспроизвести видео

Локальный файл

Пример миниатюры видео с ограничением по ширине

Пример миниатюры фото с ограничением по ширине

Пример миниатюры фото БЕЗ ограничения

dimensions="[WIDTH|WIDTHxHEIGHT|xHEIGHT]"

• вставка видео из различных сервисов (на примере youtube): <embedvideo service="youtube">//youtu.be/eJM-624xhnE</embedvideo>
• вставка видео с указанием размера окна: <embedvideo service="youtube" dimensions="РАЗМЕР">. Размер может быть указан как ширина (dimensions="640"), ширина и высота (dimensions="640x480") или только высота (dimensions="x480"). Числа приведены для примера.
• упрощённая вставка полноразмерного отображения видео из youtube: <youtube>//youtu.be/fEiA9uyB_HQ</youtube>
• полноразмерное отображение закачанного на вики видео: [[Файл:Имя_закачанного_файла.MP4]]
• миниатюра закачанного на вики фото\видео справа от текста: [[Файл:Имя_закачанного_файла.mp4|мини|справа|Подпись под видео]]
• то же, с ограничением по ширине: [[Файл:Имя_закачанного_файла.mp4|200px|мини|справа|Подпись под видео]]. Ограничение ширины в пикселях необязательно, но может пригодиться при большом количестве медиафайлов и небольшом — текста, чтобы отобразить их на странице более гармонично.

Как видно на примерах справа, наша страница — как раз тот случай, когда ограничение ширины необходимо, так как высота главы значительно меньше высоты колонки предпросмотра медиафайлов.

Важно!

[[Файл:Имя_файла|мини|справа] и

[[Файл:Имя_файла|thumb|right]

равноценны, но предпочтительнее англоязычный вариант.

Ещё один важный момент с миниатюрами справа от текста. Дело в том, что они "разрывают" заголовки, располагаясь самостоятельной лентой по правому краю, и иногда иллюстрация противоречит или не совпадает с текстом слева, что может быть истолковано неверно.

Тогда перед нужным заголовком вместо одного из переноса строк разместите код

<br style="clear:both">
== Заголовок раздела, который нельзя разрывать ==

и иллюстрации к этому разделу начнутся как положено, ниже строки заголовка.

Длинные ссылки: очистка, сокращение

Порой попадаются довольно длинные ссылки с рекламными "хвостами" (как правило, Aliexpress и подобные отслеживающие действия покупателей ресурсы), либо кириллическая ссылка, преобразуемая в пугающей длины последовательность непонятных знаков (например, такие ссылки создаёт наша вики). Помимо никому ненужного трекинга посторонних пользователей, кликнувших в такой URL, такие ссылки очень мусорно смотрятся в чатах телеграм, итд.

Пример ссылки с рекламным или "шпионским" хвостом:

https://aliexpress.ru/item/32647690484.html?spm=a2g0o.productlist.0.0.65dc4259XdPkfr&algo_pvid=046ac67e-0338-4fa7-83e4-59476b02dbc3&algo_expid=046ac67e-0338-4fa7-83e4-59476b02dbc3-0&btsid=a11c7d32-8474-4aeb-be2c-7893c6143c20&ws_ab_test=searchweb0_0,searchweb201602_3,searchweb201603_53

Здесь можно и нужно удалить всё, начиная со знака вопроса. В итоге получится очищенная от мусора ссылка:

• https://aliexpress.ru/item/32647690484.html

Кириллическая ссылка (на этот раздел вики):

https://wiki.yaboard.com/w/%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5_%D0%B8_%D0%BE%D1%84%D0%BE%D1%80%D0%BC%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86_%D0%B2%D0%B8%D0%BA%D0%B8#.D0.94.D0.BB.D0.B8.D0.BD.D0.BD.D1.8B.D0.B5_.D1.81.D1.81.D1.8B.D0.BB.D0.BA.D0.B8:_.D0.BE.D1.87.D0.B8.D1.81.D1.82.D0.BA.D0.B0.2C_.D1.81.D0.BE.D0.BA.D1.80.D0.B0.D1.89.D0.B5.D0.BD.D0.B8.D0.B5

В этом случае лучше воспользоваться сервисом сокращения ссылок clck.ru. Созданная этим сервисом ссылка на одну из страниц нашей вики выглядит так:

• https://clck.ru/LsQCe

Другие сервисы сокращения ссылок запрещены и могут удаляться без предупреждения.

Кроме того, в последние годы в связи с постепенным переходом на https рекомендуется вообще не указывать протокол, так как браузер сам выберет наилучший при обращении к адресу. И, значит, конечный вид наших ссылок становится таким:

• [//aliexpress.ru/item/32647690484.html Описание ссылки]
• [//clck.ru/LsQCe Описание ссылки]

Ссылки на наши страницы вики (целиком):

Если нужно передать кому-то или выложить в чат ссылку на полную страницу вики, а не какой-то раздел, советуем воспользоваться специальным скриптом, который выводится ниже заголовка на каждой из наших страниц. Это серый прямоугольник с текстом

"Кликните, чтобы скопировать короткую ссылку на эту страницу". 

Кликнув в этот текст, вы тут же получите в буфере обмена короткую удобную ссылку. Например, постоянная короткая ссылка на эту страницу выглядит так:

• https://wiki.yaboard.com/s/50

Дополнительно

Категории

• Что такое категории: Help:Categories/ru
• Как добавить категорию? Вставить внизу страницы текст [[Category:Название нужной категории]].
• Где просмотреть список категорий: Служебная:Категории
• Сохранили страницу без категории и потеряли? Вот где она: Служебная:Некатегоризованные_страницы

Общее форматирование MediaWiki

• Как форматировать текст: Help:Formatting/ru

Размещение на главной

Если твёрдо уверены, что ваша статья должна иметь ссылку с главной страницы, напишите об это нам (@ZioSHik, @arkrusinov). Во-первых, форматирование главной основано на более сложной вёрстке, и на html вместо обычной вики-разметки. А во-вторых, управление главной страницей — сфера обязанностей модераторов вики.

Потренироваться

Для этого есть специальная Тестовая страница — на ней можно делать всё.

В меру, конечно. Желательно не удалять верхнюю строку, поясняющую, что страница предназначена для теста набора и форматирования текста и графики.

Есть небольшой риск, что этой страницей пользуется сейчас кто-то другой, и перепишет вашу страницу своим тестом в самый неподходящий момент. Минимизировать его можно двумя приёмами:

• Перед отправкой «Записать страницу» копируйте весь текст в буфер (горячие клавиши Ctrl-A, Ctrl-C под Windows, например)

• Вместо «Записать страницу» использовать кнопку «Предварительный просмотр». Это самый лучший способ потому, что:
  • вообще не перезаписывает страницу
  • позволяет одновременно и смотреть изменяемую страницу, и редактировать её.