gnome-doc-utils GNOME-DOC-UTILS é uma coleção de utilitários de documentação para o projeto GNOME.
Baixe Agora

gnome-doc-utils Classificação e resumo

gnome-doc-utils Tag

GNOMO Utilitários do Gnome. documentação utilitários de documentação documentação do GNOME gnome-doc-utils

gnome-doc-utils Descrição

O GNOME-DOC-UTILS é uma coleção de utilitários de documentação para o projeto GNOME. Os pacotes GNOME-doc-Utils contêm uma coleção de utilitários de documentação para o projeto GNOME. Notavelmente, contém utilitários para a criação de documentação e todos os arquivos auxiliares em sua árvore de origem, e contém os formuladores de docbook XSLT que já foram distribuídos com o Yelp. Começando com o GNOME 2.8, o Yelp exigirá GNOME-doc-Utils para o XSLT.OrganizationTest / O diretório de teste contém um número de testes para Gnome-doc-Utils. Diretórios do formulário TestDocn, onde n é um inteiro positivo, são árvores de origem esqueleto contendo documentação, com o mesmo layout que seria usado por projetos reais. O diretório TestDocs contém os testes de unidade de docbook-testdocs, desenvolvidos pela NORM e Co. para os estilos de docbooks pan-galácticos. Um arquivo readme adicional é nesse diretório, dando instruções sobre a extensão ou alteração de qualquer um dos arquivos no diretório GNOME-doc-Utils CVS.DOC / O Diretório Doc Contém documentação para Gnome-doc-Utils. Na maioria dos casos, o GNOME-doc-utils é necessário para construir sua documentação. Os mecanismos estão em vigor para boottrapping.xslt / o diretório XSLT contém todos os XSLT em Gnome-doc-Utils. Notavelmente, o diretório XSLT / Docbook contém o XSLT / XSLT / GetText contém o utilitário XSLT GetText para traduzir texto automático. O diretório Sandbox / The Sandbox não é distinto, então ele só aparecerá se você tiver um checkout CVS. É um playground para novas ideias.xml2PO / O diretório XML2PO contém a ferramenta XML2PO desenvolvida pela Danilo Segan para tradução de formatos XML arbitrários. É usado pelo Gnome-doc-Utils for docBook tradução.Testingunder O diretório de teste é um número de testes para Gnome-doc-Utils. Para testar o sistema de compilação (gnome-doc-utils.m4 e gnome-doc-utils.make), você pode usar qualquer um dos diretórios TestDocn (para N a Positive Integer). Estes são configurados como árvores de fonte de esqueleto, comportando-se exatamente como um projeto real. Além disso, o GNOME-DOC-Utils usa-se para construir sua própria documentação (sob doc), portanto, o próprio GNOME-doc-Utils é um teste das ferramentas de construção. Para testar os estilos do docbook, use o diretório Test / TestDocs. Esses testes unitários são do pacote docbook-testdocs no docbook.sourceforge.net, desenvolvido por Norm e Co., simplesmente digitando essa diretório irá construir cada teste. Se o nome do arquivo de teste for foo.001.xml, a saída será HTML / FOO.001 / foo.001.html. Cada teste geralmente testa um pequeno número de elementos documentos relacionados. Muitas das características do docbook ou do XSLT em Gnome-doc-Utils podem não ser testadas por estes. Testes adicionais podem ser adicionados; Siga as instruções no teste / testdocs / readme para que isso é útil para testar o XSLT é transformar alguns documentos grandes usando-o. O Guia do Usuário do GNOME e o Manual Gnumérico servem como excelente teste docs.Hackingunlike a maioria das programações C, trabalhando em grande parte do GNOME-doc-Utils realmente envolvem melhorias incrementais isoladas. Não há como dar uma pequena lista de recursos amplos em uma lista de tarefas. Para trabalhar nas ferramentas de construção (Gnome-doc-Utils.m4 e Gnome-doc-Utils.Make), construa os documentos de teste e veja o que não trabalhos. Gnome-doc-Utils.Make tem uma lista de todos os alvos de alto nível que devem ser totalmente suportados. Para funcionar no docbook XSLT, encontrar um elemento que ainda não seja implementado e implementá-lo. Se você tiver XML Starlet (xmlstar.sourceforge.net) instalado, você poderá digitar "fazer Report.html" no diretório XSLT / docbook / HTML para obter um relatório HTML agradável sobre quais elementos são implementados. Há também um arquivo TDO neste diretório com uma lista muito sucinta de jogos que precisam ser feitos que não podem ser pegos pelo relatório.html.note que o XSLT está documentado em linha com o XSLDOC, que é em si uma parte do gnome- Doc-Utils. Sinta-se à vontade para trabalhar no XSLDOC também. A documentação gerada pelo XSLDOC está incluída no manual em Doc / XSLT.

gnome-doc-utils Software Relacionado