openstax/cnx-easybake

cnx-easybake

Easybake is a library (and cli tool) for using an extended subset of CSS3 to describe and 'bake-in' some manipulations of HTML files, in particular collation (moving content around) and numbering.

DEPENDENCIES

For Windows Users: If your username contains whitespace, the setup and installation will not work. Create a new user without whitespace in the username in order to succesfully complete installation.

Install the following:

nodenv with node-build at https://github.com/nodenv/nodenv#installation

pyenv at https://github.com/pyenv/pyenv#installation

also:

sudo apt-get install python-dev 
sudo apt-get install build-essential

INSTALL

To install cnx-easybake:

./scripts/setup

Primarily for use as a library to process etree HTML trees. Example:

from lxml import etree
from cnxeasybake import Oven

oven = Oven(myRuleSet)  # an CSS3 based ruleset - see docs

myHTML = etree.HTML(myHTMLstring)
oven.bake(myHTML)

Example usage:

cnx-easybake poc.css poc-raw.html poc-baked.html

TEST

Test files are available on in the tests folder.

To run the tests:

./scripts/test