[Moin-user] Long documents

[David Cramer]

By putting the heading in the including page as Richard suggests (and as 
is done in the example page that Nir's provides), you avoid this bug:
http://moinmoin.wikiwikiweb.de/MoinMoinBugs/TableOfContentsBrokenForIncludedPages 
I've had to refrain from upgrading one of our moinmoin wikis beyond 
1.2.3 because of that one because the group that uses that wiki has made 
extensive use of this included pages but without putting headings in the 
including page :-(

Other things to keep in mind are that you may need to educate your users 
that subscribing to a page that is made up of included pages does not 
subscribe them to changes in the included pages. Also take care that the 
heading levels of the included pages match the level you need them to be 
in the including page. There's more discussion here:
http://moinmoin.wikiwikiweb.de/FeatureRequests/SectionEditing

David

Hiers, Richard wrote:

>I have a long document (disaster recovery instructions) that I have
>broken up and manage using Includes.  Here is a bit of the code found on
>the DisasterRecovery "master document":
>
>**************************
>= Power Outage =
>----
>''[:DisasterRecovery/PowerOutage:Edit this section]''
>[[Include(DisasterRecovery/PowerOutage, , to="^----$")]]
>
>**************************
>
>The "edit this section" link take you to the page for that section,
>which you can then easily edit.
>
>Richard
>
>-----Original Message-----
>From: moin-user-admin at lists.sourceforge.net
>[mailto:moin-user-admin at lists.sourceforge.net] On Behalf Of Nir Soffer
>Sent: Tuesday, April 18, 2006 5:25 AM
>To: Mehdi Hassanpour
>Cc: moin-user at lists.sourceforge.net
>Subject: Re: [Moin-user] Long documents
>
>
>On 18/04/2006, at 12:58, Mehdi Hassanpour wrote:
>
>  
>
>> I have some long documents and wanted to know can MoinMoin treat like
>>    
>>
>
>  
>
>>media wiki to have edits for paragraphs on page ?
>> It's a bit hard opening the whole long doc to edit some thing in the 
>>middle...
>>    
>>
>
>There is no section editing like in media wiki. You can make it easier
>to edit long documents by braking them to many sub pages and compile the
>full page with [[Include(subpage)]].
>
>See http://moinmoin.wikiwikiweb.de/MoinMoinQuestions for example.
>
>Best Regards,
>
>Nir Soffer
>
>
>
>-------------------------------------------------------
>This SF.Net email is sponsored by xPML, a groundbreaking scripting
>language that extends applications into web and mobile media. Attend the
>live webcast and join the prime developer group breaking into this new
>coding territory!
>http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
>_______________________________________________
>Moin-user mailing list
>Moin-user at lists.sourceforge.net
>https://lists.sourceforge.net/lists/listinfo/moin-user
>
>
>-------------------------------------------------------
>This SF.Net email is sponsored by xPML, a groundbreaking scripting language
>that extends applications into web and mobile media. Attend the live webcast
>and join the prime developer group breaking into this new coding territory!
>http://sel.as-us.falkag.net/sel?cmd=k&kid0944&bid$1720&dat1642
>_______________________________________________
>Moin-user mailing list
>Moin-user at lists.sourceforge.net
>https://lists.sourceforge.net/lists/listinfo/moin-user
>  
>