Single-source workflow
goal
Create ICML and HTML files from a styled docx manuscript file.
- The ICML is the content of the inDesing project that will originate the print publication
- The HTML is the content of the Website project
why
- updatable: changes to the manuscript are propagated to the outputs
- reusable: structure (headings, bloque quotes) and paragraphs styles (bold, italics) are maintained from manuscript to outputs
how:Pandoc / Hybrid Publishing Editor=
pandoc: is a software for converting text between different markups
However Pandoc's text-based interface can be challenging to use to those unused to use the terminal.
Luckily there are a few Web interfaces to Pandoc, such as Hybrid Publishing Editor by Michael Murtaugh
ICML files
ICML files are essentially XML files, usualy managed by InCopy, Adobe’s own word processor, which can be easily imported into Adobe InDesign.
Importing ICML to InDesign
An ICML file can be imported into InDesign with File>Place
The present paragraph styles and chapter styles that were present in the manuscript which gave origin to the ICML are kept and included in the HTML file.
bold; italic; blockquotes; footnotes; headers; paragraphs; tables; lists.
Images are given an empty placeholder.
Updating content
If the ICML remains linked to the inDesign project, changes performed in manuscript, once converted to the ICML, will be integrated into the inDesign project.
inDesign Styles
See more in https://helpx.adobe.com/indesign/using/paragraph-character-styles.html
Importing styles from another inDesign project
To import character and paragraph styles from another inDesign project:
- Choose Load All Text Styles from the Paragraph Styles panel menu
- InDesign displays the Open a File dialog box.
- Locate and select the InDesign project file containing the styles you want and click the Open button.
- InDesign copies the character styles from that publication into the current document.
http://ptgmedia.pearsoncmg.com/images/art_0600indesign_b/elementLinks/styles07.gif
Importing/Exporting styles
According to Lynda.com course Exporting InDesign styles for CSS and HTML "InDesign writes and creates the CSS for you. This is not an option that I really recommend because InDesign, great as it is, does not write very good CSS. It tries to write CSS that is a very, very close match in appearance to your print layout and that's not necessarily Web-friendly."
Besides the design spaces - the page and the screen have different properties and behaviors.
Conversions to ICML
Pandoc can convert HTML and Markdown markups into ICML, since the file format is is essentially XML markup.
Example command:
pandoc -s -f markdown -t icml -o my.icml my.md
-s option, which stands for “standalone”, produces output with an appropriate header and footer;
-f option, which stands for “from”, is followed by the source format;
-t option, which stands for “to”, is followed by the output format;
-o option, which stands for “output”;;
my.md is the markdown source filename.
Links
Updatable Website
How to integrating changing content & website creation?
Our problem: like in inDesign we want to work on the identity and navigation of our website, while keeping the content updatable.
inDesign addresses this issue with the use of chapter styles.
How can it work for the website creation?
https://github.com/wdka-publicationSt/book-website/archive/master.zip
