diff options
| author | 2013-11-20 16:58:50 -0300 | |
|---|---|---|
| committer | 2013-11-20 16:58:50 -0300 | |
| commit | ca94afc07df55cb7fc6fe3b4f3011877b7881195 (patch) | |
| tree | d81e1f275aa77545f33740723f307a83dde2e0b4 /README.rst | |
| parent | f794eee787e9cde54e6b8f53e45d69c9ddc9936a (diff) | |
Imported Upstream version 6.2.1upstream/6.2.1
Diffstat (limited to 'README.rst')
| -rw-r--r-- | README.rst | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..afa5500 --- /dev/null +++ b/README.rst @@ -0,0 +1,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/ |
