Wiki

Clone wiki

dotim / Home

<<float left>>

== Dotim ==

A fresh, simple django-powered blog engine.

<</float>>

<<float right>>
{{http://bitbucket.org/bruno/dotim/wiki/dotim.png|Dotim logo}}
<</float>>

<<clear>>

== Features ([[http://bruno.im|See it live here]]) ==

<<float left>>

=== Blog ===
* Supports reStructredText syntax for writing blog entries
* Syntax highlighting for publishing code snippets
* Inline image support
* Preview your entries before you publish them
* Tagging
* Comments with optional Akismet moderation
* Atom feeds for entries, tags and intersection of sets of tags
* Short URLs, with {{{rel=shortlink}}} and {{{Link}}} header support

<</float>>
<<float right>>

=== Gallery ===
* Pictures are grouped by gallery
* Thumbnail and large size views
* Flickr-like browsing
* Youtube-like "light off" feature: swicth the light on and off

<</float>>
<<clear>>

<<float left>>

=== Projects ===
* Description of the projects you're working on
* Links to the code, website and live demo

<</float>>
<<float right>>

=== Activity ===
* Aggregates your activity on del.icio.us, github, bitbucket, gitorious, twitter, django snippets
* Ability to filter what is put on your timeline (exclude your private projects)

<</float>>
<<float right>>
{{http://bitbucket.org/bruno/dotim/wiki/dotim.png|Dotim logo}}
<</float>>

<<clear>>

== Features ([[http://bruno.im|See it live here]]) ==

<<float left>>

=== Blog ===
* Supports reStructredText syntax for writing blog entries
* Syntax highlighting for publishing code snippets
* Inline image support
* Preview your entries before you publish them
* Tagging
* Comments with optional Akismet moderation
* Atom feeds for entries, tags and intersection of sets of tags
* Short URLs, with {{{rel=shortlink}}} and {{{Link}}} header support

<</float>>
<<float right>>

=== Gallery ===
* Pictures are grouped by gallery
* Thumbnail and large size views
* Flickr-like browsing
* Youtube-like "light off" feature: swicth the light on and off

<</float>>
<<clear>>

<<float left>>

=== Projects ===
* Description of the projects you're working on
* Links to the code, website and live demo

<</float>>
<<float right>>

=== Activity ===
* Aggregates your activity on del.icio.us, github, bitbucket, gitorious, twitter, django snippets
* Ability to filter what is put on your timeline (exclude your private projects)

<</float>>


Features (See it live here)

<<float left>>

=== Blog ===
* Supports reStructredText syntax for writing blog entries
* Syntax highlighting for publishing code snippets
* Inline image support
* Preview your entries before you publish them
* Tagging
* Comments with optional Akismet moderation
* Atom feeds for entries, tags and intersection of sets of tags
* Short URLs, with {{{rel=shortlink}}} and {{{Link}}} header support

<</float>>
<<float right>>

=== Gallery ===
* Pictures are grouped by gallery
* Thumbnail and large size views
* Flickr-like browsing
* Youtube-like "light off" feature: swicth the light on and off

<</float>>
<<clear>>

<<float left>>

=== Projects ===
* Description of the projects you're working on
* Links to the code, website and live demo

<</float>>
<<float right>>

=== Activity ===
* Aggregates your activity on del.icio.us, github, bitbucket, gitorious, twitter, django snippets
* Ability to filter what is put on your timeline (exclude your private projects)

<</float>>
<<float right>>

=== Gallery ===
* Pictures are grouped by gallery
* Thumbnail and large size views
* Flickr-like browsing
* Youtube-like "light off" feature: swicth the light on and off

<</float>>
<<clear>>

<<float left>>

=== Projects ===
* Description of the projects you're working on
* Links to the code, website and live demo

<</float>>
<<float right>>

=== Activity ===
* Aggregates your activity on del.icio.us, github, bitbucket, gitorious, twitter, django snippets
* Ability to filter what is put on your timeline (exclude your private projects)

<</float>>


<<float left>>

=== Projects ===
* Description of the projects you're working on
* Links to the code, website and live demo

<</float>>
<<float right>>

=== Activity ===
* Aggregates your activity on del.icio.us, github, bitbucket, gitorious, twitter, django snippets
* Ability to filter what is put on your timeline (exclude your private projects)

<</float>>
<<float right>>

=== Activity ===
* Aggregates your activity on del.icio.us, github, bitbucket, gitorious, twitter, django snippets
* Ability to filter what is put on your timeline (exclude your private projects)

<</float>>


Installation

Requirements:

Get the code:

hg clone https://bruno@bitbucket.org/bruno/dotim/
cd dotim

Run the tests and check everything is fine:

python manage.py test --settings=test_settings

If so, edit local_settings.py and configure your blog. Here is an example of what you can put in local_settings.py:

DEBUG = False
TEMPLATE_DEBUG = DEBUG

ADMINS = (('Your Name', 'your-email@example.com'),)
MANAGERS = ADMINS

MEDIA_URL = 'http://media.example.com/'

TIME_ZONE = 'Europe/Paris'

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_HOST = '' # leave blank if localhost
DATABASE_NAME = 'dotim'
# Optionally set DATABASE_USER and DATABASE_PASSWORD

SERVER_EMAIL = 'admin@example.com'
EMAIL_HOST = 'smtp.example.com'
EMAIL_PORT = 25
EMAIL_SUBJECT_PREFIX = '[Awesome] '

AKISMET_API_KEY = '786398233942'

Once your dotim instance is configured, run python manage.py syncdb and refer to the Django deployment docs for making it available to the guys of the interwebz.

Customization

Settings

A few settings are available to set the title, tagline and footer of your blog. Define them in your local_settings.py:

DOTIM_TITLE = (
    'This goes into the <h1> of your blog',
    'This goes into the <head> » <title> section'
)

DOTIM_FOOTER = """This is the footer. You can put any HTML you want in it"""

DOTIM_TAGLINE = 'This will appear under your blog\'s title'

Site-wide inclusion of custom elements

You can extend the <head> section of your blog and add some custom code just before the closing </body> tag. This is done by creating two templates: head.html and footer.html, in the root of one of your TEMPLATE_DIRS.

  • head.html: here you can put meta tags, include custom CSS files and do whatever you want to add elements to the <head> section.
  • footer.html: this is where you should put your analytics' code (if any), or any javascript code that should appear on every single page.

If you don't need to customize anything, don't bother creating empty templates. Dotim just checks if they're here and keeps going if not.

Updated