A helper for Weblocks framework to define widget dependencies in LASS syntax.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
src
t
.gitignore
.travis.yml
ChangeLog.rst
README.rst
tasks.py
version.lisp-expr
weblocks-lass-test.asd
weblocks-lass.asd

README.rst

weblocks-lass

https://travis-ci.org/40ants/weblocks-lass.svg?branch=master

A utility system to define Weblocks dependencies as code in Lass syntax.

Reasoning

Sometimes it is easier to write CSS rules in lisp using full power of Lisp.

(defvar log-item '(:|@message| "Some"
                   :|@timestamp| 122434342
                   ;; this field is wrong and
                   ;; shouldn't be here
                   :|@fields| nil))

Roadmap

  • Add some kind of ability to reuse Lass rules among different widgets.

Building Documentation

To use this library:

  • load it with (ql:quickload :weblocks-lass);

  • define a dependency:

    TODO: add code snippet

How to build documentation

To build documentation, you need a Sphinx. It is documentaion building tool written in Python.

To install it, you need a virtualenv. Read this instructions how to install it.

Also, you'll need a cl-launch. It is used by documentation tool to run a script which extracts documentation strings from lisp systems.

Run these commands to build documentation:

virtualenv env
source env/bin/activate
pip install -r docs/requirements.txt
invoke build_docs

These commands will create a virtual environment and install some python libraries there. Command invoke build_docs will build documentation and upload it to the GitHub, by replacing the content of the gh-pages branch.