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.hal...@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 <c...@libreoffice.org>
Reviewed-by: Olivier Hallot <olivier.hal...@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>
_______________________________________________
Libreoffice-commits mailing list
libreoffice-comm...@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits
