This is a community-contributed place where we collect all our documentation. Every ALICE member can contribute, and the Analysis Tutorial Committee will review every contribution.
Documentation is published on GitHub pages at the following address:
First off you need a GitHub account. Fork the alice-doc/alice-analysis-tutorial repository, then clone it to your laptop:
git clone https://github.com/alice-doc/alice-analysis-tutorial
cd alice-analysis-tutorial/
git remote add <my_username> https://github.com/<my_username>/alice-analysis-tutorialDocumentation is written in Markdown and it
is generated using GitBook. You need to install GitBook first. GitBook
is a NodeJS package, meaning that you need npm to install it. You can get npm easily.
On Ubuntu:
sudo apt install npmOn macOS (assuming you have Homebrew:
brew install npmOn CentOS 7 (you need EPEL enabled):
sudo yum install npmOnce npm is installed, you can install GitBook:
sudo npm install -g gitbook-cliDo not use sudo on macOS.
Once GitBook is installed, you should find it in your $PATH, check it with:
type gitbookTo preview the documentation pages locally while you are editing them, move to the repository's root directory and run:
cd alice-analysis-tutorial/
make serveThe command will not exit and a local website will be visible at the following address:
The website uses GitBook. Editing the pages using your favorite text editor: whenever you save, the page currently opened in your local preview will be refreshed automatically.
When you are happy with your modifications, commit them, push them to your repository and open a pull request, for instance:
git commit -a -m 'I am happy with my doc'
git push <my_username>then navigate to your GitHub repository online to open a pull request.