manuale + immagini – testo

Non è la prima volta che mi tocca di crivere un breve tutorial che contiene poco testo e molte immagini di screenshots che spiegano passo passo cosa fare, l’ultimo è qui:
http://www.vitacarmelitana.org/download/installazione.pdf.zip
Non so bene come devo inserire le immagini. Per il momento ho evitato l’ambiente figure e ho inserito le immagini direttamente dopo il testo, con risultati non soddisfacenti. Cosa mi consigliate? Esiste un classe che aiuti a fare qualcosa del genere? … grazie

In quel documento c’è un errore di fondo: inserisci le immagini come figure in testo (senza didascalia, incluse con un semplice \includegraphics), e poi fai riferimento alle figure con etichette non definite:

La pagina successiva ci dà un resoconto dei prerequisiti installazione [fig-9], mostrandoci che tutto è ok, altrimenti possiamo andare indietro e settare i permessi alle cartella [fig-10].

La storia delle immagini in testo e fuori testo è uno dei tormentoni del forum: la trovi riassunta a pag. 92-93 dell’Arte, che ti invito a (ri)leggere.

Non si tratta un problema di classe, ma di metodo. O usi delle figure fuori testo (con didascalia, nell’ambiente figure) oppure usi immagini in testo (senza didascalia, con un semplice \inlcudegraphics, ma poi non puoi fare riferimento ad esse nel documento). Se le immagini sono tante e il testo poco, i problemi di impaginazione sono inevitabili.

Nel tuo caso, la scelta che hai fatto di usare immagini in testo può andare (ma togli quei riferimenti inesistenti nel documento).

Ciao,
L.

grazie Lorenzo,
infatti, è proprio quello che voglio fare, cioè lasciare le figure nel testo. Il riferimento, tranne nelle ultime due immagini, che devo rivedere, li ho messi perché sulle stesse ho dovuto mettere dei riquadri numerati per indicare le zone di cui parlo nel testo. Sarà inevitabile, quindi citare nel corpo del testo i punti a cui mi riferisco.

Se devi fare riferimento ad una figura (o ad una sua parte) nel testo, ti occorre un’etichetta (e una didascalia): io se vedo qualcosa come “fig-9” (a proposito, meglio “nella figura 9”) cerco immediatamente una didascalia con l’etichetta “Figura 9”, se non la trovo resto confuso.

Facevo riferimento a qualche classe, perché pensavo alla possibilità di impaginare il testo in modo diverso, ad esempio componendo una tabella o dei riquadri in cui mettere testo a dx o sx e immagini affianco … cosa mi consigli? e come procedere in questo caso? Ora, infatti, risulta antiestetico vedere le immagni finire alla pagina successiva, quando c’è molto spazio nella pagina attuale …

Non saprei. Per me non è un problema risolvibile cambiando classe, anzi, non so neppure se sia un problema risolvibile in modo del tutto soddisfacente: tante immagini e poco testo non vanno d’accordo con un’impaginazione ottimale (perdonami l’irriverenza del paragone, ma mi ricorda un po’ il problema di coniugare l’onnipotenza di Dio e la sua infinita bontà con la presenza del male nel mondo).

Però qualche tentativo (magari un po’ forzato…) per mettere tutto assieme si può fare: io (che in queste cose sono ossessivo, e che non amo le figure in testo), proverei con tutti i trucchi di impaginazione che mi vengono in mente. Leggi il paragrafo sulla revisione finale dell’Arte. Di sicuro, c’è un po’ di lavoro da fare.

Ciao,
L.

Scusa se continuo questa discussione, che sicuramente potrebbe essere considerata esaurita, ma penso che la questione possa interessare altri utenti. E cioè se con LaTeX si possono scrivere anche dei Tutorial con abbondanza di immagini o si deve usare un altro sistema. Sulle riviste del settore informatico ci sono molti esempi di quello che dico, cioè guide che descrivono passo passo cosa fare per utilizzare un software. Allora dobbiamo dire: questo non lo puoi fare con LaTeX, usa un programma wysiwyg come Xpress, Scribus ecc…, oppure si puo fare così ecc…

Ho riletto i paragrafi delle tua guida (scritta in modo magistrale!), ed in effetti qualcosa in più l’ho capita, ma il mio caso non è contemplato. Anche guardando il paragrafo sulla revisione finale, si ricava poco circa una eventuale soluzione di impaginazione.

Sto pensando alla possibilità di usare supertabular e creare una tabella, ora faccio un esperimento e magari mi dai un consiglio. Spero di poter arrivare ad una soluzione soddisfacente, ma anche giungere alla conclusione che LaTeX e sconsigliato per questo genere di documenti … può essere un contributo. Grazie

Prima di tutto grazie per i complimenti. Come sai, pur essendo un appassionato di LaTeX, so bene che si tratta di uno strumento. Come tutti gli strumenti, fa bene certe cose e male altre. Usare LaTeX per comporre una brochure o un biglietto da visita o un menu è IMHO un’esperienza frustrante: meglio un software WYSIWYG, quando le necessità di flessibilità visiva prevalgono su quelle di coerenza logica. Da’ un’occhiata al paragrafo “Filosofia” dell’Arte.

Il tuo caso, però, non rientra fra quelli in cui è meglio usare un software “visuale” (né è risolubile con supertabular, che ti sconsiglio decisamente per l’uso che vorresti farne). Il problema è oggettivo, fisico: tante immagini grosse in testo sono difficili da posizionare al meglio, a LaTeX (ma questo vale per ogni altro software di composizione tipografica) resta poco spazio di manovra; sistemare l’impaginazione in modo adeguato può essere impossibile.

Immagina di vivere in un monolocale con tantissimi scatoloni pieni zeppi di libri, appoggiati sul pavimento. In qualsiasi modo decidi di posizionarli, sarai sempre scomodo. Non c’entra come li metti, è che manca lo spazio.

In conclusione, comporre un manuale con molti screenshot e descrizioni passo per passo è impresa non da poco, soprattutto se si cerca un risultato tipografico di alta qualità. LaTeX è lo strumento migliore. Si possono usare figure in testo oppure figure mobili; alcune di queste ultime potrebbero essere posizionate manualmente con l’opzione H di float (ecco forse uno dei rari casi in cui quell’opzione può essere usata a ragion veduta). In ogni caso, bisogna essere disposti a un considerevole lavoro di revisione manuale.

Ciao,
L.