From 0a3bf3ce5a0877c1729442754e0856a87344061f Mon Sep 17 00:00:00 2001 From: dakkar Date: Sun, 2 Mar 2008 15:57:32 +0000 Subject: git-svn-id: svn://luxion/repos/thenautilus@332 fcb26f47-9200-0410-b104-b98ab5b095f3 --- SW/sitemake/document.en.rest.txt | 55 ++++++++++++++++++++++++++++++++++++++ SW/sitemake/document.it.rest.txt | 57 ++++++++++++++++++++++++++++++++++++++++ sitemake/document.en.rest.txt | 55 -------------------------------------- sitemake/document.it.rest.txt | 57 ---------------------------------------- 4 files changed, 112 insertions(+), 112 deletions(-) create mode 100644 SW/sitemake/document.en.rest.txt create mode 100644 SW/sitemake/document.it.rest.txt delete mode 100644 sitemake/document.en.rest.txt delete mode 100644 sitemake/document.it.rest.txt 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 diff --git a/sitemake/document.en.rest.txt b/sitemake/document.en.rest.txt deleted file mode 100644 index c947412..0000000 --- a/sitemake/document.en.rest.txt +++ /dev/null @@ -1,55 +0,0 @@ -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/sitemake/document.it.rest.txt b/sitemake/document.it.rest.txt deleted file mode 100644 index dd842b3..0000000 --- a/sitemake/document.it.rest.txt +++ /dev/null @@ -1,57 +0,0 @@ -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 -- cgit v1.2.3