001/hdr/001/001 -- a brief introduction to z.m.l. xxxxx
001/hdr/002/002 -- by bowerbird intelligentleman xxxxx
001/bce/003/003 -- you can "view source" for this document here:
---/---/004
002/hdr/005/001 -- table of contents xxxxx
002/bce/006/002 -- a brief introduction to z.m.l.
---/---/007
003/hdr/008/001 -- preface to this brief introduction xxxxx
003/pop/009/002 -- this is the preface.
---/---/010
004/hdr/011/001 -- chapter 1
004/hdr/012/002 -- review paragraphs xxxxx
004/pop/013/003 -- separate paragraphs with a blank line.
004/pop/014/004 -- don't indent paragraphs with spaces or tabs.
004/pop/015/005 -- (indeed, don't use tabs anywhere.)
---/---/016
005/hdr/017/001 -- chapter 2
005/hdr/018/002 -- review sections xxxxx
005/pop/019/003 -- separate the sections -- such as chapters,
005/pop/020/004 -- you can alternatively put hash-marks at the
005/pop/021/005 -- every section must have at least one header,
005/pop/022/006 -- the first section in the book is the cover/title.
005/pop/023/007 -- the second section is the table of contents.
---/---/024
006/hdr/025/001 -- chapter 3
006/hdr/026/002 -- text styling in your book xxxxx
006/pop/027/003 -- italicized words are indicated with underbars,
006/pop/028/004 -- this word will be in _italics._
006/pop/029/005 -- this phrase _will_ _be_ _in_ _italics._
006/pop/030/006 -- *bold* words are indicated with asterisks,
006/pop/031/007 -- this word will be in *bold.*
006/pop/032/008 -- this phrase *will* *be* *bold.*
---/---/033
007/hdr/034/001 -- chapter 4
007/hdr/035/002 -- poetry and other silly things xxxxx
007/pop/036/003 -- use a space in the first column to get centered lines.
007/bce/037/004 -- t.v. will eat you
007/bce/038/005 -- t.v. will eat you
007/pop/039/006 -- use multiple spaces (5 or more, in a consistent number)
007/bpo/040/007 -- a haiku for you
007/bpo/041/008 -- haiku have three lines
007/pop/042/009 -- you can vary the spacing, as some poems like to do.
007/bpo/043/010 -- six spaces at the start of this line
007/pop/044/011 -- you can even get downright fweaky!
007/bpo/045/012 -- six spaces at the start of this line
007/pop/046/013 -- sometimes you want to set off an element
007/bce/047/014 -- the input for the 2 chunks that follow has
007/bce/048/015 -- you know about a space in the first column.
007/bce/049/016 -- a space in the first column will center a line,
007/bjl/050/017 -- this chunk, and the next chunk as well, has
007/bjl/051/018 -- if you want to explicitly declare a block as
007/bjc/052/019 -- this chunk, and the next chunk as well, has
007/bjc/053/020 -- as reported above, a space in the first column
007/bjr/054/021 -- this chunk, and the next chunk as well, has
007/bjr/055/022 -- and, to fill out the left-center-right concept,
007/bce/056/023 -- so, to review, 1 space = centered
007/pop/057/024 -- note also that you can use this convention inside
007/pop/058/025 -- and, of course, the other types of justification
---/---/059
008/hdr/060/001 -- chapter 5
008/hdr/061/002 -- images in your book xxxxx
008/pop/062/003 -- to include an image in your book, just enter its u.r.l.
008/bce/063/004 -- http://z-m-l.com/go/alice/checking_watch.png
008/pop/064/005 -- "what is the
008/bce/065/006 -- http://z-m-l.com/go/alice/alice_cramped.png xxxxx
008/pop/066/007 -- you can put a caption on your image if you like,
008/bce/067/008 -- here's a caption placed above a picture
008/bce/068/009 -- http://z-m-l.com/go/alice/checking_watch.png
008/bce/069/010 -- and here's a caption placed above a picture...
008/pop/070/011 -- and, using the methodology discussed above,
008/pop/071/012 -- and, of course, the justification techniques that
008/pop/072/013 -- to center an image, precede its u.r.l. with 1 space:
008/bjc/073/014 -- http://z-m-l.com/go/alice/checking_watch.png xxxxx
008/pop/074/015 -- to "float" the image to the left, use 2 spaces:
008/bjl/075/016 -- http://z-m-l.com/go/alice/checking_watch.png xxxxx
008/pop/076/017 -- to center an image, precede its u.r.l. with 3 spaces:
008/bjc/077/018 -- http://z-m-l.com/go/alice/checking_watch.png xxxxx
008/pop/078/019 -- and to "float" it to the right, you'd use 4 spaces:
008/bjr/079/020 -- http://z-m-l.com/go/alice/checking_watch.png xxxxx
008/pop/080/021 -- notice that when you use a single space, the image
008/pop/081/022 -- on the other hand, using the 2/3/4 spaces method
008/pop/082/023 -- when you use the 2/3/4 spaces option for a picture,
---/---/083
009/hdr/084/001 -- chapter 6
009/hdr/085/002 -- linking in your book xxxxx
009/pop/086/003 -- remember how, in chapter 2, we said
009/pop/087/004 -- similarly, there are often places in a book
009/pop/088/005 -- so jaguar automates those links for you,
009/pop/089/006 -- for instance, the beginning of this chapter
009/pop/090/007 -- such internal links are one type needed,
009/pop/091/008 -- to make an external link, just list the u.r.l.
009/bce/092/009 -- http://gutenberg.org
009/pop/093/010 -- jaguar will create that link automatically.
009/pop/094/011 -- a core element of the jaguar philosophy
009/pop/095/012 -- however, if the u.r.l. would be too bulky to
009/pop/096/013 -- i get 10 times more traffic from Google[g]
009/pfn/097/014 -- [g] http://google.com
009/pfn/098/015 -- [y] http://search.yahoo.com
009/pfn/099/016 -- [m] http://bing.com
---/---/100
010/hdr/101/001 -- chapter 7
010/hdr/102/002 -- multi-purpose block-quotes xxxxx
010/pop/103/003 -- you can get a blockquote like this.
010/bce/104/004 -- : four score and seven years ago, our
010/pop/105/005 -- or like this:
010/bce/106/006 -- > four score and seven years ago, our
010/pop/107/007 -- you should note that the first method
---/---/108
011/hdr/109/001 -- chapter 8
011/hdr/110/002 -- footnotes and endnotes xxxxx
011/pop/111/003 -- your book can have footnotes.[3]
011/pop/112/004 -- for a footnote, place the footnote-referent in
011/pop/113/005 -- note that there must be _no_ white-space
011/pop/114/006 -- this is just a dummy paragraph,
011/pop/115/007 -- this is another dummy paragraph,
011/pop/116/008 -- this is a third dummy paragraph,
011/pop/117/009 -- and a fourth dummy paragraph,
011/pop/118/010 -- here's dummy paragraph #5,
011/pop/119/011 -- this is a sixth dummy paragraph,
011/pop/120/012 -- and the seventh dummy paragraph,
011/pop/121/013 -- here's dummy paragraph #8,
011/pop/122/014 -- i hope 9 dummy paragraphs is enough
011/pfn/123/015 -- [3] you can put the footnote right underneath
---/---/124
012/hdr/125/001 -- chapter 9
012/hdr/126/002 -- lists in your book xxxxx
012/pop/127/003 -- you can use '' * '' at the beginning of a gourd
012/bce/128/004 -- *
012/pop/129/005 -- as you can see in this example, every item
012/bce/130/006 -- ***
012/pop/131/007 -- you can also use '' o '' for a list, a tag that
012/bce/132/008 -- o mercury
012/pop/133/009 -- this list has an empty item at the end of it,
012/bce/134/010 -- ***
012/pop/135/011 -- you can also use '' + '' for a list you want
012/bce/136/012 -- + some
012/bce/137/013 -- ***
012/pop/138/014 -- and you can also use '' - '' to make a list,
012/bce/139/015 -- - mary's
012/bce/140/016 -- ***
012/pop/141/017 -- as you might imagine, you can combine
012/bce/142/018 -- * this is the first point at the first level
012/bce/143/019 -- ***
012/pop/144/020 -- you can also use '' = '' to create a list;
012/bce/145/021 -- = the
012/bce/146/022 -- ***
012/pop/147/023 -- finally, you can use '' x '' to make a list.
012/bce/148/024 -- x the
012/pop/149/025 -- the '' x '' prefix has _no_ bullet at all.
012/bce/150/026 -- ***
012/pop/151/027 -- sometimes you want a numbered list...
012/pop/152/028 -- here's an example of an unordered list
012/bce/153/029 -- x 1. one
012/bce/154/030 -- ***
012/pop/155/031 -- here's another "numbered list", again
012/bce/156/032 -- x 101. one
012/pop/157/033 -- that example seems kind of silly, yes,
012/bce/158/034 -- x 9800bc -- north america gets inhabited
012/bce/159/035 -- ***
012/pop/160/036 -- and finally, another numbered list, except
012/bce/161/037 -- # one
---/---/162
013/hdr/163/001 -- chapter 10
013/hdr/164/002 -- epigraphs and epitaphs xxxxx
013/bjr/165/003 -- _there's_ _an_ _old_ _proverb_
013/pop/166/004 -- sometimes a chapter starts with a nice pithy quote,
013/pop/167/005 -- so you wanna be able to handle that kind of thing.[5]
---/---/168
014/hdr/169/001 -- chapter 11
014/hdr/170/002 -- tables in your book xxxxx
014/pop/171/003 -- you can have tables in your book, simple ones.
014/bce/172/004 -- | table 1 column 1 column 2
014/bce/173/005 -- ***
014/pop/174/006 -- you can also use or-bars to separate the cells.
014/bce/175/007 -- | table 1 | column 1 | column 2
014/bce/176/008 -- ***
014/pop/177/009 -- you can even combine these two approaches,
014/bce/178/010 -- | table 1 | column 1 | column 2
---/---/179
015/hdr/180/001 -- chapter 12
015/hdr/181/002 -- the play is the thing xxxxx
015/pop/182/003 -- jaguar auto-bolds the first word of a paragraph
015/pin/183/004 -- dale: that's not what p.g. is all about.
015/pin/184/005 -- bowerbird: i think it's important to
015/pin/185/006 -- dale: that's your opinion.
015/pin/186/007 -- bowerbird: yes it is.
015/pin/187/008 -- steve: (weakly) i can't...
015/pin/188/009 -- dale: no it isn't.
015/pin/189/010 -- steve: (weakly) get a...
015/pin/190/011 -- bowerbird: is too.
015/pin/191/012 -- steve: (weakly) word in edgewise...
015/pin/192/013 -- dale: is not.
015/pin/193/014 -- lurkers: will you two cut it out?
015/pin/194/015 -- bowerbird: is so.
015/pin/195/016 -- dale: is not...
015/pop/196/017 -- fade to black.[6]
---/---/197
016/hdr/198/001 -- chapter 13
016/hdr/199/002 -- unlucky number 13 xxxxx
016/pop/200/003 -- there is no 13th floor in most buildings.
---/---/201
017/hdr/202/001 -- chapter 14
017/hdr/203/002 -- hyphens and dashes xxxxx
017/pop/204/003 -- use a double-dash -- like these here -- to get
017/pop/205/004 -- don't use a single-dash - like this bad example -
017/pop/206/005 -- even http://medium.com and http://kottke.org
---/---/207
018/hdr/208/001 -- chapter 15
018/hdr/209/002 -- hyphenation stinks xxxxx
018/pop/210/003 -- do not hyphenate your text. e-books don't need it.
---/---/211
019/hdr/212/001 -- chapter 16
019/hdr/213/002 -- two spaces after a sentence xxxxx
019/pop/214/003 -- many typesetters set a little bit of extra space
019/pop/215/004 -- now some people try to get this nicer look via
019/pop/216/005 -- so the best tactic to use these days is to put
---/---/217
020/hdr/218/001 -- chapter 17
020/hdr/219/002 -- preformatted text and code xxxxx
020/pop/220/003 -- sometimes you might have a need to present
020/pop/221/004 -- for these situations, you will use the ` backtick.
020/pop/222/005 -- inside a paragraph, or some other element,
020/pop/223/006 -- however, the backtick can also be used as
020/pop/224/007 -- while the '' ` '' can be used to start each line,
020/bce/225/008 -- `
020/pop/226/009 -- be aware that you can also add a note to
020/bce/227/010 -- ` // javascript document.ready function
---/---/228
021/hdr/229/001 -- chapter 18
021/hdr/230/002 -- the notes section xxxxx
021/pfn/231/003 -- [1] in later years, it was made clear that
021/pfn/232/004 -- [2] again, in later years, it was made clear
021/pfn/233/005 -- [3a] personally, i don't think we need to
021/pfn/234/006 -- [4] this is a test footnote. because of that,
021/pop/235/007 -- look, it even has a second paragraph!
021/pop/236/008 -- oh no! a third paragraph. way too long!
021/pfn/237/009 -- [5] this is another test footnote. but it will be short.
021/pfn/238/010 -- [6] you probably shouldn't mix footnotes and endnotes,
---/---/239
022/hdr/240/001 -- chapter 19
022/hdr/241/002 -- meta-data for this book xxxxx
022/pop/242/003 -- here's the meta-data...
022/bce/243/004 -- o title = a brief introduction to z.m.l.
---/---/244