Read Me
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.