{"id":100,"date":"2021-03-15T13:16:02","date_gmt":"2021-03-15T13:16:02","guid":{"rendered":"https:\/\/openbook.ums.edu.my\/userguide\/chapter\/adding-relevant-metadata-for-directory\/"},"modified":"2024-09-19T04:19:25","modified_gmt":"2024-09-19T04:19:25","slug":"adding-relevant-metadata-for-directory","status":"publish","type":"chapter","link":"https:\/\/openbook.ums.edu.my\/userguide\/chapter\/adding-relevant-metadata-for-directory\/","title":{"raw":"Add Relevant Metadata","rendered":"Add Relevant Metadata"},"content":{"raw":"Pressbooks makes it simple to fill out your book\u2019s metadata. Having complete metadata not only helps readers find your book, it tells them what your book is about. Without it, your book may be harder to find in search results and its entry in <a href=\"https:\/\/pressbooks.directory\/\">Pressbooks Directory<\/a> may be bare and incomplete. This short video tutorial summarizes our recommendations for authors who want to ensure their book is easy for others to find and use:\n\nhttps:\/\/www.youtube.com\/watch?v=PLVYjqnl8fw\n<h1>Improving Directory Metadata<\/h1>\nHere's a sample book card from the Directory for a book that lacks relevant metadata (book info):\n\n[caption id=\"attachment_334\" align=\"alignnone\" width=\"719\"]<img class=\"wp-image-326 \" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2014\/03\/Screen-Shot-2021-03-18-at-2.54.46-PM.png\" alt=\"A book without much metadata\" width=\"719\" height=\"339\"> A book without much metadata[\/caption]\n\nThe example shown above doesn't include much apart from its title to help a visitor know whether they might be interested to read, adopt, or adapt that book for their own needs. To improve your book\u2019s metadata on your network and in Pressbooks Directory, we recommend that you log into the Pressbooks dashboard and select <em>Book Info<\/em> from the main menu, then enter the relevant values for the following fields:\n\n1. An author\/editor. You may need to begin by <a href=\"https:\/\/pressbooks.pub\/guide\/chapter\/book-info\/#Contributors\">creating new contributors<\/a> for each of the people you wish to credit as authors, editors, reviewers, contributors, etc.\n\n<img class=\"size-full wp-image-327 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-7.47.09-PM.png\" alt=\"The author field\" width=\"605\" height=\"125\">\n\n2. A Creative Commons license that grants others permission to share derivative works (this tool can help you choose an appropriate license: <a href=\"https:\/\/chooser-beta.creativecommons.org\/\">https:\/\/chooser-beta.creativecommons.org\/<\/a>).\n\n<img class=\"size-full wp-image-328 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-8.07.35-PM.png\" alt=\"Creative Commons license\" width=\"431\" height=\"326\">\n\n3. A cover image with 1:1.5 ratio dimensions.\n\n<img class=\"size-full wp-image-329 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-7.54.38-PM.png\" alt=\"Adding a cover\" width=\"229\" height=\"217\">\n\n4. A relevant subject. Pressbooks uses <a href=\"https:\/\/www.editeur.org\/151\/thema\"><em>Thema<\/em><\/a>, an subject category scheme designed for the international book trade, to help authors and publishers categorize their books. To help you select the appropriate subject(s) for your book, you may wish to consult\u00a0<em>Thema<\/em>'s <a href=\"https:\/\/www.editeur.org\/files\/Thema\/20200619%20Thema%20v1.4%20Basic%20instructions.pdf\">instructions<\/a> or interactive <a href=\"https:\/\/ns.editeur.org\/thema\/en\">subject taxonomy tool<\/a>.\n\n<img class=\"size-full wp-image-330 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-7.59.07-PM.png\" alt=\"Choosing a subject\" width=\"428\" height=\"357\">\n\n5. The correct language of the book. You should select the language your book is primarily written in.\n\n<img class=\"size-full wp-image-331 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-8.00.18-PM.png\" alt=\"Choosing a language\" width=\"429\" height=\"89\">\n\n6. A long and\/or short description. Include at least a few sentences describing what your book is about and what readers can expect to learn from it. The Directory will display the long description when it exists, and fall back to the book's short description if no long description has been entered.\n\n<img class=\"size-full wp-image-332 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-8.04.05-PM.png\" alt=\"Long and short descriptions\" width=\"937\" height=\"362\">\n\n7. A publisher (optional), if relevant to your book. After you have added or revised your metadata with the relevant values, make sure you click 'Save' in the 'Save Book Information' on the book info page.\n\n<img class=\"alignnone wp-image-333 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screenshot-from-2021-03-26-07-44-31.png\" alt=\"Publisher and Save Book Information options in Pressbooks Book Info page\" width=\"855\" height=\"190\">\n\nOnce you have completed these metadata updates, the information will be synced to the Directory within an hour. In contrast with the book example shown at the beginning of this guide chapter, a book will metadata entered will appear in the Directory like the following:\n\n[caption id=\"attachment_334\" align=\"alignnone\" width=\"874\"]<img class=\"wp-image-334 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-8.26.40-PM-new.png\" alt=\"Book card with metadata\" width=\"874\" height=\"447\"> A sample Pressbooks Directory book card with relevant metadata[\/caption]","rendered":"<p>Pressbooks makes it simple to fill out your book\u2019s metadata. Having complete metadata not only helps readers find your book, it tells them what your book is about. Without it, your book may be harder to find in search results and its entry in <a href=\"https:\/\/pressbooks.directory\/\">Pressbooks Directory<\/a> may be bare and incomplete. This short video tutorial summarizes our recommendations for authors who want to ensure their book is easy for others to find and use:<\/p>\n<p><iframe loading=\"lazy\" id=\"oembed-1\" title=\"Adding OER Metadata with Pressbooks\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/PLVYjqnl8fw?feature=oembed&#38;rel=0\" frameborder=\"0\" allowfullscreen=\"allowfullscreen\"><\/iframe><\/p>\n<h1>Improving Directory Metadata<\/h1>\n<p>Here&#8217;s a sample book card from the Directory for a book that lacks relevant metadata (book info):<\/p>\n<figure id=\"attachment_334\" aria-describedby=\"caption-attachment-334\" style=\"width: 719px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-326\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2014\/03\/Screen-Shot-2021-03-18-at-2.54.46-PM.png\" alt=\"A book without much metadata\" width=\"719\" height=\"339\" \/><figcaption id=\"caption-attachment-334\" class=\"wp-caption-text\">A book without much metadata<\/figcaption><\/figure>\n<p>The example shown above doesn&#8217;t include much apart from its title to help a visitor know whether they might be interested to read, adopt, or adapt that book for their own needs. To improve your book\u2019s metadata on your network and in Pressbooks Directory, we recommend that you log into the Pressbooks dashboard and select <em>Book Info<\/em> from the main menu, then enter the relevant values for the following fields:<\/p>\n<p>1. An author\/editor. You may need to begin by <a href=\"https:\/\/pressbooks.pub\/guide\/chapter\/book-info\/#Contributors\">creating new contributors<\/a> for each of the people you wish to credit as authors, editors, reviewers, contributors, etc.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-327 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-7.47.09-PM.png\" alt=\"The author field\" width=\"605\" height=\"125\" \/><\/p>\n<p>2. A Creative Commons license that grants others permission to share derivative works (this tool can help you choose an appropriate license: <a href=\"https:\/\/chooser-beta.creativecommons.org\/\">https:\/\/chooser-beta.creativecommons.org\/<\/a>).<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-328 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-8.07.35-PM.png\" alt=\"Creative Commons license\" width=\"431\" height=\"326\" \/><\/p>\n<p>3. A cover image with 1:1.5 ratio dimensions.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-329 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-7.54.38-PM.png\" alt=\"Adding a cover\" width=\"229\" height=\"217\" \/><\/p>\n<p>4. A relevant subject. Pressbooks uses <a href=\"https:\/\/www.editeur.org\/151\/thema\"><em>Thema<\/em><\/a>, an subject category scheme designed for the international book trade, to help authors and publishers categorize their books. To help you select the appropriate subject(s) for your book, you may wish to consult\u00a0<em>Thema<\/em>&#8216;s <a href=\"https:\/\/www.editeur.org\/files\/Thema\/20200619%20Thema%20v1.4%20Basic%20instructions.pdf\">instructions<\/a> or interactive <a href=\"https:\/\/ns.editeur.org\/thema\/en\">subject taxonomy tool<\/a>.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-330 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-7.59.07-PM.png\" alt=\"Choosing a subject\" width=\"428\" height=\"357\" \/><\/p>\n<p>5. The correct language of the book. You should select the language your book is primarily written in.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-331 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-8.00.18-PM.png\" alt=\"Choosing a language\" width=\"429\" height=\"89\" \/><\/p>\n<p>6. A long and\/or short description. Include at least a few sentences describing what your book is about and what readers can expect to learn from it. The Directory will display the long description when it exists, and fall back to the book&#8217;s short description if no long description has been entered.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-332 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-8.04.05-PM.png\" alt=\"Long and short descriptions\" width=\"937\" height=\"362\" \/><\/p>\n<p>7. A publisher (optional), if relevant to your book. After you have added or revised your metadata with the relevant values, make sure you click &#8216;Save&#8217; in the &#8216;Save Book Information&#8217; on the book info page.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-333 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screenshot-from-2021-03-26-07-44-31.png\" alt=\"Publisher and Save Book Information options in Pressbooks Book Info page\" width=\"855\" height=\"190\" \/><\/p>\n<p>Once you have completed these metadata updates, the information will be synced to the Directory within an hour. In contrast with the book example shown at the beginning of this guide chapter, a book will metadata entered will appear in the Directory like the following:<\/p>\n<figure id=\"attachment_334\" aria-describedby=\"caption-attachment-334\" style=\"width: 874px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-334 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screen-Shot-2021-03-24-at-8.26.40-PM-new.png\" alt=\"Book card with metadata\" width=\"874\" height=\"447\" \/><figcaption id=\"caption-attachment-334\" class=\"wp-caption-text\">A sample Pressbooks Directory book card with relevant metadata<\/figcaption><\/figure>\n","protected":false},"author":1,"menu_order":24,"template":"","meta":{"pb_show_title":"","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"chapter-type":[],"contributor":[],"license":[],"class_list":["post-100","chapter","type-chapter","status-publish","hentry"],"part":53,"_links":{"self":[{"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/pressbooks\/v2\/chapters\/100","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/pressbooks\/v2\/chapters\/100\/revisions"}],"predecessor-version":[{"id":101,"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/pressbooks\/v2\/chapters\/100\/revisions\/101"}],"part":[{"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/pressbooks\/v2\/parts\/53"}],"metadata":[{"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/pressbooks\/v2\/chapters\/100\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/wp\/v2\/media?parent=100"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/pressbooks\/v2\/chapter-type?post=100"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/wp\/v2\/contributor?post=100"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/openbook.ums.edu.my\/userguide\/wp-json\/wp\/v2\/license?post=100"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}