LINUX.ORG.RU

О статьях, простынях кода и навигации

 , ,


0

1

Нельзя не заметить, что наше дружное, единое и сплочённое сообщество, вопреки всему, продолжает делиться опытом в разделе «Статьи». Но есть нюанс, который превращает их чтение в настоящую пытку.

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

Это бьёт по всем:

  • Читателям неудобно препарировать материал и возвращаться к нужным частям.
  • Авторы вынуждены либо резать свои примеры на нелогичные куски, либо вовсе отказываться от написания сложных, подробных статей, чтобы не обрекать людей на страдания.

Решение ведь несложное, и оно состоит из двух частей:

  1. Дайте нам сворачиваемые блоки. Хотя бы простейшие <details> и <summary>, чтобы можно было аккуратно упаковать листинги на 200 строк. Это позволит сохранить целостность кода и не сломает структуру текста.
  2. Дайте нам оглавление. Возможность ставить якоря на заголовки и ссылаться на них в начале статьи, как в Википедии. Чтобы можно было сразу прыгнуть к разделу «Установка», «Конфигурация» или «Решение проблем», а не искать его вручную.

Скоро, чтобы найти нужный фрагмент в статье, придётся писать нейросетевого агента-суммаризатора. А он, знаете ли, может оказаться вредным духом и начать писать на форум от имени firkax_llm. Давайте не доводить до этого.

Ответ на: комментарий от dataman

Тупняк, но как этим код с комментариями свернуть?

Или это просто ссылка на обсуждение? Там твой коммент:

Затруднит работу модераторов, если разрешить спойлеры во всех сообщениях.

Нельзя ли отдельно для статей прикрурить? Мою длинную и так полтора месяца проверяли, перед тем, как выложить.

mamina_radost
() автор топика
Ответ на: комментарий от mamina_radost

Или это просто ссылка на обсуждение?

Ага. Не стало длинным. :)

dataman ★★★★★
()
Для того чтобы оставить комментарий войдите или зарегистрируйтесь.