aboutsummaryrefslogtreecommitdiffstats
path: root/theme/docs/index.md
diff options
context:
space:
mode:
authorShankho Boron Ghosh <shankhoghosh123@gmail.com>2020-11-04 20:48:01 +0530
committerJan-Simon Moeller <jsmoeller@linuxfoundation.org>2020-11-10 22:43:20 +0000
commit6b1ab1c2161da3cd7a3d54fe684906e73da23674 (patch)
tree43ffb329b1c418251e8fa7c140b3c5717c7365af /theme/docs/index.md
parentd03401d2cdcddf2bc24f4eff0954f69fa5aa61ec (diff)
Meta redirects to http://old-docs.automotivelinux.org/docs/en/icefish/getting_started/ Bug-AGL: [SPEC-3633] Signed-off-by: Shankho Boron Ghosh <shankhoghosh123@gmail.com> Change-Id: Ie6bfbc5821b8c158fb92a076d143d8e495ac5d89 Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/25509 Reviewed-by: Jan-Simon Moeller <jsmoeller@linuxfoundation.org> Tested-by: Jan-Simon Moeller <jsmoeller@linuxfoundation.org>
Diffstat (limited to 'theme/docs/index.md')
-rw-r--r--theme/docs/index.md52
1 files changed, 52 insertions, 0 deletions
diff --git a/theme/docs/index.md b/theme/docs/index.md
new file mode 100644
index 0000000..be1bb25
--- /dev/null
+++ b/theme/docs/index.md
@@ -0,0 +1,52 @@
+# Windmill theme
+
+## About
+
+Windmill theme focuses on clean usable navigation for large documentation
+projects. It retains the state of the menu of pages and folders across page
+transitions, by keeping navigation to an iframe.
+
+It also implements a versatile search, featuring term highlighting, and both a
+quick dropdown and a full-page option that allows the user to come back to
+search results.
+
+Within pages, it uses the default mkdocs theme, including syntax highlighting.
+
+## Installation
+
+Install the Windmill theme using `pip`:
+
+``` sh
+pip install mkdocs-windmill
+```
+
+To install and get started with `mkdocs`, follow [MkDocs documentation](http://www.mkdocs.org/#installation).
+
+## Usage
+
+To use the Windmill theme installed via `pip`, add this to your `mkdocs.yml`:
+
+``` yaml
+theme: 'windmill'
+```
+
+If you cloned Windmill from GitHub:
+
+``` yaml
+theme:
+ name: null
+ custom_dir: '{INSTALL_DIR}/mkdocs_windmill'
+ # Copy settings from mkdocs_theme.yml, which is ignored by custom_dir themes.
+ static_templates: [404.html]
+ search_index_only: true
+ include_search_page: true
+```
+
+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
+```
+
+See [Customization](customization.md) for a few extra configuration options
+supported by the Windmill theme.