00:00:09In this demonstration we'll show you details
about the EPUB support in oXygen XML.
00:00:14In the first part of the demonstration we'll
define some transformation scenarios to produce
00:00:19EPUB files from DocBook and DITA.
00:00:21Next, we'll validate an EPUB archive and correct
the detected errors.
00:00:27In the final part of the demonstration we'll
show you how to search for and update specific
00:00:31content in an EPUB archive.
00:00:34First, we start by opening a sample DocBook
00:00:42Then we use a built-in transformation scenario
to convert it to EPUB, and after a successful
00:00:48transformation the result is automatically
opened in our system's default EPUB browser.
00:00:59Now, let's do a similar transformation with
a DITA project.
00:01:04We open our sample ditamap file in Oxygen's
DITA Maps Manager view.
00:01:10Again we'll use a built-in transformation
scenario to convert it to EPUB, this time
00:01:15using a DITA Map to EPUB scenario.
00:01:19Once again, after a successful transformation
the result is opened in the system's default
00:01:26Note that Oxygen includes support for obtaining
EPUB 2.0 or 3.0 output.
00:01:34Now, let's show you another useful feature that allows you to validate EPUB 2.0 or 3.0 archives.
00:01:41Oxygen includes a batch validation feature,
so to check multiple files for possible errors,
00:01:48we right-click the folder that contains our
EPUB files and select the Validate action.
00:01:58Notice that all of the problems are reported
in the Errors panel at the bottom of the editor.
00:02:03Let's focus on one of the files that contains
00:02:08To resolve the errors we want to see the structure
of the EPUB archive.
00:02:12We double-click the "sequence.epub" file to
open it and notice that Oxygen offers a dedicated
00:02:18"Archive Browser" view that shows all of the
contents of the EPUB package.
00:02:23We want to see the errors again for this particular
EPUB package, so we use the "Validate" button
00:02:28on the Archive Browser view's toolbar.
00:02:31Now let's correct the errors.
00:02:33The first error reports that there is an element
that is not allowed.
00:02:37If we double-click the problem in the Errors
panel, Oxygen will open that particular resource
00:02:42at the location of the error.
00:02:43To solve this problem, we simple need to rename
00:02:48After saving our changes, we validate the
00:02:54The next two errors report some missing resources
and the last warning indicates that the "images"
00:02:59directory is empty.
00:03:02To solve these errors, we simply need to add
the missing files to the appropriate folders.
00:03:13Now the EPUB should be complete, but to make
sure, we validate it again.
00:03:18And...the validation was successful this time.
00:03:23The last thing that we want to show you is
how to search for and update specific content
00:03:27in an EPUB archive.
00:03:29Let's open our sample in the default EPUB
browser ... notice that there is a toolbar
00:03:35button in the Archive Browser view to do this.
00:03:43Now,... suppose that we want to add the scientific
name for the "Snowdrop" flower.
00:03:48We go back to the Archive Browser view and
we invoke the "Find/Replace in Files" action.
00:03:55We search for the word "snow" and we set the
search scope to "Opened archive".
00:04:01Since EPUB is an archive that consists of
multiple files zipped together in a package,
00:04:06this means that the search operation will
look in all the files within that EPUB archive.
00:04:11We searched for the word "snow" and all instances
are shown in the results panel at the bottom
00:04:16of the editor.
00:04:18Now, we're going to open the table of contents
file and switch to "Author" mode.
00:04:24Notice that Oxygen renders this type of EPUB
file as a hierarchical list of HTML files
00:04:31and each entry is a reference to that specific
00:04:35So, for our purposes, we click on the link
for the "Snowdrop" entry to access its HTML
00:04:42We add the scientific name and save our changes.
00:04:47This will update the actual content within
the EPUB archive.
00:04:52Next, we validate the package to make sure
it's still valid and we'll open it in the
00:04:56default EPUB viewer one more time just to
make sure our change was updated in the archive.
00:05:05This concludes our demonstration about the
EPUB support in Oxygen XML and as always,
00:05:10thanks for watching.