- Как заполнять эту вики
- 4 правила хорошей страницы
- Как добавлять ссылки
- Как писать и форматировать текст
- Информационные блоки
- Callout
- Неразывный пробел
- Оформление текста как monospace / code
- Таблицы
- Подробнее о шорткатах при оформлении информации
- Как создать новую страницу
- Создание новой страницы через контекстное меню, вызываемое через @
- Назначение красивого адреса страницы на uahelp.wiki
- Метод защиты от случайного удаления дочерних страниц при редактирования родительской страницы
- Как добавить ссылку на секцию (заголовок) на странице
- ToC - Table of Contents
- QR со ссылкой на страницу
- Синхронизированные блоки
- Превью страницы вики в Telegram
- Известные баги
Как заполнять эту вики
- Допускается информация на немецком, английском или украинском, но старайтесь, пожалуйста, писать на русском. Помните, что украинский язык знают далеко не все. Запрещены любые конфликты на национальной почве. Нормальные люди не делят людей по паспортам, сейчас это трагедия и беда для всех нас.
- Помните, что приезжающие украинцы скорее всего не знают немецкого языка!
- Имейте в виду, что информация очень динамическая, любая информация может устаревать в течение часов.
- Желательно постить информацию в виде текста, чтобы её было можно скопировать частично. Картинки допустимы, но в крайнем случае. Если можете — перенаберите текстом.
4 правила хорошей страницы
- Наличие оглавления. Смотрите, как его создать, и почему оно важно, в разделе ToC.
- Дата последнего обновления страницы/секции после заголовка, например Страница обновлена: 03.06.2022
- Формулируйте мысли коротко и по делу, для более глубокого изучения вопроса существуют ссылки на официальные источники.
- В самом низу страницы стоит сделать футер (его еще называют “подвал”), где можно разместить QR-код на эту страницу, ссылки на связанные темы (”Смотрите также”) и ссылку возврата в раздел, где находится эта страница, либо на главную страницу вики. Если вы хотите иметь какой-то общий футер на всех страницах вашего города/раздела, это удобно сделать с помощью синхронизированных блоков.
Такой футер реализован, например, на всех страницах города .Ганновер - Hannover
Как добавлять ссылки
- Отрезаем от всех ссылок ненужные рекламные параметры вроде
?fbcId=...,jsessionid=...,utm_source=...итд итп. - По сути, для каждой ссылки Вы можете удалить всё, начиная с
?включительно и перепроверить, что ссылка по-прежнему работает и ведёт на ту же страницу. - Ссылки на Телеграм и Инстаграм нужно делать кликабельными:
- Телеграм: Вместо просто
@dmitry_weirdoнужно это делать ссылкой https://t.me/dmitry_weirdo (без собачки@в юзернейме, обратите внимание). - Инстаграм: Вместо просто
@dmitry.weirdoнужно делать ссылку вида https://www.instagram.com/dmitry.weirdo/. - Ссылки на телефоны нужно делать кликабельными:
- Выделяем текст телефона.
- Нажимаем
Ctrl + K. - Вводим ссылку в формате
tel:+491234567890. - Таким образом, при просмотре сайта с телефона можно будет нажать на ссылку и позвонить на номер.
- Ссылки на э-мейлы нужно делать кликабельными:
- Выделяем текст телефона.
- Нажимаем
Ctrl + K. - Вводим ссылку в формате
mailto:[email protected]. - Таким образом, при нажатии на ссылку будет открываться почтовый клиент с заполненным полем To.
- Проверяем рабочесть и кликабельность ссылки для всех видов ссылок!
- Ссылки на другие страницы внутри самой вики добавляем через
@:.Поиск жилья - Для ссылок на сайты и документы с информацией на языке, отличном от русского и украинского, старайтесь указать рядом со ссылкой в скобках язык.
Как писать и форматировать текст
Информационные блоки
Для удобства перемещения информации (и создания Синхронизированных блоков), текст на страницы нужно добавлять блоками.
- Переход на новую строку внутри текстового блока:
Shift + Enter. Иначе вы создадите новый блок с переходом на новую строку.
Callout
/callout . Этот текст находится внутри коллаута.Неразывный пробел
Неразрывный пробел можно ввести через Alt + 0160. Далее в принципе можно копипейстить его.
Оформление текста как monospace / code
Ctrl + E— пометить выделенный текст или стартовать новый текст как monospace / code.- Markdown разметка код-блоков через тильду
`тоже работает.
Таблицы
Shift + Enter— при редактировании таблицы добавить новую строку.- Работает из любой колонки строки.
- Если не работает, а создаёт новую строку внутри ячейки, сперва нажмите
Enter, чтобы выйти из режима редактирования.
Подробнее о шорткатах при оформлении информации
- https://www.notion.so/help/keyboard-shortcuts
- https://keycombiner.com/collections/notion/
Ctrl + Shift + Lв режиме редактирования — сменить на светлую/тёмную тему.
Как создать новую страницу
Создание новой страницы через контекстное меню, вызываемое через @
Создать новую страницу можно в меню, вызываемом через @.
Для этого нужно набрать @ + новое уникальное название на родительской странице. Тогда в выпадающем контекстном меню появятся пункты про создание страницы или подстраницы:
@Чтобы для новой страницы сразу автоматически сгенерировался красивый URL, см. следующую секцию 👇
Назначение красивого адреса страницы на uahelp.wiki
Чтобы у этой страницы появился красивый адрес (например uahelp.wiki/hannover/beauty), нужно создавать её с желаемым словом в названии (например beauty). Когда её станет видно в публичном доступе (по адресу https://uahelp.wiki/...), то название можно исправить на любое.
Если автоматика сработала плохо и красивый адрес не создался, придется пойти к кому-то из админов с доступом к назначению адресов, дать им ссылку на новую страницу (в формате notion.so/russiansabroad/12345) и попросить их назначить желаемый адрес. Подробности: .
Метод защиты от случайного удаления дочерних страниц при редактирования родительской страницы
Для защиты от случайного «я что-то нажал и всё исчезло», созданные подстраницы (за исключением тех, что находятся на главной странице нашей вики или главной странице вашего города) прячем внутри тоггла в самом низу страницы над футером. А в самом тексте страницы используем только ссылки на них. Так, в случае исправления или удаления части текста, мы не удалим случайно подстраницы.
Пример:
Как добавить ссылку на секцию (заголовок) на странице
Если вы хотите дать кому-то ссылку не на всю страницу, а на какую-то ее часть, то вот самый быстрый и удобный способ это сделать:
- Добавляем на страницу автоматически генерируемое оглавление (см. ниже)
- Ждём, пока она появится в публичном доступе на странице с адресом
https://uahelp.wiki/.... - По клику правой кнопкой на нужный заголовок выбираем «Скопировать адрес этой ссылки» (не знаю, как это будет на других языках/операционных системах, но действие вам известно).
- Вставляем туда, где нам нужна была эта ссылка. Например, в настроечную таблицу вашего бота .Бот-консультант dv_wiki_bot («Дюся»)
Как чинить сломавшиеся ссылки:
- Особенно если пропали хэдеры 2 уровня на uahelp.wiki — берём тот же якорь и добавляем к урлу на uahelp.wiki (могут делать только админы, имеющие доступ к )
- ❗Вроде бы средствами самого Ноушна можно сделать ссылку на блок.
ToC - Table of Contents
Чтобы мочь ссылаться на конкретные разделы на страницах (их заголовки), стоит добавить на страницу автоматически генерируемое оглавление — ToC или Table of Contents. Но в эстетических целях иногда уместно добавить его не в самое начало страницы, а спрятать в самый конец, чтобы при открытии странички был виден сразу красивый вариант оглавления, описанный ниже. (См. в качестве примера
Красивое оглавление: В начале страницы рекомендуется вместо стандартного оглавления вставлять ТоС с основной навигацией по страничке, со ссылками на конкретные блоки информации внизу страницы.
Выглядит это вот так:
А здесь небольшая инструкция, о том как достичь этого результата (не судите строго — первое в жизни инструкционное видео от @Ela)
Сравнение вида обычного оглавления и навигатора, о котором рассказано выше:
QR со ссылкой на страницу
На каждой странице вставляем QR-код, ведущий на короткую паблик-ссылку этой страницы (то есть ссылку вида https://uahelp.wiki/...).
Update 10.04.2022: QR на странице решили оставить, но перенести вниз страницы. Пример можно посмотреть на странице
- При просмотре с телефона QR сверху занимал значительную часть экрана.
- В мобильном браузере есть встроенная кнопка Share, так что QR не нужен.
- QR оставляем для того, чтобы его можно было использовать в распечатках.
Подробнее про QR и его полезность:
Синхронизированные блоки
Зачем они нужны?
Во-первых, у нас есть несколько синхронизированных блоков с общей информацией по всех Германии. Ответственный за блок обновил информацию в одном блоке, и она поменялась во всех блоках по всей вики, которые с ним синхронизированы.
Во-вторых, их очень удобно использовать внутри ваших городских страниц, если какая-то информация упоминается в нескольких местах (например, адрес Центра приема беженцев может фигурировать как на странице о том, где можно переночевать, так и на странице о процессе регистрации в городе). Еще один пример:
Официальная документация Notion: https://www.notion.so/help/synced-blocks
Из моего (@Grigory Grin) опыта работает чуть иначе:
Превью страницы вики в Telegram
При заполнении страниц вики учтите, что ее самые первые предложения будут показываться в превью при отправке сообщений со ссылкой на нее в Telegram и WhatsApp.
В случае изменения текста на странице или изменения Site title & description в указанном меню, без дополнительного вмешательства эти превью обновляются очень медленно. Смотрите пример:
Если все совсем плохо, и оно никак не обновляется — изучите способ сделать это руками в админке для назначения URL — Super.so.
Известные баги
- Сворачивающийся текст (Toggle) может не попадать в генерирующееся автоматически содержание страницы (ToC). Соответственно, на него может быть невозможно создать ссылку на публичной вики (с адресом, начинающимся на
uahelp.wiki). C Toggle heading при этом обычно все в порядке. - Не стоит при использовании эмодзи (иконок, например 👶) менять цвет кожи человечка, иначе с айфонов иконка распадается на слои и выглядит плохо и глючно.
- Если страничка становится огромной ширины и прокручивается вправо (см скриншот ниже), ищите и удаляйте непечатные символы в вашем тексте. Удобно скопировать текст в текстовый редактор, умеющий показывать непечатные символы, например, Word. Так вы узнаете, где они, и сможете удалить их с вашей страницы в Notion.
