= Welcome to Blogsum =

Blogsum is a very basic blogging application.  It was written from scratch with a focus on simplicity and security.  The author was frustrated with the lack of small blog applications that were ''written well'' and would reside in OpenBSD's httpd(8) chroot without too much pain.  Blogsum addresses these needs while providing the most popular features that the typical blogger might require (tags, rss, basic authoring tools).

The original Blogsum development site is hosting [http://www.obfuscurity.com/ obfuscurity.com].

There is a [http://www.dixongroup.net/mailman/listinfo/blogsum-users mailing list] for general discussion.

== Features ==

=== Article Markup ===

There's nothing fancy here.  Blogsum takes what you save and publishes it directly to output.  The standard design (e.g. on [http://www.obfuscurity.com/ Obfuscurity.com]) uses CSS to style typical contents ({{{<p>}}}, {{{<pre>}}}, etc) so it's wise to use proper HTML layout techniques.  Long articles can be abbreviated on the front page by using a {{{<!--readmore-->}}} tag where you'd like the short view to truncate.

=== Comments ===

Article comments are moderated and must be accompanied with a successful Captcha challenge.  Rest assured that all user input is encoded to avoid XSS issues.

=== Themes ===

Blogsum supports user themes.  These exist in the {{{themes}}} directory.  To create a theme, simply copy the {{{themes/default}}} directory to your own directory (e.g. {{{themes/foobar}}}) and modify accordingly.  Changes can be made to any of the files in a theme, but the path and filenames should not change.  When you are finished, edit your {{{$blog_theme}}} setting in {{{Blogsum/Config.pm}}} and enjoy!

== To-Do List ==

 * word count in preview
 * bring back TZ support
 * sync up {{{#preview}}} and {{{#article}}} styles
 * remove absolute links and make it easier to use non-{{{<VirtualHost>}}} setups (e.g. {{{<Directory>}}})
 * moar themez!!!
 * add favicon to themes
 * wysiwyg editor ([http://xinha.webfactional.com/wiki Xinha], BSD licensed)

== Miscellaneous ==

 * [wiki:Features Detailed Feature List]

== Installation ==

 * [wiki:InstallOpenBSD OpenBSD]