diff options
author | 2020-11-06 20:26:15 +0530 | |
---|---|---|
committer | 2020-11-10 15:09:00 +0000 | |
commit | b0647613fa820df9487b32009267a3b20b65b478 (patch) | |
tree | af653cf62ecd274c45ab0f27dd728caa1ddf2b01 /theme/README.md | |
parent | 57816f8bf1281e967d89ce0854060fb52ba42c81 (diff) |
Added Guppy Branchguppy
Meta redirects to http://old-docs.automotivelinux.org/docs/en/guppy/getting_started/
Bug-AGL: [SPEC-3633]
Signed-off-by: Shankho Boron Ghosh <shankhoghosh123@gmail.com>
Change-Id: Idd21d5e00ee57f860857ef63e37d12a0930aa38e
Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/25536
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.md | 58 |
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 +``` |