Skip to content
Permalink
Browse files

merge master

Signed-off-by: Chris Warrick <kwpolska@gmail.com>
  • Loading branch information
Kwpolska committed Jul 15, 2015
2 parents 0a7fec4 + 493c495 commit 2f80f0b8657ef4fab0f0f55942a8a16c189c36d4
Showing with 175 additions and 39 deletions.
  1. +1 −0 conf.py
  2. +7 −28 listings/conf.py
  3. +79 −0 posts/nikola-761-is-out.txt
  4. +45 −0 stories/CHANGES.txt
  5. +1 −1 stories/conf.txt
  6. +1 −1 stories/extending.txt
  7. +39 −7 stories/manual.txt
  8. +1 −1 stories/social_buttons.txt
  9. +1 −1 stories/theming.txt
@@ -30,6 +30,7 @@
POSTS = (
("posts/*.txt", "blog", "post.tmpl"),
("posts/*.rst", "blog", "post.tmpl"),
("posts/*.md", "blog", "post.tmpl"),
)

PAGES = (
@@ -20,7 +20,7 @@
BLOG_AUTHOR = "Your Name" # (translatable)
BLOG_TITLE = "Demo Site" # (translatable)
# This is the main URL for your site. It will be used
# in a prominent link
# in a prominent link. Don't forget the protocol (http/https)!
SITE_URL = "https://example.com/"
# This is the URL where Nikola's output will be deployed.
# If not set, defaults to SITE_URL
@@ -293,7 +293,7 @@
# "blogging": "Meta-blog posts about blogging about blogging.",
# "open source": "My contributions to my many, varied, ever-changing, and eternal libre software projects."
# },
#}
# }


# If you do not want to display a tag publicly, you can mark it as hidden.
@@ -319,10 +319,10 @@
# using a forward slash ('/') to separate paths. Use a backslash ('\') to escape
# a forward slash or a backslash (i.e. '\//\\' is a path specifying the
# subcategory called '\' of the top-level category called '/').
# CATEGORY_ALLOW_HIERARCHIES = False
CATEGORY_ALLOW_HIERARCHIES = False
# If CATEGORY_OUTPUT_FLAT_HIERARCHY is set to True, the output written to output
# contains only the name of the leaf category and not the whole path.
# CATEGORY_OUTPUT_FLAT_HIERARCHY = False
CATEGORY_OUTPUT_FLAT_HIERARCHY = False

# If CATEGORY_PAGES_ARE_INDEXES is set to True, each category's page will contain
# the posts themselves. If set to False, it will be just a list of links.
@@ -336,7 +336,7 @@
# "blogging": "Meta-blog posts about blogging about blogging.",
# "open source": "My contributions to my many, varied, ever-changing, and eternal libre software projects."
# },
#}
# }

# If you do not want to display a category publicly, you can mark it as hidden.
# The category will not be displayed on the category list page.
@@ -716,8 +716,7 @@
# (Uses the INDEX_FILE setting, so if that is, say, default.html,
# it will instead /foo/default.html => /foo)
# (Note: This was briefly STRIP_INDEX_HTML in v 5.4.3 and 5.4.4)
# Default = False
# STRIP_INDEXES = False
STRIP_INDEXES = False

# Should the sitemap list directories which only include other directories
# and no files.
@@ -882,7 +881,7 @@
# <input type="text" name="q" maxlength="255" results="0" placeholder="Search"/>
# </form>
# <!-- End of custom search -->
#""" % SITE_URL
# """ % SITE_URL

# Use content distribution networks for jQuery, twitter-bootstrap css and js,
# and html5shiv (for older versions of Internet Explorer)
@@ -987,26 +986,6 @@
# sometimes crash Nikola, your web server, or eat your cat.
# USE_SLUGIFY = True

# You can configure the logging handlers installed as plugins or change the
# log level of the default stderr handler.
# WARNING: The stderr handler allows only the loglevels of 'INFO' and 'DEBUG'.
# This is done for safety reasons, as blocking out anything other
# than 'DEBUG' may hide important information and break the user
# experience!

LOGGING_HANDLERS = {
'stderr': {'loglevel': 'INFO', 'bubble': True},
# 'smtp': {
# 'from_addr': 'test-errors@example.com',
# 'recipients': ('test@example.com'),
# 'credentials':('testusername', 'password'),
# 'server_addr': ('127.0.0.1', 25),
# 'secure': (),
# 'level': 'DEBUG',
# 'bubble': True
# }
}

# Templates will use those filters, along with the defaults.
# Consult your engine's documentation on filters if you need help defining
# those.
@@ -0,0 +1,79 @@
.. title: Nikola 7.6.1 is out
.. slug: nikola-761-is-out
.. date: 2015-07-15 15:18:22 UTC
.. tags:
.. category:
.. link:
.. description:
.. type: text

On behalf of the Nikola team, I am pleased to announce the immediate availability of Nikola v7.6.1. 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/

Key Changes since v7.6.0
========================

* Many Wordpress importer improvements
* Modern reST stylesheets, based in part on Bootstrap 3 (Issue #1150)

Downloads
=========

Get it on [GitHub][] and [PyPI][].

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

Changes
=======

Features
--------

* Several improvements to WordPress importer (PR #1867):
* Allowing to export categories and category hierarchy with
--export-categories-as-categories
* Allowing to exclude private posts, and allowing to include empty posts
* Allowing to use HTTP authentication for downloads with --download-auth
(PR #1848)
* Allowing to export comments with --export-comments
* Allowing to use WordPress page compiler to directly convert posts
to HTML on import with --transform-to-html
* Allowing to use WordPress page compiler on imported site instead of
converting posts to markdown with --use-wordpress-compiler
* Allowing to automatically install the WordPress page compiler when
needed with --install-wordpress-compiler
* Exporting information on attachments per post as JSON (#1867 and #1888)
* Exporting post status and excerpt
* New ‘pagekind’ variable available to identify different kind of pages from theme templates
* Add ``--no-server`` option to ``nikola auto`` (Issue #1883)
* Always return unicode in slugify (Issue #1885)
* Remove logging handlers (Issue #1797)
* Add ``-d``, ``--detach`` option to ``nikola serve`` (Issue #1871)
* Use provided teaser format (``*_READ_MORE_LINK``) with custom teaser text
(Issue #1879)
* Delete old ``bootstrap`` theme (use ``bootstrap3`` instead)
* Screen reader-friendly navbar collapses and dropdowns (Issue #1863)
* Modern reST stylesheets, based in part on Bootstrap 3 (Issue #1150)

Bugfixes
--------

* Add missing ``xmlns:xhtml`` namespace to sitemaps (Issue #1890)
* Fixed superfluous rebuild problems with Python 3. Note that this will cause
rebuilds for most sites. (Issue #1887)
* Fix links in sample post (Issue #1874)
* Don't use deprecated Yapsy methods (Isue #1868)
* Surpress wincing when auto is aborted during rebuilding
* Show tags only from the current language on tag listing pages (Issue #1856)
* Remove gap between line numbers and code (Issue #1859)
* Fix spurious warnings about posts published in the future (Issue #1850)


@@ -1,3 +1,48 @@
New in v7.6.1
=============

Features
--------

* Several improvements to WordPress importer (PR #1867):
* Allowing to export categories and category hierarchy with
--export-categories-as-categories
* Allowing to exclude private posts, and allowing to include empty posts
* Allowing to use HTTP authentication for downloads with --download-auth
(PR #1848)
* Allowing to export comments with --export-comments
* Allowing to use WordPress page compiler to directly convert posts
to HTML on import with --transform-to-html
* Allowing to use WordPress page compiler on imported site instead of
converting posts to markdown with --use-wordpress-compiler
* Allowing to automatically install the WordPress page compiler when
needed with --install-wordpress-compiler
* Exporting information on attachments per post as JSON (#1867 and #1888)
* Exporting post status and excerpt
* New ‘pagekind’ variable available to identify different kind of pages from theme templates
* Add ``--no-server`` option to ``nikola auto`` (Issue #1883)
* Always return unicode in slugify (Issue #1885)
* Remove logging handlers (Issue #1797)
* Add ``-d``, ``--detach`` option to ``nikola serve`` (Issue #1871)
* Use provided teaser format (``*_READ_MORE_LINK``) with custom teaser text
(Issue #1879)
* Delete old ``bootstrap`` theme (use ``bootstrap3`` instead)
* Screen reader-friendly navbar collapses and dropdowns (Issue #1863)
* Modern reST stylesheets, based in part on Bootstrap 3 (Issue #1150)

Bugfixes
--------

* Add missing ``xmlns:xhtml`` namespace to sitemaps (Issue #1890)
* Fixed superfluous rebuild problems with Python 3. Note that this will cause
rebuilds for most sites. (Issue #1887)
* Fix links in sample post (Issue #1874)
* Don't use deprecated Yapsy methods (Isue #1868)
* Surpress wincing when auto is aborted during rebuilding
* Show tags only from the current language on tag listing pages (Issue #1856)
* Remove gap between line numbers and code (Issue #1859)
* Fix spurious warnings about posts published in the future (Issue #1850)

New in v7.6.0
=============

@@ -4,6 +4,6 @@
.. description: The Nikola configuration file.
.. type: text

The default config file for Nikola v7.6.0 is reproduced below.
The default config file for Nikola v7.6.1 is reproduced below.

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

:Version: 7.6.0
:Version: 7.6.1
:Author: Roberto Alsina <ralsina@netmanagers.com.ar>

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

:Version: 7.6.0
:Version: 7.6.1

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

@@ -1758,15 +1758,47 @@ the following:

This is also useful for DISQUS thread migration!

* Will try to convert the content of your posts. This is *not* error free, because
WordPress uses some unholy mix of HTML and strange things. Currently we are treating it
as markdown, which does a reasonable job of it.
* Allows you to export your comments with each post
* Exports information on attachments per post
* There are different methods to transfer the content of your posts:

You will find your old posts in ``new_site/posts/post-title.wp`` in case you need to fix
any of them.
- You can convert them to HTML with the WordPress page compiler plugin
for Nikola. This will format the posts including supported shortcodes
the same way as WordPress does. Use the ``--transform-to-html`` option
to convert your posts to HTML.

If you use this option, you do not need to install the plugin
permanently. You can ask Nikola to install the plugin into the subdirectory
``plugins`` of the current working directory by specifying
the ``--install-wordpress-compiler`` option.

- You can leave the posts the way they are and use the WordPress page
compiler plugin to render them when building your new blog. This also
allows you to create new posts using the WordPress syntax, or to manually
add more shortcode plugins later. Use the ``--use-wordpress-compiler``
option to not touch your posts.

If you want to use this option, you have to install the plugin permanently.
You can ask Nikola to install the plugin into your new site by specifying
the ``--install-wordpress-compiler`` option.

- You can let Nikola convert your posts to Markdown. This is *not* error
free, because WordPress uses some unholy mix of HTML and strange things.
This is the default option and requires no plugins.

You will find your old posts in ``new_site/posts/post-title.html`` in the first case,
``new_site/posts/post-title.wp`` in the second case or ``new_site/posts/post-title.md``
in the last case if you need to edit or fix any of them.

Please note that the page compiler currently only supports the ``[code]`` shortcode,
but other shortcodes can be supported via plugins.

Also note that the WordPress page compiler is licensed under GPL v2 since
it uses code from WordPress itself, while Nikola is licensed under the more
liberal MIT license.

This feature is a work in progress, and the only way to improve it is to have it used for
as many sites as possible and make it work better each time, so I am happy to get requests
as many sites as possible and make it work better each time, so we are happy to get requests
about it.

.. [#] The dump needs to be in 1.2 format. You can check by reading it, it should say
@@ -8,7 +8,7 @@
Using Alternative Social Buttons with Nikola
============================================

:Version: 7.6.0
:Version: 7.6.1

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

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

:Version: 7.6.0
:Version: 7.6.1
:Author: Roberto Alsina <ralsina@netmanagers.com.ar>

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

0 comments on commit 2f80f0b

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