summaryrefslogtreecommitdiff
AgeCommit message (Collapse)AuthorFilesLines
2011-11-12Updates to xslHEADmasterMatt Dew2-3/+72
2011-11-12Added refentry styleMatt Dew1-0/+5
2011-11-10fixed pathMatt Dew2-1/+26
added table styling to css to match pdf
2011-10-30Add libXt supportMatt Dew1-0/+7
2011-09-18CSS style: support styling for multi licensed docsGaetan Nadon1-0/+12
For documentation having multiple licenses, the copyright and legalnotice elements sequence cannot instantiated multiple times. The copyright notice and license text are therefore coded inside a legalnotice element. The role attribute on the paragraph is used to allow styling of the copyright notice text which should not be italicized. Also restore the font size to the default "medium" size. Markup example: <para role="multiLicensing">Copyright © 1994 X Consortium</para> Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-09-09Version bump: 1.10xorg-sgml-doctools-1.10Gaetan Nadon1-1/+1
The masterdbs for olink have changed. Currently only bigreqproto has olinks to libX11. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-09-09Embed CSS styles inside the HTML HEAD elementGaetan Nadon3-7/+21
Rather than referring to the external xorg.css stylesheet, embed the content of the file in the html output produced. This is accomplished by adding an xsl:template to the customization layer. The content of xorg.css must not be encoded due to the '<' character. 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: Gaetan Nadon <memsize@videotron.ca>
2011-09-09CSS: authors and affiliation spacingGaetan Nadon1-4/+2
The objective is to have more spacing between each author so their affiliation is visually grouped with its author. The previous method was not reliable as it was making an assumption about the preceeding element. The new method of reducing the bottom margin for the author should be more reliable. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-09-09masterdb: add olink support for chunked htmlGaetan Nadon3-88/+75
For olinks to chunked html, the masterdb cannot contain the baseuri attribute. The xsl parameter olink.base.uri needs to be used in makefiles for non chunked html while the chunked html does not use it. The txt and ps documents cannot be an end point of olinks, so no target dbs will be generated for those formats, hence no masterdb needed either. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-08-19Version bump: 1.9xorg-sgml-doctools-1.9Gaetan Nadon1-1/+1
Mainly for the new xorg-chunk.xsl Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-08-10Review documents cascading style sheetGaetan Nadon1-42/+241
There is no drastic changes in style, it will go unnoticed for the most part. Many inconsistencies in titles and headings were fixed in both books and articles. The large libX11 specs was used a reference. The border above each and every section was removed, keeping only level 2 headings. It alleviates the sense of "being lost". An additional step might be the section numbering. The body background and foreground colors are no longer set, which will not interfere with the user own styling. This should fix #37535. The figure-float was removed as it was specific for one figure and did not yield nice results. There is virtually no room for improvements with what docbook has to offer. All xorg docs were reviewed to ensure nothing got badly broken. A few changes in the doc source was made in libX11 and similar changes need to be done in the remaining xorg docs. They only affect minor spacing issues. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-07-28Add support for generating chunked xhtml for DocBooksGaetan Nadon2-0/+60
Some large documents will benefit from this feature. A different docbook xsl file must be imported. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-07-17Update masterdb for libX11/i18n/compose/libX11-keys.xmlGaetan Nadon1-0/+7
This document can be referred to using olink. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-06-11Version bump: 1.8xorg-sgml-doctools-1.8Gaetan Nadon1-1/+1
For olinks to be resolved, updated protos, libs and xserver are required. These will require XORG_CHECK_SGML_DOCTOOLS(1.8) Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-06-11Masterdb: read the target dbs from the usual doc directoryGaetan Nadon3-67/+78
This is a coordinated change with the packages building DocBook/XML. The target dbs are now installed alongside the generated documents. Currently 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. The master db xi:include statement is changed. It uses a fully qualified path but could also have used a relative path although it is difficult to ensure it would work reliably. The generated html/pdf link are still relative. The README elaborates on requirements which previously existed but were not introduced by this patch. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-06-06Masterdb: remove the libXi porting document target dbGaetan Nadon1-5/+0
There is no such document. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-04-09masterdb: match libX11 installation directory structure changeGaetan Nadon1-21/+25
i18n/framework i18n/localedb i18n/trans libX11 Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-03-29Version bump: 1.7xorg-sgml-doctools-1.7Gaetan Nadon1-1/+1
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-03-29DocBook/XML: add support for docbook external referencesGaetan Nadon9-3/+732
Documents external references ----------------------------- A new feature with version 1.7 is references to documents in other packages. For example a protocol specifications may refer to another one or to a library implementing it. This feature works with PDF, HTML, PS (and epub?) generated documents and will generate links to the other versions of the same type, i.e. html docs will link to other html docs, and pdf docs will link to other pdf docs. New: generating target databases -------------------------------- All documents will generate a target db, analogous to a symbol table which will be consulted by other documents to find linking information. This is accomplished with xsltproc. New: consulting target databases -------------------------------- While documents are being converted from xml to html/pdf/ps, they will consult the target dbs of each document they which to refer to. This is accomplished with xmlto. New: master database -------------------- A hand written database has been created which provides an association between the target dbs and the document themselves. It also reflects the hierarchical structure of the documents relative to the installation dir. New: xorg-xhtml.xsl and xorg-fo.xsl ----------------------------------- A number of motivations are behind the new (and split) versions of xorg.xsl. This module must remain backward compatible to build previous versions of documentation. It was originally designed a while ago for sgml. Given that all documents makefile had to change, it seemed a good opportunity to break from the past. Among the differences: The location of xorg.css is no longer set in the stylesheet. The chunked html is no longer supported. The html and fo parameters are kept separate. Additional parameters for external references. Now allows different values for html/fo xsl for the same parameter should that be required. The xorg-xhtml.xsl imports html/docbook.xsl The xorg-fo.xsl imports fo/docbook.xsl Co-authored-by: Matt Dew <marcoz@osource.org> Acked-by: Dan Nicholson <dbn.lists@gmail.com> Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2011-02-01config: comment, minor upgrade, quote and layout configure.acGaetan Nadon1-34/+31
Group statements per section as per Autoconf standard layout Quote statements where appropriate. Autoconf recommends not using dnl instead of # for comments Use AC_CONFIG_FILES to replace the deprecated AC_OUTPUT with parameters. Add AC_CONFIG_SRCDIR([Makefile.am]) where missing Update minimum version of util-macros to at least 1.8. No functional configuration changes This helps automated maintenance and release activities. Details can be found in http://wiki.x.org/wiki/NewModuleGuidelines Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2010-12-18xorg-sgml-doctools 1.6xorg-sgml-doctools-1.6Alan Coopersmith1-1/+1
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-12-18Set defs.ent values for 7.6 final releaseAlan Coopersmith1-1/+1
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-12-17Add Arphic PL fonts for Chinese characters in PDF/PS outputAlan Coopersmith1-1/+1
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-12-17Change the release month to DecemberAlan Coopersmith1-1/+1
I must relucantly admit that it is not actually the 47th day of November now. Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-12-16Add fop font settings to xorg.xsl to support a wider range of glyphsAlan Coopersmith1-0/+17
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> Reviewed-by: Gaetan Nadon <memsize@videotron.ca>
2010-12-13Add support for PDF bookmarks in the xorg stylesheetMatt Dew1-0/+4
PDF files can optionally include an active table of contents that is displayed alongside the pages in the PDF viewer. These references are called bookmarks. PDF bookmarks are generated using special functions in each XSL-FO processor because XSL cannot produce them directly. Bookmarks will be automatically produced when used with DocBook XSL stylesheets version 1.70.0 or later Signed-off-by: Gaetan Nadon <memsize@videotron.ca> Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com> Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-12-12Make links in pdf output blue so it's easier to tell they're links.Alan Coopersmith1-0/+8
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> Reviewed-by: Signed-off-by: Gaetan Nadon <memsize@videotron.ca> Acked-by: Peter Hutterer <peter.hutterer@who-t.net>
2010-11-29Speed up ps/pdf output by not trying to fetch draft.png from webAlan Coopersmith1-0/+6
Force draft mode to "no" instead of default of "maybe" as discussed in various posts in http://sources.redhat.com/ml/docbook-apps archives. For those of us building behind firewalls, shaves approx. 3 minutes off document creation for each set of documents by not waiting for download of the draft.png watermark image from the docbook website to time out. Also gets rid of these errors from xmlto: Nov 28, 2010 8:10:04 PM org.apache.fop.apps.FOURIResolver resolve SEVERE: Error with opening URL 'http://docbook.sourceforge.net/release/images/draft.png': Connection timed out Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> Reviewed-by: Adam Jackson <ajax@redhat.com> Reviewed-by: Gaetan Nadon <memsize@videotron.ca>
2010-11-11Update README to cover using xorg.css directly in installed docsAlan Coopersmith1-1/+3
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-11-111.5.99.901 (1.6 RC 1) snapshot for X11R7.6 RC1 docsxorg-sgml-doctools-1.5.99.901Alan Coopersmith1-1/+1
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-11-08Upgrade xorg-sgml-doctools to Autoconf 2.60 directory architectureGaetan Nadon3-4/+7
Currently the value of sgmlrootdir is hard coded relative to $prefix. In Autoconf 2.60, $datarootdir has been added to define the architecture independent data directory. --datarootdir=DIR read-only arch.-independent data root [PREFIX/share] Relative to that location, a number of subdirectories have been defined: --datadir=DIR read-only architecture-independent data [DATAROOTDIR] --infodir=DIR info documentation [DATAROOTDIR/info] --localedir=DIR locale-dependent data [DATAROOTDIR/locale] --mandir=DIR man documentation [DATAROOTDIR/man] --docdir=DIR documentation root [DATAROOTDIR/doc/xorg-sgml-doctools] --htmldir=DIR html documentation [DOCDIR] --dvidir=DIR dvi documentation [DOCDIR] --pdfdir=DIR pdf documentation [DOCDIR] --psdir=DIR ps documentation [DOCDIR] The sgmlrootdir should hang off datarootdir. If there is a need to specify a different location, a new configure option should be added: --sgmldir=DIR sgml stylesheets and entities [DATAROOTDIR/sgml] An sgmlrootdir Automake variable is defined in configure.ac to provide a unique value holder for the sgmlrootdir. Variable PACKAGE_VERSION is preferred over the undocumented VERSION variable. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2010-11-06xorg.css: center <othercredit> as wellAlan Coopersmith1-1/+2
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-11-02defs.ent: Remove CDATA declarations from entities for xml compatibilityAlan Coopersmith1-11/+11
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-11-02Update defs.ent for X11R7.6 RC1Alan Coopersmith1-10/+10
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-10-08xorg.xsl: make index links point to the indexterm locationAlan Coopersmith1-0/+3
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-10-08xorg.css: center more bits of title pagesAlan Coopersmith1-1/+1
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-06-28Add style rules for <screen> output sections to xorg.cssAlan Coopersmith1-1/+12
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-06-23xorg-sgml-doctools 1.5xorg-sgml-doctools-1.5Alan Coopersmith1-1/+4
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-06-18Bump minimum autoconf version required to 2.60Alan Coopersmith1-1/+1
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-06-18Add COPYING & README filesAlan Coopersmith2-0/+70
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2010-06-18Provide common CSS & XSL stylesheets for DocBook docsAlan Coopersmith3-2/+128
These have been copied into & expanded in several modules already, might as well make a common copy to share so that our docs end up with a common style. Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> Reviewed-by: Dan Nicholson <dbn.lists@gmail.com>
2010-04-05Version bump: 1.4xorg-sgml-doctools-1.4Gaetan Nadon1-1/+1
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2010-04-02Provide a pkg-config fileYaakov Selkowitz3-0/+10
This allows the SGML entities to be found no matter where they are installed, or even when cross-compiling. Signed-off-by: Yaakov Selkowitz <yselkowitz@users.sourceforge.net> Reviewed-by: Gaetan Nadon <memsize@videotron.ca>
2009-12-01Makefile.am: add ChangeLog and INSTALL on MAINTAINERCLEANFILESGaetan Nadon1-0/+1
Now that the INSTALL file is generated. Allows running make maintainer-clean. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2009-10-28INSTALL, NEWS, README or AUTHORS files are missing/incorrect #24206Gaetan Nadon1-2/+5
Add missing INSTALL file. Use standard GNU file on building tarball README may have been updated Remove AUTHORS file as it is empty and no content available yet. Remove NEWS file as it is empty and no content available yet.
2009-10-26Makefile.am: ChangeLog not required: EXTRA_DIST or *CLEANFILES #24432Gaetan Nadon1-2/+0
ChangeLog filename is known to Automake and requires no further coding in the makefile.
2009-10-26.gitignore: use common defaults with custom section # 24239Gaetan Nadon1-7/+72
Using common defaults will reduce errors and maintenance. Only the very small or inexistent custom section need periodic maintenance when the structure of the component changes. Do not edit defaults.
2009-10-22xorg-sgml-doctools 1.3xorg-sgml-doctools-1.3Alan Coopersmith1-1/+1
Signed-off-by: Alan Coopersmith <alan.coopersmith@sun.com>
2009-10-22Migrate to xorg macros 1.3 & XORG_DEFAULT_OPTIONSAlan Coopersmith1-6/+6
Signed-off-by: Alan Coopersmith <alan.coopersmith@sun.com>
2009-10-22Set defs.ent values for 7.5 final releaseAlan Coopersmith1-6/+6
Signed-off-by: Alan Coopersmith <alan.coopersmith@sun.com>