-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
136 lines (89 loc) · 4.1 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
===========
GIMP-Help
===========
GIMP-Help is a help system designed for use with the internal GIMP help
browser, external web browser and HTML renderers, and human eyeballs.
Docbook is used to create a highly customizable system for all needs.
The current manual documents features for GIMP 2.8.
Project page and news
=====================
Recent changes and updates about the modules are available at:
http://docs.gimp.org
Tips for contribution
=====================
Write a mail to one of the authors (check the WIKI).
They should know what tasks need to be done and can find something to
do for you. You should subscribe to the gimp mailing lists to get up
to date information of the current GIMP development.
What you should know
--------------------
You should know a bit about Docbook and XML, or be smart enough to learn
the syntax yourself. You can get more information about Docbook and XML
by using your preferred search engine.
Editors, Programs and Setups
----------------------------
Use any editor you want, but you should handle it well. Please keep in
mind, that the tab width in XML Mode should be 2 spaces. It is
recommended to attach patches to a bug report. Creating patches with
git is probably better described at http://live.gnome.org, but in
short:
git format-patch HEAD^
to create a patch with your last local commits.
Provided you have xmllint installed, you can validate the XML
and check the well-formedness of the XML files by running
make validate
When you edit an XML file and want to quickly check your changes,
you can create a single quick-and-dirty HMTL draft file with
make src/of/the/xml-file.draft
where the target is the path name with extension ".draft" instead
of ".xml", or with
make preview-src/of/the/xml-file.xml
where the path name is preceded with "preview-".
The name of the HMTL draft file depends on its id (not on the name
of the XML source file!) and is displayed when the file is created.
Hints for making good screenshots
---------------------------------
* please make screenshots only with the system default theme, which
is of course just the plain gtk+ default look
* use default fonts like Bitstream Vera Sans
* crop the window manager borders
* before saving an image as PNG, check if you can convert it to indexed
mode without loss of quality (saves space and bandwidth)
* provide your source images (eg. for making new screenshots in other
languages)
TODO
====
see Bugzilla:
http://bugzilla.gnome.org/browse.cgi?product=GIMP-manual
OMF Files
=========
The directory omf holds documentation metadata that describes the user
manual and its localized versions. The format is described by the
Open Source Metadata Framework (OMF). A good resource on this subject
is the ScrollKeeper website: http://scrollkeeper.sourceforge.net/
ODF Files
=========
You need docbook2odf installed to create ODF files. Although the
transformation process is very slow (because every picture is copied to
a temp directory), you can start the transformation by typing:
make odf
Hint: Set the ALL_LINGUAS environment variable to create ODF files only
for a particular language.
Docbook2ODF can be obtained from the following website:
http://open.comsultia.com/docbook2odf/
HINT: If you get an error opening the created ODT files, open
docbook2odf (probably installed in /usr/bin/) in a text editor.
Uncomment the line:
#use encoding 'utf-8';
and rerun 'make odf'.
History of the gimp-help-2 module
=================================
The development on the original gimp-help modules came pretty much to a
stop after the first few stable versions of GIMP 1.2 were released. This is
due to several reasons, one of them being that all of the original
documentation had been converted from HTML to DocBook/SGML and apart from a
bit new content, lots of markup and proofreading not too much happened to
the organisation of the complete mess.
Daniel Egger and Mel Boyce were not too happy about the quirks with
this help system. So they started completely from scratch creating a new
manual based on Docbook/XML.