8

CommentPress breaks up content into a commentable form according to paragraph breaks ( <p> ). Wordpress automatically inserts paragraph tags into your document when it detects two line breaks. This works well for most texts, but if you'd like more flexibility in determining how you break things up into commentable units, you can insert your own <p> to group together multiple paragraphs.

To keep two or more paragraphs within a single comment block, try separating them with two break tags <br> instead of using paragraph tags <p>. That's how we kept this paragraph inside the same commenting block as the one above.


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.

Also, a heads up: you may encounter minor problems if you use lists, blockquotes and other more elaborate formatting. We also don't know how well this plays with video embeds. These are areas we hope to improve in the not-too-distant future.


2

One further note about structure. In "document" mode (i.e. not "blog" with a steady inflow of new content), the order of pages is determined by the time the posts were created (oldest to newest). To reoder your table of contents simply edit the post timestamps into the desired chronological sequence.

Posted by Eddie Tejeda on July 20, 2007
Tags: Uncategorized

Total comments on this page: 13

How to read/write comments

Comments on specific paragraphs:

Click the icon to the right of a paragraph

  • If there are no prior comments there, a comment entry form will appear automatically
  • If there are already comments, you will see them and the form will be at the bottom of the thread

Comments on the page as a whole:

Click the icon to the right of the page title (works the same as paragraphs)

Comments

No comments yet.

K.G. Schneider on paragraph 2:

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

July 22, 2007 5:15 pm
ben vershbow on paragraph 2:

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

July 27, 2007 5:26 pm
Johan Karlsson on paragraph 4:

Is it possible to print the whole text rather than just one page at a time? Or to read (and comment on) the entire text onscreen?

July 31, 2007 9:49 am
copystar on paragraph 1:

When creating posts in my CommentPress theme I’m able to see the option for comments, but I don’t see them when I try to create a ‘page’. (the ‘allow comments’ option is on’)

I tried included two lines breaks as well as more than a couple to cajole the ability to comment, but that didn’t happen.

A bug?

August 3, 2007 11:56 am
jdwilbur :

The 1.1 version of CommentPress doesn’t support the use of the CP style commenting on Wordpress ‘pages’ - just posts for right now. Keep your eye on the site though, because we are working on it.

August 3, 2007 2:28 pm
copystar on paragraph 1:

Fair enough. But I have run into this problem when in a blog post. For some reason, two ‘returns’ ( or ‘) doesn’t force a comment to appear. Is there any code I can add to the text to force a comment option to appear?

August 7, 2007 12:50 pm
copystar on paragraph 1:

I should clarify. The comments option works very well most of the time. Occasionally it stumbles when a list, ordered or not, is involved. Thanks for this!

August 9, 2007 7:24 am
jdwilbur on paragraph 1:

I think to get the effect you want, you need to wrap your text in a

tag. Unless things have changed (and they may have in the 1.3 version), that’s what we’re keying off of to generate the comment icons. I’ll post again if I find out differently.

September 4, 2007 6:16 pm
jdwilbur on paragraph 4:

This isn’t an option right now - nor do I think it really tends to fit into the blogging platform structure, but I do understand the request, and we’ll see if we can get it into future versions.

September 4, 2007 6:17 pm
Patri Friedman on paragraph 1:

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.

September 9, 2007 8:12 pm
Joel "Jaykul" Bennett on paragraph 1:

Great, so now we’re encouraging people to use semantically incorrect markup which most likely won’t look right the next time they change their style sheet … just to avoid the hassle of, say, parsing attributes (why not just mark your paragraph as being joined to the previous by using a class attribute [p class=”withabove”]) or adding extra tags?

April 28, 2008 9:08 am
Lottie on paragraph -1:

Do not count your chickens before they’re hatched ,

May 30, 2008 8:22 am
eu on paragraph 1:

one test

August 8, 2008 8:37 pm
Name (required)
E-mail (required - never shown publicly)
URI
Create an account (optional) | Login