a document containing the
full range of features found
in project gutenberg e-texts
by bowerbird intelligentleman
greetings, earthling...
this is a test-suite created for
e-texts from project gutenberg,
a 40-year-old volunteer effort to
put public-domain literature online.
please go visit their web-site for
the latest news and information on
usage conditions for their e-texts,
volunteering for them, and more...
http://www.gutenberg.org
you can “view source” for this document here:
http://zenmagiclove.com/test-suite-2012.zml
a 2012 test-suite for project gutenberg
table of contents
dedication
chapter 1--welcome aboard
chapter 2--the sections of the book
chapter 3--text “styling”
chapter 4--plain ascii versus unicode
chapter 5--poetry and other silly things
chapter 6--tables
chapter 7--centered text
chapter 8--pictures in your book
chapter 9--footnotes and endnotes
chapter 10--hotlinks
chapter 11--hyphens and dashes
chapter 12--hyphenation stinks
chapter 13--unlucky 13
chapter 14--two spaces after a sentence
chapter 15--multi-purpose block-quotes
chapter 16--the play is the thing
chapter 17--epigraphs and epitaphs
chapter 18--lists in your book
a subsection of chapter 18
another subsection of chapter 18
chapter 19--the meta-data chapter
chapter 20--zen markup language
chapter 21--the end
the notes section
meta-data
to michael hart
for his bold vision
and his persistence
welcome!
this is a document intended to demonstratethe range of features common throughoutthe e-texts in the project gutenberg library,and indeed to the majority of printed books.
project gutenberg is a volunteer effort fordigitizing the text of public-domain books,for viewing and distribution in cyberspace.
http://www.gutenberg.org
it was begun by michael hart back in 1971,with the goal of creating 10,000 e-texts,a milestone achieved in 2003, thanks toa big boost from distributed proofreaders,which allows people to proofread online—thousands of them doing a page at a time,volunteering bits and pieces of their time.
http://www.pgdp.net
if you want to support the p.g. librarywith software, a markup system, or so on,you should be able to handle its features,and you can use this file as a “test-suite”to verify that your system is fully capable.
this document should be self-explanatory.tabs have been substituted with “~tab~”,so that they will become visible to you, sothey could be changed back for your testing.other than that, no changes should be needed.
if you find inconsistencies in this test-suite,do please let me know immediately. thank you.
first, you should be able to handleheadings of different levels, such asthe book, chapters, and subsections.
you may label the levels as you like.
html can support 6 different levels,so that's a good number to shoot for.
one of the things that users find handyis a table of contents for the e-book,so you must be capable of generating one,in cases where an e-text doesn't have one.
because of their experience with the web,people often expect this table of contentsto be hotlinked to the appropriate sections,so your markup system should facilitate that.a nice touch is then to have chapter headingsthen link back to the table of contents...
project gutenberg was born a very long time ago,before word-processors and personal computers...a rumor is that michael used a keypunch machine(it's ok if you're too young to know what that is)to enter a good number of the original e-texts...
computers didn't even have lowercase charactersin the early days, so the whole book was capitalized!luckily, before long we got lowercase characters.
but still, “luxuries” like italicized and bold textwere not possible, so michael developed a conventionwhere a word that was bold or italics in the originalwas entered in all-uppercase, to show that emphasis.
because the e-texts are stored as raw ascii text,that convention lives on, to this day, in some files.by this time, however, we need to be able to handlestyled text, so your systems must be able to do so.
most english e-texts in the library can berepresented in the lower-ascii characters,but future e-texts are likely to requiresome unicode characters, so you shouldwithout question be able to handle unicode.
many of the e-texts contain poetry,or verse of some type, so your systemmust be able to handle silliness like that.
some poems want to be left-justified,so you should be able to handle that:
a haiku for you
(by bowerbird intelligentleman)
haiku have three lines
and seventeen syllables
five, seven, and five
other poems want to be centered instead:
t.v. will eat you
(by bowerbird intelligentleman)
t.v. will eat you
out of a satellite dish
with a tuning fork
and some poems want to alternate...
six spaces at the start of this line
12 spaces at the start of this line
six spaces at the start of this line
12 spaces at the start of this line
six spaces at the start of this line
12 spaces at the start of this line
six spaces at the start of this line
12 spaces at the start of this line
and some poems want to get fweaky!
six spaces at the start of this line
ten spaces at the start of this line
14 spaces at the start of this line
18 spaces at the start of this line
22 spaces at the start of this line
26 spaces at the start of this line
30 spaces at the start of this line
34 spaces at the start of this line
38 spaces at the start of this line
42 spaces at the start of this line
38 spaces at the start of this line
34 spaces at the start of this line
30 spaces at the start of this line
26 spaces at the start of this line
22 spaces at the start of this line
18 spaces at the start of this line
14 spaces at the start of this line
ten spaces at the start of this line
six spaces at the start of this line
in general, lines of a poem prefer to stay together,that is, to be kept all on a page whenever possible,so your system should attempt to accomplish that...
if it's not possible to keep the whole poem on a page,try to make the page-break occur between the verses...
there aren't a whole lot of tables in the e-texts—we're talking literature, not spreadsheets—but your system should handle tables anyway;not really big and hairy ones, just simple ones.
| . | column 1 | column 2 |
| plain-text | yes | yes |
| x.m.l. | no | yes |
| html | yes | no |
| .rtf | no | yes |
| no | no |
center me please!
sometimes, for one reason or another,some of an e-text's lines are centered.so your system should be able to do that.
center me as well, please!
most of the p.g. e-texts are text-only.but some of them do have pictures, soyour system must be able to show 'em.
http://z-m-l.com/go/alice/checking_watch.png
put a picture here,or maybe a buttonthat someone couldclick in order toview that picture...
http://z-m-l.com/go/alice/cat_fades.png
“what is theuse of a book,”thought alice,“without picturesor conversation?”
http://z-m-l.com/go/alice/alice_cramped.png
some of the e-texts have footnotes.[1]
your system must be able to handle them.how it might do that is up to you, captain.
http://z-m-l.com/go/alice/alice_holding.png
remember how, in chapter 2, we saidthat the table of contents should behot-linked to the appropriate spots?
that is one type of link you'll need.there are several other types as well.
your system should also be able tomake the jump to an internet site.most of the e-texts are quite old,so of course it's not like they havea bunch of internet url's in them;but every e-text will indeed containa link to project gutenberg's website,so you must be able to execute links...
quite often there are places in an e-textthat reference other parts of the e-text.in these cases, it's nice to have a hotlinkclose to (or on) that reference point thattransports the reader directly to the placethat is being referenced; it is convenient.your system should facilitate such linking,preferably making it happen automatically.
for instance, the beginning of this chapterhas a reference to chapter 2. if a readerclicked on those words— “chapter 2”—they should automatically go to chapter 2.
(and likewise with each of the referencesto “chapter 2” here in this paragraph too.)
i use a hyphen between “e” and “text” in “e-text”.not everyone does, but i think that it looks nicer.
a hyphen—as you know—differs from a dash.and you probably know that there are even two(and some people say more!) types of dashes...
the first - called an “en-dash” - is a narrow one.you will see these in a fair number of the e-texts.it's called an “en” dash because it was traditionallydefined as being exactly as wide as the letter “n”.(or, some say, as wide as a letter “n” is high,so you can take your pick between those choices.)
the second—called an “em-dash”—is wider, andyes, it's called that because it's as wide as an “m”,or so the story goes, according to some people...
generally, try to use an em-dash, not an en-dash...the en-dash looks too much like a hyphen, especiallywhen it is run into the words that are surrounding it.
now, the convention says that you should not havespaces on the sides of a dash. the convention is wrong.it looks much nicer if you put spaces around a dash.
perhaps even more importantly, the search capabilityof many programs is thrown off if you don't use spaces.
so are the re-margination routines in many programs, so—to avoid these problems—put spaces around dashes.
a problem arises, though, because there is no em-dash inthe lower-ascii codes. so you have to use a double-dash—like these here—for an em-dash. ok, problem solved.your system should be able to convert the double-dashinto a proper em-dash, if the user chooses that option.
hyphenation is another thing that messes up e-booksearch capabilities. e-books don't need hyphenation.so turn hyphenation off when you make an e-book.
there is no 13th floor in most buildings.
back in the old typewriter days, students wereinstructed to put two spaces after a sentence.
ever since wordprocessing, though, some peoplehave said two spaces are no longer required, thatit is an unnecessary leftover from earlier times.
those people were wrong. if you have one spaceafter a period, sentences run together too much.
but...
the thing is, it's actually a lot easier to edittext if you only have one space after a period...that way, you can do a search for two spaces,and that search should come up totally empty.
thus, to make life easier on the writers out there,your software should create the smidgen of spacenecessary to separate two sentences sufficiently.
so, if you're making an e-book, use just one space.
sometimes you want to quote a whole block of stufffrom someone. this is often called a “block-quote”.clever, the guy who came up with that name...
many of the project gutenberg e-texts containblock-quotes of one various type or another.
here's an example of a block-quote, a letter.
dear leslie,
how are you? i am fine.
the weather is nice here.
but i wish it was half
as beautiful as you are.
and i wish you were here.
love,
bowerbird
typically, block-quotes are indentedon both the left and right sides.
here's another block-quote, from a speech.
four score and seven years ago, our
forefathers set forth upon this continent
a new nation, conceived in liberty and
dedicated to the proposition that
all men[2] are created equal.
there are a number of different situationsthroughout the e-texts that might call forthis type of indentation. for now, we willjust subsume them all under “block-quote”;perhaps later we will see fit to break outa more finely-grained analysis, if we findany special cases merit their own class.
dale: that's not what p.g. is all about.
bowerbird: i think it's important togive people a good e-book experience.
dale: that's your opinion.
bowerbird: yes it is.
steve: (weakly) i can't...
dale: no it isn't.
steve: (weakly) get a...
bowerbird: is too.
steve: (weakly) word in edgewise...
dale: is not.
lurkers: will you two cut it out?
bowerbird: is so.
dale: is not...
fade to black.[3]
there are plays in the library. gotta be able to handle plays.dialog, instructions to actors, stage directions, that stuff...
there's an old proverb
that says just about
whatever you want it to...
— slashdot
sometimes a chapter starts with a nice pithy quote,which is usually italicized, and often right-justified.
so you wanna be able to handle that kind of thing.[4]
i like lists. here's a list:
gotta be able to handle lists...
sometimes you want a numbered list...
here's an example of a numbered list,with the number specifically included.
here's another numbered list, againwith the number specifically included,where we mix things up a bit...
here's another numbered list, exceptthis time it's an “ordered list”, whichmeans the browser does the numbering...
still gotta be able to handle lists...
here's another example of a list:
like poems, items in a list generally want tostick together on the same page, if possible.
still gotta be able to handle lists...
a lot of people think “meta-data”is important. i think they're fullof poop, but why not make 'em happy?
so give them their own section—call it the “meta-data section”—and then let them put whatevermakes 'em happy into that section.
you will find the meta-data sectiontoward the very end of this document,where it belongs, after the “real” data.
this test-suite document is a demonstrationof z.m.l.—“zen markup language”—a systemby which a set of simple formatting rules cantake the place of complicated markup languages.
this document is “marked up” in z.m.l. and willspring to life when displayed by a z.m.l.-viewer.
furthermore, a z.m.l.-viewer can perform all ofthe tasks necessary to implement the featuresthat this test-suite represents: the hot-linking,the styling, different layouts, tables, pictures,formatting for plays, the lists, the whole thing,without the difficulty of heavy markup languages.
we hope you've enjoyed this test-suite document.if you have any questions, feel free to ask them.
this is a draft, so please suggest improvements.and if you want to make your own test-suite, do!
sadly, michael hart passed away in 2011, so he isno longer with us. he's up in heaven now, wherethere are no typos, and every book is available...
but after he attained his 10,000 e-texts goal,michael got a new goal—a million e-texts!
maybe you can serve michael's memory, and say“thanks”, by helping to reach his new goal? :+)
http://www.gutenberg.org
have a nice day.
the end.
personally, i don't think we need tomake a distinction between footnotesand endnotes any more, i believe thatall the types of notes should be storedat the end of the file, like these notes,but i think the person should be able todisplay them at the point of referencein the actual body of the text. therefore,they are actually a sort of hybrid betweenfootnotes and endnotes, combining thestrengths and convenience of both types.
↩
in later years, it was made clear thatlincoln was referring to all “people”, andnot just men, that women are equally equal. ↩
this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on. ↩
look, it even has a second paragraph!this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on. ↩
oh no! a third paragraph. way too long!this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on.this is a test footnote. because of that,it's going to go on and on and on. ↩
here's the meta-data...
http://www.gutenberg.org
here's a test of some of the formatting commands.
left-justified
centered
right-justified
this just has one tab...
.
the next line of this paragraph contains a full 2.5 alphabets:abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyzabcdefghijklmand=the=last=line=is=here.
.
the next line of this paragraph is one letter shy of 2.5 alphabets:abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyzabcdefghijkland=the=last=line=is=here.
.
the next line of this paragraph contains two alphabets:abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyzand=the=last=line=is=here.
.
the next line of this paragraph contains 33 m's and w's:MMMMWMMMMWMMMMWMMMMWMMMMWMMMMWMMMabcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyzand=the=last=line=is=here.
.
the next line of this paragraph contains 40 m's and w's:MMMMWMMMMWMMMMWMMMMWMMMMWMMMMWMMMMWMMMMWand=the=last=line=is=here.
.
the next line of this paragraph will measure in at 40 ems:MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMabcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyzabcdefghijkland=the=last=line=is=here.
.
the next line of this paragraph will measure in at 41 ems:MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMabcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyzabcdefghijklmand=the=last=line=is=here.
.
http://www.google.com
http://zenmagiclove.com/test-suite-2012.txt
http://www.pgdp.net
http://z-m-l.com/go/alice/checking_watch.png
http://z-m-l.com/go/alice/cat_fades.png
http://z-m-l.com/go/alice/alice_cramped.png
http://z-m-l.com/go/alice/alice_holding.png
http://www.gutenberg.org
.
and now all of them in one paragraph:
http://www.google.com
http://zenmagiclove.com/test-suite-2012.txt
http://www.pgdp.net
http://z-m-l.com/go/alice/checking_watch.png
http://z-m-l.com/go/alice/cat_fades.png
http://z-m-l.com/go/alice/alice_cramped.png
http://z-m-l.com/go/alice/alice_holding.png
http://www.gutenberg.org
goodbye!