TeXifsc

Esta página pessoal contem informações de minha classe de LaTeX gerada para atender a maior parte das normas requeridas pela ABNT e pela Biblioteca do IFSC. Estou montando um demonstrativo desta classe, a versão atual pode ser encontrada aqui. O código todo está disponível abaixo.

NOTÍCIA 03/12/2013 - estou passando esta pasta para um servidor de versão que estará aberto a todos! Isso deve ocorrer até dia 06/12/2013. A versão será mais atual que a disponível abaixo, portanto sugiro que aguarde alguns dias.

É importante comentar que a II SIFSC abriu espaço para que este pacote se torna-se mais amplamente conhecido no instituto.

Importante: esta classe pode não atender a todas as regras atuais (por exemplo, por estar desatualizada) e não posso garantir assistência a todos. Use-a sabendo disso. No entanto, qualquer pessoa com algum conhecimento mais profundo de LaTeX poderá ser capaz de lhe ajudar a arrumar uma coisa ou outra.

Do que se trata?

O LaTeX é um sistema para preparação de documentos para composição de alta-qualidade. Não se trata de um processador de texto (como o Open Office Writer ou o Microsoft Word). É exatamente o contrário: a ideia é que usuário não se preocupe com a aparência do documento, mas sim com o conteúdo.

A ideia básica é a de uma linguagem de marcação: você identifica o tipo do documento (artigo, livro, tese, relatório), o título, autores, etc, tudo em campos separados. Ao chamar o LaTeX, um processador reune as informações e cruza tudo para que saia um documento seguindo as normas que regem o tipo definido e com o conteúdo descrito. Por exemplo, a American Physical Society (APS) disponibiliza um tipo de documento próprio para suas revistas, o revtex. Com ele, é muito simples gerar um artigo com o look and feel dos jornais da APS (para mais detalhes, veja este artigo).

Ao escrever uma tese, o ideal seria focar-se na ciência, não em formatações. Por isso muitas universidades têm modelos LaTeX que atendem a todas as exigências de suas respectivas agências de normas. No IFSC, aparentemente existem algumas tentativas de se fazer isso, e este pacote é uma delas. Fiz durante minha dissertação de mestrado e resolvi disponibilizá-la para que isso não se perca a toa. O grande propósito deste pacote é que você possa dizer "quero escrever uma tese do IFSC" e o LaTeX já consiga formatar tudo pra você. Vale comentar que baseei meus códigos no ABNTeX.

Os desenvolvimentos são feitos em contato com o Serviço de Biblioteca e Informação Prof. Bernhard Gross, especificamente com Maria Cristina C. Dziabas e Ana Mara M. C. Prado. Infelizmente não tenho tempo de atualizar constantemente este pacote. Por isso, se você utilizá-lo e tiver soluções que eu não fui capaz de implementar, entre em contato!! Disponibilizarei imediatamente suas soluções para todos!

Voltar ao topo

Facilidade de uso

Vou comentar rapidamente qual a minha ideia de uma classe que realmente seja boa e o que de fato está implementado. Para ficar mais organizado, comentarei aspectos gerais primeiramente e, em seguida, falarei sobre referências (BibTeX). A ideia não é introduzir ao LaTeX de uma forma geral, mas tentarei fazer o texto o mais básico quanto possível.

LaTeX

Como comentei na seção Do que se trata?, a ideia do LaTeX como uma linguagem de marcação é que você coloque em um lugar o texto indexado de uma forma inteligente, e em outro lugar defina como cada parte do texto deve ser formatada. O que define essas formatações de forma primordial é a classe do documento, definida na primeira linha do seu arquivo LaTeX. Como esta classe chama-se ifsc, a primeira linha do documento será algo próximo de

\documentclass[OPÇÕES]{ifsc}

Em "OPÇÕES" geralmente se usam definições específicas que podem mudar com o tempo e, portanto, preferi deixar livres. No arquivo exemplo, eu usei:

\documentclass[a4paper, espaco=emeio, dvips, ruledheader, twoside, openright, final, normalfigtabnum, tocpage=plain]{ifsc}

A menos que você queira mudar algo e saiba o que está fazendo, a ideia seria não mexer nessa parte.

A primeira parte de uma tese é a capa, resumos, agradecimentos, lista de tabelas, figuras, etc. Isso também será montado pelo próprio LaTeX já seguindo os padrões exigidos pela ABNT e pela bibioteca. Dentre os arquivos de exemplo da classe, existe um arquivo chamado titlepage.tex em que definem-se todas informações necessárias para a montagem da seção inicial, parecido com o seguinte:

\autor{Seu nome}

\titulo{Título da sua tese}

\orientador{Prof. Dr. Nome do Seu Orientador}

\area{Física Básica}

Veja abaixo o resultado (pulando páginas em branco):

Estas páginas são colocadas já à direita automaticamente, deixando folhas em branco sempre que necessário. O resumo é bem semelhante e pode ser visto no arquivo resumo.tex, tanto a versão em português como a versão em inglês. Note que o texto aleatório usado para o resumo passa de uma página, e mesmo assim a abertura mantém-se na página impar automaticamente.

De resto, qualquer pessoa que conhece o mínimo de LaTeX poderá entender sozinho, basicamente será escrever um documento normalmente. Sugiro partir dos arquivos exemplo e ir adicionando o conteúdo, alterando as informações da tese para as suas próprias (título, autor, etc). O próximo passo é como fazer referências da forma correta. Para tal, preparei também um programinha que poderá usar referências armazenadas no formato BibTeX e gerará o formato correto.

Bibtex

O BibTeX (http://www.bibtex.org) é um formato para indexar referências discriminando todos os campos necessários para que a citação obedeça um dado sistema de referenciamento. O que exatamente significa? Ao ler um artigo ou livro, o(s) autor(es) pode(m) fazer referências a outros trabalhos. Ao final da obra, temos acesso à lista de referências. Cada uma destas entradas tem que conter todas as informações para que qualquer pessoa possa encontrar de forma certeira a obra que foi referenciada. No caso de artigos, para a maioria das revistas só são necessários, além do nome da revista, o volume e a numeração da primeira página (veja por exemplo a Physical Review Letters, canto direito superior). Veja um exemplo de artigo em bibtex:

@ARTICLE{PhysRevB.76.195439,
author = {Rusin, Tomasz M. and Zawadzki, Wlodek},
title = {Transient Zitterbewegung of charge carriers in mono- and bilayer graphene, and carbon nanotubes},
journal = {Physical Review B},
year = {2007},
volume = {76},
pages = {195439-1--195439-7},
number = {19},
doi = {10.1103/PhysRevB.76.195439},
numpages = {7},
publisher = {American Physical Society}
}

No entanto, a forma como essas informações serão descritas é de livre escolha dos editores. E o BibTeX serve exatamente para que o trabalho de por suas referências no formato correto de cada jornal ou instituição não seja seu, mas sim do computador: uma vez que as regras são definidas, constroi-se um programa que pega as entradas do BibTeX e as processa da forma como o editor desejar. No caso de teses seguindo as normas da ABNT, temos um conjunto de regras bem definidas para isso, mas não consegui encontrar um programa assim específico. Daí a ideia de desenvolvê-lo. Veja como fica a saída se citamos esta referência usando \cite{PhysRevB.76.195439}:

Referência de exemplo para formatação.

A numeração é automática, a ordenação "Sobrenome, Nome" também, a separação em ";", supressão dos Nomes apenas nas iniciais, transformação para letras maiúsculas, etc, é tudo automático. Vamos supor que você precise então publicar em um jornal que não segue esse modelo? Você não precisará mudar o a entrada do BibTeX, bastará você usar o modelo fornecido pela revista que tudo será modificado da forma apropriada.

Para criar essas entradas, você pode (i) montar a partir de um exemplo ou (ii) baixar a entrada diretamente do jornal (geralmente disponíveis em links "download to manager" ou "download citation"), o que é bastante prático. Diversos jornais grandes (e pequenos) oferecem como opção de exportação o BibTex, assim como gerenciadores de referências gratuitos (JabRef, Mendeley, etc) e pagos.

Voltar ao topo

Exemplos de uso desta classe

Veja algumas das teses que foram escritas usando esta classe:

Voltar ao topo

Download

Estou montando um demonstrativo desta classe, a versão atual pode ser encontrada aqui. Uma lista de versões abaixo:

NOTÍCIA 03/12/2013 - estou passando esta pasta para um servidor de versão que estará aberto a todos! Isso deve ocorrer até dia 06/12/2013. A versão será mais atual que a disponível abaixo, portanto sugiro que aguarde alguns dias.


Outros downloads:


Esta classe deverá ser colocada em breve em alguma GPL.

Voltar ao topo

Bugs conhecidos

Voltar ao topo

Autor e contribuidores

Esta classe foi criada baseada na última versão estável do ABNTex. Como o projeto foi descontinuado e eu precisava escrever minha dissertação de mestrado, resolvi fazer num formato que eu pudesse repassar para outras pessoas.

Meu nome é Thiago Mosqueiro, você pode me contactar pelo e-mail thiago dot mosqueiro at usp dot br.

Apesar de ter tido esse trabalho, não é minha prioridade ficar corrigindo os bugs e expandindo a classe para conseguir gerar algo à prova de erros. No entanto é de meu interesse manter razoavelmente funcional este modelo. Por isso, caso você tenha corrigido algum dos bugs ou tenha achado outros e queira dar uma contribuição, agradecerei muito e colocarei explicitamente este agradecimento aqui.

Voltar ao topo