# Com contribuir?

Us donem la benvinguda a l'equip d'ajuda del GIMP!

Aquest programa d'aprenentatge és per a escriure documentació. Si voleu traduir la documentació o la interfície d'usuari, aneu a "https://l10n.gnome.org/teams/xx" on «xx» és el vostre codi de llenguatge: el codi de llenguatge ISO 639-1 es pot trobar a .

## Prerequisits

### Uneix-te al Discourse

Podeu unir-vos al Servidor Discourse de Gnome i subscriure-us a gimp i documentació. Si us plau, no dubteu a fer preguntes. Si ho feu, recordeu establir les etiquetes rellevants, o pot ser que no vegem el missatge.

### Crea una còpia de treball local del codi

El manual d'ajuda del GIMP està ubicat en un dipòsit central, a https://gitlab.gnome.org/GNOME/gimp-help. Crea una còpia local del dipòsit per a assegurar-se que tothom pot treballar independentment sense que la seva feina es confongui amb la dels altres col·laboradors.

Com a principiants, podeu accedir al dipòsit git de manera anònima (sense un compte). Obriu un terminal i escriviu: git clone https://gitlab.gnome.org/GNOME/gimp-help.git .

Si teniu un compte GNOME, l'ordre és: git clone git@gitlab.gnome.org:GNOME/gimp-help.git .

Això crearà una gimp-help carpeta en el vostre directori actual. Sigueu pacients! És una baixada de 700 MB.

### Instal·lant el vostre espai aïllat

Després de baixar-vos una còpia local, executeu: cd gimp-help llavors ./autogen.sh --without-gimp ALL_LINGUAS="en xx".

Quan executeu ./autogen.sh, us podeu adonar que no trobeu alguns paquets informàtics, per exemple revisa el dblatex... no. La majoria d'ells estan relacionats amb els fitxers PDF i podeu haver-los instal·lat abans d'executar-los ./autogen.sh si voleu crear fitxers PDF.

### La carpeta gimp-help

El manual d'ús del GIMP es manté en els fitxers xml de la carpeta src. Utilitzeu aquests fitxers xml per a treballar.

## Flux de treball

### Escriptura

La llengua és l'anglès (EUA).

Per a editar fitxers XML, utilitzeu el vostre editor de text preferit (aquesta guia d'autor prefereix l'editor lliure Kate). Heu d'indicar l'editor per a:

- Idioma anglès-americà.

- A sang amb dos espais (la tecla Tab ha de moure el punter per dos espais).

- Reemplaça els tabuladors amb espais (per compatibilitat amb tots els editors de text i navegadors).

- 80 caràcters per línia.

- Ortografia automàtica amb l'anglès (EUA) com a idioma per defecte.

Els fitxers font s'escriuen amb llenguatge XML segons el DocBook DTD. Les especificacions del DocBook es poden trobar a .

No us preocupeu. No utilitzarem tots aquests elements, i podreu aprendre XML progressivament llegint els fitxers XML que hi hagi. Per als nous fitxers, si us plau, utilitzeu les plantilles que podeu trobar a la carpeta gimp-help/docs/templates.

Si escriviu un nou fitxer, l'heu d'afegir en el fitxer src/gimp.xml, o en el fitxer XML que el crida (per exemple, el fitxer src/menus/edit.xml crida undo.xml, redo.xml, fade.xml... i així).

### Validació

Quan hàgiu acabat d'escriure, heu de validar la vostra feina:

- Per a un sol fitxer, podeu utilitzar la línia d'ordres següent: `xmllint --noout --nonet --valid your-file.xml`. Aquesta ordre no mostra res si el vostre fitxer està bé. Si es troba un error, apareixerà un missatge indicant el tipus d'error i en quin lloc del fitxer es troba.

  Aquesta ordre es pot utilitzar per comprovar ràpidament un fitxer xml. Pot no trobar alguns errors. En cas de referències externes a altres fitxers, també pot mostrar missatges d'error incorrectes, perquè aquesta ordre només comprova un únic fitxer.

  (L'editor Kate té una opció (un connector) per a validar el fitxer xml actiu.)

- Quan vulgueu comprovar diversos fitxers o tot el dipòsit gimp-help, hauríeu d'executar `make validate-en`. Hauríeu de rebre un missatge de Cap error.

  Si no, una llista d'errors validats es mostra com una línia de números referits al fitxer de registre en.xml que podeu trobar a la carpeta /registre.

  Obriu el fitxer en.xml en un editor de text, escriviu a l'editor l'ordre jump to line (l'ordre del Kate editor és Ctrl G) i introduïu el número de línia per a saltar a la línia referida en el fitxer en.xml. Allà hi trobareu l'error.

  Si heu treballat en diferents fitxers XLM, mireu a dalt per a trobar en el fitxer en.xml per a trobar-hi (en el camp xml:base de l'etiqueta id), en què el fitxer xml és l'error.

  Corregiu l'error. No oblideu desar el fitxer i executar `make validate-en` una altra vegada.

  Un error freqüent és editar el fitxer de registre en.xml en comptes del fitxer XML.

### Imatges

També heu de gestionar captures de pantalla. Aquí teniu alguns consells per a fer bones captures de pantalla:

- reduïu l'àrea de captura de la pantalla tant com es pugui retallant les vores del gestor de finestres, i desactiveu el botó d'ajuda (podeu fer-ho al diàleg de preferències),

- establiu el mode d'imatge en 255 colors indexats Imatge Mode indexat

  Això no cal per a les icones, i si la vostra imatge només té pocs colors. En aquests casos, les imatges indexades són més grans que les no indexades.

- establiu la resolució d'impressió a 144 ppp (no per a imatges petites com les icones). Podeu fer-ho fàcilment amb el GIMP des d'Imatge Mida d'impressió...

- Exporta les imatges en format PNG.

No inclogueu text en anglès a les imatges. Els traductors no poden traduir-lo i a molts usuaris no els agrada. Utilitzeu els subtítols XML, o proporcioneu un fitxer .xcf a la carpeta Docs Imatges xcf imatges, indicant-lo amb un comentari en el fitxer XML:<!--TO TRANSLATORS: Corresponding .xcf file is in https://gitlab.gnome.org/GNOME/gimp-help/tree/master/docs/xcf%20images -->

Les icones del GIMP es troben a `/usr/share/gimp/2.0/icons/`. Les icones GTK es troben a `/usr/share/icons/`.

Per a incloure una icona en el text: <guiicon> <inlinemediaobject> <imageobject> <imagedata fileref="path-to-icon"/> </imageobject> </inlinemediaobject> </guiicon>

Tres ordres per a gestionar les vostres imatges:

- `make check-image-resolutions-en`: dona les referències de les imatges la resolució del qual no és de 144 ppp.

- `make check-images-en`: dona les referències de les imatges perdudes o orfes.

- `mogrify units PixelsPerTrack -density 144x144 *.png` per a establir la resolució d'impressió de totes les imatges PNG.

### Crea fitxers HTML

Un cop s'hagin validat els fitxers XML, executeu `make html-en`. Fer fitxers HTML és important per a tenir una idea del que veuran els usuaris. Probablement notareu algunes millores que s'han de fer al vostre fitxer XML.

Podeu fer un esborrany HTML (quan s'ha creat la carpeta xml/en durant la validació) per a un únic fitxer xml d'origen, executant, per exemple, l'ordre `make preview-xml/en/path-to-file.xml`. Això crea un fitxer draft.html en la carpeta html.

També podeu utilitzar yelp i executar `yelp file:///your-file.xml` .

### Enviant els vostres fitxers

Quan els vostres fitxers estiguin preparats:

No teniu un compte de GNOME

  Si no teniu un compte de GNOME, heu de trobar un corresponsal que accepti «empènyer» els vostres fitxers; això no serà difícil si envieu un missatge a la llista. Podeu enviar els vostres fitxers xml i les imatges adjuntes en un fitxer comprimit (en un arbre que reprodueix el de les carpetes src i les carpetes d'imatges si envieu diversos fitxers per a facilitar la tasca del vostre corresponsal), o bé envieu un «pedaç» que heu de crear.

  Abans de crear un pedaç, heu d'obtenir tots els fitxers xml i les imatges en l'índex. Esteu a la carpeta gimp-help, feu `git status`. Si teniu fitxers a la secció Fitxers no rastrejats, executeu `git add -A`.

  A continuació, executeu `diff --full-index --binary origine > name-of-the-patch` per a crear el pedaç.

Teniu un compte GNOME

  Tot anant bé, ja sabeu com gestionar el Git. Hi ha molts programes d'aprenentatge a la web.

  Un flux de treball comú és:

  - make validate-en

  - git status

  - git stash

  - git pull

  - git status

  - git stash apply

  - Eventually, fix conflicts

  - git add -A

  - git status

  - git commit -m "a message"

  - git push

## Annexos

Notes XML

  Identificador

  Els identificadors que identifiquen ordres i s'utilitzen quan es prem la tecla F1 a la interfície del GIMP, es troben a https://git.gnome.org/browse/gimp/tree/app/widgets/gimphelp-ids.h

  Exemples d'etiquetes XML

  procediment: en using/web.xml.

  taula: en toolbox/tools-painting.xml.

  llista de programes: a using/script-fu-tutorial.xml.

  segmentedlist: en dialogs/path-dialog.xml per una llista de columnes n.

Pares i fills

  Aquí hi ha un diagrama que sovint faig servir.

## Treballant amb Windows

La documentació aquí estava obsoleta. Per ara, consulteu el nostre README per al repositori gimp-help.

El GIMP Com contribuir?