diff options
Diffstat (limited to 'SW/sitemake')
| -rw-r--r-- | SW/sitemake/document.en.rest.txt | 55 | ||||
| -rw-r--r-- | SW/sitemake/document.it.rest.txt | 57 |
2 files changed, 112 insertions, 0 deletions
diff --git a/SW/sitemake/document.en.rest.txt b/SW/sitemake/document.en.rest.txt new file mode 100644 index 0000000..c947412 --- /dev/null +++ b/SW/sitemake/document.en.rest.txt @@ -0,0 +1,55 @@ +Web Generator +============= + +Motivations +----------- + +Ever since I discovered `XML`_ and `XSLT`_, I've been looking for an easy and +confortable way to keep content and presentation totally separate. I started +using `XWeb`_, which is a good program, but with some problems: + +* it's written in Java (OK, OK, this is personal taste) + +* it "tweaks" files to add (navigational) information, and I thought it was + not necessary + +* it does (did?) not have dependency control functionalities (like make) + +Shortly after version 0.3 I lost sync with the official codebase because of +some modifications of mine, and I did not follow later developments. + +Given the high level of correctness attained by the `Gnome XSLT library`_, I +decided to try and look if it was possible to use just xsltproc and make to +obtain the same results. + +So I developed a DTD to describe the structure of the site, a stylesheet to +convert this structure into a makefile, and retouched the stylesheets to keep +them working after the modifications. + +How it works +------------ + +Given a description of the site's structure in the file sitemap.xml, the +stylesheet compile.xsl generates a Makefile containing rules for the +transformation of every page, along with their prerequisites. + +In this way calling make causes the regenaration of only those files whose +source have actually been modified. Moreover, each stylesheet implicitly gets +two parameters: sitemapuri containing the URI of the sitemap relative to the +stylesheet, and active which is an XPath expression indicating, inside the +sitemap, the node corresponding to the page being transformed. This way the +stylesheets can access all relevant navigational information. + +You can consult the site's sources. + +.. _`xml`: + http://www.w3.org/TR/REC-xml + +.. _`gnome xslt library`: + http://xmlsoft.org/XSLT + +.. _`xweb`: + http://xweb.sourceforge.net + +.. _`xslt`: + http://www.w3.org/TR/xslt diff --git a/SW/sitemake/document.it.rest.txt b/SW/sitemake/document.it.rest.txt new file mode 100644 index 0000000..dd842b3 --- /dev/null +++ b/SW/sitemake/document.it.rest.txt @@ -0,0 +1,57 @@ +Generatore Web +============== + +Le motivazioni +-------------- + +Da quando ho scoperto `XML`_ e `XSLT`_, ho cercato un modo semplice e comodo +per gestire in maniera del tutto separata contenuto e presentazione. All'inizio +usavo `XWeb`_, ottimo programma, ma con alcuni difetti: + +* è scritto in Java (OK, OK, questa è una questione personale...) + +* "trucca" i file per aggiungervi informazioni (di navigazione), e io pensavo + non fosse necessario + +* non ha (aveva?) funzionalità di controllo dipendenze (tipo make) + +Poco dopo la versione 0.3 ho perso la sincronizzazione con la codebase +ufficiale a causa di qualche mia modifica al codice, e non ne ho più seguiti +gli sviluppi. + +Dato l'ottimo livello di correttezza raggiunto dalla `libreria Gnome XSLT`_, ho +deciso di vedere se fosse possibile usare soltanto xsltproc e make per ottenere +gli stessi effetti. + +Ho quindi sviluppato un DTD per descrivere la struttura del sito, uno +stylesheet per convertire questa struttura in un makefile, e ho ritoccato gli +stylesheet per adeguarli alle modifiche. + +Funzionamento +------------- + +Data una descrizione della struttura del sito, nel file sitemap.xml, lo +stylesheet compile.xsl genera un Makefile contenente le istruzioni per la +trasformazione di tutte le pagine, e i loro prerequisiti. + +In questo modo, chiamando make vengono rigenerati soltanto i file i cui +sorgenti sono stati effettivamente modificati. Inoltre, ad ogni stylesheet +vengono passati implicitamente due parametri: sitemapuri che indica la URI +della sitemap relativa allo stylesheet, e active che è un'espressione XPath che +identifica, dentro la sitemap, il nodo corrispondente alla pagina che si sta +trasformando. In questo modo gli stylesheet possono accedere a tutte le +informazioni di navigazione utili. + +Potete consultare i sorgenti del sito. + +.. _`xml`: + http://www.w3.org/TR/REC-xml + +.. _`libreria gnome xslt`: + http://xmlsoft.org/XSLT + +.. _`xweb`: + http://xweb.sourceforge.net + +.. _`xslt`: + http://www.w3.org/TR/xslt |