Hi everybody,

I have updated the VIFF homepage and switched from having just one
XHTML file to a system where pages are written in reStructuredText
format and then rendered to XHTML.

The first new page is just a simple page with links to the VIFF
documentation, including the design talk slides which were never
online before.

The pages can be checked out via

  hg clone http://hg.viff.dk/viff.dk

(it looks weird, I know... but like this the default target directory
is viff.dk which is nice, I think. We can easily change the URL,
though, if anybody thinks this is important.)

That gives you a bunch of .txt files which follow an easy format
described here:

  http://docutils.sourceforge.net/docs/user/rst/quickstart.html

This is the standard format used in Python for documentation that is
both easy to read and write in plain-text, but which can be turned
into HTML (and LaTeX, and probably other formats as well).


Hacking on the website is now very easy (and I'm sure you can find
some bad English you will want to correct):

  hg clone http://hg.viff.dk/viff.dk
  cd viff.dk
  ./update_news.py
  ./buildhtml.py

You only need to run update_news.py if you want to regenerate the
news-blob on the front page in your local version. It is done
automatically every two hours on viff.dk.

Now change something, add new files, and run buildhtml.py to generate
the .html files. When you are satisfied with the results, you simply
'hg commit' it and tell me to pull from your repository. We can also
setup a shared repository on viff.dk if people prefer that and I
become a bottleneck in the process.


I went with this system since it is *simple* in terms of
infrastructure -- I really like the idea of having a website that does
not depend on a huge backend system (database or webserver). With this
setup you can preview the website directly from the filesystem and
easily work on it from several locations.

Docutils (the project making reStructuredText) is not the most
flexible system out there, but again I hope that the simplicity will
be a good thing.

Let me know what you think!

Oh, one last thing:c to build the website you will need Feedparser,
Genshi, and Docutils:

  * http://feedparser.googlecode.com/files/feedparser-4.1.zip
  * http://ftp.edgewall.com/pub/genshi/Genshi-0.4.4.tar.bz2
  * http://docutils.sourceforge.net/docutils-snapshot.tgz

or for people on DAIMI: just put /home/mg/opt/lib/python in your
PYTHONPATH. That should do the trick.

-- 
Martin Geisler
_______________________________________________
viff-devel mailing list (http://viff.dk/)
viff-devel@viff.dk
http://lists.viff.dk/listinfo.cgi/viff-devel-viff.dk

Reply via email to