search

ros-infrastructure / rosdoc_lite

A light-weight version of rosdoc that does not rely on ROS infrastructure for crawling packages.
10 stars 31 forks source link

Are there way to use custom css for doxygen at docs.ros.org? #58

Open wkentaro opened 8 years ago

wkentaro commented 8 years ago

as discribed at doxygen's manual, https://www.stack.nl/~dimitri/doxygen/manual/customize.html

same thing as

doxygen -w html header.html footer.html customdoxygen.css
jack-oquin commented 8 years ago

I just maintain this package. I didn't write it and don't really know it very well.

I don't know how to do what you are requesting, or whether that would be an appropriate change to the build farm scripts or not.

@dirk-thomas, @wjwwood, @tfoote: is this something we should consider?

wjwwood commented 8 years ago

Presumably the rosdoc.yaml config file could influence how doxygen is run. I don't think anything has to be changed on the farm. Here is something about the doxygen styles:

https://github.com/ros-infrastructure/rosdoc_lite/blob/master/src/rosdoc_lite/doxygenator.py#L244-L251

Not sure that's the right place to hook in or not.

tfoote commented 8 years ago

It might be possible to add however I think for ros.org purposes maintaining a consistent view is important. If someone is using the tool elsewhere it might be useful.

jack-oquin commented 8 years ago

I am willing to make the tool more useful, but prefer to keep its focus on handling the build farm doc jobs.

If people need more complete control elsewhere, they are free to run doxygen directly. I don't think it is feasible for rosdoc_lite to wrap all the features of doxygen or sphinx or epydoc.