Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
[TOOL] docsync
View unanswered posts
View posts from last 24 hours
View posts from last 7 days

 
Reply to topic    Gentoo Forums Forum Index Forum italiano (Italian) Risorse italiane (documentazione e tools)
View previous topic :: View next topic  
Author Message
fedeliallalinea
Administrator
Administrator


Joined: 08 Mar 2003
Posts: 30822
Location: here

PostPosted: Mon Sep 27, 2004 12:44 pm    Post subject: [TOOL] docsync Reply with quote

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
View user's profile Send private message
xchris
Advocate
Advocate


Joined: 10 Jul 2003
Posts: 2824

PostPosted: Mon Sep 27, 2004 12:57 pm    Post subject: Reply with quote

eddai fai l'upload da qualche parte.. :)
odio il cutn'paste :D
ciao
_________________
while True:Gentoo()
Back to top
View user's profile Send private message
xchris
Advocate
Advocate


Joined: 10 Jul 2003
Posts: 2824

PostPosted: Mon Sep 27, 2004 1:10 pm    Post subject: Re: [TOOL] docsync Reply with quote

fedeliallalinea wrote:

Scarica qui


:D:D 10x
_________________
while True:Gentoo()
Back to top
View user's profile Send private message
xchris
Advocate
Advocate


Joined: 10 Jul 2003
Posts: 2824

PostPosted: Mon Sep 27, 2004 1:14 pm    Post subject: Reply with quote

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
View user's profile Send private message
fedeliallalinea
Administrator
Administrator


Joined: 08 Mar 2003
Posts: 30822
Location: here

PostPosted: Mon Sep 27, 2004 1:22 pm    Post subject: Reply with quote

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
View user's profile Send private message
fedeliallalinea
Administrator
Administrator


Joined: 08 Mar 2003
Posts: 30822
Location: here

PostPosted: Mon Sep 27, 2004 1:40 pm    Post subject: Reply with quote

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
View user's profile Send private message
xchris
Advocate
Advocate


Joined: 10 Jul 2003
Posts: 2824

PostPosted: Mon Sep 27, 2004 1:52 pm    Post subject: Reply with quote

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
View user's profile Send private message
fedeliallalinea
Administrator
Administrator


Joined: 08 Mar 2003
Posts: 30822
Location: here

PostPosted: Mon Sep 27, 2004 1:54 pm    Post subject: Reply with quote

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
View user's profile Send private message
xchris
Advocate
Advocate


Joined: 10 Jul 2003
Posts: 2824

PostPosted: Mon Sep 27, 2004 2:02 pm    Post subject: Reply with quote

ahem.. avevo capito male :oops:

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

ciao
_________________
while True:Gentoo()
Back to top
View user's profile Send private message
neysx
Retired Dev
Retired Dev


Joined: 27 Jan 2003
Posts: 795

PostPosted: Mon Sep 27, 2004 2:16 pm    Post subject: Reply with quote

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
View user's profile Send private message
fedeliallalinea
Administrator
Administrator


Joined: 08 Mar 2003
Posts: 30822
Location: here

PostPosted: Mon Sep 27, 2004 2:31 pm    Post subject: Reply with quote

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
View user's profile Send private message
randomaze
Bodhisattva
Bodhisattva


Joined: 21 Oct 2003
Posts: 9985

PostPosted: Mon Sep 27, 2004 3:06 pm    Post subject: Reply with quote

fedeliallalinea wrote:
Qualcuno puo' tradurmi la parte


Effettivamente non é facile :roll:

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
View user's profile Send private message
fedeliallalinea
Administrator
Administrator


Joined: 08 Mar 2003
Posts: 30822
Location: here

PostPosted: Mon Sep 27, 2004 3:09 pm    Post subject: Reply with quote

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
View user's profile Send private message
randomaze
Bodhisattva
Bodhisattva


Joined: 21 Oct 2003
Posts: 9985

PostPosted: Mon Sep 27, 2004 3:15 pm    Post subject: Reply with quote

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
View user's profile Send private message
fedeliallalinea
Administrator
Administrator


Joined: 08 Mar 2003
Posts: 30822
Location: here

PostPosted: Mon Sep 27, 2004 3:16 pm    Post subject: Reply with quote

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
View user's profile Send private message
fedeliallalinea
Administrator
Administrator


Joined: 08 Mar 2003
Posts: 30822
Location: here

PostPosted: Mon Sep 27, 2004 7:26 pm    Post subject: Reply with quote

Nuova versione. Leggere bene il primo post!!!
_________________
Questions are guaranteed in life; Answers aren't.
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Forum italiano (Italian) Risorse italiane (documentazione e tools) All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum