summaryrefslogtreecommitdiffstats
path: root/source/text/swriter/01/04090001.xhp
blob: df950f8e009549958c95731396784b2df29df846 (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
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
<?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="textswriter0104090001xml" indexer="include">
    <title id="tit" xml-lang="en-US">Document (Fields)</title>
    <filename>/text/swriter/01/04090001.xhp</filename>
  </topic>
</meta>

<body>

<section id="document">
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/flddocumentpage/@@nowidget@@" id="bm_@@nowidget@@" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/flddocumentpage/FldDocumentPage" id="bm_id3145246" localize="false"/>

<h1 id="hd_id3150017" xml-lang="en-US"><link href="text/swriter/01/04090001.xhp" name="Document">Document</link></h1>
<paragraph id="par_id3147167" role="paragraph" xml-lang="en-US"><ahelp hid=".">Fields are used to insert information about the current document, for example, file name, template, statistics, user data, date, and time.</ahelp></paragraph>
</section>

<section id="howtoget">
<embed href="text/swriter/00/00000404.xhp#felddokument"/>
</section>

<paragraph role="paragraph" id="par_id911603998090123">To insert a field in your document, first select the field <emph>Type</emph>, then click in the <emph>Select</emph> list, to choose which information item should be inserted, then click <emph>Insert</emph>.</paragraph>

<section id="fieldtype">
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/flddocumentpage/type" id="bm_id3153666" localize="false"/>

<h2 id="hd_id3151312" xml-lang="en-US">Type</h2>
<paragraph id="par_id3153672" role="paragraph" xml-lang="en-US"><ahelp hid="modules/swriter/ui/flddocumentpage/type">Lists the available field types. </ahelp></paragraph>
</section>

<section id="select">
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/flddocumentpage/select" id="bm_id3150671" localize="false"/>

<h2 id="hd_id3150660" xml-lang="en-US">Select<comment>on "Document" and "DocInformation" tab page this is called "Select", on the other tab pages "Selection"</comment></h2>
<paragraph id="par_id3150678" role="paragraph" xml-lang="en-US"><ahelp hid="modules/swriter/ui/flddocumentpage/select">Lists what information can be inserted for a selected field type.</ahelp></paragraph>

</section>
<h3 id="par_id71603998444482">Available field Types and Select lists</h3>
<table id="tbl_id3149686">
  <tablerow>
    <tablecell>
      <paragraph id="par_id3155182" role="tablehead" xml-lang="en-US">Type</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3143272" role="tablehead" xml-lang="en-US">Select list</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3151248" role="tablecontent" xml-lang="en-US">Author</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3148975" role="tablecontent" xml-lang="en-US">Name or initials of current user (as entered in <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem>
</caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - </menuitem><link href="text/shared/optionen/01010100.xhp" name="$[officename] - User Data"><menuitem>$[officename] - User Data)</menuitem></link>.</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3145759" role="tablecontent" xml-lang="en-US">Chapter</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3149172" role="tablecontent" xml-lang="en-US">Inserts the chapter number and/or the chapter name.</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3145771" role="tablecontent" xml-lang="en-US">Date</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3151370" role="tablecontent" xml-lang="en-US">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 - <literal>Date</literal> - that it is updated automatically. To manually update the <literal>Date</literal> field, press <keycode>F9</keycode>.</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3150699" role="tablecontent" xml-lang="en-US">File name</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3150122" role="tablecontent" xml-lang="en-US">Inserts the filename and/or the directory path of the current document, as well as the filename without extension.</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3147495" role="tablecontent" xml-lang="en-US">Page</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3145264" role="tablecontent" xml-lang="en-US">Inserts the page number of the current, previous, or next page.</paragraph>
    </tablecell>
  </tablerow>
     <tablerow>
       <tablecell>
           <paragraph id="par_id821601755856152" role="tablecontent">Paragraph Signature</paragraph>
       </tablecell>
       <tablecell>
          <paragraph id="par_id611601755863247" role="tablecontent">Inserts a meta-data field with a digital signature for the paragraph. You must have a digital certificate to sign a paragraph.</paragraph>
       </tablecell>

    </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3150561" role="tablecontent" xml-lang="en-US">Sender</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3146341" role="tablecontent" xml-lang="en-US">Inserts fields containing user data. You can change the user-data that is displayed by choosing <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem>
</caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - </menuitem><link href="text/shared/optionen/01010100.xhp" name="$[officename] - User Data"><menuitem>$[officename] - User Data</menuitem></link>.</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3148863" role="tablecontent" xml-lang="en-US">Statistics</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3151091" role="tablecontent" xml-lang="en-US">Inserts document statistics, such as page and word counts, as a field. To view the statistics of a document, choose <menuitem>File - Properties</menuitem>, and then click the <emph>Statistics</emph> tab. </paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3153302" role="tablecontent" xml-lang="en-US">Templates</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3156123" role="tablecontent" xml-lang="en-US">Inserts the filename, the filename without the file extension, the path, or the path and filename of the current template. You can also insert the <literal>Template name</literal> and <literal>Category</literal> of the current template.</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3146939" role="tablecontent" xml-lang="en-US">Time</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3154340" role="tablecontent" xml-lang="en-US">Inserts the current time. You can insert the time as a fixed field - <literal>Time (fixed)</literal> - that does not change, or as a dynamic field - <literal>Time</literal> - that it is updated automatically. To manually update the <literal>Time</literal> field, press <keycode>F9</keycode>.</paragraph>
    </tablecell>
  </tablerow>
</table>

<tip id="par_id3155537" xml-lang="en-US">To quickly insert a field from the <emph>Select</emph> list, double-click the field.</tip>

<section id="selectnote">
<note id="par_id3154631" xml-lang="en-US">The following fields can only be inserted if the corresponding field type is selected in the <emph>Type </emph>list.</note>
</section>

<section id="format">
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/flddocumentpage/format" id="bm_id3145607" localize="false"/>
<h2 id="hd_id3145595" xml-lang="en-US">Format</h2>
<paragraph id="par_id3145613" role="paragraph" xml-lang="en-US"><ahelp hid="modules/swriter/ui/flddocumentpage/format">If a field is displaying a date, time or number, then <emph>Format</emph> is used to customize the appearance of the date, time, or number. Common formats are shown in the Format window, or click "Additional formats" to define a custom format.</ahelp></paragraph>
</section>
<paragraph id="par_id3150138" role="paragraph" xml-lang="en-US"><variable id="datetimeformat">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. </variable></paragraph>
<paragraph id="par_id3154867" role="paragraph" xml-lang="en-US">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 - Chapter numbering"><menuitem>Tools - Chapter numbering</menuitem></link> are not displayed.</paragraph>
<paragraph id="par_id3156079" role="paragraph" xml-lang="en-US">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>

<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/flddocumentpage/fixed" id="bm_id3153014" localize="false"/>
<paragraph id="par_id0902200804313432" role="paragraph" xml-lang="en-US"><ahelp hid="." visibility="hidden">Inserts the field as static content, that is, the field cannot be updated.</ahelp></paragraph>
<note id="par_id3154470" xml-lang="en-US">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.</note>
<embed href="text/swriter/01/04090004.xhp#fixedcontent"/>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/flddocumentpage/level" id="bm_id3153038" localize="false"/>

<h2 id="hd_id3153026" xml-lang="en-US">Level</h2>
<paragraph id="par_id3154580" role="paragraph" xml-lang="en-US"><ahelp hid="modules/swriter/ui/flddocumentpage/level">Enter outline level of the chapter to be displayed. The inserted field will display the value taken from last paragraph with the specified outline level placed before the inserted field.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/flddocumentpage/offset" id="bm_id3154610" localize="false"/>

<section id="page_correction">
<bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/flddocumentpage/value" id="bm_id3150903" localize="false"/>
<h2 id="hd_id3150891" xml-lang="en-US">Offset</h2>
<paragraph id="par_id3155312" role="paragraph" xml-lang="en-US"><ahelp hid="modules/swriter/ui/flddocumentpage/value">Enter the offset value that you want to apply to a page number field, for example "+1".</ahelp></paragraph>
</section>
<paragraph id="par_id3145188" role="paragraph" xml-lang="en-US">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>
<tip id="par_id3154948" xml-lang="en-US">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.</tip>

<h2 id="hd_id3154598" xml-lang="en-US">Offset in days/minutes</h2>
<paragraph id="par_id3154899" role="paragraph" xml-lang="en-US"><ahelp hid="modules/swriter/ui/flddocumentpage/offset">Enter the offset that you want to apply to a date or time field.</ahelp></paragraph>

</body>
</helpdocument>