March 2021
Update Patch Release Notes
The following updates have been implemented in this release:
In this update, we have implemented the aria-label and aria-labelledby, which come under Aria States and Properties category.
This is applicable to elements with implicit landmark roles such as <section>, <nav> and <aside> elements appearing in the variants of ePub3 formats.
A new checkbox for "Process Aria States and Properties. [aria-label] [aria-labelledby]" has been added under 'Accessibility ARIA Processing' header, for "ePub3 Processing Options" on the DPI form.
Currently if the ePub3, generated from Digital Publisher has notes/footnotes with the default markup, the notes/footnotes functionality is not working properly in Apple iBooks. The only thing that displays is the footnote number (twice).
We have now done modifications in the markup, if the following options are selected in the DPI form.
iBooks Notes and Footnotes processing
- Insert separate span for Endnote text and map ePubtype and ref ID.
- Insert separate span for Footnote text and map ePubtype and ref ID.
For e.g.
The default markup for Notes processing is as follows:
<div class="list-named-rw list-notes-rw" id="list-notes1"> <p id="p208" epub:type="rearnote"> <span class="num-note-rw" id="rw-num-note-1"> <a href="#rw-ref-note-1">1</a> </span> chapter 1 note 1 </p>
So in this case, if the note links to span#rw-num-note-1 it only pops up the content of the span, which is only the endnote number.
After selecting the above option for notes, and generating the ePub3, the new structure would be
<div class="list-named-rw list-notes-rw" id="list-notes1"> <p id="p208"> <span class="num-note-rw"><a href="#rw-ref-note-1">1</a></span> <span id="rw-num-note-1" epub:type="rearnote"> chapter 1 note 1</span> </p>
There are cases when images are not available in the manuscript, or images are not yet ready for insertion in the manuscript, so these images will have to be uploaded and inserted manually into the document later, once the manuscript is imported.
"Image-Placeholder" paragraph style has been introduced in the manuscript styles, to avoid the manual insertion of images at the desired location.
So in this case user can insert image placeholder text in the manuscript and import the manuscript.
For e.g. When image_001.jpg text is inserted into a manuscript along with the "Image-Placeholder" paragraph style applied, the manuscript importer will convert this placholder text into .images/image_001_online.jpg image relative path reference within the imported document.
Later when the user uploads the actual image into Media Manager, under Images tab, the images will automatically be visible on the placeholder location.
Notes:
1. The image reference in DOCX must include the file extension.
2. The image reference in the DOCX must be lower case. The Media manager converts all the images to lower case during upload.
3. Do not use space or hyphen in the filename.
4. The files must be uploaded to the images directory inside the book using the Media Manager.
The IGP manuscript master template has been updated for "Image-Placeholder" style for this feature.
There are cases when inline images are available in the manuscript. The images are then imported as Block Media into the document.
We have now handled such images to be imported as Inline Media into the document.
To setup the inline images into the manuscript, one can use any one of the following method:
- Libreoffice: After inserting inline image in manuscript, there needs to set a following image property i.e.: As character. And There are two ways to view image properties. First option is via double clicking on image and second option is via right clicking on image and select "Properties" option.
Image Properties >> Type >> Anchor >> As character
- MS Office: After inserting inline image in manuscript, there needs to set a following image property i.e.: In Line with Text. This option is visible under Wrap Text option.
Picture Tool >> option >>Wrap Text >> In line with Text
Audio and Video count is added in statistics report. This Audio and Video count is based on <audio> and <video> element count in the sections.
For the quiz, make a person answer all the questions before they can check their answers
For the new "Check" button update/functionality to work, the class "custom-validation" will need to be used in QAA set block.
IE:
<div class="qaa-set-rw custom-validation">
And also in the normal QAA blocks:
IE:
<div class="qaa-rw multichoice-rw custom-validation">
If qaa set is present the you dont have to put in the normal qaa block
If qaa block is used without qaa set then normal qaa block need to have class
The system now is enabled to embed PDF in ePub3 and ePub3+2 to generate a valid ePub. The PDF file must be uploaded in Writer, in the 'download_files' folder under the "Document Components" accordian of the Title. The file can then be inserted into any section as a link.
The Master Presentation Templates will be updated by IGP during the update activity. If you have created any custom templates based on the IGP Master Templates, please check that these updates are applied in your templates if applicable.
DPI Form update - Added "iBooks Notes and Footnotes processing" header along with the below two checkbox options, under ePub3 Processing options
- Insert separate span for Endnote text and map ePubtype and ref ID.
- Insert separate span for Footnote text and map ePubtype and ref ID.
DPI Form update - Changed current heading text "Accessibility Aria Role" to "Accessibility ARIA Processing".
DPI Form update - Changed current text "Process Aria Role attributes." to "Process Aria Roles."
DPI Form update - Added "Process Aria States and Properties. [aria-label, aria-labelledby]" option under 'Accessibility Aria Processing' header, for "ePub3 Processing Options".
[ PT updated: DPMaster-2012, DPMasterSMIL-2012, TradeMaster-2012, MinimalCSS and StaticSiteMaster-2012 ]
Table rowspan issue was appearing after importing docx file. This is now fixed.
Section numbering processing feature for Article section was not working. Heading numbering, Process Content Block Numbers, TOC nesting, NCX/TOC.xhtml. This is now fixed.
Image alt-text and Table summary processing generated "modified-img" and "modified-other" processing attributes in FX and it was not stripped during processing. In result, these attributes are generating ePub validation errors. This is now fixed.
In some cases the manuscript docx importing failed due to permission issues, when images were present in the manuscript. This now fixed.
On manuscript docx importing, the "fm-Other" section was getting stripped and not appearing in the document. This now fixed.
If a num-note-rw or num-footnote-rw have multiple same references then during notes and footnotes hyper linking process reference linking processed with wrong hyperlink. This is now fixed.
When processing Website Metadata, IGP and SEO metadata blocks were repeated in poem block of poem section. This is now fixed.
On manuscript docx importing, <a> orphan elements wrapped all its further content within it in writer. To fix this, added one hard space to <a> orphan elements to avoid that content wrapping issue in writer after manuscript import process. And class="link-ref" has been added to <a> orphan elements handle space visibility in epub using CSS.
Media manager Cover upload - Stop creating a duplicate record for cover image if the same file is uploaded again.
There were cases when Manuscripts failed to import. We have now changed the docx conversion process.