Appendice C. Come contribuire

Indice

1. Prerequisiti
1.1. Collegati a Discourse
1.2. Crea una copia di lavoro del codice
1.3. Installazione della propria sandbox
1.4. La cartella gimp-help
2. Flusso di lavoro
2.1. Scrivere
2.2. Validazione
2.3. Immagini
2.4. Creazione file HTML
2.5. Spedire i file
3. Allegati
4. Al lavoro su Windows

Benvenuti nella squadra della documentazione di GIMP!

This tutorial is intended for writing documentation. If you want to translate the documentation or the user interface, please go to "https://l10n.gnome.org/teams/xx" where "xx" is your language code: ISO 639-1 language codes can be found at https://www.loc.gov/standards/iso639-2/php/code_list.php.

1. Prerequisiti

1.1. Collegati a Discourse

Ci si può collegare al server Discourse di Gnome e iscriversi a gimp e documentazione. Sentitevi liberi di fare domande. Se ne fate, ricordasi di impostare i tag pertinenti, altrimenti i messaggi potrebbero passare inosservati.

1.2. Crea una copia di lavoro del codice

Il manuale di GIMP è ospitato in un repository centrale su https://gitlab.gnome.org/GNOME/gimp-help. La creazione di una copia di lavoro locale di questo repository assicura che tutti possano lavorare sulla propria senza disturbare il lavoro degli altri collaboratori.

Come principiante, avrai accesso al repository git in forma anonima (senza un account). Aprire un terminale e battere: git clone https://gitlab.gnome.org/GNOME/gimp-help.git .

Se si possiede un account GNOME, il comando diventa: git clone git@gitlab.gnome.org:GNOME/gimp-help.git .

Questo comando creerà una cartella «gimp-help» nella propria cartella corrente. Abbiate pazienza! Sarà un grosso scaricamento: circa 700 MB.

1.3. Installazione della propria sandbox

Dopo aver scaricato la propria copia locale, eseguire: cd gimp-help e poi ./autogen.sh --without-gimp ALL_LINGUAS="en xx" .

Durante l'esecuzione di ./autogen.sh, è possibile notare che alcuni pacchetti siano mancanti, per esempio «checking for dblatex... no». Molti di questi sono relativi alla gestione dei file PDF ed è necessario installarli prima di eseguire nuovamente ./autogen.sh se si vuole creare file PDF.

1.4. La cartella gimp-help

Il Manuale Utente di GIMP è costituito da file xml presenti nella cartella «src». Questi file xml sono quelli su cui si lavorerà.