Gestione dei contenuti con DITA e XML

Gestione dei contenuti con DITA e XML

Gestione esperta di contenuti DITA e XML per la pubblicazione multilingue. Autore strutturato, scrittura per argomenti e soluzioni per il riutilizzo dei contenuti.

Cos'è lo standard DITA?

DITA (Darwin Information Typing Architecture) è un'architettura basata su XML per l'authoring, la produzione e la distribuzione di documentazione tecnica. L'architettura, insieme alla relativa DTD e W3C-Schema, è stata sviluppata da IBM.

Il nome completo dell'architettura ha questa spiegazione combinata:
Darwin: utilizza i principi di specializzazione ed ereditarietà
Information Typing: sfrutta la semantica dei topic (concept, task, reference) e dei contenuti (messaggi, frasi tipizzate, tabelle semantiche)
Architecture: fornisce margini di espansione verticale (nuove applicazioni) e estensione orizzontale (specializzazione in nuovi tipi) per l'informazione

A differenza degli approcci orientati al libro basati su capitoli e pagine, DITA utilizza topic, piccoli blocchi di informazione facilmente riutilizzabili in diversi contesti e formati di output. DITA dispone inoltre di un supporto integrato per l'estensibilità, il che significa che è possibile personalizzare le definizioni dei tipi di documento (o DTD) senza compromettere la compatibilità con le applicazioni e i processi esistenti. Per questi motivi e altri ancora, DITA va oltre qualsiasi approccio precedente nell'aiutarvi a superare le barriere all'adozione di XML, massimizzare il riutilizzo dei contenuti e ridurre le ridondanze informative.

DITA specifica diversi tipi di topic, come Task, Concept e Reference. All'interno di DITA, un topic Task è destinato a una procedura che descrive come completare un compito; elenca una serie di passaggi che gli utenti seguono per produrre un risultato specifico; identifica chi fa cosa, quando, dove e come. Un topic Reference è per gli argomenti che descrivono la sintassi dei comandi, le istruzioni di programmazione, altro materiale di riferimento; solitamente materiale dettagliato e fattuale.

Che cos'è lo standard DocBook?

DocBook è un linguaggio di markup per la documentazione tecnica, originariamente concepito per la redazione di documenti tecnici relativi all'hardware e al software informatico, ma utilizzabile per qualsiasi altro tipo di documentazione.

Uno dei principali vantaggi di DocBook è che consente agli utenti di creare contenuti documentali in forma indipendente dalla presentazione, catturando la struttura logica del contenuto; tale contenuto può quindi essere pubblicato in una varietà di formati, inclusi HTML, PDF, pagine man e HTML Help, senza richiedere alcuna modifica al codice sorgente.

Che cos'è DocBook?

DocBook fornisce un sistema per la scrittura di documenti strutturati utilizzando SGML o XML. È particolarmente adatto a libri e articoli su hardware e software informatico, sebbene non sia assolutamente limitato a questi.
In breve, DocBook è un DTD facile da comprendere e ampiamente utilizzato. Decine di organizzazioni utilizzano DocBook per milioni di pagine di documentazione, in vari formati sia cartacei che online, in tutto il mondo.

Perché DocBook è necessario?

Il formato DocBook è stato progettato dal consorzio OASIS specificamente per la documentazione tecnica. Fornisce un ricco insieme di tag per descrivere il contenuto del documento.
Di seguito sono riportati alcuni punti chiave che aiutano a comprendere che cosa sia DocBook:

• DocBook è un linguaggio di markup
  È molto simile a HTML sotto questo aspetto. I tag danno una struttura al documento e appaiono mescolati al testo informativo.
  Questo aspetto particolare rappresenta una rivoluzione per la traduzione della documentazione, poiché la fase di DTP (impaginazione del testo) viene eseguita una sola volta indirettamente attraverso l'etichettatura del testo originale. I traduttori devono solo tradurre "tra i tag" e con un singolo tasto viene generato l'output tradotto.
• È realizzato per la documentazione tecnica
  DocBook è perfettamente adatto alla documentazione delle parti di motori automobilistici. Tuttavia, è fortemente orientato verso la documentazione dei programmi per computer.
• Tecnicamente, DocBook è un DTD SGML o XML
  Ciò significa che è possibile sfruttare i numerosi strumenti consapevoli di SGML e XML. Sebbene DocBook come implementazione XML sia abbastanza recente, ha una lunga storia come implementazione SGML.
• DocBook non è un linguaggio di presentazione
  DocBook si preoccupa attentamente di non specificare come appaia la documentazione finale. Questo consente allo scrittore di concentrarsi sull'organizzazione e sul significato del documento che scrive. Tutti gli aspetti di presentazione sono demandati ai fogli di stile.
  Questo garantisce che tutti i documenti abbiano un aspetto coerente, indipendentemente da chi sia il redattore tecnico.
• DocBook è personalizzabile
  È abbastanza facile personalizzare il DTD per soddisfare le proprie esigenze grazie alla sua organizzazione modulare. Tuttavia, è necessario essere consapevoli che ciò deve essere fatto nel rispetto delle convenzioni SGML/XML e potrebbe introdurre incompatibilità.
  Se DocBook viene utilizzato in combinazione con i fogli di stile modulari di Norman Walsh, è anche possibile personalizzare il modo in cui un file DocBook può essere stampato o messo online.
• DocBook è completo
  Il gran numero di tag definiti in DocBook garantisce che possa adattarsi a un'ampia gamma di situazioni e aspettative di elaborazione.
  Questo, a sua volta, lo rende un po' difficile da imparare, ma è possibile scrivere documentazione conoscendo solo un insieme limitato di tag e facendo riferimento alla documentazione di riferimento quando necessario.

Che cos'è la gestione dei contenuti XML?

Un sistema di gestione dei contenuti XML può trasformare i vostri contenuti per raggiungere diversi media e dispositivi, inclusi il web, CD, presentazioni offline, cataloghi stampati, dispositivi PDA e telefoni wireless. Creando i contenuti una sola volta e riutilizzandoli su diversi media, garantite coerenza e rilevanza dei messaggi su tutti i canali di comunicazione. In questo modo, la gestione dei contenuti XML consente alle aziende di impegnarsi più efficacemente nell'e-business attraverso il riutilizzo dei contenuti, la separazione tra contenuto e presentazione, lo scambio indipendente dalla piattaforma, l'integrazione senza problemi e la pubblicazione multicanale.

Che cos'è la Web Content Management?

La Web Content Management consente agli utenti aziendali e al personale non tecnico di mantenere e sviluppare un sito web separando la sua struttura e i contenuti dalla progettazione grafica. Questo sostituisce i metodi tradizionali che richiedono conoscenze di HTML e tecniche di design, e con regole a livello di sistema, garantisce che aspetti quali la navigazione e i layout delle pagine siano gestiti in modo coerente. Ciò consente di controllare il sito web senza preoccuparsi di compromettere lo stile aziendale, di come aggiungere una nuova sezione al menu o quali costi aggiuntivi potrebbero derivare dalle vostre modifiche, e invece concentrarsi sull'utilizzo del sito web per comunicare più efficacemente con clienti, potenziali clienti e partner.