v7.7.7

ralsina · ralsina · commit 3a2642640d5f · 2016-03-10T14:34:40.000-03:00
diff --git a/listings/conf.py b/listings/conf.py
@@ -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
diff --git a/posts/nikola-v777-is-out.md b/posts/nikola-v777-is-out.md
@@ -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)
+
diff --git a/stories/CHANGES.txt b/stories/CHANGES.txt
@@ -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
 =============
 
diff --git a/stories/conf.txt b/stories/conf.txt
@@ -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.
diff --git a/stories/extending.txt b/stories/extending.txt
@@ -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
diff --git a/stories/manual.txt b/stories/manual.txt
@@ -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)
 
diff --git a/stories/path_handlers.txt b/stories/path_handlers.txt
@@ -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
diff --git a/stories/social_buttons.txt b/stories/social_buttons.txt
@@ -9,7 +9,7 @@
 Using Alternative Social Buttons with Nikola
 ============================================
 
-:Version: v7.7.6
+:Version: 7.7.7
 
 .. class:: alert alert-info pull-right
 
diff --git a/stories/theming.txt b/stories/theming.txt
@@ -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

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. title: Nikola v7.7.6 configuration file`
	`1`	`+.. title: Nikola v7.7.7 configuration file`
`2`	`2`	`.. slug: conf`
`3`	`3`	`.. date: 2014-11-08 18:51:30 UTC`
`4`	`4`	`.. description: The Nikola configuration file.`