tris/recoll
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc: no conversion for rst for now

Browse Source
This commit is contained in:
Jean-Francois Dockes 2019-04-13 12:38:17 +02:00
parent 7c7b3ce509
commit f19e2f82e8
2 changed files with 19 additions and 6237 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6227
docs/index.rst
View File

File diff suppressed because it is too large Load Diff

29
src/doc/user/Makefile
View File

@ -54,18 +54,27 @@ recoll-conf-xml:
--idprefix=RCL.INSTALL.CONFIG.RECOLLCONF \
../../sampleconf/recoll.conf > recoll.conf.xml
usermanual-rst: recoll-conf-xml
tail -n +2 recoll.conf.xml > rcl-conf-tail.xml
sed -e '/xi:include/r rcl-conf-tail.xml' \
< usermanual.xml > full-man.xml
sed -i -e '/xi:include/d' -e '/<?xml version="1.0"?>/d' full-man.xml
pandoc -s -f docbook -t rst full-man.xml > \
../../../docs/index.rst
rm -f rcl-conf-tail.xml full-man.xml
# Generating a restructured text version, for uploading to readthedocs.
# Does not really work, the internal links are botched. pandoc
# generates something like:
# `configuration <#RCL.INDEXING.CONFIG>`__
# when it should be:
# :ref:`RCL.INDEXING.CONFIG`
# Also with the second form, the link text is the section heading (can't be
# chosen), which is not nice. Else, the change could probably be done by a
# script.
# Also could not get readthedocs to generate the left pane TOC? could
# probably be fixed...
#usermanual-rst: recoll-conf-xml
# tail -n +2 recoll.conf.xml > rcl-conf-tail.xml
# sed -e '/xi:include/r rcl-conf-tail.xml' \
# < usermanual.xml > full-man.xml
# sed -i -e '/xi:include/d' -e '/<?xml version="1.0"?>/d' full-man.xml
# pandoc -s -f docbook -t rst full-man.xml > \
# ../../../docs/index.rst
# rm -f rcl-conf-tail.xml full-man.xml
# not needed with pandoc 2.x -@echo fix termmatch and execute
#(cd sphinx;make html)
clean:
rm -f RCL.*.html usermanual.pdf usermanual.html index.html \
tmpfile.html rcl-conf-tail.xml full-man.xml