This id is not the same as the title of the blog. That, and more, you can edit by selecting Blog|Edit blog info.
kaa.py testfor a blog called "test".
It may be convenient to make a small script or batch file (or a shortcut, in Windows) that calls Kaa with the appropriate blog id.
You write your message in pure HTML. (However, some tools may be added in the future to allow for a simple, non-HTML, markup, that will be translated to HTML.) When you're done, press Save to store the entry in the database. At this point, no HTML is generated yet, much less published.
Future releases may also support inclusion of Python code in an entry, by the way.
Existing entries are edited by picking them from the list presented to you by Entry|Edit existing entry.
<!-- template --> <h1><% blog.title %></h1> <i><% blog.description %></i> <hr> <p> <% blog.messages() %> <hr> Generated by Kaa <# import resource doc.write(resource.__version__) #> on <# import date print date.Date().isodate() #>.All you need is <% blog.messages() %> really, this includes the blog entries; the other code includes Kaa's version number and the current date and time. (Note: This may change in future versions.)
The entry_template.html file may look like this:
<h3><% entry.title %></h3> <% entry.text %> <br> <font face="Tahoma" size="1">Posted on <% entry.insert_date %> <# if entry.modified_date and entry.modified_date != entry.insert_date: print "[ Last edited on", entry.modified_date, "]" #> </font> <p>Again, all you really need is <% entry.text %> and <% entry.title %>, and maybe <% entry.insert_date %> for the date that the entry was posted. The other code adds the modified date in case the entry was changed after it was posted.
So, you use normal HTML, with Python expressions between <% %> and Python statements (or code blocks) between <# #>. For expressions, the value is included. For statements, it works a bit different: anything printed to sys.stdout is included in HTML instead.
Sample templates are included with the Kaa distribution.
In Kaa-land, "posting" means generating HTML pages, while "publishing" means uploading these pages to FTP. Posting is done using the templates above; you can set the names of the templates (and also the name of the page being generated) in the "Edit blog info" screen. Select Publishing|Post to create one HTML page with all entries, or Publishing|Post recent to create a page with the 20 most recent entries. Any generated HTML is stored in a directory html_XX where XX is the name/id of your blog.
When publishing, Kaa connects to your FTP account (settings can be edited with Blog|Edit FTP info), and uploads everything in the html_XX directory. (The benefit of this is that it's easy to add additional files, like pictures... just put the files in your directory and they will be uploaded the next time you publish. The drawback is that you can add this way, but not delete. Maybe some future features will deal with this as well.)
Save-post-publish is a three step, but there's also a "One click publishing" button that does all three these things.
Again, category names should preferably be identifiers.
If you check the "category archives" checkbox in the bloginfo screen, Kaa will generate archives per category (in addition to "regular" archives). It takes the last N entries in a given category and puts them on the page, much like the "front page" works.
For more up-to-date info, and current developments, keep an eye on the Kaa development weblog.
Reactions, comments, bug reports, tips, ideas for features and improvements, etc, are welcome. (Bear in mind that it's heavily under construction, though... "obvious" bugs and lacking basic features are most likely on my to-do list already.) You can contact me here.