Learning to Love Markup Languages
Documentation | March 01, 2018
Having worked with WYSIWG tools such as FrameMaker most of my early working career, it was really hard getting used to writing documents in a markup language. I needed the comfort of a WYSIWYG editor and not having to wait for some compiler or typesetter to generate the output just to “see” what it looks like. That was a really big barrier to overcome.
Form AND function seemed to be required in my brain. Layout AND content had to be seen at the same time. I couldn’t write without first making the layout. This I blamed on WYSIWYG editors, or maybe it was just habit. But it was really stupid thinking. Give me a second to explain.
In the ancient times”
After all, how were documents written before there was software such as Word or WordPerfect (remember that tool?). They were written with a very simple layout in mind using a device called a Typewriter.
Ancient device known as a typewriter.
In case you don’t know what one looks like, here is an image of one for you. Its main claim to fame is the QWERTY keyboard which slowed down fast typists so they wouldn’t break the delicate mechanisms that lifted and pressed letters onto paper.
But let’s not get ahead of ourselves.
Writing involved good penmanship and precise form
Before even typewriters, there was this ancient task called writing. It was done with a special device called a pen or sometimes a pencil. It was called writing because you would take the device and “write” onto paper your message or story or letter. Imagine that!
Starting a few inches from the top of the paper, a writer would start writing the text with an attempt to keep a left and right margin (which is a space from the edge of the paper to the written text). Once the writer had completed one line of text (ideally 66 characters), writing continued on to the next line.
That was it! A good writer just needed beautiful penmanship and an ability to think ahead before writing to create a great document. You really saw what you got. If you messed up, well you just had to start again. Hence, the proverbial clutter of crunched paper below the desk of the dedicated writer.
Enter tab stops and double spaces
Later, with the typewriter, layout was a bit more precise but the device had controls for setting left and right margins. Using a sheet of paper, It was inserted into the feeder of a typewriter, the user then set up mechanical tab stops and then rolled the paper forward to start typing. And off they went banging away on the keys.
With a typewriter, it was considered good form to use two spaces between sentences for readability. And the typewriter had just one font, which was a mono-spaced font within a fixed block or area. This font was hard-coded onto the faces of the keys. Layout was still very simple and the focus was on writing text. In time, clever typists learned how to make tables, boxes, blank spaces for images, post and double lines, and so forth.
With minimal design, writing with a typewriter meant implicitly understanding about layout, simply because it barely existed.
Enter Word Processors
With the rapid rise of the use of personal computers, someone came up with the idea of Word Processors.
Layout became the first task BEFORE you started writing. You “set up” the document by usually choosing a pre-defined template provided by the software, or if you were clever, you could design your own.
WordPerfect word processor. Source: Wikipedia
This introduced so many conveniences. It is hard to remember, if at all, when all this work was done manually. Word processes introduced automatic running headers and footers. They could generate automatically Table of contents and indexes. Special footnotes or end notes could be easily inserted. Even images and pictures could be added as required.
What was once the work of artists, typesetters and printers was now in the reach of anyone who owned a powerful enough computer.
This, by the way, was the world of Technical Writers before the early 1980s.
Markup Languages that Separate Layout and Content
I deliberately skipped over one technological innovation that occurred during the 1960s and 1970s. This was the ability to write plain text files on computers and send those files to just about anyone with a computer that had a capability to read plain text files, which was just about all of them.
These files had absolutely no layout capabilities, except putting spaces or empty lines between paragraphs. That was it.
In fact, typewriters didn’t disappear but were very much still in use during the 1960s and 1970s and even into the 1980s. Authors would provide typewritten manuscripts to typesetters who would retype in the document into typesetting machines, add images, lines, headers, footers and so forth. Plates would be generated and sent to be printed on printing machines.
As an aside, I remember well operating a Heidelberg Platen Press in a printing company based in Lancaster, Pennsylvania. It was complicated, you had to be concentrating on the operation 100% of the time and know that machine well. But I loved running it. I got a thrill out of seeing this machine do its wonder. Here is an old advertisement for the same machine.
Heidelberg Platen Press. Source: britishletterpress.co.uk
But now it seems we have turned full circle back to “plain text”. Our modern cars are becoming Model T-Fords again, even though the underlying technology is clearly 21st century. There is an efficiency with separating content from layout.
Despite efforts of Word Processing tools to integrate markup languages into their products, the general trend is towards text based authoring and generating output based on a layout rules. LaTeX is once such system. DITA is another, but that is for a later set of articles.