Update: I had the privilege to see Charcoal as a Habari system theme. This means that as of Habari 0.5, Charcoal is included in every Habari install.
I have committed version 0.4 of Charcoal to the habari-extras repository. Charcoal, in case you've not hear of it, is a theme project for Habari that I started a couple of months ago and work on as much as I can. It was my first web design made from scratch, and to my surprise, it looked really good when it was finished.
Download
Charcoal is hosted within the habari-extras repository. If you'd like a "nightly" build of the theme, you can download charcoal.zip from the Habari distribution page. Otherwise, you can download a stable copy of version 0.4 here.
Installation
Extract the downloaded archive in /user/themes within your habari installation directory, and activate it from the Admin site.
What it looks like
Here are a couple of screenshots of what the theme looks like
Home page
Single entry
Tag view
Search results
Configuration
Until a configuration options page is implemented for the theme in Habari, you can customize some simple aspects of the theme by changing several constants in charcoal's theme.php file:
SHOW_TITLE_IMAGE : Set to 'true' to display your own title image, an image with the name title.png must be present in the theme's 'images' directory.
HOME_LABEL : Set to whatever you want your first tab text to be.
SHOW_ENTRY_PAPERCLIP : Setting this to true will show the paper clip graphic in entries, set to 'false' to hide it
SHOW_PAGE_PAPERCLIP : Setting this to true will show the paper clip graphic in pages, set to 'false' to hide it
SHOW_POWERED : Set to 'true' to display the "Powered by Habari" graphic, and to 'false' to hide it
DISPLAY_LOGIN : Set to 'true' to display the login/admin link in the navigation bar, and to false to hide it
TAGS_IN_MULTIPLE : Set to true, to display post tags for each post displayed in the 'Multiple' views (ie, search results, tag views and navigation pages)
Recommended Plugins
Charcoal won't need any particular plugin to be activated. However, to maintain the look of the theme, 2 plugins are recommended:
- RN Tag Cloud - The theme will "recognize" the plugin when it's activated, so there is no need to add anything to the theme code.
- Extended Monthly Archives
Compatibility
Charocal is still under development and my not display correctly on some browsers. It was tested successfully on Firefox and Safari and it's not looking very good in IE6 (working on it). If you test with any other browser please let me know how it looks there so I can work on increasing its browser compatibility.
Acknowledgment
As small as it may seem, I would still never be able to progress with this little project without the support of the Habari community. Almost everyone there helped me by either by answering a code question, suggesting an implementation or even giving their opinion and support. Thanks guys!
License
Charcoal theme is licensed under the terms of the Apache Software License 2.0.
Found a bug? Have a question or comment?
As previously mentioned, Charcoal's code is hosted in the habari-extras repository, so if you find any bug in it or if you have a feature that you'd like to see in the theme. Please file a ticket within the habari-extras Trac , and make sure you set the 'Component' field to 'charcoal'.
If you have a question or you you feel you need to comment on something, that's what's the comments section is all for :)
tinyau
It's really cool. Thanks for your efforts. ;)
1205379061