Skip to content
Permalink
Browse files

Nikola v7.7.9

Signed-off-by: Chris Warrick <kwpolska@gmail.com>
  • Loading branch information
Kwpolska committed Jun 11, 2016
1 parent 0e36e51 commit b0f74153fa419b344cb129a02174f5b7b4120dcc
@@ -57,7 +57,8 @@
# it Italian
# ja Japanese [NOT jp]
# ko Korean
# nb Norwegian Bokmål
# lt Lithuanian
# nb Norwegian (Bokmål)
# nl Dutch
# pa Punjabi
# pl Polish
@@ -1082,7 +1083,8 @@
# - description
#
# An example re is the following:
# '(?P<date>\d{4}-\d{2}-\d{2})-(?P<slug>.*)-(?P<title>.*)\.md'
# '.*\/(?P<date>\d{4}-\d{2}-\d{2})-(?P<slug>.*)-(?P<title>.*)\.rst'
# (Note the '.*\/' in the beginning -- matches source paths relative to conf.py)
# FILE_METADATA_REGEXP = None

# If you hate "Filenames with Capital Letters and Spaces.md", you should
@@ -0,0 +1,62 @@
.. title: Nikola v7.7.9 is out!
.. slug: nikola-v779-is-out
.. date: 2016-06-11 09:45:22 UTC
.. tags: nikola, planet, python, programming, release
.. author: Chris Warrick
.. type: text

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

For this release, we also passed a milestone — Nikola has got over 1000 stars on GitHub. Thanks for the continued support!

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`__.

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

Changes
=======

Features
--------

* New ``sc`` or ``html`` reST role, which passes content unaltered (Issue #1854)
* Point the user to our users site after 1st successful deploy (Issue #2096)
* Option to disable color output using ``NIKOLA_MONO`` environment
variable (Issue #2360)
* Improved locale detection in Windows (Issue #2343)
* Added ``enclosure_length`` meta field for better interop (Issue #2338)
* New Lithuanian translation by Antanas Lasys

Bugfixes
--------

* Avoid conflicts caused by multiple copies of the same plugin (#2362)
* Fix handling of some wordpress dumps (Issue #2340)
* When using the plugin command, load ALL plugins (Issue #2359)
* Fix plugin removal for plugins that are a package (Issue #2356)
* Reload English messages for every theme to prevent caching (Issue #2347)
* Cache theme messages after loading once (Issue #2344)
* Add ``<link>`` tags to other languages even if the post is
untranslated (Google complained otherwise)
* Don't call sys.exit() from plugins if possible (Issue #1839)
* Create Persistor directories only if site is configured (Issue #2334)
* Remove newlines in imported WordPress titles (Issue #2330)
@@ -1,3 +1,3 @@
{
"last_deploy": "2016-04-29T14:13:48.209536"
"last_deploy": "2016-06-11T10:16:54.350844"
}
@@ -83,6 +83,7 @@
* `Sean Pue <https://github.com/seanpue>`_
* `Simon van der Veldt <https://github.com/simonvanderveldt>`_
* `Stefan Näwe <https://github.com/snaewe>`_
* `Sukil Etxenike <https://github.com/sukiletxe>`_
* `Thibauld Nion <https://github.com/tibonihoo>`_
* `Thomas Burette <https://github.com/tburette>`_
* `Tim Chase <https://github.com/Gumnos>`_
@@ -1,3 +1,34 @@
New in v7.7.9
=============

(1000+ stars on GitHub — thanks!)

Features
--------

* New ``sc`` or ``html`` reST role, which passes content unaltered (Issue #1854)
* Point the user to our users site after 1st successful deploy (Issue #2096)
* Option to disable color output using ``NIKOLA_MONO`` environment
variable (Issue #2360)
* Improved locale detection in Windows (Issue #2343)
* Added ``enclosure_length`` meta field for better interop (Issue #2338)
* New Lithuanian translation by Antanas Lasys

Bugfixes
--------

* Avoid conflicts caused by multiple copies of the same plugin (#2362)
* Fix handling of some wordpress dumps (Issue #2340)
* When using the plugin command, load ALL plugins (Issue #2359)
* Fix plugin removal for plugins that are a package (Issue #2356)
* Reload English messages for every theme to prevent caching (Issue #2347)
* Cache theme messages after loading once (Issue #2344)
* Add ``<link>`` tags to other languages even if the post is
untranslated (Google complained otherwise)
* Don't call sys.exit() from plugins if possible (Issue #1839)
* Create Persistor directories only if site is configured (Issue #2334)
* Remove newlines in imported WordPress titles (Issue #2330)

New in v7.7.8
=============

@@ -9,6 +40,7 @@ Features
Bugfixes
--------

* Fix folder handling and redirects in ``nikola auto`` (Issue #2331)
* Use state files in ``nikola github_deploy`` and ``nikola status``
(Issue #2317)
* Add ``align`` options for ``youtube``, ``vimeo``, ``soundcloud``
@@ -1,10 +1,10 @@
.. title: Nikola v7.7.8 configuration file
.. title: Nikola v7.7.9 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.7.8 is reproduced below.
The default config file for Nikola v7.7.9 is reproduced below.

.. listing:: conf.py python
@@ -9,7 +9,7 @@
Extending Nikola
================

:Version: 7.7.8
:Version: 7.7.9
:Author: Roberto Alsina <ralsina@netmanagers.com.ar>

.. class:: alert alert-info pull-right
@@ -557,11 +557,11 @@ Shortcodes

Some (hopefully all) markup compilers support shortcodes in these forms::

{{% foo %}} # No arguments
{{% raw %}}{{% foo %}} # No arguments
{{% foo bar %}} # One argument, containing "bar"
{{% foo bar baz=bat %}} # Two arguments, one containing "bar", one called "baz" containing "bat"

{{% foo %}}Some text{{% /foo %}} # one argument called "data" containing "Some text"
{{% foo %}}Some text{{% /foo %}} # one argument called "data" containing "Some text"{{% /raw %}}

So, if you are creating a plugin that generates markup, it may be a good idea
to register it as a shortcode in addition of to restructured text directive or
@@ -9,7 +9,7 @@
The Nikola Handbook
===================

:Version: 7.7.8
:Version: 7.7.9

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

@@ -813,7 +813,11 @@ 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 {{% raw %}}{{% name parameters %}}{{% /raw %}} 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 this form::

{{% raw %}}{{% name parameters %}}{{% /raw %}}

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".

@@ -823,6 +827,19 @@ Example of a paired shortcode (note that we don't have a highlight shortcode yet

{{% raw %}}{{% highlight python %}} A bunch of code here {{% /highlight %}}{{% /raw %}}

.. note:: Shortcodes and reStructuredText

In reStructuredText shortcodes may fail because docutils turns URL into links and everything breaks.
For some shortcodes there are alternative docutils directives (example, you can use the media
**directive** instead of the media shortcode.

Also, you can use the shortcode **role**::

:sc:`{{% raw %}}{{% shortcode here %}}{{% /raw %}}`

That role passes text unaltered, so shortcodes behave correctly.


Built-in shortcodes
~~~~~~~~~~~~~~~~~~~

@@ -834,7 +851,6 @@ media

{{% 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
@@ -848,8 +864,10 @@ chart
'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)
raw
Passes the content along, mostly used so I can write this damn section and you can see the shortcodes instead
of them being munged into shortcode **output**. I can't show an example because Inception.


Community shortcodes
~~~~~~~~~~~~~~~~~~~~
@@ -9,7 +9,7 @@
Using Alternative Social Buttons with Nikola
============================================

:Version: 7.7.8
:Version: 7.7.9

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

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

:Version: 7.7.8
:Version: 7.7.9
:Author: Roberto Alsina <ralsina@netmanagers.com.ar>

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

0 comments on commit b0f7415

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