{"id":237,"date":"2009-12-18T04:33:21","date_gmt":"2009-12-18T09:33:21","guid":{"rendered":"http:\/\/futureofthebook.org\/commentpress\/?page_id=237"},"modified":"2016-05-20T07:33:17","modified_gmt":"2016-05-20T11:33:17","slug":"using-commentpress","status":"publish","type":"page","link":"https:\/\/futureofthebook.org\/commentpress\/support\/using-commentpress\/","title":{"rendered":"How to read a CommentPress document"},"content":{"rendered":"

The following relates to the default CommentPress theme that is bundled with the plugin. The theme used on this website will be included with the plugin, but is still in development. Please be patient and we’ll update this page when the time comes. Thanks.<\/strong><\/p>\n

If you’re unfamiliar with the CommentPress interface, the following should help you navigate your way around a CommentPress document. (Please note: the screenshots below correspond to the design of Version 3.2, but the icons and general placement have not changed much in the default theme, so we hope these are still helpful)<\/p>\n

\"Document
\nDocument Title<\/em><\/p>\n

As with most WordPress sites, the document title is also a link to the document’s home page. The main text column and the comments column can be made to occupy proportionally different widths of the page by dragging the right–hand border of the text column. If you\u2019d like less screen clutter, you can close the page header by clicking on the ‘up–and–down’ arrow icon at the far right of the navigation bar (click the icon again to reopen).<\/p>\n

\"Page
\nPage Title<\/em><\/p>\n

Each page will display its title here. If the page is contained within a chapter or section, this context will also be shown here. Navigate your way through pages in a linear way using the next and previous page buttons:<\/p>\n

\"Next
\nNext Page Button<\/em><\/p>\n

\"Previous
\nPrevious Page Button<\/em><\/p>\n

If at any time you get lost, or want to jump to a specific page, the Table of Contents is always available to you by clicking the open book icon shown below. If you have Javascript enabled, the Table of Contents will appear in the right hand column. If Javascript is not enabled, this will take you to the document’s home page where you will find the Table of Contents in the right–hand column.<\/p>\n

\"Table
\nTable of Contents Button<\/em><\/p>\n

CommentPress presents two innovative ways of reading comments on the text. By clicking on the ‘double speech bubble’ icon in the navigation bar, you can read comments–by–page; in the list of pages, ordered by number of comments. By clicking on the people icon in the navigation bar, you can read comments–by–author, with the same functionality as for comments–by–page.<\/p>\n

\"General
\nGeneral Comments Button<\/em><\/p>\n

Perhaps your comment does not really apply to a particular page or paragraph? The General Comments page is there so that you can leave comments which are global in scope or reference.<\/p>\n

\"All
\nAll Comments Button<\/em><\/p>\n

As you can guess, the All Comments page shows a list of pages that have comments on them, ranked by number of comments. With Javascript enabled, you’ll have to click on the title of the page to view the comments. Each comment has a link so that you can view it in its original page context: click on “Comment” in each comment’s header.<\/p>\n

\"Comments-by-Commenter
\nComments-by-Commenter Button<\/em><\/p>\n

The Comments–by–Commenter page is similar to the All Comments page, but (of course) comments are listed by comment author.<\/p>\n

\"Blog
\nBlog Button<\/em><\/p>\n

The CommentPress document’s blog is accessed by clicking the ‘thumbtack’ button shown above. In general, CommentPress documents are likely to be completed works — the blog allows the author a continuing voice without disturbing the layout of the document itself. Where the document is still in progress, the blog allows content to be published that does not sit comfortably within the document itself — announcements, for example.<\/p>\n

If you are on a page (or blog post) which allows paragraph–level commenting, then you will see icons like those below down the left–hand side of the page:<\/p>\n

\"Paragraph
\nParagraph Icons<\/em><\/p>\n

Clicking one of these icons (when Javascript is enabled) will highlight the relevant paragraph (or block) open the corresponding comments section in the right–hand column and scroll it to the comment form. To leave a comment on an entire page, click the link to “Comments on the whole page”. Paragraph icons are also links which can be used as permalinks to a paragraph. Here’s an example link to a video<\/a> on another page on this site.<\/p>\n

If you’re concentrating on reading comments on paragraphs, this is more easily done by clicking the headers in the “Comments” column; each section will then open at the first comment. If you’re reading comments on an iPad, use two–finger scrolling in this column. CommentPress features live posting and updating of comments, so you don’t have to refresh the page to see what’s being said by others.<\/p>\n

Are you having trouble understanding anything else about CommentPress? Leave a comment on this page and we’ll try and help you out.<\/p>\n","protected":false},"excerpt":{"rendered":"

The following relates to the default CommentPress theme that is bundled with the plugin. The theme used on this website will be included with the plugin, but is still in development. Please be patient and we’ll update this page when the time comes. Thanks. If you’re unfamiliar with the CommentPress interface, the following should help […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":222,"menu_order":3,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-237","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/pages\/237","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/comments?post=237"}],"version-history":[{"count":15,"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/pages\/237\/revisions"}],"predecessor-version":[{"id":419,"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/pages\/237\/revisions\/419"}],"up":[{"embeddable":true,"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/pages\/222"}],"wp:attachment":[{"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/media?parent=237"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}