[Date Prev][Date Next] [Chronological] [Thread] [Top]

Re: New Admin Guide TOC



<quote who="Howard Chu">
> Gavin Henry wrote:
>> Dear all,
>>
>> Just working on a proposal for a new TOC, which is basically a
>> re-arranged
>> version of the existing one with new sections.
>>
>> If you have had an idea/wish for a section for the guide, please let me
>> know and I'll add it to the proposal.
>>
>> Anyone have an docs lying around unfinished they want to let me know
>> about?
>>
>> Also, could we allow the TOC to have 3 layers, instead of the current 2?
>
> Just set DOC_TOC to 3 in admin.sdf.

OK.

>
>> This would help find things quickly e.g.
>>
>> Replication
>>   Replication Strategies
>>       Syncrepl
>>       Delta Syncrepl
>>   Recommended Solutions
>>
>> Backends
>>   back-monitor
>>       Overview
>>       Configuration
>>   back-hdb
>>
>> etc.
>>
>> Lastly, is it easy to do an index linking back to over sections? Is that
>> just like "back-monitor: {{SECT Backends}}"
>
> The current version of sdf doesn't have automatic index building for
> anything besides Framemaker. You'd have to write a few new perl
> subroutines to get that working. If you want the index to cover anything
> more than the section headers (which are already accumulated in the
> table of contents) then you'd need to define a new {{INDEX}} specifier
> and use it liberally in the documents.

OK. Shame this isn't maintained anymore, that could be a good patch.

Gavin.

>>
>> Thanks.
>>
>
>
> --
>    -- Howard Chu
>    Chief Architect, Symas Corp.  http://www.symas.com
>    Director, Highland Sun        http://highlandsun.com/hyc
>    OpenLDAP Core Team            http://www.openldap.org/project/
>


-- 
Kind Regards,

Gavin Henry.
Managing Director.

T +44 (0) 1224 279484
M +44 (0) 7930 323266
F +44 (0) 1224 824887
E ghenry@suretecsystems.com

Open Source. Open Solutions(tm).

http://www.suretecsystems.com/