Home > Archive > Dylan > February 2006 > batteries included
You are viewing an archived Text-only version of the thread.
To view this thread in it's original format and/or if you want to reply to
this thread please [click here]
| Author |
batteries included
|
|
| Matthew D Swank 2006-02-11, 6:57 pm |
| With the addition of Open Dylan as a free implementation, there are a lot
of useful, open-source bindings to various APIs available for Dylan. This
has the potential to make Dylan quite attractive.
Open Dylan has quite a bit of documentation. However, it doesn't seem
very accessible: especially on Linux. Is there a community avenue for
getting this stuff into a more usable form? I notice there is a Wiki on
the Monday site, but it seems locked down.
Matt
--
"You do not really understand something unless you can
explain it to your grandmother." — Albert Einstein.
| |
| Matthew D Swank 2006-02-11, 6:57 pm |
| On Sat, 11 Feb 2006 16:36:36 -0600, Matthew D Swank wrote:
> However, it doesn't seem very accessible: especially on Linux.
I mostly meant since the fun-o site went down, but it would also be nice
to be able to post how-to's and whatnot.
Matt
--
"You do not really understand something unless you can
explain it to your grandmother." — Albert Einstein.
| |
| andreas@andreas.org 2006-02-13, 6:57 pm |
| Matthew D Swank wrote:
> Open Dylan has quite a bit of documentation. However, it doesn't
seem
> very accessible: especially on Linux. Is there a community avenue for
> getting this stuff into a more usable form? I notice there is a Wiki on
> the Monday site, but it seems locked down.
The Open Dylan[0] documentation was done using Framemaker, and then
exported as HTML from there. Then, we have the Gwydion Dylan
documentation[1], which comes as Docbook with some extensions, some
files XML, some SGML. So at the moment, working on the documentation
requires access to our SVN repository (which could be arranged for
anybody who is seriously interested in helping us).
What we need is a common format for all documentation, and a way to
make it editable on the web. Peter Housel started working on a library
description exporter for Open Dylan, which is able to generate a
DITA[2] skeleton, plus a web interface for browsing that documentation
using XSLT transformations.[3][4] I did some prototyping work for a
web interface into Open Dylan, which allows browsing of libraries,
modules, definitions and source code[5]. We're also working on a Wiki
written in Dylan.[6]
In the end, it would be nice to have a web interface that presents
current libraries and definitions, and allows Wiki-style editing of the
documentation entries for the functions. It should be possible to
generate printed documentation too.
Ah, so much to do, so litte time... did I mention we're still looking
for volounteers?
Andreas
[0] http://www.opendylan.org/cgi-bin/viewcvs.cgi/trunk/ref/
[1]
http://www.opendylan.org/cgi-bin/vi...ntation/fundev/
[2] http://www-128.ibm.com/developerworks/library/x-dita1/
[3]
http://www.opendylan.org/cgi-bin/vi...entation/topic/
[4] http://www.opendylan.org/cgi-bin/topic.cgi
[5] http://www.opendylan.org:8001/project?name=code-browser
[6]
http://www.opendylan.org/cgi-bin/vi.../examples/wiki/
|
|
|
|
|