THIS GIT REPOSITORY IS OBSOLETE. IT IS NO LONGER BEING USED
TO MAINTAIN MAXIMA'S WEBSITE. THE wEB PAGES ARE NOW IN THE
"WEBPAGES" REPOSITORY (Jaime Villate, September 30, 2014)
===============================================================
Here is a brief explanation of how it works.
You should have write access to /home/project-web/maxima/ at
web.sourceforge.net and to the Maxima GIT repository
(i.e. you should be a developer of Maxima project at the SF).
See https://sourceforge.net/scm/?type=git&group_id=4933
DO NOT edit the .html files in /home/project-web/maxima/htdocs since
they are generated automatically. The sources are stored in the GIT
module 'site-xml'.
The template is main.xsl; all .xml files should be transformed
using .xsl. Please, ensure that your changes are valid XHTML 1.0
Strict or at least well-formed XML (you can check it by the special
tools like xmllint or xsltproc or by opening XML files in a web
browser with built-in XSLT processor, e.g. Firefox).
For transformations I recommend xsltproc
(http://www.xmlsoft.org/XSLT/xsltproc2.html)
An example session (suppose the user ID is bob):
Either do a fresh clone:
~/foo$ git clone ssh://bob@git.code.sf.net/p/maxima/site-xml
Or update your existing repository:
~/foo$ cd site-xml
~/foo$ git pull
Then:
~/foo$ git checkout -b fixit ; cd es
~/foo/site-xml/es$ emacs documentation.xml
~/foo/site-xml/es$ git commit -m 'message' documentation.xml
~/foo/site-xml/es$ xsltproc documentation.xml ../main.xsl > documentation.html
~/foo/site-xml/es$ scp documentation.html bob,maxima@web.sourceforge.net:/home/project-web/maxima/htdocs/es
~/foo/site-xml/es$ rm documentation.html
Contact Alexey Beshenov <al@cadadr.org> if there are some problems.