Obtendo GTK-Doc
- 1.3.1. Requisitos
- 1.3.2. Instalação
1.3.1. Requisitos
Perl v5 - os scripts principais são Perl.
DocBook DTD v3.0 - Este é o DocBook SGML DTD. http://www.ora.com/davenport
Jade v1.1 - Este é um processador de DSSSL para conversão de SGML para vários formatos. http://www.jclark.com/jade
Folhas de estilo modulares do DocBook Este é o código DSSSL para converter DocBook para HTML (e alguns outros formatos). É usado junto com jade. Eu personalizei um pouco o código DSSSL, em gtk-doc.dsl, para colorir as listagens/declarações do código do programa e para dar suporte a índices de referências cruzadas globais nos HTML gerados. http://nwalsh.com/docbook/dsssl
docbook-to-man - se você deseja criar páginas man a partir do DocBook. Eu personalizei um pouco a "especificação de tradução", para deixar o título em caixa alta e adicionar o título "GTK Library" no topo das páginas e a data de revisão no canto inferior. Há também um link para isso em http://www.ora.com/davenport. NOTA: isso não funciona ainda.
1.3.2. Instalação
Não há um lugar padrão onde as folhas de estilos modulares de DocBook são instaladas.
O script de configuração do GTK-DOC pesquisa por esses três diretórios automaticamente:
/usr/lib/sgml/stylesheets/nwalsh-modular (usado pelo RedHat)
/usr/lib/dsssl/stylesheets/docbook (usado pelo Debian)
/usr/share/sgml/docbkdsl (usado pelo SuSE)
Se você tiver as folhas de estilos instaladas em algum lugar, você precisa configurar o Gtk-Doc usando a opção: --with-dsssl-dir=<CAMINHO_PARA_DIRETÓRIO_RAIZ_DAS_FOLHAS_DE_ESTILO>