Skip to content

AndyLow91/nightscout.github.io

 
 

Repository files navigation

Nightscout Documentation

This is the repo that contains the source files for the Nightscout Docs site.

Documentation was migrated from MkDocs to Sphinx with MyST.

Markdown is a simple text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format.

Contributing

To suggest changes, fork this repository, edit the files, and submit your changes as a pull request.

If you don't want to install the full documentation suite, you can simply propose edits on the documentation site.

The developer discussion of Nightscout happens on our Discord channel at https://discord.gg/zg7CvCQ

Previewing Changes

Sphinx requires Python 3.8+.

  • Install python modules
$ cd <nightscout docs location - i.e. where you cloned it>
$ pip install -r requirements.txt
  • Compile the documentation
$ cd <nightscout docs location>
$ sphinx-build -b dirhtml docs _build
  • Start a local http server to view the documentation
$ cd <nightscout docs location>/_build/dirhtml
$ python -m http.server
  • You can now browse the documentation locally at http://localhost:8000/

  • Optionally, you can share the preview with others by building them in your repository with GitHub pages. You need to enable GitHub pages in your repository fork. The workflow in .github/workflows/documentation.yaml will automatically create and deploy your pages.

Conventions

  • Use images for clarity whenever appropriate

Admonitions

Admonitions are a markdown extension that enable formatted blocks for visually calling out information.

About

website, meta repo for whole project

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Batchfile 52.7%
  • Makefile 43.7%
  • HTML 3.6%