diff options
Diffstat (limited to 'docs/upgrading-to-v6.txt')
| -rw-r--r-- | docs/upgrading-to-v6.txt | 111 |
1 files changed, 0 insertions, 111 deletions
diff --git a/docs/upgrading-to-v6.txt b/docs/upgrading-to-v6.txt deleted file mode 100644 index 271d98e..0000000 --- a/docs/upgrading-to-v6.txt +++ /dev/null @@ -1,111 +0,0 @@ -.. title: Upgrading to v6 -.. slug: upgrading-to-v6 -.. date: 2013-08-23 23:00:00 UTC-03:00 -.. tags: -.. link: -.. description: - -Upgrading to v6 -=============== - -:Version: 7.1.0 - -.. class:: lead - -Nikola tries fairly hard to be compatible between versions. However, there were -a few areas which were getting clunky, and needed fxing. So, here's what you may -need to change in your site. - -If you need to change anything else, or something breaks, please write at nikola-discuss -and I'll add further tweaks here. - -Themes ------- - -**NOTE** - There is no equivalent for the jinja-default theme yet. If you have a custom, - jinja-based theme, upgrading is probably a bad idea right now. - - -Themes have been renamed: - -* site => bootstrap -* orphan => base - -Theme added: - -* base-jinja - -Themes have been moved out of nikola and into nikola-themes: - -* default => oldfashioned at nikola-themes -* jinja-default => not there yet, coming soon -* monospace => monospace at nikola-themes -* site-reveal => reveal at nikola-themes - -You may have to change your ``THEME`` setting, or change the ``parent`` if you are -using a custom theme. Also, some templates have been tweaked, but nothing should -break for you. - -Facebook comments support changed the HTML tag to: - -.. code-block:: mako - - <html - %if comment_system == 'facebook': - xmlns:fb="http://ogp.me/ns/fb#" - %endif - lang="${lang}"> - -If you do not want to use Facebook comments, you can leave the old ``<html -lang="${lang}">`` tag in and it will work just fine. - -Comments -~~~~~~~~ - -If you want a custom theme to support comment systems other than disqus, you will need to: - -1) Replace mentions of disqus_helper.tmpl with comments_helper.tmpl -2) Replace mentions of html_disqus with comment_form -3) Replace mentions of html_disqus_link with comment_link -4) Replace mentions of html_disqus_script with comment_link_script - -If you don't, your theme should work just fine, but support only disqus comments. - - -Configuration -------------- - -A number of options have been renamed. In most cases, the behaviour -should be **exactly** as before. - -However, ``post_pages`` was split into ``POSTS`` and ``PAGES``. Long -story short, anything that had a ``True`` as the ``use_in_feeds`` -(last) value goes to ``POSTS`` and anything with ``False`` goes to -``PAGES``. For example: - -.. code-block:: python - - post_pages = ( - ("posts/*.txt", "", "post.tmpl", True), - ("stories/*.txt", "p", "story.tmpl", False), - ("stories/*.html", "s", "story.tmpl", False), - ) - - ### becomes ### - - POSTS = ( - ("posts/*.txt", "", "post.tmpl"), - ) - - PAGES = ( - ("stories/*.txt", "p", "story.tmpl"), - ("stories/*.html", "s", "story.tmpl"), - ) - -Also, you will get warnings. That doesn't mean things broke. They are -there to inform you of what's happening, and that you need to tweak your -config. - -All the deprecated options will work during the v6 cycle, and only be -removed in v7, when those warnings will become errors. |
