gnome-doc-utils

gnome-doc-utils pacotes contém uma coleção de utilitários de documentação para o projeto Gnome. Notavelmente, ele contém utilitários para a construção de documentação e todos os arquivos de apoio em sua árvore de origem, e que contém as folhas de estilo XSLT DocBook que já foram distribuídos com Yelp. Começando com o GNOME 2.8, Yelp exigirá gnome-doc-utils para o XSLT. Teste

ORGANIZAÇÃO
/
O diretório de teste contém uma série de testes para gnome -doc-utils. Diretórios do testdocn formulário, onde n é um inteiro positivo, são árvores de origem esqueleto contendo a documentação, com a mesma disposição que seria usado por projetos reais. O diretório testdocs contém os testes de unidade de docbook-testdocs, desenvolvidos por Norm and Co. para os pan-galácticos de estilo DocBook. Um arquivo README adicional é nesse diretório, dando instruções sobre como prolongar ou alterar qualquer um dos arquivos em gnome-doc-utils CVS.
Doc /
O diretório doc contém a documentação para gnome-doc -utils. Na maioria dos casos, é necessário gnome-doc-utils para construir sua documentação. Existem mecanismos para bootstrapping.
XSLT /
O diretório XSLT contém todo o XSLT em gnome-doc-utils. Notavelmente, o diretório XSLT / docbook contém o DocBook XSLT, e XSLT / gettext contém o utilitário XSLT gettext para traduzir o texto automático.
Sandbox /
O diretório sandbox não é DISTed, por isso vai só aparecem se você tem um check-out CVS. É um parque infantil para as novas idéias.
Xml2po /
O diretório xml2po contém a ferramenta xml2po desenvolvido por Danilo Segan para tradução de formatos XML arbitrários. Ele é usado por gnome-doc-utils para tradução DocBook.
TESTE

Sob o diretório teste de uma série de testes para gnome-doc-utils. Para testar o sistema de construção (gnome-doc-utils.m4 e gnome-doc-utils.make), você pode usar qualquer um dos testdocn (para na inteiros positivos) diretórios. Constituídas, árvores de origem como esqueleto, comportando-se exatamente como um verdadeiro projeto faria. Além disso, gnome-doc-utils usa-se a construir a sua própria documentação (sob doc), de modo gnome-doc-utils em si é um teste das ferramentas de compilação.
Para testar as folhas de estilo DocBook, utilize o test / diretório testdocs. Estes testes de unidade são do pacote docbook-testdocs em docbook.sourceforge.net, desenvolvido por Norm and Co. Basta digitar fazer nesse diretório irá construir cada teste. Se o nome do arquivo de teste é foo.001.xml, a saída será html / foo.001 / foo.001.html. Cada teste geralmente testa um pequeno número de elementos DocBook relacionados. Muitas das características de DocBook ou do XSLT no gnome-doc-utils não pode ser testada por estes. Podem ser adicionados testes adicionais; siga as instruções no test / testdocs / README para isso.
Também é útil para testar a XSLT é transformar algumas grandes documentos usando ele. O Guia do Usuário do Gnome e do Manual Gnumeric ambos servem como excelentes docs teste.
HACKING
Ao contrário da maioria de programação C, trabalhando em grande parte do gnome-doc-utils realmente envolver isolado melhorias incrementais. Não há nenhuma maneira de dar uma pequena lista de características gerais em uma lista TODO.
Para trabalhar nas ferramentas de compilação (gnome-doc-utils.m4 e gnome-doc-utils.make), construir a docs de teste e ver o que não funciona. gnome-doc-utils.make tem uma lista de todos os alvos de alto nível que deve ser totalmente suportados.
Para trabalhar na DocBook XSLT, encontrar um elemento que ainda não está implementado e implementá-lo . Se você tiver Starlet XML (xmlstar.sourceforge.net) instalado, você pode digitar "fazer report.html 'no XSLT / docbook / html diretório para obter
um relatório HTML agradável sobre os elementos que são implementadas. Há também um arquivo TODO neste diretório com uma lista muito sucinta de partidas que precisam ser feitas, que não pode ser capturado por report.html.
Note que o XSLT está documentado em linha com xsldoc, que é em si uma parte do gnome-doc-utils. Sinta-se livre para trabalhar em xsldoc também. A documentação gerada por xsldoc está incluído no manual sob doc / XSLT

O que é novo nesta versão:.

• Fixa problemas com dist e instalar com muitos arquivos
• traduções Atualizado:
• km (Morn Met)

O que é novo na versão 0.20.9:

• Temporariamente acrescentando RNG arquivos de volta para compatibilidade. Agora que os arquivos de RNG já não são chamados (a partir de 0.20.8), as limas RNG vai ser removido novamente após um período de transição.

O que é novo na versão 0.20.6:

• Atualizado esquema Mallard
• Fixo 'fazer pot' regra para Mallard
• traduções Atualizado:
• ca (Jordi Serratosa)
• es (Jorge González, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

O que é novo na versão 0.20.5:

• Atualizado arquivos Mallard RNG
• traduções Atualizado:
• como (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• Eo (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• ou (Manoj Kumar Giri)

O que é novo na versão 0.20.3:

• substituição de comando aninhado fixo em gnome-doc-utils .make (Chris Coleman)
• traduções Atualizado:
• ca @ valencia (Carles Ferrando)
• de (Christian Kirbach)
• de (Mario Blattermann)
• el (Michael Kotsarinis)
• es (Jorge Gonzalez)
• et (Ivar Smolin)
• fa (Mahyar Moghimi)
• fr de (Bruno Brouard)
• gl (Fran Dieguez)
• sl (Matej Urbancic)
• ug (Gheyret T.Kenji)

O que é novo na versão 0.20.2:

• traduções Atualizado:
• de (Mario Blattermann)
• en @ Shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• gl (Fran Dieguez)
• ele (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki Kusano)
• lv (Rudols Mazurs)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)