{"id":405,"date":"2008-09-15T09:52:00","date_gmt":"2008-09-15T09:52:00","guid":{"rendered":"http:\/\/www.eprints.org\/uk\/index.php\/2008\/09\/15\/mechanically-derived-documents-versions\/"},"modified":"2015-10-20T16:14:43","modified_gmt":"2015-10-20T16:14:43","slug":"mechanically-derived-documents-versions","status":"publish","type":"post","link":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/2008\/09\/15\/mechanically-derived-documents-versions\/","title":{"rendered":"Mechanically derived documents (versions)"},"content":{"rendered":"<p>EPrints 3.1 has only just been released but work on 3.2 has been progressing for some months now.<\/p>\n<p>One EPrints feature that we&#8217;re improving in 3.2 is document thumbnails. First a bit of background: when you view the abstract (jump-off) page in EPrints each document will have either an icon or thumbnail shown. The thumbnail images are generated when a document is uploaded.<\/p>\n<p>Three thumbnails are generated as standard: &#8220;small&#8221;, &#8220;medium&#8221; and &#8220;preview&#8221;. The &#8220;small&#8221; thumbnail is used as a substitute for the format icon. The &#8220;medium&#8221; thumbnail isn&#8217;t used. The &#8220;preview&#8221; thumbnail is shown whenever the user hovers the mouse pointer over the icon\/thumbnail.<\/p>\n<p>Thumbnails are mechanically derived versions of the uploaded documents &#8211; they&#8217;re generated by a defined process with no user interaction. There is also a text version generated from each document that contains the terms used to index that document. In future we also want to provide video previews of uploaded videos (a youtube-style interface) and lightbox versions of powerpoints etc. Another requirement is the ability to deliver cover-paged versions of documents.<\/p>\n<p>To support a diverse set of derived documents we have implemented relationships between documents. In 3.2. when a thumbnail is generated it is actually a new document with &#8220;isVersionOf&#8221;, &#8220;isVolatileVersionOf&#8221; and &#8220;isThumbnailVersionOf&#8221; relations to the existing document. So, if you want the &#8220;small&#8221; thumbnail of a document, you query that document for it&#8217;s &#8220;hasSmallThumbnailVersion&#8221; relation. If a document is changed all of it&#8217;s &#8220;hasVolatileVersion&#8221; relations are removed and regenerated. (Before the expert reader gets too far ahead &#8230; relations aren&#8217;t implemented using a triple-store, they&#8217;re just the metadata fields that first appeared in 3.1)<\/p>\n<p>Now for every document the user uploads a multitude of derived documents will be created. To avoid overloading the user with these new documents, &#8220;volatile&#8221; documents (&#8220;isVolatileVersionOf&#8221;) are hidden.<\/p>\n<p>If the user uses the &#8220;conversion&#8221; tool during the upload stage converted documents become a &#8220;isVersionOf&#8221; the existing document. This will be used to improve the jump-off page by bundling different formats of the same document together.<\/p>\n<p>All of the mechanically derived documents in EPrints are generated by &#8220;Convert&#8221; plugins, enabling extensibility of the whole system.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>EPrints 3.1 has only just been released but work on 3.2 has been progressing for some months now. One EPrints feature that we&#8217;re improving in 3.2 is document thumbnails. First a bit of background: when you view the abstract (jump-off) page in EPrints each document will have either an icon or thumbnail shown. The thumbnail images are generated when a document is uploaded. Three thumbnails are generated as standard: &#8220;small&#8221;, &#8220;medium&#8221; and &#8220;preview&#8221;. The &#8220;small&#8221; thumbnail is used as a substitute for the format icon. The &#8220;medium&#8221; thumbnail isn&#8217;t used. The &#8220;preview&#8221; thumbnail is shown whenever the user hovers the mouse pointer over the icon\/thumbnail.<a class=\"more-link\" href=\"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/2008\/09\/15\/mechanically-derived-documents-versions\/\">Read More &rarr;<\/a><\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[1],"tags":[],"class_list":{"0":"entry","1":"post","2":"publish","3":"author-tdb","4":"post-405","6":"format-standard","7":"category-uncategorized"},"_links":{"self":[{"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/posts\/405","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/comments?post=405"}],"version-history":[{"count":1,"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/posts\/405\/revisions"}],"predecessor-version":[{"id":439,"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/posts\/405\/revisions\/439"}],"wp:attachment":[{"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/media?parent=405"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/categories?post=405"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/uk.eprints-hosting.org\/uk\/index.php\/wp-json\/wp\/v2\/tags?post=405"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}