We do have tools and documentation on the website, but I'll admit there is not explanation link on the download page. Here is a link to the TEI tools and documentation. http://pgtei.pglaf.org/marcello/0.4/ Josh

----- Original Message ----- From: "Brent Gueth" <creeva@gmail.com> To: "'Project Gutenberg Volunteer Discussion'" <gutvol-d@lists.pglaf.org> Subject: RE: [gutvol-d] another dose of reality Date: Wed, 29 Mar 2006 11:45:38 -0500

If it is supposed to be machine readable and the tools are not released with a method of quickly editing them or a description on how they are usable to the community, why are they posted on the web site. I would think this would lead to confusion to people that are privy to this mailing list and the inside discussion.

This isn't an argument for or against any format, but to have something customer facing (you don't sell anything but eyeballs are your customers and proof of the work you are doing) you should have a customer facing reason or explanation to have them there. Whether it be the TEI format or the ZML format or an XYZ format; there should be clear instructions of what the format is and how it is handled if it is launched on the site.

HTML, TXT, and PDF are considered ubiquitous in the internet age, but you have the plucker format and an explanation of what it is. I would also have assumed when the first plucker texts were launched there was an explanation of what the format is and hopefully the little html link next to the download explaining what it is was there at launch. To lessen doubt that consumers are missing something to view these texts there should be a link explaining what TEI is.

-----Original Message----- From: gutvol-d-bounces@lists.pglaf.org [mailto:gutvol-d-bounces@lists.pglaf.org] On Behalf Of Joshua Hutchinson Sent: Wednesday, March 29, 2006 11:42 AM To: Project Gutenberg Volunteer Discussion Subject: RE: [gutvol-d] another dose of reality

...

----- Original Message ----- From: "Brent Gueth" <creeva@gmail.com>

Now I'm not going to get in the middle of this on going feud, but what readers do we have for each format? The TEI formats are listed there but what do you use to read them so you do not see all the markup encoding. Firefox shows the markup when you open the file. Notepad shows the markup (to be expected). MS Word just crashes upon opening because it says that there are problems with the contents.

Good question, Brent.

The answer is that TEI is not really meant to be read by humans (just as HTML source code is not really meant to be read by humans).

The great thing about those TEI docs is that I only produced 1 file (the TEI document) and then a server automatically generated the ASCII, HTML and PDF formats. I didn't have to manually fiddle with multiple files.

The TEI file is a text file, so technically you CAN read it in Notepad (or any text editor of your choice) but it won't be all that pretty. Hopefully, the resulting files *from* it will be pretty, though.

The reason TEI is nice for this is that it provides a consistent markup method that is fairly easy for a computer to manipulate to "output" formats.

if you have any further questions, fire away. I'll be happy to try to answer them.

Josh _______________________________________________ gutvol-d mailing list gutvol-d@lists.pglaf.org http://lists.pglaf.org/listinfo.cgi/gutvol-d

_______________________________________________ gutvol-d mailing list gutvol-d@lists.pglaf.org http://lists.pglaf.org/listinfo.cgi/gutvol-d