source/text/shared/01/01100100.xhp | 100 ++++++++++++++++++++++++++++--
source/text/shared/01/about_meta_tags.xhp | 2
2 files changed, 96 insertions(+), 6 deletions(-)
New commits:
commit 63b848dba62b3f77c13a091f50ae2a0952152995
Author: Dione Maddern <dionemadd...@gmail.com>
AuthorDate: Fri May 3 16:20:08 2024 +0200
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Sun May 5 21:07:00 2024 +0200
tdf#159830 - [LOCALHELP] Update Help page on File Properties additions
(DUBLIN CORE)
In /text/shared/01/about_meta_tags.xhp
- Added bookmark information to make the page easier to find in the Help
index and search function
- Added instructions for accessing the Description tab to the "How to Get"
section.
- Updated description.
- Restructured page to improve readability.
- Added descriptions and DCMI definitions for new elements: Contributor,
Coverage, Identifier, Publisher, Relation, Rights, Source, and Type.
- Added DCMI descriptions for elements: Title and Subject.
- Added descriptions for "Help", "Reset", "OK", and "Cancel" buttons.
- Added a "Related Topics" section, including a link to the DCES page on
the DCMI website.
In /text/shared/01/about_meta_tags.xhp:
- Added Variable and Link tags to allow the file to be easily linked from
other pages.
Change-Id: Ib0d5226bb0aea6799575709248f0d3004082de47
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/167071
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
diff --git a/source/text/shared/01/01100100.xhp
b/source/text/shared/01/01100100.xhp
index 8446ea367d..3009b5cfd7 100644
--- a/source/text/shared/01/01100100.xhp
+++ b/source/text/shared/01/01100100.xhp
@@ -25,6 +25,13 @@
</topic>
</meta>
<body>
+ <bookmark branch="index" id="bm_id661712409722063">
+ <bookmark_value>description; document properties</bookmark_value>
+ <bookmark_value>description; file properties</bookmark_value>
+ <bookmark_value>description; metadata</bookmark_value>
+ <bookmark_value>metadata; adding metadata</bookmark_value>
+ <bookmark_value>metadata; editing metadata</bookmark_value>
+ </bookmark>
<section id="description">
<bookmark branch="hid/sfx/ui/descriptioninfopage/@@nowidget@@"
id="bm_@@nowidget@@" xml-lang="en-US" localize="false"/>
<bookmark branch="hid/sfx/ui/descriptioninfopage/DescriptionInfoPage"
id="bm_id3154788" xml-lang="en-US" localize="false"/>
@@ -32,20 +39,103 @@
<paragraph role="paragraph" id="par_id3154682" xml-lang="en-US"><ahelp
hid="sfx/ui/descriptioninfopage/DescriptionInfoPage">Contains descriptive
information about the document.</ahelp></paragraph>
</section>
<section id="howtoget">
+ <embed href="text/shared/00/00000004.xhp#from_menu_bar"/>
<embed href="text/shared/00/00000401.xhp#info3"/>
+ <embed href="text/shared/00/00000004.xhp#from_tabUI"/>
+ <paragraph role="paragraph" id="par_id721712354151660">Choose <menuitem>File
- Properties</menuitem> then select the <menuitem>Description</menuitem>
tab.</paragraph>
</section>
<bookmark branch="hid/sfx/ui/descriptioninfopage/title" id="bm_id3149798"
xml-lang="en-US" localize="false"/>
-<h2 id="hd_id3152372" xml-lang="en-US">Title</h2>
+ <paragraph role="paragraph" id="par_id271712404524124">%PRODUCTNAME supports
the Dublin Core Metadata Element Set, a standardized set of metadata elements
used to describe physical and electronic documents.</paragraph>
+ <tip id="par_id311712404964926">You can add additional metadata elements in
the <link href="text/shared/01/01100300.xhp"><menuitem>Custom
Properties</menuitem></link> tab.</tip>
+ <paragraph role="paragraph" id="par_id581602083308804"><emph>Title</emph>,
<emph>Subject</emph>, and <emph>Keywords</emph> are exported to PDF files as
PDF Document Properties. Entered values are exported and will appear in the
corresponding fields in the PDF Document Properties Description.</paragraph>
+ <h2 id="hd_id101714412611703"><variable
id="elements_h2">Elements</variable></h2>
+<section id="Title">
+<h3 id="hd_id3152372" xml-lang="en-US"><variable
id="title_h3">Title</variable></h3>
<paragraph role="paragraph" id="par_id3156042" xml-lang="en-US"><ahelp
hid="sfx/ui/descriptioninfopage/title">Enter a title for the
document.</ahelp></paragraph>
+ <paragraph role="paragraph" id="par_id291714416716612"><emph>DCMI
Definition: </emph>A name given to the resource.</paragraph>
+</section>
<bookmark branch="hid/sfx/ui/descriptioninfopage/subject" id="bm_id3145136"
xml-lang="en-US" localize="false"/>
-<h2 id="hd_id3145669" xml-lang="en-US">Subject</h2>
+<section id="subject"><h3 id="hd_id3145669" xml-lang="en-US"><variable
id="subject_h3">Subject</variable></h3>
<paragraph role="paragraph" id="par_id3147571" xml-lang="en-US"><ahelp
hid="sfx/ui/descriptioninfopage/subject">Enter a subject for the document. You
can use a subject to group documents with similar contents.</ahelp></paragraph>
+ <paragraph role="paragraph" id="par_id781714416090632"><emph>DCMI
Definition: </emph>The topic of the resource.</paragraph>
+</section>
<bookmark branch="hid/sfx/ui/descriptioninfopage/keywords" id="bm_id3145313"
xml-lang="en-US" localize="false"/>
-<h2 id="hd_id3156426" xml-lang="en-US">Keywords</h2>
+<section id="keywords">
+ <h3 id="hd_id3156426" xml-lang="en-US"><variable
id="keywords_h3">Keywords</variable></h3>
<paragraph role="paragraph" id="par_id3155338" xml-lang="en-US"><ahelp
hid="sfx/ui/descriptioninfopage/keywords">Enter the words that you want to use
to index the content of your document. Keywords must be separated by commas. A
keyword can contain white space characters or semicolons.</ahelp></paragraph>
+</section>
+<bookmark branch="hid/sfx/ui/descriptioninfopage/contributor"
id="bm_id761712336998843" localize="false"/>
+<section id="contributor">
+ <h3 id="hd_id991712331471026"><variable
id="contributor_h3">Contributor</variable></h3>
+ <paragraph role="paragraph" id="par_id1001712331484014">Enter the names of
the people, organizations, or other entities that have made contributions to
the document. For example he names of the authors of the document, or members
of the team who contributed data.</paragraph>
+ <paragraph role="paragraph" id="par_id341714417205026"><emph>DCMI
Definition: </emph>An entity responsible for making contributions to the
resource.</paragraph>
+</section>
+<bookmark branch="hid/sfx/ui/descriptioninfopage/coverage"
id="bm_id171712337010386" localize="false"/>
+<section id="coverage">
+ <h3 id="hd_id291712331494279"><variable
id="coverage_h3">Coverage</variable></h3>
+ <paragraph role="paragraph" id="par_id961712331502781">Enter the time,
place, or jurisdiction that the document is relevant to. For example, a range
of dates, a place, or an institution that the doccument applies to.</paragraph>
+ <paragraph role="paragraph" id="par_id751714417027700"><emph>DCMI
Definition: </emph>The spatial or temporal topic of the resource, the spatial
applicability of the resource, or the jurisdiction under which the resource is
relevant.</paragraph>
+</section>
+<bookmark branch="hid/sfx/ui/descriptioninfopage/identifier"
id="bm_id221712337018543" localize="false"/>
+<section id="identifier">
+ <h3 id="hd_id91712331508846"><variable
id="identifier_h3">Identifier</variable></h3>
+ <paragraph role="paragraph" id="par_id311712331541857">Enter a unique and
unambigous identifier for the document. For example, a document number or
ISBN.</paragraph>
+ <paragraph role="paragraph" id="par_id951714414695195"><emph>DCMI
Definition: </emph>An unambiguous reference to the document within a specific
context.</paragraph>
+</section>
+ <bookmark branch="hid/sfx/ui/descriptioninfopage/publisher"
id="bm_id141712337040094" localize="false"/>
+<section id="publisher">
+ <h3 id="hd_id941712331544480"><variable
id="publisher_h3">Publisher</variable></h3>
+ <paragraph role="paragraph" id="par_id971712331610892">Enter the name of the
entity that is making the document available. For example, a company,
university, or government body.</paragraph>
+ <paragraph role="paragraph" id="par_id951714495693749"><emph>DCMI
Definition: </emph>An entity responsible for making the resource
available.</paragraph>
+</section>
+<bookmark branch="hid/sfx/ui/descriptioninfopage/relation"
id="bm_id181712337044347" localize="false"/>
+<section id="relation">
+ <h3 id="hd_id991712331616227"><variable
id="relation_h3">Relation</variable></h3>
+ <paragraph role="paragraph" id="par_id41712331631248">Enter information
about resources related to the document. For example, a set of volumes the
document is part of, or the document's edition number.</paragraph>
+ <paragraph role="paragraph" id="par_id121714495775615"><emph>DCMI
Definition: </emph>A related resource.</paragraph>
+</section>
+<bookmark branch="hid/sfx/ui/descriptioninfopage/rights"
id="bm_id251712337051649" localize="false"/>
+<section id="rights">
+ <h3 id="hd_id371712331706300"><variable
id="rights_h3">Rights</variable></h3>
+ <paragraph role="paragraph" id="par_id381712331724319">Enter information
intellectual property rights associated with the document. For example, a
copyright statement, or information about who has permission to access the
document.</paragraph>
+ <paragraph role="paragraph" id="par_id651714495803137"><emph>DCMI
Definition: </emph>Information about rights held in and over the
resource.</paragraph></section>
+ <bookmark branch="hid/sfx/ui/descriptioninfopage/source"
id="bm_id521712337071559" localize="false"/>
+<section id="source">
+ <h3 id="hd_id691712336584526"><variable id="source_h3">Source</variable></h3>
+ <paragraph role="paragraph" id="par_id281712331745647">Enter information
about other resources from which the document is derived. For example, the name
or identifier of a hard copy that the document was scanned from, or a url that
the document was downloaded from.</paragraph>
+ <paragraph role="paragraph" id="par_id511714495809888"><emph>DCMI
Definition: </emph>A related resource from which the described resource is
derived.</paragraph>
+</section>
+<bookmark branch="hid/sfx/ui/descriptioninfopage/type"
id="bm_id121712337083175" localize="false"/>
+<section id="type">
+ <h3 id="hd_id921712336596379"><variable id="type_h3">Type</variable></h3>
+ <paragraph role="paragraph" id="par_id61712336816144">Enter information
about the category or format of the document. For example, whether the document
is a text document, image, or multimedia presentation.</paragraph>
+ <paragraph role="paragraph" id="par_id971714495815222"><emph>DCMI
Definition: </emph>The nature or genre of the resource.</paragraph>
+</section>
<bookmark branch="hid/sfx/ui/descriptioninfopage/comments" id="bm_id3147009"
xml-lang="en-US" localize="false"/>
-<h2 id="hd_id3148620" xml-lang="en-US">Comments</h2>
+<section id="comments">
+ <h3 id="hd_id3148620" xml-lang="en-US"><variable
id="comments_h3">Comments</variable></h3>
<paragraph role="paragraph" id="par_id3155391" xml-lang="en-US"><ahelp
hid="sfx/ui/descriptioninfopage/comments">Enter comments to help identify the
document.</ahelp></paragraph>
-<tip id="par_id581602083308804"><emph>Title</emph>, <emph>Subject</emph>, and
<emph>Keywords</emph> are exported to PDF files as PDF Document Properties.
Entered values are exported and will appear in the corresponding fields in the
PDF Document Properties Description.</tip>
+</section>
+<section id="help">
+ <h2 id="hd_id621714663020660">Help</h2>
+ </section>
+<section id="reset">
+ <embed href="text/shared/00/00000001.xhp#par_id761668777629023"/>
+ <h2 id="hd_id681714663041980">Reset</h2>
+</section>
+<section id="ok">
+ <embed href="text/shared/00/00000001.xhp#par_id3145068"/>
+ <h2 id="hd_id21714663049092">OK</h2>
+ <embed href="text/shared/00/00000001.xhp#par_id3145369"/>
+</section>
+<section id="cancel">
+ <h2 id="hd_id71714663031713">Cancel</h2>
+ <embed href="text/shared/00/00000001.xhp#par_id3155913"/>
+</section>
+<section id="relatedtopics">
+ <embed href="text/shared/01/01100000.xhp#eigen_von"/>
+ <embed href="text/shared/01/about_meta_tags.xhp#meta_tags_h1"/>
+ <paragraph role="paragraph" id="par_id621714749828805"><link
href="https://www.dublincore.org/specifications/dublin-core/dces/";>DCES Page on
the DCMI Website</link></paragraph>
+</section>
</body>
</helpdocument>
diff --git a/source/text/shared/01/about_meta_tags.xhp
b/source/text/shared/01/about_meta_tags.xhp
index dc51add0e2..bb24bca7c1 100644
--- a/source/text/shared/01/about_meta_tags.xhp
+++ b/source/text/shared/01/about_meta_tags.xhp
@@ -34,7 +34,7 @@
<bookmark_value>META tags</bookmark_value>
<bookmark_value>tags; META tags</bookmark_value>
</bookmark>
-<h1 id="hd_id3154380">HTML import and export</h1>
+<h1 id="hd_id3154380"><variable id="meta_tags_h1"><link
href="text/shared/01/about_meta_tags.xhp">HTML import and
export</link></variable></h1>
<paragraph role="paragraph" id="par_id3145119" xml-lang="en-US">When you
export a file to an HTML document, the description and the user-defined file
properties are included as META <link
href="text/shared/00/00000002.xhp#tags">tags</link> between the HEAD tags of
the exported document. META tags are not displayed in a Web browser, and are
used to include information, such as keywords for search engines on your Web
page. To set the properties of the current document, choose <menuitem>File -
Properties</menuitem>, click the <emph>Description</emph> or <emph>Custom
Properties</emph> tabs, and then type the information you want.</paragraph>
<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US">The following
file properties are converted to META tags when you export a file as an HTML
document:</paragraph>
<table id="tbl_id3147304">
