1. 30 Dec, 2011 1 commit
    • Gaetan Nadon's avatar
      docbook.am: embed css styles inside the HTML HEAD element · b7bb23fe
      Gaetan Nadon authored
      Rather than referring to the external xorg.css stylesheet, embed the content
      of the file in the html output produced. This is accomplished by using
      version 1.10 of xorg-xhtml.xsl.
      
      This makes the whole html docs tree much more relocatable.
      In addition, it eliminates xorg.css as a runtime file which makes
      xorg-sgml-doctools a build time only package.
      Signed-off-by: 's avatarGaetan Nadon <nadon@memsize.(none)>
      b7bb23fe
  2. 09 Sep, 2011 1 commit
    • Gaetan Nadon's avatar
      compose: upgrade makefile to support olinking on chunked html · 24632d28
      Gaetan Nadon authored
      The essential differences over the regular docbook.am are:
      Adding root.filename parameter for naming of chapters html files.
      Using xhtml xmlto format and xorg-chunk.xsl stylesheet
      Set olink.base.uri for pdf but not for chunked html
      Olink is not applicable to ps and txt formats.
      
      Html chapters are added to shelf_DATA as they are also installed.
      The xml is generated from a perl script and not distributed.
      
      Requires version 1.10 of xorg-sgml-doctools.
      Signed-off-by: Gaetan Nadon's avatarGaetan Nadon <memsize@videotron.ca>
      24632d28
  3. 31 Aug, 2011 2 commits
  4. 25 Aug, 2011 2 commits
    • Gaetan Nadon's avatar
      docbook.am: explicitly list xmlto flags for each target · b5ed2d36
      Gaetan Nadon authored
      Normal evolution of make targets make it impractical to factor out
      common command flags for xmlto.
      
      The targets now list each command option as its presence or absence
      needs to be justified.
      
      xorg.ss is only needed by xmlto for html.
      masterdb is only needed by xmlto.
      img.src.path must not be used by html.
      xsltproc need to use customization layer xorg-*.xsl.
      txt format is not required to search masterdb.
      Signed-off-by: Gaetan Nadon's avatarGaetan Nadon <memsize@videotron.ca>
      b5ed2d36
    • Gaetan Nadon's avatar
      docbook.am: do not generate docs if docbook customization layer is missing · d5b3605f
      Gaetan Nadon authored
      The stylesheets used to be only about style, fonts or colors.
      Complex features are now used like olink and chunked html which
      may cause a build break when stylesheets are missing or lead to hard
      to find problem.
      
      Some modules may be built when stylesheets are present while others
      are built without. There is no requirement to build crippled docs.
      Signed-off-by: Gaetan Nadon's avatarGaetan Nadon <memsize@videotron.ca>
      d5b3605f
  5. 11 Jun, 2011 1 commit
    • Gaetan Nadon's avatar
      Install target dbs alongside generated documents · b370eeb0
      Gaetan Nadon authored
      This matches a change in xorg-sgml-docs whereby the masterdb will look for
      the target dbs into the same location as the generated documents.
      
      The target dbs are now installed alongside the generated documents.
      Previously they are installed in $prefix/sgml/X11/dbs alongside masterdb which
      has the potential of installing outside the package prefix and cause
      distcheck to fail when user does not have write permission in this package.
      
      Requires XORG_CHECK_SGML_DOCTOOLS(1.8) which was released 2011-06-11
      b370eeb0
  6. 13 Apr, 2011 1 commit
  7. 31 Mar, 2011 1 commit
    • Gaetan Nadon's avatar
      Documentation: add Docbook external references support · e8c76407
      Gaetan Nadon authored
      When writing technical documentation, it is often necessary to cross
      reference to other information. When that other information is not in the
      current document, additional support is needed, namely <olink>.
      
      A new feature with version 1.7 of xorg-sgml-doctools adds references to
      other documents within or outside this package.
      
      This patch adds technical support for this feature but does not change
      the content of the documentation as seen by the end user.
      
      Each book or article must generate a database containing the href
      of sections that can be referred to from another document. This database
      is installed in DATAROOTDIR/sgml/X11/dbs. There is a requirement that
      the value of DATAROOTDIR for xorg-sgml-doctools and for the package
      documentation is the same. This forms a virtual document tree.
      
      This database is consulted by other documents while they are being generated
      in order to fulfill the missing information for linking.
      Refer to the xorg-sgml-doctools for further technical information.
      Co-authored-by: Matt Dew's avatarMatt Dew <marcoz@osource.org>
      Signed-off-by: Gaetan Nadon's avatarGaetan Nadon <memsize@videotron.ca>
      e8c76407