From ff3ed1e9418eab21fd42bb5ddd96a3851a25801c Mon Sep 17 00:00:00 2001 From: "Kali Kaneko (leap communications)" Date: Tue, 4 Oct 2016 02:21:32 -0400 Subject: [docs] fix readme markup --- README.rst | 33 +++++++++++++-------------------- docs/hacking/index.rst | 10 ++++++++-- 2 files changed, 21 insertions(+), 22 deletions(-) diff --git a/README.rst b/README.rst index 3f501c6..79e4cfc 100644 --- a/README.rst +++ b/README.rst @@ -88,17 +88,20 @@ commands for you. Install headless backend in development mode +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -Prerequisites: +Prerequisites:: sudo apt install build-essential python-virtualenv libsqlcipher-dev \ libssl-dev libffi-dev + +Install and activate a virtualenv:: + cd bitmask-dev virtualenv venv source venv/bin/activate All the subsequent commands assume that you have activated the virtualenv. -Install python dependencies: +Install all the python dependencies:: make dev-backend @@ -107,16 +110,16 @@ Install user interface frontend If you want to run the Bitmask user interface, you additionally need the following: -Prerequisites: +Prerequisites:: sudo apt install python-pyqt5 python-pyqt5.qtwebkit -Install python dependencies: +Install python dependencies:: make dev-all -Note: even though the UI is in javascript, Qt is used to create a webview -window. +Note: even though the UI is in javascript, Qt is used to create a webview window. + Install Bitmask user interface in development mode +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ @@ -127,28 +130,18 @@ bundled version of the javascript UI. If you want to modify the javascript UI, then you need to be able to update the javascript bundle whenever a javascript or CSS source file changes. -Prerequisites: +Prerequisites:: sudo apt install nodejs npm nodejs-legacy -Next, run ``dev-install``: +Next, run ``dev-install``:: cd ui - make dev-install # install JS user interface as a python package in "develop" mode. - node run watch # continually rebuild javascript bundle when source files change. + make dev-install # install JS user interface as a python package in "develop" mode. + node run watch # continually rebuild javascript bundle when source files change. For more information, see ``ui/README.md``. -Cross-testing -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -If you are developing against a non-published branch of ``leap.common`` or -``leap.soledad``, run instead:: - - tox -e py27-dev - -This expects ``leap_common`` and ``soledad`` repos to be checked out in the -parent folder. License diff --git a/docs/hacking/index.rst b/docs/hacking/index.rst index f1991af..2a48a7b 100644 --- a/docs/hacking/index.rst +++ b/docs/hacking/index.rst @@ -15,16 +15,22 @@ Tox is all you need:: Test when changes are made to common/soledad ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -If you modify soledad or leap.common packages:: + +If you are developing against a non-published branch of ``leap.common`` or +``leap.soledad``, run instead:: tox -e py27-dev +This expects ``leap_common`` and ``soledad`` repos to be checked out in the +parent folder. + Setting up the development environment -------------------------------------- Dependencies:: - apt install ... + sudo apt install build-essential python-virtualenv libsqlcipher-dev \ + libssl-dev libffi-dev There are different requirements files:: -- cgit v1.2.3