For documentation I prefer to use LyX and then produce a
PDF and put that into the repository. Then you just have a link from
a wiki page of the form: [http:doc/tip/documentation/my_user_man.pdf |
User Manual] . The user then has a PDF (with active links in the
table of contents and index) of the documentation. The advantage of
this is that the user can at his option download the whole thing and
print it very easily. Also the formatting if critical can absolutely
controlled and doesn't depend on browser issues.
This is my preference in documentation as I try to keep all my docs
in this form (I actually find iTunes is really great for storing
PDFs.) I agree with Richard that the Wiki is great for notes and
shorter things but for longer forms and where I want active links in
the TOC and index I would rather some other program did that for me.
--jim
On May 15, 2010, at 9:48 AM, Richard Hipp wrote:
> On Sat, May 15, 2010 at 8:23 AM, Gour <[email protected]> wrote:
> On Sat, 15 May 2010 07:11:35 -0400
> >>>>>> "Richard" == Richard Hipp wrote:
>
> Dear Richard,
>
> Richard> HTML is not "complete" enough? What do you want to do (or
> for
> Richard> that matter what does any other wiki system do) that you
> can't
> Richard> do (in a more "standard" way, I should add) with HTML?
>
> it is not point that HTML is not "complete", but it is simply too
> cumbersome to write documentation in HTML.
>
> So it really comes down to a matter of personal preference. You say
> HTML is cumbersome. I say that Markdown, etc. are arbitrary and
> cumbersome. Different people have different ideas. And yet, by
> virtue of supporting HTML, the wiki in Fossil is both standard and
> complete, for reasonable meanings of those words. What you really
> mean to say is that the fossil wiki does not suit your tastes in
> wiki and you would prefer something different. It's an emacs versus
> vi thing.
>
> btw, what do you think about:
>
> http://www.fossil-scm.org/index.html/tktview?name=3e3018e96f ?
>
> Ticket change histories can be seen by following the links in the
> submenu bar at the top of the ticket display. Example:
>
> http://www.fossil-scm.org/index.html/tkthistory/49929a3557
> http://www.fossil-scm.org/index.html/tkttimeline?name=49929a3557
>
>
> --
> ---------------------
> D. Richard Hipp
> [email protected]
> _______________________________________________
> fossil-users mailing list
> [email protected]
> http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users
_______________________________________________
fossil-users mailing list
[email protected]
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users
