Skip to content
Permalink
Browse files
Review feedback
  • Loading branch information
George Leslie-Waksman committed Aug 10, 2018
1 parent 6a93712 commit adbc4d6e85f7a15ca759de243e3fee53f0fb3b6f
Showing with 14 additions and 9 deletions.
  1. +1 −1 CHANGES.txt
  2. +9 −3 docs/creating-a-theme.rst
  3. +4 −3 docs/theming.rst
  4. +0 −1 nikola/data/symlinked.txt
  5. +0 −1 nikola/data/themes/base-jinja/bundles
@@ -15,7 +15,7 @@ Features
time is specified, the posting time will be displayed alone.
* All built-in themes now support the ``DATE_FANCINESS`` option.
* Theme bundles are now parsed using the configparser module and
can support newlines inside entries as well ad comments
can support newlines inside entries as well as comments

Bugfixes
--------
@@ -813,8 +813,12 @@ Doing the same for layout-reverse, sidebar-overlay and the rest is left as an ex
Bundles
-------

If you have ``webassets`` installed and the ``USE_BUNDLES`` option set to True, Nikola can put several CSS or JS files together in a larger file,
which makes sites load faster. To do that, your theme needs a ``bundles`` file where the syntax is::
If you have ``webassets`` installed and the ``USE_BUNDLES`` option set to True,
Nikola can put several CSS or JS files together in a larger file, which can
makes site load faster for some deployments. To do this, your theme needs
a ``bundles`` file. The file format is a modified
`config <https://docs.python.org/3/library/configparser.html>`_ file with no
defined section; the basic syntax is::

outputfile1.js=
thing1.js,
@@ -833,7 +837,9 @@ For the Lanyon theme, it should look like this::
code.css,
poole.css,
lanyon.css,
custom.css
custom.css,

**Note:** trailing commas are optional

**Note:** Some themes also support the ``USE_CDN`` option meaning that in some cases it will load one bundle with all CSS and in other will load some CSS files
from a CDN and others from a bundle. This is complicated and probably not worth the effort.
@@ -73,8 +73,9 @@ parent, engine
older).

bundles
A config file containing a list of files to be turned into bundles using WebAssets.
For example:
A `config <https://docs.python.org/3/library/configparser.html>`_ file
containing a list of files to be turned into bundles using WebAssets. For
example:

.. code:: ini

@@ -85,7 +86,7 @@ bundles
code.css,
baguetteBox.min.css,
theme.css,
custom.css
custom.css,

This creates a file called "assets/css/all.css" in your output that is the
combination of all the other file paths, relative to the output file.
@@ -23,7 +23,6 @@ nikola/data/themes/base/assets/js/html5shiv-printshiv.min.js
nikola/data/themes/base/assets/js/justified-layout.min.js
nikola/data/themes/base/assets/js/moment-with-locales.min.js
nikola/data/themes/base/messages/messages_cz.py
nikola/data/themes/base-jinja/bundles
nikola/data/themes/bootblog4-jinja/assets/css/bootblog.css
nikola/data/themes/bootblog4-jinja/bundles
nikola/data/themes/bootstrap4-jinja/assets/css/bootstrap.min.css

This file was deleted.

0 comments on commit adbc4d6

Please sign in to comment.