6. Contributing
starterkit-lessons is an open source project, and we welcome contributions of all kinds:
New lessons;
Fixes to existing material;
Bug reports; and
Reviews of proposed changes.
By contributing, you are agreeing that we may redistribute your work under these licenses. You also agree to abide by our contributor code of conduct.
6.1. Getting Started
We use the fork and pull model to manage changes. More information about forking a repository and making a Pull Request.
For our lessons, you should branch from and submit pull requests against the
master
branch.When editing lesson pages, you need only commit changes to the Markdown source files.
To build the lessons please follow the instructions.
If you’re looking for things to work on, please see the list of issues for this repository. Comments on issues and reviews of pull requests are equally welcome.
6.2. Building the lessons
6.2.1. Using venv
(recommended)
6.2.1.1. Requirements
Make sure you have venv
(virtual environment) in your working directory. It can be created with the following command:
$ python3 -m venv venv
Activate it in the shell and install the requirements, which are gathered in a file provided by the repository.
$ source venv/bin/activate
$ pip3 install -r requirements.txt
After sourcing, your shell prompt will be augmented by the (venv)
prefix, e.g.
(venv) mylaptop:~/fcc/fcc-tutorials
Building fcc-tutorials
in FCCSW stack
In case the Python from FCCSW stack is being used, it is necessary to clear
PYTHONPATH
environment variable after sourcing of the stack
source /cvmfs/fcc.cern.ch/sw/latest/setup.sh
unset PYTHONPATH
Sourcing of the FCCSW stack might be needed in cases when the Python provided by
the OS is too old, currently this is the case for CentOS 7 (lxplus
).
6.2.1.2. Building
The documentation pages are build by executing
$ sphinx-build -b html . build
6.2.1.3. Browsing the result
Open in your browser the file
$PWD/build/index.html
6.2.2. Using starterkit_ci
6.2.2.1. Requirements
To build the lessons locally, install the following:
6.2.2.2. Building
Build the pages:
$ starterkit_ci build --allow-warnings
$ starterkit_ci check --allow-warnings
6.2.2.3. Browsing the result
Start a web server to host them:
$ cd build
$ python -m http.server 8000
You can see your local version by using a web-browser to navigate to http://localhost:8000
or wherever it says it’s serving the book.