On Sep 11, 2008, at 7:03 PM, osimons wrote: > > > > On Sep 12, 1:47 am, "Noah Kantrowitz" <[EMAIL PROTECTED]> wrote: >> Yep, that’s why it isn't a blocker. I just want to get the docs >> rewritten too. >> >> --Noah >> >>> -----Original Message----- >>> From: [email protected] [mailto:[EMAIL PROTECTED] >>> On >>> Behalf Of Remy Blank >>> Sent: Thursday, September 11, 2008 4:47 PM >>> To: [email protected] >>> Subject: [Trac-dev] Re: State of the newhelp branch? >> >>> Noah Kantrowitz wrote: >>>> At some point I need to make a help provider that groks sphinx >>>> pickle >>>> output. Not reeeeally a blocker, but important. >> >>> Does this mean that the branch will not be merged before the >>> documentation has been converted to Sphinx? I thought that a first >>> step >>> could have been to use the existing wiki pages (slightly adapted), >>> and >>> just to have them managed by the help module. This would already >>> be a >>> big step forward. >> >>> -- Remy > > What is done and what remains is pretty much covered by > http://trac.edgewall.org/wiki/TracDev/Proposals/NewHelp - at least as > my original idea goes. > > There has been various earlier discussions about the branch and state > of the docs (search the trac-dev archives), and I've just been waiting > for Noah (or others) to apply their ideas for integrating Sphinx in > the branch before progressing. Not quite knowing how the docs will > change, I figured it would be best just to leave them as-is for now to > make it easier to integrate latest docs changes to default wiki pages > before progressing. > > I'm ready to move forward with the branch, but some outstanding issues > like seach will also depend on how the docs are to be stored and > retrieved for display - and no doubt it will also mean adjustments to > some of the current assumptions. > > Noah, if you have time to outline what Sphinx will imply and your > proposed changes, that would be most welcome.
No actual changes really, just an additional IHelpProvider that can read the pickled HTML blobs produced by sphinx-build. The only things I would like to see added in general is some kind of index system, and a category ID in addition to the page ID. --Noah --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Trac Development" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/trac-dev?hl=en -~----------~----~----~----~------~----~------~--~---
