---
title: "Частичное обновление — алгоритм обновления Дерева страниц"
id: "chastichnoye-obnovleniye-algoritm-obnovleniya-dereva-stranits"
project: "Руководство пользователя Документерры"
url: "https://docs.documenterra.ru/articles/manual/chastichnoye-obnovleniye-algoritm-obnovleniya-dereva-stranits"
updated: 2026-11-16T06:45:48Z
---

# Частичное обновление — алгоритм обновления Дерева страниц

В этом разделе мы предоставим вам информацию об алгоритме слияния Дерева страниц в [режиме частичного обновления публикации](/articles/manual/rezhim-chastichnogo-obnovleniya-publikatsii).

## Как работает обновление Дерева страниц публикации?

В системе Документерра используются идентификаторы страниц для сопоставления страниц в вашем проекте со страницами в обновленной публикации, чтобы определить, какие страницы уже существуют в публикации. Система выполняет обновление на основе двух принципов:

1. Дерево страниц публикации обновляется с минимально возможными изменениями.
2. Страницы, не участвующие в процессе публикации (например, дочерние или родительские элементы обновляемых страниц), не затрагиваются.

В основном обновляются все страницы, которые уже существуют в публикации, а если каких-то страниц еще нет, то они будут добавлены в публикацию, если Документерра сумеет найти для них подходящее место в Дереве страниц. Если Документерра не может определить, куда следует добавить страницу в иерархии Дерева страниц данной публикации, то страница и ее дочерние элементы не будут опубликованы (при этом в журнале публикаций будут выдаваться соответствующие предупреждения).

| ![](/resources/Storage/manual/documenterra_baselang/Images/quick-parts/icon-info-important.svg) | Важно |
| --- | --- |
| При частичном обновлении система не изменяет позиции страниц и не удаляет страницы из публикаций. Если необходимо переместить страницы или удалить их, рассмотрите возможность перемещения/удаления вручную или используйте режим публикации **Заменить полностью**. |

Предположим, что вы публикуете страницу, имеющую идентификатор **getting-started**. Документерра ищет страницу с таким же идентификатором в обновленной публикации. Если такая страница существует, то обновляется ее контент и свойства. При этом положение страницы и ее видимость в Дереве страниц публикации не изменяются, даже если они различны в публикации и проекте. Это делается для того, чтобы соблюсти два вышеуказанных принципа.

Если в публикации нет страницы с таким же идентификатором, то происходит следующее:

* Документерра проверяет родительскую страницу на наличие в проекте страницы **getting-started**.
* Если родительская страница существует в публикации, то страница **getting-started** будет добавлена в качестве ее дочернего элемента.
* Если родительская страница не существует, но будет добавлена в ходе текущей публикации, то будет также добавлена страница **getting started**. Это означает, что таким образом можно публиковать целые ветви новых страниц; необходимо только убедиться, что самые верхние из публикуемых страниц или, по крайней мере, их ближайшие родительские элементы имеют соответствующие существующие страницы в данной публикации.
* Если страница **getting-started** не имеет аналогов в публикации, ее родительский элемент не имеет аналогов в публикации и он не участвует в текущей операции публикации, то страница и все ее дочерние элементы не будут опубликованы, поскольку в этом случае для нее не может быть определено желаемое местоположение в Дереве страниц.

## Работа с элементами навигации

Страницы могут содержать различные элементы навигации — списки связанных статей, ссылки Далее/Назад/Наверх и Хлебные крошки. При публикации таких страниц в режиме частичного обновления навигационные элементы будут обновляться в публикуемых страницах в соответствии с Деревом страниц целевой публикации. Однако элементы навигации в других страницах (тех, которые вы не публикуете) обновляться не будут, в соответствии с двумя вышеизложенными принципами.

Это может привести к несоответствию навигации — вновь добавленная страница не будет находиться в списке связанных статей родительской страницы в публикации, если родительская страница не была опубликована. Помните об этом при использовании режима частичного обновления — возможно, вам придется обновить несколько дополнительных страниц, чтобы убедиться в согласованности элементов навигации, даже если вы не вносили в них изменений.

## Примеры работы алгоритма слияния Дерева страниц при частичном обновлении

Ниже приведены некоторые случаи, на которые следует обратить внимание.

### Пример №1: Страницы, которых нет в целевой публикации, но которые должны быть опубликованы, будут добавлены в целевую публикацию в соответствии с их текущей позицией в Дереве страниц

Вы создаете страницу в проекте:
![Элемент Дерева страниц в проекте](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case1_new_topic.png)
Вы увидите его в той же позиции в Дереве страниц публикации после публикации с частичным обновлением:
![Элемент Дерева страниц в публикации](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case1_new_topic_publication.png)
### Пример №2: Вновь созданные дочерние страницы будут добавлены с сохранением их позиции в Дереве страниц

В вашем проекте есть страница без дочерних элементов, и эта страница была опубликована ранее:
![Элемент Дерева страниц в проекте](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case2_topic_in_project.png)
Вы решаете добавить дочерние элементы:
![Добавление дочерних страниц в проект](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case2_add_childtopic.png)
Вы выбираете дочерние страницы для публикации и публикуете их:
![Дочерние страницы, выбранные для публикации](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case2_topics_to_publish.png)
В результате они будут добавлены в публикацию в соответствии с их положением в Дереве страниц проекта. Вот как будет выглядеть Дерево страниц целевой публикации:
![Дочерняя страница появилась в публикации](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case2_topics_in_publications.png)
### Пример №3: Страницы, не выбранные для публикации, обновляться не будут

Это означает, что контент, верхние и нижние колонтитулы этих страниц не будут обновляться, в то время как контент, верхние и нижние колонтитулы страниц, выбранных для публикации, будут обновлены. Если вы внесли изменения в мастер-страницу проекта, то при публикации необходимо использовать режим **Заменить полностью**, чтобы убедиться, что ко всем опубликованным страницам применена новая мастер-страница.

### Пример №4: Страницы, исключенные из проекта, останутся в публикации

Итак, вот страница нашего проекта:
![Элемент Дерева страниц в проекте](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case4_topic_in_project.png)
А затем мы ее удаляем:
![Элемент Дерева страниц, удаленный из проекта](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case4_topic_deleted.png)
Если опубликовать проект в режиме частичного обновления, то он **не** будет удален из публикации:
![Удаленная страница не была удалена из публикации](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case4_in_publication.png)
Чтобы убрать удаленную страницу из публикации, необходимо обновить публикацию с помощью режима **Заменить полностью**, чтобы полностью заменить ее новым Деревом страниц, или удалить страницу из самой публикации вручную.

### Пример №5: В режиме частичного обновления обновляется контент страницы, которая уже существует в публикации, но не ее позиция в Дереве страниц

Вот страница в проекте:
![Элемент Дерева страниц в проекте](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case5_topic_in_project.png)
Мы перенесли страницу в другое место в Дереве страниц и решили обновить только эту страницу:
![Элемент Дерева страниц в проекте был перемещен в другое место в Дереве страниц](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case5_topic_moved.png)
В результате будет обновлен контент страницы в публикации, но не позиция страницы в Дереве страниц публикации:
![Элемент Дерева страниц не изменил своего положения в Дереве страниц публикации](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case5_topic_notmoved.png)
Если необходимо изменить положение страницы в Дереве страниц, это можно сделать двумя способами: перетащить ее в публикацию вручную или заменить существующую публикацию, опубликовав проект в режиме **Заменить полностью**.

### Пример № 6: Режим частичного обновления не влияет на видимость опубликованной страницы в качестве элемента Дерева страниц

Предположим, что вы изменили видимость элемента [Дерева страниц](/articles/manual/obschie-svoystva-stranitsy) для конкретной страницы в вашем проекте. При публикации этой страницы в режиме частичного обновления видимость опубликованной страницы как элемента Дерева страниц не изменяется, поскольку это может повлиять на дочерние элементы, не участвовавшие в операции публикации. Однако этот параметр можно изменить вручную в опубликованной странице или воспользоваться режимом публикации **Полная замена**.

### Пример №7: Обновление страниц, имеющих статус «Готово»

Если вы используете режим частичного обновления для публикации только Опубликовать со статусом **Готово**, имейте в виду, что система все равно будет обрабатывать структуру оглавления сверху. Если какая-то страница имеет статус **Готово**, а ее родительский элемент — **Черновик**, то готовая страница все равно не будет опубликована в этом режиме.

Например, выделенные страницы имеют статус **Готово**:
![Готовые страницы в проекте](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case7_ready_status.png)
Таким образом, они не будут опубликованы, потому что их родительский элемент имеет статус **Черновик**:
![Готовые страницы отсутствуют в публикации, поскольку их родительский элемент имеет статус «Черновик»](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case7_ready_topics_notpublished.png)
Для этого необходимо изменить статус родительского элемента на **** **Готово**. В качестве альтернативы можно использовать публикацию по страницам — выбрать нужные дочерние страницы с помощью кнопки **Функция массового редактирования** и опубликовать их. Как это сделать, читайте [здесь](/articles/manual/rezhim-chastichnogo-obnovleniya-publikatsii) .

### Пример № 8: Дочерняя страница не будет опубликована, если ее родительская страница не находится в публикации и не будет опубликована в ходе данной операции

Например, вы решили обновить дочернюю страницу родительской под названием **Уровень 1**:
![Элемент Дерева страниц в проекте](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case8_child_topic.png)
Однако страница **Уровень 1** в публикации отсутствует:
![Элемент Дерева страниц отсутствует в публикации](/resources/Storage/manual/documenterra_baselang/Screenshots/partial-update-TOC-update-algorithm/case8_topic_not_in_publication.png)
В этом случае дочерние страницы не могут быть опубликованы, пока не будет опубликована страница **Уровень 1** или выбрана для той же операции публикации.