pgc-www/templates/book/about.html.ep

77 lines
2.6 KiB
Plaintext

% layout 'default';
% title 'About';
<h1>About</h1>
<div class="verbiage">
<p>
Thanks to <a href="https://www.gutenberg.org/">Project
Gutenberg</a>, this is a site for looking through the book catalog
they generously provide. It's a personal project and is not
affiliated with Project Gutenberg. The site currently offers
<%= commify($book_count) %>
book records out of 68,670 in the catalog.
</p>
<p>
In its present form the site is a little bit of an
oversimplification. As presented here, each book has exactly one
"author", or more specifically one row in an "author" table. In
practise, an "author" is really a list of zero or
more <em>contributors</em> - authors, editors, illustrators etc. So
really the relationship between "book" and "author" is many-to-many
between "book" and "contributor". For simplicity, this site ignores
the distinction and pretends that a book has exactly one author. Books
with "excessive" numbers of contributors (more than 64 bytes' worth)
are excluded from this site. A future version might aim to represent
the book-contributor relationship more faithfully.
</p>
<p>
You might notice duplicate book titles, even for a given author. For
example, John Milton has "Paradise Lost" twice. In these cases, each
instance of the title has its own identifier in the PG catalog for
distinct editions or versions. Each book title shown on this site
links to its page on PG's site.
</p>
<p>
We keep the usual kind of web site logs that include your ip
address, user agent and the page you requested. We use a session
cookie so that you can change the number of records per page. We
don't use javascript, analytics, tracking, CDNs or other third-party
web services.
</p>
<h2 id="search-help">Searching</h2>
<p>
For either author or book, the search returns records that contain
your search string, regardless of case. So a search for books with a
title like "anna" will return "Anna Karenina" and "Tyburn Tree: Its
History and Annals", among others.
</p>
<p>
There is a variety of not-really authors in the catalog. Some books
have no author entry at all. For simplicity, these are represented
here as having the author named "[no author]" to make them easily
searchable.
</p>
<p>
I.e. to find books with no author, put the string "[no author]" into
the author field of the search form ("Author like" on the books page
or "Name like" on the authors page). Other non-authors are
"Anonymous" and "Unknown".
</p>
% if (config->{'email-address'}) {
<p>
Comments and questions are welcome at
<a href="mailto:<%= config->{'email-address'} %>"><%= config->{'email-name'} %></a>.
</p>
% }
</div>