Skip to content
Permalink
Browse files

Nikola v7.8.10

Signed-off-by: Chris Warrick <kwpolska@gmail.com>
  • Loading branch information
Kwpolska committed Sep 10, 2017
1 parent 083922b commit 81bf50815f2eeec91a9e5c1be37aeec83cb046a5
@@ -0,0 +1,43 @@
.. title: Nikola v7.8.10 is out! (maintenance release)
.. slug: nikola-v7810-is-out-maintenance-release
.. date: 2017-09-10 16:54:33 UTC
.. tags: nikola, planet, python, programming, release
.. category:
.. link:
.. description:
.. type: text
.. author: Chris Warrick

On behalf of the Nikola team, I am pleased to announce the immediate
availability of Nikola v7.8.10. This is a maintenance release for the
v7 series.

Future releases in the v7 series are going to be small maintenance
releases that include bugfixes only, as work on v8.0.0 is underway.

What is Nikola?
===============

Nikola is a static site and blog generator, written in Python.
It can use Mako and Jinja2 templates, and input in many popular markup
formats, such as reStructuredText and Markdown — and can even turn
Jupyter Notebooks into blog posts! It also supports image galleries,
and is multilingual. Nikola is flexible, and page builds are extremely
fast, courtesy of doit (which is rebuilding only what has been changed).

Find out more at the website: https://getnikola.com/

Downloads
=========

Install using ``pip install Nikola`` or download tarballs on `GitHub`__ and `PyPI`__.

__ https://github.com/getnikola/nikola/releases/tag/v7.8.10
__ https://pypi.python.org/pypi/Nikola/7.8.10

Changes
=======

* Fix crashes with Jinja2 themes and tag indexes (Issue #2900)
* Ignore empty tags in HTML metadata reader (Issue #2890)
* Fix crash when compiling empty ``.html`` posts (Issue #2851)
@@ -1,3 +1,3 @@
{
"last_deploy": "2017-08-28T11:10:05.303535"
"last_deploy": "2017-09-10T16:56:33.189432"
}
@@ -1,3 +1,10 @@
New in v7.8.10
==============

* Fix crashes with Jinja2 themes and tag indexes (Issue #2900)
* Ignore empty tags in HTML metadata reader (Issue #2890)
* Fix crash when compiling empty ``.html`` posts (Issue #2851)

New in v7.8.9
=============

@@ -1,11 +1,11 @@
.. title: Nikola v7.8.9 configuration file
.. title: Nikola v7.8.10 configuration file
.. slug: conf
.. date: 2014-11-08 18:51:30 UTC
.. description: The Nikola configuration file.
.. type: text
.. author: The Nikola Team

The default config file for Nikola v7.8.9 is reproduced below.
The default config file for Nikola v7.8.10 is reproduced below.

.. raw:: html

@@ -60,9 +60,6 @@ configuration file:
# And to avoid a conflict because blogs try to generate /index.html
INDEX_PATH = "blog"

# Or you can disable blog indexes altogether:
# DISABLE_INDEXES_PLUGIN_INDEX_AND_ATOM_FEED = True


And now we are ready to create our first page:

@@ -1,4 +1,3 @@
.. title: Creating a Theme
.. slug: creating-a-theme
.. date: 2015-05-28 18:46:48 UTC
.. tags:
@@ -18,7 +17,7 @@ create themes. Since I **suck** at designing websites, I asked for opinions on t
and got some feedback. Since this is **Not So Hard™**, I will try to make time to port a few
and see what happens.

If you are looking for a reference, check out :doc:`Theming reference <theming>` and `Template variables <https://getnikola.com/template-variables.html>`_.
If you are looking for a reference, check out `Theming reference <theming.html>`_ and `Template variables <https://getnikola.com/template-variables.html>`_.

Today’s theme is `Lanyon <https://github.com/poole/lanyon>`__ which is written by `@mdo <https://twitter.com/mdo>`__
and released under a MIT license, which is liberal enough.
@@ -827,5 +826,3 @@ The End
And that’s it, that’s a whole theme. Eventually, once people start using it, they will notice small broken details, which will need handling one at a time.

This theme should be available in http://themes.getnikola.com/v7/lanyon/ and you can see it in action at https://themes.getnikola.com/v7/lanyon/demo/ .

What if you want to extend other parts of the theme? Check out the :doc:`Theming reference <theming>`. You can also contribute your improvements to the `nikola-themes <https://github.com/getnikola/nikola>` repository on GitHub.
@@ -9,7 +9,7 @@
Extending Nikola
================

:Version: 7.8.9
:Version: 7.8.10
:Author: Roberto Alsina <ralsina@netmanagers.com.ar>

.. class:: alert alert-info pull-right
@@ -9,7 +9,7 @@
The Nikola Handbook
===================

:Version: 7.8.9
:Version: 7.8.10

.. class:: alert alert-info pull-right

@@ -24,9 +24,9 @@ After you have Nikola `installed <https://getnikola.com/getting-started.html>`_:
Create an empty site (with a setup wizard):
``nikola init mysite``

You can create a site with demo files in it with ``nikola init --demo mysite``
You can create a site with demo files in it with ``nikola init --demo mysite``

The rest of these commands have to be executed inside the new ``mysite`` folder.
The rest of these commands have to be executed inside the new ``mysite`` folder.

Create a post:
``nikola new_post``
@@ -9,7 +9,7 @@
Using Alternative Social Buttons with Nikola
============================================

:Version: 7.8.9
:Version: 7.8.10

.. class:: alert alert-info pull-right

@@ -4,7 +4,7 @@
.. description: Get help using Nikola, or contact us.
.. author: The Nikola Team
:Version: 7.8.9
:Version: 7.8.10

.. class:: alert alert-info pull-right

@@ -3,7 +3,7 @@
.. date: 2017-04-13 12:00:00
.. author: The Nikola Team
:Version: 7.8.9
:Version: 7.8.10
:Author: Chris Warrick <chris@getnikola.com>

Variables available in templates are listed below.
@@ -9,7 +9,7 @@
Theming Nikola
==============

:Version: 7.8.9
:Version: 7.8.10
:Author: Roberto Alsina <ralsina@netmanagers.com.ar>

.. class:: alert alert-info pull-right
@@ -19,7 +19,7 @@ Theming Nikola
.. class:: lead

This document is a reference about themes. If you want a tutorial, please read
:doc:`Creating a Theme <creating-a-theme>`. If you’re looking for a ready-made
`Creating a Theme <creating-a-theme.html>`_. If you’re looking for a ready-made
theme for your site, check out the `Themes Index <https://themes.getnikola.com/>`_.

The Structure
@@ -176,36 +176,11 @@ should learn one first. What engine is used by the theme is declared in the ``en
you can install Beaker and `make templates be cached <http://docs.makotemplates.org/en/latest/caching.html>`__


Both template engines have a nifty concept of template inheritance. That means that a
Both template engines have a nifty concept of template inheritance. That means that, a
template can inherit from another and only change small bits of the output. For example,
``base.tmpl`` defines the whole layout for a page but has only a placeholder for content
so ``post.tmpl`` only define the content, and the layout is inherited from ``base.tmpl``.

Another concept is theme inheritance. You do not need to duplicate all the
default templates in your theme — you can just override the ones you want
changed, and the rest will come from the parent theme. (Every theme needs a
parent.)

Apart from the `built-in templates`_ listed below, you can add other templates for specific
pages, which the user can then use in his ``POSTS`` or ``PAGES`` option in
``conf.py``. Also, you can specify a custom template to be used by a post or
page via the ``template`` metadata, and custom templates can be added in the
``templates/`` folder of your site.

If you want to modify (override) a built-in template, use ``nikola theme -c
<name>.tmpl``. This command will copy the specified template file to the
``templates/`` directory of your currently used theme.

Keep in mind that your theme is *yours*, so you can require whatever data you
want (eg. you may depend on specific custom ``GLOBAL_CONTEXT`` variables, or
post meta attributes). You don’t need to keep the same theme structure as the
default themes do (although many of those names are hardcoded). Inheriting from
at least ``base`` (or ``base-jinja``) is heavily recommended, but not strictly
required (unless you want to share it on the Themes Index).

Built-in templates
------------------

These are the templates that come with the included themes:

``base.tmpl``
@@ -223,7 +198,7 @@ These are the templates that come with the included themes:
``annotation_helper.tmpl`` (internal)
Code for the optional annotations feature.

``archive_navigation_helper.tmpl`` (internal)
``archive_navigation_helper.tmpl``
Code that implements archive navigation (previous/up/next). Included by
archive templates.

@@ -304,6 +279,15 @@ These are the templates that come with the included themes:
``tags.tmpl``
Used to display the list of tags and categories.

You can add other templates for specific pages, which the user can then use in his ``POSTS``
or ``PAGES`` option in ``conf.py``. Also, keep in mind that your theme is
*yours*, there is no reason why you would need to maintain the inheritance as
it is, or not require whatever data you want (eg. you may depend on specific
custom ``GLOBAL_CONTEXT`` variables, or post meta attributes)

Also, you can specify a custom template to be used by a post or page via the ``template`` metadata,
and custom templates can be added in the ``templates/`` folder of your site.

Variables available in templates
--------------------------------

0 comments on commit 81bf508

Please sign in to comment.
You can’t perform that action at this time.