merge the formfield patch from ooo-build
[ooovba.git] / helpcontent2 / source / text / swriter / 01 / 04090001.xhp
blobad9450867430a374bd33f4f281ba5223b67efb24
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.8 $
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="textswriter0104090001xml" indexer="include">
39 <title xml-lang="en-US" id="tit">Document</title>
40 <filename>/text/swriter/01/04090001.xhp</filename>
41 </topic>
42 </meta>
43 <body>
44 <section id="dokument">
45 <bookmark xml-lang="en-US" branch="hid/HID_FLD_DOK" id="bm_id3145246" localize="false"/>
46 <paragraph xml-lang="en-US" id="hd_id3150017" role="heading" level="1" l10n="U" oldref="1"><link href="text/swriter/01/04090001.xhp" name="Document">Document</link></paragraph>
47 <paragraph xml-lang="en-US" id="par_id3147167" role="paragraph" l10n="U" oldref="2">Fields are used to insert information about the current document, for example, file name, template, statistics, user data, date, and time.</paragraph>
48 </section>
49 <section id="howtoget">
50 <embed href="text/swriter/00/00000404.xhp#felddokument"/>
51 </section>
52 <paragraph xml-lang="en-US" id="par_id3154470" role="note" l10n="U" oldref="3">For the HTML export and import of date and time fields, <link href="text/swriter/01/04090007.xhp#datumuhrzeit" name="special $[officename] formats">special $[officename] formats</link> are used.</paragraph>
53 <section id="feldtyp">
54 <bookmark xml-lang="en-US" branch="hid/SW:LISTBOX:TP_FLD_DOK:LB_DOKTYPE" id="bm_id3153666" localize="false"/>
55 <paragraph xml-lang="en-US" id="hd_id3151312" role="heading" level="2" l10n="U" oldref="4">Type</paragraph>
56 <paragraph xml-lang="en-US" id="par_id3153672" role="paragraph" l10n="U" oldref="5"><ahelp hid="SW:LISTBOX:TP_FLD_DOK:LB_DOKTYPE">Lists the available field types. To add a field to your document, click a field type, click a field in the <emph>Select </emph>list, and then click <emph>Insert</emph>.</ahelp> The following fields are available:</paragraph>
57 </section>
58 <table id="tbl_id3149686">
59 <tablerow>
60 <tablecell>
61 <paragraph xml-lang="en-US" id="par_id3155182" role="tablehead" l10n="U" oldref="6">Type</paragraph>
62 </tablecell>
63 <tablecell>
64 <paragraph xml-lang="en-US" id="par_id3143272" role="tablehead" l10n="U" oldref="7">Meaning</paragraph>
65 </tablecell>
66 </tablerow>
67 <tablerow>
68 <tablecell>
69 <paragraph xml-lang="en-US" id="par_id3151248" role="tablecontent" l10n="U" oldref="10">Author</paragraph>
70 </tablecell>
71 <tablecell>
72 <paragraph xml-lang="en-US" id="par_id3148975" role="tablecontent" l10n="CHG" oldref="11">Inserts the name of the current user. </paragraph>
73 </tablecell>
74 </tablerow>
75 <tablerow>
76 <tablecell>
77 <paragraph xml-lang="en-US" id="par_id3145759" role="tablecontent" l10n="U" oldref="18">Chapter</paragraph>
78 </tablecell>
79 <tablecell>
80 <paragraph xml-lang="en-US" id="par_id3149172" role="tablecontent" l10n="U" oldref="19">Inserts the chapter number and/or the chapter name.</paragraph>
81 </tablecell>
82 </tablerow>
83 <tablerow>
84 <tablecell>
85 <paragraph xml-lang="en-US" id="par_id3145771" role="tablecontent" l10n="U" oldref="14">Date</paragraph>
86 </tablecell>
87 <tablecell>
88 <paragraph xml-lang="en-US" id="par_id3151370" role="tablecontent" l10n="CHG" oldref="15">Inserts the current date. You can insert the date as a fixed field - <item type="literal">Date (fixed)</item> - that does not change, or as a dynamic field - <item type="literal">Date</item> - that it is updated automatically. To manually update the <item type="literal">Date</item> field, press F9.</paragraph>
89 </tablecell>
90 </tablerow>
91 <tablerow>
92 <tablecell>
93 <paragraph xml-lang="en-US" id="par_id3150699" role="tablecontent" l10n="U" oldref="12">File name</paragraph>
94 </tablecell>
95 <tablecell>
96 <paragraph xml-lang="en-US" id="par_id3150122" role="tablecontent" l10n="U" oldref="13">Inserts the filename and/or the directory path of the current document, as well as the filename without extension.</paragraph>
97 </tablecell>
98 </tablerow>
99 <tablerow>
100 <tablecell>
101 <paragraph xml-lang="en-US" id="par_id3147495" role="tablecontent" l10n="U" oldref="20">Page</paragraph>
102 </tablecell>
103 <tablecell>
104 <paragraph xml-lang="en-US" id="par_id3145264" role="tablecontent" l10n="U" oldref="21">Inserts the page number of the current, previous, or next page.</paragraph>
105 </tablecell>
106 </tablerow>
107 <tablerow>
108 <tablecell>
109 <paragraph xml-lang="en-US" id="par_id3150561" role="tablecontent" l10n="U" oldref="8">Sender</paragraph>
110 </tablecell>
111 <tablecell>
112 <paragraph xml-lang="en-US" id="par_id3146341" role="tablecontent" l10n="U" oldref="9">Inserts fields containing user data. You can change the user-data that is displayed by choosing<link href="text/shared/optionen/01010100.xhp" name="Tools - Options - $[officename] - User Data"><emph>Tools - Options - $[officename] - User Data</emph></link>.</paragraph>
113 </tablecell>
114 </tablerow>
115 <tablerow>
116 <tablecell>
117 <paragraph xml-lang="en-US" id="par_id3148863" role="tablecontent" l10n="U" oldref="22">Statistics</paragraph>
118 </tablecell>
119 <tablecell>
120 <paragraph xml-lang="en-US" id="par_id3151091" role="tablecontent" l10n="U" oldref="23">Inserts document statistics, such as page and word counts, as a field. To view the statistics of a document, choose <emph>File - Properties</emph>, and then click the<emph> Statistics tab. </emph>
121 </paragraph>
122 </tablecell>
123 </tablerow>
124 <tablerow>
125 <tablecell>
126 <paragraph xml-lang="en-US" id="par_id3153302" role="tablecontent" l10n="U" oldref="16">Templates</paragraph>
127 </tablecell>
128 <tablecell>
129 <paragraph xml-lang="en-US" id="par_id3156123" role="tablecontent" l10n="U" oldref="17">Inserts the filename, the path, or the filename without the file extension of the current template. You can also insert the names of the "Category" and the "Style" formats used in the current template. To view the names of the template categories and the styles used in the templates, choose <emph>File - Templates -</emph><link href="text/shared/01/01110100.xhp" name="Organize"><emph>Organize</emph></link>.</paragraph>
130 </tablecell>
131 </tablerow>
132 <tablerow>
133 <tablecell>
134 <paragraph xml-lang="en-US" id="par_id3146939" role="tablecontent" l10n="U" oldref="24">Time</paragraph>
135 </tablecell>
136 <tablecell>
137 <paragraph xml-lang="en-US" id="par_id3154340" role="tablecontent" l10n="CHG" oldref="25">Inserts the current time. You can insert the time as a fixed field - <item type="literal">Time (fixed)</item> - that does not change, or as a dynamic field - <item type="literal">Time</item> - that it is updated automatically. To manually update the <item type="literal">Time</item> field, press F9.</paragraph>
138 </tablecell>
139 </tablerow>
140 </table>
142 <section id="hinweis">
143 <paragraph xml-lang="en-US" id="par_id3154631" role="note" l10n="U" oldref="26">The following fields can only be inserted if the corresponding field type is selected in the <emph>Type </emph>list.</paragraph>
144 </section>
145 <section id="auswahl">
146 <bookmark xml-lang="en-US" branch="hid/SW:LISTBOX:TP_FLD_DOK:LB_DOKSELECTION" id="bm_id3150671" localize="false"/>
147 <paragraph xml-lang="en-US" id="hd_id3150660" role="heading" level="2" l10n="CHG"
148 oldref="27">Select<comment>on "Document" and "DocInformation" tab page this is called "Select", on the other tab pages "Selection"</comment></paragraph>
149 <paragraph xml-lang="en-US" id="par_id3150678" role="paragraph" l10n="U" oldref="28"><ahelp hid="SW:LISTBOX:TP_FLD_DOK:LB_DOKSELECTION">Lists the available fields for the field type selected in the <emph>Type </emph>list. To insert a field, click the field, and then click <emph>Insert</emph>.</ahelp></paragraph>
150 <paragraph xml-lang="en-US" id="par_id3155537" role="tip" l10n="U" oldref="53">To quickly insert a field from the list, hold down <switchinline select="sys"><caseinline select="MAC">Command
151 </caseinline><defaultinline>Ctrl</defaultinline></switchinline> and double-click the field.</paragraph>
152 <table id="tbl_id3148722">
153 <tablerow>
154 <tablecell>
155 <paragraph xml-lang="en-US" id="par_id3155359" role="tablehead" l10n="U" oldref="30">Fields</paragraph>
156 </tablecell>
157 <tablecell>
158 <paragraph xml-lang="en-US" id="par_id3154220" role="tablehead" l10n="U" oldref="31">Function</paragraph>
159 </tablecell>
160 </tablerow>
161 <tablerow>
162 <tablecell>
163 <paragraph xml-lang="en-US" id="par_id3145107" role="tablecontent" l10n="U" oldref="32">Previous page</paragraph>
164 </tablecell>
165 <tablecell>
166 <paragraph xml-lang="en-US" id="par_id3149595" role="tablecontent" l10n="U" oldref="33">Inserts the page number of the previous page in the document.</paragraph>
167 </tablecell>
168 </tablerow>
169 <tablerow>
170 <tablecell>
171 <paragraph xml-lang="en-US" id="par_id3146896" role="tablecontent" l10n="U" oldref="34">Next page </paragraph>
172 </tablecell>
173 <tablecell>
174 <paragraph xml-lang="en-US" id="par_id3148923" role="tablecontent" l10n="U" oldref="35">Inserts the page number of the next page in the document.</paragraph>
175 </tablecell>
176 </tablerow>
177 <tablerow>
178 <tablecell>
179 <paragraph xml-lang="en-US" id="par_id3156032" role="tablecontent" l10n="U" oldref="36">Page Number </paragraph>
180 </tablecell>
181 <tablecell>
182 <paragraph xml-lang="en-US" id="par_id3159212" role="tablecontent" l10n="U" oldref="37">Inserts the current page number.</paragraph>
183 </tablecell>
184 </tablerow>
185 </table>
187 <paragraph xml-lang="en-US" id="par_id3159229" role="paragraph" l10n="U" oldref="38">In the <emph>Format</emph>, click the numbering format that you want to use.</paragraph>
188 <paragraph xml-lang="en-US" id="par_id3145188" role="paragraph" l10n="U" oldref="39">If you want, you can enter an <emph>Offset </emph>for the displayed page number. With an <emph>Offset</emph> value of 1, the field will display a number that is 1 more than the current page number, but only if a page with that number exists. On the last page of the document, this same field will be empty.</paragraph>
189 </section>
190 <section id="korrektur">
191 <bookmark xml-lang="en-US" branch="hid/SW:EDIT:TP_FLD_DOK:ED_DOKVALUE" id="bm_id3150903" localize="false"/>
192 <paragraph xml-lang="en-US" id="hd_id3150891" role="heading" level="2" l10n="U"
193 oldref="45">Offset</paragraph>
194 <paragraph xml-lang="en-US" id="par_id3155312" role="paragraph" l10n="U" oldref="46"><ahelp hid="SW:EDIT:TP_FLD_DOK:ED_DOKVALUE">Enter the offset value that you want to apply to a page number field, for example "+1".</ahelp></paragraph>
195 </section>
196 <paragraph xml-lang="en-US" id="par_id3154948" role="tip" l10n="U" oldref="54">If you want to change the actual page number and not the displayed number, do not use the <emph>Offset</emph> value. To change page numbers, read the <link href="text/swriter/guide/pagenumbers.xhp" name="Page Numbers"><emph>Page Numbers</emph></link> guide.</paragraph>
197 <section id="format">
198 <bookmark xml-lang="en-US" branch="hid/SW:LISTBOX:TP_FLD_DOK:LB_DOKFORMAT" id="bm_id3145607" localize="false"/>
199 <paragraph xml-lang="en-US" id="hd_id3145595" role="heading" level="2" l10n="U"
200 oldref="41">Format</paragraph>
201 <paragraph xml-lang="en-US" id="par_id3145613" role="paragraph" l10n="U" oldref="42"><ahelp hid="SW:LISTBOX:TP_FLD_DOK:LB_DOKFORMAT">Click the format that you want to apply to the selected field, or click "Additional formats" to define a custom format.</ahelp></paragraph>
202 </section>
203 <paragraph xml-lang="en-US" id="par_id3150138" role="paragraph" l10n="U" oldref="49"><variable id="datumuhrzeitformat">When you click "Additional formats", the <link href="text/shared/01/05020300.xhp" name="Number Format"><emph>Number Format</emph></link> dialog opens, where you can define a custom format.
204 </variable></paragraph>
205 <paragraph xml-lang="en-US" id="par_id3154867" role="paragraph" l10n="U" oldref="50">If you choose "Chapter number without separator" for a chapter field, the separators that are specified for chapter number in <link href="text/swriter/01/06060000.xhp" name="Tools - Outline numbering"><emph>Tools - Outline numbering</emph></link> are not displayed.</paragraph>
206 <paragraph xml-lang="en-US" id="par_id3156079" role="paragraph" l10n="U" oldref="63">If you choose "chapter number" as the <emph>format</emph> for reference fields, only the number of the chapter heading containing the referenced object is displayed in the field. If the paragraph style for the chapter heading is not numbered, the field is left blank.</paragraph>
207 <paragraph xml-lang="en-US" id="par_id3148682" role="paragraph" l10n="U" oldref="56">The following number range formats are for paragraphs formatted with numbered or bulleted lists:</paragraph>
208 <table id="tbl_id3149976">
209 <tablerow>
210 <tablecell>
211 <paragraph xml-lang="en-US" id="par_id3150006" role="tablecontent" l10n="U" oldref="57">Category and number</paragraph>
212 </tablecell>
213 <tablecell>
214 <paragraph xml-lang="en-US" id="par_id3155386" role="tablecontent" l10n="U" oldref="58">The format contains everything between the beginning of the paragraph and directly after the number-range field</paragraph>
215 </tablecell>
216 </tablerow>
217 <tablerow>
218 <tablecell>
219 <paragraph xml-lang="en-US" id="par_id3146919" role="tablecontent" l10n="U" oldref="59">Caption text</paragraph>
220 </tablecell>
221 <tablecell>
222 <paragraph xml-lang="en-US" id="par_id3155929" role="tablecontent" l10n="U" oldref="60">The format contains the text following the number-range field up to the end of the paragraph</paragraph>
223 </tablecell>
224 </tablerow>
225 <tablerow>
226 <tablecell>
227 <paragraph xml-lang="en-US" id="par_id3148733" role="tablecontent" l10n="U" oldref="61">Number</paragraph>
228 </tablecell>
229 <tablecell>
230 <paragraph xml-lang="en-US" id="par_id3148755" role="tablecontent" l10n="U" oldref="62">The format only contains the reference number</paragraph>
231 </tablecell>
232 </tablerow>
233 </table>
235 <bookmark xml-lang="en-US" branch="hid/SW:CHECKBOX:TP_FLD_DOK:CB_DOKFIXEDCONTENT" id="bm_id3153014" localize="false"/>
236 <paragraph xml-lang="en-US" id="par_id0902200804313432" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Inserts the field as static content, that is, the field cannot be updated.</ahelp></paragraph>
237 <embed href="text/swriter/01/04090004.xhp#inhaltfix"/>
238 <bookmark xml-lang="en-US" branch="hid/SW:NUMERICFIELD:TP_FLD_DOK:ED_DOKLEVEL" id="bm_id3153038" localize="false"/>
239 <paragraph xml-lang="en-US" id="hd_id3153026" role="heading" level="2" l10n="U"
240 oldref="43">Layer</paragraph>
241 <paragraph xml-lang="en-US" id="par_id3154580" role="paragraph" l10n="U" oldref="44"><ahelp hid="SW:NUMERICFIELD:TP_FLD_DOK:ED_DOKLEVEL">Select the chapter heading level that you want to include in the selected field.</ahelp></paragraph>
242 <bookmark xml-lang="en-US" branch="hid/SW:NUMERICFIELD:TP_FLD_DOK:ED_DOKDATEOFF" id="bm_id3154610" localize="false"/>
243 <paragraph xml-lang="en-US" id="hd_id3154598" role="heading" level="2" l10n="U"
244 oldref="51">Offset in days/minutes</paragraph>
245 <paragraph xml-lang="en-US" id="par_id3154899" role="paragraph" l10n="U" oldref="52"><ahelp hid="SW:NUMERICFIELD:TP_FLD_DOK:ED_DOKDATEOFF">Enter the offset that you want to apply to a date or time field.</ahelp></paragraph>
246 <section id="wert">
247 <paragraph xml-lang="en-US" id="hd_id3154922" role="heading" level="2" l10n="U"
248 oldref="47">Value</paragraph>
249 <paragraph xml-lang="en-US" id="par_id3153049" role="paragraph" l10n="U" oldref="48"><ahelp hid="SW:NUMERICFIELD:TP_FLD_DOK:ED_DOKDATEOFF">Enter the contents that you want to add to a user-defined field.</ahelp></paragraph>
250 </section>
251 </body>
252 </helpdocument>