aboutsummaryrefslogtreecommitdiffstats
path: root/theme/README.md
diff options
context:
space:
mode:
authorgrowupboron <shankhoghosh123@gmail.com>2020-09-11 17:18:57 +0530
committerJan-Simon Moeller <jsmoeller@linuxfoundation.org>2020-09-11 12:11:56 +0000
commit4aad369c9728061c97b3de792286e743ee884b09 (patch)
tree14bddddeab334e3fdbdcf29446a87aa11cf6cd97 /theme/README.md
parent619a7e48085be1538c3b01eb93dcb9dc95bf0436 (diff)
Simplified doc-site generationjellyfish_9.99.4jellyfish/9.99.49.99.4
Updated theme to windmill Using Mkdocs static site generator Deployed on readthedocs Signed-off-by: growupboron <shankhoghosh123@gmail.com> Change-Id: If62eaaea1855c91b64f687900f54eba6bc1caee8 Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/25236 Reviewed-by: Jan-Simon Moeller <jsmoeller@linuxfoundation.org> Tested-by: Jan-Simon Moeller <jsmoeller@linuxfoundation.org>
Diffstat (limited to 'theme/README.md')
-rw-r--r--theme/README.md58
1 files changed, 58 insertions, 0 deletions
diff --git a/theme/README.md b/theme/README.md
new file mode 100644
index 0000000..cc443f6
--- /dev/null
+++ b/theme/README.md
@@ -0,0 +1,58 @@
+[![PyPI][pypi-image]][pypi-link]
+
+ [pypi-image]: https://img.shields.io/pypi/v/mkdocs-windmill.svg
+ [pypi-link]: https://pypi.python.org/pypi/mkdocs-windmill
+
+# Windmill theme for MkDocs
+Outstanding mkdocs theme with a focus on navigation and usability, from Grist Labs.
+
+Highlights:
+- Convenient navigation for larger documentation projects.
+- Retains state of the navigation menu across page transitions.
+- Search with term highlighting.
+- User may search in a quick dropdown or load results in a full page.
+- Default mkdocs theme within pages, including syntax highlighting.
+
+## Quick start
+
+To install using `pip`:
+``` sh
+pip install mkdocs-windmill
+```
+
+To use in `mkdocs.yml`:
+``` yaml
+theme: windmill
+```
+
+Note that it's important for there to exist a homepage, e.g. a top-level root element in mkdocs 1.0+:
+``` yaml
+nav:
+ - Home: index.md
+```
+
+## Demo and documentation
+
+More details are on this site generated with the Windmill theme:
+- [Usage](https://gristlabs.github.io/mkdocs-windmill/#) for more on installation and usage.
+- [Customization](https://gristlabs.github.io/mkdocs-windmill/#customization/) for extra configuration options that Windmill supports.
+
+## Development
+
+If doing development on `mkdocs-windmill`, check it out with
+``` sh
+git clone https://github.com/gristlabs/mkdocs-windmill/
+cd mkdocs-windmill
+```
+
+There are Selenium browser tests, based on NodeJS. To set them up, first [install Yarn](https://yarnpkg.com/en/docs/install), then from `mkdocs-windmill` checkout, run
+``` sh
+cd tests
+yarn install
+```
+
+You can run tests when you make changes as follows:
+``` sh
+cd tests
+MKDOCS_BINARY=<path-to-mkdocs-command> SELENIUM_BROWSER=chrome yarn test
+```