Build Status MindsDB Community Website
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
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.
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
How can you help us? contributions welcome
- Report a bug
- Improve documentation
- Propose new feature
- Fix typos
Made with contributors-img.