Thiblo Developer Docs

• Why on earth implement a new blogging software? What is the big picture? Click!
• How to master the codebase? Continue...

Techologies, languages

• Perl: One can find the best Perl book ever (written by the author of perl, who is actually a linguist) on the thiblo server, under /usr/local/share/books/perl-books.tgz.
• Mason: See  http://masonhq.com/docs/manual/Devel.html for a complete manual. Because thiblo has an already configured mason environment, a minimal Mason knowledge will do at first?.
• Postgresql: You don't need any particular postgresql knowledge for thiblo.
• Class::DBI: This is the module we use to make objects from records. Again, a minimal doc page will do for starting?.
• Apache: The good old lady, works in the background like charm.

Framework

Checking out the code you'll have a directory that is actually a complete application, apache+mason+postgresql configured together. After the neccessary make steps (see section Development on the start page) you'll have your own apache server running with your id, your very own postgresql server, all accessible on your own ports.

html/ is where the Mason templates are, perllib/ is the place of the middleware. For the big picture, see the description of the source tree?.

To control it, stay in the root of the project directory, and say ./bin/start, ./bin/stop, or ./bin/apache2ctl stop|start|restart. When you change anything under perllib/, you need this latter to restart the server.

Database

Metainformation to store:

• table: article_tags
  • origin: List of (date, mechanism, [aggregate_id]) tuples. Each time an article is to be tagged with a certain tag, we extend this list. Mechanism is one of {manual, aggregate}. In case of aggregate, we store the id of the link that resulted in the tagging. This is to have data about information flow dynamics.