Contents | Start | End | Previous: KB0329: Jutoh doesn't appear to save my changes | Next: KB0331: Why does Apple Books fail to open my Epub with a missing resource error?


KB0330: How do I eliminate a Lulu warning about meta@dtb:uid content?

See also: How do I resolve Lulu errors?

After submitting your Epub to Lulu, you may receive this message from Lulu even though Check passes without warnings:

WARNING: meta@dtb:uid content '9781483475714' should conform to unique-identifier in content.opf: '69059776-1fed-4c9d-9425-17b749094cfd' in OPS/toc.ncx

The problem may be that the project has two identifiers - an ISBN, and a UUID. Or there might be just an ISBN. Jutoh is using the first one it finds to provide the identifier in the NCX file.

You can see the identifiers if you click Edit on the toolbar, then in the Metadata page, click "..." next to Identifier. You'll see Identifier 1 and possibly Identifier 2 listed.

If you have two identifiers, including a UUID, then if you swap the order of these identifiers, Jutoh will use the UUID, and the Lulu warning will disappear. This means adding a new identifier to the end of the list of identifiers, and then deleting the first identifier:

  1. Click Add at the top of the "Editing Identifier" dialog (as shown via "..." as above) and then click Copy This.

  2. Click on Identifier 1, and click Delete.

  3. Click OK, then OK again and compile the Epub.

If you didn't have a UUID in the first place, only an ISBN specified, you can create one as follows:

  1. Edit your Epub configuration and copy the value of the Identifier property to the clipboard, e.g. with Ctrl+C. This will be a UUID.

  2. Go back to the Metadata and edit the Identifier again.

  3. Click Add and then Add UUID.

  4. Paste the UUID value into the Value field, and remove the urn:uuid: part.

  5. Change the ordering of the identifiers as above, so that the UUID comes first.

If you now use Book | Examine (F6) and click on toc.ncx, you should see that it reads something like this:

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE ncx PUBLIC "-//NISO//DTD ncx 2005-1//EN" "http://www.daisy.org/z3986/2005/ncx-2005-1.dtd">
<ncx xmlns="http://www.daisy.org/z3986/2005/ncx/"" xml:lang="en" version="2005-1">
    <head>
        <meta name="dtb:uid" content="69059776-1fed-4c9d-9425-17b749094cfd" />
        ...
so it's now using the UUID instead of the ISBN.

Note that these steps won't be necessary if you have left the the Identifier blank, since Jutoh will use the UUID from the current configuration and the Lulu warning won't be shown.


Contents | Start | End | Previous: KB0329: Jutoh doesn't appear to save my changes | Next: KB0331: Why does Apple Books fail to open my Epub with a missing resource error?