Primeiros passos

Os primeiros passos do trabalho com DITA envolvem um conjunto de passos:

  • Entender a arquitetura baseada em tópicos por trás do modelo DITA.
    A elaboração de conteúdo baseado em tópicos é a base da arquitetura DITA. Para compreender a melhor abordagem para a DITA, primeiro compreenda o que é conteúdo baseado em tópicos e escrita estruturada.

  • Crie um modelo de informação.
    Esta é a melhor forma de orientar sua equipe sobre o caminho a ser seguido durante o processo de adoção e implementação da DITA. Um modelo de informação inclui informações como:

    • Descrições de Tipo de Informação

    • Descrições de Unidades de Conteúdo

    • Definições de estrutura de metadados e pastas/repositório

    • Convenções de nomenclaturas

    • Definições de documentos

  • Leia a arquitura e a especificação da linguagem DITA para entender como o modelo funciona.
    Para ajudá-lo a criar seu modelo de informação, você pode considerar úteis as especificações da arquitetura (DITA Architecture Specification) e da linguagem (DITA Language Specification). A especificação da linguagem fornece definições de elementos e atributos que você pode usar como parte do padrão DITA. A especificação da arquitetura DITA fornece informações sobre os recursos que a DITA oferece como o reuso de conteúdo, o processamento condicional e a especialização.

  • Crie um inventário de seu próprio conteúdo e transforme-o em tópicos.
    Para desenvolver completamente seus processos e modelo de informação, considere a possibilidade de conduzir um projeto piloto. Seu projeto deve ser pequeno o suficiente para não desencorajar a equipe e outras partes interessadas quanto à continuidade do projeto, mas também deve ser grande o bastante de forma que você possa testar seu conteúdo em relação ao modelo DITA e seus processos de trabalho. É melhor criar um inventário de seu conteúdo primeiro para identificar consistências na estrutura e informações que você possa reduzir e reusar. Depois, comece a marcar seu conteúdo conforme a especificação DITA para identificar necessidades específicas de adequação.

  • Faça o download do DITA Open Toolkit no site do Source Forge
    Para o processamento de seu conteúdo, você pode querer usar o DITA Open Toolkit para criar saídas em PDF, XHTML pages, HTML Help (.chm), Java Help, e Eclipse Help. O DITA Open Toolkit oferece técnicas e recursos de processamento e renderização para criar estas saídas.

Veja também:

- DITA Introduction and Authoring Workshop apresentação de Michael Priestley (em inglês)

- Lone DITA tutorial

- 5-minute DITA tutorial - introdução em Flash de Bob Doyle aos elementos topics, task, concept e reference da DITA, e a mapas DITA (em inglês)

- Eliot Kimber's Quick Start DITA Tutorial - vídeo de 90 minutos (em inglês)

- DITA Users Basic Tutorials

- DITA Users Getting Started - incluindo versões online do DITA Open Toolkit e do editor DITA Storm (em inglês)

- DITA Infocenter - conteúdo da DITA Language Specification, DITA Architecture Specifications e do Guia de Usuário do OT em formato de Help com três paineis, busca, índice e sumário (em inglês)

- Introduction to DITA, livro e tutorial completo, de Jennifer Linton e Kylene Bruski (em inglês)

 

See the source English version of this page.

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I