| View previous topic :: View next topic |
| Author |
Message |
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 31446
Location: here
|
 Posted: Mon Sep 27, 2004 12:44 pm Post subject: [TOOL] docsync |
 |
|
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: | 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
_________________
Questions are guaranteed in life; Answers aren't.
Last edited by fedeliallalinea on Mon Sep 27, 2004 7:14 pm; edited 2 times in total |
|
| Back to top |
|
 |
xchris
Advocate
Joined: 10 Jul 2003
Posts: 2824
|
| Posted: Mon Sep 27, 2004 12:57 pm Post subject: |
|
|
eddai fai l'upload da qualche parte.. 
odio il cutn'paste 
ciao
_________________
while True:Gentoo() |
|
| Back to top |
|
|
xchris
Advocate
Joined: 10 Jul 2003
Posts: 2824
|
| Posted: Mon Sep 27, 2004 1:10 pm Post subject: Re: [TOOL] docsync |
|
|
10x
_________________
while True:Gentoo() |
|
| Back to top |
|
|
xchris
Advocate
Joined: 10 Jul 2003
Posts: 2824
|
| Posted: Mon Sep 27, 2004 1:14 pm Post subject: |
|
|
| Code: |
........
it/ipv6.xml:829: parser error : Entity 'nbsp' not defined
test, dovete smascherarlo aggiungendo "net-misc/totd ~x86" nel vostro file
|
come mai?
ciao
_________________
while True:Gentoo() |
|
| Back to top |
|
|
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 31446
Location: here
|
| Posted: Mon Sep 27, 2004 1:22 pm Post subject: |
|
|
| 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
_________________
Questions are guaranteed in life; Answers aren't. |
|
| Back to top |
|
|
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 31446
Location: here
|
| Posted: Mon Sep 27, 2004 1:40 pm Post subject: |
|
|
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
_________________
Questions are guaranteed in life; Answers aren't. |
|
| Back to top |
|
|
xchris
Advocate
Joined: 10 Jul 2003
Posts: 2824
|
| Posted: Mon Sep 27, 2004 1:52 pm Post subject: |
|
|
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!
_________________
while True:Gentoo() |
|
| Back to top |
|
|
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 31446
Location: here
|
| Posted: Mon Sep 27, 2004 1:54 pm Post subject: |
|
|
| 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/
_________________
Questions are guaranteed in life; Answers aren't. |
|
| Back to top |
|
|
xchris
Advocate
Joined: 10 Jul 2003
Posts: 2824
|
| Posted: Mon Sep 27, 2004 2:02 pm Post subject: |
|
|
ahem.. avevo capito male 
magari dai la possibilita' di installarlo in un percorso alternativo ma di default in /usr/share/doc.
ciao
_________________
while True:Gentoo() |
|
| Back to top |
|
|
neysx
Retired Dev
Joined: 27 Jan 2003
Posts: 795
|
| Posted: Mon Sep 27, 2004 2:16 pm Post subject: |
|
|
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: | <?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. |
|
| Back to top |
|
|
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 31446
Location: here
|
| Posted: Mon Sep 27, 2004 2:31 pm Post subject: |
|
|
Qualcuno puo' tradurmi la parte
| Code: | 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?
_________________
Questions are guaranteed in life; Answers aren't. |
|
| Back to top |
|
|
randomaze
Bodhisattva
Joined: 21 Oct 2003
Posts: 9985
|
| Posted: Mon Sep 27, 2004 3:06 pm Post subject: |
|
|
| 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
| Quote: | | 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?
_________________
Ciao da me! |
|
| Back to top |
|
|
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 31446
Location: here
|
| Posted: Mon Sep 27, 2004 3:09 pm Post subject: |
|
|
| randomaze wrote: | | Una domanda, stai seguendo le indicazioni di questa pagina e hai scaricato l' xsl di swift? |
Si
_________________
Questions are guaranteed in life; Answers aren't. |
|
| Back to top |
|
|
randomaze
Bodhisattva
Joined: 21 Oct 2003
Posts: 9985
|
| Posted: Mon Sep 27, 2004 3:15 pm Post subject: |
|
|
| 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...
_________________
Ciao da me! |
|
| Back to top |
|
|
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 31446
Location: here
|
| Posted: Mon Sep 27, 2004 3:16 pm Post subject: |
|
|
| 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
_________________
Questions are guaranteed in life; Answers aren't. |
|
| Back to top |
|
|
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 31446
Location: here
|
| Posted: Mon Sep 27, 2004 7:26 pm Post subject: |
|
|
Nuova versione. Leggere bene il primo post!!!
_________________
Questions are guaranteed in life; Answers aren't. |
|
| Back to top |
|
|
|
Forum italiano (Italian) 
