36 lines
1.5 KiB
Markdown
36 lines
1.5 KiB
Markdown
|
# Documentation
|
||
|
|
||
|
We use [mkdocs](https://www.mkdocs.org/) with the [material theme](https://squidfunk.github.io/mkdocs-material/) to write these docs. Whenever you make any changes, just push them back to the repo and the documentation will be deployed automatically.
|
||
|
|
||
|
## Set up development environment
|
||
|
|
||
|
1. Make sure your conda environment is active
|
||
|
2. `pip install mkdocs`
|
||
|
3. `pip install mkdocs-material`
|
||
|
|
||
|
## Preview
|
||
|
|
||
|
Run the following command in RAPIDS root folder and go to [http://127.0.0.1:8000](http://127.0.0.1:8000):
|
||
|
|
||
|
```bash
|
||
|
mkdocs serve
|
||
|
```
|
||
|
|
||
|
## File Structure
|
||
|
|
||
|
The documentation config file is `/mkdocs.yml`, if you are adding new `.md` files to the docs modify the `nav` attribute at the bottom of that file. You can use the hierarchy there to find all the files that appear in the documentation.
|
||
|
|
||
|
## Reference
|
||
|
|
||
|
Check this [page](https://squidfunk.github.io/mkdocs-material/reference/abbreviations/) to get familiar with the different visual elements we can use in the docs (admonitions, code blocks, tables, etc.) You can also refer to `/docs/setup/installation.md` and `/docs/setup/configuration.md` to see practical examples of these elements.
|
||
|
|
||
|
## Extras
|
||
|
|
||
|
You can insert [emojis](https://facelessuser.github.io/pymdown-extensions/extensions/emoji/) using this syntax `:[SOURCE]-[ICON_NAME]` from the following sources:
|
||
|
|
||
|
- https://materialdesignicons.com/
|
||
|
- https://fontawesome.com/icons/tasks?style=solid
|
||
|
- https://primer.style/octicons/
|
||
|
|
||
|
You can use this [page](https://www.tablesgenerator.com/markdown_tables) to create markdown tables more easily
|