A fork of mkdocs readthedocs theme to make it work with mkapi
Project description
mkdocs-rtd
A fork of mkdocs readthedocs theme to make it work better, especially with mkapi.
Why just use extra_css
and extra_javascript
?
- The javascript written in
theme.js
shipped with the original theme has problems expanding the sidebar items and it's not easy to fix it only usingextra_javascript
.
Installation
pip install -U mkdocs-rtd
Usage
theme:
name: rtd
All options are the same when using the original theme (readthedocs
). See also:
https://www.mkdocs.org/user-guide/choosing-your-theme/#readthedocs
Modifications
- Add social icons (only Github supported now) to the top right corner of the page.
- Adjust some styles
- Open external links in new tab by default
- Do not reset side nav items when url hash is
#
or empty - Make search box sticky
- Add css support for
pymdownx.blocks.tab
(must usealternate_style: true
) - Set
ignoreUnescapedHTML
totrue
forhljs
- Keep current sidebar item always in view when scrolling
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mkdocs_rtd-0.0.14.tar.gz
(2.8 MB
view hashes)
Built Distribution
Close
Hashes for mkdocs_rtd-0.0.14-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d9ae35ae51bd852f9d3c1346c43546aa418669cadfa76aebfb01c84d649cf8aa |
|
MD5 | 8f5ca7ca017e84e384bcb05e57fcc363 |
|
BLAKE2b-256 | c49128b0dfebcde2b4555cf74c69ec11c9dff64b7e20a01a07f74941e5975d01 |