{"id":110,"date":"2016-11-18T22:12:04","date_gmt":"2016-11-18T22:12:04","guid":{"rendered":"http:\/\/www.publiconsulting.com\/wordpress\/eduguide\/chapter\/hypothesis\/"},"modified":"2018-01-21T18:45:06","modified_gmt":"2018-01-21T18:45:06","slug":"hypothesis","status":"publish","type":"chapter","link":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/chapter\/hypothesis\/","title":{"rendered":"Hypothesis for Webbook Annotation"},"content":{"raw":"\n<div class=\"textbox\">\n<p>Hypothesis is a powerful web annotation tool that many users deploy to use as a teaching tool with students or to enable: collaboration between authors and editors, personal note taking and annotation or engagement&nbsp;with readers. This chapter will cover:<\/p>\n<ul>\n<li>What is Hypothesis?<\/li>\n<li>How to enable Hypothesis on your webbook<\/li>\n<li>How to include and exclude specific chapters or sections&nbsp;from Hypothesis<\/li>\n<\/ul>\n<\/div>\n<h2>What is Hypothesis?<\/h2>\n<p><a href=\"http:\/\/hypothes.is\">Hypothesis<\/a>&nbsp;is a simple web annotation tool that allows readers to highlight and annotate webpages, enabling deeper engagement with content.&nbsp;While the tool is available as a browser extension that can be used on any webpage, Pressbooks allows you to&nbsp;build its capabilities into the pages of your webbook itself, &nbsp;meaning readers can read and create annotations without installing the extension&nbsp;(so long as they have a Hypothesis account) and public comments will be visible to anyone who comes to your book.<\/p>\n<p>Once Hypothesis is enabled on your webbook (see below), any reader coming to the book will see the Hypothesis toolbar on the right, either open or minimized depending on your settings.<\/p>\n[caption id=\"attachment_106\" align=\"alignnone\" width=\"1163\"]<img class=\"wp-image-106 size-full\" src=\"http:\/\/www.publiconsulting.com\/wordpress\/navegarvela\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis4.png\" alt=\"Hypothesis interface on webbook\" width=\"1163\" height=\"770\"> An example of a webbook with Hypothesis enabled.[\/caption]\n<p>With this toolbar open, the reader will see any public annotations and can create or log into their account. Once logged in, they can select any section of text and a small icon will pop up that lets them either highlight the passage (which will remain private) or add an annotation. Annotations can be edited, deleted, replied to or shared using the icons at the bottom of the annotation section.<\/p>\n<p>These annotations can also be public, private to a reader or visible in a private group, and the user can toggle between these options at the very top of the toolbar (the default is \"Public\"). You can read more about <a href=\"https:\/\/hypothes.is\/creating-groups\/\">creating groups<\/a> and <a href=\"https:\/\/hypothes.is\/annotating-with-groups\/\">annotating in groups<\/a> on the Hypothesis website.<\/p>\n<p><img class=\"alignnone size-full wp-image-107\" src=\"http:\/\/www.publiconsulting.com\/wordpress\/navegarvela\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis3.png\" alt=\"hypothesis3\" width=\"1167\" height=\"770\"><\/p>\n<h2>Enabling Hypothesis in Pressbooks<\/h2>\n<p>By default, Hypothesis will not appear on any pages of your webbook. To enable it, follow these steps:<\/p>\n<ol>\n<li>Go to \"Settings\" --&gt; \"Hypothesis\"<\/li>\n<li>Select your default behaviours for:\n<ol>\n<li>Displaying highlights<\/li>\n<li>Displaying the sidebar (you can make it open by default if you wish)<\/li>\n<li>Enabling annotations on PDFs stored in your media library (NOTE: we discourage the use of your media library for this kind of storage)<\/li>\n<\/ol>\n<\/li>\n<li>Select the&nbsp;parts of your book on which to allow Hypothesis annotations.<\/li>\n<li>Save your changes.<\/li>\n<\/ol>\n<p><img class=\"size-full wp-image-108 aligncenter\" src=\"http:\/\/www.publiconsulting.com\/wordpress\/navegarvela\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis.png\" alt=\"Hypothesis settings interface\" width=\"578\" height=\"738\"><\/p>\n<h2>Including &amp; Excluding Specific&nbsp;Chapters or Sections<\/h2>\n<p>Your Hypothesis settings also offer granular control over which chapters or sections have Hypothesis enabled. To employ this option, you will need the <strong>post&nbsp;ID<\/strong> for the chapter(s) or section(s) you wish to specify. To find this, when you are in the chapter editor, look in the address bar for&nbsp;<strong>post=[a number]<\/strong>.<\/p>\n<p>Once you have this&nbsp;number, you can enter&nbsp;it in the Hypothesis content settings in the appropriate field to allow or disallow Hypothesis on that specific page, overriding the global settings.<\/p>\n<p>NOTE: If you're entering more than one post ID, separate them with a comma&nbsp;<em>only<\/em> (no spaces!).<\/p>\n<p><img class=\"size-full wp-image-109 aligncenter\" src=\"http:\/\/www.publiconsulting.com\/wordpress\/navegarvela\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis2.png\" alt=\"Post-specific inclusion and exclusion interface\" width=\"603\" height=\"766\"><\/p>\n<h2>Uses<\/h2>\n<ul>\n<li>Collaborative editing - users can set up a private group, leave comments and editing suggestions, and discuss changes right in the document.<\/li>\n<li>Reader feedback - if you're sharing your book with early readers, they can offer feedback and comments, or you can leave the option open to anyone who is engaging with your books!<\/li>\n<li>Student engagement - students can be encouraged to engage with academic texts or books being discussed in class by leaving their thoughts and talking about the text among the class, offering those less likely to speak up in class the opportunity to share their thoughts.<\/li>\n<\/ul>\n<hr>\n<p>If you have any questions, or any trouble using Hypothesis on your webbook, please let us know at <a href=\"mailto:support@pressbooks.com\">support@pressbooks.com<\/a>.<\/p>\n\n","rendered":"<div class=\"textbox\">\n<p>Hypothesis is a powerful web annotation tool that many users deploy to use as a teaching tool with students or to enable: collaboration between authors and editors, personal note taking and annotation or engagement&nbsp;with readers. This chapter will cover:<\/p>\n<ul>\n<li>What is Hypothesis?<\/li>\n<li>How to enable Hypothesis on your webbook<\/li>\n<li>How to include and exclude specific chapters or sections&nbsp;from Hypothesis<\/li>\n<\/ul>\n<\/div>\n<h2>What is Hypothesis?<\/h2>\n<p><a href=\"http:\/\/hypothes.is\">Hypothesis<\/a>&nbsp;is a simple web annotation tool that allows readers to highlight and annotate webpages, enabling deeper engagement with content.&nbsp;While the tool is available as a browser extension that can be used on any webpage, Pressbooks allows you to&nbsp;build its capabilities into the pages of your webbook itself, &nbsp;meaning readers can read and create annotations without installing the extension&nbsp;(so long as they have a Hypothesis account) and public comments will be visible to anyone who comes to your book.<\/p>\n<p>Once Hypothesis is enabled on your webbook (see below), any reader coming to the book will see the Hypothesis toolbar on the right, either open or minimized depending on your settings.<\/p>\n<figure id=\"attachment_106\" aria-describedby=\"caption-attachment-106\" style=\"width: 1163px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-106 size-full\" src=\"\/\/www.publiconsulting.com\/wordpress\/navegarvela\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis4.png\" alt=\"Hypothesis interface on webbook\" width=\"1163\" height=\"770\" srcset=\"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis4.png 1163w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis4-300x199.png 300w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis4-768x508.png 768w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis4-1024x678.png 1024w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis4-65x43.png 65w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis4-225x149.png 225w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis4-350x232.png 350w\" sizes=\"auto, (max-width: 1163px) 100vw, 1163px\" \/><figcaption id=\"caption-attachment-106\" class=\"wp-caption-text\">An example of a webbook with Hypothesis enabled.<\/figcaption><\/figure>\n<p>With this toolbar open, the reader will see any public annotations and can create or log into their account. Once logged in, they can select any section of text and a small icon will pop up that lets them either highlight the passage (which will remain private) or add an annotation. Annotations can be edited, deleted, replied to or shared using the icons at the bottom of the annotation section.<\/p>\n<p>These annotations can also be public, private to a reader or visible in a private group, and the user can toggle between these options at the very top of the toolbar (the default is &#8220;Public&#8221;). You can read more about <a href=\"https:\/\/hypothes.is\/creating-groups\/\">creating groups<\/a> and <a href=\"https:\/\/hypothes.is\/annotating-with-groups\/\">annotating in groups<\/a> on the Hypothesis website.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-107\" src=\"\/\/www.publiconsulting.com\/wordpress\/navegarvela\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis3.png\" alt=\"hypothesis3\" width=\"1167\" height=\"770\" srcset=\"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis3.png 1167w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis3-300x198.png 300w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis3-768x507.png 768w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis3-1024x676.png 1024w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis3-65x43.png 65w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis3-225x148.png 225w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis3-350x231.png 350w\" sizes=\"auto, (max-width: 1167px) 100vw, 1167px\" \/><\/p>\n<h2>Enabling Hypothesis in Pressbooks<\/h2>\n<p>By default, Hypothesis will not appear on any pages of your webbook. To enable it, follow these steps:<\/p>\n<ol>\n<li>Go to &#8220;Settings&#8221; &#8211;&gt; &#8220;Hypothesis&#8221;<\/li>\n<li>Select your default behaviours for:\n<ol>\n<li>Displaying highlights<\/li>\n<li>Displaying the sidebar (you can make it open by default if you wish)<\/li>\n<li>Enabling annotations on PDFs stored in your media library (NOTE: we discourage the use of your media library for this kind of storage)<\/li>\n<\/ol>\n<\/li>\n<li>Select the&nbsp;parts of your book on which to allow Hypothesis annotations.<\/li>\n<li>Save your changes.<\/li>\n<\/ol>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-108 aligncenter\" src=\"\/\/www.publiconsulting.com\/wordpress\/navegarvela\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis.png\" alt=\"Hypothesis settings interface\" width=\"578\" height=\"738\" srcset=\"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis.png 578w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis-235x300.png 235w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis-65x83.png 65w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis-225x287.png 225w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis-350x447.png 350w\" sizes=\"auto, (max-width: 578px) 100vw, 578px\" \/><\/p>\n<h2>Including &amp; Excluding Specific&nbsp;Chapters or Sections<\/h2>\n<p>Your Hypothesis settings also offer granular control over which chapters or sections have Hypothesis enabled. To employ this option, you will need the <strong>post&nbsp;ID<\/strong> for the chapter(s) or section(s) you wish to specify. To find this, when you are in the chapter editor, look in the address bar for&nbsp;<strong>post=[a number]<\/strong>.<\/p>\n<p>Once you have this&nbsp;number, you can enter&nbsp;it in the Hypothesis content settings in the appropriate field to allow or disallow Hypothesis on that specific page, overriding the global settings.<\/p>\n<p>NOTE: If you&#8217;re entering more than one post ID, separate them with a comma&nbsp;<em>only<\/em> (no spaces!).<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-109 aligncenter\" src=\"\/\/www.publiconsulting.com\/wordpress\/navegarvela\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis2.png\" alt=\"Post-specific inclusion and exclusion interface\" width=\"603\" height=\"766\" srcset=\"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis2.png 603w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis2-236x300.png 236w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis2-65x83.png 65w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis2-225x286.png 225w, https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-content\/uploads\/sites\/56\/2016\/09\/hypothesis2-350x445.png 350w\" sizes=\"auto, (max-width: 603px) 100vw, 603px\" \/><\/p>\n<h2>Uses<\/h2>\n<ul>\n<li>Collaborative editing &#8211; users can set up a private group, leave comments and editing suggestions, and discuss changes right in the document.<\/li>\n<li>Reader feedback &#8211; if you&#8217;re sharing your book with early readers, they can offer feedback and comments, or you can leave the option open to anyone who is engaging with your books!<\/li>\n<li>Student engagement &#8211; students can be encouraged to engage with academic texts or books being discussed in class by leaving their thoughts and talking about the text among the class, offering those less likely to speak up in class the opportunity to share their thoughts.<\/li>\n<\/ul>\n<hr \/>\n<p>If you have any questions, or any trouble using Hypothesis on your webbook, please let us know at <a href=\"mailto:support@pressbooks.com\">support@pressbooks.com<\/a>.<\/p>\n","protected":false},"author":1,"menu_order":1,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"chapter-type":[],"contributor":[],"license":[],"class_list":["post-110","chapter","type-chapter","status-publish","hentry"],"part":17,"_links":{"self":[{"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/pressbooks\/v2\/chapters\/110","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/pressbooks\/v2\/chapters\/110\/revisions"}],"predecessor-version":[{"id":111,"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/pressbooks\/v2\/chapters\/110\/revisions\/111"}],"part":[{"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/pressbooks\/v2\/parts\/17"}],"metadata":[{"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/pressbooks\/v2\/chapters\/110\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/wp\/v2\/media?parent=110"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/pressbooks\/v2\/chapter-type?post=110"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/wp\/v2\/contributor?post=110"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/www.publiconsulting.com\/wordpress\/eduguide\/wp-json\/wp\/v2\/license?post=110"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}