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.
How does one change the green background to a different color or texture? I tried changing all the colors in the css files but only managed to change the header somehow.
The definition of the colour for the body background is in layout.css, but you can override it in a number of ways: use a child theme and define your body colour there, or use the custom.css file to put your overridden style in.
Thanks for replying. One other question: the logo image repeats itself on monitor resolutions greater than 1600 (mine’s 1920). The header tab does not give us the option to control this. Thanks!
Add this to custom.css, or in your child theme:
body #book_header {background-repeat: no-repeat;
}
Is there a way to add blog categories on the right along with or instead of archives? Also, how does one add social media icons or an RSS feed?
Not via the admin interface, I’m afraid. You’d have to code it.
Thanks for replying. Your advice on my earlier questions helped me greatly.Let’s say I wanted to put two icons in the header area with its own css boxes, which file or css item should I look for? Wish there was a way I could add blog categories along with the archives tab – that would make it almost like two documents within a blog!
Hi John – first off, if you have an Archive tab, then you’re running an outdated version of the theme and plugin. The Archive tab was removed in favour of an Activity tab in Commentpress 3.3. For obvious reasons, I’d recommend upgrading.
You’ll find the code for the icons in a file called navigation.php, which is in the ‘style/templates’ sub-directory of the theme. The images you’ll need to replicate are in ‘style/images/buttons’. And the CSS controlling them is in layout.css, though you’ll want to look at layout.dev.css for a readable version.
I think I see where you want to go with your modifications – if you contact me directly, I may be able to help you customise your install more robustly.
Oh no. I have 3.2.1…but when I clicked download it takes me to the same github page with version 3.2.1. Where can I find 3.3.1?
Github always has the latest code for the theme and plugins. Just download them again from their Github pages.
Maybe I’m doing it wrong. I’ve tried it four times now. When I click the download theme button I’m taken to this page: https://github.com/IFBook/CommentPressThemeFrom this page I have tried two download options – The Zip button on the top left and the Downloads link on the middle right (takes me to a second page with zip or tar option). I use ZIP. Both of these downloads when installed show up as 3.2.1. Is there a different link?