[Libreoffice-commits] help.git: AllLangHelp_shared.mk source/text
Seth Chaiklin (via logerrit)
logerrit at kemper.freedesktop.org
Tue Oct 20 18:45:11 UTC 2020
AllLangHelp_shared.mk | 1
source/text/shared/01/ref_pdf_export_general.xhp | 20 +-
source/text/shared/01/ref_pdf_export_universal_accessibility.xhp | 73 ++++++++++
3 files changed, 87 insertions(+), 7 deletions(-)
New commits:
commit 73e6149de3f0eeb1be5b24e111995be34a7cb0d6
Author: Seth Chaiklin <sdc.blanco at youmail.dk>
AuthorDate: Sun Oct 11 23:10:15 2020 +0200
Commit: Seth Chaiklin <sdc.blanco at youmail.dk>
CommitDate: Tue Oct 20 20:44:50 2020 +0200
Resolves: tdf#127959 and tdf#135196 - updating help for PDF export - General tab
- add "Structure" heading and short description
- add PDF/A-3b format to PDF/A
- add note with advice about differences among PDF/A versions and which to choose.
- make new page about "Universal Accessibility"
- embed "Universal Accessibility (PDF/UA)" control and description
with link to new page
- update to <menuitem>
Change-Id: I634aa3f95890cfbf322c01560ae7afb6e25192f8
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/104152
Tested-by: Jenkins
Reviewed-by: Seth Chaiklin <sdc.blanco at youmail.dk>
diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk
index d587c0cae..a55d39e6f 100644
--- a/AllLangHelp_shared.mk
+++ b/AllLangHelp_shared.mk
@@ -368,6 +368,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\
helpcontent2/source/text/shared/01/ref_pdf_export_links \
helpcontent2/source/text/shared/01/ref_pdf_export_security \
helpcontent2/source/text/shared/01/ref_pdf_export_user_interface \
+ helpcontent2/source/text/shared/01/ref_pdf_export_universal_accessibility \
helpcontent2/source/text/shared/01/ref_pdf_send_as \
helpcontent2/source/text/shared/01/signexistingpdf \
helpcontent2/source/text/shared/01/securitywarning \
diff --git a/source/text/shared/01/ref_pdf_export_general.xhp b/source/text/shared/01/ref_pdf_export_general.xhp
index 8d2223e79..44b4308ae 100644
--- a/source/text/shared/01/ref_pdf_export_general.xhp
+++ b/source/text/shared/01/ref_pdf_export_general.xhp
@@ -54,7 +54,7 @@
<h2 id="par_idN10706">Images</h2>
<paragraph id="par_idN1070A" role="paragraph" xml-lang="en-US">Sets the PDF export options for images inside your document.</paragraph>
- <note id="par_idN1071B">EPS images with embedded previews are exported only as previews. EPS images without embedded previews are exported as empty placeholders.</note>
+
<bookmark xml-lang="en-US" branch="hid/filter/ui/pdfgeneralpage/losslesscompress" id="bm_id8095950" localize="false"/>
<h3 id="par_idN10715">Lossless compression</h3>
@@ -74,6 +74,8 @@
<bookmark xml-lang="en-US" branch="hid/filter/ui/pdfgeneralpage/resolution" id="bm_id1751762" localize="false"/>
<paragraph id="par_idN10782" role="paragraph" xml-lang="en-US"><ahelp hid=".">Select the target resolution for the images.</ahelp></paragraph>
+ <note id="par_idN1071B">EPS images with embedded previews are exported only as previews. EPS images without embedded previews are exported as empty placeholders.</note>
+
<h2 id="hd_id141574104956415">Watermark</h2>
<paragraph role="paragraph" id="par_id341574104961922">Add a centered, vertical, light green watermark text to the page background. The watermark is not part of the source document.</paragraph>
<h3 id="hd_id381574104981670">Sign with watermark</h3>
@@ -89,8 +91,11 @@
<paragraph id="par_id0804200803553767" role="paragraph" xml-lang="en-US"><ahelp hid=".">This setting enables you to export the document as a .pdf file containing two file formats: PDF and ODF.</ahelp> In PDF viewers it behaves like a normal .pdf file and it remains fully editable in %PRODUCTNAME.</paragraph>
<bookmark xml-lang="en-US" branch="hid/filter/ui/pdfgeneralpage/pdfa" id="bm_id303964" localize="false"/>
- <h3 id="hd_id2796411">Archive (PDF/A ISO 19005)</h3>
- <paragraph id="par_id5016327" role="paragraph" xml-lang="en-US"><ahelp hid=".">Converts to the PDF/A-2b or PDF/A-1b format. This is defined as an electronic document file format for long term preservation. All fonts that were used in the source document will be embedded into the generated PDF file. PDF tags will be written.</ahelp></paragraph>
+ <h3 id="hd_id2796411">Archive (PDF/A, ISO 19005)</h3>
+ <paragraph id="par_id5016327" role="paragraph" xml-lang="en-US"><ahelp hid=".">Converts to the PDF/A-1b, PDF/A-2b, or PDF/A-3b format. All fonts used in the source document are embedded in the generated PDF file, and PDF tags are written. The primary purpose is to create an electronic document whose appearance is device and application independent, making it suitable for long term preservation.</ahelp></paragraph>
+ <note id="par_id301602634061241">PDF/A-2b is recommended for most users, because it allows for layers and transparency with shapes and images. It also compresses better (JPEG 2000) than PDF/A-1b, usually producing smaller files. PDF/A-3b is identical to PDF/A-2b, but also accepts embedding of other file formats.</note>
+
+ <embed href="text/shared/01/ref_pdf_export_universal_accessibility.xhp#PDA_UA_Head"/>
<bookmark xml-lang="en-US" branch="hid/filter/ui/pdfgeneralpage/tagged" id="bm_id6884975" localize="false"/>
@@ -111,10 +116,11 @@
<h3 id="hd_id1026200909535841">Allow duplicate field names</h3>
<paragraph id="par_id102620090953596" role="paragraph" xml-lang="en-US"><ahelp hid=".">Allows you to use the same field name for multiple fields in the generated PDF file. If disabled, field names will be exported using generated unique names.</ahelp></paragraph>
-
+<h2 id="hd_id671602451425200">Structure</h2>
+<paragraph role="paragraph" id="par_id51602451783950">Sets options for diverse features such as bookmarks, comments, page layout.</paragraph>
<bookmark xml-lang="en-US" branch="hid/filter/ui/pdfgeneralpage/bookmarks" id="bm_id8694112" localize="false"/>
<h3 id="hd_id8257087">Export outlines</h3>
- <paragraph id="par_id3479415" role="paragraph" xml-lang="en-US"><ahelp hid=".">Select to export bookmarks of Writer documents as PDF bookmarks. Bookmarks are created for all outline paragraphs (<item type="menuitem">Tools - Chapter Numbering</item>) and for all table of contents entries for which you did assign hyperlinks in the source document.</ahelp></paragraph>
+ <paragraph id="par_id3479415" role="paragraph" xml-lang="en-US"><ahelp hid=".">Select to export bookmarks of Writer documents as PDF bookmarks. Bookmarks are created for all outline paragraphs (<menuitem>Tools - Chapter Numbering</menuitem>) and for all table of contents entries for which you did assign hyperlinks in the source document.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/filter/ui/pdfgeneralpage/exportplaceholders" id="bm_id7971129" localize="false"/>
<switch select="appl">
@@ -156,8 +162,8 @@
<h3 id="hd_id3946959">Use reference XObjects</h3>
<paragraph id="par_id8551897" role="paragraph" xml-lang="en-US"><ahelp hid=".">This option affects how PDF images are exported back to PDF. When this option is disabled, then the first page of the PDF data is included in the output. The PDF export merges the used images, fonts and other resources during export. This is a complex operation, but the result can be viewed in various viewers. When the option is enabled, then the reference XObject markup is used: this is a simple operation, but viewers have to support this markup to show vector images. Otherwise a fallback bitmap is shown in the viewer.</ahelp></paragraph>
<section id="relatedtopics">
- <embed href="text/shared/01/ref_pdf_export_digital_signature.xhp#relatedtopics"/>
-</section>
+ <embed href="text/shared/01/ref_pdf_export_digital_signature.xhp#relatedtopics"/>
+ </section>
</body>
</helpdocument>
diff --git a/source/text/shared/01/ref_pdf_export_universal_accessibility.xhp b/source/text/shared/01/ref_pdf_export_universal_accessibility.xhp
new file mode 100644
index 000000000..92401eca6
--- /dev/null
+++ b/source/text/shared/01/ref_pdf_export_universal_accessibility.xhp
@@ -0,0 +1,73 @@
+<?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/.
+ *
+-->
+
+<meta>
+ <topic id="universalaccessibility" indexer="include" status="PUBLISH">
+ <title id="tit" xml-lang="en-US">Universal Accessibility (PDF Export)</title>
+ <filename>/text/shared/01/ref_pdf_export_universal_accessibility.xhp</filename>
+ </topic>
+</meta>
+<body>
+<bookmark xml-lang="en-US" branch="index" id="bm_id791603045631184">
+<bookmark_value>PDF export;Universal Accessibility</bookmark_value>
+</bookmark>
+<section id="PDF_UA_head">
+<h2 id="hd_id711602623643384"><link href="text/shared/01/ref_pdf_export_universal_accessibility.xhp">Universal Accessibility (PDF/UA)</link></h2>
+<paragraph role="paragraph" id="par_id221602623934399">Creates a universal accessibility-complaint PDF file that follows the requirements of PDF/UA (ISO 14289) specifications.</paragraph>
+</section>
+
+<section id="howtoget">
+<embed href="text/shared/00/00000401.xhp#exportpdfgeneral"/>
+<paragraph role="paragraph" id="par_id891603046173838">then choose Universal Accessibility (PDF/UA).</paragraph>
+</section>
+
+<paragraph role="paragraph" id="par_id151603044639549">The specification defines the required structure and formatting of a document and PDF features that are better suited for accessibility. This specification can also be used to produce documents that achieve W3C's Web Content Accessibility Guidelines 2.0 (WCAG 2.0).</paragraph>
+
+<paragraph role="paragraph" id="par_id701603046818148">The present implementation (January 2020) checks the following:</paragraph>
+
+<list type="unordered">
+ <listitem>
+ <paragraph id="par_id601603042936801" role="listitem">Document title is set.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id951603042978520" role="listitem">Document language is set, or that all styles in use, have the language set.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id951603042984032" role="listitem">All images, graphics, OLE objects have an "alt" text (or title in some objects).</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id341603042991177" role="listitem">Tables do not include splits or merges.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id481603043007920" role="listitem">Only integrated numbering is used. No manual numbering (e.g., writing "1." "2." "3." at the beginning of paragraphs.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id521603043012471" role="listitem">Hyperlink text is not a hyperlink itself, and hyperlink is described. </paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id521603043019328" role="listitem">Contrast between text and background meets the WCAG specification.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id71603043022999" role="listitem">No blinking text.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id251603043029601" role="listitem">No footnotes and endnotes.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id101603043034257" role="listitem">Headings must increase incrementally with no skips (e.g., cannot have Heading 1 to Heading 3, skipping Heading 2).</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id281603043041040" role="listitem">Text does not convey additional meaning with (direct) formatting.</paragraph>
+ </listitem>
+</list>
+<tip id="par_id311603047235460">Check Accessibility before trying to export with <menuitem>Tools - Check Accessibility</menuitem> </tip>
+</body>
+</helpdocument>
\ No newline at end of file
More information about the Libreoffice-commits
mailing list