Capítulo 8. Perguntas e Respostas

8.1. Como é que introduzido vários autores?
8.2. Posso modificar a aparência da página impressa?
8.3. Como é que agrupo por uma propriedade que não esteja listada na barra de ferramentas?
8.4. Porque é que aparece tanto lixo quando corro o Tellico?
8.5. Como é que altero as colunas que são apresentadas?
8.6. Como é que filtro por algo, como o campo "Lido"?
8.7. Como é que adiciono novos modelos de itens?
8.8. A compilação e a instalação correram bem; porém, quando o Tellico é iniciado, a janela aparece em branco. O que se passou?
8.9. Como é que exporto os campos adicionais do Bibtex?
8.10. O que aconteceu ao Bookcase?
8.11. Com o que é que o Tellico tem a ver?
8.12. Porque é que inclui as referências à Amazon.com nos resultados da pesquisa?
8.13. Porque é que não usou uma base de dados real?

8.1.

Como é que introduzido vários autores?

Os nomes dos autores deverão ser separados por ponto-e-vírgula, como o seguinte: Brian W. Kernighan; Dennis M. Ritchie. Não inclua a palavra "and" (e) ou algo semelhante, mesmo que tenha 20 autores. Se tiver a opção de formatação automática, assinalada, então será apresentado o último nome em primeiro lugar para cada autor.

As outras propriedades que permitem valores múltiplos, como o "género" e as "palavras-chave", são introduzidas da mesma forma, com um ponto-e-vírgula (;) a separar cada um dos valores.

8.2.

Posso modificar a aparência da página impressa?

Sim, claro que sim. Descubra o ficheiro tellico-printing.xsl, que deverá estar na pasta $KDEDIR/share/apps/tellico/. Podê-lo-á copiar para $KDEHOME/share/apps/tellico/ para as suas modificações pessoais. Terá de saber XSLT, mas a modificação desse ficheiro é a forma como irá mudar a disposição da impressão. É gerado HTML a partir do ficheiro, e a forma mais simples de alterar a aparência da impressão é modificar o CSS na secção de topo.

Lembre-se que o ficheiro tellico-printing.xsl faz referência a outro ficheiro, o tellico-common.xsl, que contém alguns modelos comuns em XSLT. Se copiar o ficheiro tellico-printing.xsl para o $KDEHOME, deverá então modificar o elemento <xsl:import> para apontar para a localização actual do ficheiro tellico-common.xsl ou copie o ficheiro comum também.

8.3.

Como é que agrupo por uma propriedade que não esteja listada na barra de ferramentas?

Para permitir agrupar por um campo que não permita agrupamentos por omissão, assinale a opção "Permitir o Agrupamento", para esse campo em particular, na janela de "Campos da Colecção".

8.4.

Porque é que aparece tanto lixo quando corro o Tellico?

Se aparecer algo do tipo:

Tellico::updateCollectionToolBar
GroupView::setGroupAttribute - author
GroupView::slotAddCollection
QCheckBox::property( "title" ) failed: property invalid
or does not exist

, isso é informação de depuração. Na altura de compilação, isso pode ser interrompido com a opção --disable-debug. Poderá também querer usar a opção --enable-final, o que irá ocupar um pouco mais de memória na compilação, mas que será mais eficiente ao executar a aplicação.

A última mensagem é ligeiramente diferente; simplesmente significa que a sua instalação do Qt™ foi compilada com alguma informação de depuração.

Ou, caso o Tellico já esteja instalado, execute kdebugdialog e certifique-se que o "0 (generic)" está desligado. Isso desliga todas as mensagens de depuração para todas as aplicações genéricas do KDE, isto é, as que não são distribuídas oficialmente pelo KDE.

8.5.

Como é que altero as colunas que são apresentadas?

Carregue com o botão direito na barra do cabeçalho. Poderá também arrastar os cabeçalhos para reordenar as colunas, carregando depois nelas para ordenar por esse campo.

8.6.

Como é que filtro por algo, como o campo "Lido"?

Internamente, os campos de opções de marcação são guardados como "true" (verdadeiro) no Tellico; por isso, se quiser filtrar para mostrar apenas os livros de ficção científica que ainda não leu, por exemplo, então terá duas regras. Certifique-se que a opção "Corresponder a todos os seguintes" está activa. Configure a primeira regra para ter "Género" "contém" "Ficção Científica" (sem as aspas) e a segunda regra configurada como "Lido" "não contém" "true" (sem as aspas).

Do mesmo modo, o filtro rápido na barra de ferramentas irá corresponder a qualquer campo e, se existir um carácter que não faça parte de uma palavra, o texto é interpretado como uma expressão regular. Por isso, se quiser filtrar rapidamente os seus livros para mostrar os que pertençam a Weber ou Bujold, então escreva "weber|bujold" (sem as aspas) na barra de ferramentas.

8.7.

Como é que adiciono novos modelos de itens?

Os modelos dos itens deverão ser gravados em $KDEHOME/share/apps/tellico/entry-templates/, para ficarem acessíveis para um único utilizador, ou em $KDEDIR/share/apps/tellico/entry-templates/ para ficar acessível para todos. Os modelos em $KDEHOME sobrepor-se-ão aos ficheiros com o mesmo nome em $KDEDIRS. Os modelos de itens poderão ser definidos, por tipo de colecção, na janela de configuração.

Os modelos para a Janela de Relatórios estão gravados em $KDEHOME/share/apps/tellico/report-templates/.

8.8.

A compilação e a instalação correram bem; porém, quando o Tellico é iniciado, a janela aparece em branco. O que se passou?

Os programas do KDE procuram por dados nos locais definidos na variável de ambiente $KDEDIRS. Se instalar na /usr/local por exemplo, mas se a variável $KDEDIRS estiver em branco ou com /usr, então o Tellico não irá conseguir encontrar os ficheiros que necessita. Isto acontece principalmente no SuSE; nesse caso, deverá compilar com --prefix=/opt/kde3. Em alternativa, poderá adicionar uma linha ao seu ficheiro .profile que configure a variável $KDEDIRS. Veja a documentação sobre a sua linha de comandos.

8.9.

Como é que exporto os campos adicionais do Bibtex?

O Tellico usa a propriedade bibtex para saber como exportar os campos do Bibtex. Se quiser adicionar campos extra à exportação, como um resumo, abra a Janela de Campos da Colecção e carregue no botão Propriedades Extendidas. Adicione uma propriedade bibtex com o valor abstract. Depois, quando exportar para 'bibtex' ou 'bibtexml', essa propriedade será usada para o nome do campo 'bibtex'.

8.10.

O que aconteceu ao Bookcase?

Devido a um conflito de marcas registadas, o Bookcase mudou de nome para Tellico em Setembro de 2004. O Tellico 0.12 foi então lançado, sendo idêntico ao Bookcase 0.11, exceptuando a mudança no nome.

8.11.

Com o que é que o Tellico tem a ver?

O autor pensou em diversos nomes, sendo alguns deles relacionados com colecções de livros. Contudo, o Tellico pode lidar com mais do que apenas livros; para além disso, isto é um passatempo, pelo que o autor escolheu um nome que lhe soasse bem, retirado de uma cidade próxima do local onde cresceu.

8.12.

Porque é que inclui as referências à Amazon.com nos resultados da pesquisa?

O termos do acordo de acesso aos Serviços Web da Amazon.com obrigam a que todas as imagens obtidas do serviço sejam referenciadas de volta à Amazon.com, assim como a possuir uma ligação adicional. O ID de sócio da Amazon.com é incluído por necessidade, para que todos os pagamentos de referência sejam devidamente pagos.

8.13.

Porque é que não usou uma base de dados real?

Uma das razões pelas quais o Tellico foi iniciado foi a aprendizagem de C++. O autor não sabia nada sobre SQL na altura e, de momento, só possui um conhecimento vago de como o usar. Em resumo, o Tellico não começou como uma base de dados relacional, e isso não irá mudar até que o autor aprenda SQL e tenha o tempo e motivação para modificar o modelo de dados. Se isso o incomodar, então não use o Tellico.

Obviamente, toda a ajuda é bem-vinda para fazer as alterações necessárias ao código-fonte para o efeito.