summaryrefslogtreecommitdiff
path: root/source/text/swriter/guide/references.xhp
blob: 3ff17ac8a0640d1fd6f8bdaa7ba3ff47cae75b89 (plain)
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
<?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="textswriterguidereferencesxml" indexer="include">
    <title id="tit" xml-lang="en-US">Inserting Cross-References</title>
    <filename>/text/swriter/guide/references.xhp</filename>
  </topic>
</meta>

<body>

<bookmark xml-lang="en-US" branch="index" id="bm_id3145087">
  <bookmark_value>references; inserting cross-references</bookmark_value>
  <bookmark_value>cross-references; inserting and updating</bookmark_value>
  <bookmark_value>tables; cross-referencing</bookmark_value>
  <bookmark_value>pictures; cross-referencing</bookmark_value>
  <bookmark_value>objects; cross-referencing</bookmark_value>
  <bookmark_value>OLE objects;cross-referencing</bookmark_value>
  <bookmark_value>draw objects;cross-referencing</bookmark_value>
  <bookmark_value>updating;cross-references</bookmark_value>
  <bookmark_value>inserting;cross-references</bookmark_value>
</bookmark>


<paragraph id="hd_id3145087" role="heading" level="1" xml-lang="en-US"><variable id="references"><link href="text/swriter/guide/references.xhp">Inserting Cross-References</link></variable></paragraph>
<paragraph id="par_id3159263" role="paragraph" xml-lang="en-US">Cross-references allow you to jump to specific text passages and objects in a single document. A cross-reference consists of a target and a reference that are inserted as <link href="text/swriter/guide/fields.xhp">fields</link> in the document.</paragraph>
<paragraph id="par_id3155860" role="paragraph" xml-lang="en-US">Objects with captions and bookmarks can be used as targets.</paragraph>

<h2 id="hd_id3149833">Cross-Referencing Text</h2>
<paragraph id="par_id3149846" role="paragraph" xml-lang="en-US">Before you can insert a cross-reference, you must first specify the targets in your text.</paragraph>

<h3 id="hd_id3156105">To Insert a Target</h3>

<list type="ordered">
  <listitem>
    <paragraph id="par_id3153408" role="listitem" xml-lang="en-US">Select the text that you want to use as a target for the cross-reference.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3153125" role="listitem" xml-lang="en-US">Choose <emph>Insert - Cross-reference</emph>.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3149634" role="listitem" xml-lang="en-US">In the <item type="menuitem">Type</item> list, select “Set Reference”.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3149614" role="listitem" xml-lang="en-US">Type a name for the target in the <emph>Name</emph> box. The selected text is displayed in the <emph>Value</emph> box.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3145110" role="listitem" xml-lang="en-US">Click <item type="menuitem">Insert</item>. The name of the target is added to the <item type="menuitem">Selection</item> list.</paragraph>
  </listitem>
</list>
<paragraph id="par_id3156257" role="paragraph" xml-lang="en-US">Leave the dialog open and proceed to the next section.</paragraph>

<h3 id="hd_id3153370">To Create a Cross-Reference to a Target</h3>

<list type="ordered">
  <listitem>
    <paragraph id="par_id7032074" role="listitem" xml-lang="en-US">Position the cursor in the text where you want to insert a cross-reference.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id7796868" role="listitem" xml-lang="en-US">Choose <emph>Insert - Cross-reference</emph> to open the dialog, if it is not open already.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3153392" role="listitem" xml-lang="en-US">In the <emph>Type</emph> list, select "Insert Reference".</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3154256" role="listitem" xml-lang="en-US">In the <emph>Selection</emph> list, select the target that you want to cross-reference.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3154856" role="listitem" xml-lang="en-US">In the <emph>Refer using</emph> list, select the format for the cross-reference. The <link href="text/swriter/01/04090002.xhp">format</link> specifies the type of information that is displayed as the cross-reference. For example, "Reference" inserts the target text, and "Page" inserts the page number where the target is located. For footnotes the footnote number is inserted.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3155895" role="listitem" xml-lang="en-US">Click <emph>Insert</emph>.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3148685" role="listitem" xml-lang="en-US">Click <emph>Close</emph> when finished.</paragraph>
  </listitem>
</list>

<h2 id="hd_id3149980">Cross-Referencing an Object</h2>
<paragraph id="par_id3149992" role="paragraph" xml-lang="en-US">You can cross-reference most objects in your document, such as graphics, drawing objects, OLE objects, and tables, so long as they have a caption. To add a caption to an object, select the object, and then choose <link href="text/swriter/guide/captions.xhp"><emph>Insert - Caption</emph></link>.</paragraph>

<list type="ordered">
  <listitem>
    <paragraph id="par_id3147123" role="listitem" xml-lang="en-US">Click in the document where you want to insert the cross-reference.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3150212" role="listitem" xml-lang="en-US">Choose <emph>Insert - Cross-reference</emph>.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3150236" role="listitem" xml-lang="en-US">In the <emph>Type</emph> list, select the caption category of the object.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3150942" role="listitem" xml-lang="en-US">In the <emph>Selection</emph> list, select the caption number of the object that you want to cross-reference.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3150968" role="listitem" xml-lang="en-US">In the <emph>Refer using</emph> list, select the format of the cross-reference. The <link href="text/swriter/01/04090002.xhp">format</link> specifies the type of information that is displayed as the cross-reference. For example, "Reference" inserts the caption category and caption text of the object.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3150535" role="listitem" xml-lang="en-US">Click <emph>Insert</emph>.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id3151092" role="listitem" xml-lang="en-US">Click <emph>Close</emph> when finished.</paragraph>
  </listitem>
</list>

<h2 id="hd_id3151115">Updating Cross-References</h2>
<paragraph id="par_id3153594" role="paragraph" xml-lang="en-US">To manually update the cross-references in a document, choose <emph>Tools - Update - Fields</emph> from the menu or press F9.</paragraph>
<paragraph id="par_id7321390" role="tip" xml-lang="en-US">Choose <emph>View - Field Names</emph> to switch between viewing the reference names and the reference contents.</paragraph>
<embed href="text/shared/00/00000004.xhp#related"/>
<embed href="text/swriter/guide/references_modify.xhp#references_modify"/>
<embed href="text/swriter/guide/hyperlinks.xhp#hyperlinks"/>
<embed href="text/shared/guide/hyperlink_insert.xhp#hyperlink_insert"/>
</body>

</helpdocument>