| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211 |
- Metadata-Version: 2.1
- Name: mkdocs-material
- Version: 5.5.2
- Summary: A Material Design theme for MkDocs
- Home-page: https://squidfunk.github.io/mkdocs-material/
- Author: Martin Donath
- Author-email: martin.donath@squidfunk.com
- License: MIT
- Keywords: mkdocs,documentation,theme
- Platform: UNKNOWN
- Classifier: Development Status :: 5 - Production/Stable
- Classifier: Environment :: Web Environment
- Classifier: License :: OSI Approved :: MIT License
- Classifier: Programming Language :: JavaScript
- Classifier: Programming Language :: Python
- Classifier: Topic :: Documentation
- Classifier: Topic :: Software Development :: Documentation
- Classifier: Topic :: Text Processing :: Markup :: HTML
- Description-Content-Type: text/markdown
- Requires-Dist: mkdocs (>=1.1)
- Requires-Dist: Pygments (>=2.4)
- Requires-Dist: markdown (>=3.2)
- Requires-Dist: pymdown-extensions (>=7.0)
- Requires-Dist: mkdocs-material-extensions (>=1.0)
- <p align="center">
- <a href="https://squidfunk.github.io/mkdocs-material">
- <img src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/logo.png" width="320" alt="Material for MkDocs">
- </a>
- </p>
- <p align="center">
- <strong>
- A
- <a href="https://material.io/">Material Design</a>
- theme for
- <a href="https://www.mkdocs.org/">MkDocs</a>
- </strong>
- </p>
- <p align="center">
- <a href="https://github.com/squidfunk/mkdocs-material/actions"><img
- src="https://github.com/squidfunk/mkdocs-material/workflows/ci/badge.svg?branch=master"
- alt="GitHub Action"
- /></a>
- <a href="https://pypistats.org/packages/mkdocs-material"><img
- src="https://img.shields.io/pypi/dm/mkdocs-material.svg"
- alt="Downloads"
- /></a>
- <a href="https://gitter.im/squidfunk/mkdocs-material"><img
- src="https://badges.gitter.im/squidfunk/mkdocs-material.svg"
- alt="Chat on Gitter"
- /></a>
- <a href="https://pypi.org/project/mkdocs-material"><img
- src="https://img.shields.io/pypi/v/mkdocs-material.svg"
- alt="Python Package Index"
- /></a>
- <a href="https://hub.docker.com/r/squidfunk/mkdocs-material/"><img
- src="https://img.shields.io/docker/pulls/squidfunk/mkdocs-material"
- alt="Docker Pulls"
- /></a>
- <a href="https://github.com/sponsors/squidfunk"><img
- src="https://img.shields.io/static/v1?label=sponsor&message=%E2%9D%A4&logo=GitHub&color=ea4aaa"
- /></a>
- </p>
- <p align="center">
- Create a branded static site from a set of Markdown files to host the
- documentation of your Open Source or commercial project – customizable,
- searchable, mobile-friendly, 40+ languages. Set up in 5 minutes.
- </p>
- <p align="center">
- <a href="https://squidfunk.github.io/mkdocs-material/getting-started/">
- <img src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/screenshot.png" width="700" />
- </a>
- </p>
- <p align="center">
- <em>
- A demo is worth a thousand words — check it out at
- <a
- href="https://squidfunk.github.io/mkdocs-material/"
- >squidfunk.github.io/mkdocs-material</a>.
- </em>
- </p>
- ## Features
- * **It's just Markdown** — write your technical documentation in plain Markdown
- – no need to know HTML, JavaScript, or CSS. Material for MkDocs will do the
- heavy lifting and convert your writing to a beautiful and functional website.
- * **Responsive by design** — built from the ground up to work on all sorts of
- devices – from mobile phones to widescreens. The underlying fluid layout will
- always adapt perfectly to the available screen space.
- * **Static, yet searchable** — almost magically, your technical documentation
- website will be searchable without any further ado. Material for MkDocs comes
- with built-in search – no server needed – that will instantly answer your
- users' queries.
- * **Many configuration options** — change the color palette, font families,
- language, icons, favicon and logo. Add a source repository link, links to your
- social profiles, Google Analytics and Disqus - all with a few lines of code.
- * **Truly international** — thanks to many contributors, Material for MkDocs
- includes translations for more than 40 languages and offers full native RTL
- (right-to-left) support for languages such as Arabic, Persian (Farsi) and
- Hebrew.
- * **Accessible** — Material for MkDocs provides extensible keyboard navigation
- and semantic markup including role attributes and landmarks. Furthermore, the
- layout is entirely based on `rem` values, respecting the user's default font
- size.
- * **Beyond GitHub Markdown** — integrates natively with Python Markdown
- Extensions, offering additional elements like callouts, tabbed content
- containers, mathematical formulas, critic markup, task lists, and emojis.
- * **Modern architecture** — Material for MkDocs's underlying codebase is built
- with TypeScript, RxJS, and SCSS, and is compiled with Webpack, bringing
- excellent possibilities for theme extension and customization.
- ## Quick start
- Material for MkDocs can be installed with `pip`:
- ``` sh
- pip install mkdocs-material
- ```
- Add the following line to `mkdocs.yml`:
- ``` yaml
- theme:
- name: material
- ```
- For other installation methods, configuration options, and a demo, visit
- [squidfunk.github.io/mkdocs-material][1]
- [1]: https://squidfunk.github.io/mkdocs-material/
- ## Users
- * **Companies** —
- [AWS](https://awssecworkshops.com/),
- [Datadog](https://datadoghq.dev/integrations-core/),
- [ING](https://ing-bank.github.io/baker/),
- [Lyft](https://lyft.github.io/amundsen/),
- [Netflix](https://netflix.github.io/titus/),
- [Salesforce](https://policy-sentry.readthedocs.io/en/latest/),
- [SAP](https://sap.github.io/ui5-tooling/),
- [SoundCloud](https://intervene.dev/),
- [Spotify](https://spotify.github.io/mkdocs-monorepo-plugin/),
- [Square](https://square.github.io/okhttp/),
- [Uber](https://ludwig-ai.github.io/ludwig-docs/getting_started/),
- [Zalando](https://opensource.zalando.com/skipper/)
- * **Open Source** —
- [AutoKeras](https://autokeras.com/),
- [BFE](https://www.bfe-networks.net/),
- [FastAPI](https://fastapi.tiangolo.com/),
- [Kubernetes](https://kops.sigs.k8s.io/),
- [OpenFaaS](https://docs.openfaas.com/),
- [Pi-Hole](https://docs.pi-hole.net/),
- [Pydantic](https://pydantic-docs.helpmanual.io/),
- [Traefik](https://docs.traefik.io/),
- [Vapor](https://docs.vapor.codes/),
- [ZeroNet](https://zeronet.io/docs/)
- ## Sponsors
- <p>
- <a href="https://cirrus-ci.org/" target=_blank>
- <img src="https://raw.githubusercontent.com/squidfunk/mkdocs-material/master/.github/assets/sponsors/cirrus-ci.svg" width="155" />
- </a>
- </p>
- If you're using this project a lot, consider [sponsoring][2] it! This will give
- me the opportunity to sustain my efforts maintaining it. Every contribution
- counts, no matter how small!
- [2]: https://github.com/sponsors/squidfunk
- ## License
- **MIT License**
- Copyright (c) 2016-2020 Martin Donath
- Permission is hereby granted, free of charge, to any person obtaining a copy
- of this software and associated documentation files (the "Software"), to
- deal in the Software without restriction, including without limitation the
- rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
- sell copies of the Software, and to permit persons to whom the Software is
- furnished to do so, subject to the following conditions:
- The above copyright notice and this permission notice shall be included in
- all copies or substantial portions of the Software.
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
- IN THE SOFTWARE.
|