forked from netrc/ManagingAFS
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathtextnotes.html
47 lines (45 loc) · 2.8 KB
/
textnotes.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="generator" content="pandoc" />
<title>ManagingAFS</title>
<style type="text/css">code{white-space: pre;}</style>
<link rel="stylesheet" href="../pandoc.css" type="text/css" />
</head>
<body>
<a href="../index.html">Managing AFS</a>
<h2> Notes on the original text </h2>
All of the original text, figures, and tables are in the "archive" folder just as I delivered to Prentice-Hall in 1997. As you will see, the files are mostly just simple text - editing powered by Vi!.
<p>
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
<ul>
<li> Per-chapter files
<li> "CHAPTER" - to indicate chapter title text
<li> "SECTION" - for section headings
<li> "~~", "~/~" - to demark code/shell commands
<li> "~B~", "~/B~" - for bold
<li> "--" - for bullet lists
<li> and UTF-8 copyright and trademark symbols
</ul>
<p>
The figures (see <a href="../notes/backstory.html">backstory</a>) 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.)
<p>
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).
<p>
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.
<p>
Pandoc - <a href="https://pandoc.org/">https://pandoc.org/</a> - is run to convert that formatted text to desired output. The makefile is configured to create both html and docbook files.
<p>
See the Makefile for latest commands to create the online book.
<pre>
$ ./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
</pre>
<p>
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.
</body>
</html>