429 lines
18 KiB
Scheme
429 lines
18 KiB
Scheme
;;; GNU Guix --- Functional package management for GNU
|
|
;;; Copyright © 2014, 2018 Ludovic Courtès <ludo@gnu.org>
|
|
;;; Copyright © 2014, 2016 Andreas Enge <andreas@enge.fr>
|
|
;;; Copyright © 2016 Eric Bavier <bavier@member.fsf.org>
|
|
;;; Copyright © 2016 Roel Janssen <roel@gnu.org>
|
|
;;; Copyright © 2016 Thomas Danckaert <post@thomasdanckaert.be>
|
|
;;; Copyright © 2017 Kei Kebreau <kkebreau@posteo.net>
|
|
;;; Copyright © 2017, 2020 Efraim Flashner <efraim@flashner.co.il>
|
|
;;; Copyright © 2018 Tobias Geerinckx-Rice <me@tobias.gr>
|
|
;;; Copyright © 2019 Mathieu Othacehe <m.othacehe@gmail.com>
|
|
;;; Copyright © 2020 Ricardo Wurmus <rekado@elephly.net>
|
|
;;; Copyright © 2020, 2021 Michael Rohleder <mike@rohleder.de>
|
|
;;; Copyright © 2021, 2022 Marius Bakke <marius@gnu.org>
|
|
;;; Copyright © 2022 Maxim Cournoyer <maxim.counoyer@gmail.com>
|
|
;;; Copyright © 2023 Janneke Nieuwenhuizen <janneke@gnu.org>
|
|
;;;
|
|
;;; This file is part of GNU Guix.
|
|
;;;
|
|
;;; GNU Guix is free software; you can redistribute it and/or modify it
|
|
;;; under the terms of the GNU General Public License as published by
|
|
;;; the Free Software Foundation; either version 3 of the License, or (at
|
|
;;; your option) any later version.
|
|
;;;
|
|
;;; GNU Guix is distributed in the hope that it will be useful, but
|
|
;;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
;;; GNU General Public License for more details.
|
|
;;;
|
|
;;; You should have received a copy of the GNU General Public License
|
|
;;; along with GNU Guix. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
(define-module (gnu packages documentation)
|
|
#:use-module (guix licenses)
|
|
#:use-module (guix packages)
|
|
#:use-module (guix download)
|
|
#:use-module (guix gexp)
|
|
#:use-module (guix git-download)
|
|
#:use-module (guix build-system gnu)
|
|
#:use-module (guix build-system cmake)
|
|
#:use-module (guix build-system perl)
|
|
#:use-module (guix build-system python)
|
|
#:use-module (guix build-system qt)
|
|
#:use-module (guix deprecation)
|
|
#:use-module (guix utils)
|
|
#:use-module (gnu packages)
|
|
#:use-module (gnu packages autotools)
|
|
#:use-module (gnu packages backup)
|
|
#:use-module (gnu packages base)
|
|
#:use-module (gnu packages bash)
|
|
#:use-module (gnu packages check)
|
|
#:use-module (gnu packages python)
|
|
#:use-module (gnu packages python-xyz)
|
|
#:use-module (gnu packages bison)
|
|
#:use-module (gnu packages kde-frameworks)
|
|
#:use-module (gnu packages docbook)
|
|
#:use-module (gnu packages flex)
|
|
#:use-module (gnu packages graphviz)
|
|
#:use-module (gnu packages gettext)
|
|
#:use-module (gnu packages glib)
|
|
#:use-module (gnu packages perl)
|
|
#:use-module (gnu packages pkg-config)
|
|
#:use-module (gnu packages qt)
|
|
#:use-module (gnu packages sqlite)
|
|
#:use-module (gnu packages sphinx)
|
|
#:use-module (gnu packages xml)
|
|
#:use-module (gnu packages xorg))
|
|
|
|
(define-public latex2html
|
|
(package
|
|
(name "latex2html")
|
|
(version "2022.2")
|
|
(source
|
|
(origin
|
|
(method git-fetch)
|
|
(uri
|
|
(git-reference
|
|
(url "https://github.com/latex2html/latex2html")
|
|
(commit (string-append "v" version))))
|
|
(file-name (git-file-name name version))
|
|
(sha256
|
|
(base32 "1z71anjzxy5jsdlaqba4w9spncc6iycldarnr2z1dq8xmk6yhpjn"))))
|
|
(build-system gnu-build-system)
|
|
(arguments
|
|
(list #:phases
|
|
#~(modify-phases %standard-phases
|
|
(add-after 'unpack 'patch-configure
|
|
(lambda* (#:key outputs #:allow-other-keys)
|
|
(substitute* "configure"
|
|
(("/usr/local")
|
|
#$output)
|
|
(("\\$\\{CONFIG_SHELL-/bin/sh\\}")
|
|
(which "bash")))))
|
|
(replace 'configure
|
|
(lambda _
|
|
(invoke "./configure")))
|
|
(add-after 'configure 'patch-cfgcache
|
|
(lambda* (#:key outputs #:allow-other-keys)
|
|
(substitute* "cfgcache.pm"
|
|
(("/usr/local")
|
|
#$output)))))))
|
|
(inputs
|
|
(list perl))
|
|
(synopsis "LaTeX documents to HTML")
|
|
(description "LaTeX2HTML is a utility that converts LaTeX documents to web
|
|
pages in HTML.")
|
|
(home-page "https://www.latex2html.org/")
|
|
(license gpl2+)))
|
|
|
|
(define-public asciidoc
|
|
(package
|
|
(name "asciidoc")
|
|
(version "9.1.0")
|
|
(source (origin
|
|
(method git-fetch)
|
|
(uri (git-reference
|
|
(url "https://github.com/asciidoc/asciidoc-py")
|
|
(commit version)))
|
|
(file-name (git-file-name name version))
|
|
(sha256
|
|
(base32
|
|
"1clf1axkns23wfmh48xfspzsnw04pjh4mq1pshpzvj0cwxhz0yaq"))))
|
|
(build-system gnu-build-system)
|
|
(arguments
|
|
`(#:tests? #f ; no 'check' target
|
|
#:phases
|
|
(modify-phases %standard-phases
|
|
(replace 'bootstrap
|
|
(lambda _
|
|
(invoke "autoconf")))
|
|
;; Some XML-related binaries are required for asciidoc's proper usage.
|
|
;; Without these, asciidoc fails when parsing XML documents, either
|
|
;; reporting a missing "xmllint" binary or, when passed the
|
|
;; "--no-xmllint" option, a missing "xsltproc" binary.
|
|
;; The following phase enables asciidoc to find some of them.
|
|
(add-before 'configure 'set-xml-binary-paths
|
|
(lambda* (#:key inputs #:allow-other-keys)
|
|
(let* ((libxml2 (assoc-ref inputs "libxml2"))
|
|
(xmllint (string-append libxml2 "/bin/xmllint"))
|
|
(libxslt (assoc-ref inputs "libxslt"))
|
|
(xsltproc (string-append libxslt "/bin/xsltproc")))
|
|
(substitute* "a2x.py"
|
|
(("XMLLINT = 'xmllint'")
|
|
(string-append "XMLLINT = '" xmllint "'"))
|
|
(("XSLTPROC = 'xsltproc'")
|
|
(string-append "XSLTPROC = '" xsltproc "'"))))))
|
|
;; Make asciidoc use the local docbook-xsl package instead of fetching
|
|
;; it from the internet at run-time.
|
|
(add-before 'install 'make-local-docbook-xsl
|
|
(lambda* (#:key inputs #:allow-other-keys)
|
|
(substitute* (find-files "docbook-xsl" ".*\\.xsl$")
|
|
(("xsl:import href=\"http://docbook.sourceforge.net/\
|
|
release/xsl/current")
|
|
(string-append
|
|
"xsl:import href=\""
|
|
(string-append (assoc-ref inputs "docbook-xsl")
|
|
"/xml/xsl/docbook-xsl-"
|
|
,(package-version docbook-xsl)))))))
|
|
;; Do the same for docbook-xml.
|
|
(add-before 'install 'make-local-docbook-xml
|
|
(lambda* (#:key inputs #:allow-other-keys)
|
|
(substitute* "docbook45.conf"
|
|
(("http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd")
|
|
(string-append (assoc-ref inputs "docbook-xml")
|
|
"/xml/dtd/docbook/docbookx.dtd"))))))))
|
|
(native-inputs (list autoconf))
|
|
(inputs (list python docbook-xml-4.5 docbook-xsl libxml2 libxslt))
|
|
(home-page "https://asciidoc.org/")
|
|
(synopsis "Text-based document generation system")
|
|
(description
|
|
"AsciiDoc is a text document format for writing notes, documentation,
|
|
articles, books, ebooks, slideshows, web pages, man pages and blogs.
|
|
AsciiDoc files can be translated to many formats including HTML, PDF,
|
|
EPUB, man page.
|
|
|
|
AsciiDoc is highly configurable: both the AsciiDoc source file syntax and
|
|
the backend output markups (which can be almost any type of SGML/XML
|
|
markup) can be customized and extended by the user.")
|
|
(license gpl2+)))
|
|
|
|
(define-deprecated asciidoc-py3 asciidoc)
|
|
|
|
(define-public doxygen
|
|
(package
|
|
(name "doxygen")
|
|
(version "1.9.5")
|
|
(home-page "https://www.doxygen.nl/")
|
|
(source (origin
|
|
(method url-fetch)
|
|
(uri (list (string-append home-page "files/doxygen-"
|
|
version ".src.tar.gz")
|
|
(string-append "mirror://sourceforge/doxygen/rel-"
|
|
version "/doxygen-" version
|
|
".src.tar.gz")))
|
|
(sha256
|
|
(base32
|
|
"1v1f9cp5lyymg7xmw0ldnzi7ql8agbaqam1xdyljk0lrbnrm9d2m"))))
|
|
(build-system cmake-build-system)
|
|
(native-inputs
|
|
(list bison
|
|
flex
|
|
libxml2 ;provides xmllint for the tests
|
|
python)) ;for creating the documentation
|
|
(inputs
|
|
(list bash-minimal))
|
|
(arguments
|
|
;; Force cmake to use iconv header from cross-libc instead of the one
|
|
;; from native libc.
|
|
(list
|
|
#:configure-flags
|
|
(if (%current-target-system)
|
|
#~(list (string-append "-DICONV_INCLUDE_DIR="
|
|
(assoc-ref %build-inputs "cross-libc")
|
|
"/include"))
|
|
#~'())
|
|
#:test-target "tests"
|
|
#:phases
|
|
#~(modify-phases %standard-phases
|
|
(add-after 'unpack 'disable-bibtex-test
|
|
(lambda _
|
|
;; Disable test that requires bibtex to avoid a
|
|
;; circular dependency.
|
|
(for-each delete-file-recursively
|
|
'("testing/012" "testing/012_cite.dox"))))
|
|
(add-before 'configure 'patch-sh
|
|
(lambda* (#:key inputs #:allow-other-keys)
|
|
(let ((/bin/sh (search-input-file inputs "/bin/sh")))
|
|
(substitute* "src/portable.cpp"
|
|
(("/bin/sh")
|
|
/bin/sh)))))
|
|
#$@(if (target-hurd?)
|
|
#~((add-after 'unpack 'apply-patch
|
|
(lambda _
|
|
(let ((patch-file
|
|
#$(local-file
|
|
(search-patch "doxygen-hurd.patch"))))
|
|
(invoke "patch" "--force" "-p1" "-i" patch-file)))))
|
|
#~()))))
|
|
(synopsis "Generate documentation from annotated sources")
|
|
(description "Doxygen is the de facto standard tool for generating
|
|
documentation from annotated C++ sources, but it also supports other popular
|
|
programming languages such as C, Objective-C, C#, PHP, Java, Python,
|
|
IDL (Corba, Microsoft, and UNO/OpenOffice flavors), Fortran, VHDL, Tcl,
|
|
and to some extent D.")
|
|
(license gpl3+)))
|
|
|
|
(define-public doc++
|
|
(package
|
|
(name "doc++")
|
|
(version "3.4.10")
|
|
(source (origin
|
|
(method url-fetch)
|
|
(uri (string-append "https://sourceforge.net/projects/docpp/"
|
|
"files/doc++-" version ".tar.gz"))
|
|
(sha256
|
|
(base32
|
|
"0i37zlxl8g352s4hzpdx0657k5x3czh3xcsfr27irc708gb277pn"))
|
|
(patches (search-patches "doc++-include-directives.patch"
|
|
"doc++-segfault-fix.patch"))))
|
|
(build-system gnu-build-system)
|
|
(native-inputs
|
|
(list flex gettext-minimal))
|
|
(home-page "https://docpp.sourceforge.net")
|
|
(synopsis "Documentation system for C, C++, IDL, and Java")
|
|
(description
|
|
"DOC++ is a documentation system for C, C++, IDL, and Java. It can
|
|
generate both TeX output for high-quality hardcopies or HTML output for online
|
|
browsing. The documentation is extracted directly from the C/C++/IDL source
|
|
or Java class files.")
|
|
(license gpl2+)))
|
|
|
|
(define-public pod2pdf
|
|
(package
|
|
(name "pod2pdf")
|
|
(version "0.42")
|
|
(source (origin
|
|
(method url-fetch)
|
|
(uri (string-append
|
|
"mirror://cpan/authors/id/J/JO/JONALLEN/pod2pdf-"
|
|
version
|
|
".tar.gz"))
|
|
(sha256
|
|
(base32
|
|
"0w5p7yy01vph74nfr9qzjb18p1avmhhcpza0qz9r88fmb0blbiyv"))))
|
|
(build-system perl-build-system)
|
|
(propagated-inputs
|
|
(list perl-getopt-argvfile
|
|
perl-pdf-api2
|
|
perl-pod-parser))
|
|
(home-page "https://metacpan.org/release/pod2pdf")
|
|
(synopsis "Convert Pod to PDF format")
|
|
(description "pod2pdf converts documents written in Perl's @acronym{POD, Plain Old
|
|
Documentation} format to PDF files. It also supports some extensions to the POD
|
|
format, and supports the file types JPG, GIF, TIFF, PNG, and PNM for embedded
|
|
objects.")
|
|
(license artistic2.0)))
|
|
|
|
(define-public python-docrepr
|
|
(package
|
|
(name "python-docrepr")
|
|
(version "0.2.0")
|
|
(source (origin
|
|
(method git-fetch)
|
|
(uri (git-reference
|
|
(url "https://github.com/spyder-ide/docrepr")
|
|
(commit (string-append "v" version))))
|
|
(file-name (git-file-name name version))
|
|
(sha256
|
|
(base32
|
|
"1ma5gwy93m1djd3zdlnqfrwhgr8ic1qbsz5kkrb9f987ax40lfkd"))
|
|
(patches (search-patches "python-docrepr-fix-tests.patch"))))
|
|
(build-system python-build-system)
|
|
(arguments
|
|
(list
|
|
#:phases
|
|
#~(modify-phases %standard-phases
|
|
(add-after 'unpack 'patch-sources
|
|
(lambda _
|
|
;; XXX: This fixes an issue where shutil.copytree would fail
|
|
;; merging directories with same files copied by Sphinx from the
|
|
;; store (hence read-only, throwing a Permission denied error).
|
|
;; In the case this happens, it falls back to a manual copy
|
|
;; routine that omits overwriting same-named files (see:
|
|
;; https://github.com/spyder-ide/docrepr/issues/54).
|
|
(substitute* "docrepr/utils.py"
|
|
(("except TypeError")
|
|
"except (TypeError, shutil.Error)"))))
|
|
(replace 'check
|
|
(lambda* (#:key tests? #:allow-other-keys)
|
|
(when tests?
|
|
(invoke "pytest" "-p" "no:warnings" "-vv")))))))
|
|
(native-inputs
|
|
(list python-ipython
|
|
python-matplotlib
|
|
python-numpy
|
|
python-pytest
|
|
python-pytest-asyncio))
|
|
(propagated-inputs
|
|
(list python-docutils
|
|
python-jinja2
|
|
python-matplotlib
|
|
python-sphinx))
|
|
(home-page "https://github.com/spyder-ide/docrepr/")
|
|
(synopsis "Python docstrings to HTML renderer")
|
|
(description "Docrepr renders Python docstrings to HTML with Sphinx. It
|
|
can generate rich and plain representations of docstrings, alongside
|
|
additional metadata about the object to which the docstring belongs.")
|
|
(license bsd-3)))
|
|
|
|
(define-public scrollkeeper
|
|
(package
|
|
(name "scrollkeeper")
|
|
(version "0.3.14")
|
|
(source
|
|
(origin
|
|
(method url-fetch)
|
|
(uri (string-append "mirror://sourceforge/scrollkeeper/scrollkeeper/"
|
|
version "/scrollkeeper-" version ".tar.gz"))
|
|
(sha256
|
|
(base32 "1bfxwxc1ngh11v36z899sz9qam366r050fhkyb5adv65lb1x62sa"))))
|
|
(build-system gnu-build-system)
|
|
(arguments
|
|
`(#:configure-flags
|
|
(list (string-append "--with-xml-catalog="
|
|
(assoc-ref %build-inputs "docbook-xml")
|
|
"/xml/dtd/docbook/catalog.xml"))))
|
|
(inputs
|
|
(list perl libxml2 libxslt
|
|
;; The configure script checks for either version 4.2 or 4.1.2.
|
|
docbook-xml-4.2))
|
|
(native-inputs
|
|
(list intltool))
|
|
(home-page "https://scrollkeeper.sourceforge.net/")
|
|
(synopsis "Open Documentation Cataloging Project")
|
|
(description
|
|
"ScrollKeeper is a cataloging system for documentation. It manages
|
|
documentation metadata as specified by the Open Source Metadata Framework and
|
|
provides a simple API to allow help browsers to find, sort, and search the
|
|
document catalog. It will also be able to communicate with catalog servers on
|
|
the Net to search for documents which are not on the local system.")
|
|
(license lgpl2.1+)))
|
|
|
|
(define-public zeal
|
|
(let ((commit "1cfa7c637f745be9d98777f06b4f8dec90892bf2")
|
|
(revision "1"))
|
|
(package
|
|
(name "zeal")
|
|
(version (git-version "0.6.1" revision commit))
|
|
(source
|
|
(origin
|
|
(method git-fetch)
|
|
(uri (git-reference
|
|
(url "https://github.com/zealdocs/zeal")
|
|
(commit commit)))
|
|
(file-name (git-file-name name version))
|
|
(sha256
|
|
(base32 "1m7pp3cwc21x03718vhwfd9j2n8md3hv5dp10s234vcsd755s7a3"))))
|
|
(build-system qt-build-system)
|
|
(arguments
|
|
`(#:tests? #f ;no tests
|
|
#:phases
|
|
(modify-phases %standard-phases
|
|
(add-after 'wrap 'wrap-qt-process-path
|
|
(lambda* (#:key inputs outputs #:allow-other-keys)
|
|
(let* ((out (assoc-ref outputs "out"))
|
|
(bin (string-append out "/bin/zeal"))
|
|
(qt-process-path (string-append
|
|
(assoc-ref inputs "qtwebengine-5")
|
|
"/lib/qt5/libexec/QtWebEngineProcess")))
|
|
(wrap-program bin
|
|
`("QTWEBENGINEPROCESS_PATH" = (,qt-process-path)))
|
|
#t))))))
|
|
(native-inputs
|
|
(list extra-cmake-modules pkg-config))
|
|
(inputs
|
|
`(("libarchive" ,libarchive)
|
|
("sqlite" ,sqlite)
|
|
("qtbase" ,qtbase-5)
|
|
("qtdeclarative-5" ,qtdeclarative-5)
|
|
("qtwebchannel-5" ,qtwebchannel-5)
|
|
("qtwebengine-5" ,qtwebengine-5)
|
|
("qtquickcontrols-5" ,qtquickcontrols-5)
|
|
("qtx11extras" ,qtx11extras)
|
|
("xcb-util-keyms" ,xcb-util-keysyms)))
|
|
(home-page "https://zealdocs.org/")
|
|
(synopsis "Offline documentation browser inspired by Dash")
|
|
(description "Zeal is a simple offline documentation browser
|
|
inspired by Dash.")
|
|
(license gpl3+))))
|