Formatting Your Document
Permalink for this paragraph 0
Commentpress breaks up content into a commentable form in two ways: by default, it splits according to paragraph breaks and lists ( <p>, <ol>, <ul> ). WordPress automatically inserts paragraph tags into your document when it detects two line breaks. This works well for most texts.
Permalink for this paragraph 0
You can also split content by using a ‘quicktag’ separator in the text (<--commentblock-->). The HTML and Rich-text Editors in WordPress both have a ‘commentblock’ 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.
- Permalink for this paragraph 0
- Lets go ahead and
- Test whether we get
- Comment icons on
- An unordered list
- Permalink for this paragraph 0
- And lets also
- Test if we get
- Comment icons on
- An ordered list
Permalink for this paragraph 2 We realize that when you reorganize things in this way the term “paragraph” begins to get a bit wobbly. We thought of calling them “lexias” (units of reading) but that seemed a little too obscure. Let us know if you have any other ideas.
Permalink for this paragraph 0 Please note: 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 — 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.
Permalink for this paragraph 0
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’t forget to add the <param name="wmode" value="opaque" /> parameter. For example:
Permalink for this paragraph 2
Permalink for this paragraph 0
Permalink for this paragraph 0 Paragraph links: you can link to a particular paragraph in the same document by copying the adjoining speech bubble’s link and then add the ‘cp_para_link’ class to make it scroll nicely. Links to other pages work just the same.
Permalink for this paragraph 0
<a href="#pePnhaomefwnbpuaatbowcclPotrftiwrodhectdofaWwaftmumc" class="cp_para_link">Your link text</a> produces Your link text
Permalink for this paragraph 0
<a href="http://www.haystack.co.uk/commentpress/about-commentpress/#pEsHoHphbcfutrCaapstcspwiiacmspNsfhcucsiwctwshpuWinp">Link to other page</a> produces Link to other page
Christian Wach
Mark Walters
Many journalists I know refer to “graphs.” A “paragraph” could be the larger term. Or to be clearer, change the term for the aggregated paragraphs — perhaps call them “comment sections.”
SUPERB KUMMASAV
Another option: Jack Slocum, whose own granular commenting system very much influenced Commentpress, calls them “blocks”.
It’s awesome that you use paragraph tags, I wrote my own commenting system many years ago in perl and it also used paragraph breaks. So hopefully I can port my book draft over to Comment Press with minimal reformatting required.
This is an interesting piece of software – looks fantastic for this kind of thing actually.
[...] tools is actually a pretty clever and simple extension of WordPress, called Commentpress. It links the comments to specific paragraphs in a post, displaying the two side-by-side not [...]
I like “blocks” myself. I also like “units” or “sense unit”.
I have a document that includes many bulleted lists, and Commentpress is essentially useless because there is no way to indicate that a list is a paragraph. Doesn’t help to add tags around the list. Makes me very sad, as Commentpress is so useful otherwise.
@Dot: Commentpress 3.2 has two ways to generate commentable blocks -either leave the text as is and it’ll parse <p>, <ul> and <ol> tags, or use the new “comment-block” divider in the edit page screen to arbitrarily sub-divide your text.