Dalla versione 2.4.2.0 di Argo è disponibile il modulo Argo HTML Converter per convertire in formato HTML manuali, libretti, istruzioni d’uso, guide (per installatore, operatore, manutentore, ecc.), troubleshooting (risoluzione di problemi), ecc. Argo HTML Converter genera documentazione tecnica in formato HTML, completa di sommario interattivo, intestazione e piè di pagina, motore di ricerca e layout personalizzabile. La documentazione può essere pubblicata online, utilizzando qualsiasi server web.

1. Pubblicare manuali
online da Argo CMS
Come realizzare manuali in HTML
da Argo per pubblicarli sul web
Argo CMS è compatibile con Windows 8

2. Pubblicare manuali online da Argo
Dalla versione 2.4.2.0 di Argo è disponibile il modulo Argo
HTML Converter per convertire in formato HTML manuali,
libretti, istruzioni d’uso, guide (per installatore, operatore,
manutentore, ecc.), troubleshooting (risoluzione di
problemi), ecc.
Argo HTML Converter genera documentazione tecnica in
formato HTML, completa di sommario interattivo,
intestazione e piè di pagina, motore di ricerca e layout
personalizzabile.
La documentazione può essere pubblicata online,
utilizzando qualsiasi server web.

3. Come realizzare manuali in HTML
Per convertire in HTML la documentazione tecnica gestita
con Argo, seguite questa procedura:
Argo
 Esportate i contenuti del manuale da pubblicare sul web
 Utilizzate eventualmente i marcatori (le Proprietà di Argo) per esportare
selettivamente i contenuti, per esempio per famiglia, modello, matricola,
mercato, destinatario, tipo di pubblicazione, ecc.
Argo HTML Converter
 Convertite in HTML il manuale esportato da Argo
 Caricate sul server web il manuale in formato HTML per pubblicarlo online.

4. Che cosa fare in Argo 1
La prima volta, prima di esportare da Argo i contenuti del
manuale da pubblicare sul web:
Accedete a
C:ProgrammiArgo 2.0Plugin
 Verificate che la cartella contenga il file
PluginHtml.dll
 Questo file è necessario per convertire in modo corretto il manuale in HTML.

5. Verificate la presenza del file
PluginHTML

6. Che cosa fare in Argo 2
La prima volta, prima di esportare da Argo i contenuti del
manuale da pubblicare sul web, impostate la
corrispondenza fra stili di Argo e tag HTML.
E’ necessario mappare:
Titoli (6 livelli possibili, da h1 ad h6)
Elenchi (puntati, numerati, lettera).
E’ possibile mappare altri stili per inserire contenuti in intestazione e nel piè di pagina
del manuale online:
Titolo e Sottotitolo del manuale
Riferimenti dell’azienda (Indirizzo 1 e 2)
Logo dell’azienda (LogoFooter)
Indirizzo e-mail e indirizzo Web.

7. Mappate gli Stili
1. Cliccate sul bottone Stili
1. Cliccate sulla colonna 1. Selezionate il tag HTML da
HTML Tag in associare allo stile di Argo
corrispondenza dello stile Esempio: Titolo06 = h6
da mappare 2. Cliccate su OK

8. Legenda del menu Tag HTML
 Stili per il contenuto del manuale online
 Titoli
 Da h1 (header, cioè titolo di livello 1) ad h6 (header, cioè titolo di livello 6)
 Determinano la struttura del sommario del manuale online
 Elenchi
 Puntato, numerato o lettera
 Stili per l’intestazione del manuale online
 Titolo e Sottotitolo
 Titolo e sottotitolo del manuale
 Indirizzo 1 e Indirizzo 2
 Riferimenti dell’azienda
 Stili per il piè di pagina del manuale online
 Logofooter
 Logo dell’azienda
 Indirizzo e-mail e www
 Indirizzo e-mail e indirizzo del sito web dell’azienda.

9. Che cosa fare in Argo 3
Ora siete pronti!
Per esportare da Argo i contenuti del manuale da
pubblicare sul web:
Cliccate sul bottone Esporta  FrameEditor
 Seguite la procedura guidata.

10. Esportate i contenuti da Argo
1. Selezionate un file di
configurazione di export
2. Cliccate sul bottone Avanti

11. Esportate i contenuti da Argo
Cliccate sul bottone Avanti

12. Esportate i contenuti da Argo
1. Selezionate il documento e
la revisione da cui
esportare i contenuti
2. Cliccate sul bottone Avanti

13. Esportate i contenuti da Argo
Selezionate:
1.Contenuti da esportare (a
mano o richiamando i
marcatori [le Proprietà])
2.Destinatari
3.Lingua
4.Dove salvare il file
5.Cliccate sul bottone Avanti

14. Esportate i contenuti da Argo
1. Selezionate l’opzione Html
2. Se lo desiderate,
selezionate l’opzione
Esporta le immagini
3. Cliccate sul bottone Avanti

15. Esportate i contenuti da Argo
1. Se lo desiderate, salvate il
file di configurazione
2. Cliccate sul bottone Fine
per esportare i contenuti.
Otterrete un file denominato
Database.xml.

16. Che cosa fare nel Converter 1
Avete completato la prima fase della procedura!
Una volta esportati da Argo i contenuti del manuale da
pubblicare sul web:
Chiudete Argo
Accedete alla cartella che contiene Argo HTML
Converter
 La prima volta, create:
 Una cartella in cui salvare il Template da modificare
 Il Convertitore crea una copia del Template di default, che potete modificare per
personalizzare il layout di pagina e la formattazione dei contenuti dei manuali da
pubblicare online
 Una cartella in cui salvare i manuali convertiti in HTML
 Aprite il convertitore.

17. Aprite il Converter
1. Create 2 cartelle per
salvare:
1. I Template grafici da
modificare
2. I manuali convertiti in
HTML
2. Aprite il convertitore.

18. Che cosa fare nel Converter 2
Per convertire il manuale in HTML, selezionate:
La cartella in cui salvare il Template da modificare
La cartella in cui salvare il manuale
Il file Database.xml esportato da Argo
 Si tratta del file con i contenuti del manuale da convertire.

19. Selezionate la cartella del Template
da modificare

20. Cartella del Template da modificare
Il Convertitore crea una copia
del Template di default.
Potete modificarlo prima di
convertire il manuale per
personalizzare:
1.Layout di pagina (file
PageTemplate e
RicercaTemplate)
2.Formattazione dei contenuti
(fogli di stile CSS).

21. Selezionate la cartella di
destinazione del manuale in HTML

22. Selezionate il manuale da
convertire in HTML

23. Che cosa fare nel Converter 3
Al termine della conversione del manuale in HTML:
Accedete alla cartella che contiene il manuale
 Il manuale è contenuto in una cartella nominata in base alla data
e all’ora di creazione
 Potete rinominare la cartella, prima di caricarla sul vostro web server per
pubblicare online il manuale in HTML
 Il convertitore segnala eventuali immagini mancanti, che potete
inserire a mano nella cartella Images del manuale, prima di
pubblicarlo sul web.

24. Verificate le immagini mancati e
accedete al manuale in HTML

25. Cartella del manuale in HTML
Il manuale è contenuto in una
cartella nominata in base alla
data e all’ora di creazione.
Potete rinominare la cartella,
prima di caricarla sul vostro
web server per pubblicare
online il manuale.

26. Contenuto della cartella del
manuale in HTML

27. Contenuto della cartella del
manuale in HTML
 Pagine HTML
 Il convertitore genera le pagine in base ai tag da h1 (header,
cioè titolo di livello 1) ad h6 (header, cioè titolo di livello 6)
impostati in Argo
 Il convertitore genera una pagina per ogni tag da h1 ad h6
 Cliccate sulla prima pagina HTML per aprire il manuale nel vostro browser
predefinito
 Così potete verificare il manuale prima di pubblicarlo online
 Cartella Images
 Contiene le immagini del manuale
 Se necessario, copiate a mano le immagini nel formato e delle
dimensioni idonee alla visualizzazione sul web e/o le immagini
mancanti
 Cartella CSS
 Contiene i fogli di stile in formato CSS
 Potete modificarli per personalizzare, dopo la conversione, la
formattazione dei contenuti del manuale.

28. Esempio di manuale in HTML
Per vedere un esempio di manuale in HTML
esportato da Argo, seguite questo link:
http://
www.keanet.it/realizzare-manuali-in-html-da-arg

29. Esempio di manuale in HTML
Intestazione e piè di pagina
contengono i valori dei tag
Titolo, Sottotitolo, Indirizzo 1 e
2, LogoFooter, Indirizzo e-mail
e www impostati in Argo
Il sommario del manuale è
generato in base ai tag da h1
ad h6 impostati in Argo

30. Esempio di manuale in HTML
Modificando i fogli di stile CSS
potete personalizzare la
Modificando i file Template formattazione di tutti i
potete personalizzare il layout contenuti:
•Titoli
di pagina:
•Intestazione •Testi
•Menu del sommario •Elenchi
•Piè di pagina •Immagini
•Warnings
•Tabelle, ecc.

31. Esempio di manuale in HTML
Esempio di formattazione
automatica di una tabella, che
contiene celle concatenate

32. Esempio di manuale in HTML
Il motore di ricerca permette
all’utente di:
•Cercare nel manuale parole ed
espressioni chiave
•Accedere ai risultati della
ricerca

33. Che cosa fare per pubblicare
1
online il manuale
Ora il manuale è in HTML!
Effettuate le verifiche, per pubblicare online il manuale in
HTML:
Selezionate la cartella che contiene il manuale
Caricate la cartella sul vostro server web
 Per caricare la cartella utilizzate, per esempio, un client FTP
Per rendere il manuale accessibile da parte dei destinatari
 Pubblicatene il link sul vostro sito internet
… oppure…
 Comunicatene il link ai destinatari via e-mail o in una newsletter.
Ora il manuale è online!

34. Contatti
Contattateci per maggiori informazioni su Argo CMS e su
Argo HTML Converter!
 KEA s.r.l.
 Via Strà, 102
 37042 Caldiero (VR)
 Italia
 Tel./Fax: +39 045 6152381
 E-mail generale: info@keanet.it
 Web: http://www.keanet.it/
 Blog: http://blog.keanet.it/