Structural and style inconsistencies
Closed this issue · 1 comments
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...
Closing due to no interest from maintainers.