tango-controls / tango-doc

The official documentation for Tango controls
http://tango-controls.readthedocs.io
8 stars 27 forks source link

Problems building pdf with nested tables #113

Closed andygotz closed 7 years ago

andygotz commented 7 years ago

The Hdb++ documentation has nested tables in the device interface documentation. When trying to build the pdf version on my laptop using the command "make latexpdf" I get this error:

Markup is unsupported in LaTeX: administration/services/hdbpp/hdbpp-es_doc/FullDocument-hdbpp-es:: nested tables are not yet implemented. Makefile:114: recipe for target 'latexpdf' failed make: *** [latexpdf] Error 1

I see the nested tables are rendered on the html version but how to get them rendered in pdf? The pdf version on readthedocs does not seem to have them either.

piogor commented 7 years ago

Yes, the RtD builder is reporting the same issue: http://readthedocs.org/projects/tango-controls/builds/5830248/

andygotz commented 7 years ago

I wonder if we need these tables in the documentation? Maybe we can remove them for now.

piogor commented 7 years ago

I have already started splitting, but I may remove them instead.

andygotz commented 7 years ago

I would remove this file for now. It is very detailed and should be part of the auto generated doxygen documentation.

piogor commented 7 years ago

There is also https://github.com/tango-controls/tango-doc/blob/master/source/administration/services/hdbpp/hdbpp-cm_doc/FullDocument-hdbpp-cm.rst file which is generated documentation. There, the tables are un-nested. Shell I remove it, too?

andygotz commented 7 years ago

Yes

piogor commented 7 years ago

The documentation is now built correctly. I am closing the bug and creating new task - to add external links to device servers documentation.