MobileRead Forums - View Single Post - Tagging files to show up in the "Docs"-lists

NiLuJe · 05-14-2014, 06:41 PM

Yup, you got the same explanation as I just gave from the posts you linked (from Kovid, of course

), and summarised by wallcraft in the second link.

As I said, the fact that you filter for "Docs" doesn't directly impact collections, which is why you see the collection on the Homescreen. And inside that collection, no more filtering on the cdeType is done, which is why you see both EBOK & PDOC files (and yeah, you might have side loaded them, but I'm guessing they have an EBOK cdeType, so you'll have to check how you proceeded to set up Calibre if you intended for them to end up as PDOC

).

The Homescreen and the "Inside-a-collection" screen behave completely differently, and have different filtering capabilities/set of filters.

I agree that the usual given examples of using "[PDOC]" can be confusing. Personally, I prefix "special" tags (those used to make automagic stuff happens, like PDOC or Kindle Collections) with a "+", so that output setting is set to "+Doc" for me. If I ever tag a book with "+Doc" in Calibre, and then send it *over USB, via Calibre's "Send To Device"*, it will end up with a PDOC cdeType (and thus fall in the "Docs" filter of the *Homescreen*, and get the "Personal" banner on FW 5.X).

You don't need to do a conversion, and it won't actually change a thing, the change is applied to the metadata of the file during the "Send To Device" process (or a Save To Disk). (i.e. it only applies to the on-device file, or the exported file).

(And, again, if you keep testing stuff on the exact same book, keep the last paragraph of my previous post in mind: the Kindle catalog can sometime be tricky in its acceptance of changes to an existant file).

EDIT: If my mumbling about cdeType isn't clear, that's because I keep using the 'internal' naming of the file format itself, because the issue is so often mistreated/misunderstood that I prefer using 'exact' words, which happen to be keywords you can look for in the wiki, Calibre's source code, and the code of the various tools dealing with the Mobi/KF8 format, in particular its internal metadata.

So the cdeType field is what that output setting is controlling in Calibre, and what the Kindle's OS actually checks when it decides how to filter a book, and it if it should get a special banner or not.
EBOK is the default: this is both what you get when buying books from Amazon, and what you get with Calibre (when sent over USB from Calibre, with default settings).
PDOC is what you get when you get stuff via Amazon's various Personal documents-related services, and also what you get out of KindleGen. You can also get this with Calibre, if the aforementioned output setting is used correctly.

05-14-2014, 06:41 PM	#6
NiLuJe BLAM! Posts: 13,506 Karma: 26047202 Join Date: Jun 2010 Location: Paris, France Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E	Yup, you got the same explanation as I just gave from the posts you linked (from Kovid, of course ), and summarised by wallcraft in the second link. As I said, the fact that you filter for "Docs" doesn't directly impact collections, which is why you see the collection on the Homescreen. And inside that collection, no more filtering on the cdeType is done, which is why you see both EBOK & PDOC files (and yeah, you might have side loaded them, but I'm guessing they have an EBOK cdeType, so you'll have to check how you proceeded to set up Calibre if you intended for them to end up as PDOC ). The Homescreen and the "Inside-a-collection" screen behave completely differently, and have different filtering capabilities/set of filters. I agree that the usual given examples of using "[PDOC]" can be confusing. Personally, I prefix "special" tags (those used to make automagic stuff happens, like PDOC or Kindle Collections) with a "+", so that output setting is set to "+Doc" for me. If I ever tag a book with "+Doc" in Calibre, and then send it over USB, via Calibre's "Send To Device", it will end up with a PDOC cdeType (and thus fall in the "Docs" filter of the Homescreen, and get the "Personal" banner on FW 5.X). You don't need to do a conversion, and it won't actually change a thing, the change is applied to the metadata of the file during the "Send To Device" process (or a Save To Disk). (i.e. it only applies to the on-device file, or the exported file). (And, again, if you keep testing stuff on the exact same book, keep the last paragraph of my previous post in mind: the Kindle catalog can sometime be tricky in its acceptance of changes to an existant file). EDIT: If my mumbling about cdeType isn't clear, that's because I keep using the 'internal' naming of the file format itself, because the issue is so often mistreated/misunderstood that I prefer using 'exact' words, which happen to be keywords you can look for in the wiki, Calibre's source code, and the code of the various tools dealing with the Mobi/KF8 format, in particular its internal metadata. So the cdeType field is what that output setting is controlling in Calibre, and what the Kindle's OS actually checks when it decides how to filter a book, and it if it should get a special banner or not. EBOK is the default: this is both what you get when buying books from Amazon, and what you get with Calibre (when sent over USB from Calibre, with default settings). PDOC is what you get when you get stuff via Amazon's various Personal documents-related services, and also what you get out of KindleGen. You can also get this with Calibre, if the aforementioned output setting is used correctly. Last edited by NiLuJe; 05-14-2014 at 06:56 PM.