Loading...

Using the Blog

The Blog is a simple tool to post messages and opinions related to the project. It follows the traditional blog style, and interacting well with the other features of the project.

The basics

The blog is made up of blog posts, and blog posts have an author and zero or more categories attached to it that together with initial creation (publish) time will categorise posts in various lists available in the sidebar:

  • Time periods
  • Authors
  • Categories

The blog post uses regular Wiki formatting in the content, giving full access to links, syntax highlighting, attachments and many other commonly found features of the project.

An individual blog post can further have comments made by author and other users.

Permissions

Use of the blog requires setting the appropriate permissions.

For a regular project that may mean assigning:

  • BLOG_VIEW and perhaps BLOG_COMMENT to all regular project users.
  • BLOG_MODIFY_OWN permission to those that get to create and maintain their own posts on the blog.

In addition, project administrators will have BLOG_ADMIN permission that allows various administrative features such as deleting comments and posts.

For user-projects (such as simon) the permissions are already pre-defined to allow anonymous access to the blog, and allowing all authenticated users to make comments on the blog posts.

Creating and modifying posts

A new blog posts is created by using the 'New post' item in the context menu. Edit, preview and save the post:

  • 'post name / url' is the name used to uniquely identify the post, and it's main usage is that it will be the used for navigation and linking behind the scenes. The URL to a blog post 'my_first_post' will be .../blog/my_first_post.
  • 'title' is the main heading that will be used in all listings descibing the post.
  • 'body' is the main wiki-based content.
  • 'author' is the author of the post as used by navigation and classification.
  • 'categories' is a space (or comma) seperated list of words that tag and classify the content, also reflected in navigation and lists.

For any existing post, attachments can be added, and the content can be edited at will later.

Making comments

This is simply a matter of filling in the 'Add comment' form that consists of one or two fields:

  • 'author' will show if the user is not logged in.
  • 'comment' is the wiki syntax that makes up the comment.

Comments can be previewed before they are posted.

Search and Timeline

All changes to blog posts, or comments added will appear in the Timeline for those that have read access to the blog - and have checked to view 'Blog' items in the timeline.

Additionally, both blog posts and comments are fully searchable (see Search)

RSS feeds

The blog front page and archive provide the main RSS feed for the project. Additionally, there are feeds that only target a specific author or category.

The various blog feeds provide full-text messages into the feeds.

To track details of any updates or comments made, use the Timeline RSS feeds.

See HelpUser/RSS for general information about RSS feeds.