Hi, 2014-10-31 0:03 GMT+09:00 <[email protected]>: > Take as as example the sidebar. I have in mind a different design, very > similar to the Google one in the screenshot I've provided. I'd also like to > greatly rearrange the index pages, and add some disclosure sections to > content pages (Apple do this on their document pages - for example, clicking > on characterAtIndex has revealed more detailed info about this method). Oh > yeah, I'd also like to add some options to the code blocks. > > For someone whose never attempted any form of customization this is quite a > wish-list. Can anyone advise on whether these sorts of things are > possible/practical with Sphinx extensions, or whether I'd be better off > taking a different approach.
I think some part is possible and some part is impossible without sphinx modification. For example, you can add some options to the code-block directive if you create new code-block directive implementation and override the code-block directive registration. However it is not good because such overriding will introduce some confusion. Then I think you should create another directive like 'code-block-ex' for local using purpose OR please make a proposal ticket for code-block's new options. If you can implement it, please make a pull request for that! There are documentation for creating a extension and for creating a pull request. * Developing extensions for Sphinx: http://sphinx-doc.org/extdev/index.html * Sphinx Developer’s Guide: http://sphinx-doc.org/devguide.html I think HTML output customization is easier than creating a sphinx-extension. There are documentations for templating/theming. * http://sphinx-doc.org/theming.html * http://sphinx-doc.org/templating.html If you can't achieve the HTML customization purpose by less information or less sphinx implementation, we may be able to provide more informations or features for that. I think the archive of this ML, IRC and issue tracker have many answers for feature-questions and howto. Please check it too. * https://groups.google.com/forum/#!forum/sphinx-users * https://botbot.me/freenode/sphinx-doc/ * https://bitbucket.org/birkenfeld/sphinx/issues Thanks, -- Takayuki SHIMIZUKAWA http://about.me/shimizukawa -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
