Argonaut 0.2.0

3.1 Prequisites for install

• Python 2.4+ [http://www.python.org]

• Pylons 1.0 [http://pylonshq.com/]

• Python setuptools (easy_install) [http://pypi.python.org/pypi/setuptools]

Please see Pylons documentation to get started with Pylons [http://pylonshq.com/docs/en/0.9.7/gettingstarted/].

3.2 Other components

In addition to Pylons, Argonaut uses the following components:

• Mako (templates, the View) [http://www.makotemplates.org/]

• SQLAlchemy (the Model) [http://www.sqlalchemy.org/]

• repoze.what (authentication and access rights) [http://what.repoze.org/docs/1.0/]

• CKEditor (for writing posts) [http://ckeditor.com/]

• AddToAny (for sharing) [http://www.addtoany.com/]

• jQuery (for additional magic) [http://jquery.com/]

• Simple3color (default theme) [http://www.oswd.org/design/preview/id/3533]

• TurboMail (for notifications) [http://www.python-turbomail.org/]

Of these the JavaScript components CKEditor, jQuery and AddToAny are distributed along with this package. The Python components are downloaded and installed by easy_install.

3.3 Installation and Setup

Prequisites for install must be fulfilled. Install Argonaut using easy_install:

easy_install argonaut

OR with local .egg file

easy_install <path_to_egg_file>

Make a config file as follows:

paster make-config argonaut config.ini

Tweak the config file as appropriate. Please see Pylons application setup pages for hints on editing the config file [http://pythonpaste.org/deploy/]. After this run the following to setup the application:

paster setup-app config.ini#arg

Then you are ready to go.

You can test the installation by running:

paster serve config.ini

After this visit the link http://127.0.0.1:5000

Optionally no installing is needed to just test the application. Just extract the source, install Pylons and in the Argonaut base directory run:

paster serve development.ini

4.1 Modifying the site

Argonaut features templates that can be used to control the site structure, layout and texts. Unfortunately in this early version there is no admin panel so all editing must be made to the files directly.

Template files are situated in argonaut/templates. Please see Mako documentation on how to change the templates.

4.2 Configuration

During application setup a database will be created in the form that is configured in config.ini. In addition to blog data, Argonaut also stores some configuration values in the database. These are stored in the table ‘config’.

4.3 Users

The default user for writing posts is ‘admin’, password ‘admin’. Currently users can only be added directly to the database. An admin panel will be added later.

4.4 Other usage notes

Proper documentation and usage will be added slowly over future releases :)