aniani/elinks
1
0
Fork 0
mirror of https://github.com/rkd77/elinks.git synced 2024-06-05 22:00:54 +00:00
Code

docs: generate pdfs using dblatex

Browse Source
This commit is contained in:
Felix Janda 2020-09-03 12:44:43 -04:00
parent 9e42f86242
commit 9e08ea995a
4 changed files with 17 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Makefile.config.in
View File

@ -69,7 +69,7 @@ INTLBISON = @INTLBISON@
INTLLIBS = @INTLLIBS@
INTLOBJS = @INTLOBJS@
INTL_LIBTOOL_SUFFIX_PREFIX = @INTL_LIBTOOL_SUFFIX_PREFIX@
JW = @JW@
DBLATEX = @DBLATEX@
LIBDIR = @LIBDIR@
LIBDOM_CFLAGS = @LIBDOM_CFLAGS@
LIBDOM_LIBS = @LIBDOM_LIBS@
@ -139,7 +139,7 @@ CONFIG_HTML_HIGHLIGHT = @CONFIG_HTML_HIGHLIGHT@
CONFIG_IDN = @CONFIG_IDN@
CONFIG_INTERLINK = @CONFIG_INTERLINK@
CONFIG_IPV6 = @CONFIG_IPV6@
CONFIG_JW = @CONFIG_JW@
CONFIG_DBLATEX = @CONFIG_DBLATEX@
CONFIG_LEDS = @CONFIG_LEDS@
CONFIG_LIBDOM = @CONFIG_LIBDOM@
CONFIG_LZMA = @CONFIG_LZMA@

16
configure.ac
View File

@ -74,7 +74,7 @@ PKG_PROG_PKG_CONFIG
CONFIG_ASCIIDOC="no"
CONFIG_POD2HTML="no"
CONFIG_XMLTO="no"
CONFIG_JW="no"
CONFIG_DBLATEX="no"
if test "x$CONFIG_DOC" != xno; then
AC_PATH_PROGS(PYTHON3, "python3")
@ -91,10 +91,10 @@ if test "x$CONFIG_DOC" != xno; then
EL_CONFIG(MAN_XMLTO, [man (groff)])
fi
AC_PATH_PROGS(JW, "jw")
if test "x$JW" != "x"; then
EL_CONFIG(CONFIG_JW, [JadeWrapper])
EL_CONFIG(MANUAL_JW, [PDF])
AC_PATH_PROGS(DBLATEX, "dblatex")
if test "x$DBLATEX" != "x"; then
EL_CONFIG(CONFIG_DBLATEX, [dblatex])
EL_CONFIG(MANUAL_DBLATEX, [PDF])
fi
AC_PATH_PROGS(POD2HTML, "pod2html")
@ -114,10 +114,10 @@ AC_SUBST(CONFIG_ASCIIDOC)
AC_SUBST(CONFIG_DOXYGEN)
AC_SUBST(CONFIG_POD2HTML)
AC_SUBST(CONFIG_XMLTO)
AC_SUBST(CONFIG_JW)
AC_SUBST(CONFIG_DBLATEX)
EL_CONFIG_DEPENDS(CONFIG_DOC, [CONFIG_ASCIIDOC CONFIG_XMLTO CONFIG_JW CONFIG_POD2HTML], [Documentation Tools])
EL_CONFIG_DEPENDS(CONFIG_MANUAL, [MANUAL_ASCIIDOC MANUAL_XMLTO MANUAL_JW], [Manual Formats])
EL_CONFIG_DEPENDS(CONFIG_DOC, [CONFIG_ASCIIDOC CONFIG_XMLTO CONFIG_DBLATEX CONFIG_POD2HTML], [Documentation Tools])
EL_CONFIG_DEPENDS(CONFIG_MANUAL, [MANUAL_ASCIIDOC MANUAL_XMLTO MANUAL_DBLATEX], [Manual Formats])
EL_CONFIG_DEPENDS(CONFIG_MANPAGE, [MAN_ASCIIDOC MAN_XMLTO], [Man Page Formats])
EL_CONFIG_DEPENDS(CONFIG_APIDOCS, [CONFIG_DOXYGEN], [API Documentation])

10
doc/Makefile
View File

@ -54,8 +54,8 @@ MAN_DOCS-$(CONFIG_XMLTO) += \
elinks.conf.5 \
elinkskeys.5
# Use jw for generating PDF, since xmlto seems to freak out.
PDF_DOCS-$(CONFIG_JW) += \
# Use dblatex for generating PDF
PDF_DOCS-$(CONFIG_DBLATEX) += \
manual.pdf
API_DOCS-$(CONFIG_DOXYGEN) += \
@ -146,8 +146,8 @@ option-%.frag.xhtml: $(ELINKS) $(HELP2XML)
#############################################################################
# Build commands and macros
quiet_cmd_jw = ' [$(LINK_COLOR)JW$(END_COLOR)] $(RELPATH)$@'
cmd_jw = $(JW) -b $(2) $<
quiet_cmd_dblatex = ' [$(LINK_COLOR)DBLATEX$(END_COLOR)] $(RELPATH)$@'
cmd_dblatex = $(DBLATEX) $<
quiet_cmd_xmlto = ' [$(LINK_COLOR)XMLTO$(END_COLOR)] $(RELPATH)$@'
cmd_xmlto = $(XMLTO) -o $(call outdir) $(3) $(2) $<
@ -203,7 +203,7 @@ elinks.conf.5.html: option-config.frag.xhtml
$(call cmd,xmlto,html)
%.pdf: %.xml
$(call cmd,jw,pdf)
$(call cmd,dblatex)
%.html: %.pod
$(call cmd,pod2html)

4
doc/README
View File

@ -76,7 +76,7 @@ The following tools are used for generating documentation in various formats:
- python: interpreter for asciidoc, which is the basic tool for
lifting the .txt files to other formats.
- xmlto: used for outputting chunked HTML and man pages.
- jw: used for pdf documents.
- dblatex: used for pdf documents.
- pod2html: used for perl docs.
All these tools are checked by configure, thus to successfully build all the
@ -89,7 +89,7 @@ manual formats (with tool requirements listed):
- HTML one-file (asciidoc)
- HTML chunked / multiple files (asciidoc + xmlto)
- PDF (asciidoc + jw)
- PDF (asciidoc + dblatex)
and the following man page formats: