docs: learn to build html files for the manual pages

Signed-off-by: Nicolas Sebrecht <nicolas.s-dev@laposte.net>
This commit is contained in:
Nicolas Sebrecht 2017-04-17 20:36:52 +02:00
parent a4c887e5b1
commit 874106d3bd
3 changed files with 23 additions and 0 deletions

View File

@ -16,6 +16,15 @@ html: $(HTML_TARGETS)
$(HTML_TARGETS): %.html : %.rst $(HTML_TARGETS): %.html : %.rst
$(RST2HTML) $? $@ $(RST2HTML) $? $@
manhtml: offlineimap.html offlineimapui.html
offlineimap.html: offlineimap.txt offlineimap.known_issues.txt
a2x -v -d manpage -D manhtml -f xhtml $<
offlineimapui.html: offlineimapui.txt
a2x -v -d manpage -D manhtml -f xhtml $<
man: offlineimap.1 offlineimapui.7 man: offlineimap.1 offlineimapui.7
offlineimap.1: offlineimap.txt offlineimap.known_issues.txt offlineimap.1: offlineimap.txt offlineimap.known_issues.txt
@ -30,12 +39,14 @@ api:
websitedoc: websitedoc:
./website-doc.sh releases ./website-doc.sh releases
./website-doc.sh api ./website-doc.sh api
./website-doc.sh html
./website-doc.sh contrib ./website-doc.sh contrib
clean: clean:
$(RM) -f $(HTML_TARGETS) $(RM) -f $(HTML_TARGETS)
$(RM) -f offlineimap.1 $(RM) -f offlineimap.1
$(RM) -f offlineimap.7 $(RM) -f offlineimap.7
$(RM) -f manhtml/*
$(RM) -rf html/* $(RM) -rf html/*
-find ./docs -name '*.html' -exec rm -f {} \; -find ./docs -name '*.html' -exec rm -f {} \;

0
docs/manhtml/.lock Normal file
View File

View File

@ -126,6 +126,15 @@ function releases () {
rm -f "$ANNOUNCES_YML_TMP" rm -f "$ANNOUNCES_YML_TMP"
} }
function manhtml () {
set -e
cd ./docs
make manhtml
cd ..
cp -av ./docs/manhtml/* "$DOCBASE"
}
exit_code=0 exit_code=0
test "n$ARGS" = 'n' && ARGS='usage' # no option passed test "n$ARGS" = 'n' && ARGS='usage' # no option passed
@ -139,6 +148,9 @@ do
"napi") "napi")
api api
;; ;;
"nhtml")
manhtml
;;
"ncontrib") "ncontrib")
contrib contrib
;; ;;