Skip to content
Permalink
Browse files
v7.7.7
  • Loading branch information
ralsina committed Mar 10, 2016
1 parent cb1869d commit 3a2642640d5f612ebf3bc2ce0b6a5852dbfb893f
@@ -463,6 +463,12 @@
# output / TRANSLATION[lang] / INDEX_PATH / index-*.html
# INDEX_PATH = ""

# Optional HTML that displayed on “main” blog index.html files.
# May be used for a greeting. (translatable)
FRONT_INDEX_HEADER = {
DEFAULT_LANG: ''
}

# Create per-month archives instead of per-year
# CREATE_MONTHLY_ARCHIVE = False
# Create one large archive instead of per-year
@@ -634,6 +640,11 @@
#
# If set to False, it will sort by filename instead. Defaults to True
# GALLERY_SORT_BY_DATE = True

# If set to True, EXIF data will be copied when an image is thumbnailed or
# resized.
# PRESERVE_EXIF_DATA = False

#
# Folders containing images to be used in normal posts or pages. Images will be
# scaled down according to IMAGE_THUMBNAIL_SIZE and MAX_IMAGE_SIZE options, but
@@ -0,0 +1,51 @@
.. title: Nikola v7.7.7 is out!
.. slug: nikola-v777-is-out
.. date: 2016-03-10 17:16:24 UTC
.. tags: nikola, planet, python, programming, release
.. category:
.. link:
.. description:
.. type: text

On behalf of the Nikola team, I am pleased to announce the immediate availability of Nikola v7.7.7. It fixes some bugs and adds new features.

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 (IPython) 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][].

[GitHub]: https://github.com/getnikola/nikola/releases/tag/v7.7.7
[PyPI]: https://pypi.python.org/pypi/Nikola/7.7.7

Changes
=======

Features
--------

* New ``--one-file`` option to wordpress importer (Issue #2262)
* New Pygal-based chart shortcode (Issue #2170)
* Add ``post_type`` to post-list directive (Issue #2272)
* Use ``sys.executable`` for launching pip in ``plugin`` (Issue #2275)

Bugfixes
--------

* Fix Indonesian translation (Issue #2291)
* Fix a JSON conversion bug in the WordPress importer (Issue #2264)
* Don’t create download directories when not downloading WordPress
attachments (Issue #2260)
* Don’t display "Good link" messages in ``nikola check -l`` by default,
can be re-enabled with ``-v`` option (Issue #2268)
* Fix a format string in ``nikola check`` (Issue #2267)
* Don't crash wordpress importer when posts are "empty" (Issue #2263)
* Don't put untranslated and nonexistant posts in sitemap (Issue #2289)

@@ -1,3 +1,27 @@
New in v7.7.7
=============

Features
--------

* New ``--one-file`` option to wordpress importer (Issue #2262)
* New Pygal-based chart shortcode (Issue #2170)
* Add ``post_type`` to post-list directive (Issue #2272)
* Use ``sys.executable`` for launching pip in ``plugin`` (Issue #2275)

Bugfixes
--------

* Fix Indonesian translation (Issue #2291)
* Fix a JSON conversion bug in the WordPress importer (Issue #2264)
* Don’t create download directories when not downloading WordPress
attachments (Issue #2260)
* Don’t display “Good link” messages in ``nikola check -l`` by default,
can be re-enabled with ``-v`` option (Issue #2268)
* Fix a format string in ``nikola check`` (Issue #2267)
* Don't crash wordpress importer when posts are "empty" (Issue #2263)
* Don't put untranslated and nonexistant posts in sitemap (Issue #2289)

New in v7.7.6
=============

@@ -1,4 +1,4 @@
.. title: Nikola v7.7.6 configuration file
.. title: Nikola v7.7.7 configuration file
.. slug: conf
.. date: 2014-11-08 18:51:30 UTC
.. description: The Nikola configuration file.
@@ -9,7 +9,7 @@
Extending Nikola
================

:Version: v7.7.6
:Version: 7.7.7
:Author: Roberto Alsina <ralsina@netmanagers.com.ar>

.. class:: alert alert-info pull-right
@@ -495,7 +495,7 @@ Here's the relevant code from the tag plugin.
# path elements.
def tag_rss_path(self, name, lang):
return [_f for _f in [self.site.config['TRANSLATIONS'][lang],
self.site.config['TAG_PATH'], self.slugify_name(name) + ".xml"] if
self.site.config['TAG_PATH'], self.slugify_name(name, lang) + ".xml"] if
_f]

Template Hooks
@@ -9,7 +9,7 @@
The Nikola Handbook
===================

:Version: v7.7.6
:Version: 7.7.7

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

@@ -813,7 +813,7 @@ To use them from plugins, please see `Extending Nikola <https://getnikola.com/ex
Using a shortcode
~~~~~~~~~~~~~~~~~

In your content files, a shortcode can be called by using the ``{{% name parameters %}}`` form. Shortcode parameters are space delimited. Parameters with spaces can be quoted (or backslash escaped).
In your content files, a shortcode can be called by using the {{% raw %}}{{% name parameters %}}{{% /raw %}} form. Shortcode parameters are space delimited. Parameters with spaces can be quoted (or backslash escaped).

The first word is always the name of the shortcode. Parameters follow the name. Depending upon how the shortcode is defined, the parameters may be named, positional or both. The format for named parameters models that of HTML with the format name="value".

@@ -829,6 +829,27 @@ Built-in shortcodes
post-list
Will show a list of posts, see the `Post List directive for details <#post-list>`__

media
Display media embedded from a URL, for example, this will embed a youtube video::

{{% raw %}}{{% media url="https://www.youtube.com/watch?v=Nck6BZga7TQ" %}}{{% /raw %}}

In reStructuredText this shortcode will fail because docutils turns that URL to a link and everything breaks, use the `media directive <#media>`__ instead.

chart
Create charts via PyGal. This is similar to the `chart directive <#chart>`__ except the syntax is adapted to
shortcodes. This is an example::

{{% raw %}}{{% chart Bar title='Browser usage evolution (in %)' %}}
x_labels='["2002","2003","2004","2005","2006","2007","2008","2009","2010","2011","2012"]'%}}
'Firefox', [None, None, 0, 16.6, 25, 31]
'Chrome', [None, None, None, None, None, None]
'IE', [85.8, 84.6, 84.7, 74.5, 66, 58.6]
'Others', [14.2, 15.4, 15.3, 8.9, 9, 10.4]
{{% /chart %}}{{% /raw %}}

In reStructuredText the quoting needed to pass arguments gets insane really fast, use the chart directive
instead (the syntax is nicer anyway)

Template-based shortcodes
~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1388,13 +1409,14 @@ The currently available filters are:
.. sidebar:: Creating your own filters

You can use any program name that works in place as a filter, like ``sed -i``
and you can use arbitrary python functions as filters, too.
and you can use arbitrary Python functions as filters, too.

If your program doesn't run in-place, then you can use Nikola's runinplace function.
If your program doesn't run in-place, then you can use Nikola's ``runinplace`` function (from the ``filters`` module).
For example, this is how the yui_compressor filter is implemented:

.. code-block:: python

from nikola.filters import runinplace
def yui_compressor(infile):
return runinplace(r'yui-compressor --nomunge %1 -o %2', infile)

@@ -2,8 +2,8 @@
.. slug: path-handlers
.. author: The Nikola Team

Nikola supports special links with the syntax ``link://kind/name``. Here is
the description for all the supported kinds.
Nikola supports special links with the syntax ``link://kind/name``. In the templates you can also
use ``_link(kind, name)`` Here is the description for all the supported kinds.

.. class:: dl-horizontal

@@ -204,7 +204,7 @@ slug

Example:

links://slug/yellow-camaro => /posts/cars/awful/yellow-camaro/index.html
link://slug/yellow-camaro => /posts/cars/awful/yellow-camaro/index.html


tag
@@ -9,7 +9,7 @@
Using Alternative Social Buttons with Nikola
============================================

:Version: v7.7.6
:Version: 7.7.7

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

@@ -9,7 +9,7 @@
Theming Nikola
==============

:Version: v7.7.6
:Version: 7.7.7
:Author: Roberto Alsina <ralsina@netmanagers.com.ar>

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

0 comments on commit 3a26426

Please sign in to comment.