Mestre em LaTeX v0.2

Acabo de lançar uma nova versão do Mestre em LaTeX! Fiz uma boa limpeza no código e corrigi os poucos (mas importantes) bugs que haviam sido reportados. As principais mudanças foram a melhoria da formatação dos elementos pré-textuais (capa até sumário), o ajuste para que seções comecem sempre nas páginas ímpares e re-estruturação do texto. Veja mais detalhes sobre as atualizações desta versão aqui. Para baixar:

Mestre em LaTeX v0.2 – 2010-05-01 [zip com 502kb]

ou visite o site para mais informações: http://code.google.com/p/mestre-em-latex/

Para a próxima versão deixarei o texto mais didático, já que ficou um pouco bagunçado depois do rearranjo, e adequarei o documento de acordo com as normas da ABNT para a apresentação de documentos acadêmicos.

Desde 29 de janeiro de 2009 a primeira versão foi baixada 767 vezes e pelo menos 2 dissertações foram defendidas com sucesso (essa do gepeto e essa do zué; além da minha ;)). Se alguém tiver notícia de mais alguma me avise. Agradeço a todos que me relataram bugs ou me escreveram, mesmo que só para dizer que o MeL* havia funcionado (ou não) nos seus sistemas. Continuem mandando sugestões!

* apelido carinhoso

10 respostas para “Mestre em LaTeX v0.2”

  1. Alguns pequenos comentários:

    1- dê uma olhada no pacote SIunits, é muito bom. É como uma extensão do units. Preste atenção nas incopatibilidades com o amsmath e pstricks… (isto está explicado no pdf do SIunits) basicamente ele define duas funções que já existem nestes pacotes \square \grey (se eu nao me engando). Para corrigir isto, basta colocar uns options no includepackage para que ele não redefina as funções.

    2- Quanto à ifenização. Eu não gosto da hifenização em pt. Já encontrei muita separação silábica errada. Não sei como está isso hoje em dia, não sei se corrigiram. Nevertheless, acho que separação silábica no final da linha é um recurso da época que usávamos máquina de escrever e, em que quando chegávamos no final da linha, quebrávamos a palavra (pq não tinha um backspace na máquina de escrever =) ) O que eu faço nos meus documentos é usar

    \usepackage[none]{hyphenat}

    Com isto, alguns problemas de justificação de final de linha vai dar problema. Para corrigir isto, eu uso

    \sloppy

    no preâmbulo do documento.

    3- Gostei dos links na legenda da figura 2.3! =D

    4- Há a opção para inserir referências por ordem numérica?

    5- não conhecia esse booktable

    6- Makefile só com pdflatex? e se o cara usa só imagens .eps/.ps/.pdf?

    Good Job soldier!

  2. continuando…

    7- Eu costumo definir alguns macros para facilitar o meu trabalho, assim fica mais fácil adicionar referências:

    \newcommand{\figref}[1]{Figura~\ref{#1}}
    \newcommand{\tabref}[1]{tabela~\ref{#1}}
    \newcommand{\secref}[1]{seção~\ref{#1}}
    \newcommand{\apref}[1]{apêndice~\ref{#1}}

    e também para inserir figuras. assim economizo tempo e o .tex fica mais limpinho um pouco:

    o comando \imagem serve para inserir figuras de forma rápida:

    \imagem{banana.eps}{Esta é a legenda.}{fig:este_eh_o_label}{10cm}

    \newcommand{\imagem}[4]{\begin{figure}[H]
    \center
    \includegraphics[width=#4]{./imagens/#1}
    \caption{#2}\label{#3}
    \end{figure}}

    só coloco a opcao de tamanho para a largura, pq julgo que seja o mais comum.

    o \imagemg:

    \newcommand{\imagemg}[5]{\begin{figure}[H]
    \center
    \includegraphics[width=#4]{./imagens/#1}
    \caption[#5]{#2}\label{#3}
    \end{figure}}

    é a mesma coisa, mas tem um caption extra. este caption extra é uma versao menor do caption para ficar na lista de figuras:

    \imagem{banana.eps}{Esta é a legenda longa e cheia de detalhes a respeito da foto de uma banana, que fica horrível na lista de figuras pois é muito comprida e cheira de palavras.}{fig:este_eh_o_label}{10cm}{Foto da Banana}

    8- Note que as imagens estão dentro de um subdiretorio do documento ./imagens. Talvez fosse legal citar algos desse tipo no MeL. Pode ser que o usuário comum não saiba desta possibilidade de organizar as imagens, deixar as imagens separadas ajuda bastante!

    9- Ah, vale a pena tbm falar para NÃO colocar espaço em nome de arquivos, NEM acentos. a nao ser que o cara queira problemas de compatipilidade entre sistemas, eu um estiver usando utf-8 e outro iso8859-1. =D

    9- Avise também que vc está usando aí nos seus .tex o encoding utf-8! Eu abri aqui e tava como iso8859-1… aí já viu =)

  3. mais novas idéias!! =D

    acabei de ter uma idéia: pq não adicionar no Makefile (ou em algum tools.sh) algumas ferramentas como por exemplo um conversor de formato de imagens:
    1) jpg -> eps
    2) eps -> jpg
    3) jpg -> png

    imagino que o convert do ImageMagick resolve isso sem problemas. O script poderia ser algo que procura recursivamente as figuras, ou faz em uma lista especificada de figuras. Se vc quiser, eu escrevo pra vc este script. Deve ter outros tools interessantes tbm, mas afora não to conseguindo pensar ema nada. =P

    outro comment:

    para organizar meu .bib, eu uso o jabref. (http://jabref.sourceforge.net/)
    esse programinha aí é mto legal e tem muitos features legais, como procura online (apesar que nunca usei). Deixa inclusive vc linkar o documento a referência, assim vc nao precisa procurar no seu computador todo onde está o maldito pdf da referência… =D
    Eu tenho aqui no meu computador um único .bib central, que chamo de biblioteca.bib.

  4. Mais idéias (tá, esse é o último, prometo)

    olhei o seu pdf compilado e o .tex e tudo mais té bem explicadinho e tal. Talvez fosse legal preparar um documentinho “boas práticas no latex para noobs” e por junto do MeL, com dicas do tipo:

    – jabref (ou similar)
    – que é legal organizar as imagens em diretorios
    – que formato de imagem usar
    – pq usar imagens .eps em gráficos

    essas coisinhas que são mto simples, mas que, em geral, não são observadas por aí e temos que aprender por conta.

    Posso ajudar nisso se vc quiser.

    bom, acho que meus comentários acabam aqui…. ou não XD

  5. ok, sou eu de novo… rsrs

    1-) tava olhando o meta.tex e o pre.tex …

    achei um pouco complicado, para o usuário nao acostumado com latex, para colocar o titulo da tese, area da pesquisa, nome, etc…

    pelo que vi, o cara tem q cololcar essas coisas no meta.tex nao é?

    pq vc nao faz assim (exemplo para o autor, o resto é igualzinho):

    no seu meta.tex vc define
    \newcommand{\autor}[1]{\renewcommand{\MeLautorNome}{#1}}

    aí o cara, no .tex dele, (nao no pre.tex) pode simplesmente escrever

    \autor{Jośe da Silva Xavier}

    pronto, agora no seu pre.tex, vc pode mandar colocar na pagina de titulo simplesmente \MeLautorNome

    obs:
    não esqueca que tbm pode ter co-orientador

    2-)

    2-a) pq vc nao cria um comando para a capa, folha de rosto, folha de aprovacao, etc?

    \capa
    \folhaderosto
    \fichaCalatografica

    para a ficha catalografica, o que eu fiz pra poli é:

    \newcommand{\permissaocopia}[1]{\newcommand{\permissaocopia}{#1}}

    \newcommand{\fichacatalografica}[1]{
    \begin{titlepage}
    \espaco{1.1}

    \hspace{-2.5cm}
    \begin{minipage}{1.0\textwidth}
    \begin{espacosimples}
    \ifthenelse{\equal{\permissaocopia}{sim}}{\MakeUppercase{autorizo a reprodução e divulgação total ou parcial
    deste trabalho, por qualquer meio convencional ou eletrônico, para fins de estudo e pesquisa, desde
    que citada a fonte.}}{não autorizo a reprodução e divulgação total ou parcial
    deste trabalho, por qualquer meio convencional ou eletrônico.}
    \end{espacosimples}
    \end{minipage}

    \small
    \vspace*{13cm}
    \hspace{-2.5cm}
    \begin{minipage}{1.0\textwidth}
    \begin{center}
    \begin{tabular}{c}
    {\normalsize \bf \MakeUppercase{Ficha catalográfica}}\\\\
    \end{tabular}
    #1
    \end{center}
    \end{minipage}
    \end{titlepage}
    }

    para chamar a bagaca:

    \fichacatalografica{\begin{tabular}{|l|} \hline]\\
    tabela\\

    tabela\\
    \hline
    \end{tabular}
    } (note que o parametro que estou passando eh uma tabela)

    e pra configurar esse \permissaocopia

    \permissaocopia{sim} % ou nao

    2-b) nao sei se o pre.tex é necessário. Por que vc nao trabalha criando uns environments no meta.tex? por exemplo para as dedicatorias:

    \newenvironment{dedicatoria}%
    {
    \noindent{\LARGE\textbf{Agradecimentos}}
    \begin{minipage}{0.3\textwidth}
    \vspace{14cm}
    \doublespacing
    }
    {
    \end{minipage}
    \newpage
    }

    assim, o cara no texto dele pode escrever

    \begin{dedicatoria}
    Aos meus pais e irmãos.

    Dedico também ao papai noel por me dar presentes, etc…
    \end{dedicatoria}

    vc pode tbm definir parametros no environment, como no caso da epigrafe, cujo parametro é o nome do autor, que deve ser colocado abaixo do texto, um pouquinho para a direita (este exemplo funfa, eu testei aqui colocando no seu meta.tex) Fiz assim pra poli:

    \newsavebox{\nome}
    \newenvironment{epigrafeFe}[1]
    {
    \sbox{\nome}{\textit{#1}}
    \begin{center}
    \begin{minipage}{0.7\textwidth}
    \vspace{4.5cm}
    }
    {\begin{flushright}
    \usebox{\nome}
    \end{flushright}
    \end{minipage}
    \end{center}
    \newpage
    }

    e o cara sé escreve no texto dele algo do tipo:

    \begin{epigrafe}{Albert Einstein (1879$-$1955)}
    “Tenha em mente que tudo que você aprende na escola é trabalho de muitas
    gerações. Receba essa herança, honre-a, acrescente a ela e, um dia, fielmente,
    deposite-a nas mãos de seus filhos.”
    \end{epigrafe}

    obs: note que eu já coloco o \newpage dentro da definicao do environment.. assim o cara nao precisa se preocupra com isso.. rá! =D

    no final da história, o cara teria o seguinte no tex dele:

    no preambulo, ele colocaria
    \autor{José da Silva Xavier}
    \titulo{Este é o título do Trabalho}
    \areaconcentracao{Engenharia mecânica}
    \orientador[]{Prof. Dr. Bla bla}
    \coorientador[]{}
    \comentario{Dissertacao apresentada ao Instituto de Biociências da Universidade de São Paulo, para a obtenção bla bla bla}
    \instituicao{UNIVERSIDADE DE SÃO PAULO \par ESCOLA POLITÉCNICA}
    \local{São Paulo}
    \data{2010}

    \permissaocopia{sim} % ou nao

    aí no pré.tex (simplificado) dele teria algo:

    \capa
    \folhaderosto
    \folhadeaprovacao

    \begin{dedicatoria}
    bla bla bla
    \end{dedicatoria}

    \begin{epigrafe}{autor desconhecido}
    agua mole e pedra dura, tanto bate até que fura
    \end{epigrafe}

    \begin{resumopt}
    macaco
    \end{resumopt}

    \begin{resumoen}
    monkey
    \end{resumoen}

    etc…

    bom, vc pegou a idéia… deste jeito, o pre do cara fica mto mais fácil de ver.

  6. Paul! Valeu muito pelos comentários! Vou organizar as sugestões para acrescentar no tracker do MeL e ir incorporando.

    Você sabe mexer com mercurial? Se souber, acho que seria o jeito mais prático de ajudar, eu te coloco como colaborador do projeto e você pode editar os arquivos e submeter para o site direto. Se não também, se você quiser corrigir alguma coisa é só me mandar.

    Agora aos comentários!

    Vou checar o pacote SIunits e mais um outro (que não lembro o nome), mas que tem a mesma função. Cogitei até em tirar o units e formatar o espaço entre a unidade com o comando \, mas acabei não achando que seria tão bom.

    Nunca tive problemas com a hifenação, mas talvez não tenha reparado. De qualquer modo se aparecer algo errado dá pra ensinar o compilador com o co\-man\-do \-

    Os links da subfig são legalzinhos mesmo, mas na prática não acho muito úteis… hehe.

    Para inserir as refs em ordem númerica é só trocar o estilo no \bibliographystyle{}. Deixei apalike por padrão (tb preciso checar o que a ABNT diz…), mas se trocar funciona igual. Talvez valha a pena deixar a opção lá.

    Gosto bastante do booktable. Acho a tabela padrão bem feinha…

    Tudo do MeL fiz pensando em compilar com o pdflatex pq era o q eu estava usando, mas acho que vale a pena colocar a opção para gerar ps/dvi. Aliás a idéia de criar um Makefile é sua e ajudou muito! Até incluí o gerador de abreviaturas nele pra facilitar (já q era a parte mais “complexa” pra executar). Vi alguém usando o ifthenelse para escolher o pacote graphics dependendo se a compilação fosse latex ou pdflatex. Achei bem legal, acho que vou incorporar.

    Gostei bastante dos novos comandos para inserir os links internos e figuras. Realmente bem mais prático. Vou incluir!

    Na versão anterior as imagens estavam dentro de uma pasta própria. Nessa versão achei melhor simplificar e deixar em uma pasta só, mas a opção ainda está disponível no meta.tex! É só descomentar.

    Vou colocar a codificação em algum lugar… talvez no LEIAME?

    Eu tenho uns scripts pra converter imagens tb (imagemagick rulez), mas acho que separado do Makefile seria melhor.

    Usei o JabRef um bom tempo! Agora estou usando mais o Mendeley, que ainda não chegou lá, mas está indo bem. Mas vira e mexe ainda volto no jabref pra abrir coisas lá. Seria legal incluir dicas assim, talvez no Wiki direto, ou mesmo ao longo do texto. Acho que caberia bem.

    Criar os comandos e ambientes para limpar o pre.tex é uma idéia bem boa. Só me pergunto se o cara que olhar aquilo pela primeira vez não vai achar muito mais complicado entender como que um \capa funciona do que olhar os elementos da capa direto ali no pre.tex seguido dos outros elementos. De qualquer modo, acho que vai valer muito a pena implementar isso pq fica muito mais prático.

    Paul, obrigadão!

  7. Oi! Gostei muito do mestre em latex e já defendi minha qualificação de mestrado com ele. Tem dois problemas que não consigo resolver: Encontrar um estilo de bibliografia que funcione e seja em ordem numérica (mas completa, parecida com a da ABNT) e colocar figuras em outro formato que não o jpg(só consigo este, e as figuras perdem definição). Valeu!

    1. Olá Taci,

      Valeu! Legal, saber que você está usando o MeL.

      Para customizar o estilo das referências você pode usar o pacote custom-bib. Ele você vai gerar o arquivo bst baseado numa lista de perguntas sobre como você quer que seja o estilo.

      Você consegue usar figuras como PNG ou TIFF? Ou só JPG que funciona? No meu computador eu consigo usar todos os tipos de arquivo (incluindo figuras em PDF), menos PS e EPS. Para usar estes dois precisaria compilar com o comando latex e não pdflatex (padrão do MeL).

      Se quiser crie uma entrada na lista de bugs clicando aqui e coloque uma descrição do que está acontecendo, com detalhes de quais pacotes você está usando, em qual sistema, etc, para que eu possa achar a origem do bug.

      Abs!

Os comentários estão desativados.