Hi everyone,

For the Kivy project, i've made a custom theme sphinx with 2 features:

1. Unobstructive javascript that add links for collapse class documentation 
and member documentation.
Take a look at http://kivy.org/docs/api-kivy.uix.anchorlayout.html : If you 
click on Show/Hide description will give you a better idea of all existing 
member.
One click to the member will automatically toggle it. The Expand/Collapse 
all is the same, but for classes.
The choice you made is saved in a Cookie, and used for all the pages within 
the documentation.

2. Make Cython class look like Python class
Without changes, the cython class was giving "too" much information, like 
including "<classname> self" as the first argument of all the class method. 
Since Python is not doing that, some regex are applied to remove theses 
part. Also, autodoc was document all the methods/properties as func (i 
don't remember the bug exactly, but it wasn't showed as it is)

What's your though about that ?
I would want to release that theme in a generic format. But i don't know 
where to start. The better cython documentation is implemented as an 
extension (
https://github.com/tito/kivy/blob/master/doc/sources/sphinxext/preprocess.py), 
while all the rest is custom html/css/javascript.
Any tips about how to release ? And where i can publish it ?

Thanks,

Mathieu

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To view this discussion on the web visit 
https://groups.google.com/d/msg/sphinx-dev/-/Ax4G0gHyvJUJ.
To post to this group, send email to sphinx-dev@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to