merge the formfield patch from ooo-build
[ooovba.git] / helpcontent2 / source / text / swriter / guide / references.xhp
blob75ffbd20e56203548804b622a62c57d572341cfa
1 <?xml version="1.0" encoding="UTF-8"?>
2 <helpdocument version="1.0">
4 <!--
5 ***********************************************************************
7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 *
9 * Copyright 2008 by Sun Microsystems, Inc.
11 * OpenOffice.org - a multi-platform office productivity suite
13 * $RCSfile: soffice2xmlhelp.xsl,v $
14 * $Revision: 1.10 $
16 * This file is part of OpenOffice.org.
18 * OpenOffice.org is free software: you can redistribute it and/or modify
19 * it under the terms of the GNU Lesser General Public License version 3
20 * only, as published by the Free Software Foundation.
22 * OpenOffice.org is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU Lesser General Public License version 3 for more details
26 * (a copy is included in the LICENSE file that accompanied this code).
28 * You should have received a copy of the GNU Lesser General Public License
29 * version 3 along with OpenOffice.org. If not, see
30 * <http://www.openoffice.org/license.html>
31 * for a copy of the LGPLv3 License.
33 ************************************************************************
34 -->
37 <meta>
38 <topic id="textswriterguidereferencesxml" indexer="include">
39 <title xml-lang="en-US" id="tit">Inserting Cross-References</title>
40 <filename>/text/swriter/guide/references.xhp</filename>
41 </topic>
42 </meta>
43 <body>
44 <bookmark xml-lang="en-US" branch="index" id="bm_id3145087"><bookmark_value>references; inserting cross-references</bookmark_value>
45 <bookmark_value>cross-references; inserting and updating</bookmark_value>
46 <bookmark_value>tables; cross-referencing</bookmark_value>
47 <bookmark_value>pictures; cross-referencing</bookmark_value>
48 <bookmark_value>objects; cross-referencing</bookmark_value>
49 <bookmark_value>OLE objects;cross-referencing</bookmark_value>
50 <bookmark_value>draw objects;cross-referencing</bookmark_value>
51 <bookmark_value>updating;cross-references</bookmark_value>
52 <bookmark_value>inserting;cross-references</bookmark_value>
53 </bookmark>
54 <paragraph xml-lang="en-US" id="hd_id3145087" role="heading" level="1" l10n="U"
55 oldref="28"><variable id="references"><link href="text/swriter/guide/references.xhp" name="Inserting Cross-References">Inserting Cross-References</link>
56 </variable></paragraph>
57 <paragraph xml-lang="en-US" id="par_id3159263" role="paragraph" l10n="CHG" oldref="8">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" name="fields">fields</link> in the document.</paragraph>
58 <paragraph xml-lang="en-US" id="par_id3155860" role="paragraph" l10n="U" oldref="21">Objects with captions and bookmarks can be used as targets.</paragraph>
59 <paragraph xml-lang="en-US" id="hd_id3149833" role="heading" level="2" l10n="U"
60 oldref="38">Cross-Referencing Text</paragraph>
61 <paragraph xml-lang="en-US" id="par_id3149846" role="paragraph" l10n="U" oldref="39">Before you can insert a cross-reference, you must first specify the targets in your text.</paragraph>
62 <paragraph xml-lang="en-US" id="hd_id3156105" role="heading" level="3" l10n="U"
63 oldref="52">To Insert a Target</paragraph>
64 <list type="ordered">
65 <listitem>
66 <paragraph xml-lang="en-US" id="par_id3153408" role="listitem" l10n="U" oldref="40">Select the text that you want to use as a target for the cross-reference.</paragraph>
67 </listitem>
68 <listitem>
69 <paragraph xml-lang="en-US" id="par_id3153125" role="listitem" l10n="U" oldref="41">Choose <emph>Insert - Cross-reference</emph>.</paragraph>
70 </listitem>
71 <listitem>
72 <paragraph xml-lang="en-US" id="par_id3149634" role="listitem" l10n="U" oldref="42">In the <item type="menuitem">Type</item> list, select “Set Reference”.</paragraph>
73 </listitem>
74 <listitem>
75 <paragraph xml-lang="en-US" id="par_id3149614" role="listitem" l10n="U" oldref="43">Type a name for the target in the <emph>Name</emph> box. The selected text is displayed in the <emph>Value</emph> box.</paragraph>
76 </listitem>
77 <listitem>
78 <paragraph xml-lang="en-US" id="par_id3145110" role="listitem" l10n="U" oldref="44">Click <item type="menuitem">Insert</item>. The name of the target is added to the <item type="menuitem">Selection</item>
79 <emph/>list.</paragraph>
80 </listitem>
81 </list>
82 <paragraph xml-lang="en-US" id="par_id3156257" role="paragraph" l10n="U" oldref="45">Leave the dialog open and proceed to the next section.</paragraph>
83 <paragraph xml-lang="en-US" id="hd_id3153370" role="heading" level="3" l10n="U"
84 oldref="53">To Create a Cross-Reference to a Target</paragraph>
85 <list type="ordered">
86 <listitem>
87 <paragraph xml-lang="en-US" id="par_id7032074" role="listitem" l10n="NEW">Position the cursor in the text where you want to insert a cross-reference.</paragraph>
88 </listitem>
89 <listitem>
90 <paragraph xml-lang="en-US" id="par_id7796868" role="listitem" l10n="NEW">Choose <emph>Insert - Cross-reference</emph> to open the dialog, if it is not open already.</paragraph>
91 </listitem>
92 <listitem>
93 <paragraph xml-lang="en-US" id="par_id3153392" role="listitem" l10n="U" oldref="46">In the <emph>Type</emph> list, select "Insert Reference".</paragraph>
94 </listitem>
95 <listitem>
96 <paragraph xml-lang="en-US" id="par_id3154256" role="listitem" l10n="U" oldref="47">In the <emph>Selection</emph> list, select the target that you want to cross-reference.</paragraph>
97 </listitem>
98 <listitem>
99 <paragraph xml-lang="en-US" id="par_id3154856" role="listitem" l10n="CHG" oldref="48">In the <emph>Insert reference to</emph> list, select the format for the cross-reference. The <link href="text/swriter/01/04090002.xhp" name="format">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>
100 </listitem>
101 <listitem>
102 <paragraph xml-lang="en-US" id="par_id3155895" role="listitem" l10n="U" oldref="49">Click <emph>Insert</emph>.</paragraph>
103 </listitem>
104 <listitem>
105 <paragraph xml-lang="en-US" id="par_id3148685" role="listitem" l10n="U" oldref="54">Click <emph>Close</emph> when finished.</paragraph>
106 </listitem>
107 </list>
108 <paragraph xml-lang="en-US" id="hd_id3149980" role="heading" level="2" l10n="U"
109 oldref="29">Cross-Referencing an Object</paragraph>
110 <paragraph xml-lang="en-US" id="par_id3149992" role="paragraph" l10n="U" oldref="30">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" name="Insert - Caption"><emph>Insert - Caption</emph></link>.</paragraph>
111 <list type="ordered">
112 <listitem>
113 <paragraph xml-lang="en-US" id="par_id3147123" role="listitem" l10n="U" oldref="14">Click in the document where you want to insert the cross-reference.</paragraph>
114 </listitem>
115 <listitem>
116 <paragraph xml-lang="en-US" id="par_id3150212" role="listitem" l10n="U" oldref="11">Choose <emph>Insert - Cross-reference</emph>.</paragraph>
117 </listitem>
118 <listitem>
119 <paragraph xml-lang="en-US" id="par_id3150236" role="listitem" l10n="U" oldref="32">In the <emph>Type</emph> list, select the caption category of the object.</paragraph>
120 </listitem>
121 <listitem>
122 <paragraph xml-lang="en-US" id="par_id3150942" role="listitem" l10n="U" oldref="33">In the <emph>Selection</emph> list, select the caption number of the object that you want to cross-reference.</paragraph>
123 </listitem>
124 <listitem>
125 <paragraph xml-lang="en-US" id="par_id3150968" role="listitem" l10n="CHG" oldref="34">In the <emph>Insert reference to</emph> list, select the format of the cross-reference. The <link href="text/swriter/01/04090002.xhp" name="format">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>
126 </listitem>
127 <listitem>
128 <paragraph xml-lang="en-US" id="par_id3150535" role="listitem" l10n="U" oldref="35">Click <emph>Insert</emph>.</paragraph>
129 </listitem>
130 <listitem>
131 <paragraph xml-lang="en-US" id="par_id3151092" role="listitem" l10n="U" oldref="55">Click <emph>Close</emph> when finished.</paragraph>
132 </listitem>
133 </list>
134 <paragraph xml-lang="en-US" id="hd_id3151115" role="heading" level="2" l10n="U"
135 oldref="56">Updating Cross-References</paragraph>
136 <paragraph xml-lang="en-US" id="par_id3153594" role="paragraph" l10n="U" oldref="51">To manually update the cross-references in a document, press F9.</paragraph>
137 <paragraph xml-lang="en-US" id="par_id7321390" role="tip" l10n="NEW">Choose <emph>View - Fields</emph> to switch between viewing the reference names and the reference contents.</paragraph>
138 <embed href="text/shared/00/00000004.xhp#related"/>
139 <embed href="text/swriter/guide/references_modify.xhp#references_modify"/>
140 <embed href="text/swriter/guide/hyperlinks.xhp#hyperlinks"/>
141 <embed href="text/shared/guide/hyperlink_insert.xhp#hyperlink_insert"/>
142 </body>
143 </helpdocument>