jbfavre opened a new issue, #8858:
URL: https://github.com/apache/trafficserver/issues/8858
Hello,
Packaging trafficserver on Debian, I had to disable documentation build a
while ago because of an error with `sphinxcontrib.plantuml`. I recently tried
to fix that to be able to provide manpages within the package.
### Initial build error was:
```
Exception occurred:
File "/usr/lib/python3/dist-packages/docutils/nodes.py", line 2056, in
unknown_departure
raise NotImplementedError(
NotImplementedError: <class 'ManualPageTranslator'> departing unknown node
type: plantuml
```
I'm using Debian version of packages:
* `sphinxcontrib.plantuml` 0.5 (quite outdated)
* `sphinx` 4.5.0
* `plantuml` 1:1.2020.2
### Current attempt to get manpages back into the package:
I Use
* `sphinxcontrib-plantuml` 0.23 (installed with `pip`)
* `sphinx` 4.5.0
* `plantuml` 1:1.2020.2 (also tested with 1.2018.1 from
ci.trafficserver.apache.org)
I got a lot of error and warning, but at least the build ends "successfully".
However, manpages are not generated:
```
$ ls docbuild/man/
apachetrafficserver.1
```
I attached full log output.
Does anyone faces the same issue ?
I'm considering building them locally, adding them as static content into
the package and disable automatic documentation build. But, for this to work, I
still need a solution to get manpages built locally.
[make_man.log](https://github.com/apache/trafficserver/files/8749120/make_man.log)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
