Webpage Generation from the SVN repository

The  KWARC webpages are generated automatically from the  SVN repository where they reside. The material is transformed from WSML to proper HTML by a script. Whenever one commits to the SVN, the repository automatically runs a makefile that does two things: generate html from the xml, and copy the material from the svn server to the www server.

Example

Assume you want to establish a new www directory called newdir in the projects folder. You have to do the following things:

  • svn up
  • cd projects
  • mkdir newdir; cd newdir
  • write a Makefile in projects/newdir
  • write index.xml in projects/newdir
  • cd ..
  • add newdir to the DIRS list in the Makefile here

Makefile structure

The variables in the Makefiles found in each folder have the following meaning:

  • CPDIRS - list of directories that are just copied statically, without any WSML magic.
  • DIRS - list of directories that are copied, and subject to WSML magic (i.e. page generation from index.xml).
  • SYNCDIRS - list of directories processed to copy the contents onto the web server.

DIRS and SYNCDIRS are usually identical, and only differ conceptually. The difference is that make runs over DIRS and generates the html from the xml files. The SYNCDIRS are processed to copy the contents onto the web server.