Working on CSS and Documentation¶
CSS¶
We’re using LESS (no direct editing of CSS). If you’d like to contribute to the design efforts:
Before first run, and only once, you’ll need:
git submodule init
git submodule update
We recommend to use nvm to install the correct node version (so that all the developers get consistent css results):
install nvm, see: https://github.com/creationix/nvm
then, run:
$ cd OpenKnesset
OpenKnesset$ nvm install
If you encounter problems using nvm, you can install the node another way, you need node in the version specified in .nvmrc file
Install less using the version specified in package.json:
$ cd OpenKnesset
OpenKnesset$ nvm use
OpenKnesset$ npm install
Make your changes to the files in the less
directory, and compile
(assuming you’re in the Open-Knesset
directory):
$ cd OpenKnsset
OpenKnesset$ nvm use
OpenKnesset$ npm run less
Documentation¶
Our documentation is written with Sphinx, install it with the virtualenv activated:
pip install sphinx
Edit the relevant docs under the docs
directory, and once done, run
make html
. You’ll have the resulting documentation in build/html
directory.
We have 2 documentation directories:
- api — API and Embedding for 3rd party apps/services developers
- devel — Developer guide for the OpenKnesset project (TBD)
e.g: To work on the devel docs, edit the files under docs/devel/source
, once
ready to build:
cd docs/devel
make html
You’ll have the result under:
docs/devel/build/html