From f9b6afa80a8d153c7cde8ed28c9d4797cff1c330 Mon Sep 17 00:00:00 2001 From: Bastian Venthur Date: Thu, 9 Jun 2022 21:13:41 +0200 Subject: [PATCH] made docs working --- debian/blag-doc.docs | 1 + debian/control | 36 +++++++++++++++++++----------------- debian/package.doc-base.ex | 20 -------------------- debian/rules | 12 ++++++------ 4 files changed, 26 insertions(+), 43 deletions(-) create mode 100644 debian/blag-doc.docs delete mode 100644 debian/package.doc-base.ex diff --git a/debian/blag-doc.docs b/debian/blag-doc.docs new file mode 100644 index 0000000..344fcaa --- /dev/null +++ b/debian/blag-doc.docs @@ -0,0 +1 @@ +build/html/ diff --git a/debian/control b/debian/control index 91ef338..390a92a 100644 --- a/debian/control +++ b/debian/control @@ -5,6 +5,7 @@ Maintainer: Bastian Venthur Rules-Requires-Root: no Build-Depends: debhelper-compat (= 13), + dh-sequence-sphinxdoc, dh-sequence-python3, dh-python, python3-setuptools, @@ -15,6 +16,7 @@ Build-Depends: python3-pygments, python3-pytest, python3-pytest-cov, + python3-sphinx, #Testsuite: autopkgtest-pkg-python Standards-Version: 4.6.0.1 Homepage: https://github.com/venthur/blag @@ -38,20 +40,20 @@ Description: Blog-aware, static site generator * Integrated devserver * Available on PyPI -#Package: blag-doc -#Section: doc -#Architecture: all -#Depends: -# ${sphinxdoc:Depends}, -# ${misc:Depends}, -#Description: Blog-aware, static site generator (documentation) -# Blag is a blog-aware, static site generator, written in Python. It supports -# the following features: -# * Write content in Markdown -# * Theming support using Jinja2 templates -# * Generation of Atom feeds for blog content -# * Fenced code blocks and syntax highlighting using Pygments -# * Integrated devserver -# * Available on PyPI -# . -# This is the common documentation package. +Package: blag-doc +Section: doc +Architecture: all +Depends: + ${sphinxdoc:Depends}, + ${misc:Depends}, +Description: Blog-aware, static site generator (documentation) + Blag is a blog-aware, static site generator, written in Python. It supports + the following features: + * Write content in Markdown + * Theming support using Jinja2 templates + * Generation of Atom feeds for blog content + * Fenced code blocks and syntax highlighting using Pygments + * Integrated devserver + * Available on PyPI + . + This is the common documentation package. diff --git a/debian/package.doc-base.ex b/debian/package.doc-base.ex deleted file mode 100644 index 522a242..0000000 --- a/debian/package.doc-base.ex +++ /dev/null @@ -1,20 +0,0 @@ -Document: blag -Title: Debian blag Manual -Author: -Abstract: This manual describes what blag is - and how it can be used to - manage online manuals on Debian systems. -Section: unknown - -Format: debiandoc-sgml -Files: /usr/share/doc/blag/blag.sgml.gz - -Format: postscript -Files: /usr/share/doc/blag/blag.ps.gz - -Format: text -Files: /usr/share/doc/blag/blag.text.gz - -Format: HTML -Index: /usr/share/doc/blag/html/index.html -Files: /usr/share/doc/blag/html/*.html diff --git a/debian/rules b/debian/rules index ffb6044..6596836 100755 --- a/debian/rules +++ b/debian/rules @@ -9,17 +9,17 @@ export PYBUILD_TEST_ARGS=--no-cov export PYBUILD_NAME=blag %: - dh $@ --with python3 --buildsystem=pybuild + dh $@ --with python3,sphinxdoc --buildsystem=pybuild # If you need to rebuild the Sphinx documentation: # Add sphinxdoc to the dh --with line. # # And uncomment the following lines. -#execute_after_dh_auto_build-indep: export http_proxy=127.0.0.1:9 -#execute_after_dh_auto_build-indep: export https_proxy=127.0.0.1:9 -#execute_after_dh_auto_build-indep: -# PYTHONPATH=. python3 -m sphinx -N -bhtml \ -# docs/ build/html # HTML generator +execute_after_dh_auto_build-indep: export http_proxy=127.0.0.1:9 +execute_after_dh_auto_build-indep: export https_proxy=127.0.0.1:9 +execute_after_dh_auto_build-indep: + PYTHONPATH=. python3 -m sphinx -N -bhtml \ + docs/ build/html # HTML generator # PYTHONPATH=. python3 -m sphinx -N -bman \ # docs/ build/man # Manpage generator