lektor-cssbuild 0.2

A Lektor plugin for building CSS files

lektor-cssbuild is a plugin for the Lektor static site generator that integrates CSS management tools into the build process. The tools that it uses are:

• node-sass is run before the Lektor build to generate a CSS file.

• uncss is run after the Lektor build to remove unused CSS.

• node-cssmin is run as the last step to minify the CSS.

This plugin does not use a task runner. It runs the command-line executables of these tools.

To use the plugin, add it to your project:

lektor plugin add lektor-cssbuild

Create a package.json file (the name and version aren’t significant for the plugin):

{
  "name": "my-project-cssbuild",
  "version": "1.0.0",
  "private": true
}

Install the tools:

npm install --save-dev node-sass uncss cssmin

Create a configuration file configs/cssbuild.ini and set the tool paths:

[sass]
source = src:style/sass/main.scss
output = src:assets/static/

[uncss]
output = dst:static/main.nested.css

[cssmin]
source = dst:static/main.nested.css
output = dst:static/main.css

When writing a path, the src prefix refers to a path in the source folders and the dst prefix refers to the build folders.

If any tool section is missing, that tool will be skipped.

To enable the plugin during Lektor build, the cssbuild flag has to be included (same for the server command):

lektor build -f cssbuild

Using the above configuration, the build process will run as follows:

• The style/sass/main.scss file is read and the file assets/static/main.css is generated.

• Lektor generates the site artifacts.

• Based on the generated HTML pages, the unused CSS rules are removed and the result is written into the static/main.nested.css file in the build directory.

• The generated static/main.nested.css file is minified and the result is written into the main.css file in the same directory.

During uncss, the ignore option can be used to make sure to keep some selectors:

[uncss]
output = src:style/css/main.css
ignore = "/\.selector1.*/"

0.2 (2019-08-06)

• Add ignore option to uncss stage.

0.1 (2019-08-06)

• Initial release on PyPI.