Hello,
Thanks Jeremy for your encouragement to contributing to darktable user
manual.
Following your suggestion I merged your additions and my explanation and
reworked the result into a text hopefully conformant to docbook and
dartable documentation conventions.
I'd like to check it by locally building the user manual before
submitting a pull request.
Alas I can't generate documentation. Cmake says:
-- Could NOT find Java (missing: Java_JAR_EXECUTABLE Java_JAVAC_EXECUTABLE
Java_JAVAH_EXECUTABLE Java_JAVADOC_EXECUTABLE) (found version "1.7.0.65")
I followed
http://darktable.org/redmine/projects/users/wiki/Translating_the_usermanual
and doc/usermanual/README.
In particular:
sudo apt-get install xsltproc fop gnome-doc-utils
And notice that manually running Java works.
java -version
java version "1.7.0_65"
OpenJDK Runtime Environment (IcedTea 2.5.3) (7u71-2.5.3-0ubuntu0.14.04.1)
OpenJDK 64-Bit Server VM (build 24.65-b04, mixed mode)
I looked at cmake/modules/FindSaxon.cmake but am now clueless.
Thanks!
Le 03/10/2014 10:37, jeremy rosen a écrit :
I would personnaly add it either to chapter 9 (special topics) or to a
new chapter (frequently asked questions, that we could develop separately)
Ulrich Pegelow is our usermanual-master, and his opinion is the one
you should most likely follow, but I don't think placement is that
important for the moment it can easily be changed after the fact.
And yes, github pull requests is a great way to contribute to the user
manual
On Thu, Oct 2, 2014 at 10:26 PM, Stéphane Gourichon
<[email protected]
<mailto:[email protected]>> wrote:
Le 02/10/2014 11:34, jeremy rosen a écrit :
Your explanation was really good, it would be awesome if you
could add it as a wiki page (and/or a section in the usermanual)
Thank you.
The documentation may make more sense than the wiki.
I see that the manual source is in git, so I can contribute
through this channel.
According to http://www.darktable.org/development/ I should
contribute to master branch and a pull request on github is fine.
Now, where to put the explanation ?
http://www.darktable.org/usermanual/ch03s02.html.php "3.2.
Darkroom concepts" ?
http://www.darktable.org/usermanual/ch03s03s03.html.php "3.3.3.
History stack" ?
http://www.darktable.org/usermanual/ch03s04.html.php "3.4. Modules" ?
There are other options: add a subsection in one of those, add a
new section "module apply order" or similar, make a link to it in
other places.
Any hint appreciated.
Regards,
--
Stéphane Gourichon
--
Stéphane Gourichon
------------------------------------------------------------------------------
_______________________________________________
Darktable-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/darktable-users
