Notes on the original text

The text formatting based on what the publisher could accept back then, a very simple kind of markdown. The book didn't require very sophisticated typography, so the main indicators are just

• Per-chapter files
• "CHAPTER" - to indicate chapter title text
• "SECTION" - for section headings
• "~~", "~/~" - to demark code/shell commands
• "~B~", "~/B~" - for bold
• "--" - for bullet lists
• and UTF-8 copyright and trademark symbols

The figures (see backstory) were hand-drawn by me and are now lost. At the time, they were re-drawn by Prentice-Hall to what you see in the book. So far, I've just scanned those in to the 'newfigures' folder. (Major TODO: to make those illustrations better.)

My table 'markdown' wasn't particularly sophisticated and I believe were just hand set by someone at the publisher. I've manually updated those tables with pandoc "pipe" formatting for now in the 'newtables' directory. (Minor TODO: perhaps write in HTML for final formatting).

I've written a small javascript library/program (in 'afs2pan' and 'lib/*.js') to convert all the above files to a format that pandoc can process. Essentially, for each chapter, I read in each line, and convert the formatting in the characters and the text; then to be processed by pandoc.

Pandoc - https://pandoc.org/ - is run to convert that formatted text to desired output. The makefile is configured to create both html and docbook files.

See the Makefile for latest commands to create the online book.

$ ./afs2pan archive/CH* > book/ma.pandoc
$ pandoc -s --metadata pagetitle=ManagingAFS -t html -o book/ma.html  < book/ma.pandoc
$ pandoc -s -t docbook -o book/ma.docbook  < book/ma.pandoc

For the html files, the style "pandoc.css" is from https://gist.github.com/killercup/5917178 . The final html is viewable on Github Pages at https://netrc.github.io/ManagingAFS Please use issues to report typos, bad formatting, etc.