1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
Nikola, a Static Site and Blog Generator
========================================
In goes content, out comes a website, ready to deploy.
.. image:: https://travis-ci.org/getnikola/nikola.png
:target: https://travis-ci.org/getnikola/nikola
.. image:: https://pypip.in/v/Nikola/badge.png
:target: https://crate.io/packages/Nikola
.. image:: https://pypip.in/d/Nikola/badge.png
:target: https://crate.io/packages/Nikola
.. image:: https://coveralls.io/repos/getnikola/nikola/badge.png?branch=master
:target: https://coveralls.io/r/getnikola/nikola?branch=master
Why Static Websites?
--------------------
Static websites are safer, use fewer resources, and avoid vendor and platform lock-in.
You can read more about this in the `Nikola Handbook`_
What Can Nikola Do?
-------------------
It has many features, but here are some of the nicer ones:
* `Blogs, with tags, feeds, archives, comments, etc.`__
* `Themable`_
* Fast builds, thanks to `doit`_
* Flexible, extensible via plugins
* Small codebase (programmers can understand all of Nikola core in a day)
* `reStructuredText`_ or Markdown as input language (also Wiki, BBCode, Textile, and HTML)
* Easy `image galleries`_ (just drop files in a folder!)
* Syntax highlighting for almost any programming language or markup
* Multilingual sites, `translated to 18 languages.`__
* Doesn't reinvent wheels, leverages existing tools.
* Python 2.6, 2.7 and 3.3 compatible.
.. _Nikola Handbook: http://getnikola.com/handbook.html#why-static
__ http://users.getnikola.com/
.. _Themable: http://themes.getnikola.com
.. _doit: http://pydoit.org
.. _reStructuredText: http://getnikola.com/quickstart.html
.. _image galleries: http://getnikola.com/galleries/demo/
__ https://www.transifex.com/projects/p/nikola/
Installation Instructions
-------------------------
Assuming you have pip installed::
git clone git://github.com/getnikola/nikola.git
cd nikola
pip install .
Optionally (for markdown and lots of other features)::
pip install -r requirements.txt
For even more stuff, like tests and very optional features::
pip install -r requirements-full.txt
For more information, see http://getnikola.com/
|