Capítulo 8. Perguntas e respostas

8.1. Como eu insiro vários autores?
8.2. Eu posso modificar a aparência da página impressa?
8.3. Como eu agrupo por uma propriedade que não esteja listada na barra de ferramentas?
8.4. Porque aparece tanto lixo quando rodo o Tellico?
8.5. Como eu altero as colunas que são apresentadas?
8.6. Como eu filtro por algo, como o campo "Lido"?
8.7. Como eu 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 está errado?
8.9. Como eu exporto os campos adicionais do Bibtex?
8.10. O que aconteceu ao Bookcase?
8.11. De onde veio o nome Tellico?
8.12. Porque você inclui as referências à Amazon.com nos resultados da pesquisa?
8.13. Porque você não usou um banco de dados real?

8.1.

Como eu insiro 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 inseridas da mesma forma, com um ponto e vírgula (;) separando cada um dos valores.

8.2.

Eu posso modificar a aparência da página impressa?

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

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

8.3.

Como eu 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 padrão, assinale a opção "Permitir o Agrupamento", para esse campo em particular, na janela de "Campos da Coleção".

8.4.

Porque aparece tanto lixo quando rodo 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. No momento da compilação, isso pode ser interrompido com a opção --disable-debug. Você 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 de que o "0 (generic)" está desligado. Isso desliga todas as mensagens de depuração para todos os aplicativos genéricos do KDE, isto é, os que não são distribuídos oficialmente pelo KDE.

8.5.

Como eu altero as colunas que são apresentadas?

Clique com o botão direito na barra do cabeçalho. Você poderá também arrastar os cabeçalhos para reordenar as colunas, clicando depois nelas para ordenar por esse campo.

8.6.

Como eu 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 você terá duas regras. Certifique-se de que a opção "Corresponder a todos os seguintes" está ativa. 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 caracter 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 eu adiciono novos modelos de itens?

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

Os modelos para a Janela de Relatórios estão salvos 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 está errado?

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 arquivos que necessita. Isto acontece principalmente no SuSE; nesse caso, você deverá compilar com --prefix=/opt/kde3. Em alternativa, poderá adicionar uma linha ao seu arquivo .profile que configure a variável $KDEDIRS. Veja a documentação sobre a sua linha de comando.

8.9.

Como eu exporto os campos adicionais do Bibtex?

O Tellico usa a propriedade bibtex para saber como exportar os campos do Bibtex. Se você quiser adicionar campos extra à exportação, como um resumo, abra a Janela de Campos da Coleção e clique no botão Propriedades Estendidas. 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 registradas, 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, excetuando a mudança no nome.

8.11.

De onde veio o nome Tellico?

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

8.12.

Porque você 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 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 feitos.

8.13.

Porque você não usou um banco 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 naquela época e, atualmente, só possui um conhecimento vago de como usá-lo. Em resumo, o Tellico não começou como um banco 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.