Hello all,

Figured out part of the confusion. Initially I had more error messages:

Xslt processor saxon not found. HTML usermanual will be built with xsltproc;
expect usermanual with inconsistent screenshot and image dimensions.


The remaining message I reported first only means my local system can run java but not compile or run javadoc. Yet it's confusing because it seems that everything actually needed is present.

I still can't build HTML manual:

make darktable-usermanual-html

[  0%] Built target darktable_single_xml
[ 97%] Built target target_media_images
Scanning dependencies of target darktable-usermanual-html
[ 97%] Updating usermanual.css
[ 97%] Building html usermanual
No adjustColumnWidths function available.
Processing terminated by xsl:message at line 402
make[3]: *** [doc/usermanual/html/index.html] Erreur 1
make[2]: *** [doc/usermanual/CMakeFiles/darktable-usermanual-html.dir/all] 
Erreur 2
make[1]: *** [doc/usermanual/CMakeFiles/darktable-usermanual-html.dir/rule] 
Erreur 2
make: *** [darktable-usermanual-html] Erreur 2

PDF manual builds and contains the changes, confirming that docbook source XML is okay.

I could figure out that error message above comes from /usr/share/xml/docbook/stylesheet/docbook-xsl/html/table.xsl which belongs to package docbook-xsl.

Indeed the XSL code says:

<xsl:when test="$use.extensions != 0
                      and $tablecolumns.extension != 0">
        <xsl:choose>
          <xsl:when test="function-available('stbl:adjustColumnWidths')">
            <xsl:copy-of select="stbl:adjustColumnWidths($colgroup)"/>
          </xsl:when>
          <xsl:when test="function-available('xtbl:adjustColumnWidths')">
            <xsl:copy-of select="xtbl:adjustColumnWidths($colgroup)"/>
          </xsl:when>
          <xsl:when test="function-available('ptbl:adjustColumnWidths')">
            <xsl:copy-of select="ptbl:adjustColumnWidths($colgroup)"/>
          </xsl:when>
          <xsl:otherwise>
            <xsl:message terminate="yes">
              <xsl:text>No adjustColumnWidths function available.</xsl:text>
            </xsl:message>




System: /Ubuntu 14.04 with software versions below.

LC_ALL=C dpkg -l xsltproc fop gnome-doc-utils saxon docbook-xsl
(...)
||/ Name                             Version               Architecture         
 Description
+++-================================-=====================-=====================-======================================================================
un  docbook-xsl-saxon                <none>                <none>               
 (no description available)
ii  fop                              1:1.1.dfsg-2ubuntu1   all                  
 XML formatter driven by XSL Formatting Objects (XSL-FO.)
ii  gnome-doc-utils                  0.20.10-1build1       all                  
 collection of documentation utilities for the GNOME project
ii  libsaxon-java                    1:6.5.5-10            all                  
 Saxon XSLT Processor
un  libsaxon-java-doc                <none>                <none>               
 (no description available)
ii  xsltproc                         1.1.28-2build1        amd64                
 XSLT 1.0 command line processor
ii  docbook-xsl                      1.78.1+dfsg-1         all                  
 stylesheets for processing DocBook XML to various output formats


Any hint about how to compile HTML manual ?


Le 31/10/2014 13:00, Stéphane Gourichon a écrit :
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. (...)


--
Stéphane Gourichon

------------------------------------------------------------------------------
_______________________________________________
Darktable-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/darktable-users

Reply via email to