Try to use Markdown instead of HTML. Try to do minimal changes from the text - don't put a paragraph in one line, or remove trailing space separately, as they make diffs hard to follow.
Example sections in chapters:
# Chapter 1
## Introduction to Lisp
## 3.1 A Guide to Lisp Style
### Answer 1.2
To mark a block of code, use:
```lisp
That will give syntax highlighting. Leave out lisp
if it's something else, like assembly.
>
to blockquote - to indent. You only need one at the start of a paragraph.
Use *italics*
for italics, and **bold**
for bold.
Non-paragraph line breaks can be tricky, like in the quotes at the start of chapters. It looks like two trailing spaces do the trick in both Github Flavored Markdown and Docsify:
Cerium quod factum.
(One is certain of only what one builds.)-Giovanni Battista Vico (1668-1744)
Italian royal historiographer
There are a lot of special symbols, with special ways of calling them; there's a Wikipedia page with a list. Here are some of the common ones:
symbol | entity |
---|---|
× | × |
π | π |
∫ | ∫ |
φ | φ |
≈ | ≈ |
ö | ö |
± | ± |
é | é |
⇒ | ⇒ |
λ | λ |
0̸ | 0̸ |
Note that these will not work in code blocks.
We're largely targeting Github Flavored Markdown, but the online version uses docsify, which uses marked.
If you'd like to test the docsify parsing, you can run a local server; look at scripts/httpd
- there are Ruby and Python variants.