Metadata-Version: 2.4
Name: Nikola
Version: 8.3.3
Summary: A modular, fast, simple, static website and blog generator
Author-email: Roberto Alsina and others <info@getnikola.com>
Maintainer-email: Roberto Alsina <roberto@getnikola.com>, Chris Warrick <chris@getnikola.com>
License: Copyright © 2012-2025 Roberto Alsina and others.
        
        Permission is hereby granted, free of charge, to any
        person obtaining a copy of this software and associated
        documentation files (the "Software"), to deal in the
        Software without restriction, including without limitation
        the rights to use, copy, modify, merge, publish,
        distribute, sublicense, and/or sell copies of the
        Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice
        shall be included in all copies or substantial portions of
        the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
        KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
        WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
        PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
        OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
        OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
        OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
        SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
Project-URL: homepage, https://getnikola.com/
Project-URL: documentation, https://getnikola.com/documentation.html
Project-URL: issues, https://github.com/getnikola/nikola/issues
Project-URL: changelog, https://github.com/getnikola/nikola/blob/master/CHANGES.txt
Keywords: website,blog,static
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Plugins
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Text Processing :: Markup
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
License-File: AUTHORS.txt
Requires-Dist: doit>=0.33.1
Requires-Dist: Pygments>=2.4.2
Requires-Dist: Pillow>=9.1.0
Requires-Dist: python-dateutil>=2.8.2
Requires-Dist: docutils>=0.19
Requires-Dist: mako>=1.0.9
Requires-Dist: Markdown>=3.0
Requires-Dist: unidecode>=0.4.16
Requires-Dist: lxml>=4.5.2
Requires-Dist: PyRSS2Gen>=1.1
Requires-Dist: blinker>=1.3
Requires-Dist: setuptools>=60.0.5
Requires-Dist: natsort>=5.1.0
Requires-Dist: requests>=2.31.0
Requires-Dist: piexif>=1.0.3
Requires-Dist: Babel>=2.12.0
Provides-Extra: extras
Requires-Dist: Jinja2>=3.1.0; extra == "extras"
Requires-Dist: hsluv>=5.0.0; extra == "extras"
Requires-Dist: pyphen>=0.9.1; extra == "extras"
Requires-Dist: micawber>=0.3.0; extra == "extras"
Requires-Dist: pygal>=2.0.11; extra == "extras"
Requires-Dist: typogrify>=2.0.4; extra == "extras"
Requires-Dist: phpserialize>=1.3; extra == "extras"
Requires-Dist: notebook>=6.0.0; extra == "extras"
Requires-Dist: ipykernel>=6.21.2; extra == "extras"
Requires-Dist: ghp-import>=1.0.0; extra == "extras"
Requires-Dist: aiohttp>=3.8.6; extra == "extras"
Requires-Dist: watchdog>=2.3.0; extra == "extras"
Requires-Dist: ruamel.yaml>=0.15.98; extra == "extras"
Requires-Dist: toml>=0.9.2; extra == "extras"
Requires-Dist: html5lib>=1.0.1; extra == "extras"
Provides-Extra: tests
Requires-Dist: coverage>=4.5.1; extra == "tests"
Requires-Dist: pytest>=4.3.0; extra == "tests"
Requires-Dist: pytest-cov>=2.6.1; extra == "tests"
Requires-Dist: feedparser>=6.0.10; extra == "tests"
Requires-Dist: freezegun>=0.3.10; extra == "tests"
Requires-Dist: flake8>=3.7.7; extra == "tests"
Requires-Dist: pydocstyle>=6.3.0; extra == "tests"
Provides-Extra: docs
Requires-Dist: pyparsing>=2.0.2; extra == "docs"
Requires-Dist: Sphinx>=4.2.0; extra == "docs"
Dynamic: license-file

Nikola, a Static Site and Blog Generator
========================================

In goes content, out comes a website, ready to deploy.

.. image:: http://img.shields.io/pypi/v/Nikola.svg
   :target: https://pypi.python.org/pypi/Nikola

.. image:: https://github.com/getnikola/nikola/workflows/Nikola%20CI/badge.svg
   :target: https://github.com/getnikola/nikola/actions

.. image:: http://img.shields.io/badge/license-MIT-green.svg
   :target: https://github.com/getnikola/nikola/blob/master/LICENSE.txt

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 the dozens of `available 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 50 languages.`__
* Doesn't reinvent wheels, leverages existing tools.
* Python 3.8+ compatible.

.. _Nikola Handbook: https://getnikola.com/handbook.html#why-static
__ https://users.getnikola.com/
.. _Themable: https://themes.getnikola.com
.. _doit: https://pydoit.org
.. _available plugins: https://plugins.getnikola.com/
.. _reStructuredText: https://getnikola.com/quickstart.html
.. _image galleries: https://getnikola.com/galleries/demo/
__ https://www.transifex.com/projects/p/nikola/

Nikola Architecture
-------------------

.. image:: https://getnikola.com/images/architecture.png

Installation Instructions
-------------------------

Assuming you have pip installed::

    pip install Nikola

For optional features::

    pip install "Nikola[extras]"

For tests::

    pip install "Nikola[extras,tests]"

For more information, see https://getnikola.com/
