numfocus / DISCOVER-Cookbook

The NumFOCUS DISCOVER Cookbook (Diverse & Inclusive Spaces and Conferences: Overall Vision and Essential Resources). A guide for organizing more diverse and inclusive events and conferences, produced by the NumFOCUS Diversity & Inclusion in Scientific Computing (DISC) Program, with support from the Moore Foundation.
http://discover-cookbook.numfocus.org
MIT License
175 stars 23 forks source link

rethink tags #49

Closed noatamir closed 1 year ago

noatamir commented 1 year ago

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

mikofski commented 1 year ago

copied from temporary transition repo "discover-handbook" https://github.com/numfocus/DISCOVER-handbook/issues/5

noatamir commented 1 year ago

replaces and closes #39

mikofski commented 1 year ago

As discussed on 2023-02-06, we will remove all tags for now.

mikofski commented 1 year ago

stumbled across this from @melissawm : https://github.com/melissawm/sphinx-tags maybe we can use it?