Author: Guillem Jover --- configure.in | 2 doc/docbook/Makefile.in | 20 +++++-- doc/docbook/docbook-utils.dsl | 115 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 133 insertions(+), 4 deletions(-) --- a/doc/docbook/Makefile.in +++ b/doc/docbook/Makefile.in @@ -9,12 +9,24 @@ prefix = @prefix@ srcdir = @srcdir@ +abs_srcdir = @abs_srcdir@ docdir = $(prefix)/share/doc/bochs -DOCBOOK2HTML = @DOCBOOK2HTML@ WGET = @WGET@ TARGZ = bochsdoc.tar.gz RENDERED_DOC_URL = http://bochs.sf.net/doc/docbook/$(TARGZ) +ifdef USE_JADE +# jade build +HTML_STYLESHEET = $(abs_srcdir)/docbook-utils.dsl\#html +JADE = @JADE@ +JADE_ARGS = -t sgml -i html -d $(HTML_STYLESHEET) # -V nochunks +SGML_VALIDATE = nsgmls -s +DOCBOOK2HTML = $(JADE) $(JADE_ARGS) +else +# docbook-utils build +DOCBOOK2HTML = @DOCBOOK2HTML@ +endif + DESTDIR= # name of the major documentation sections @@ -42,15 +54,15 @@ all: $(SECTION_HTML) user/index.html: $(srcdir)/user/user.dbk -mkdir -p user - $(DOCBOOK2HTML) -o user $(srcdir)/user/user.dbk + cd user; $(DOCBOOK2HTML) user.dbk documentation/index.html: $(srcdir)/documentation/documentation.dbk -mkdir -p documentation - $(DOCBOOK2HTML) -o documentation $(srcdir)/documentation/documentation.dbk + cd documentation; $(DOCBOOK2HTML) documentation.dbk development/index.html: $(srcdir)/development/development.dbk -mkdir -p development - $(DOCBOOK2HTML) -o development $(srcdir)/development/development.dbk + cd development; $(DOCBOOK2HTML) development.dbk fixperm:: # fix permissions locally so that tar will install things right --- /dev/null +++ b/doc/docbook/docbook-utils.dsl @@ -0,0 +1,115 @@ + + + + + + ]]> + + + ]]> +]> + + + + + +;; =================================================================== +;; Generic Parameters +;; (Generic currently means: both print and html) + +(define %chapter-autolabel% #t) +(define %section-autolabel% #t) +(define (toc-depth nd) 3) + + + + + + +;; =================================================================== +;; Print Parameters +;; Call: jade -d docbook-utils.dsl#print + +; === Page layout === +;; (define %paper-type% "A4") ;; use A4 paper - comment this out if needed + +; === Media objects === +(define preferred-mediaobject-extensions ;; this magic allows to use different graphical + (list "eps")) ;; formats for printing and putting online +(define acceptable-mediaobject-extensions + '()) +(define preferred-mediaobject-notations + (list "EPS")) +(define acceptable-mediaobject-notations + (list "linespecific")) + +; === Rendering === +(define %head-after-factor% 0.2) ;; not much whitespace after orderedlist head +(define ($paragraph$) ;; more whitespace after paragraph than before + (make paragraph + first-line-start-indent: (if (is-first-para) + %para-indent-firstpara% + %para-indent%) + space-before: (* %para-sep% 4) + space-after: (/ %para-sep% 4) + quadding: %default-quadding% + hyphenate?: %hyphenation% + language: (dsssl-language-code) + (process-children))) + + + + + + +;; =================================================================== +;; HTML Parameters +;; Call: jade -d docbook-utils.dsl#html + +; === File names === +(define %root-filename% "index") ;; name for the root html file +(define %html-ext% ".html") ;; default extension for html output files +(define %html-prefix% "") ;; prefix for all filenames generated (except root) +(define %use-id-as-filename% #f) ;; if #t uses ID value, if present, as filename + ;; otherwise a code is used to indicate level + ;; of chunk, and general element number + ;; (nth element in the document) +(define use-output-dir #f) ;; output in separate directory? +(define %output-dir% "HTML") ;; if output in directory, it's called HTML + +; === HTML settings === +(define %html-pubid% "-//W3C//DTD HTML 4.01 Transitional//EN") ;; Nearly true :-( +(define %html40% #t) + +; === Media objects === +(define preferred-mediaobject-extensions ;; this magic allows to use different graphical + (list "png" "jpg" "jpeg")) ;; formats for printing and putting online +(define acceptable-mediaobject-extensions + (list "bmp" "gif" "eps" "epsf" "avi" "mpg" "mpeg" "qt")) +(define preferred-mediaobject-notations + (list "PNG" "JPG" "JPEG")) +(define acceptable-mediaobject-notations + (list "EPS" "BMP" "GIF" "linespecific")) +; === Rendering === +(define %admon-graphics% #t) ;; use symbols for Caution|Important|Note|Tip|Warning + +; === Books only === +(define %generate-book-titlepage% #t) +(define %generate-book-toc% #t) +(define ($generate-chapter-toc$) #f) ;; never generate a chapter TOC in books + +; === Articles only === +(define %generate-article-titlepage% #t) +(define %generate-article-toc% #t) ;; make TOC + + + + + + + --- a/configure.in +++ b/configure.in @@ -2206,6 +2206,8 @@ AC_SUBST(WX_CFLAGS) AC_SUBST(WX_CXXFLAGS) AC_SUBST(TOOLKIT_CXXFLAGS) +AC_CHECK_PROGS([JADE], [jade openjade]) + AC_CHECK_PROGS(WGET, wget curl fetch, not_found) if test "$WGET" = not_found; then AC_MSG_WARN([cannot find wget (or equivalent) command])