[TOOL] docsync

Message

Post by **fedeliallalinea** » Mon Sep 27, 2004 12:44 pm

Questo tool permette di scaricare tutta la documentazione italiana in locale e la trasforma da xml a html. Inoltre fa un controllo che quella (eventualmente) gia' scaricata sia aggiornata.

NOTA: E' scritto con il culo quando avro' piu' tempo lo metto a posto e faccio in modo doi dividerlo a funzioni cosi' il codeice resta piu' leggibile.

Messa nuova versione ma dovete prima di farlo parire editarlo e cambiare le variabili

Code: Select all

TMPDIR='/tmp/docsync'
LOCATIONDIR='/home/fat/doc/gentoo-doc-it'
CONFIGDIR='/home/fat/docsync'

Con cartelle che volete voi. La TMPDIR potete lasciarla cosi' com'e' visto che alla fine verra eliminata dal programma. La LOCATIONDIR serve per dire dove mettere la doc trasformata in html. L'ultima variabile CONFIGDIR e' dove mettete il file di configurazione (per il momento ha solo date) che serve per vedere se la doc locale e' aggiornata o meno.

Non e' ancora la versione finale quindi potrebbe avere degli errori quindi a vostro rischio e pericolo.

Scarica qui

xchris · Post by **xchris** » Mon Sep 27, 2004 12:57 pm

eddai fai l'upload da qualche parte..

odio il cutn'paste

ciao

xchris · Post by **xchris** » Mon Sep 27, 2004 1:10 pm

fedeliallalinea wrote: Scarica qui

:D 10x

xchris · Post by **xchris** » Mon Sep 27, 2004 1:14 pm

Code: Select all

........
it/ipv6.xml:829: parser error : Entity 'nbsp' not defined
test, dovete smascherarlo aggiungendo "net-misc/totd&nbsp;~x86" nel vostro file

come mai?
ciao

Post by **fedeliallalinea** » Mon Sep 27, 2004 1:22 pm

xchris wrote:come mai?
ciao

C'e' un errore nella doc fatta in xml non e' un errore dell script. Sembrerebbe che non rispetta benissimo il xsl ma comunque la crea

Post by **fedeliallalinea** » Mon Sep 27, 2004 1:40 pm

Hai qualche suggerimento per dove mettere la doc? Io avevo pensato che quando lanci lo script, se non c'e' gia', crea la cartella .docsync con il file date e un file dove mettere la doc che viene chiesta da shell. Che ne pensi?

EDIT: gnome-light sta compilando ancora spero che per stasera abbia finito

xchris · Post by **xchris** » Mon Sep 27, 2004 1:52 pm

io la metterei sempre sotto /usr/share/doc/nome_giusto

e' inutile credo avere n-versioni di cui n-1 vecchie

ciao

P.S.:aspettiamo che compili

EDIT:magari metti una funzione anche per zappare la doc!

Post by **fedeliallalinea** » Mon Sep 27, 2004 1:54 pm

xchris wrote:e' inutile credo avere n-versioni di cui n-1 vecchie

Questo chiaro metto solo l'ultima disponibile non lascia quelle vecchie. Era solo se l'utente voleva avere una cartella differente da /usr/share/doc/

xchris · Post by **xchris** » Mon Sep 27, 2004 2:02 pm

ahem.. avevo capito male

magari dai la possibilita' di installarlo in un percorso alternativo ma di default in /usr/share/doc.

ciao

neysx · Post by **neysx** » Mon Sep 27, 2004 2:16 pm

Please allow me to answer in English. Sorry I can't write in Italian.

fedeliallalinea wrote:C'e' un errore nella doc fatta in xml non e' un errore dell script. Sembrerebbe che non rispetta benissimo il xsl ma comunque la crea"

This not an error in the xsl but a config error. You need to update your /etc/xml/catalog file as explained in this doc so that the DTD can be found.
BTW, the texts like Note, Summary, Updated... that are inserted by the stylesheet can also be translated into Italian. If anyone can send me a translation of

Code: Select all

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE inserts SYSTEM "/dtd/inserts.dtd">
<inserts lang="en">
  <insert name="Content">Content</insert>
  <insert name="Updated">Updated</insert>
  <insert name="Summary">Summary</insert>
  <insert name="Figure">Figure</insert>
  <insert name="Note">Note</insert>

  <insert name="Warning">Warning</insert>
  <insert name="Important">Important</insert>
  <insert name="CodeListing">Code Listing</insert>
  <insert name="GLinuxDoc">Gentoo Linux Documentation</insert>
  <insert name="PrintableDoc">Printable Linux Documentation</insert>
  <insert name="PrintablePrj">Printable Linux Project</insert>

  <insert name="SpaceBeforeColon"/>
  <insert name="Print">Print</insert>
  <insert name="PrintTip">View a printer-friendly version</insert>
</inserts>

as found here, I'll be happy to make it available online.

You'd need to use the online version of the guide.xsl to make use of that feature which means in turn that you'd have to rewite some links either in the xsl or in the generated html.
I'll let you work on this

I don't mind sharing the fun.

You might also want to generate the printable versions of the html instead of the online ones, or maybe also the full version of the handbook in a single document.

I had a quick look at the script and I believe the navigation in the handbook will not work at all.

You might also want to serve the xml files from a webserver. You can use apache, and you can also do it without apache.

Ciao.

Post by **fedeliallalinea** » Mon Sep 27, 2004 2:31 pm

Qualcuno puo' tradurmi la parte

Code: Select all

You'd need to use the online version of the guide.xsl to make use of that feature which means in turn that you'd have to rewite some links either in the xsl or in the generated html.
I'll let you work on this Wink I don't mind sharing the fun.

You might also want to generate the printable versions of the html instead of the online ones, or maybe also the full version of the handbook in a single document.

I had a quick look at the script and I believe the navigation in the handbook will not work at all.

You might also want to serve the xml files from a webserver. You can use apache, and you can also do it without apache.

Che non l'ho capita molto bene?

randomaze · Post by **randomaze** » Mon Sep 27, 2004 3:06 pm

fedeliallalinea wrote:Qualcuno puo' tradurmi la parte

Effettivamente non é facile

In sostanza credp che dica che dovresti usare la versione online di guide.xsl oppure riscrivere alcuni link nell'xsl o nell'html generato.
Oppure potresti generare la versione "printable" del documento generato, o anche usare apache per servire direttamente i file .xml

I had a quick look at the script and I believe the navigation in the handbook will not work at all.

Questo significa che probabilmente alcuni link dell'handbook non funzioneranno.

Una domanda, stai seguendo le indicazioni di questa pagina e hai scaricato l' xsl di swift?

Post by **fedeliallalinea** » Mon Sep 27, 2004 3:09 pm

randomaze wrote:Una domanda, stai seguendo le indicazioni di questa pagina e hai scaricato l' xsl di swift?

Si

randomaze · Post by **randomaze** » Mon Sep 27, 2004 3:15 pm

fedeliallalinea wrote:
randomaze wrote:Una domanda, stai seguendo le indicazioni di questa pagina e hai scaricato l' xsl di swift?
Si

Allora (forse) l'xsl per generare off-line non é perfetto...

Post by **fedeliallalinea** » Mon Sep 27, 2004 3:16 pm

randomaze wrote:Allora (forse) l'xsl per generare off-line non é perfetto...

Beh comunque gli ho spedito la traduzione del dtd e visto che parla franceso gli ho detto se puo' tradurmi quel pezzo in francese che per me e' meglio. Grazie randomaze

Post by **fedeliallalinea** » Mon Sep 27, 2004 7:26 pm

Nuova versione. Leggere bene il primo post!!!

[TOOL] docsync

[TOOL] docsync

Re: [TOOL] docsync