Hybrid-Publishing: Difference between revisions

From XPUB & Lens-Based wiki
(Created page with "==Hybrid Publishing - principals == Two or more outputs (publications) from a single workflow, that branches on two the outputs Updatable: connection between source and outp...")
 
m (Andre Castro moved page User:Hybrid-Publishing to Hybrid-Publishing)
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Hybrid Publishing - principals ==
==Hybrid Publishing ==
[[File:Hybrid-workflow.png|thumb]]


Two or more outputs (publications) from a single workflow, that branches on two the outputs
===Two or more outputs===
Two or more outputs (publications) from a single workflow, that branches out the end.


Updatable: connection between source and outputs
===Updatable===
[[File:Hybrid-workflow.png|600px]]
Connection between source and outputs


Template based design
===Dialogues===
Writing < - > Design 


Re-usability - not only of the templates but the workflows
===Re-usability===
Template based design.


Experimental outputs
With similar mechanics, but different templates - which results in different identities.


[http://hackersanddesigners.nl/ '''Hackers & Designers'''] [http://hackersanddesigners.nl/NewDesign/#/Scraping,%20counting,%20sorting new website (prototype)] [http://wiki.hackersanddesigners.nl/ wiki]


==Hybrid Publishing - tools ==
===Small costs - large audiences===
Publishing to a wide audience, under multiple formats, at small costs.
 
 
[http://w3c.github.io/dpub-pwp/ W3C Portable Web Publications for the Open Web Platform] ''full convergence between online and offline/portable document publishing''
 
===Form producing meaning===
Not specific to hybrid publishing.
But as at least 2 outputs are produce the influence of form over meaning becomes more apparent.
 
Example:
* http://toneelstof.be/ http://toneelstof.be/w (more on the project [http://activearchives.org/wiki/Toneelstof_SMW_K%C3%B6ln_%282012%29], [http://activearchives.org/whoswho/datadiary.pdf])
* Beyond Social - [http://www.beyond-social.org/prototypes/author-maps/wiki-author-articles.html Authors and Pages]; [http://beyond-social.org/ Table of contents]
 
'''EPUB from Graduation works'''
 
== Example - Graduation works website ==
 
===Wiki: editing space===
http://pzwiki.wdka.nl/mediadesign/Category:2015
 
* web applications dedicated to collaborative content creation<ref>[http://upload.wikimedia.org/wikipedia/commons/3/31/Ward_Cunningham%2C_Inventor_of_the_Wiki.webm Interview with Ward Cunningham] - inventor of the first wiki</ref>
* anyone can become an editor
* all content (edited, unedited, draft) is public
* little editorial structure to begin with (only users and pages): allowing workflows and structures to develop based on project's needs (by using categories, templates, user roles, etc)
* revision system: keeping track of each page edit
* enforces semantic structure within (articles) content - making possible conversion between formats
 
Down-sides:
* not very intuitive
* difficult to change its visual form
 
===Glue: connecting spaces===
* [https://www.mediawiki.org/wiki/API:Main_page Wiki API] - a programming interface to the wiki.
* [http://pandoc.org/ Pandoc]: converts the content from wiki pages' content to HTML (More on Pandoc's role in hybrid publishing in <ref>D.P.T. Collective. 2014. From Print to Ebooks: A Hybrid Publishing Toolkit for the Arts. Vol. 1. Institute of Network Cultures. http://networkcultures.org/blog/publication/from-print-to-ebooks-a-hybrid-publishing-toolkit-for-the-arts/</ref>)
* gluing [https://gitlab.com/Castro0o/iki2Frontend-MMDC scripts]:
** API calls to fetch content from wiki
** Pandoc calls to convert content to HTML
** Website HTML pages generation, from the fetched wiki content
 
===Website: publishing space===
http://pzimediadesign.nl/
* based on template html & css files
* pages are HTML files: easy to archive
 
Website design: [http://template01.info/ Template]
 
==Epub==
[[File:cpystmonk.jpg|thumb]]
 
* poor medium
* inconsistently rendered across readers
* lack of experimental, radical or utopian works or discourses
 
* readable and writable
* accessible: open-standards (HTML, CSS, Dublin Core metadata); Only requires a text-editor, and religious belief (to write it form scratch).   
* a book space?
 
 
=Hybrid Publishing - tools =
* Structured text - HTML, [http://daringfireball.net/projects/markdown/syntax Markdown], Mediawiki, styled docx
* Structured text - HTML, [http://daringfireball.net/projects/markdown/syntax Markdown], Mediawiki, styled docx
* Collaborative distributed tools - [Git http://git-scm.com/] / Mediawiki
* Collaborative distributed tools - [Git http://git-scm.com/] / Mediawiki
Line 21: Line 85:
* Custom made scripts: to gather and assemble content, transform the outputs programmatically, generate experimental outputs , ...
* Custom made scripts: to gather and assemble content, transform the outputs programmatically, generate experimental outputs , ...


==References ==
* From Print to Ebooks


* Author & Works map
== Simple Epub recipe ( using Pandoc) ==
* http://toneelstof.be/ http://toneelstof.be/w (more on the project [http://activearchives.org/wiki/Toneelstof_SMW_K%C3%B6ln_%282012%29], [http://activearchives.org/whoswho/datadiary.pdf])
[[File:studious-fox.jpg|thumb]]
 
* using [[Thematic-Making_It_Public]] page as content
'''Ingredients:'''
* 1 folder for project
* text file with wiki content
* images locally stored
 
'''Quick recipe:'''
<pre>pandoc --from mediawiki --to epub3 --self-contained --output=mybook.epub page.md</pre>
 
 
'''Long recipe:'''
<pre>pandoc --from mediawiki --to epub3 --self-contained --epub-chapter-level=1 --epub-stylesheet=styles.css --epub-cover-image=cover.jpg --epub-metadata=metadata.xml --toc-depth=1 --output=mybook.epub page.wiki<pre>
 
'''minimal metadata.xml file'''
<pre>
<dc:title id="epub-title-1">The Title</dc:title>
<meta refines="#epub-title-1" property="title-type">main</meta>
<dc:publisher>Publisher-name</dc:publisher>   
<dc:date id="epub-date">2015-11</dc:date>
<dc:language>en-US</dc:language>
<dc:creator id="epub-creator-0">Author</dc:creator>
<meta refines="#epub-creator-0" property="role" scheme="marc:relators">aut</meta>
</pre>
 
'''arguments explained'''
* `--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
* `--epub-embed-font` can also be used to embed custom font, but need to be imported in css style sheet
 
'''view book with calibre '''
 
ebook-viewer mybook.epub

Latest revision as of 18:17, 26 May 2019

Hybrid Publishing

Hybrid-workflow.png

Two or more outputs

Two or more outputs (publications) from a single workflow, that branches out the end.

Updatable

Connection between source and outputs

Dialogues

Writing < - > Design

Re-usability

Template based design.

With similar mechanics, but different templates - which results in different identities.

Hackers & Designers new website (prototype) wiki

Small costs - large audiences

Publishing to a wide audience, under multiple formats, at small costs.


W3C Portable Web Publications for the Open Web Platform full convergence between online and offline/portable document publishing

Form producing meaning

Not specific to hybrid publishing. But as at least 2 outputs are produce the influence of form over meaning becomes more apparent.

Example:

EPUB from Graduation works

Example - Graduation works website

Wiki: editing space

http://pzwiki.wdka.nl/mediadesign/Category:2015

  • web applications dedicated to collaborative content creation[1]
  • anyone can become an editor
  • all content (edited, unedited, draft) is public
  • little editorial structure to begin with (only users and pages): allowing workflows and structures to develop based on project's needs (by using categories, templates, user roles, etc)
  • revision system: keeping track of each page edit
  • enforces semantic structure within (articles) content - making possible conversion between formats

Down-sides:

  • not very intuitive
  • difficult to change its visual form

Glue: connecting spaces

  • Wiki API - a programming interface to the wiki.
  • Pandoc: converts the content from wiki pages' content to HTML (More on Pandoc's role in hybrid publishing in [2])
  • gluing scripts:
    • API calls to fetch content from wiki
    • Pandoc calls to convert content to HTML
    • Website HTML pages generation, from the fetched wiki content

Website: publishing space

http://pzimediadesign.nl/

  • based on template html & css files
  • pages are HTML files: easy to archive

Website design: Template

Epub

Cpystmonk.jpg
  • poor medium
  • inconsistently rendered across readers
  • lack of experimental, radical or utopian works or discourses
  • readable and writable
  • accessible: open-standards (HTML, CSS, Dublin Core metadata); Only requires a text-editor, and religious belief (to write it form scratch).
  • a book space?


Hybrid Publishing - tools

  • Structured text - HTML, Markdown, Mediawiki, styled docx
  • Collaborative distributed tools - [Git http://git-scm.com/] / Mediawiki
  • Document format converter - Pandoc
  • Ebook viewer, manager, editor - Calibre
  • CSS - for styling
  • Custom made scripts: to gather and assemble content, transform the outputs programmatically, generate experimental outputs , ...


Simple Epub recipe ( using Pandoc)

Studious-fox.jpg

Ingredients:

  • 1 folder for project
  • text file with wiki content
  • images locally stored

Quick recipe:

pandoc --from mediawiki --to epub3 --self-contained --output=mybook.epub page.md


Long recipe:

pandoc --from mediawiki --to epub3 --self-contained --epub-chapter-level=1 --epub-stylesheet=styles.css --epub-cover-image=cover.jpg --epub-metadata=metadata.xml --toc-depth=1 --output=mybook.epub page.wiki<pre>

'''minimal metadata.xml file'''
<pre>
<dc:title id="epub-title-1">The Title</dc:title>
<meta refines="#epub-title-1" property="title-type">main</meta>
<dc:publisher>Publisher-name</dc:publisher>    
<dc:date id="epub-date">2015-11</dc:date>
<dc:language>en-US</dc:language>
<dc:creator id="epub-creator-0">Author</dc:creator>
<meta refines="#epub-creator-0" property="role" scheme="marc:relators">aut</meta>

arguments explained

  • `--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
  • `--epub-embed-font` can also be used to embed custom font, but need to be imported in css style sheet

view book with calibre

ebook-viewer mybook.epub
  1. Interview with Ward Cunningham - inventor of the first wiki
  2. D.P.T. Collective. 2014. From Print to Ebooks: A Hybrid Publishing Toolkit for the Arts. Vol. 1. Institute of Network Cultures. http://networkcultures.org/blog/publication/from-print-to-ebooks-a-hybrid-publishing-toolkit-for-the-arts/