On 5/23/08, Satish Balay <balay at mcs.anl.gov> wrote:
> I guess the problem is - each of us use different editors.

>
>  I guess we have to converge to a single editor to avoid this
>  issue. Also I believe we have to redesign PETSc web page to make it
>  more attractive :) [with Beth - MCS/web developer's help]

Have you ever considered the option of moving from maintaining static
html files, to something more advances, like a 'dynamic' webserver
(ala, Zope, Plone, Wiki, or something like that?)

Other way would be to move to something like reStructuredText, perhaps
also using (and adapting is needed) the infraestruture (a tool called
Sphinx) that supports the documentation system for Python 2.6 and 3.0.
This way, actual sources are plain, easy to edit and follow text files
with wiki-like markup, and the output are still plain html files you
can put in some dir and served with Apache.

If you ever want to take a look at the later option, Brian Granger
(IPython developer) started a few days ago the process of converting
some docs for mpi4py yo the reStructuredText+Sphinx . So I have a
working example of sources that are be converted to html.


-- 
Lisandro Dalc?n
---------------
Centro Internacional de M?todos Computacionales en Ingenier?a (CIMEC)
Instituto de Desarrollo Tecnol?gico para la Industria Qu?mica (INTEC)
Consejo Nacional de Investigaciones Cient?ficas y T?cnicas (CONICET)
PTLC - G?emes 3450, (3000) Santa Fe, Argentina
Tel/Fax: +54-(0)342-451.1594


Reply via email to