Hi world, as the way our website is organized isn't the pure standard most people know, I decided to write a little summary about it, how it should work and what you need to do to modify parts of it and how to keep it good and working and nice and whatever. The whole thing is in svn on alioth, in the debconf6-data svn. If you dont have access it is possible to give it to you, but if you want to just look at it you can do so at http://svn.debian.org/wsvn/debconf6-data - or check it out with svn if you want to work on it. Ok, lets suppose you have it on your harddisc, change to the website/ folder of it. There are multiple folders here, you can basically ignore them except www/, www-es/ and media/. media/ contains anything thats hidden behind media.debconf.org. Put every media file there, in the right subdirectory, which means dc6/ for this debconf. That way images or public documents can be easily shared between the english and the spanish website, having a central source. www/ contains the english site, www-es/ the spanish one. The layout within those should be the same, just not the language, so the following applies to both of them. We are using a perl thingie for this website (http://perl.apache.org/embperl/ if you want), which makes some nice things available, including *easy* writing of new pages due to automated inclusion of all neccessary files, etc. pp. Simple said this site works if you only write the body part of your site. Never ever write a header or footer or even menu in your site. Those are automatically included from the appropriate files in the same directory, or in absence of them in the same subdirectory below www/ they are taken from the next directory above your location. Ie if you are in www/about/ you wont find the footer.html - it is taken From the www/footer.html file then. But you find www/about/menubar.html which replaces the menubar.html from one dir above for the about/ and all of its subdirectories - except they have their own file for this. Now, if you go and write a page, or change an existing one, a basic hint for you is: Always write pur standard XHML1.0 Strict but never include headers or footers or menubars. You start with the first <h1> and end with the last content in your text. (Taking www.debconf.org you start with "<h1>What is Debconf?</h1>" and end it with "Participation to this event is free of charge.", the whole rest is added automagically for you. Our big website master, Neil, and myself are trying to keep the page valid XHTML1 strict. So if you are going to change something in the site - please be sure to keep it validating. You can check that easily after your svn commit: Wait the time (at max. 15 minutes after commit) until the site is updated, then goto the HTML Validator behind http://validator.w3.org/ - enter the url to your changed page and look what it gives you. *ANY* error message needs to be eliminated. If you are confused or not sure or want any other help - mail to the website list behind debconf-website@lists.debconf.org or talk on IRC to Neil (Nick Maulkin) or me (Nick Ganneff). You could even just send your suggestions how to change $foo to the website list. :) -- bye Joerg Free Beer is such a good thing and Free Speech too. Debian is about the both.
Attachment:
pgpECodCYEOdJ.pgp
Description: PGP signature