GUIDELINES.md: aggiornamento e pulizia

This commit is contained in:
bursa-pastoris 2022-08-08 20:32:04 +02:00
parent 97e129a23d
commit 8f6074ff12
1 changed files with 12 additions and 36 deletions

View File

@ -50,34 +50,11 @@ informazioni relative alle impostazioni di Inkscape.
Uno dei problemi del manuale originale è che il sezionamento è poco chiaro: ci
sono intestazioni che sembrano dello stesso livello che però hanno formato
diverso, altre che hanno formato simile sembrano essere di livello diverso.
Nella versione reimpaginata, il problema è risolto principalmente introducendo
la numerazione dei livelli di sezionamento fino a `subsubsection`. Per
ricostruire il livello delle intestazioni nel documento originale, uso come
riferimento la tabella seguente.
| titolo sezione | pagina nell'originale | livello in LaTeX |
| ---------------------------------------- | --------------------- | -----------------|
| Introduzione | 7 | part |
| Benvenuto in Not the End | 8 | chapter |
| Cos'è un gioco di ruolo | 9 | section |
| Rischia per ciò che consideri importante | 11 | subsection |
| Come scegliere l'ambientazoine | 16 | subsection |
| Qual è l'archetipo del mio eroe? | 29 | subsubsection |
| Esempi di stesura dei tratti | 33 | section* |
I sezionamenti il formato della cui intestazione corrisponde a quello di un
elemento presente nella lista è considerato del medesimo livello.
Nel manuale originale, alcuni elementi che sembrano essere di livello `section`
non compaiono nell'indice (Ad esempio, *Esempi di stesura dei tratti* a pagina
33. In LaTeX, questi elementi sono copiati come non numerati; come non numerati
sono registrati anche tutti i loro sottosezionamenti.
diverso, altre che hanno formato simile sembrano essere di livello diverso. I
relativi livelli sono stati ricostruiti "a occhio e croce".
## Lezioni
### Considerazioni iniziali
Dal manuale di gioco e dalla struttura della scheda del personaggio, sembra che
i rettangoli disegnati nel primo debbano essere utilizzati come carte, quindi
che debbano essere stampati e tagliati. Contemporaneamente però sembrerebbe
@ -88,15 +65,16 @@ sia nel manuale, accoppiate alle rispettive descrizioni, sia in un documento a
parte, più adatto per la stampa.
Per assicurare che il contenuto delle carte nei due documenti sia esattamente
lo stesso ciascuna di esse è generata da uno specifico documento sorgente,
lo stesso, ciascuna di esse è generata da uno specifico documento sorgente,
incluso sia nel manuale che nella versione per la stampa. Tali singoli
documenti sono nel percorso [`lezioni`](./lezioni).
Il problema di avere due documenti compilati distinti (manuale di gioco e carte
stampabili) contenenti le stesse carte disposte nello spazio in modo diverso
l'elemento presente nel manuale originale è stato "scomposto" in tre elementi:
Per far fronte alla necessità di costruire due documenti distinti (manuale di
gioco e carte da stampare) contenenti gli stessi elementi disposti diversamente
nello spazio, l'elemento presente nel manuale originale è stato "scomposto" in
tre parti:
MANUALE ORIGINALE || ELEMENTI
MANUALE ORIGINALE || PARTI
||
||
+---------------------------+ || +---------------------------+
@ -134,8 +112,7 @@ l'elemento presente nel manuale originale è stato "scomposto" in tre elementi:
Sia il manuale che la versione per la stampa contengono la carta (titolo,
effetto e contorni), mentre la descrizione è presente solo nel primo. I
singoli documenti per lezione contengono quindi le istruzioni per disegnare la
carta, attraverso il comando `\les` (appositamente definito in
[`lezioni.tex`](./lezioni.tex) come
carta, attraverso il comando `\les`:
% lezioni/esempio.tex
\les{Titolo}%
@ -146,8 +123,7 @@ carta, attraverso il comando `\les` (appositamente definito in
}
Tale documento è poi usato nel manuale per associare la carta alla rispettia
descrizione con il comando `\lesdesc` (anche questo definito in
[`lezioni.tex`](./lezioni.tex):
descrizione con il comando `\lesdesc`:
\lesdesc{\input{lezioni/esempio}}
{
@ -156,8 +132,8 @@ descrizione con il comando `\lesdesc` (anche questo definito in
Eventualmente su più paragrafi.
}
La versione stampabile sarà costruita disponendo sul foglio A4 le sole carte,
con
La versione stampabile è stata costruita disponendo sul foglio A4 le sole
carte, con
\input{lezioni/esempio}