Category: Top » View » Spanish-48434

Cuando viene a los proyectos de la documentación, sobre todo técnico, médico, y científico, usar XML es un ningu'n-brainer. El pensamiento pesado viene al decidir qué sabor de XML para utilizar: DocBook o DITA (arquitectura que mecanografía de la información de Darwin). He sido un partidario firme de DocBook por más de seis años. intenté mi mano en DITA y la di para arriba como capricho; porciones de campanas y de silbidos, pero complicado también para integrar. ¿Y no podía DocBook hacer todo DITA prometido de todos modos?

Tan cuando los sistemas de Allette me entraron en contacto con para hablar en estándares de XML en SydneyAustralia, salté en la ocasión de probar al mundo de la documentación apenas cómo es DocBook maravilloso y cómo falta DITA. Afortunadamente, mi investigación profundizada se abrió los ojos en las ventajas y las limitaciones de ambos.

En una cáscara de nuez, DocBook tiene la ventaja de la edad; es establo, fácil setup, y creado para las publicaciones técnicas de la documentación. Mientras que DITA tiene la ventaja de la juventud; es innovador, completo con su propia arquitectura, y creado para la documentación fuera del libro. DocBook fue tramado en 1991 por los sistemas informáticos de HaL y O'Reilly. En 1998, el oasis dio a DocBook su propia comunidad técnica. Un año más adelante, DITA comenzó a desarrollarse de los equipos del cruz-departamento dentro de la IBM. Establecieron a su comunidad técnica del oasis en 2004.

Mi investigación y experimentación con estos dos estándares se resume en la tabla siguiente.

1. Definiciones

DocBook es un Document type definition (DTD) para los libros y los artículos técnicos de la escritura, con la estructura que tales formas implican.

DITA es un DTD y un sistema de las reglas para la documentación del contexto en línea de la escritura tal como archivos de la ayuda del software.

2. Conceptos

DocBook es jerárquico por la naturaleza, y se debe convertir para tener en cuenta solo-sourced DocBook contento hace un elemento y una cualidad fijos fijar.

DITA separa el contenido del contexto, permitiendo arquitecturas múltiples de la información DITA es extensible, permitiendo la definición de los tipos de información

3.Context

Docbook: libro (sección) orientado
DITA: asunto orientado

4. Características Dominantes

Docbook: sistema grande de elementos y de cualidades apuntados para la documentación técnica
DITA: asunto basado, separación del contenido y contexto, especialización

5. Transferencia directa e instalación

Docbook: palo, compartimiento, DTD, archivos del etc. y Ede capaces de funcionar con como es
DITA: palo, compartimiento, DTD, archivos del etc., y motor de la transformación

6. Archivo De Documento

Docbook: archivo regular de XML llamado un archivo del incluido con todos archivos incluido en el documento
DITA: archivo del ditamap con todos los archivos y acoplamientos relacionados de cada archivo

7. Salida

Docbook: Pdf, HTML, HTMLHelp
DITA: sin restricción, pero todo desarrollo de la necesidad

8. Comunidad

Docbook: pozo apoyado por la comunidad de XML
DITA: comunidad pequeña pero fuerte, cada vez mayor

9. Complejidad

Docbook: con un poco desarrollo, DocBook puede hacer qué DITA está procurando en una escala más pequeña
DITA impresionante se dirige, pero puede ser también industrial-fuerza

10. Necesidades Posibles

Docbook: Sistema De Gerencia Contento
DITA: Plug-ins que publican

DocBook se apoya bien, fácil integrar, y se adapta a las necesidades técnicas de la documentación. DITA tiene una comunidad altamente técnica, innovadora, la lata (con el desarrollo) publica a todos los formatos en línea, y viene con su propia arquitectura (gerencia contenta).

¿Tan cómo usted decide? Bien, las buenas noticias son DocBook y DITA son absolutamente similares en piezas elementales básicas y etiquetas de XML. Por ejemplo, DocBook se construye en las secciones, que se pueden comparar a los asuntos de DITA, según lo demostrado en la figura abajo (véase la imagen en http://www.livetechdocs.com/blog/wp-content/uploads/2007/12/04_DBvDITAStructure.png).

¿Por qué son estas buenas noticias? Porque compañías más pequeñas, o ésas nuevas a XML, usted comienzan con DocBook y gradúan a DITA cuando y si están necesitadas.
Las comunidades en línea (documento abierto del oasis) y las compañías (soluciones de Flatiron) están procurando ya facilitar compatibilidad entre estos dos estándares.

La tabla abajo puede ayudarle decidía a qué estándar correcto para usted y su compañía hoy.

1. Volumen de la documentación

Docbook: pequeño y medio
DITA: grande

2. Salida de la documentación

Docbook: Pdf, HTML, HTMLHelp, otros con el desarrollo
DITA: todos con el desarrollo

3. Marco de tiempo básico de integración (ninguna conversión)

Docbook: un día laboral
DITA: un mes más

4. Presupuesto

Docbook: pequeño-medio
DITA: medio a grande

Estoy siempre interesado en sus comentarios y experiencias, especialmente si diferencian el mía. Siéntase por favor animado para comentar respecto a este blog (www.livetechdocs.com/blog), o envíeme un email teresa.mulvihill@livetechdocs.com.

Sobre el autor

Con sobre once años de experiencia en comunicaciones técnicas, Teresa Mulvihill tiene una amplia gama de la experiencia en la documentación, incluyendo el hardware, el software, y la seguridad de la red. Su maestría miente en desarrollar las soluciones que publican de XML para las compañías de todos los tamaños. Teresa Mulvihill también fundó LiveTechDocs, un servicio en línea de la colaboración para la documentación. Web site: LiveTechDocs Seed Newsvine

Este artículo ha sido traducido automáticamente de la fuente Inglés.