Switch to zensical and add new architecture diagram

[joecorall]

Purpose / why

Update the diagram at https://islandora.github.io/documentation/technical-documentation/diagram

The new version can be previewed at https://islandora.github.io/documentation/pr-preview/pr-2397/technical-documentation/diagram/

What changes were made?

• Since mkdocs-material has abandonded mkdocs, switched mkdocs to instead use zensical
• Broke up the architecture diagram into different mermaid.js diagrams
  • also added some custom CSS/JS to draw animations on the diagrams
  • also some custom JS to zoom into a mermaid diagram
• Fixed some other docs in the technical-documentation that were out of date
• Leveraged zensical's snippets extension. Wrote a bash script to parse our glossary.md into the format the snippets expect, loaded them with the proper config in mkdocs.yml so all our docs can reference terms in the glossary by wrapping the term in []

markdown_extensions:
  - zensical.extensions.preview:
      targets:
        include:
          - user-documentation/glossary.md
  - pymdownx.snippets:
      auto_append:
        - includes/abbreviations.md

Verification

Interested Parties

Checklist

Pull-request Reviewer

Pull-request reviewer should ensure the following:

• Does this PR link to related issues?
• Does the proposed documentation align with the Islandora Documentation Style Guide?
• Are the changes accurate, useful, free of typos, etc?

Person Merging

The person merging should ensure the following:

• Does mkdocs still build successfully? (This is indicated by TravisCI passing. To test locally, and see warnings, see How To Build Documentation.)
• If pages are renamed or removed, have all internal links to those pages been fixed?
• If pages are added, have they been linked to or placed in the menu?
• Did the PR receive at least one approval from a committer, and all issues raised have been addressed?

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-04-08 18:59 UTC

[aOelschlager]

Should NGINX and Traefik be added to the other open source section of the diagram page?

Everything else I read looks good to me. Thanks Joe!