search

esdoc / esdoc-plugins

MIT License
140 stars 77 forks source link

Structural and style inconsistencies #71

Closed mwri closed 4 years ago

mwri commented 5 years ago

I set out to create a custom style sheet, because, though esdoc does make quite beautiful docs (jolly well done everyone) I do find it a bit difficult to pick stuff out of the mass of black and grey similarly indented similar spaced blurb...

I've run into difficulties though, I did create a style sheet I felt improved things a lot, but it's kinda nasty, it matches based on things I really feel it shouldn't, and on stuff I feel might reasonably change, and I couldn't do everything I wanted...

The thing is, the content produced doesn't really have (for example) an element with a class of (say) "class", in which a class is rendered with more child elements with classes of (say) "method" and "parameter", etc. So the capability to (say) select all headers in a class render and make them some colour, or all 'details' sections in a variable render and indent them a certain amount... is just a nightmare.

Changing this and making it more consistent and easy to style isn't necessarily very difficult, but to do so properly and retain backwards compatibility seems impossible to me.. so I thought I'd raise the issue and see what prevailing opinions were...

mwri commented 4 years ago

Closing due to no interest from maintainers.