feat: build from tacc docs docker image

Overview

Give https://designsafe-ci.org/user-guide/ the theme and features of https://docs.tacc.utexas.edu/ in such a way that other repos can do the same with ease.

Status

Reviewed multiple times by developer, designer, stakeholder, and contributor. Stakeholder says to deploy when I feel comfortable. I will merge into epic/redesign-2024, so further changes are independent of this TACC-Docs PR.

- [x] Developer review \# 1. - [x] Developer review \# 1 updates. ^#2 - [x] Stakeholder review \# 1. - [x] Stakeholder review \# 1 updates. ^57f498f - [x] Deploy. - [x] Document intent to make installable TACC theme. - [x] Use a TACC-Docs version **not** a commit (pre-release of [TACC/TACC-Docs#15](https://github.com/TACC/TACC-Docs/pull/15)). - [x] [Developer review \# 2](https://github.com/DesignSafe-CI/DS-User-Guide/pull/1#pullrequestreview-2041777918). - [x] Developer review \# 2 updates. ^{https://github.com/DesignSafe-CI/DS-User-Guide/pull/1#pullrequestreview-2094707095
https://github.com/DesignSafe-CI/DS-User-Guide/pull/1#pullrequestreview-2069087570} - [x] Stakeholder review \# 2. — 2024/05/28 ^{86c4878, get "Contributor review \#1"} - [x] Contributor review \# 1 (@silviamazzoni). - [x] Contributor review \# 1 updates. ^{51d1367, 6bca8d4, editor can instead use [old nav config](https://github.com/DesignSafe-CI/DS-User-Guide/blob/816dcd1/user-guide/mkdocs.yml#L62-L85) to set title for navigation} - ~~Stakeholder review \# 3.~~ ^{I was told I could deploy when I think it is ready.} - [x] Swap out the logo with [new one](https://www.designsafe-ci.org/). ^{3c562755, e29e2bc6}

DES-2469
requires https://github.com/TACC/TACC-Docs/pull/15
depends on #14

Changes

added rule to ignore TACC-Docs files in Git
changed Dockerfile to only:
- load taccwma/tacc-docs
- archive TACC-Docs files
- copy over specific TACC-Docs files
changed Makefile to remove TACC assets only for Docker users
documented local development gotcha
added script to clone essential TACC-Docs files
added code to integrate TACC docs only for Docker users
removed Poetry dependencies (because TACC will provide them)
removed custom styles and scripts (because TACC will provide them)
added favicon, logo, and CMS link

Testing

Live

[!TIP] Available on DesignSafe "Next" server at /user-guide/.

TACC Theme via Docker

Setup site via Docker or see deploy works at https://pprd.docs.tacc.utexas.edu/.
Verify site has style of https://docs.tacc.utexas.edu/.

Non-Docker Regression Test

Setup site via Python
Verify site has MkDocs readthedocs theme.

Docker & Non-Docker Steps

Verify site has content of https://designsafe-ci.org/user-guide/.
Verify pages load images.
Verify search still works.
Verify Nav behavior matches production.

UI

TACC Theme via Docker— as of 51d1367

Non-Docker Regression Test — as of 412eff9

Notes

Installing the TACC assets and theme dir as a MkDocs theme is a great idea! See CMD-154: TACC Docs Styles via Installable Theme. Not done yet, because TACC Docs theme might because there is a deadline to meet.

DesignSafe-CI / DS-User-Guide