<?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>


<h1 id="hd_id3145087"><variable id="references"><link href="text/swriter/guide/references.xhp">Inserting Cross-References</link></variable></h1>
<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>

<section id="relatedtopics">
<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"/>
</section>
</body>

</helpdocument>
