Documentation for the European Environment for Scientific Software Installations (EESSI)
Welcome to the repository that hosts the EESSI documentation, see https://eessi.github.io/docs/.
Basic info
-
contents are located in
docs/
subdirectory -
Markdown is used as syntax
Getting started
This documentation is rendered via MkDocs, which makes it very easy to preview the result of the changes you make locally.
-
First, install
mkdocs
:pip install mkdocs-material mkdocs-git-revision-date-localized-plugin
-
Build the documentation:
make
or:
mkdocs build
-
Test the documentation (make sure there are no issues):
make test
or:
mkdocs build --strict
-
Start the MkDocs built-in dev-server to preview the documentation as you work on it:
make preview
or:
mkdocs serve
Visit http://127.0.0.1:8000/ to see the local live preview of the changes you make.
-
If you prefer building a static preview you can use
make
, which should result in asite/
subdirectory that contains the rendered documentation.
Automatic updates
The rendered version of this documentation at https://eessi.github.io/docs/
is automatically updated on every push to the main
branch,
thanks to the GitHub Actions workflow defined in
.github/workflows/deploy.yml
.
The gh-pages
branch in this repository contains the rendered version.
https://eessi.github.io/docs/ will only be updated if the tests pass,
see GitHub Actions workflow defined in
.github/workflows/test.yml
.
Note: do not change the files in the gh-pages
branch directly!
All your changes will be lost the next time the main
branch is updated...
License
The software in this repository is distributed under the terms of the GNU General Public License v2.0.
See LICENSE for more information.
SPDX-License-Identifier: GPL-2.0-only