/oenology

Oenology

Read the content of this git from the book view

Building this booklet locally

The content of this repository is written with markdown files, packaged with MkDocs and can be built into a book-readable format by MkDocs build processes.

  1. Install MkDocs locally following the official documentation instructions.
  2. Install Material plugin for mkdocs: pip install mkdocs-material
  3. git clone https://github.com/jbcodeforce/aenology.git (or your forked repository if you plan to edit)
  4. cd aenology
  5. mkdocs serve
  6. Go to http://127.0.0.1:8000/ in your browser.

Building this booklet locally but with docker

In some cases you might not want to alter your Python setup and rather go with a docker image instead. This requires docker is running locally on your computer though.

  • docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material
  • Go to http://127.0.0.1:8000/ in your browser.

Pushing the book to GitHub Pages

  1. Ensure that all your local changes to the main branch have been committed and pushed to the remote repository. git push origin main
  2. Run mkdocs gh-deploy --remote-branch main from the root directory.

Project Status

  • [12/2023] Started this project

Contributors