cfiandra” post=95346
È raro che le documentazioni di classi o pacchetti siano suddivise in capitoli, anche perché o sono veramente classi/pacchetti enormi che richiedono centinaia di pagine, oppure è perfettamente possibile limitarsi alla suddivisione in sezioni.Per inserire i comandi sul bordo margine in genere si utilizza il comando [tt]\DescribeMacro[/tt].
Per il “codice applicato”, esistono una serie anche abbastanza numerosa di pacchetti. Puoi trovarne una lista qui. Se dovessi scegliere adesso, mi orienterei su tcolorbox.
Ti consiglio di provare a partire da esempi di dtx semplici e man mano andare a leggere quelli di pacchetti “grandi” come mdframed (dove “grandi” vuol sottilineare sia la complessità del pacchetto che quella della documentazione). Esiste anche un manuale per realizzare dtx (di cui ora mi sfugge il nome).
grazie mille ci darò di sicuro un occhio e proverò di sicuro ad applicare le cose che leggo ai miei piccoli pacchettini già fatti 🙂
cfiandra” post=95346
In quanto curatore, però, puoi “consigliare caldamente” gli autori a usare i metodi “appropriati”, dove possibile naturalmente.
Pienamente d’accordo, speriamo di riuscirci 🙂
Grazie mille,
Corrado.