Help get this topic noticed by sharing it on Twitter, Facebook, or email.

Creating custom web publishing and print templates

With Delicious Library 3.1 we've made it easier than ever to create a custom template when publishing and printing your library. This is the place to post and share cool templates you've created with other Delicious Library users. Have questions? Delicious staff are here to help.
4 people like
this idea
+1
Reply
  • This is good to hear, obviously. But where do we find out how to do it? It certainly isn't obvious on any of the application's menus or the help "manual" on your web site, which is still not very useful at all. And a related general question...when is the "help manual" going to turn into something actually useful?

    I did see a fleeting reference to a link about templates during the upgrade process to the latest version, but that's long gone and not accessible anymore.

    So what's a user to do? Frankly, you guys don't make stuff like this easy to find, at least in my experience.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • Some updated documentation would be nice. The reference in the online docs is paltry, and the docs from within the app still don't even load.

    Also, the release notes on the website not been updated since 3.0. They are in the installer, but you can't reference them after the fact. Can't someone post them to the site upon releases?

    It'd be nice to have a blog post upon releases too that actually explains the new features, as the release notes don't ever have enough detail on how things actually work.

    Thanks.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • This reply was removed on 2013-06-26.
    see the change log
  • 1
    "1. First, download the "

    Download what????

    And
    "... check if Console shows any errors..."
    "... documentation (what's not obvious)..." Ummm, there isn't any!

    Good to see some effort being made in this area, but is this really ready for release?
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • 1
    Getting Started: (with a fixed link!)


    1. First, download the example template.


    2. In the publishing view, can right-click (or control-click) the template list, choose "Open Templates Directory", and put the (unzipped) example template in there. As you edit the template's HTML file, Delicious Library's preview should update live. (If something's not working, check if Console shows any errors - we should improve that.)


    3. We're working on documentation; for the time being you can take a look at the built-in templates inside the Delicious Library 3.app package. Please share any feedback you have, both ideas for documentation (what's not obvious), and improvements we can make in the app.

  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • Some issues seen:

    1) images are exported double size (for retina) on publication and then resized in HTML (not very good for downloadable page weight e.g. 6Mb for 15 items is excessive) - images should be exported at the requested size

    2) image placeholders are being handled differently; the address book image is being replaced with the name of the file when exported, but cover images replaced with non-changeable HTML; these should be consistent preferably filename only and leave the HTML to the template designer

    3) dates are being exported differently, publish date as "MMM dd, YYYY" but purchase date as "dd MMM YYYY" - need to be able to add configuration for users to define how dates are exported.

    4) Shelf Navigation - is being replaced with predefined HTML - need to be able to define how this is shown within the template.

    5) as 4 but for breadcrumbs where appropriate

    6) the example template has an HTML5 footer element (faulty HTML at that), but that is being stripped by the publish process (non-HTML5 tidy process being used?)
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • Any progress in this area? Like the documentation you said you were working on a month ago?
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • UPDATE: Okay, it was opening but due to the size of the right pane, it was not visible and there was NO visible indication there were more templates.

    The UI really does need some loving and care, IMHPO (that P is for professional, I am a desktop and web developer though on the dark side in Windows).

    Original Message/Question:
    Open Templates Directory is not refreshing the Templates area. The new template is not being seen. Any suggestions?
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • It looks like the only way to output the list of items in a library is in a table (even though it's not really tabular data). It would be much better if there was some control over the HTML used to output the lists of items, such as putting them in just a div or unordered list for example.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • Upgraded to 3.1.2, and now can not even get to ANY templates. Has this been restored in 3.14, or whatever the latest release is?
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • Found it in 3.1.4, but can not find the three or four template names that are "built in" to DL. I also do not know HTML, so if someone can design me a template for BOOKS and tell me where to put it so DL can recognize it, that would be great. Alternately, describe how to make the template and save it for DL use.

    Items I need, in order, are Author, Series, No in Series, Title, Format, Edition
    Single line per book, either portrait or landscape layout.

    Thank you in advance.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • I found the templates in the Print dialog, but can not find anyway to print only the selected items. I clicked on the books icon, but when I printed all of the items in the library printed. How do you get only the items selected? Thanks
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • You need to put the selected items on a shelf and then select that shelf to print (using either drag/drop or Smart Shelf method).

    To print all your Books create a new Shelf (File>NewShelf) add rules ("Type" is "Book", plus any other rules you wish) and then sort the shelf into the final order you wish to generate for your printed list (by Author+Title, by Title only, Author+Series+Release Date, etc). Select the shelf and File>Print the select the template format. For 2170 books Pocket Reference (4 columns) will generate 16 pages, Pocket Reference -Tiny (8 columns) gives 5 pages and the older Two Columns format (with cover image) gives 99 pages. These 3 formats give Author, Title and the Year from the release date for each item.

    You can use the PDF option to Preview a select page or two before printing or you can choose to save the PDF file to your computer to print later. You even have the option to save an "Untitled" PDF directly to iTunes to view on your mobile device using iBooks or another app. The Two column version creates a large file but it is easy to view on a small screen. With the Pocket Reference you may need to zoom in a bit to view it (the font on Tiny would probably be unusable). PDFs in iBooks do have a text search option to help locate Authors or Titles in the file.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • just curious, if anyone create a simple author/creator, title type of template with easy to jump to creator name and/or title name? such a simple list template would have been extremely useful to browse library on cell phone while shopping :)
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • The method I described in the previous post is the easiest to create I have found to date. The Two Column template gives a Cover thumbnail plus Title, Author and Year of publication. The order of items is determined by how you pre-sorted your Smart Shelf so I find it easy to flip the pages or jump the the approximate area I want.

    In addition, iBooks DOES have a Search feature!!! So while I always pre-sort my books by Author + Title so I can scan through the PDF, if there are 2 Authors DL3 sorts by the first Author's name. I can now type either of the Author's names in the iBooks search and it will still find it. Or I can type all or part of the Title and iBooks search zeros in on what I need.

    You can't use the scanner or search by isbn or other fields because the data is somewhat limited and static, but I find it fully meets my needs.

    If you don't have an iPhone with free iTunes and iBooks you can still create a PDF and I'm sure you will be able to reference it in some other reader app compatible with your cell phone. Hopefully that reader app will also have a search feature, if not pre-sorting before printing will be vital.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • I’m excited
    This past summer, we found a really beautifully restored nine-drawer card catalogue in an antique store and had to bring it home. That's when I got serious about cataloguing our library, and after scanning our fiction shelves into DL3, I wanted to print 3 x 5 cards for each book.

    Thanks to some information above and on other areas of this site and others, I adapted the two-column template so I could print onto Avery printable index cards (Avery template #5388).

    To get started, control-click the Delicious Library application and select "Show Package Contents." Open the "Contents" folder, then "Resources," then "Templates."

    There you find a collection of seven folders containing the files for the built-in templates. The first folder, "collectionPrintStyle.libraryprinttemplate," has an HTML file in "collectionPrintStyle.libraryprinttemplate -> Contents -> Resources" called "index.libraryprint.html." That file has loads of good documentation on how DL3 handles templates.

    I copied the whole "collectionPrintStyle.libraryprinttemplate" folder, renamed it "cardPrintStyle.libraryprinttemplate," and started modifying.

    Since I wanted to print index cards, I got rid of a lot of the code because I didn't want anything to print outside of the cards. I'm no CSS wizard, so it was a lot of trial and error. I'd delete something I didn't think was necessary and see what happened. The results work for me, but the code might look yucky to professional developers.

    I'll paste the code I used below, but there are two other things you have to do to make DL3 treat your modified template just like the included templates, so read all the way to the end.

    First, the code that's in my "index.libraryprint.html" file (any comments that begin with "TEMPLATE WRITERS" are from Delicious Monster:

    <html>
    <head>
    <!-- This is my attempt at creating a template to print cards for my catalog. It is based on the two-column print template. I have removed anything I didn't need, including some of the original comments. -->
    <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
    <title>Card Catalog</title>
    </head>
    <body style="margin: 0; font-family:'Book Antiqua', serif; font-weight: normal; font-size: 8pt; color: #404040;">
    <!-- TEMPLATE WRITERS: 'class="mediasizingcontainer"' tells Delicious Library what element to check for the vertical sizing when adding rows; we keep stamping out 'medium' elements (see below) until this element overflows vertically, so we can always add the right number of rows for any page size / orientation. -->
    <div class="mediasizingcontainer" style="position: absolute; top:0; bottom: 0; left: 0; right: 0; margin: 0; padding: 0; overflow:hidden;">
    <div style="clear: both; position: relative; padding: 0; white-space: nowrap; overflow:hidden;">
    <!-- page header; this just creates 74px of white space at the top of the template -->
    <div style="height: 74px;">
    </div>
    <!-- medium template -->
    <!-- TEMPLATE WRITERS: 'class="medium"' tells Delicious Library to stamp out one of these for each row in a column that is created... there should be exactly one element of this type or printing won't work at all! -->
    <div class="medium" style="height: 215px; overflow:hidden; text-align: left; padding: 1; margin-bottom: 0; width: 59%; margin-left:auto; margin-right:auto; font-weight: bold;">
    <div style="float: left; width: 48px; margin-left: 3pt; margin-right: 3pt; vertical-align: center;">$coverImage48</div>
    <div style="overflow: hidden; text-overflow: ellipsis; white-space: nowrap; margin-bottom: 0; font-size: 8pt;font-weight:bold;">$title</div>
    <div style="overflow: hidden; text-overflow: ellipsis; white-space: nowrap; margin-bottom: 0; font-size: 8pt;">$creatorsCompositeString</div>
    <div style="overflow: hidden; text-overflow: ellipsis; white-space: nowrap; margin-bottom: 0; font-size: 8pt;">$publishersCompositeString, $publishYearString</div>
    <div style="overflow: hidden; text-overflow: ellipsis; white-space: normal; margin-bottom: 0; font-size: 8pt;">$pages pages</div>
    <div style="overflow: hidden; text-overflow: ellipsis; white-space: normal; margin-top: 10pt;margin-bottom: 0; margin-left: 43pt; font-size: 8pt;">Subjects: $notes</div>
    <div style="clear: both; height: 0"></div>
    </div>
    <!-- end of medium template -->

    </div>
    </div>
    </div><!-- End .mediasizingcontainer -->
    </body>
    </html>


    Now go to "Contents -> Resources -> Base.lproj" and open the Template.strings file in TextEdit. Change it so DL3 will display the name you choose for your template. Mine is "3x5 Index Cards."

    Finally, save PDF of the results of your new template as "thumbnail.pdf" and copy it to "yourNewPrintStyle.librarytemplate -> Contents -> Resources" and replace the one that's already there.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • So does anyone have any custom templates they'd like to share?
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • Any way to get a list of all the fields (to be used in a template? As in cover type, edition, etc. Looking in the various "built in" templates, I don't see one that shows all the data, except possibly as a combined string, and I want to use individual items.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • It's pretty sad that 3 years later, there's still no documentation on creating templates, or any additional templates available for web export.

    The two included are relics from DL 2 still.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • a list of fields that can be included was added as part of the container as per the latest release notes. But your point still stands and many/all of the limitations itemised initially still stand also

    Contents/Resources/Templates/README - List Of Fields.txt ->

    actorsCompositeString
    amazonLastLookupDate
    amazonLastPricesLookupDate
    amazonLastSynopsesLookupDate
    amazonProductGroup
    asin
    associatedURL
    audienceRecommendedAgeSingularString
    boxHeightInInches
    boxLengthInInches
    boxWeightInPounds
    boxWidthInInches
    buyPrice
    cinematographersCompositeString
    composersCompositeString
    conditionSingularString
    conductorsCompositeString
    countryCode
    coverImageColorsCompositeString
    coverImageDominantColorRGBA
    coverImageEdgeDominantColorRGBA
    coverImageIsCustom
    coverImageLargeURLString
    coverImageLargestHeightInPixels
    coverImageLargestWidthInPixels
    coverImageMediumURLString
    coverImageNormalizedAreaOfInterestData
    coverImageNormalizedCornerRadiusLowerLeft
    coverImageNormalizedCornerRadiusLowerRight
    coverImageNormalizedCornerRadiusUpperLeft
    coverImageNormalizedCornerRadiusUpperRight
    coverImageSmallURLString
    coverImageTinyImageData
    coverImageUserSpecifiedTrapezoidData
    creationDate
    creationFetchKeyName
    creationFetchingError
    creatorsCompositeString
    currentValue
    customAttributesDictionary
    deweyDecimal
    ean
    editionsCompositeString
    explicitPhysicalFormat
    featuresCompositeString
    foreignUUIDString
    formatSingularString
    genresCompositeString
    hasExperienced
    illustratorsCompositeString
    isSigned
    isbn
    key
    languagesCompositeString
    lastModificationDate
    libraryOfCongressCallNumber
    locationSingularString
    maximumPlayers
    minimumPlayers
    minutes
    netRating
    networkDictionaryData
    notes
    numberInSeries
    numberOfMedia
    ownerSingularString
    pages
    platformsCompositeString
    price
    privateCollection
    publishDate
    publishersCompositeString
    purchaseDate
    rare
    rating
    screenwritersCompositeString
    serialNumber
    seriesSingularString
    subtitle
    theatricalDate
    title
    tracksCompositeString
    type
    used
    uuidString
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • I'm kind of over it. I've only ever been interested in the Web export to have a list available on the go.

    I've now bought and migrated my Movie and TV collections to the MyMovies app.

    I'll maintain both it and DL for a while to see how they shake out with their next versions, but MyMovies has an iOS app and even a new Apple TV app. It also handles Box Sets. All of which puts it light years ahead of DL now for my needs.

    Sure it's Mac App doesn't have nearly the polish or the fancy 3D display that DL has, but it's far more useful for me at this point, and it's only at v1. I have high expectations for its 2.0 Mac app given how polished it's new iOs release is.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • There you find a collection of seven folders containing the files for the built-in templates. The first folder, "collectionPrintStyle.libraryprinttemplate," has an HTML file in "collectionPrintStyle.libraryprinttemplate -> Contents -> Resources" called "index.libraryprint.html." That file has loads of good documentation on how DL3 handles templates. http://printablecalendartemplates.com... I copied the whole "collectionPrintStyle.libraryprinttemplate" folder, renamed it "cardPrintStyle.libraryprinttemplate," and started modifying.

    Since I wanted to print index cards, http://printablecalendartemplates.com/ I got rid of a lot of the code because I didn't want anything to print outside of the cards. I'm no CSS wizard, so it was a lot of trial and error. I'd delete something I didn't think was necessary and see what happened. The results work for me, but the code might look yucky to professional developers
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • DATES do not print correctly..always 1 off from real date, unless you print single book per page then it prints today's date
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated

  • It is 2018 and there is still no documentation. Furthermore, the example from Stu Wilson (6 years ago) does not work. I put it in the template folder, unzipped, as instructed, but it never shows up in the template list.
  • (some HTML allowed)
    How does this make you feel?
    Add Image
    I'm

    e.g. kidding, amused, unsure, silly happy, confident, thankful, excited indifferent, undecided, unconcerned sad, anxious, confused, frustrated