summaryrefslogtreecommitdiffstats
path: root/README.rst
diff options
context:
space:
mode:
authorLibravatarAgustin Henze <tin@sluc.org.ar>2013-11-20 16:58:50 -0300
committerLibravatarAgustin Henze <tin@sluc.org.ar>2013-11-20 16:58:50 -0300
commitca94afc07df55cb7fc6fe3b4f3011877b7881195 (patch)
treed81e1f275aa77545f33740723f307a83dde2e0b4 /README.rst
parentf794eee787e9cde54e6b8f53e45d69c9ddc9936a (diff)
Imported Upstream version 6.2.1upstream/6.2.1
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst68
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/