Skip to content
/ docs Public

Documentation for the European Environment for Scientific Software Installations (EESSI)

License

Notifications You must be signed in to change notification settings

EESSI/docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

author
Caspar van Leeuwen
Oct 25, 2023
1320c09 · Oct 25, 2023
Feb 24, 2023
Oct 25, 2023
Feb 20, 2023
Oct 4, 2023
May 7, 2020
Jun 17, 2020
Nov 16, 2020
May 7, 2020
Feb 18, 2021
Oct 20, 2023

Repository files navigation

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 a site/ 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

About

Documentation for the European Environment for Scientific Software Installations (EESSI)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published