Re: collective.developermanual is now on plone.org

Dylan Jay <dylan-Q+/Sk2sTzaxWk0Htik3J/[email protected]>
Newsgroups gmane.comp.web.zope.plone.documentation
Message-ID <[email protected]>
On 25/01/2010, at 2:01 AM, Mikko Ohtamaa wrote:

>
>
> Dylan Jay-4 wrote:
>>
>> The manual is now uploaded to the knowledgebase area[1]. I'm assuming
>> that the redesign will get rid of the authors attributions as that no
>> longer makes sense right? If not I'll get Mikko to reupload it as  
>> it's
>> mainly his work.
>> All the code for uploading will be in the buildout in
>> collective.developermanual shortly. Next step will be to setup  
>> regular
>> reuploads every night. Of course if anyone wants to contribute to the
>> manual just read [2]
>>
>
> Greatness!
>
> Can someone give me a sharing permission for the doc, so I can see  
> what it
> looks like :)
>
> Great work there with upload, Dylan. I just eyed through the source  
> code. Is
> that true that you didn't have write a line of Python code to make  
> this
> happen? (or did you just update funnel itself...)

yes to both. Funnelweb got some bugs fixes/improvements, two new  
transmogrifier blueprints for importing via xmlrpc and a commandline  
interface. Nothing ended up being sphinx specific except the single  
pipeline.cfg now included in collective.developermanual .  
Transmogrifier is nice.


>
> I can help to provide needed CSS to make the manual look proper.  
> Also, I'll
> edit the text so that it fits better to Plone-like folder / page  
> structure
> (Sphinx gives little more freedom regarding this and it has turned  
> out that
> freedom regarding index pages is not necessary a good thing).

The first paragraph of the index pages is now used as the plone  
description. Everything else is lost.  The direct links to sub  
headings on the sphinx heading pages is lost which is a shame.

e.g. compare
http://plone.org/documentation/kb/collective.developermanual/persistency
http://plonemanual.twinapex.fi/persistency/index.html

Maybe PHC could be updated to do the same?



------------------------------------------------------------------------------
Throughout its 18-year history, RSA Conference consistently attracts the
world's best and brightest in the field, creating opportunities for Conference
attendees to learn about information security's most important issues through
interactions with peers, luminaries and emerging and established companies.
http://p.sf.net/sfu/rsaconf-dev2dev
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.