Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

DOC: Support dynamic filtering by tags for gallery examples with Sphinx-Gallery v0.21.0

Aperta
#4,599 5 commenti 2 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
42/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
python
Ambito
documentation

Direzione di ricerca

Leggi prima la documentazione del tagging di Sphinx-Gallery v0.21.0 e la demo della galleria collegata. Esamina gli esempi di galleria esistenti, la configurazione di Sphinx-Gallery e le guide per contribuire per definire i tag consentiti e dove devono essere documentati. Il lavoro è completo quando l’elenco dei tag è concordato e documentato, gli esempi utilizzano il meccanismo di tagging e la documentazione pertinente sulla navigazione o sui contributi è aggiornata.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

discussions documentation

Sphinx-Gallery v0.21.0 introduces tag support for gallery examples, which allows examples to be tagged and filtered more effectively. See https://sphinx-gallery.github.io/stable/configuration.html#tagging-examples-and-filtering for the usage and https://sphinx-gallery.github.io/stable/auto_examples/index.html?#general-examples for a live demo.

This feature would be very beneficial for the PyGMT gallery, which has grown substantially and can be difficult to navigate, especially for new users. Tag support would allow:

  • Better discoverability of examples
  • More flexible navigation
  • Easier onboarding for new users
  • Improved documentation structure without major reorganization

Potential checklist

  • Decide if we want to support tags
  • Decide on the list of allowed tags for PyGMT
  • Document the list of allowed tags
  • Upgrade to Sphinx-Gallery ≥ 0.21.0
  • Add tags to gallery examples using the new tagging mechanism [definitely in multiple PRs]
  • See if we should reorganize the structure of the gallery
  • Update contributing guides
Lingua principale
Python
Stelle
875
Fork
256
Merge medio
2g 22h
PR unite (30g)
43

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di GenericMappingTools/pygmt

Tutte le issue di GenericMappingTools/pygmt

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.