๐ง MindsDB Documentation(Migrated to MindsDB repository) ๐ง
Running the docs locally
First install the mkdocs and mkdocs-material theme in your python virtual environment:
pip install -r requirements.txt
Then, navigate to the /mindsdb-docs
directory and start the server:
mkdocs serve
The documentation website will be available at http://127.0.0.1:8000
Deploy the docs
The latest version shall be automatically pushed and deployed after merge on master. If the CI/CD deploy failed, locally run:
mkdocs gh-deploy
All of the html files and assets will be pushed to the gh-pages branch and published on github pages.
Repository structure
The mindsdb-docs layout is as follows:
docs # Containes documentation source files
|__assets/ # Image and icons used in pages
|__.md # All of the markdown files used as pages
overrides
โโ assets/
โ โโ images/ # Images and icons
โ โโ javascripts/ # JavaScript
โ โโ stylesheets/ # Stylesheets
โโ partials/
โ โโ footer.html # Footer bar
โโ 404.html # 404 error page
โโ base.html # Base template
โโ main.html
.mkdocs.yml # Mkdocs configuration file
Contribute
- Report a bug
- Improve documentation
- Propose new feature
- Fix typos
Contributors
Made with contributors-img.