Diff for Primeiros passos
Tue, 2009-07-14 20:01 by mcotrim | Tue, 2009-07-14 20:06 by mcotrim | ||
---|---|---|---|
Portuguese translation of page "Getting started". | Link correction at first paragraph. | ||
Changes to Body | |||
Line 8 | Line 8 | ||
A elaboração de conteúdo baseado em tópicos é a base da arquitetura
| A elaboração de conteúdo baseado em tópicos é a base da arquitetura
| ||
DITA. Para compreender a melhor abordagem para a DITA, primeiro
| DITA. Para compreender a melhor abordagem para a DITA, primeiro
| ||
- | compreenda o que é [[Conteúdo baseado em tópicos|conteúdo baseado em
| + | compreenda o que é <a href="/freelinking/Conte%25C3%25BAdo%2520baseado%2520em%2520t%25C3%25B3picos">conteúdo baseado em
|
- | tópicos]] e escrita estruturada.
| + | tópicos</a> e escrita estruturada.
|
</p>
| </p>
| ||
</li>
| </li>
| ||
Line 28 | Line 28 | ||
<li>
| <li>
| ||
<p>
| <p>
| ||
- | Descrições de <em>Unidades de Conteúd</em>
| + | Descrições de <em>Unidades de Conteúdo</em>
|
</p>
| </p>
| ||
</li>
| </li>
|
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)
- 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 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.