> ## Documentation Index
> Fetch the complete documentation index at: https://www.doc-reviewer.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Загрузка и оценка веб-страниц документации по URL

> Загружайте одну или несколько веб-страниц по URL через headless-браузер Chromium, затем оценивайте их инструкции как единый документ в Doc Reviewer.

Вместо загрузки файла вы можете указать Doc Reviewer URL страницы. Приложение загружает её через headless-браузер Chromium, извлекает разделы с инструкциями из HTML и обрабатывает результат как обычный документ, готовый к оценке. До запуска оценки вы можете добавить несколько страниц в один документ.

<Warning>
  Для оценки веб-страниц нужен Chromium, который не входит в комплект `.exe`. Установите его один раз на каждом компьютере, где вы хотите использовать эту функцию — независимо от того, запускаете ли вы `.exe` или исходный код. Откройте терминал и выполните:

  ```bash theme={null}
  py -3.11 -m playwright install chromium
  ```
</Warning>

## Загрузка веб-страницы

<Steps>
  <Step title="Откройте страницу Оценка">
    Нажмите **Оценка** в боковом меню или перейдите в любой проект и нажмите **Оценить по URL**.
  </Step>

  <Step title="Выберите вкладку «По URL»">
    В верхней части страницы Оценка нажмите вкладку **По URL**, чтобы переключиться с загрузки файла в режим URL.
  </Step>

  <Step title="Вставьте URL и нажмите «Загрузить»">
    Вставьте полный URL страницы (должен начинаться с `http://` или `https://`) и нажмите **Загрузить**. Doc Reviewer запустит Chromium в headless-режиме и загрузит страницу.
  </Step>

  <Step title="Дождитесь загрузки страницы">
    Chromium полностью отрисовывает страницу до начала извлечения контента, поэтому страницы с JavaScript и одностраничные приложения (SPA) загружаются корректно. Загрузка обычно занимает несколько секунд. В процессе отображается индикатор загрузки.
  </Step>

  <Step title="Добавьте дополнительные страницы (необязательно)">
    После успешной загрузки первой страницы в заголовке документа появляется кнопка **+ Добавить страницу**. Нажмите её, вставьте другой URL и нажмите **Загрузить**, чтобы добавить инструкции этой страницы в тот же документ. Повторите для каждой дополнительной страницы.
  </Step>

  <Step title="Перейдите к оценке">
    После загрузки всех страниц в дереве документа слева отображаются все извлечённые разделы с инструкциями. Просмотрите разделы, скорректируйте классификации при необходимости и нажмите **Оценить**, чтобы запустить оценку LLM.
  </Step>
</Steps>

<Note>
  Все добавленные страницы становятся частью одного документа. Каждый блок с инструкцией, извлечённый с каждой страницы, отображается как отдельный раздел в дереве документа и оценивается по отдельности.
</Note>

## Как работает веб-парсер

Doc Reviewer использует две стратегии разбора в зависимости от источника:

<Tabs>
  <Tab title="Веб-справка Positive Technologies">
    Если страница содержит пользовательские теги `<instruction>`, `<action>` или `<task>` — структура, используемая в веб-справке Positive Technologies — Doc Reviewer применяет специализированный парсер, который:

    * Обрабатывает каждый блок `<instruction>` как отдельный раздел документа
    * Корректно нумерует шаги внутри тегов `<action>`
    * Убирает артефакты вёрстки, например символы мягкого переноса (`&shy;`)

    Этот парсер обеспечивает наилучшее качество извлечения и является основным сценарием использования для веб-оценки.
  </Tab>

  <Tab title="Другие сайты">
    Для сайтов без структуры веб-справки Positive Technologies Doc Reviewer использует универсальный конвертер HTML в Markdown. Всё содержимое страницы преобразуется в Markdown и делится на разделы.

    Качество извлечения зависит от сайта. На сложных макетах, страницах с вкладочной навигацией и контентом, скрытым за JavaScript-взаимодействием, разделы могут быть неполными или содержать лишние данные.
  </Tab>
</Tabs>

<Note>
  Поскольку Chromium отрисовывает JavaScript до извлечения контента, приложение поддерживает страницы с JS и SPA. Статические HTML-страницы загружаются быстрее, но оба типа работают корректно.
</Note>