MkDocs TACC Theme

A TACC-styled MkDocs theme based on MkDocs' own ReadTheDocs theme.

• Either Create a New MkDocs-TACC Project
• Or Install Theme Into Existing MkDocs Project

Create a New MkDocs-TACC Project

1. Create a repository from our mkdocs-tacc-client template. How?
2. In your new repository:
   • Change all instances of mkdocs-tacc-client to your-project-name.
   • Change all instances of MkDocs-TACC to Your Project Name.
   • Rename mkdocs_tacc_client directory to your_project_name.

Install Theme Into Existing MkDocs Project

1. Enter the directory of your MkDocs project e.g.

   cd path/to/your/mkdocs/project

2. Install the theme (and optional dependencies) e.g.

   pip install "mkdocs-tacc[all]"

Note

We also offer detailed instructions instead.

How to Use

3. In your mkdocs.yml:

   • Set theme name as tacc_readthedocs.
   • Set typical extensions for this theme.

Known Clients

Status	Repository
Active	TACC-Docs wesleyboar/Digital-Rocks-Docs
Upcoming	DesignSafe-CI/DS-User-Guide
Potential	TACC/containers_at_tacc TACC/life_sciences_ml_at_tacc

Contributing

We welcome contributions. Read "How to Contribute".