diff options
authorOlivier Hallot <>2021-06-12 16:35:25 -0300
committerOlivier Hallot <>2021-06-12 21:57:07 +0200
commit390d5cf871798108c4a45b78dfcdb22bbd4667cc (patch)
parentFix embed links (diff)
tdf#126507 Add help page for Combine Text in Draw libreoffice-7-2-branch-point
Change-Id: I8fc7b9fa152d732486ac59c3d9544ac12a39e5e7 Reviewed-on: Tested-by: Jenkins Reviewed-by: Olivier Hallot <>
2 files changed, 63 insertions, 0 deletions
diff --git a/ b/
index 94cceb925..80629f7eb 100644
--- a/
+++ b/
@@ -21,6 +21,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,sdraw,\
helpcontent2/source/text/sdraw/00/00000004 \
helpcontent2/source/text/sdraw/00/page_menu \
helpcontent2/source/text/sdraw/01/3dsettings_toolbar \
+ helpcontent2/source/text/sdraw/01/consolidatetext \
helpcontent2/source/text/sdraw/01/delete_page \
helpcontent2/source/text/sdraw/01/duplicate_page \
helpcontent2/source/text/sdraw/01/insert_layer \
diff --git a/source/text/sdraw/01/consolidatetext.xhp b/source/text/sdraw/01/consolidatetext.xhp
new file mode 100644
index 000000000..fe371405f
--- /dev/null
+++ b/source/text/sdraw/01/consolidatetext.xhp
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<helpdocument version="1.0">
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at
+ *
+ <topic id="consolidatetext" indexer="include" status="PUBLISH">
+ <title id="tit" xml-lang="en-US">Consolidate Text Boxes</title>
+ <filename>/text/sdraw/01/consolidatetext.xhp</filename>
+ </topic>
+<bookmark id="bm_id301623510996084" xml-lang="en-US" branch="hid/.uno:TextCombine" localize="false"/>
+<bookmark xml-lang="en-US" branch="index" id="bm_id371623524099696">
+<bookmark_value>text box consolidation</bookmark_value>
+<bookmark_value>join PDF lines;text box consolidation</bookmark_value>
+<bookmark_value>combine text box;text box consolidation</bookmark_value>
+<bookmark_value>combine text frames;text box consolidation</bookmark_value>
+<section id="textboxconsolidation">
+<h1 id="hd_id861623510996086"><link href="text/sdraw/01/consolidatetext.xhp" name="consolidate text">Text Box Consolidation</link></h1>
+<paragraph id="par_id441623510996088" role="paragraph" xml-lang="en-US"><variable id="textboxconsolidationv1"><ahelp hid=".">Combine two or more selected text boxes into one.</ahelp></variable></paragraph>
+<section id="howtoget">
+<paragraph role="paragraph" id="par_id111623511334889">Select two or more text boxes and either</paragraph>
+<paragraph role="paragraph" id="par_id711623512060597">Choose menu <menuitem>Shape - Consolidate Text</menuitem>.</paragraph>
+<paragraph role="paragraph" id="par_id501623512080240">Open context menu and choose <menuitem>Consolidate Text</menuitem>.</paragraph>
+<paragraph role="paragraph" id="par_id61623512950690">Text box consolidation joins several text boxes into a bigger text box, enabling text reflow inside the resulting box.</paragraph>
+<tip id="par_id141623511540551"><emph>Consolidate text</emph> command is specially useful for editing PDF documents with %PRODUCTNAME Draw.</tip>
+<paragraph role="paragraph" id="par_id471623513979583">The function inspects the text fragments to see if they end in sentence-ending punctuation. If not, then the next text box's content is appended to it instead of starting a new paragraph. You must afterwards fix up paragraphing, and set paragraph properties.</paragraph>
+<h2 id="hd_id381623516529280">Remarks</h2>
+<list type="unordered">
+ <listitem>
+ <paragraph id="par_id211623513189855" role="listitem">The resulting text box is inserted into the current layer.</paragraph>
+ <paragraph id="par_id61623516556624" role="listitem">If the single text box objects are named, the resulting text box is unnamed.</paragraph>
+ <paragraph id="par_id611623516624688" role="listitem">Title and description of the single text boxes are lost.</paragraph>
+ <paragraph id="par_id281623513291901" role="listitem">The previous text box objects are deleted after consolidation.</paragraph>
+ <paragraph id="par_id531623515498932" role="listitem">Consolidation of lists requires attention to restore the list layout that has been affected by the position of the punctuation. This includes the case of numbering of style "1.", where he resulting list items are split after the dot.</paragraph>
+ <paragraph id="par_id931623525360411" role="listitem">For better results, combine adjacent text boxes with similar paragraph formatting. Character formatting inside the text boxes is preserved. Combining text boxes with different paragraph styles (headings, list and more) will require manual intervention to restore the original text layout.</paragraph>
+<section id="relatedtopics">
+ <embed href="text/shared/01/ref_pdf_export.xhp#ref_pdf_export"/>