Tinkerer

Blogging for Pythonistas

How to Tinker?

Get Tinkerer:

easy_install -U Tinkerer

Skim through the Documentation.

Sphinx Documentation

Tinkerer is powered by Sphinx so a lot of useful information can be found on the Sphinx webiste.

Get Involved

Have a question? Have an answer? Join the google group.

Found an issue? Report it on the issue tracker.

Also please consider contributing your themes and extensions. Patches are also welcomed :)

You can also follow Tinkerer on Bitbucket.

Tinkerer 0.3 Beta Released

What’s New

  • Tinkerer went international! Spanish and Catalan translations are now available. To have your Tinkerer blog displayed in Spanish, add the following line to your conf.py:

    language = "es"
    

    For Catalan, add:

    language = "ca"
    
  • Limited support for Facebook Comments as an alternative to Disqus comments

  • RSS feed enhancements: RSS feed auto-discovery and feed categories

  • Multiple bugfixes and minor style tweaks to the Modern theme

Tinkerer 0.2 Beta Released

What’s New

  • Support for Drafts.
  • Fixes for cross-references and embedded images which were not displaying correctly on home page and RSS feed.
  • Ensure Tinkerer runs only from the blog root directory unless when setting up a new blog (this prevents accidental deletes and mysterious exceptions).
  • Minimal support for documentation - prev and next links will be displayed on pages under doc/ or docs/ path.
  • Many other small extension fixes.
  • CSS fixes (gradient not showing in Firefox, page not scaling correctly on retina displays, many other small tweaks).

Upgrading from 0.1

There are a couple of steps required if upgrading from 0.1:

  • In your conf.py replace:

    # Add file patterns to exclude from build
    exclude_patterns = []
    

    with:

    # Add file patterns to exclude from build
    exclude_patterns = ["drafts/*"]
    

    This will make Sphinx stop warning you about drafts not being included in the build.

  • Make sure your master.rst file ends with a blank line. If not, append a blank line at the end of it.

Thank You!

A big Thank You to everyone who showed interest in the project and for the valuable feedback you provided.

Tinkerer 0.1 Beta is Out!

What is Tinkerer?

Tinkerer is a blogging engine/static website generator powered by Sphinx.

It allows blogging in reStructuredText format, comes with out-of-the-box support for post publishing dates, authors, categories, tags, post archive, RSS feed generation, comments powered by Disqus and more.

Tinkerer is also highly customizable through Sphinx extensions.

Why Tinkerer?

  • Because “hacker” is way overused nowadays.
  • Because static websites are cool.
  • Because you already write documentation in RST format and you love it.
  • Because you have Pygments for sharing highlighted code.
  • Because you can use your favorite Sphinx extensions right away.

How to Tinker?

Get Tinkerer:

easy_install -U Tinkerer

Skim through the Documentation.

Fork me