Modificar o TellicoÍndice
Segundo o espírito do 'Software' Livre, você é bem-vindo para modificar o Tellico tanto quanto desejar. Você poderá criar programas para importar, exportar ou modificar os dados com muita facilidade. Este capítulo fornece mais informações sobre como fazer isso.
O arquivo de dados padrão do Tellico é um pacote ZIP, normalmente com uma extensão de arquivos .tc. Dentro do pacote, existe um arquivo de topo tellico.xml. As imagens poderão ser incluídas dentro da pasta images/ do pacote, podendo também ser incluídas diretamente no XML, com uma codificação 'base64'. As imagens poderão também ser salvas dentro da pasta de dados da aplicação; nesse caso, não estarão no arquivo de dados. O Tellico também pode carregar o arquivo XML propriamente dito, no formato não-comprimido.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE tellico PUBLIC "-//Robby Stephenson/DTD Tellico V11.0//EN" "http://periapsis.org/tellico/dtd/v11/tellico.dtd"> <tellico xmlns="http://periapsis.org/tellico/" syntaxVersion="11"> <collection title="Meus Livros" type="2"> </collection> </tellico>
O arquivo começa com a declaração e codificação obrigatória do XML, seguida do tipo de documento. Quando for adicionado um novo tipo de campo ou forem definidas propriedades adicionais nos campos predefinidos, a versão da DTD para o tipo de documento será incrementada. O Tellico será sempre capaz de abrir e ler qualquer versão anterior da DTD, mas só irá salvar os arquivos na versão atual. A localização da DTD aponta de fato para um arquivo de DTD atual.
O elemento de topo é um <tellico>, que contém a declaração do espaço de nomes padrão e a versão da sintaxe do arquivo, que deverá corresponder sempre à DTD.
O elemento <tellico> contém um elemento <collection>. São ignoradas várias coleções, por enquanto. O atributo title contém o título da coleção, enquanto o type define os tipos de itens que estão contidos na coleção. Os tipos permitidos são apresentados numa seção posterior. Existe um atributo entryTitle opcional que poderá ser usado para definir o título dos itens numa coleção personalizada, devendo estar no plural.
<fields>
<field flags="8" title="Título" category="Geral" format="1" type="1" name="titulo" />
<field flags="7" title="Autor" category="Geral" format="2" type="1" name="autor" />
<field flags="2" title="Formato" category="Geral" allowed="Capa Dura;Capa de Papel;Capa de Papel Comercial;E-Book;Revista;Jornal" format="4" type="3" name="formato" >
<prop name="default"
>Revista</prop>
</field>
<field flags="6" title="Publicação" category="Publicação" format="0" type="1" name="publicacao" />
<field flags="4" title="Edição" category="Publicação" format="0" type="1" name="edicao" />
<field flags="3" title="Ano do 'Copyright'" category="Publicação" format="4" type="6" name="ano_copyright" />
<field flags="2" title="Ano de Publicação" category="Publicação" format="4" type="6" name="ano_publicacao" />
<field flags="0" title="ISBN#" category="Publicação" format="4" type="1" name="isbn" description="International Standard Book Number" />
<field flags="7" title="Gênero" category="Classificação" format="0" type="1" name="genero" />
<field flags="7" title="Palavras-Chave" category="Classificação" format="0" type="1" name="palavraschave" />
<field flags="0" title="Capa" category="Capa" format="4" type="10" name="capa" />
<field flags="0" title="Comentários" category="Pessoal" format="4" type="1" name="comentarios" />
<field title="Classificação" flags="2" category="Pessoal" format="4" type="14" name="classificacao">
<prop name="maximum"
>5</prop>
<prop name="minimum"
>1</prop>
</field>
<field title="ID" flags="32" category="Pessoal" format="4" type="6" name="id">
<prop name="template"
>%{@id}</prop>
</field>
</fields>
Todos os campos são definidos dentro de um elemento <fields>, nos quais só poderá existir um. Toda a informação de um campo, exceto as propriedades estendidas, são incluídas como atributos do elemento <field>. Os valores permitidos para os atributos flags, format e type são fornecidos na seguinte seção.
As propriedades dos campos são usadas para definir os valores padrão para os campos, os intervalos dos valores de classificações, os modelos dos valores derivados, etc. Os exemplos acima incluem um valor padrão, um valor máximo de classificação e um modelo para um campo de ID derivado.
<entry>
<title
>A Linguagem de Programação C++</title>
<authors>
<author
>Stroustrup, Bjarne</author>
</authors>
<publisher
>Addison-Wesley Pub Co</publisher>
<edition
>3a</edition>
<pub_year
>1997</pub_year>
<isbn
>0-201-88954-4</isbn>
<genres>
<genre
>Não-Ficção</genre>
</genres>
<keywords>
<keyword
>Programação</keyword>
<keyword
>Computadores</keyword>
</keywords>
<cover
>cf65a2f023b6cb9e9233323dca10ac7c.jpeg</cover>
</entry>
Para cada um dos campos da coleção, existe um <entry> que poderá conter um elemento, cujo nome é idêntico ao nome do campo. Se forem permitidos vários valores para o campo, então será adicionada a letra s ao nome do campo, ao criar um elemento, e cada um dos valores é adicionado como um filho do elemento, como acontece no caso dos campos 'author', 'genre' e 'keyword' acima.
Como resultado, se forem adicionados campos extras à coleção, o arquivo de dados já não ficará mais em conformidade com a DTD. Contudo, o Tellico usa um processador de XML sem validação, assim os campos adicionais não causam problemas.
<images> <image width="111" format="JPEG" height="140" id="cf65a2f023b6cb9e9233323dca10ac7c.jpeg" /> </images>
Dentro do elemento <images>, é enumerada cada uma das imagens referenciadas por um elemento, em conjunto com os atributos que descrevem o tamanho, o formato e o identificador da imagem. Se a imagem estiver contida dentro do arquivo ZIP, o elemento está em branco. Caso contrário, os dados da imagem poderão estar contidos na sequência de XML, sob o formato de texto codificado em base64.