Skip to content

Latest commit

 

History

History
61 lines (43 loc) · 1.86 KB

installation.rst

File metadata and controls

61 lines (43 loc) · 1.86 KB

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. See about for a listing of third-party libraries used.

I'm aware of tools like javascript-based syntax highlighting and browser/javascript provided hyphenation, but the latter is rather slow and a browser may not distuingish between different languages. Acrylamids focuses on plain HTML generation and avoids javascript usage whenever possible.

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).

Note

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

Additional Supported Modules

  • docutils for reStructuredText support
  • textile for Textile support
  • pygments for syntax highlighting
  • asciimathml to write AsciiMathML in Markdown
  • smartypants for nicer typography
  • pyyaml to use the official YAML parser

Windows

Not supported currently.

Python 3

Within the release of 0.3.4 Acrylamid has experimental support for Python 3. I hope 2to3 gets automatically applied, if not:

$ 2to3 -wn -x execfile acrylamid/
$ python setup.py install