[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Axiom-developer] literate programming in html
From: |
Martin Baker |
Subject: |
Re: [Axiom-developer] literate programming in html |
Date: |
Fri, 20 Jan 2012 15:43:26 +0000 |
User-agent: |
KMail/1.13.6 (Linux/2.6.37.6-0.11-desktop; KDE/4.6.0; x86_64; ; ) |
On Friday 20 Jan 2012 11:59:52 Ralf Hemmecke wrote:
> It all depends on your tools. If there were a tool that puts every code
> chunk into a separate file but while editing shows you the chunks in the
> order you want, you wouldn't care how your content is physically stored.
Its just that the method Tim describes for embedding code into html here:
http://axiom-developer.org/axiom-website/litprog.html
has some complications and requires specialised tools.
In some ways I find the current LP and hyperdoc stuff in Axiom flavors
actually makes it harder for me to produce the quality of documentation that I
would like, although moving to an html version like this would help, I still
think custom tools like this are a major problem.
I think it would be much better to use standard tools. I'm not sure that file
structure is the most important issue? This seems like a technical issue to
me. In the end the important issues to me are:
* Can I use standard tools that I already know to edit code, html and diagrams
in WYSIWYG mode.
* Does it require maintainence of specialised tools?
* Does it inhibit development of IDE capablitied like code completion and
debugging tools?
* Does it make documentation harder to produce rather than easier?
* Is there duplication between LP, Hyperdoc, )show, etc.
I think there is a lot to be said for keeping the documentation (LP and
hyperdoc) on a server somwhere and only downloading code to users client.
Martin