{"id":97,"date":"2009-11-05T07:42:40","date_gmt":"2009-11-05T12:42:40","guid":{"rendered":"http:\/\/futureofthebook.org\/commentpress\/?page_id=97"},"modified":"2016-05-20T07:35:02","modified_gmt":"2016-05-20T11:35:02","slug":"formatting-your-document","status":"publish","type":"page","link":"https:\/\/futureofthebook.org\/commentpress\/support\/formatting-your-document\/","title":{"rendered":"Formatting Your Document"},"content":{"rendered":"<p>CommentPress breaks up content into a commentable form in two ways: by default, it splits according to paragraph breaks and lists ( <code>&lt;p&gt;<\/code>, <code>&lt;ol&gt;<\/code>, <code>&lt;ul&gt;<\/code> ). WordPress automatically inserts paragraph tags into your document when it detects two line breaks. This works well for most texts.<\/p>\n<p>You can also split content by using a &#8216;quicktag&#8217; separator in the text (<code>&lt;--commentblock--&gt;<\/code>). The HTML and Rich-text Editors in WordPress both have a &#8216;commentblock&#8217; button to help you do this should you choose this method. Please note: you can use either splitting method on a page, but not both.<\/p>\n<ul>\n<li>Lets go ahead and<\/li>\n<li>Test whether we get<\/li>\n<li>Comment icons on<\/li>\n<li>An unordered list<\/li>\n<\/ul>\n<ol>\n<li>And lets also<\/li>\n<li>Test if we get<\/li>\n<li>Comment icons on<\/li>\n<li>An ordered list<\/li>\n<\/ol>\n<p>We realize that when you reorganize things in this way the term &#8220;paragraph&#8221; begins to get a bit wobbly. We thought of calling them &#8220;lexias&#8221; (units of reading) but that seemed a little too obscure. Let us know if you have any other ideas.<\/p>\n<p><em>Please note:<\/em> headings and other more elaborate formatting will not be picked up as a text block on which comments can be left. Part of the reason for this is the way a text block is represented &#8212; headings often do not have enough content to distinguish one from another. We would appreciate feedback on which tags would be most useful to make commentable.<\/p>\n<p>If you want to make video and Flash embeds and images commentable, then wrap them in a paragraph. If you want Flash embeds to scroll nicely under the header, don&#8217;t forget to add the <code>&lt;param name=\"wmode\" value=\"opaque\" \/&gt;<\/code> parameter. For example:<\/p>\n<p><object width=\"320\" height=\"240\" classid=\"clsid:d27cdb6e-ae6d-11cf-96b8-444553540000\" codebase=\"http:\/\/download.macromedia.com\/pub\/shockwave\/cabs\/flash\/swflash.cab#version=6,0,40,0\"><param name=\"wmode\" value=\"opaque\" \/><param name=\"allowfullscreen\" value=\"true\" \/><param name=\"allowscriptaccess\" value=\"always\" \/><param name=\"src\" value=\"http:\/\/vimeo.com\/moogaloop.swf?clip_id=309180&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1\" \/><embed type=\"application\/x-shockwave-flash\" width=\"320\" height=\"240\" src=\"http:\/\/vimeo.com\/moogaloop.swf?clip_id=309180&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1\" allowscriptaccess=\"always\" allowfullscreen=\"allowfullscreen\" wmode=\"opaque\" \/><\/object><\/p>\n<p><img decoding=\"async\" style=\"width: 320px; height: 240px;\" title=\"Haystack\" src=\"http:\/\/www.haystack.co.uk\/images\/blog\/haystack_corn_texture.jpg\" alt=\"Haystack\" \/><\/p>\n<p>Paragraph links: you can link to a particular paragraph in the same document by copying the adjoining speech bubble&#8217;s link and then add the &#8216;cp_para_link&#8217; class to <a class=\"cp_para_link\" href=\"#pePnhaomefwnbpuaatbowcclPotrftiwrodhectdofaWwaftmumc\">make it scroll nicely<\/a>. Links <a href=\"http:\/\/futureofthebook.org\/commentpress\/about-commentpress\/#pTwtpocwretdGTbiumsppcwolpbqrhtfcbaetmvsasTbcMSpahhwfomhHHOCEswfhcamyirhcasdpccdowlsTipbWcsjcbmwbyuydJSFSFssfgfdhcrdGGPLDttealmc\">to other pages<\/a> work just the same.<\/p>\n<p><code>&lt;a href=\"#pePnhaomefwnbpuaatbowcclPotrftiwrodhectdofaWwaftmumc\" class=\"cp_para_link\"&gt;Your link text&lt;\/a&gt;<\/code> produces <a class=\"cp_para_link\" href=\"#pePnhaomefwnbpuaatbowcclPotrftiwrodhectdofaWwaftmumc\">Your link text<\/a><\/p>\n<p><code>&lt;a href=\"http:\/\/futureofthebook.org\/commentpress\/about-commentpress\/#pEsHoHphbcfutrCaapstcspwiiacmspNsfhcucsiwctwshpuWinp\"&gt;Link to other page&lt;\/a&gt;<\/code> produces <a href=\"http:\/\/futureofthebook.org\/commentpress\/about-commentpress\/#pEsHoHphbcfutrCaapstcspwiiacmspNsfhcucsiwctwshpuWinp\">Link to other page<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>CommentPress breaks up content into a commentable form in two ways: by default, it splits according to paragraph breaks and lists ( &lt;p&gt;, &lt;ol&gt;, &lt;ul&gt; ). WordPress automatically inserts paragraph tags into your document when it detects two line breaks. This works well for most texts. You can also split content by using a &#8216;quicktag&#8217; [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":222,"menu_order":2,"comment_status":"open","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-97","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/pages\/97","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=97"}],"version-history":[{"count":32,"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/pages\/97\/revisions"}],"predecessor-version":[{"id":422,"href":"https:\/\/futureofthebook.org\/commentpress\/wp-json\/wp\/v2\/pages\/97\/revisions\/422"}],"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=97"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}