rethink tags
noatamir opened this issue · 4 comments
documents have tags hardcoded in content with HTML to color them red, but no crossref links
EG: https://github.com/numfocus/DISCOVER-handbook/blob/jupyter-init/DISCOVER/06_childcare.md
---
layout: page
title: Childcare
---
# Childcare
**Tags:** <span style="color:red">Parents and Carers</span>, <span style="color:red">Participant Diversity</span>, <span style="color:red">Scholarships</span>
✅ Offer financial support for childcare.
- Build it into your budget.
- Link it to sponsorships, or university partners, or ...
There's a section in jupyter book docs to create cross references here:
- https://jupyterbook.org/en/stable/content/references.html
- https://jupyterbook.org/en/stable/tutorials/references.html
Need to do more research to see if this is useful for tags. Turns out jbook is built on top of Sphinx, so there are similarities.
here is a tool to create tags in jupyterbooks/sphinx: https://github.com/melissawm/sphinx-tags
copied from temporary transition repo "discover-handbook"
https://github.com/numfocus/DISCOVER-handbook/issues/5
As discussed on 2023-02-06, we will remove all tags for now.
stumbled across this from @melissawm : https://github.com/melissawm/sphinx-tags maybe we can use it?