Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix numerazione automatica figure #24

Merged
merged 3 commits into from
May 28, 2024

Conversation

AgostinoPurificato
Copy link
Collaborator

Problema: alcune figure mostravano solo la numerazione inserita manualmente negli rst, mentre altre sia quella manuale che quella automatica.

Esempio 1:
image

Esempio 2:
image

Soluzione: fix della numerazione automatica su tutte le figure, ed eliminazione di quella manuale. In questo modo, ad ogni aggiunta/eliminazione di una figura, non sarà necessario modificare la numerazione manualmente.

Esempio 1:
image

Esempio 2:
image

Open point: l'indice delle figure generato automaticamente riesce a indicizzare solo una figura, che è contenuta in un file rst sotto la cartella docs. Tutte le altre figure, contenute in file rst a loro volta contenuti in sotto-cartelle di docs, non sono indicizzate in automatico.
image
Una possibile soluzione al problema è quella di compattare i vari file rst di sotto-capitoli in un singolo rst, così da ottenere un singolo file rst per ciascun capitolo (sono 6 in totale). In questo modo, l'indicizzazione delle figure automatica dovrebbe funzionare, ma si perderebbe in leggibilità della guida (si avrebbero solo sei pagine ma piuttosto lunghe).

CC: @Clou-dia @bfabio @mauropratesi

Copy link

vercel bot commented May 27, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
dati-semantic-guida-ndc-docs ✅ Ready (Inspect) Visit Preview May 28, 2024 9:59am

@AgostinoPurificato AgostinoPurificato added documentation Improvements or additions to documentation bug Something isn't working labels May 27, 2024
@AgostinoPurificato
Copy link
Collaborator Author

@Clou-dia con l'ultima commit abbiamo implementato un workaround, ovvero abbiamo spostato l'immagine 2.1 (ultimo screen-shot della descrizione della PR) dal capitolo principale al cap. 2.1 (è comunque coerente col contenuto).

In questo modo, abbiamo la numerazione automatica delle figure funzionante, e l'indice delle figure non viene più mostrato (che per come funziona docs-italia-theme, sarebbe comunque parziale visto che indicizza solo le figure nei capitoli principali).

@AgostinoPurificato AgostinoPurificato merged commit e633d7c into teamdigitale:main May 28, 2024
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant