# Ссылки должны оставаться в Документах

**URL:** https://meta.discourse.org/t/links-should-remain-in-docs/176627
**Category:** Feature
**Tags:** docs
**Created:** [19.Январь.2021 21:53:46 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627 "2021-01-19T21:53:46Z")
**Posts on this page:** 9
**Page:** 1

<div class="post-metadata">

### Author: ![PhilippBoeing](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/philippboeing/32/116347_2.png) [@PhilippBoeing](https://meta.discourse.org/u/PhilippBoeing)
#### Post date: [19.Январь.2021 21:53:46 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627/1 "2021-01-19T21:53:46Z")

</div>

Для общения в нашей команде мы используем Discourse. У нас есть специальная категория для внутренней инструкции, где все сообщения представлены в виде вики-страниц.

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

Можно ли автоматически переписать ссылки так, чтобы при переходе из одного сообщения в другое оставался режим Knowledge Explorer?

---

<div class="post-metadata">

### Author: ![justin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/justin/32/157614_2.png) [@justin](https://meta.discourse.org/u/justin)
#### Post date: [20.Январь.2021 16:00:02 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627/2 "2021-01-20T16:00:02Z")

</div>

Это технически возможно, но потребует довольно неуклюжей реализации. Нам пришлось бы добавлять параметр запроса к каждому клику по ссылке, а затем перенаправлять на представление документации, внедряя изменения в TopicController. Однако не все внутренние ссылки ведут на темы, которые есть в документации, и это тоже нужно учитывать.

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

---

<div class="post-metadata">

### Author: ![oshyan](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/oshyan/32/212644_2.png) [@oshyan](https://meta.discourse.org/u/oshyan)
#### Post date: [02.Ноябрь.2021 23:51:39 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627/3 "2021-11-02T23:51:39Z")

</div>

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

---

<div class="post-metadata">

### Author: ![Nick\_Chomey](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nick_chomey/32/215378_2.png) [@Nick\_Chomey](https://meta.discourse.org/u/Nick_Chomey)
#### Post date: [15.Ноябрь.2021 23:10:11 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627/4 "2021-11-15T23:10:11Z")

</div>

Это было бы очень полезно. Я только что импортировал множество документов с другой платформы, которые содержат ссылки на другие документы, и, похоже, вынужден либо заменять их ссылками на страницу документации (/docs?category=123&topic=456), либо на страницу темы (/t/topic-title/456).

Было бы здорово иметь возможность использовать информативную ссылку на тему (содержащую название темы), но при этом перенаправлять её на документ при просмотре в режиме «Документация».

Кроме того, если мы переместим тему в другую категорию, ссылка /docs?category перестанет работать корректно. Удивительно, но она действительно отображает тему в режиме «Документация», однако фильтр устанавливается для старой категории.

---

<div class="post-metadata">

### Author: ![jrgong](https://avatars.discourse-cdn.com/v4/letter/j/c57346/32.png) [@jrgong](https://meta.discourse.org/u/jrgong)
#### Post date: [12.Январь.2022 12:55:24 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627/5 "2022-01-12T12:55:24Z")

</div>

Наконец-то нашли это! Именно то, что мы искали!

В данный момент мы добавляем ссылки на темы документации в таком формате: `/docs?ascending=false&category=22&topic=1564`, что является огромной головной болью.

---

<div class="post-metadata">

### Author: ![jrgong](https://avatars.discourse-cdn.com/v4/letter/j/c57346/32.png) [@jrgong](https://meta.discourse.org/u/jrgong)
#### Post date: [03.Март.2022 11:57:43 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627/6 "2022-03-03T11:57:43Z")

</div>

Всего лишь короткое напоминание и вопрос: поддерживаете ли вы тоже PR по этому поводу? Будем рады спонсировать такую функцию.

---

<div class="post-metadata">

### Author: ![tobiaseigen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tobiaseigen/32/539204_2.png) [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [03.Март.2022 15:24:00 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627/8 "2022-03-03T15:24:00Z")

</div>

Привет и спасибо за предложение и готовность отправить pull-запрос. Мы обсуждали улучшение документации, в том числе идею присвоения каждому документу одного URL вместо двух. Я думаю, что это решило бы проблему, но потребовало бы значительной рефакторинга текущей реализации функционала документации.

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [04.Март.2022 00:34:47 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627/9 "2022-03-04T00:34:47Z")

</div>

О, есть быстрое временное решение. Думаю, встроенная функция постоянных ссылок должна сработать? Вы можете настроить их в интерфейсе администратора. Это потребует немного дополнительных усилий, но позволит получать очень чистые URL-адреса для обмена.

---

<div class="post-metadata">

### Author: ![jrgong](https://avatars.discourse-cdn.com/v4/letter/j/c57346/32.png) [@jrgong](https://meta.discourse.org/u/jrgong)
#### Post date: [04.Март.2022 07:58:13 UTC](https://meta.discourse.org/t/links-should-remain-in-docs/176627/10 "2022-03-04T07:58:13Z")

</div>

Спасибо, ребята, я ценю ваши отзывы!

Пока попробуем использовать предложенные обходные пути. Но чем больше тем мы добавим в /docs, тем сложнее всё может стать, если нам придётся вручную управлять длинным списком URL-адресов.
