Installation

Acrylamid doesn’t reinvent the wheel. It integrates a lot of useful projects to provide a feature-rich user experience. You can use acrylamid in a very minimalistic way and write your posts in plain markdown or add more expensive features you may not have with dynamic web pages such as code highlighting, typography, MathML and hyphenation.

Linux/Debian and OS X

You’ll need the python interpreter with version ≥ 2.6 and a python package manager. If you are on Linux (Debian-based), just apt-get install python python-setuputils. If you are using OS X the proper Python version is already installed (10.6 or later).

$> easy_install -U acrylamid

And you are done with the simplest setup (by the way even markdown and translitcodec are not must-have dependency). You can install all supprted modules via easy_install -U acrylamid[full].

Note

Avoid removing translitcodec egg after you started writing your blog. It might break all your permanent links.

Additional Supported Modules

Feature Dependency
reStructuredText docutils
Textile pytextile
Discount discount.
Syntax Highlighting pygments
Typography enhancements smartypants
AsciiMathML to MathML asciimathml
cyrillic/chinese ascii slugs unidecode
non-ASCII text detection python-magic
Mako Templating mako
exact YAML parser PyYAML
Twitter twitter

Asian/Russian Users

If you write in your native language, I recommend to install unidecode for a better ASCII transcription of your characters. If not, provide either a proper ASCII slug in your articles or use a fixed permalink with your native characters.

Acrylamid also tries to detect text files, but that might fail if your post has less than 30% ASCII characters within the first 512 bytes. Therefore you can optionally install python-magic to circumvent this issue.

Windows

Works, but remains uncovered by the developer and test suite.

Python 3

As of Acrylamid 0.4.4 Python 3 is covered by the testsuite. So, in theory it might work. Please report any issues related to Python 3.

Table Of Contents

Related Topics

This Page