diff options
author | Norbert Preining <norbert@preining.info> | 2019-10-09 03:01:25 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-10-09 03:01:25 +0000 |
commit | 8d5625f5e48587e6ca4304739304ed11b17cb26c (patch) | |
tree | f2c8b0e5f20681e9a35e6c3d33d2ec6a81d05e22 /macros/latex/contrib/fei/fei.dtx | |
parent | e5ffc42ed260285f76383ae18dd0f4a603c07fa8 (diff) |
CTAN sync 201910090301
Diffstat (limited to 'macros/latex/contrib/fei/fei.dtx')
-rw-r--r-- | macros/latex/contrib/fei/fei.dtx | 48 |
1 files changed, 33 insertions, 15 deletions
diff --git a/macros/latex/contrib/fei/fei.dtx b/macros/latex/contrib/fei/fei.dtx index 60b93ba5e7..3fae8c81a8 100644 --- a/macros/latex/contrib/fei/fei.dtx +++ b/macros/latex/contrib/fei/fei.dtx @@ -49,7 +49,7 @@ See http://www.latex-project.org/lppl.txt \endpreamble \postamble -Copyright (C) 2017 by Douglas De Rizzo Meneghetti <douglasrizzo@fei.edu.br> +Copyright (C) 2019 by Douglas De Rizzo Meneghetti <douglasrizzo@fei.edu.br> This work may be distributed and/or modified under the conditions of the LaTeX Project Public License (LPPL), either @@ -173,7 +173,13 @@ literate= \begin{agradecimentos} Agradecemos a Donald Knuth pela criação do \TeX{}, a Leslie Lamport pelo \LaTeX{} e a toda a comunidade de desenvolvedores que continua dando suporte e criando pacotes para melhorar a qualidade dos documentos escritos. Agradecimentos especiais são estendidos aos membros da \TeX{} \emph{Stack Exchange} pela divisão do fardo de criar documentos com belas tipografias. Agradece-se também os mantenedores da \gls{ctan}, por hospedar a classe e garantir sua distribuição em todas as maiores distribuições de \LaTeX{} nos principais sistemas operacionais, além de enviar-me e-mails toda vez que subo uma versão errada da classe. \end{agradecimentos} -\epigrafe{A good scientist is a person with original ideas. A good engineer is a person who makes a design that works with as few original ideas as possible. There are no prima donnas in engineering.}{Freeman Dyson \nocite{dyson_disturbing_1979}} + +\begin{epigrafe} + \epig{Beware of bugs in the above code; I have only proved it correct, not tried it.}{Donald E. Knuth \nocite{knuth77}} + \epig{Something is rotten in the state of Denmark.}{William Shakespeare \nocite{shakespeare1885tragedy}} +\end{epigrafe} + +% \epigrafe{A good scientist is a person with original ideas. A good engineer is a person who makes a design that works with as few original ideas as possible. There are no prima donnas in engineering.}{Freeman Dyson \nocite{dyson_disturbing_1979}} \begin{resumo} O \TeX{} é um sistema de formatação de textos baseado em uma \emph{mark-up language}, criado em 1978 por Donald Knuth e ampliado com uma série de macros por Leslie Lamport, dando à luz o \LaTeX{}. Utilizado com frequência na área acadêmica, foram criadas classes em \LaTeX{} para satisfazer às regras de formatação dos mais variados órgãos, sociedades, institutos e universidades. Baseada nos padrões da ABNT, a biblioteca da FEI criou seu próprio guia para formatação de trabalhos acadêmicos, o qual originou, extra-oficialmente, a classe \texttt{fei.cls}. Neste guia, os usuários serão guiados no uso dessa classe, desde a criação de elementos pré-textuais (capa, folha de rosto, ficha catalográfica, epígrafe, dedicatória, sumário, listas de figuras, tabelas, algoritmos, siglas e símbolos), passando pelo corpo do texto e elementos pós-textuais (índice remissivo, referências bibliográficas, apêndices e anexos) e terminando com uma explicação referente à instalação dos pré-requisitos e compilação de um trabalho dissertativo com todos os recursos que a classe pode oferecer. @@ -337,8 +343,9 @@ A classe da FEI pode receber as seguintes opções: \item \texttt{sublist}: configura o pacote \texttt{glossaries} para que sub-listas de símbolos sejam usadas. Mais sobre sub-listas na seção \ref{sec:sublist}; \item \texttt{algo-as-figure}: configura o pacote \texttt{algorithm2e} para que algoritmos sejam listados na lista de ilustrações. Essa configuração é preferível, uma vez que a formatação das legendas e da lista de algoritmos, no presente, não condiz com as recomendações do guia da biblioteca; \item \texttt{twoside}: a atualização de 2015 do guia da biblioteca recomenda que trabalhos acadêmicos com mais de 100 páginas sejam impressos em formato \index{frente-e-verso}frente-e-verso. Por ser derivada da classe \texttt{memoir}, a classe da FEI pode receber algumas opções nativas de \texttt{memoir}. Um exemplo de opção que pode ser útil é \texttt{twoside}, a qual alterna o tamanho das margens direita e esquerda das páginas, assim como a posição da numeração, permitindo realizar uma impressão frente-e-verso de melhor qualidade. Alterações adicionais foram realizadas para que todos os elementos pré-textuais sejam corretamente iniciados nas páginas ímpares, como recomenda o guia e a norma. É importante reparar, contudo, que a utilização de \texttt{twoside} acarreta no aumento do número de páginas, uma vez que os versos de algumas páginas no pré-texto podem ser deixados em branco em prol da norma. - \item \texttt{acronym}: sinaliza a configuração da lista de abreviaturas; - \item \texttt{symbols}: sinaliza a configuração da lista de símbolos. + \item \texttt{acronym}: passado para o pacote \texttt{glossaries-extra}, sinaliza o uso de abreviaturas no trabalho; + \item \texttt{symbols}: passado para o pacote \texttt{glossaries-extra}, sinaliza o uso de símbolos no trabalho; + \item \texttt{record}: passado para o pacote \texttt{glossaries-extra}, sinaliza o uso de um arquivo \texttt{.bib} para definição de símbolos e abreviaturas, a ser compilado pelo programa \index{bib2gls@\texttt{bib2gls}}\texttt{bib2gls}. \end{enumerate} \subsection{Nome do autor, e título} @@ -400,11 +407,19 @@ A quem se deseja agradecer. \end{lstlisting} \subsection{Epígrafe} -A epígrafe possui um formato especial, da mesma forma que a dedicatória. Este comando recebe dois parâmetros, sendo o primeiro a epígrafe e o segundo o autor da mesma. + +A página da epígrafe é criada utilizando o ambiente \texttt{epigrafe}. Dentro deste ambiente, uma ou mais citações podem ser inseridas separadamente utilizando o comando \lstinline+\epig{citacao}{Autor}+. Este comando recebe dois parâmetros, sendo o primeiro a citação em si e o segundo o autor da mesma. Apesar do guia de formatação da biblioteca não mencionar a possibilidade de incluir mais que uma cvitação na epígrafe, a classe da FEI disponibiliza esta opção aos seus usuários \emph{Nota:} O guia da FEI requer que a referência da epígrafe esteja presente no final do trabalho. O comando \lstinline+\nocite{obra}+ pode ser usado para que a referência apareça ao final do texto, sem aparecer na epígrafe. -Exemplo: \lstinline+\epigrafe{Haw-Haw!}{Nelson Muntz \nocite{muntz_book}}+ +Exemplo de declaração da página de epígrafe com duas citações: + +\begin{lstlisting} +\begin{epigrafe} +\epig{Epígrafe número um]}{Autor da Silva \nocite{obra_1}} +\epig{Epígrafe número dois]}{Autor de Souza \nocite{obra_2}} +\end{epigrafe} +\end{lstlisting} \subsection{Resumo e \emph{abstract}} @@ -1310,7 +1325,7 @@ A seguir, as descrições dos arquivos auxiliares gerados durante o processo de % \fi %<*class> \NeedsTeXFormat{LaTeX2e} -\ProvidesClass{fei}[2019/05/31 4.5.1 Modelo da FEI] +\ProvidesClass{fei}[2019/10/03 4.6 Modelo da FEI] % passa a opção draft para a classe \DeclareOption{draft}{ @@ -1340,6 +1355,11 @@ A seguir, as descrições dos arquivos auxiliares gerados durante o processo de \glossariestrue \PassOptionsToPackage{\CurrentOption}{glossaries-extra} } +% opção para configurar a lista de abreviaturas +\DeclareOption{record}{ + \glossariestrue + \PassOptionsToPackage{\CurrentOption}{glossaries-extra} +} % opção para criar sub-listas de símbolos \newif\ifsublist \sublistfalse @@ -1848,13 +1868,12 @@ A seguir, as descrições dos arquivos auxiliares gerados durante o processo de \end{flushright} } -% epígrafe -\newcommand{\epigrafe}[2]{ - \cleardoublepage - \thispagestyle{empty} - \vspace*{\fill} - \begin{flushright} - \begin{minipage}[t][0.5\textheight][c]{0.5\textwidth} +\newenvironment{epigrafe}{\cleardoublepage\pagestyle{empty}\vspace*{\fill}}{\pagestyle{plain}} + +\newcommand{\epig}[2]{ + \vspace{2\baselineskip} + \begin{flushright} + \begin{minipage}[t]{0.5\textwidth} ``{#1}'' \begin{flushright} #2 @@ -1862,7 +1881,6 @@ A seguir, as descrições dos arquivos auxiliares gerados durante o processo de \end{minipage} \end{flushright} } - % resumo \newenvironment{resumo}{\part*{Resumo}\pagestyle{empty}}{\cleardoublepage\pagestyle{plain}\setlength{\parindent}{1.25cm}} |