https://bugs.documentfoundation.org/show_bug.cgi?id=174028
Bug ID: 174028
Summary: Writer: Cross-references to headings become invalid in
a master document (.odm) containing linked
subdocuments (.odt)
Product: LibreOffice
Version: 26.8.0.3 release
Hardware: All
OS: Linux (All)
Status: UNCONFIRMED
Severity: normal
Priority: medium
Component: Writer
Assignee: [email protected]
Reporter: [email protected]
Description:
LIBREOFFICE BUG REPORT — ENGLISH VERSION
Title
Writer: Cross-references to headings become invalid in a master document (.odm)
containing linked subdocuments (.odt)
1. Environment
- Operating system: Ubuntu 26.04 LTS (Lubuntu, LXQt desktop).
- Application: LibreOffice Writer.
- Document format: OpenDocument Master Document (.odm).
- Structure: One master document containing seven linked .odt subdocuments.
- Table of contents: Manually created table with 101 rows, containing
cross-references displaying page numbers.
2. Problem description
In a LibreOffice Writer master document (.odm), some cross-references to
headings located in linked subdocuments stop working.
While certain cross-references correctly display their page numbers, others
display the following error:
“Error: Reference source not found”
The corresponding headings still exist in the linked subdocuments.
This issue is particularly problematic in large master documents, where
page-number cross-references must remain valid after editing, updating, saving,
and reopening the document.
3. Observations
The following observations were made during troubleshooting:
1. The master document correctly recognizes all seven linked subdocuments.
2. The headings and their contents are accessible from the master document.
3. The failing cross-references use automatically generated internal
identifiers associated with headings, such as __RefHeading___Toc....
4. Some cross-references remain functional, while others lose their reference
source.
5. Explicit text bookmarks provide identifiable reference targets and offer a
practical workaround.
A diagnostic performed through the LibreOffice UNO API confirmed that the
master document exposes 138 bookmarks, including 98 explicitly created
bookmarks with names beginning with RT_2026_.
The diagnostic also confirmed that all seven linked subdocuments were
accessible.
4. Expected behavior
When a cross-reference to a heading is inserted into a master document,
LibreOffice Writer should:
- Preserve the reference after saving and reopening the document.
- Correctly locate the referenced heading in its linked subdocument.
- Update the corresponding page number.
- Maintain the reference when the master document and its subdocuments are
updated.
5. Actual behavior
Some heading cross-references become invalid even though the corresponding
headings still exist.
The issue does not affect every cross-reference: some continue to display
correct page numbers, while others report that the reference source cannot be
found.
6. Workaround
The problematic heading cross-references were manually replaced with
cross-references targeting explicit text bookmarks.
These bookmarks were assigned unique names beginning with RT_2026_.
This approach makes the reference targets easier to identify and verify.
7. Remaining questions
The exact operation that causes the references to become invalid has not yet
been identified.
Further investigation is required to determine whether the issue is triggered
by:
- Updating linked subdocuments.
- Saving or reopening the master document.
- Editing or renaming headings.
- Updating cross-reference fields.
The available evidence does not yet establish the precise technical cause.
8. Suggested reproduction test
1. Create two Writer documents (.odt) containing several headings.
2. Create a master document (.odm) and insert both documents as linked
subdocuments.
3. Insert a manually constructed table of contents in the master document.
4. Add page-number cross-references to headings located in the linked
subdocuments, using the heading cross-reference category.
5. Save and close the master document.
6. Reopen it and update the linked subdocuments and cross-reference fields.
7. Check whether all cross-references still display valid page numbers.
8. Repeat after modifying some headings.
Note: This is a proposed reproduction procedure. It has not yet been
independently verified to reproduce the issue consistently.
9. Additional information
The problem was observed in a real master document containing seven linked
subdocuments and a manually constructed table of contents.
The original table contained approximately 76 page-number cross-reference
fields, some of which displayed valid numbers while others reported missing
reference sources.
The issue was worked around by replacing the automatic heading references with
references to explicit text bookmarks.
The behavior has been observed, but it has not yet been established whether it
is a reproducible LibreOffice defect or an inconsistency specific to the
affected document.
RAPPORT DE BOGUE LIBREOFFICE — VERSION FRANÇAISE
Titre
Writer : les renvois vers les titres deviennent invalides dans un document
maître (.odm) contenant des sous-documents liés (.odt)
1. Environnement
- Système d'exploitation : Ubuntu 26.04 LTS (Lubuntu, environnement LXQt).
- Application : LibreOffice Writer.
- Format : document maître OpenDocument (.odm).
- Structure : un document maître contenant sept sous-documents .odt liés.
- Table des matières : tableau construit manuellement, comportant 101 lignes et
des renvois affichant les numéros de page.
2. Description du problème
Dans un document maître LibreOffice Writer (.odm), certains renvois vers les
titres situés dans les sous-documents liés cessent de fonctionner.
Alors que certains renvois affichent correctement leur numéro de page, d'autres
affichent le message :
« Erreur : source de la référence non trouvée »
Les titres correspondants existent pourtant toujours dans les sous-documents
liés.
Ce dysfonctionnement est particulièrement gênant dans les documents maîtres
volumineux, où les renvois de page doivent rester valides après modification,
actualisation, enregistrement et réouverture du document.
3. Constatations
Les investigations ont permis d'établir les points suivants :
1. Le document maître reconnaît correctement les sept sous-documents liés.
2. Les titres et leur contenu sont accessibles depuis le document maître.
3. Les renvois défectueux utilisent des identifiants internes automatiquement
générés pour les titres, notamment __RefHeading___Toc....
4. Certains renvois restent fonctionnels, tandis que d'autres ne retrouvent
plus leur source.
5. L'utilisation de repères de texte explicites fournit des cibles de référence
identifiables et constitue une solution de contournement.
Un diagnostic réalisé avec l'interface de programmation UNO de LibreOffice a
confirmé que le document maître donne accès à 138 repères, dont 98 repères
explicites dont les noms commencent par RT_2026_.
Le diagnostic a également confirmé l'accessibilité des sept sous-documents
liés.
4. Comportement attendu
Lorsqu'un renvoi vers un titre est inséré dans un document maître, LibreOffice
Writer devrait :
- Conserver la référence après enregistrement et réouverture.
- Retrouver correctement le titre dans le sous-document lié.
- Actualiser le numéro de page correspondant.
- Maintenir la validité du renvoi lors de l'actualisation du document maître et
de ses sous-documents.
5. Comportement observé
Certains renvois vers les titres deviennent invalides alors que les titres
correspondants existent toujours.
Le problème ne touche pas tous les renvois : certains continuent à afficher des
numéros de page corrects, tandis que d'autres signalent que la source de la
référence est introuvable.
6. Solution de contournement
Les renvois problématiques vers les titres ont été remplacés manuellement par
des renvois vers des repères de texte explicites.
Ces repères ont reçu des noms uniques commençant par RT_2026_.
Cette méthode facilite l'identification et la vérification des cibles des
renvois.
7. Questions restant à examiner
L'opération exacte qui provoque l'invalidation des références n'a pas encore
été identifiée.
Il reste à déterminer si le problème apparaît lors :
- De l'actualisation des sous-documents liés.
- De l'enregistrement ou de la réouverture du document maître.
- De la modification ou du renommage des titres.
- De l'actualisation des champs de renvoi.
Les éléments disponibles ne permettent pas encore d'établir la cause technique
précise.
8. Procédure de reproduction proposée
1. Créer deux documents Writer (.odt) contenant plusieurs titres.
2. Créer un document maître (.odm) et y insérer les deux documents comme
sous-documents liés.
3. Construire manuellement une table des matières dans le document maître.
4. Insérer des renvois affichant les numéros de page des titres situés dans les
sous-documents, en utilisant la catégorie de renvoi vers les titres.
5. Enregistrer et fermer le document maître.
6. Le rouvrir et actualiser les sous-documents ainsi que les champs de renvoi.
7. Vérifier que tous les renvois affichent toujours des numéros de page
valides.
8. Recommencer après modification de certains titres.
Remarque : cette procédure est proposée à titre de test. Il n'a pas encore été
vérifié qu'elle reproduit systématiquement le problème.
9. Informations complémentaires
Le problème a été observé dans un document maître réel contenant sept
sous-documents liés et une table des matières construite manuellement.
Le tableau initial contenait environ 76 champs de renvoi vers des numéros de
page. Certains affichaient correctement leur numéro, tandis que d'autres
indiquaient que leur source était introuvable.
Le problème a été contourné en remplaçant les références automatiques aux
titres par des références à des repères de texte explicites.
Le dysfonctionnement a été constaté, mais il reste à établir s'il s'agit d'un
bogue reproductible de LibreOffice ou d'une anomalie propre au document
concerné.
Actual Results:
...
Expected Results:
...
Reproducible: Always
User Profile Reset: No
Additional Info:
...
--
You are receiving this mail because:
You are the assignee for the bug.
