source/text/swriter/01/02110000.xhp | 10 ++-
source/text/swriter/01/02110100.xhp | 109 +++++++++++++++---------------------
2 files changed, 56 insertions(+), 63 deletions(-)
New commits:
commit 686da2a7ece1ce03db28cfba2747870c88a9ca2e
Author: Stéphane Guillou <stephane.guil...@libreoffice.org>
AuthorDate: Wed Apr 17 04:57:44 2024 +0100
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Thu Apr 25 18:13:36 2024 +0200
tdf#156273 tdf#155882 update Navigate By documentation
- update since changes in:
- 7.0: from icon that opens a toolbar, to listbox
- 7.1: commands hidden by default in Find toolbar
- 7.2: Recency added to Navigate By
- hyperlink relevant pages and embed sections
- correct command labels
- add bookmarks
- related tdf#156332: remove space breaking HID linking
- paragraphs for categories that need explanations
- remove obsolete <ahelp> and bookmarks
Remaining doubts:
- how "Wrong table formula" works (broken?)
Change-Id: I1de013be320d31396076f4ccec991a52a14e1db5
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/166096
Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
Tested-by: Jenkins
diff --git a/source/text/swriter/01/02110000.xhp
b/source/text/swriter/01/02110000.xhp
index 803bd84d4f..0f24de8c07 100644
--- a/source/text/swriter/01/02110000.xhp
+++ b/source/text/swriter/01/02110000.xhp
@@ -48,7 +48,7 @@
<paragraph id="par_id3149490" role="paragraph">Click the expander icon (+)
next to a category in the Navigator to view the items in the category. Click on
an expanded category to collapse it.</paragraph>
<paragraph role="paragraph" id="par_id611683893638800">To view the number of
items in a category, rest your mouse pointer over the category in the
Navigator.</paragraph>
<paragraph role="paragraph" id="par_id941683893643631">To jump to an item in
the document, double-click the item in the Navigator.</paragraph>
-<paragraph id="par_id3149106" role="paragraph">To jump to the next or previous
item in a document, use the <emph>Navigate by</emph> box to select the item
category, and then click the up or down arrows.</paragraph>
+<paragraph id="par_id3149106" role="paragraph">To jump to the next or previous
item in a document, use the <link
href="text/swriter/01/02110100.xhp"><emph>Navigate By</emph></link> list to
select the item category, and then click the <emph>Previous</emph> or
<emph>Next</emph> arrows.</paragraph>
<paragraph role="paragraph" id="par_id571655653825780">The navigator shows the
correspondence between the current document cursor location element and the
navigator view, according to different categories: Headings, Tables, Hyperlinks
and more. The element is displayed and highlighted in the Navigator content
view. If the element is located in a collapsed layer, the required layers above
it are automatically expanded and remain expanded afterwards.</paragraph>
@@ -64,6 +64,7 @@
<section id="navigateby">
<h2 id="hd_id321603114930016">Navigate By</h2>
<paragraph role="paragraph" id="par_id171603114951991">Use selection box to
choose which type of item should be navigated, when using the Previous and Next
buttons.</paragraph>
+ <section id="navigateby_arrows">
<h2 id="hd_id3150096">Previous</h2>
<paragraph id="par_id3148784" role="paragraph">Jumps to the previous item in
the document. To specify the type of item to jump to, click the <emph>Navigate
By</emph> list, and then click an item category - for example,
"Images".</paragraph>
<table id="tbl_id3150044">
@@ -89,11 +90,14 @@
</tablecell>
</tablerow>
</table>
+ </section>
</section>
<bookmark branch="hid/modules/swriter/ui/navigatorpanel/numericfield"
id="bm_id3148726" localize="false"/>
+ <section id="navigateby_pages">
<h2 id="hd_id3148715">Page number</h2>
<paragraph id="par_id3155548" role="paragraph"><ahelp
hid="modules/swriter/ui/navigatorpanel/numericfield">Type the number of the
page that you want to jump to, and then press Enter. Use the spin buttons to
navigate.</ahelp></paragraph>
+ </section>
<h2 id="hd_id3146891">Content Navigation View</h2>
<paragraph id="par_id3145596" role="paragraph"><ahelp
hid="modules/swriter/ui/navigatorpanel/root">Switches between the display of
all categories in the Navigator and the selected category.</ahelp></paragraph>
@@ -175,7 +179,7 @@
<bookmark branch="hid/modules/swriter/ui/navigatorpanel/reminder"
id="bm_id3155392" localize="false"/>
<h2 id="hd_id3155381">Set Reminder</h2>
-<paragraph id="par_id3153011" role="paragraph"><ahelp hid="."
visibility="hidden">Click here to set a reminder at the current cursor
position. You can define up to five reminders. To jump to a reminder, click the
<link href="text/swriter/01/02110100.xhp"><emph>Navigation</emph></link> icon,
in the <emph>Navigation</emph> window click the <emph>Reminder</emph> icon, and
then click the <emph>Previous</emph> or <emph>Next</emph> button.</ahelp> Click
here to set a reminder at the current cursor position. You can define up to
five reminders. To jump to a reminder, click the <link
href="text/swriter/01/02110100.xhp">Navigation</link> icon, in the Navigation
window click the Reminder icon, and then click the Previous or Next
button.</paragraph>
+<paragraph id="par_id3153011" role="paragraph"><ahelp hid="."
visibility="hidden">Click here to set a reminder at the current cursor
position. You can define up to five reminders. To jump to a reminder, click the
<link href="text/swriter/01/02110100.xhp"><emph>Navigation</emph></link> icon,
in the <emph>Navigation</emph> window click the <emph>Reminder</emph> icon, and
then click the <emph>Previous</emph> or <emph>Next</emph> button.</ahelp> Click
here to set a reminder at the current cursor position. You can define up to
five reminders. To jump to a reminder, click the <link
href="text/swriter/01/02110100.xhp">Navigate By</link> list, select
<menuitem>Reminder</menuitem>, and then click <emph>Previous</emph> or
<emph>Next</emph>.</paragraph>
<table id="tbl_id3154577">
<tablerow>
@@ -187,7 +191,9 @@
</tablecell>
</tablerow>
</table>
+ <section id="reminders_note">
<note id="par_id3495381">Reminders are navigated in the order in which they
are set. Reminders are not saved when a document is closed.</note>
+ </section>
<bookmark branch="hid/modules/swriter/ui/navigatorpanel/headings"
id="bm_id3150519" localize="false"/>
<bookmark branch="hid/SW_HID_NAV_OUTLINE_LEVEL" id="bm_id3156965"
localize="false"/>
diff --git a/source/text/swriter/01/02110100.xhp
b/source/text/swriter/01/02110100.xhp
index 889dc2c45b..573dd2a298 100644
--- a/source/text/swriter/01/02110100.xhp
+++ b/source/text/swriter/01/02110100.xhp
@@ -33,66 +33,53 @@
</meta>
<body>
<bookmark branch="hid/SW_HID_SCRL_NAVI" id="bm_id3149832" localize="false"/>
-<bookmark branch="hid/
.uno:AvailableToolbars?Toolbar:string=navigationobjectbar"
id="bm_id731690546250138" localize="false"/>
-<h1 id="hd_id3147745">Navigation</h1>
-<paragraph role="paragraph" id="par_id3149844" xml-lang="en-US"><ahelp
hid="HID_SCRL_NAVI">If you click this icon in the Navigator or in the lower
right of the document window, a toolbar will appear which enables you to choose
among the existing targets within a document.</ahelp> You can then use the up
and down arrow icons to position the text cursor in the document on the
previous or next target.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_SCRL_PAGEUP" id="bm_id3153304"
localize="false"/>
-<paragraph role="paragraph" id="par_id3153293" xml-lang="en-US"><ahelp
hid="HID_SCRL_PAGEUP">Click the up button to scroll to the previous page or
object.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_SCRL_PAGEDOWN" id="bm_id3156109"
localize="false"/>
-<paragraph role="paragraph" id="par_id3156098" xml-lang="en-US"><ahelp
hid="HID_SCRL_PAGEDOWN">Click the down button to scroll to the next page or
object.</ahelp></paragraph>
-<paragraph role="paragraph" id="par_id3155076" xml-lang="en-US">By default, as
long as you have not selected any other entry, the arrow buttons jump to the
previous or the next page in the document. The arrow buttons are black if you
are browsing through pages and blue if you jump to other objects.</paragraph>
-<paragraph role="paragraph" id="par_id3154330" xml-lang="en-US">The entries
largely correspond to those in the <link
href="text/swriter/01/02110000.xhp">Navigator</link> selection box. You can
also select other jump destinations. An example are the reminders, which you
can set with the <emph>Set Reminder</emph> icon in the Navigator. You can
select an object from among the following options on the
<emph>Navigation</emph> toolbar: table, frame, graphics, OLE object, page,
headings, reminder, drawing object, control field, section, bookmark,
selection, footnote, note, index entry, table formula, wrong table
formula.</paragraph>
-<paragraph role="paragraph" id="par_id3148330" xml-lang="en-US">Reminders are
navigated in the order in which they are set.</paragraph>
-<paragraph role="paragraph" id="par_id3148783" xml-lang="en-US">For table
formulas, you can either jump to all table formulas located within your
document or only to the incorrect ones. For incorrect formulas, you jump only
to formulas that have resulted in errors. The program skips over formulas with
resulting errors (those that reference incorrect formulas).</paragraph>
-<h2 id="hd_id3150031">Working With the Navigation Toolbar</h2>
-<paragraph role="paragraph" id="par_id3150045" xml-lang="en-US">Open the
<emph>Navigation</emph> toolbar by clicking on its top left icon located on the
top of the Navigator display area. You can break the toolbar away from its
place by dragging and arranging it on the screen.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NAVI_VS" id="bm_id3154622"
localize="false"/>
-<paragraph role="paragraph" id="par_id3153141" xml-lang="en-US"><ahelp
hid="HID_NAVI_VS">Click the icon for the type of objects you want to browse
through. Then click one of the "Previous Object" or "Next Object" arrow
buttons. The names of these buttons indicate the type of object you have
selected. The text cursor is placed on whichever object you have
selected.</ahelp></paragraph>
-<paragraph role="tip" id="par_id3149968" xml-lang="en-US">You can configure
$[officename] according to your specific preferences for navigating within a
document. To do this, choose <link
href="text/shared/01/06140000.xhp"><emph>Tools - Customize</emph></link>. The
various tables for adapting <link
href="text/shared/01/06140100.xhp">menus</link>, <link
href="text/shared/01/06140200.xhp">keyboard input</link> or toolbars contain
various functions for navigation within the document under the "Navigate" area.
In this way you can jump to the index tags in the document with the "To
Next/Previous Index Tag" functions.</paragraph>
-<bookmark xml-lang="en-US" branch="index"
id="bm_id3155338"><bookmark_value>searching; repeating a search</bookmark_value>
-</bookmark>
-<h2 id="hd_id3155338">Repeat Search</h2>
-<paragraph role="paragraph" id="par_id3155361" xml-lang="en-US">With the
<emph>Repeat search</emph> icon on the <emph>Navigation</emph> toolbar you can
repeat a search you started with the <emph>Search and Replace</emph> dialog. To
do this, click the icon. The blue arrow buttons on the vertical scrollbar now
take on the functions <emph>Continue search forwards</emph> and <emph>Continue
search backwards</emph>. If you now click one of the arrow surfaces, the search
will be continued for the term entered in the Search and Replace
dialog.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_BKM" id="bm_id2258064"
localize="false"/>
-<paragraph role="paragraph" id="par_idN106DD" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
bookmarks.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_CTRL" id="bm_id9021576"
localize="false"/>
-<paragraph role="paragraph" id="par_idN106F4" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through control
fields.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_DRW" id="bm_id4192327"
localize="false"/>
-<paragraph role="paragraph" id="par_idN1070B" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through drawing
objects.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_FRM" id="bm_id8498794"
localize="false"/>
-<paragraph role="paragraph" id="par_idN10722" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
frames.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_FTN" id="bm_id66835"
localize="false"/>
-<paragraph role="paragraph" id="par_idN10739" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
footnotes.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_GRF" id="bm_id7068697"
localize="false"/>
-<paragraph role="paragraph" id="par_idN10750" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
graphics.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_INDEX_ENTRY"
id="bm_id9798577.00000001" localize="false"/>
-<paragraph role="paragraph" id="par_idN10767" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through index
entries.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_MARK" id="bm_id9345988"
localize="false"/>
-<paragraph role="paragraph" id="par_idN1077E" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
reminders.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_NEXT" id="bm_id3960692"
localize="false"/>
-<paragraph role="paragraph" id="par_idN10795" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Sets the cursor to the next object of the selected
type.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_OLE" id="bm_id5234534"
localize="false"/>
-<paragraph role="paragraph" id="par_idN107AF" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through OLE
objects.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_OUTL" id="bm_id1883602"
localize="false"/>
-<paragraph role="paragraph" id="par_idN107C6" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
headings.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_PGE" id="bm_id6152836"
localize="false"/>
-<paragraph role="paragraph" id="par_idN107DD" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
pages.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_POSTIT" id="bm_id5230567"
localize="false"/>
-<paragraph role="paragraph" id="par_idN107F4" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
comments.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_PREV" id="bm_id1692556"
localize="false"/>
-<paragraph role="paragraph" id="par_idN1080B" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Sets the cursor to the previous object of the selected
type.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_REG" id="bm_id9508651"
localize="false"/>
-<paragraph role="paragraph" id="par_idN10829" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
sections.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_SEL" id="bm_id7225257"
localize="false"/>
-<paragraph role="paragraph" id="par_idN10840" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
selections.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_SRCH_REP" id="bm_id1448408"
localize="false"/>
-<paragraph role="paragraph" id="par_idN10857" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through search
results.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_TABLE_FORMULA"
id="bm_id7630237" localize="false"/>
-<paragraph role="paragraph" id="par_idN1086E" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through table
formulas.</ahelp></paragraph>
-<!-- removed HID HID_NID_FORMULA_ERROR -->
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_TABLE_FORMULA_ERROR"
id="bm_id8653523" localize="false"/>
-<paragraph role="paragraph" id="par_idN10885" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through wrong table
formulas.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/SW_HID_NID_TBL" id="bm_id4498428"
localize="false"/>
-<paragraph role="paragraph" id="par_idN1089C" xml-lang="en-US"><ahelp hid="."
visibility="hidden">Select this icon to browse through
tables.</ahelp></paragraph>
+<bookmark
branch="hid/.uno:AvailableToolbars?Toolbar:string=navigationobjectbar"
id="bm_id731690546250138" localize="false"/>
+<bookmark branch="hid/modules/swriter/ui/navigatorpanel/.uno:NavElement"
id="bm_id321713404357993" localize="false"/>
+<h1 id="hd_id3147745">Navigate By</h1>
+
+ <paragraph role="paragraph" id="par_id3149844"><ahelp
hid="HID_SCRL_NAVI">The <emph>Navigate By</emph> selection box allows choosing
a category to navigate the document by, including pages, headings, sections,
objects, fields, comments, latest search results and recency of cursor
position.</ahelp> You can then use the <emph>Previous</emph> and
<emph>Next</emph> arrow icons to position the text cursor in the document on
the previous or next target.</paragraph>
+
+ <section id="howtoget">
+ <embed href="text/swriter/01/02110000.xhp#howtoget"/>
+ </section>
+
+ <h2 id="hd_id3150031">Working With Navigate By</h2>
+ <paragraph role="paragraph" id="par_id3155076">By default, as long as you
have not selected any other category, the Page category is selected, and the
arrows are replaced by a number field that can be used to go to the previous or
the next page, or jump to a specific one.</paragraph>
+ <bookmark xml-lang="en-US" branch="hid/SW_HID_NAVI_VS" id="bm_id3154622"
localize="false"/>
+ <paragraph role="paragraph" id="par_id3153141" xml-lang="en-US"><ahelp
hid="HID_NAVI_VS">Once you select another category, you can use the "Previous"
or "Next" arrow buttons. The labels of these buttons indicate the type of
object you have selected. The text cursor is then placed on whichever object
you have selected.</ahelp></paragraph>
+
+ <bookmark xml-lang="en-US" branch="hid/SW_HID_SCRL_PAGEUP" id="bm_id3153304"
localize="false"/>
+ <bookmark xml-lang="en-US" branch="hid/SW_HID_SCRL_PAGEDOWN"
id="bm_id3156109" localize="false"/>
+ <bookmark branch="hid/modules/swriter/ui/navigatorpanel/gotopage"
id="bm_id641713404959460" localize="false"/>
+ <embed href="text/swriter/01/02110000.xhp#navigateby_pages"/>
+ <bookmark
branch="hid/modules/swriter/ui/navigatorpanel/.uno:ScrollToPrevious"
id="bm_id331713404689417" localize="false"/>
+ <bookmark branch="hid/modules/swriter/ui/navigatorpanel/.uno:ScrollToNext"
id="bm_id311713404734071" localize="false"/>
+ <embed href="text/swriter/01/02110000.xhp#navigateby_arrows"/>
+
+ <tip id="par_id3149968">You can configure $[officename] according to your
specific preferences for navigating within a document. To do this, choose <link
href="text/shared/01/06140000.xhp"><emph>Tools - Customize</emph></link>. The
various tables for adapting <link
href="text/shared/01/06140100.xhp">menus</link>, <link
href="text/shared/01/06140200.xhp">keyboard input</link> or toolbars contain
various functions for navigation within the document under the "Navigate"
category. For example, you can add buttons to a toolbar to jump to the index
tags in the document with the "Go to Next/Previous Index Entry" commands.</tip>
+ <paragraph role="paragraph" id="par_id3154330">The available categories
largely correspond to those in the <link
href="text/swriter/01/02110000.xhp">Navigator</link> selection box. However,
you can select other jump destinations that are not classic Navigator
categories: for example, Reminders, Repeat Search or Recency.</paragraph>
+ <paragraph role="paragraph" id="par_id561713406417133">Select from one of
the following options: Bookmarks, Comments, Controls, Drawing objects, Fields
by type, Fields, Footnotes, Frames, Headings, Images, Indexes, OLE objects,
Page, Recency, Reminder, Repeat search, Sections, Selection, Table formula,
Tables, Wrong table formula.</paragraph>
+
+ <h2 id="hd_id1001713405229169">Footnotes</h2>
+ <paragraph role="paragraph" id="par_id541713405238672">Select the
<emph>Footnotes</emph> category to jump between footnotes and endnotes. This
can be used in conjunction with the <emph>Anchor ↔ Text</emph> button in the
Navigator, to quickly jump between the text of the footnote/endnote and its
anchor in the body.</paragraph>
+
+ <h2 id="hd_id801713406561353">Recency</h2>
+ <paragraph role="paragraph" id="par_id141713406574059">When selecting the
<emph>Recency</emph> category, the <emph>Go back</emph> and <emph>Go
forward</emph> buttons can be used to jump to recent cursor positions in the
document.</paragraph>
+
+ <h2 id="hd_id701713405928808">Reminders</h2>
+ <paragraph role="paragraph" id="par_id871713405938067">Up to 5
<emph>Reminders</emph> (which are not saved when the document is closed) can be
set at various locations in the document. Set a reminder with the <emph>Set
Reminders</emph> button in the Navigator.</paragraph>
+ <embed href="text/swriter/01/02110000.xhp#reminders_note"/>
+
+ <bookmark xml-lang="en-US" branch="index"
id="bm_id3155338"><bookmark_value>searching; repeating a search</bookmark_value>
+ </bookmark>
+ <h2 id="hd_id3155338">Repeat Search</h2>
+ <paragraph role="paragraph" id="par_id3155361">With the <menuitem>Repeat
search</menuitem> category, you can repeat a search you started with the
<emph>Search and Replace</emph> dialog or the <emph>Find</emph> toolbar. If you
now click one of the arrows, the search will be resumed for the term last
searched.</paragraph>
+
+ <h2 id="hd_id761713525529070">Selection</h2>
+ <paragraph role="paragraph" id="par_id961713525563573">If a multiple
selection is active (for example when using <keycode>Ctrl + click and
drag</keycode> or the Adding <link href="text/shared/02/20050000.xhp">selection
mode</link>, or after a Find All search), <emph>Selection</emph> allows jumping
from one to the other.</paragraph>
+
+ <h2 id="hd_id731713403460395">Table Formulas</h2>
+ <paragraph role="paragraph" id="par_id3148783">For table formulas, you can
either jump to all table formulas located within your document with <emph>Table
formula</emph> or only to the incorrect ones with <emph>Wrong table
formula</emph>. For incorrect formulas, you jump only to formulas that have
resulted in errors. The program skips over formulas with resulting errors
(those that reference incorrect formulas).</paragraph>
+
</body>
</helpdocument>
