Suggerimento per la documentazione di Suftesi

  • Creatore
    Topic
  • #117017
    Up
    0
    Down
    ::


    Da qualche giorno sto usando nuovamente la sempre ottima suftesi.
    Mi chiedevo se per tutti quelli che si avvicinano a Latex per la prima volta potrebbe essere d’aiuto evidenziare meglio nella documentazione della classe la presenza di biblatex-philosophy boundle che ora è menzionato quasi di sfuggita in fondo.

    Inoltre per attirare l’attenzione di chi si sta guardando intorno alla ricerca di una documentclass, sarebbe utile avere anche un colpo d’occhio sulla resa finale delle numerose combinazioni possibili degli stili (pre-defined styles: c’era un pdf con qualcosa di simile una volta… ho la stampa… forse un pezzo di una delle prime versioni della doc di suftesi…). Cosa che tra l’altro è proprio una delle caratteristiche distintive di suftesi.

    Ed infine, ancora meglio se tutto questo potesse essere raggiunto con un unico comando a terminale (invento: texdoc suftesi-boundle), questo a tutto vantaggio del neofita che potrà rendersi conto più facilmente di avere davanti quello che stava cercando.

    Grazie ancora
    Andrea

Visualizzazione 2 filoni di risposte
  • Autore
    Risposte
    • #117018
      Up
      0
      Down
      ::


      Ciao Andrea. Grazie dei suggerimenti. Hai ragione, in una delle prime documentazioni avevo inserito un certo numero di esempi degli stili di pagina. Inoltre la doc era in stile periodicalaureo, mi pare. Ho scelto in seguito di usare uno stile standard perché suftesi non è un unico stile, e non volevo che documentazione desse l’idea che si ha uno stile solo. Forse la cosa miglior sarebbe mettere gli esempi alla fine. Qui però c’è un piccolo problema TeXnico. La documentazione è scritta con una classe apposita e riprodurr gli stili di suftesi diventa una cosa molto macchinosa. Anche se possibile. L’alternativa è inserire gli esempi come immagini, che però dovrei allegare al pacchetto che carico su CTAN. Queso farebbe aumentare di molto le dimensioni del pacchetto è ciò va contro una mia personale, è discutibile, etica: è vero che gli spazi di archiviazione sono ampi ma se si ragiona così si continua a creare cose pesanti…che tanto c’è posto. Non so. Mi spiego. Siccome TeX Live è già abbastanza pesante non volevo contribuire io stesso. L’unica alternativa che vedo è allegare un file TeX che l’utente possa compilare per vedere qualche esempio di impaginazione.

      L’altra questione riguarda gli stili bibliografici. Certo potrei accennarne nella doc di suftesi. Non ci ho mai pensato. Devo solo capire come fare senza appesantire troppo. Un tempo mi è balenata l’idea di creare una sorta di macro pacchetto per scritti umanistici ma poi non ci ho più lavorato. Magari ci penso l’anno prossimo. Nel frattempo ogni consiglio è ben accetto

      Ciao
      Ivan

    • #117019
      Up
      0
      Down
      ::


      Ciao Ivan,

      comprendo la tua preoccupazione di non abusare dello spazio “apparentemente” infinito degli spazi di archiviazione.
      Una soluzione di compromesso potrebbe essere quella di non modificare radicalmente la guida suftesi.pdf, ma per lo meno di mettere ben in evidenza l’esistenza di biblatex-philosophy in texlive e soprattutto il fatto che questa è la soluzione ideale per lo studente di materie umanistiche. Starà poi a lui digitare texdoc biblatex-philosophy e vedere di che cosa si tratta.
      Questa informazione potrebbe essere messa ad esempio ben in evidenza con una piccola \section, magari all’inizio del documento, così che proprio sia impossibile non vederla.

      Per quanto riguarda invece l’aggiunta di una anteprima degli stili, potrebbe essere fatta in un pdf a parte (anche toptesi, ad esempio, ha più file di documentazione e ciascuno è a suo modo necessario). A mio modo di vedere, è importante per un utente poter vedere/decidere in anticipo la resa tipografica della classe che ha scelto. Altrimenti perché sceglierla? Tanto più che in suftesi le combinazioni sono veramente tante.

      Quindi, non avendo sostanzialmente modificato suftesi.pdf, e avendo aggiunto in texlive solo un piccolo pdf con le anteprime, magari è possibile collegare anche la doc di biblatex-philosophy in modo che risultino tutti e tre nella lista generata digitando $ texdoc -l suftesi ?

      ciao
      Andrea

    • #117020
      OldClaudio
      Partecipante
        Up
        0
        Down
        ::



        @And
        , anch’io sono un estimatore di suftesi, Sarebbe stato fuori luogo presentare delle pagine con immagini composto con suftesi quando ho scritto una delel guide yematiche, disponibili sul nostro foru, la guida sulla progettazine grafica della pagina; in quella guid ho messo solo i disegni delle pagine, non quello che le riempie, ma ci sono tutti gli stili si suftesi; in partela guida stessa adotta o simula uno degli stili compositivi di suftesi.
        Certo la progettazione grafica fa parte di suftesi, ma non è tuto. suftesi è molto di più.
        Mi permetto un suggerimento a Ivan; una guida tematica che esemplifichi come si deve la sua classe, non ci sarebbe il clutterign di TeX Live,ma per gli utenti prevalentemente i taliani la documnetazion suTeX Live e MikTeX consisterebbe in un link alla nostra area Documentazione.

    Visualizzazione 2 filoni di risposte
    • Devi essere connesso per rispondere a questo topic.

    Go to top