Add metadata editing UI for book

[kathi-fletcher]

Design: Add New Book with Metadata

Design for adding basic metadata at the time a new book is created.

Step 1. Add new book

Should be no change from existing implementation.

Step 2. Request title

• Change "OK" to "Next" on the title request, since we are going to request metadata before finishing.
• Change "What title would you like to use for this?" to "What title would you like to use for this book?"

Step 3. Save book

Save <title>.opf, <title>-nav.html, <title>-module1.html

I think their should be no changes from the existing implementation, except possibly adding part of the book title to module1's title so we don't end up with a bunch of module1's.

• Add book title to module 1.

Step 4. Request metadata

Mockup (View in Firefox): w-editor-33.html : Click on module title area to see dialog.

This is the same metadata collection dialog that will come up from various other interactions, but it has a couple of variations from the mockup when it comes from "Create new book".

To activate the metadata dialog so you can see all the parts, click on the module title, "Laws of Exponents" in orange on the editable area and choose "Yes, edit book information first". (Implementing module metadata will be described in a separate design doc.)

Variations from the mockup

• 1. Instead of "Save", use "Next" and forward to the tab to the right. About -> Authors, Authors -> Summary.
• 2. On the right most tab, "Summary", say "Save".

Notes relevant to all the tabs

• 1. The author can click on the tabs to move through them in addition to using the "Next" button.
• 2. If the author cancels, no new metadata will be saved, but the book will still be created since that happens after the title is entered.
• Cancel should have a confirmation since you could lose a lot of work. "Are you sure you want to cancel? The title, authors, and other information about this book will retain their previous values."

Tab 1: About

Mockup (View in Firefox): w-editor-33.html : Click on module title area to see dialog.

• Modal title done. "Edit the authors and other metadata on this book"
• Editable title area done. "Title (required): <title>" click to edit, highlights on hover
• Title color matches the book title color in the TOC.
• Implement subject and keywords entry. Comma, tab, or enter, should all separate entries. The entries should then work like gmail addresses, or the author ids on the connexions beta.
• Inside subject and keywords, do light gray italics instructions. This is not on the mockup. "Use comma, or tab to separate"
• Language : Use the list here - http://remix.oerpub.org/metadata .
• Google Analytics: If this could work like it does on remix, and have a check box that unfolds the value. google-analytics.png ga-unfolded.png
• License: Use the same values as in the image uploader. licenses.png
• Change "Save" to "Next", advance to next tab

Tab 2: Authors

Mockup (View in Firefox): w-editor-33.html : Click on module title area to see dialog.

• Implement authors, copyright holders, editors, and translators. Use the same entry mechanism as for subjects and keywords.
• Add help text within the author field. (See subjects and keywords)
• Add "Publisher (optional)" beneath "Copyright Holder" (these aren't in the mockup)
• Add "Illustrator (optional)" at the end (these aren't in the mockup)
• Change "Save" to "Next", advance to next tab

Tab 3: Summary

Mockup (View in Firefox): w-editor-33.html : Click on module title area to see dialog.

• Make sure can enter multiple paragraphs.
• Make entry box big enough to fill the tab reasonably.
• Make entry box stretchy.
• Implement mini-formatting toolbar for the summary is a separate issue : [https://github.com/Implement mini-toolbar for formatting the abstract/summary in the metadata #153](Issue 153)

Step 5.A Save metadata in the .opf file

• Use this format book-metadata-format
• As add things to the opf, test the editor and test the reader to make sure that they are still working.

Step 5.B Save metadata in the -nav.html file

• Use this format book-metadata-format, and
  this sample file sample nav
• As add things to the -nav, test the editor and test the reader to make sure that they are still working.

Step 6. Content saves should update the modified date in the metadata

ie. <meta properties="dcterms:modified">2013-12-19</meta>

• Update in the opf file.
• Update in the nav file.

[kathi-fletcher]

Testing : Once I finally untangled the dependencies, here are my initial findings on the book metadata.

The testbook I used was metadata-test-book

Opf file

• Don't want a new book to be "based on anything". <meta property="schema:isBasedOnUrl">http://github.com/oerpub/empty-book/content/empty-book.opf</meta>. If the repo the book is in is forked from somewhere, then this field should be set to the original repo.
• ID is empty: <dc:identifier id="uid"/> This should be the URL to the repo. We have this as the .opf file right now.
• When creating a new shelf, we need to the metadata editing widget to come up.

-Nav file

• Meta tags need closing. <meta itemprop="inLanguage" content="en">