J.5. Redacción de la documentación #

J.5.1. Emacs

Las fuentes de la documentación se modifican más cómodamente con un editor que tenga un modo para editar XML, y aún más si tiene conocimiento de los lenguajes de esquema XML para que pueda reconocer la sintaxis específica de DocBook.

Ten en cuenta que, por razones históricas, los archivos fuente de la documentación se nombran con la extensión .sgml aunque ahora sean archivos XML. Por lo tanto, es posible que debas ajustar la configuración de tu editor para establecer el modo correcto.

J.5.1. Emacs #

El modo nXML Mode, que viene incorporado con Emacs, es el modo más común para editar documentos XML con Emacs. Te permitirá usar Emacs para insertar etiquetas y verificar la consistencia del marcado, y es compatible con DocBook por defecto. Consulta el manual de nXML para obtener documentación detallada.

src/tools/editors/emacs.samples contiene las configuraciones recomendadas para este modo.