Формат ссылок - KoolTechTricks/pages GitHub Wiki

Общие рекомендации:

  • Убирайте лишний / в конце ссылки
  • Убирайте ненужные части ссылок и отслеживающие параметры (?si=, ?utm_source= и прочее)
  • Убирайте локализацию (en-US, ru-RU и прочее)
  • При необходимости указывайте #-ссылки, чтобы сразу переместить читателя к контексту

GitHub

Этот раздел также относится и к Gitea/Forgejo (Codeberg)

Если необходимо указать официальный сайт ПО, то ссылку на него можно найти под описанием проекта на GitHub. Если же ссылки нет, используется ссылка на репозиторий с окончанием #readme. Это нужно, чтобы сразу переместить читателя к описанию и пропустить исходные файлы.

  • Плохо: https://github.com/vuejs/vue
  • Плохо: https://github.com/vuejs/vue?tab=readme-ov-file
  • Хорошо: https://github.com/vuejs/vue#readme

Обратите внимание, что GitHub добавляет в ссылку часть ?tab=readme-ov-file. Она не нужна для функционирования ссылки, следовательно, её можно убрать.

При указании ссылки на скачивание с GitHub, используйте схему https://github.com/<проект>/releases/latest. Часть latest важна, так как она перенаправляет на последнюю стабильную версию.

Примеры:

  • Плохо: https://github.com/electron/electron/releases
  • Плохо: https://github.com/electron/electron/releases/tag/v30.0.6
  • Хорошо: https://github.com/electron/electron/releases/latest

YouTube

  • Используйте короткие ссылки youtu.be
  • Убирайте ненужные части (?si=XXX)
  • Используйте временные метки, чтобы сразу переместить читателя на нужный момент видео
  • Не используйте ссылки на альтернативные фронтенды

Примеры:

  • Плохо: https://www.youtube.com/watch?v=dQw4w9WgXcQ
  • Плохо: https://youtu.be/dQw4w9WgXcQ?si=RAy6sNxB5Du5j4b3
  • Плохо: https://piped.video/dQw4w9WgXcQ
  • Хорошо: https://youtu.be/dQw4w9WgXcQ

X (Twitter)

Если есть возможность, избегайте X (Twitter) и указывайте ссылку на Mastodon/Fediverse.

Рекомендуемые варианты названий:

  • (На странице) в (социальной сети) X
  • X (Twitter)
  • Старый интерфейс / старая версия приложения Twitter (- ссылка на старую версию, когда ещё называлась Twitter, а не X)

Примеры:

  • Плохо: https://twitter.com/SponsorBlock/status/1800835402666054072?s=12
  • Лучше: https://x.com/SponsorBlock/status/1800835402666054072
  • Ещё лучше: https://fosstodon.org/@sponsorblock/112603139898164385

OpenNet

Ссылки на новости можно сильно сократить.

Примеры:

  • Плохо: https://www.opennet.ru/opennews/art.shtml?num=61448
  • Хорошо: https://opennet.ru/61448

Локализации

Некоторые ссылки содержат локализации. При переходе по таким ссылкам открывается сайт на заданном языке. Это не желаемое поведение. Сайт должен открываться на языке, который установлен у читателя по умолчанию. Для этого в ссылке (по возможности) должны отсутствовать локализации.

Примеры:

https://f-droid.org/en/packages/org.fdroid.fdroid
https://f-droid.org/packages/org.fdroid.fdroid

https://addons.mozilla.org/en-US/firefox/addon/ublock-origin
https://addons.mozilla.org/firefox/addon/ublock-origin

https://apps.apple.com/us/app/sponsorblock-for-safari/id1573461917
https://apps.apple.com/app/sponsorblock-for-safari/id1573461917

Также отметим прочие ненужные части:

https://chromewebstore.google.com/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm
https://chromewebstore.google.com/detail/cjpalhdlnbpafiamejdnhcphjbkeiagm

https://apps.apple.com/app/sponsorblock-for-safari/id1573461917
https://apps.apple.com/app/id1573461917

Если вам кажется, что элемент ссылки не нужен, обязательно проверьте работоспособность ссылки без неё. Иногда эти ненужные части нужны в определённом контексте.

Альтернативные фронтенды

Privacy-friendly alternative frontends

Указывайте постоянные ссылки на оригинальные сайты, а не их альтернативные фронтенды. Мы считаем, что если пользователь хочет избегать трекеров, то он сам решит проблему с автоматической пересылкой на альтернативные фронтенды. Нет необходимости заставлять всех пользоваться альтернативными фронтендами. Они очень часто ломаются, из-за чего обычные читатели не смогут получить доступ к информации.

На альтернативном фронтенде YouTube ошибка, из-за чего невозможно воспроизвести видео

Сокращённые ссылки

Существуют сервисы по типу bit.ly или clck.ru, которые предназначены для сокращения длинных ссылок. Они генерируют новую ссылку, которая ведёт на их собственный сайт, а затем пересылает на оригинальный. В процессе пересылки сервис может посчитать посещение и, возможно, собрать некоторую информацию о пользователе, что нарушает конфиденциальность.

Чаще всего сервисы сокращённых ссылок нужны там, где количество символов ограничено. Это не касается Вики, поэтому подобные сервисы в данном случае не нужны.

⚠️ **GitHub.com Fallback** ⚠️