numfocus/DISCOVER-Cookbook

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:

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

replaces and closes #39

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?