[Libreoffice-commits] help.git: source/media source/text
Olivier Hallot
olivier.hallot at libreoffice.org
Mon Apr 30 15:30:34 UTC 2018
source/media/screenshots/modules/swriter/ui/exportepub/en-US/EPubDialog.png |binary
source/media/screenshots/modules/swriter/ui/exportepub/pt-BR/EPubDialog.png |binary
source/text/shared/00/00000002.xhp | 7
source/text/shared/00/00000401.xhp | 25 ++-
source/text/shared/01/ref_epub_export.xhp | 77 ++++++----
5 files changed, 81 insertions(+), 28 deletions(-)
New commits:
commit 3b48a6feb0728a07fba8213ee39f39bb835812f3
Author: Olivier Hallot <olivier.hallot at libreoffice.org>
Date: Sun Apr 29 16:55:24 2018 -0300
Improve EPUB help page
After some remarks from translators.
Added localized dialog too.
Added Adolfo suggestions.
Change-Id: Ie7311bb6f612284baa69a26c929cda99fda4e0a9
Reviewed-on: https://gerrit.libreoffice.org/53630
Tested-by: Jenkins <ci at libreoffice.org>
Reviewed-by: Olivier Hallot <olivier.hallot at libreoffice.org>
diff --git a/source/media/screenshots/modules/swriter/ui/exportepub/en-US/EPubDialog.png b/source/media/screenshots/modules/swriter/ui/exportepub/en-US/EPubDialog.png
new file mode 100644
index 000000000..ae4814ae8
Binary files /dev/null and b/source/media/screenshots/modules/swriter/ui/exportepub/en-US/EPubDialog.png differ
diff --git a/source/media/screenshots/modules/swriter/ui/exportepub/pt-BR/EPubDialog.png b/source/media/screenshots/modules/swriter/ui/exportepub/pt-BR/EPubDialog.png
new file mode 100644
index 000000000..0007dcdca
Binary files /dev/null and b/source/media/screenshots/modules/swriter/ui/exportepub/pt-BR/EPubDialog.png differ
diff --git a/source/text/shared/00/00000002.xhp b/source/text/shared/00/00000002.xhp
index 8ed48330f..b417867dc 100644
--- a/source/text/shared/00/00000002.xhp
+++ b/source/text/shared/00/00000002.xhp
@@ -48,6 +48,13 @@
<paragraph id="par_id180820162344398454" role="paragraph" xml-lang="en-US">The Content Management Interoperability Services (CMIS) standard defines a domain model and Web Services and Restful AtomPub bindings that will enable greater interoperability of Enterprise Content Management (ECM) systems. CMIS uses Web services and Web 2.0 interfaces to enable rich information to be shared across Internet protocols in vendor-neutral formats, among document systems, publishers and repositories, within one enterprise and between companies.</paragraph>
</section>
+<section id="epub">
+ <paragraph role="heading" id="hd_id151525000078771" level="2" xml-lang="en-US">EPUB</paragraph>
+ <paragraph role="paragraph" id="par_id11525000863861" xml-lang="en-US"><variable id="epubv">EPUB is standard for electronic book files with the extension <emph>.epub</emph> that can be downloaded and read on devices like smartphones, tablets, computers, or e-readers.</variable></paragraph>
+ <paragraph role="paragraph" id="par_id981525003378764" xml-lang="en-US">EPUB is a technical standard published now by the <link href="https://www.w3.org/publishing/" name="IDPF">Publishing group of W3C</link>. EPUB is a popular format because it is open and is based on HTML.</paragraph>
+ <paragraph role="paragraph" id="par_id291525000873676" xml-lang="en-US">An EPUB publication is delivered as a single file and is an unencrypted zipped archive containing a website. It includes HTML files, images, CSS style sheets, and other assets such as metadata, multimedia and interactivity.</paragraph>
+</section>
+
<section id="webdav">
<paragraph id="hd_id180820162344393005" role="heading" level="2" xml-lang="en-US">WebDAV</paragraph>
diff --git a/source/text/shared/00/00000401.xhp b/source/text/shared/00/00000401.xhp
index 00d2a5a0d..0b2109bcf 100644
--- a/source/text/shared/00/00000401.xhp
+++ b/source/text/shared/00/00000401.xhp
@@ -327,11 +327,28 @@
</section>
</section>
-<paragraph role="paragraph" id="par_id3145269" xml-lang="en-US"><variable id="export">Choose <emph>File - Export</emph>
-</variable></paragraph>
+<paragraph role="paragraph" id="par_id3145269" xml-lang="en-US"><variable id="export">Choose <emph>File - Export</emph></variable></paragraph>
+
+<section id="epub01">
+ <paragraph role="paragraph" id="par_id621525017637963" xml-lang="en-US">Choose <emph>File - Export as EPUB</emph>.</paragraph>
+ <table id="tab_id381525017874627">
+ <tablerow>
+ <tablecell>
+ <paragraph role="paragraph" id="par_id121525017890767" xml-lang="en-US">
+ <image src="cmd/sc_exportdirecttoepub.png" id="img_id291525017890767" width="0.566cm" height="0.566cm">
+ <alt xml-lang="en-US" id="alt_id51525017890767">Export as EPUB</alt>
+ </image>
+ </paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id421525017874627" role="tablecontent" xml-lang="en-US">Export Directly as EPUB</paragraph>
+ </tablecell>
+ </tablerow>
+ </table>
+</section>
+
<section id="exportpdf">
-<paragraph role="paragraph" id="par_id3166421" xml-lang="en-US">Choose <emph>File - Export as PDF</emph>
-</paragraph>
+<paragraph role="paragraph" id="par_id3166421" xml-lang="en-US">Choose <emph>File - Export as PDF</emph></paragraph>
<section id="syexportpdf">
<table id="tbl_id3154992">
<tablerow>
diff --git a/source/text/shared/01/ref_epub_export.xhp b/source/text/shared/01/ref_epub_export.xhp
index 1fe5d64ea..57155bebb 100644
--- a/source/text/shared/01/ref_epub_export.xhp
+++ b/source/text/shared/01/ref_epub_export.xhp
@@ -34,60 +34,89 @@
<bookmark_value>exporting;to EPUB</bookmark_value>
</bookmark>
+<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/EpubDialog" id="bm_id1033968" localize="false"/>
+
<paragraph id="hd_id3149532" role="heading" level="1" xml-lang="en-US"><variable id="ref_epub_export"><link href="text/shared/01/ref_epub_export.xhp" name="Export as EPUB">Export as EPUB</link></variable></paragraph>
-<paragraph id="par_id3154044" role="paragraph" xml-lang="en-US">Saves the current file to EPUB. An EPUB is a reflowable file that can be viewed or printed on any platform, provided that supporting software is installed.</paragraph>
+<paragraph id="par_id3154044" role="paragraph" xml-lang="en-US">Export the current file to <link href="text/shared/00/00000002.xhp#epub" name="epub">EPUB</link>.</paragraph>
+<paragraph role="paragraph" id="par_id701525003241759" xml-lang="en-US"><embedvar href="text/shared/00/00000002.xhp#epubv" markup="keep"/></paragraph>
</section>
-<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/EpubDialog" id="bm_id1033968" localize="false"/>
+<section id="howtoget">
+ <embed href="text/shared/00/00000401.xhp#epub01"/>
+</section>
-<paragraph id="hd_id3148519" role="heading" level="2" xml-lang="en-US">General</paragraph>
<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/generalft" id="bm_id1033966" localize="false"/>
+<paragraph id="par_id19921" role="paragraph"><image id="img_id22170" src="media/screenshots/modules/swriter/ui/exportepub/EPubDialog.png" localize="true" width="664px" height="482px"><alt id="alt_id59843">EPUB dialog box</alt></image></paragraph>
+<paragraph id="hd_id3148519" role="heading" level="2" xml-lang="en-US">General</paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/versionlb" id="bm_id1033967" localize="false"/>
<paragraph id="hd_id3148520" role="heading" level="3" xml-lang="en-US">Version</paragraph>
<paragraph id="par_id3154230" role="paragraph" xml-lang="en-US">Sets the version of the resulting EPUB file.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/versionlb" id="bm_id1033967" localize="false"/>
-<paragraph id="hd_id3148521" role="heading" level="3" xml-lang="en-US">Split method</paragraph>
-<paragraph id="par_id3154231" role="paragraph" xml-lang="en-US">Determines if a next EPUB section will start on page breaks or on paragraphs according to outline numbering.</paragraph>
<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/splitlb" id="bm_id1033968" localize="false"/>
+<paragraph id="hd_id3148521" role="heading" level="3" xml-lang="en-US">Split method</paragraph>
+<paragraph id="par_id3154231" role="paragraph" xml-lang="en-US">Select the type of start of the the next EPUB section.</paragraph>
+ <list type="unordered">
+ <listitem>
+ <paragraph id="par_id751525007405690" role="listitem" xml-lang="en-US"><emph>Heading</emph>: Starts the next section on headings, according to the document outline numbering.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id971525007425252" role="listitem" xml-lang="en-US"><emph>Page break</emph>: Starts the new section on a page break.</paragraph>
+ </listitem>
+ </list>
+<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/splitlb" id="bm_id1033969" localize="false"/>
<paragraph id="hd_id3148522" role="heading" level="3" xml-lang="en-US">Layout method</paragraph>
<paragraph id="par_id3154232" role="paragraph" xml-lang="en-US">Determines if a reflowable or a fixed layout EPUB will be generated.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/splitlb" id="bm_id1033969" localize="false"/>
+<list type="unordered">
+ <listitem>
+ <paragraph id="par_id51525006930128" role="listitem" xml-lang="en-US"><emph>Reflowable</emph>: The content flows, or reflows, to fit the screen and to fit the needs of the user.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id861525007152589" role="listitem" xml-lang="en-US"><emph>Fixed</emph>: Gives greater control over presentation when a reflowable EPUB is not suitable for the content.</paragraph>
+ </listitem>
+</list>
-<paragraph id="hd_id3148523" role="heading" level="3" xml-lang="en-US">Custom cover image</paragraph>
-<paragraph id="par_id3154233" role="paragraph" xml-lang="en-US">The exporter uses a cover image from the media directory (see below) if the image is named cover.gif, cover.jpg, cover.png or cover.svg. This default can be customized here.</paragraph>
<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/coverpath" id="bm_id1033970" localize="false"/>
+<paragraph id="hd_id3148523" role="heading" level="3" xml-lang="en-US">Custom cover image</paragraph>
+<paragraph id="par_id3154233" role="paragraph" xml-lang="en-US">Enter the full path of the custom cover image file. If the entry is empty, the exporter takes the cover image in the media directoty (see below) when the name is one of the following: <item type="literal">cover.gif</item>, <item type="literal">cover.jpg</item>, <item type="literal">cover.png</item> or <item type="literal">cover.svg</item>.</paragraph>
+<paragraph xml-lang="en-US" id="par_id601525022680859" role="note">The custom cover image is embeded in the EPUB file.</paragraph>
-<paragraph id="hd_id3148524" role="heading" level="3" xml-lang="en-US">Custom media directory</paragraph>
-<paragraph id="par_id3154234" role="paragraph" xml-lang="en-US">The exporter uses media from the FILENAME (without extension) directory (in the same directory than the document itself) by default. This can be customized here.</paragraph>
-<paragraph id="par_id3154235" role="paragraph" xml-lang="en-US">The media directory may contain: a cover image (see above), custom metadata (FILENAME-WITHOUT-EXTENSION.xmp, has priority over in-document metadata) and image links. Image links mean that if you create relative links on images or text and they link an image that's available in the media directory, then this media will be available in the EPUB export result as a popup.</paragraph>
<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/mediadir" id="bm_id1033971" localize="false"/>
+<paragraph id="hd_id3148524" role="heading" level="3" xml-lang="en-US">Custom media directory</paragraph>
+
+<paragraph id="par_id3154234" role="paragraph" xml-lang="en-US">Enter the custom media directory for the EPUB file. The media directory may contain a cover image as seen above, custom metadata and image links.</paragraph>
+
+<paragraph role="paragraph" id="par_id651525022578455" xml-lang="en-US">By default, the exporter looks for custom media and custom metadata in the current document directory inside a folder with the same name of the document file name. For example, if the document name is <item type="literal">MyText.odt</item>, the default media folder for cover and metadata is <item type="literal">MyText</item> in the current directory. </paragraph>
+
+<paragraph role="paragraph" id="par_id971525023515891" xml-lang="en-US">For custom metadata, you must provide a file with same name as the original filename and with extension as ".xmp". The provided metadata will override the the internal document metadata. In the example above, the custom metadata must exist in the MyText directory as <item type="literal">MyText.xmp</item>.</paragraph>
+
+<paragraph role="paragraph" id="par_id901525027635882" xml-lang="en-US">Image links mean that if you create relative links on images or text and they link an image that's available in the media directory, then this media will be available in the EPUB export result as a popup.</paragraph>
-<paragraph id="hd_id3148525" role="heading" level="2" xml-lang="en-US">Metadata</paragraph>
-<paragraph id="par_id3154236" role="paragraph" xml-lang="en-US">Allows manual override of document metadata. This is handy if for example the user creating the document is not the author of the publication in fact. If a metadata property should not be customized, it can be left empty.</paragraph>
<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/metadataft" id="bm_id1033972" localize="false"/>
+<paragraph id="hd_id3148525" role="heading" level="2" xml-lang="en-US">Metadata</paragraph>
+<paragraph id="par_id3154236" role="paragraph" xml-lang="en-US">Enter the custom metadata to override the document default metadata. These text fields can be left empty.</paragraph>
-<paragraph id="hd_id3148526" role="heading" level="3" xml-lang="en-US">Identifier</paragraph>
-<paragraph id="par_id3154237" role="paragraph" xml-lang="en-US">Unique identifier for the publication.</paragraph>
<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/identifier" id="bm_id1033973" localize="false"/>
+<paragraph id="hd_id3148526" role="heading" level="3" xml-lang="en-US">Identifier</paragraph>
+<paragraph id="par_id3154237" role="paragraph" xml-lang="en-US">Enter an unique identifier for the publication.</paragraph>
-<paragraph id="hd_id3148527" role="heading" level="3" xml-lang="en-US">Title</paragraph>
-<paragraph id="par_id3154238" role="paragraph" xml-lang="en-US">Title of the publication.</paragraph>
<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/title" id="bm_id1033974" localize="false"/>
+<paragraph id="hd_id3148527" role="heading" level="3" xml-lang="en-US">Title</paragraph>
+<paragraph id="par_id3154238" role="paragraph" xml-lang="en-US">Enter the title of the publication.</paragraph>
-<paragraph id="hd_id3148528" role="heading" level="3" xml-lang="en-US">Author</paragraph>
-<paragraph id="par_id3154239" role="paragraph" xml-lang="en-US">Author of the publication.</paragraph>
<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/author" id="bm_id1033975" localize="false"/>
+<paragraph id="hd_id3148528" role="heading" level="3" xml-lang="en-US">Author</paragraph>
+<paragraph id="par_id3154239" role="paragraph" xml-lang="en-US">Enter the Author of the publication.</paragraph>
+<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/language" id="bm_id1033976" localize="false"/>
<paragraph id="hd_id3148529" role="heading" level="3" xml-lang="en-US">Language</paragraph>
<paragraph id="par_id3154240" role="paragraph" xml-lang="en-US">Language of the publication (see RFC4646 and ISO 639 for possible values).</paragraph>
-<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/language" id="bm_id1033976" localize="false"/>
-<paragraph id="hd_id3148530" role="heading" level="3" xml-lang="en-US">Date</paragraph>
-<paragraph id="par_id3154241" role="paragraph" xml-lang="en-US">Last modification date for the publication. The value of this property must be an XML Schema dateTime conformant date of the form: CCYY-MM-DDThh:mm:ssZ.</paragraph>
<bookmark xml-lang="en-US" branch="hid/writerperfect/ui/exportepub/date" id="bm_id1033977" localize="false"/>
+<paragraph id="hd_id3148530" role="heading" level="3" xml-lang="en-US">Date</paragraph>
+<paragraph id="par_id3154241" role="paragraph" xml-lang="en-US">Last modification date for the publication. The value of this property must be an XML Schema dateTime conformant date in the form: CCYY-MM-DDThh:mm:ssZ. Default is the date and time when the export dialog opened.</paragraph>
</body>
-
</helpdocument>
More information about the Libreoffice-commits
mailing list