View Single Post
Old 12-26-2009, 06:32 PM   #4
rogue_ronin
Banned
rogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-books
 
Posts: 475
Karma: 796
Join Date: Sep 2008
Location: Honolulu
Device: Nokia 770 (fbreader)
Kevin --

It's great to be able to comm with you. You've answered a bunch of questions, and of course I have more.

The 2008 document is an unreadable mess, full of jargon and ridiculous assumptions. Glad to hear about your use of the 2003 document, and your somewhat "hybridized" approach to solving the problem.

Beyond the DC, you seem to be supporting basic tags that you can assume folks might have: Publisher, Author, Editor, etc. Is that right? What tags are you supporting? I use my own set, that work specifically with my macro library and are automatically updated, but may not be universal enough -- example:

Code:
	<!-- BEGIN: EBOOK META INFORMATION -->

	<meta name="FileName" content="BookTitle.html" />
	<meta name="FileID" content="xBook_00000099" />
	<meta name="FileCreationDate" content="2009-12-09" />
	<meta name="FileVersion" content="0.10" />
	<meta name="FileRevisionDate" content="2009-12-09" />
	<meta name="FileSource" content="Found Web Text" />
	<meta name="FileScanner" content="Unknown" />
	<meta name="FileProofer" content="FoundText" />
	<meta name="FileComment" content="Created with xBook NoteTab Clip Library" />

	<meta name="Title" content="Book Title" />
	<meta name="SubTitle" content="Subtitle" />
	<meta name="Series" content="Examples" />
	<meta name="SeriesNumber" content="16" />

	<meta name="Author" content="First·Middle·LastName·" />
	<meta name="Illustrator" content="First·Middle·LastName·" />
	<meta name="Editor" content="First·Middle·LastName·" />
	<meta name="CoverDesigner" content="Name" />

	<meta name="Genre" content="Howto" />
	<meta name="ISBN" content="123456789X" />
	<meta name="Language" content="en" />
	<meta name="Description" content="An example document for discussing metadata." />
	<meta name="Keywords" content="metadata,example" />

	<meta name="Publisher" content="FoundText" />
	<meta name="PublicationDate" content="2009-12" />
	<meta name="PublicationCity" content="Honolulu" />

	<meta name="CopyrightHolder" content="none" />
	<meta name="CopyrightDate" content="none" />
	<meta name="CopyrightLicense" content="Public Domain" />

	<!-- END: EBOOK META INFORMATION -->
Which of these would you catch with Sigil?

Now, even if you catch some of it, I don't expect to be able to use it as is. I've already explored some changes:

Code:
	<!-- BEGIN: EBOOK META INFORMATION -->

	<meta name="FileName" content="BookTitle.html" />
	<meta name="DC.identifier" scheme="xBook" content="xBook_00000099" />
	<meta name="DC.date.created" content="2009-12-09" />
	<meta name="FileVersion" content="0.10" />
	<meta name="DC.date.modified" content="2009-12-09" />
	<meta name="DC.source" content="Found Web Text" />
	<meta name="FileScanner" content="Unknown" />
	<meta name="DC.contributor.pfr" content="FoundText" />
	<meta name="FileComment" content="Created with xBook NoteTab Clip Library" />

	<meta name="DC.title" content="Book Title" />
	<meta name="SubTitle" content="Subtitle" />
	<meta name="Series" content="Examples" />
	<meta name="SeriesNumber" content="16" />

	<meta name="DC.creator.aut" content="First·Middle·LastName·" />
	<meta name="DC.contributor.ill" content="First·Middle·LastName·" />
	<meta name="DC.contributor.edt" content="First·Middle·LastName·" />
	<meta name="DC.contributor.cov" content="Name" />

	<meta name="DC.type" content="Howto" />
	<meta name="DC.identifier" scheme="ISBN" content="123456789X" />
	<meta name="DC.language" content="en" />
	<meta name="DC.description" content="An example document for discussing metadata." />
	<meta name="DC.subject" content="metadata,example" />

	<meta name="DC.publisher" content="FoundText" />
	<meta name="DC.date.published" content="2009-12" />
	<meta name="PublicationCity" content="Honolulu" />

	<meta name="CopyrightHolder" content="none" />
	<meta name="DC.date.copyrighted" content="none" />
	<meta name="DC.rights" content="Public Domain" />

	<!-- END: EBOOK META INFORMATION -->
Which should mostly work with Sigil, right? The only meta-conflict I can see is DC.date.copyrighted which is not mentioned in the DC-HTML docs, but seems useful to me.

The name layout also might not be good -- I use an explicit marker for separating out first-middle-last. I do this so that I can generate names in the format LastName, First Middle or (as my macro library does file management) to create folders named LastName_First_Middle. How do you support the "file-as" attribute of the ePub spec?

I'm also of a mind that versioning info might be good. You'll note that I keep info about the file itself, and info about the document contents, somewhat distinguished. May not suit Sigil though...

What do you think about something like:

Code:
<meta name="DC.relation.series" content="Examples" />
<meta name="DC.relation.series.number" content="16" />
or

Code:
<meta name="DC.title.sub" content="Subtitle" />
?

The two DC terms that you don't say you support are: Language, and Source. Would you consider them? Or are they unnecessary?

Also, you wrote:
Quote:
ID (must be one of DOI, ISBN, ISSN, or CustomID)
What is CustomID? Would my scheme="xBook" be okay?

And finally, the namespace can be either DC or DCTERMS, correct?

Hope that's not too much, thanks!

m a r

Last edited by rogue_ronin; 12-26-2009 at 06:46 PM.
rogue_ronin is offline   Reply With Quote