made docs working

This commit is contained in:
Bastian Venthur
2022-06-09 21:13:41 +02:00
parent c469b9b591
commit f9b6afa80a
4 changed files with 26 additions and 43 deletions

1
debian/blag-doc.docs vendored Normal file
View File

@@ -0,0 +1 @@
build/html/

36
debian/control vendored
View File

@@ -5,6 +5,7 @@ Maintainer: Bastian Venthur <venthur@debian.org>
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.

View File

@@ -1,20 +0,0 @@
Document: blag
Title: Debian blag Manual
Author: <insert document author here>
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

12
debian/rules vendored
View File

@@ -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