From 6b1ab1c2161da3cd7a3d54fe684906e73da23674 Mon Sep 17 00:00:00 2001 From: Shankho Boron Ghosh Date: Wed, 4 Nov 2020 20:48:01 +0530 Subject: Added Icefish Branch Meta redirects to http://old-docs.automotivelinux.org/docs/en/icefish/getting_started/ Bug-AGL: [SPEC-3633] Signed-off-by: Shankho Boron Ghosh Change-Id: Ie6bfbc5821b8c158fb92a076d143d8e495ac5d89 Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/25509 Reviewed-by: Jan-Simon Moeller Tested-by: Jan-Simon Moeller --- theme/README.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 theme/README.md (limited to 'theme/README.md') 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= SELENIUM_BROWSER=chrome yarn test +``` -- cgit 1.2.3-korg