eEditing for multi-channel publishing

Browser based systems for editing books and output to multiple formats

Chris Jennings
Oct 12, 2018 · 8 min read
From The Alchemist, Peter Bruegel. 1558. Staatliche Museum, Berlin.

Introduction

Authors use word processors to write text. Although there are many word processing programs on the market, Microsoft Word is the most common and although the format is propriety, files can be converted and edited with other tools. LibreOffice Office is a good alternative to Word and for Apple users there is Pages that can open Word files and export back to the Word format.

Entering and editing text in a web browser will rely on a friendly interface that provides a limited set of options for structure and style and these may be based on a browser plugin or use a Markdown toolset.

Structure rather than Style

The problem of word processing software, is that it is too easy to select styling that only visually enhances the text but does not adhere to any structural conformance. A word processed document that looks good, may not lend itself to being the basis for formats such as HTML and ePub (also formed form HTML).

What do we mean by Multi-channels?

What do we mean by structuring the text?

Within the blocks of text we will sometimes need to draw a different emphasise with words in bold or italic. These inline elements will be children of their paragraphs. Although I refer here to bold and italic we should not concern ourselves with appearance or style, because this can be anything we like and applied later in the workflow to publish.

The important thing is the structure and because of this, we can utilise an editing system that is very simple; Markdown .

Some authors are using such tools as Ulysses or Scrivener to write their texts. At the heart of these tools is a standard way to structure (we come to styling later) the text.

I am using Markdown to write this text. Markdown simply uses hash codes to indicate levels of heading. One hash is the top level # with ## and ### and so on being the following levels 2 and 3. A basic paragraph needs no markup particularly but does need to be separated with a break (2 returns will ensure this is separated).

Lists (bulleted or numbered) have special methods. A bulleted list is created by adding a + sign and space before the first item; thereafter a single break will continue the list. Numbered lists are similar but a number 1. a period and space will start the list.

Blockquotes need a > at the start of the first line.

Inline elements can use either an asterix * or an underscore _.

If you need to display a block of code in a technical document, then a set of 3 backticks will start the and finish the block.

Here is an example of how this appears:

# This is a heading 
## This is a sub heading
A paragraph of text looks like this and simply continues **although** can have **bold** and *italic* text. + One
+ Two
+ Buckle my shoe
1. Item 1
2. Item 2
3. Item 3
> Mary had a little lamb
>Its fleece was white as snow

There are other codes that will be needed for embedding images or for making hyperlinks. Footnotes are also possible, but as you will see, there are apps and tools that make this much easier.

I am writing this on my iPad with an app called Editorial. I am expected to type the markdown codes but the app makes this easy by providing a set of buttons along the bottom of the screen. The text will also be displayed appropriately giving feedback and confirmation that the elements are correctly formed.

I show here an example of Editorial in use.

There are other apps, that use markdown for both iOS and desktop computers.

I should also give a big mention to Atom a free editor for desktop computers. Below you see a screenshot with the markdown on the left and a preview on the right.

Atom is available from atom.io

Conversion to other formats

Some apps will already include the ability to directly export to a variety of formats; Ulysses, for example, will export to docx, PDF and ePub as well as HTML.

Markdown is raw text and has no styling applied. It can be read by any human or interpreted by a computer program that will then tag the markup and make appropriate formatting conversions depending on the requirement of the target file type.

Pandoc

Pandoc can be used in a command line mode. Here is an example that will convert a Word file to a Markdown document:

$ pandoc –wrap=none –extract-media=images somefile.docx -o mynewfile.md

Since Pandoc can be utilised on a web server, it can also be used by online tools to form publishing options.

More about Pandoc here.

Let us now explore some online systems that can provide multi-format export after editing in the browser. Many of these systems also provide collaborative editing.

Working Files in the Cloud

Penflip

You can see in the images here that the complexity of having a lot of editors is handled perfectly by this kind of system.

In terms of the actual workflow and details of the process, the text is edited with markdown

Penflip works well, but I cannot recommend it for serious work, since the support has fallen off, and may not be developed further.

GitBook

GitBook, as the name suggests is built to edit (also with markdown) a book under revision control within a Git repository. This goes beyond the prose.io instance described below, because the content can be exported as PDF or eBook. The management of the edits by multiple authors can be hard to resolve.

Note: GitBook has a new interface and looks different from this image.

Prose

You will notice from this screen image that Prose also includes a row of icons that make the process of entering markdown a lot easier for the user if they have little knowledge of the required markup. This set of icons leads us on to look at other input systems providing a more user friendly approach to browser based editing.

Other text input systems

Read more about the CKEditor here.

Booktype

I have now built an editing system based on this software here: booktype.publisha.org and this is only open to editors, however you can view this book in progress.

You can see from the image below that Booktype provides a variety of formats available for export.

Collaborative Editing

In systems that use Git as the basic versioning engine (Penflip, Prose, GitBook), each author/editor has ownership of their own version and when a commit is made the changes are then merged into the original or master copy. This means that editors can be working on the same document simultaneously.

With Booktype however, the document is effectively checked-out for the editor and cannot be edited by anyone else until those edits are saved. Changes are not part of the final document until the changes are accepted by the admin or chief editor.


Originally published at publisha.github.io on October 12, 2018.

Publisha

Articles and papers that revolve around publishing technology, book and typographic design and occassional posts of a more personal nature from Chris Jennings. See also my static GitHub site: https://publisha.github.io

Chris Jennings

Written by

eBook Consultant who teaches in the Oxford International Centre for Publishing at Oxford Brookes University. He also owns a boat ‘Perspectief’ on the Thames.

Publisha

Publisha

Articles and papers that revolve around publishing technology, book and typographic design and occassional posts of a more personal nature from Chris Jennings. See also my static GitHub site: https://publisha.github.io

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade