d50fab67a9
- Nav bar text is now 20% higher opacity, hover state also differentiated with weight - In-body links are now underlined - Lightened BG colour and darkened link colour — now achieves an APCA score of 84!
1.4 KiB
Writing documentation
Our documentation is built with Material for MkDocs and configured via mkdocs.yml in the project root.
The docs can be found in the ./docs subdirectory.
To build the docs locally, install Material for MkDocs with pip:
pip install mkdocs-material
In the project root directory run mkdocs serve to run a local version of the documentation site.
The docs hosted on docs.browsertrix.cloud are created from the main branch of https://github.com/webrecorder/browsertrix-cloud
Adding icons
We typically use the Bootstrap icon set with our projects. This set is quite expansive, and we don't add the entire set into our docs folder as most icons go unused. If you wish to use an icon when writing documentation to refer to an icon present in part of the app, you may have to download the SVG file and add it to the repo.
Icons are placed in the docs/overrides/.icons/iconsetname/icon-name.svg directory, and can be added in markdown files as :iconsetname-icon-name: accordingly. For more information, see the Material for MKDocs page on Changing the logo and icons.
Docs style guide
TODO!