--- title: "Страницы и дерево" id: "1975" type: "page" slug: "pages" published_at: "2026-09-20T15:42:58+00:00" modified_at: "2026-10-28T18:13:30+00:00" url: "https://pastukhov.com/agents/portal/docs/pages/" markdown_url: "https://pastukhov.com/agents/portal/docs/pages.md" excerpt: "Дерево страниц — это оглавление всего портала: слева видно, из чего он состоит, справа открывается…" --- # Страницы и дерево [https://pastukhov.com/agents/portal/docs/pages/.md](https://pastukhov.com/agents/portal/docs/pages/.md) Дерево страниц — это оглавление всего портала: слева видно, из чего он состоит, справа открывается выбранная страница. Дерево строится из самих файлов контента, поэтому оно всегда совпадает с тем, что реально есть в портале: отдельно вести список страниц не нужно. ## Дерево слева Список страниц занимает полосу шириной 260 точек — её можно потянуть за край и изменить, а можно свернуть целиком, чтобы страница заняла весь экран. На узких экранах дерево прячется и открывается кнопкой в заголовке страницы. Раскрытые папки запоминаются: вернувшись в браузер, вы увидите дерево в том же виде. Порядок в дереве задаёт сервер: страницы идут по заданному порядку, а при равном порядке — по алфавиту. То, что у страницы есть вложенные страницы, на её место в списке не влияет: папка не всплывает наверх только из-за вложенности. Активная страница раскрывается сама, чтобы её было видно в списке. ## Поиск по страницам В поле поиска над деревом набирается слово или фраза — портал ищет не только по названию и адресу страницы, но и по всему её содержимому: заголовкам блоков, текстам, подписям кнопок, адресам ссылок и запросам. Совпадения по названию или адресу показываются выше, чем совпадение только по тексту. Результаты выводятся плоским списком — так быстрее найти нужное, когда портал разросся. Очистите поле — дерево вернётся к обычному виду. Открыть поиск можно и с клавиатуры: **Ctrl+K** (или **⌘K** на Mac). ## Списки страниц Рядом с поиском есть кнопка со значком часов — **История**. Она переключает то, что видно слева: - **Все** — обычное дерево со всеми страницами; - **Недавно просмотренные** — последние открытые вами страницы; этот список хранится в вашем браузере и не мешает другим; - **Недавно обновлённые** — что правилось последним; - **Недавно созданные** — самые новые страницы. В каждом списке справа видно соответствующее время, а у черновиков стоит пометка. Повторное нажатие того же пункта возвращает дерево. Если список пуст, показывается подсказка — например, «Недавно просмотренных документов пока нет». ## Пометки в дереве - **Черновик** — страница с доступом «только для администраторов». Читателям её вообще не видно, а администратору она показана приглушённо с пометкой. - **Непрочитанные** — страницы, которые изменились с тех пор, как их последний раз открывали. Они выделены жирным, и жирным же помечаются их родители в дереве, чтобы новая правка не потерялась в глубине. Изменение считается по содержимому страницы: если файл просто скопировали, переименовали или тронули дату, пометки не будет — она появляется только тогда, когда текст действительно поменялся. Правки, сделанные пока портал был выключен, находятся при его запуске. Как только страницу открыли, пометка снимается — сразу для всех читателей. Если пробежать несколько страниц подряд, ни одна из них не останется помянутой по ошибке: все открытые помечаются прочитанными, и пометка не возвращается после обновления дерева. ## Меню у строки дерева У каждой строки дерева — и у обычной страницы, и у самой верхней строки с названием портала — есть меню: при наведении показываются три точки, а по правому щелчку меню открывается сразу. В нём два действия: - **Отметить прочитанным** — снимает жирную пометку. У папки это делается сразу со всем, что внутри, а у верхней строки — со всего дерева: удобно, когда агент обновил много страниц, а читать их вы собираетесь не сегодня. - **Обновить иконку** — открывает поиск по значкам и ставит выбранный значок странице. Свой значок можно задать и верхней строке портала; если очистить поиск, вернётся стандартный значок. ## Адрес страницы У каждой открытой страницы есть свой адрес в строке браузера. Его можно скопировать и отправить коллеге: перейдя по ссылке, человек попадёт сразу на эту страницу с уже раскрытым деревом. Это удобно для ссылок в письмах и мессенджерах. ## Состояния страницы - **Загрузка** — пока страница едет с сервера, на её месте показывается «Загрузка страницы…». - **Страница не найдена** — если адрес не совпадает ни с одной страницей (или страница недоступна читателю), показывается аккуратная заглушка «Страница не найдена». - **Ошибка загрузки** — если что-то пошло не так, появляется сообщение «Не удалось загрузить страницу» и кнопка **Повторить**. ## Полоса проблем от агента Если агент что-то не доделал в странице, сверху появляется полоса **Агент оставил на этой странице проблемы (N)**. Её можно раскрыть и увидеть, что именно не так. Читателям, которые не администраторы, эта полоса не показывается — служебные сообщения остаются внутри. ## Комментарии к странице Под содержимым страницы может быть нить комментариев — замечаний администратора к выделенному тексту. Она появляется, только когда замечания есть, и видна лишь администратору внутри портала. Замечание оставляют, выделив текст на странице; тем же выделением можно сразу отправить агенту задание отдельной беседой. Подробнее — в разделе [Комментарии к страницам](/agents/portal/docs/comments) . ## Ширина страницы Для каждой страницы задаётся один из трёх вариантов ширины: обычная (узкая колонка текста, удобная для чтения), широкая и во всю ширину экрана. Этот выбор задаёт агент в настройках страницы — читателю переключать ничего не нужно. ## Обновление на лету Сервер следит за файлами контента. Как только агент сохранил правку, открытая страница обновляется сама — без перезагрузки и без нажатия кнопок. Прокрутка при этом не сбрасывается: если вы читали середину длинной страницы, вы на ней и останетесь, даже когда содержание обновилось. Страница, в которой ничего не изменилось, лишний раз не перерисовывается. ## Переменные пути Некоторые страницы — это образцы, которые обслуживают сразу много адресов (подробнее — в разделе [Шаблоны и переменные](/agents/portal/docs/templates) ). Если такой образец открыли без нужного значения, сверху показывается блок **Переменные пути**. В нём выбирается значение, рядом видно **Итоговый путь**, а кнопка **Применить** открывает страницу по нужному адресу. Дальше: из чего складывается страница на диске — в разделе [Формат документа](/agents/portal/docs/documents) ; чем наполняется страница — в разделе [Блоки](/agents/portal/docs/blocks) ; куда попадают страницы с разным доступом — в разделе [Доступ к страницам](/agents/portal/docs/access) . [← Оглавление документации](/agents/portal/docs)