Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Introduction to Hybrid Publishing: at INC and WdKA
- 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
Hybrid Publishing at WdKA
focused on wikis as "working" format and platform
outputs: print and websites This approach is less fragmented, as it focus on the platform, but the publishing processes are less visible and harder to interact with. Also requires a lot of planing and conventions that everyone follows.
MMDC Graduation website
Essential tools: text processor, Markup, Pandoc, Text editor, Calibre
Turning a manuscript into Markdown, EPUB and ICML with Pandoc
Styling the manuscript inside Word: introducing structural meaning to the text
- Download one file from the Gray Zones manuscripts: http://publicationstation.wdka.hro.nl/andre/Gray_Zones/
- save it on a specific folder dedicated this workshop
- open it in your text processors and style it according to INC's style-guide
- save it in .docx
Converting the .docx to a Markdown plain-text file
- open your computer's Terminal
- navigate to that specific folder by
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 --output=mymarkdownfile.md mydocfile.docx
--atx-headersoption: 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 mymarkdownfile.md
--standaloneoption: results in a HTML file with all the necessary DOCTYPE, html, head and body tag. If you perform the same conversion without
--standaloneonly the content will be converted.
pandoc --standalone --from=markdown --to=html --css=style.css --output=myhtmlfile.html mymarkdownfile.md
--csslet 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 mymarkdownfile.md
(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 mymarkdownfile.md
--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 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 mymarkdownfile.md
icmlis 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.
- 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.