simplefoc.github.io

Documentation website for SimpleFOCproject

• Documentation
• Community forum
• Shop

Running the site using anaconda environement

Nice tutorial: https://s-canchi.github.io/2021-04-30-jekyll-conda/

First create the new anaconda environmnet using the environment.yamlfile

conda env create -f environement.yaml
conda activate simpledocs

Once in the environment simpledocs install jekyll

gem install jekyll bundler

Then install necessary jekyll dependencies of the simplefoc docs:

# Optionally specify "--path /some/other/dir" to avoid needing root.
bundle install

And you're ready to go!

Just make sure that whenever you open your terminal to generate the website to activate the conda environment:

conda activate simpledocs

Generating the website

To generate the site locally clone the repo to your local directory and then open terminal inside the repo folder and run:

bundle exec jekyll serve

Since the site is quiet large sometimes the --incremental flag helps with faster execution

bundle exec jekyll serve --incremental

Olddocs generating

1. Add the library version to the index.md
2. modify the _config.yaml
   • url: "http://olddocs.simplefoc.com"
   • baseurl: "v2.2.3"
3. run bundle exec jekyll build
4. in _site you have the generated html