Re: Collective developer manual now ready to be plone.orgified
Dylan Jay <dylan-Q+/Sk2sTzaxWk0Htik3J/[email protected]>
| Newsgroups | gmane.comp.web.zope.plone.documentation |
|---|---|
| Message-ID | <[email protected]> |
On 21/04/2010, at 11:25 AM, Alex Clark wrote: > On 2010-04-19, Mikko Ohtamaa <mikko+plone-75aZqqp77KCaMPzRcYMCawC/[email protected]> wrote: >> Hi, >> >> Now the work to upload Sphinx based documentation, namely >> collletive.developermanual, is in a stage it is useful. > > Congrats! Nice work. > >> I created a demo site here were I uploaded >> collective.developermanual to >> vanilla Plone site with Plone Help Center only installed: >> >> http://collective-docs.mfabrik.com/ >> >> The process itself is described here: >> >> http://collective-docs.mfabrik.com/documentation/introduction/developermanual.html >> >> If someone puts me in docteam or grants edit access to >> collective-developermanual reference manual at plone.org I can push >> the >> manual in. > > So basically the process is to run some transmogrifier "rules" (or > whatever > they are called I've never used it) on the sphinx docs and that just > does pretty much. The code is from pretaweb.funnelweb, a generic website importer for plone, which has now been split into many packages 6 packages http://pypi.python.org/pypi?:action=search&term=funnelweb > phc.referencemanual.obj.setText(sphinx_generated_html) (or whatever > the accessor is) ? Not quite as clean as that but basically yes. http://github.com/djay/transmogrify.ploneremote/blob/master/transmogrify/ploneremote/remoteschemaupdater.py It's unfortunate that the xmlrpc doesn't consistently work for plone api's and you have to revert to using urllib. Mikko did some great work to add remote workflow updating (which will be merged in soon) which also had to revert to using urllib instead of xmlrpc. http://github.com/miohtama/transmogrify.ploneremote/blob/master/transmogrify/ploneremote/remoteworkflowupdater.py > > This is my favorite: > > http://collective-docs.mfabrik.com/documentation/referencemanual-all-pages > > :-) > > > > >> >> Cheers, >> Mikko >> >> ----- >> Mikko Ohtamaa >> mFabrik - Freedom Delivered. >> >> Web site - http://mfabrik.com >> Mobile site - http://mfabrik.mobi >> Blog - http://blog.mfabrik.com > > > -- > Alex Clark · http://aclark.net > Author of Plone 3.3 Site Administration · http://aclark.net/plone-site-admin > > > ------------------------------------------------------------------------------ > _______________________________________________ > Plone-docs mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/plone-docs ------------------------------------------------------------------------------