http://www.keanet.it/argo-ccms-per-documentazione-tecnica-e-di-prodotto.html | Da Argo CCMS è possibile realizzare manuali di istruzioni in formato HTML5, e-manual e digital documentation come previsto dal futuro nuovo Regolamento Macchine
2. Che cosa fare
in Argo una sola volta
Verificate la presenza del file
PluginHTML
3. 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.
Cartella C:ProgrammiArgo
2.0Plugin
5. Che cosa fare
in Argo una sola volta
Impostate la corrispondenza fra
stili di Argo e stili HTML
6. 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.
È 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.
Impostate le corrispondenze
7. 1. Cliccate sulla colonna
HTML Tag in
corrispondenza dello stile
da mappare
1. Selezionate il tag HTML da
associare allo stile di Argo
Esempio: Titolo06 = h6
2. Cliccate su OK
1. Cliccate sul bottone Stili
Impostate le corrispondenze
8. Dettaglio sul 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.
10. Che cosa fare
in Argo
Inserite i contenuti tipici dei
manuali in HTML
11. Per inserire in Argo un testo da usare
come link a risorse online o locali:
Inserire un modulo Testo, attribuendogli lo
Stile (es. «LinkTesto») che dichiarerete nelle
impostazioni di Argo HTML5 Converter
Nel modulo Testo inserire testo +
URL/nome della risorsa separati da |:
Esempio di Link a risorsa esterna che inizia con
www o http|www.nome-sito.it
Esempio di Link a risorsa locale|nome-file.pdf
Inserite un Anchor Text
12. Per inserire in Argo un’immagine da usare
come link a risorse online o locali:
Inserire un modulo Foto+Didascalia, attribuendogli lo
Stile (es. «LinkIMG») che dichiarerete nelle
impostazioni di Argo HTML5 Converter
Nel modulo Foto+Didascalia inserire:
L’immagine da trasformare in link
In didascalia inserire:
L’URL della risorsa esterna che inizia con www o http (es.
www.nome-sito.it)
Il nome della risorsa locale nome-file.pdf
Inserite un’immagine linkata
13. Per inserire in Argo un video pubblicato
su YouTube da incorporare:
Inserire un modulo Testo, attribuendogli lo
Stile (es. «Video») che dichiarerete nelle
impostazioni di Argo HTML5 Converter
Nel modulo Testo inserire l’URL del video
in questo formato:
https://www.youtube.com/embed/a5K-W_ZY5Hg
Incorporate un video di YouTube
14. Per inserire in Argo un video locale da
incorporare:
Inserire un modulo Testo, attribuendogli lo
Stile (es. «VideoFile») che dichiarerete nelle
impostazioni
di Argo HTML5 Converter
Nel modulo Testo inserire il nome del file
video, che deve essere in formato .mp4:
nome-file.mp4
Incorporate un video salvato in una
cartella locale
15. Vi consigliamo di
inserire anchor text, immagini linkate, video
di YouTube e video locali
in livelli a sé stanti di Argo e/o di
marcarli con apposite Proprietà,
in modo tale da poter facilmente escludere
dagli output stampati i contenuti tipici dei
manuali in HTML.
Consiglio generale
16. Che cosa fare
in Argo
Esportate da Argo i contenuti
del manuale in HTML
17. Esportate i contenuti da Argo
Ora siete pronti!
Per esportare da Argo i contenuti del manuale da
pubblicare sul web:
Cliccate sul bottone Esporta FrameEditor
Seguite la procedura guidata.
18. Esportate i contenuti da Argo
1. Selezionate un file di
configurazione di export
2. Cliccate sul bottone Avanti
20. Esportate i contenuti da Argo
1. Selezionate il documento e
la revisione da cui
esportare i contenuti
2. Cliccate sul bottone Avanti
21. 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
22. 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
23. 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.
24. Che cosa fare una sola
volta in Argo HTML5
Converter
Create le cartelle di base
25. Create le cartelle di base
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 HTML5
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 HTML5
Aprite il convertitore.
26. Create le cartelle di base
1. Create 2 cartelle per
salvare:
1. I Template grafici da
modificare
2. I manuali convertiti in
HTML5
2. Aprite il convertitore.
27. Che cosa fare in Argo
HTML5 Converter
Convertite in HTML5 il file XML
esportato da Argo
30. 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).
32. Opzione per la nominazione delle
pagine HTML5 del manuale
Opzione per nominare le pagine
web secondo il formato
Numero progressivo + ID
univoco + Titolo della pagina
33. Opzione per impostare ulteriori
corrispondenze fra stili Argo/HTML
Opzione per definire ulteriori
corrispondenze fra stili di Argo
e tag di Titolo HTML.
Ulteriori a quelle già definite in
Argo.
35. In Argo avete già definito il nome degli
Stili che desiderate usare per gestire:
Testi da usare come link
a risorse online o locali
Immagini da usare come link
a risorse online o locali
Video di YouTube da incorporare
Video locali da incorporare
Riassunto delle attività già svolte in
Argo
36. Specificate il nome degli Stili
definiti in Argo
Specificare il nome degli Stili definiti in
Argo per gestire:
Anchor text (es. «LinkTesto»)
Immagini linkate (es. «LinkIMG»)
Video pubblicati su YouTube (es. «Video»)
Video salvati in locale (es. «VideoFile»)
1
38. Specificate il nome delle cartelle
di risorse e video locali
Specificate il nome delle cartelle locali in
cui salvare:
Risorse di vario tipo
Per esempio: PDF, file in formato MS Word ed
Excel, ecc.
Video
2
39. Risorse e video locali
vanno salvati nella
cartella specificata nelle
impostazioni di Argo
HTML5 Converter
Cartella delle
risorse locali
Cartella dei
video locali
2
Specificate il nome di cartelle
di risorse e video locali
42. Al termine della conversione del manuale in HTML5
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 HTML5
Il convertitore segnala eventuali immagini mancanti, che potete
inserire a mano nella cartella Images del manuale, prima di
pubblicarlo sul web.
Accedete alla cartella del
manuale convertito in HTML5
43. Dettaglio sulla finestra di dialogo
La finestra di dialogo vi
indica il numero di immagini
mancanti, che potete
inserire a mano nella
cartella Images del manuale.
44. Cartella del manuale in HTML5
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.
2021-09-15-10-00-00
46. Contenuto della cartella del
manuale in HTML5
Pagine HTML5
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(5) 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.
48. Sommario interattivo, header,
credits e footer
Il sommario del manuale è
generato in base ai tag da h1 ad
h6 impostati in Argo
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
49. Motore di ricerca
Il motore di ricerca permette
all’utente di:
• Cercare nel manuale parole
ed espressioni chiave
• Accedere ai risultati della
ricerca
50. Personalizzazioni grafiche
Modificando i file Template
potete personalizzare il layout
di pagina:
• Intestazione
• Menu del sommario
• Piè di pagina
Modificando i fogli di stile CSS
potete personalizzare la
formattazione di tutti i
contenuti:
• Titoli
• Testi
• Elenchi
• Immagini
• Warnings
• Tabelle, ecc.
51. Concatenazione automatica di celle
di tabella
Esempio di formattazione
automatica di una tabella, che
contiene celle concatenate
57. Come pubblicare online il
manuale in HTML5
Ora il manuale è in formato HTML5!
Effettuate le verifiche, per pubblicare online il manuale in
HTML5:
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, in una newsletter o
mediante codice QR apposto su prodotto/confezione/imballo, ecc.
Ora il manuale è online!
58. Altre modalità di distribuzione
del manuale in HTML5
Oltre a essere pubblicabile online, il manuale in HTML5
realizzato a partire da Argo può essere:
Integrato in applicativi installati a bordo macchina
Salvato su chiavette USB e altri supporti offline.
59. Contatti
Contattateci per maggiori informazioni su Argo CMS e su
Argo HTML5 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/