1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
<?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 http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
-->
<meta>
<topic id="textswriter0104090002xml" indexer="include">
<title id="tit" xml-lang="en-US">Cross-references</title>
<filename>/text/swriter/01/04090002.xhp</filename>
</topic>
</meta>
<body>
<section id="cross_references2">
<section id="cross_references">
<bookmark xml-lang="en-US" branch="hid/.uno:InsertReferenceField" id="bm_id8981346" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/fldrefpage/@@nowidget@@" id="bm_@@nowidget@@" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/fldrefpage/FieldRefPage" id="bm_id3149042" localize="false"/>
<h1 id="hd_id3153641" xml-lang="en-US"><link href="text/swriter/01/04090002.xhp" name="Cross-references">Cross-reference</link></h1>
<paragraph role="paragraph" id="par_id3155142" xml-lang="en-US"><variable id="reftext"><ahelp hid=".">This is where you insert the references or referenced fields into the current document. References are referenced fields within the same document or within sub-documents of a master document.</ahelp>
</variable></paragraph>
</section>
<paragraph role="paragraph" id="par_id3159197" xml-lang="en-US">The advantage of entering a cross-reference as a field is that you do not have to adjust the references manually every time you change the document. Just update the fields with F9 and the references in the document are updated too.</paragraph>
</section>
<section id="howtoget">
<embed href="text/swriter/00/00000404.xhp#insert_cross_references"/>
</section>
<embed href="text/swriter/guide/references.xhp#references"/>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/fldrefpage/type" id="bm_id3145772" localize="false"/>
<h2 id="hd_id4333628" xml-lang="en-US">Type</h2>
<paragraph role="paragraph" id="par_id4516129" xml-lang="en-US"><ahelp hid=".">Lists the available field types. To add a field to your document, click a field type, click a field in the Selection list, and then click Insert.</ahelp> The following fields are available:</paragraph>
<table id="tbl_id3145784">
<tablerow>
<tablecell>
<paragraph role="tablehead" id="par_id3151380" xml-lang="en-US">Type</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablehead" id="par_id3150700" xml-lang="en-US">Meaning</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3155862" xml-lang="en-US">Set Reference</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3147422" xml-lang="en-US">Set target for a referenced field. Under <emph>Name</emph>, enter a name for the reference. When inserting the reference, the name will then appear as an identification in the list box <emph>Selection</emph>.</paragraph>
<paragraph role="tablecontent" id="par_id3149556" xml-lang="en-US">In an HTML document, reference fields entered this way will be ignored. For the target in HTML documents, you have to <link href="text/swriter/01/04040000.xhp" name="insert a bookmark">insert a bookmark</link>.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3150548" xml-lang="en-US">Insert Reference</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3147746" xml-lang="en-US">Inserting a reference to another position in the document. The corresponding text position has to be defined with "Set Reference" first. Otherwise, inserting a reference by choosing a field name under <emph>Selection</emph> is not possible.</paragraph>
<paragraph role="tablecontent" id="par_id3146344" xml-lang="en-US">In master documents, you can also reference from one sub-document to another. Note that the reference name will not appear in the selection field and has to be entered "by hand".</paragraph>
<paragraph role="tablecontent" id="par_id3149847" xml-lang="en-US">In an HTML document, reference fields entered this way will be ignored. For referenced fields in HTML documents, you have to <link href="text/shared/01/05020400.xhp" name="insert a hyperlink">insert a hyperlink</link>.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id2408825" xml-lang="en-US">Headings</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id9988402" xml-lang="en-US">The Selection box shows a list of all headings in the order of their appearance in the document.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id6401257" xml-lang="en-US">Numbered Paragraphs</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id5841242" xml-lang="en-US">The Selection box shows a list of all ordered paragraphs in the order of their appearance in the document. The list includes:</paragraph>
<list type="unordered">
<listitem>
<paragraph id="par_id971618826026891" role="listitem">paragraphs with a paragraph style assigned a numbering scheme in the Tools > Chapter Numbering dialog
</paragraph>
</listitem>
<listitem>
<paragraph id="par_id1001618826039875" role="listitem">ordered list paragraphs, formatted with the Formatting toolbar or Bullets and Numbering dialog</paragraph>
</listitem>
<listitem>
<paragraph id="par_id761618826048138" role="listitem">paragraphs formatted with a numbered list style</paragraph>
</listitem>
<listitem>
<paragraph id="par_id941618826055035" role="listitem">paragraphs formatted with a paragraph style with a numbered list style applied in the Outline & List tab.</paragraph>
</listitem>
</list>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id306711" xml-lang="en-US">Bookmarks</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3150907" xml-lang="en-US">After inserting a bookmark in the document with <emph>Insert - Bookmark</emph>, the bookmarks entry on the <emph>References</emph> tab becomes usable. Bookmarks are used to mark certain text passages in a document. In a text document, you can use the bookmarks, for example, to jump from one passage in the document to another.</paragraph>
<paragraph role="tablecontent" id="par_id3155080" xml-lang="en-US">In an HTML document, these bookmarks become anchors <A name>, which determine the target of hyperlinks for example.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id0818200811011072" xml-lang="en-US">Footnotes</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id0818200811011049" xml-lang="en-US">If your documents contains a footnote, you can select the Footnotes entry. A reference to a footnote returns the footnote number.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id6794030" xml-lang="en-US">(Inserted objects with captions)</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id7096774" xml-lang="en-US">You can set references to objects that have captions applied. For example, insert a picture, right-click the picture, choose Caption. Now the object shows up as a numbered "Illustration" in the list.</paragraph>
</tablecell>
</tablerow>
</table>
<tip id="par_id3154772" xml-lang="en-US">References are fields. To remove a reference, delete the field. If you set a longer text as a reference and you do not want to reenter it after deleting the reference, select the text and copy it to the clipboard. You can then reinsert it as "unformatted text" at the same position using the command <emph>Edit - Paste special</emph>. The text remains intact while the reference is deleted.</tip>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/fldrefpage/select" id="bm_id3146957" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/fldrefpage/selecttip" id="bm_id1661427" localize="false"/>
<h2 id="hd_id5824152" xml-lang="en-US">Selection<comment>on "Document" and "DocInformation" tab page this is called "Select", on the other tab pages "Selection"</comment></h2>
<paragraph role="paragraph" id="par_id7374187" xml-lang="en-US"><ahelp hid=".">Lists the available fields for the field type selected in the <emph>Type </emph>list. To insert a field, click the field, select a format in the "Refer using" list, and then click <emph>Insert</emph>.</ahelp></paragraph>
<tip id="par_id7729728" xml-lang="en-US">To quickly insert a field from the list, hold down <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline> and double-click the field.</tip>
<section id="format">
<paragraph role="paragraph" id="par_id2171086" xml-lang="en-US">In the <emph>Refer using</emph> list, click the format that you want to use.</paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/fldrefpage/format" id="bm_id3154344" localize="false"/>
<h2 id="hd_id3154333" xml-lang="en-US">Refer using</h2>
<paragraph role="paragraph" id="par_id3148786" xml-lang="en-US"><ahelp hid="modules/swriter/ui/fldrefpage/format">Select the format that you want to use for the selected reference field.</ahelp> The following formats are available:</paragraph>
<table id="tbl_id3150090">
<tablerow>
<tablecell>
<paragraph role="tablehead" id="par_id7576525" xml-lang="en-US">Format</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablehead" id="par_id641193" xml-lang="en-US">Meaning</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3150039" xml-lang="en-US">Page number (unstyled)</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3153134" xml-lang="en-US">Inserts the number of the page containing the reference target.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3150681" xml-lang="en-US">Referenced text</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3154040" xml-lang="en-US">Inserts the complete reference target text. For footnotes the footnote number is inserted.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3149972" xml-lang="en-US">“Above”/“Below”</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3149619" xml-lang="en-US">Inserts "above" or "below", depending on the location of the reference target relative to the position of the reference field.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3148705" xml-lang="en-US">Page number (styled)</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3148728" xml-lang="en-US">Inserts the number of the page containing the reference target using the format specified in the page style.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id5699942" xml-lang="en-US">Number</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id6420484" xml-lang="en-US">Inserts the number of the heading or numbered paragraph, including superior levels depending on the context. See note below this table for more information.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id6986602" xml-lang="en-US">Number (no context)</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id616779" xml-lang="en-US">Inserts only the number of the heading or numbered paragraph.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id791039" xml-lang="en-US">Number (full context)</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id1953489" xml-lang="en-US">Inserts the number of the heading or numbered paragraph, including all superior levels.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3154635" xml-lang="en-US">Chapter</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3149646" xml-lang="en-US">Inserts the number of the chapter containing the reference target.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3155553" xml-lang="en-US">Category and Number</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3155356" xml-lang="en-US">Inserts the category (caption type) and the number of the reference target. This option is only available when the reference target is an object with a caption.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3154224" xml-lang="en-US">Caption Text</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3145105" xml-lang="en-US">Inserts the caption label of the reference target. This option is only available when the reference target is an object with a caption.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id3149587" xml-lang="en-US">Numbering</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id3146883" xml-lang="en-US">Inserts the caption number of the reference target. This option is only available when the reference target is an object with a caption.</paragraph>
</tablecell>
</tablerow>
</table>
<note id="par_id757469" xml-lang="en-US">The "Number" format inserts the number of the heading or numbered paragraph. The superior levels are included depending on the context, as necessary. </note>
<note id="par_id5189062" xml-lang="en-US">For example, when you are in a chapter 1, subchapter 2, subpart 5, this may be numbered as 1.2.5. When you insert here a reference to text in the previous subpart "1.2.4" and you apply the "Number" format, then the reference will be shown as "4". If in this example the numbering is set to show more sublevels, the same reference will be shown as "2.4" or "1.2.4", depending on the setting. If you use the "Number (full context)" format, you will always see "1.2.4", no matter how the numbered paragraph is formatted.</note>
</section>
<section id="name">
<section id="name2">
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/fldrefpage/name" id="bm_id3156253" localize="false"/>
<h2 id="hd_id3156242" xml-lang="en-US">Name</h2>
</section>
<paragraph role="paragraph" id="par_id3156259" xml-lang="en-US"><variable id="FieldName"><ahelp hid="modules/swriter/ui/fldrefpage/name">Type the name of the user-defined field that you want to create.</ahelp></variable> To set a target, click "Set Reference" in the <emph>Type</emph> list, type a name in this box, and then click <emph>Insert</emph>. To reference the new target, click the target name in the <emph>Selection</emph> list.</paragraph>
</section>
<paragraph role="paragraph" id="par_id3156032" xml-lang="en-US">In a master document, targets that are in different sub-documents are not displayed in the<emph> Selection</emph> list. If you want to insert a reference to the target, you must type the path and the name in the <emph>Name </emph>box.</paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/fldrefpage/value" id="bm_id3159204" localize="false"/>
<paragraph role="paragraph" id="par_id0903200802250745" xml-lang="en-US"><ahelp hid="." visibility="hidden">Enter the contents that you want to add to a user-defined fields.</ahelp></paragraph>
<section id="value">
<h2 id="hd_id3154922" xml-lang="en-US">Value</h2>
<paragraph id="par_id3153049" role="paragraph" xml-lang="en-US"><ahelp hid="modules/swriter/ui/flddocumentpage/offset">Enter the contents that you want to add to a user-defined field.</ahelp></paragraph>
</section>
<paragraph role="paragraph" id="par_id3159216" xml-lang="en-US">If you select text in the document, and then insert a reference, the selected text becomes the contents of the field that you insert.</paragraph><comment>Value box (always disabled)</comment>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/fldrefpage/value" id="bm_id5684377" localize="false"/>
<paragraph role="paragraph" id="par_id6501968" xml-lang="en-US"><ahelp hid="." visibility="hidden">Edit the value.</ahelp></paragraph>
</body>
</helpdocument>
|