This repository is an online companion for the Biostar Handbook:
See: https://www.biostarhandbook.com/
- Istvan Albert, https://github.com/ialbert
- Phil Ross, https://github.com/thephilross
Contributions need to be made via GitHub: https://github.com/ialbert/biostar-handbook-web
The web pages are generated with the pyblue static site generator from the git repository above. Install pyblue:
pip install pyblue
To view and edit the site run make
in the repository. The default action
in the make
file supports the main usecase of developing new content.
It will start the pyblue server instance and will allow you
to view the result of any changes you make to the pages.
make
Visit http://localhost:8080
to see the site. Edit any page in
an editor then reload in web browser. See the pyblue docs for
other details.
Restart the server if you add a new file as the directory tree is scanned only once on startup. Changes to files however will be visible right away.
Content is divided into subdirectories of the www/unit
directory.
- Web units need to contain all commands used to generate a result.
- Comments should be used to explain the purpose of each command
- A web unit can be a plain HTML file, may contain markdown as well as Django Templating specific commands.
- Start with the example.html file in the repository. Now examine how this file gets rendered at http://biostarhandbook.com/unit/example.html
- Code can be embedded into pages (will be automatically syntax highlighted) or can be linked to as a file.
- Bootstrap 2.3 styling is enabled.
You can also consult the pyblue documentation for more details.