Bijlage C. How to Contribute

Inhoudsopgave

1. Prerequisites
1.1. Join our mailing list
1.2. Create a Local Working Copy of Code
1.3. Installing your sandbox
1.4. The gimp-help-2 folder
2. Workflow
2.1. Writing
2.2. Validating
2.3. Images
2.4. Create HTML Files
2.5. Sending your files
3. Annexes
4. Working under Windows
4.1. Adapting Cygwin to use with GIMP documentation tools

Welcome to the GIMP-Help team!

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 http://www.loc.gov/standards/iso639-2/php/code_list.php.

1. Prerequisites

1.1. Join our mailing list

You can join our mailing list at https://mail.gnome.org/mailman/listinfo/gimp-docs-list. Please, feel free to ask questions.

1.2. Create a Local Working Copy of Code

The GIMP help Manual is lodged in a central repository at http://git.gnome.org. Creating a local copy of this repository to work on makes sure that everyone can work on his own without fuzzing around into works of other contributors.

As a newbie, you will access the git repository anonymously (without an account). Open a terminal and type: git clone git://git.gnome.org/gimp-help-2.

If you have a GNOME account, the command is: git clone ssh://yourusername@git.gnome.org/git/gimp-help-2 .

This will create a gimp-help-2 folder in your current directory. Be patient! That's a big download: about 700 MB.

1.3. Installing your sandbox

After downloading your local copy, run: cd gimp-help-2 then ./autogen.sh --without-gimp.

When running ./autogen.sh, you can notice some not found packages, for example checking for dblatex... no. Most of them are related to PDF files and you have to install them before running ./autogen.sh again if you want to create PDF files.

1.4. The gimp-help-2 folder

The GIMP User Manual is maintained in the xml files of the src folder. These xml files are used by developers.