Vai al contenuto

Note sulla guida

A seguire alcune note utili ai redattori della guida

Modalità di pubblicazione

La guida è basata su MkDocs e sul tema Material.

Stile

  • creare - ove possibile - i link ipertestuali tra i capitoli. Quindi ad esempio aggiungere tutti gli hyperlink all'indice di questa pagina, o laddove si legge qualcosa come "questa possibilità deve essere spiegata nel dizionario", inserire hyperlink al capitolo sul dizionario;
  • fare attenzione a tradurre ove possibile tutto. Non lasciare nelle tabelle di esempio, i nomi colonna in spagnolo;

File originali della guida

La cartella risorse del repository contiene i file "ufficiali" della guida.

Foglio con le tabelle di esempio della guida originale

È stato creato un foglio elettronico, dove raccogliere senza alcuna formattazione, le tabelle presenti nella guida originale. Sarà comodo per produrre la versione "italiana" da inserire in questa guida.

Note per i nomi dei fogli

I numeri pagina e la numerazione tabella sempre in doppia cifra (quindi pagina, diventa 01) e se c'è una sola tabella nella pagina si mantiene lo 01.
Come numero pagina, usare quello che si legge nel piede del PDF.

Se per qualche ragione è utile avere anche un CSV delle tabelle, inserirle qui nel repo: docs/risorse/tabelle.

Come creare tabelle HTML

Nella guida originale in PDF sono presenti tabelle come quella sottostante:

Non è possibile riprodurla con una tabella in markdown, ma è necessario usare l'HTML. Qui una guida audio-video, sul come farlo:

Il tool online usato nel video di sopra, per trasformare la tabella di un foglio elettronico in HTML è TableCleaner.