andrecastro0o edited this page Sep 30, 2015 · 8 revisions

Introduction to Hybrid Publishing: at INC and WdKA

Hybrid Publishing

Hybrid Publishing

  • Two or more outputs
  • One workflow, that branches out
  • Connection between source and outputs

Hybrid Publishing at INC

  • focused on Markup as the "working" format
  • distribute work files among the different people involved in a publication - editor, designer, developer - with Git
  • avoiding redundancy: the same task should not be repeated, by more than 1 person.
  • outputs: print and ePub

A hybrid workflow

Miriam's proofreading notes

Hybrid Publishing at WdKA

Essential tools: text processor, Markup, Pandoc, Text editor, Calibre

  • Office like text processor
  • Markdown - why markdown?
  • Pandoc - a markup convert Pandoc possible conversions

Turning a manuscript into Markdown, EPUB and ICML with Pandoc

Styling the manuscript inside Word: introducing structural meaning to the text

Converting the .docx to a Markdown plain-text file

  • open your computer's Terminal
  • navigate to that specific folder by typing: cd (with a space at end) and dragging and dropping to the terminal the specific folder, and pressing enter.
  • with Pandoc to convert a .docx to a markdown plain text file

pandoc --from=docx --to=markdown --atx-headers mydocfile.docx

  • --atx-headers option: results in use nice Markdown headers: ##

Markdown will be the working document. The working format. It will be here that the changes and corrections will occur. The .docx is what INC receive's usually from the author and needs to

Converting the Markdown to HTML

pandoc --standalone --from=markdown --to=html --output=myhtmlfile.html

  • --standalone option: results in a HTML file with all the necessary DOCTYPE, html, head and body tag. If you perform the same conversion without --standalone only the content will be converted.

pandoc --standalone --from=markdown --to=html --css=style.css --output=myhtmlfile.html

  • --css let you include a style-sheet in the resulting HTML file.

converting the Markdown to EPUB.

pandoc --from markdown --to epub3 --self-contained --output=mybook.epub

(maybe for day 3) pandoc --from markdown --to epub3 --self-contained --epub-chapter-level=1 --epub-stylesheet=styles.epub.css --epub-cover-image=cover.jpg --epub-metadata=metadata.xml --toc-depth=1 --output=mybook.epub

  • --epub-chapter-level - at what heading level will the chapter brakes occur
  • --toc-depth - what heading level will be present in the Table of Contents

view the result: Calibre

ebook-viewer mybook.epub

  • ebook-viewer is Calibre's EPUB reader application

Use Pandoc to convert the markdown file to an ICML file.

pandoc --from markdown --to icml --self-contained --output=mybook.icml

  • icml is a markup, based in XML, used by Adobe's own text editor inCopy. ICML is this format that tries to integrate writing and layout, inside Adobe's ecosystem. There is no requisite to stay within that ecosystem. Since Pandoc can produce ICML any markup can be converted to ICML, and integrated into inDesgin.

Inside inDesign

  • place it inDesing
  • common errors
  • work with the file untill


Try go through the conversion processes we did:

  • create a docx document
  • format it using styles,
  • using Pandoc convert it to Markdown
  • edit the Markdown file
  • using Pandoc create an HTML page, EPUB or ICML for indesign
  • if you work often with inDesign attempt to:
    • style your project without breaking the connection to its ICML source
    • introduce changes in the Markdown file; Convert that Markdown file to ICML (under the same filename you first place in the inDesign project); Observer if the changes you introduced in the Markdown propagate to the inDesign project.
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.