Pubblicare manuali online da Argo CMS

Come realizzare manuali in HTML da Argo per pubblicarli sul web

Argo CMS è compatibile con Windows 8

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.

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.

Che cosa fare in Argo

La prima volta, prima di esportare da Argo i contenuti del manuale da pubblicare sul web:

Accedete aC:\Programmi\Argo 2.0\Plugin

Verificate che la cartella contenga il filePluginHtml.dll

Questo file è necessario per convertire in modo corretto il manuale in HTML.

1

Verificate la presenza del file PluginHTML

Che cosa fare in Argo

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 manualeRiferimenti dell’azienda (Indirizzo 1 e 2)Logo dell’azienda (LogoFooter)Indirizzo e-mail e indirizzo Web.

2

Mappate gli Stili

1. Cliccate sulla colonna HTML Tag in corrispondenza dello stile da mappare

1. Selezionate il tag HTML da associare allo stile di ArgoEsempio: Titolo06 = h6

2. Cliccate su OK

1. Cliccate sul bottone Stili

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.

Che cosa fare in 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.

3

Esportate i contenuti da Argo

1. Selezionate un file di configurazione di export

2. Cliccate sul bottone Avanti

Esportate i contenuti da Argo

Cliccate sul bottone Avanti

Esportate i contenuti da Argo

1. Selezionate il documento e la revisione da cui esportare i contenuti

2. Cliccate sul bottone Avanti

Esportate i contenuti da Argo

Selezionate:

1.Contenuti da esportare (a mano o richiamando i marcatori [le Proprietà])2.Destinatari3.Lingua4.Dove salvare il file

5.Cliccate sul bottone Avanti

Esportate i contenuti da Argo

1. Selezionate l’opzione Html2. Se lo desiderate,

selezionate l’opzione Esporta le immagini

3. Cliccate sul bottone Avanti

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.

Che cosa fare nel Converter

Avete completato la prima fase della procedura!Una volta esportati da Argo i contenuti del manuale da pubblicare sul web:

Chiudete ArgoAccedete 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.

1

Aprite il Converter

1. Create 2 cartelle per salvare:1. I Template grafici da

modificare2. I manuali convertiti in

HTML2. Aprite il convertitore.

Per convertire il manuale in HTML, selezionate:

La cartella in cui salvare il Template da modificareLa cartella in cui salvare il manualeIl file Database.xml esportato da Argo

Si tratta del file con i contenuti del manuale da convertire.

Che cosa fare nel Converter 2

Selezionate la cartella del Template da modificare

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).

Selezionate la cartella di destinazione del manuale in HTML

Selezionate il manuale da convertire in HTML

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.

Che cosa fare nel Converter 3

Verificate le immagini mancati e accedete al manuale in HTML

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.

Contenuto della cartella del manuale in HTML

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.

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-argo-cms/0001-Guida_di_riferimento_per_il_LayOut.html

Esempio di manuale in HTML

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

Esempio di manuale in HTML

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.

Esempio di manuale in HTML

Esempio di formattazione automatica di una tabella, che contiene celle concatenate

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

Che cosa fare per pubblicare online il manualeOra il manuale è in HTML!Effettuate le verifiche, per pubblicare online il manuale in HTML:

Selezionate la cartella che contiene il manualeCaricate la cartella sul vostro server web

Per caricare la cartella utilizzate, per esempio, un client FTPPer 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!

1

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/