Table of Contents

Comment Icon0 Commentpress breaks up content into a commentable form 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.

  • Comment Icon0
  • Lets go ahead and
  • Test whether we get
  • Comment icons on
  • An unordered list
  1. Comment Icon0
  2. And lets also
  3. Test if we get
  4. Comment icons on
  5. An ordered list

Comment Icon0 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.

Comment Icon0 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.

Comment Icon0 If you want to make video embeds and images commentable, then wrap them in a paragraph. For example:

Comment Icon0

Comment Icon0 Haystack

Comment Icon0 Paragraph links: you can link to a particular paragraph in the same document by copying the adjoining speech bubble’s link and then use it anywhere. Links to other pages work just the same.

Formatting Your Document

Comments

7 Comments on the whole page

  1. 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.”

  2. Another option: Jack Slocum, whose own granular commenting system very much influenced Commentpress, calls them “blocks”.

  3. 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.

  4. This is an interesting piece of software – looks fantastic for this kind of thing actually.

  5. [...] 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 [...]

  6. I like “blocks” myself. I also like “units” or “sense unit”.

  7. 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.

0 Comments on paragraph 1

0 Comments on paragraph 2

0 Comments on paragraph 3

0 Comments on paragraph 4

0 Comments on paragraph 5

0 Comments on paragraph 6

0 Comments on paragraph 7

0 Comments on paragraph 8

0 Comments on paragraph 9

Leave a Comment