Hi :-)
El jue 19 ene 2012 21:09:26 COT, HansBKK escribió:
This is highly off-topic for most on the list, so feel free to ignore, but
anyone using Leo for single-source documentation generation/conversion,
including future googlers, please reply with comments or notes on your
experiences.
I'm using Leo in that scenario (for writing my Thesis and I hope my
students will use it in a similar fashion), so is not off-topic for me
and not for people who is using Leo primary for documentation.
I have been advocating the idea of pushing Leo-derived content to DokuWiki as a
platform for "wiki-publishing" to enable collaborative/community editing of
content (1<../d/msg/leo-editor/fSzVi1Rh5Tg/uu85satgb9YJ>, 2
<../d/msg/leo-editor/xf6_HBxlV_c/4RgGYdDh8ywJ>). I've also talked about the
markup syntax/doc generation tool Txt2tags (1
<https://groups.google.com/d/msg/leo-editor/nNEnxoohFBM/XkMPQhqhDRsJ>, 2
<https://groups.google.com/d/msg/leo-editor/HBhBnAyVG3E/UXHC1jq50iYJ> ).
When you suggested DocuWiki I thought of MoinMoin which has also
support of plain files as storage mechanism but is also scalable to
databases if this is needed and it supports reStructuredText and is
made in python, a language that "leonizens" are familiar with.
However, I have recently learned of the wiki platform Gitit
<https://github.com/jgm/gitit#readme>, which apparently, like DW, also uses
plain-text files rather than a database back-end, and integrates not only with
git but mercurial (and darcs).
Gitit also incorporates the Pandoc<http://johnmacfarlane.net/pandoc/> project
for its markup syntax, therefore enabling not only markdown but reST as a master
source input format, while DokuWiki has its own (yet another unique) markup
syntax 8-(
With the increasing likelihood that I'll be using Leo as the centerpiece of my
toolchain, plus the fact that Pandoc is much more actively maintained, it's
starting to look worth my while to consider switching my "master source" content
syntax over from Txt2tags to reST. The only downsides are that Gitit is a
Haskell project rather than Python, and one thing I like about Txt2tags is its
support for conversion to AsciiDoc, rather than Pandoc's direct output to
full-blown DocBook XML - but apparently even that's in the works in Pandoc's dev
version.
Anyone in the Leo community using Gitit, especially for use beyond simple code
documentation?
Now that I'm using Leo + Fossil for my documentation related matters
and distributed work I certainly think that a distributed off-line
collaboration system for documentation is needed and, if MoinMoin can't
support the use of distributed wikis (and seems is not planned or in
development [1][2]) Gitit would be a nice place to start with this idea
and would offer advantages over the non-distributed and outdated Zope's
actual implementation, so, interested ones in the community could offer
an implementation of Gitit. On a related matter one of the problems I
see with actual server technology is its gigantism which concentrates
power in the people who has the resources, knowledge and time to
possess, understand and administer/intervene this technology so a
Global South Test for me about which server technology to choose is:
"it runs from a USB thumb drive?". This, for example, favors
Web2py/Smalltalk instead of Zope and Fossil instead of GitHub. May be
you should put this in the panorama when you judge GitIt or
Haskell/Pandoc. Pandoc, by the way, was for me a compelling reason to
learn Haskell[3] (but I thought that I would learn Smalltalk before)
because it deals elegantly with a problem in the diversity of markup
languages (txt2tags makes something similar but only in one way
translation) and for me the point of using Leo is having a tool to deal
consistently with diversity in the "sub-optimal distopic world of
everything is a file".
[1] http://moinmo.in/PawelPacana/MercurialBackend
[2] http://moinmo.in/MoinMoin2.0
[3] http://learnyouahaskell.com/
We could get philosophical here, and think about different programming
paradigms and languages that implement them with elegant syntaxes, like
Smalltalk, Haskell and Python versus the non elegant ones of .java, php
or ... (put your hated language here) and how this elegant syntaxes,
languages and computer using experience could cross-pollinate. If that
is the case, may be reading some about Combined Object Lambda
Architecture[4] and the comprehensive "Concepts, Techniques, and Models
of Computer Programming" by Van Roy and Haridi would be a nice reading.
Some times I dream of a world connected diversity where all the
problems of computer interaction can be solved by expressing that
diversity in fundamental constructs that respect it at the same time
that bring consistency and interface solving the apparent chaos and
noise.
[4] https://en.wikipedia.org/wiki/COLA_%28software_architecture%29
Cheers,
Offray
--
You received this message because you are subscribed to the Google Groups
"leo-editor" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/leo-editor?hl=en.
