FYI: handbook style trac wiki plugin

View: New views
3 Messages — Rating Filter:   Alert me  

FYI: handbook style trac wiki plugin

by Rick van der Zwet-5 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

I really like the great style of the FreeBSD handbook/article pages,
but having quite some difficulties with the format.
Docbook is not so friendly to setup on an non FreeBSD machine for example :-)

So I hacked around a bit with the trac wiki
(http://trac.edgewall.org/) and created a plugin which mimics the
behavior of the handbook (for a very small bit):

    https://trac-hacks.org/wiki/FreeDocPlugin#example1

Of course not all features are included. If you like the idea and like
something included as well, let me know.

/Rick
--
http://rickvanderzwet.nl
_______________________________________________
freebsd-doc@... mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscribe@..."

Re: FYI: handbook style trac wiki plugin

by Jason Helfman-2 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

On Sun, Nov 01, 2009 at 04:17:38PM +0100, Rick van der Zwet thus spake:
>I really like the great style of the FreeBSD handbook/article pages,
>but having quite some difficulties with the format.

I didn't have any such issues, and hope you success in future with FreeBSD format.

>Docbook is not so friendly to setup on an non FreeBSD machine for example :-)

In following the "Quick Setup," I really had no issues.
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/overview.html

>
>So I hacked around a bit with the trac wiki
>(http://trac.edgewall.org/) and created a plugin which mimics the
>behavior of the handbook (for a very small bit):
>
>    https://trac-hacks.org/wiki/FreeDocPlugin#example1
>
>Of course not all features are included. If you like the idea and like
>something included as well, let me know.

Interesting idea, however this really sidesteps everything about standards,
so I am not certain how much this idea will be embraced.
 
>
>/Rick
>--
>http://rickvanderzwet.nl
>_______________________________________________
>freebsd-doc@... mailing list
>http://lists.freebsd.org/mailman/listinfo/freebsd-doc
>To unsubscribe, send any mail to "freebsd-doc-unsubscribe@..."
>
_______________________________________________
freebsd-doc@... mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscribe@..."

Re: FYI: handbook style trac wiki plugin

by Rick van der Zwet-5 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

2009/11/2 Jason <jhelfman@...>:
> On Sun, Nov 01, 2009 at 04:17:38PM +0100, Rick van der Zwet thus spake:
>> I really like the great style of the FreeBSD handbook/article pages,
....
>> Docbook is not so friendly to setup on an non FreeBSD machine for example
>> :-)
>
> In following the "Quick Setup," I really had no issues.
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/overview.html

Indeed on a BSD system I also got a running in a breeze :-) But try
for example to get it working under mac or linux and you end up in
places where-all-bits-are-black ;-)

/Rick

--
http://rickvanderzwet.nl
_______________________________________________
freebsd-doc@... mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscribe@..."