lang-latex

Fornece padrões de engenharia e tipografia acadêmica/científica em LaTeX (LaTeX2e e LuaLaTeX/XeLaTeX). Cobre estruturação modular de documentos multinível, gestão de bibliografia com BibLaTeX/Biber, i

SKILL.md

GitHub

Habilidade de IA: Engenharia de LaTeX (LaTeX Specialist)

Esta skill orienta a inteligência artificial a atuar como especialista no ecossistema LaTeX (incluindo motores modernizados como XeLaTeX e LuaLaTeX), focando na redação e estruturação profissional de teses, dissertações, livros técnicos, artigos acadêmicos e relatórios científicos.


🧭 Diretrizes de Desenvolvimento em LaTeX

Ao atuar nesta skill, aplique rigorosamente os seguintes padrões:

1. Estruturação Modular do Projeto

  • Documento Mestre Limpo: O arquivo principal (main.tex) deve conter o pré-ambulo estruturado e as chamadas aos capítulos/seções via \input{sections/nome.tex} ou \include{chapters/nome.tex}.
  • Organização de Pastas:
    • figures/: Imagens e esquemas TikZ.
    • styles/ ou packages/: Pacotes e macros customizadas (custom.sty).
    • bibliography.bib: Base de dados bibliográfica.

2. Escolha de Motor e Pacotes Modernos

  • Prefira LuaLaTeX / XeLaTeX: Para projetos novos, utilize LuaLaTeX ou XeLaTeX com o pacote fontspec para suporte nativo a UTF-8 e fontes do sistema (OTF/TTF).
  • Pacotes Essenciais Recomendados:
    • Tipografia Matemática: amsmath, amssymb, mathtools.
    • Tabelas Profissionais: booktabs (evite linhas verticais em tabelas acadêmicas), tabularx, array.
    • Imagens e Diagramas: graphicx, tikz, pgfplots.
    • Links e Referências Cruzadas: hyperref, cleveref (deve ser carregado após o hyperref).

3. Bibliografia com BibLaTeX + Biber

  • Substituir natbib/BibTeX por BibLaTeX: Utilize biblatex com o backend biber para suporte completo a UTF-8 e estilos bibliográficos flexíveis (como ABNT, IEEE, APA):
    \usepackage[backend=biber, style=numeric, sorting=nyt]{biblatex}
    \addbibresource{bibliography.bib}
    

4. Definição Limpa de Macros e Comandos

  • Sintaxe Moderna (LaTeX3 / xparse): Defina macros com argumentos opcionais ricos usando \NewDocumentCommand em vez de \newcommand legado:
    \NewDocumentCommand{\codevar}{m o}{%
      \texttt{#1}\IfValueT{#2}{\space\textnormal{(#2)}}%
    }
    

5. Boas Práticas de Formatação Tipográfica

  • Aspas Corretas: Use ``aspas duplas'' em vez de "aspas simples".
  • Hífen vs. Meio-risco vs. Travessão: Use - para palavras compostas, -- para faixas de valores (ex: 10--20) e --- para travessões explicativos.

🧰 Padrões de Código Recomendados

Documento Mestre Modular (main.tex)

% !TEX program = lualatex
\documentclass[12pt, a4paper, oneside]{article}

% --- Pré-ambulo: Pacotes Fundamentais ---
\usepackage{fontspec}
\setmainfont{Latin Modern Roman}

% Idioma e Ajustes de Margem
\usepackage[portuguese]{babel}
\usepackage[top=3cm, bottom=2cm, left=3cm, right=2cm]{geometry}

% Matemática e Símbolos
\usepackage{amsmath, amssymb, mathtools}

% Tabelas e Figuras
\usepackage{booktabs}
\usepackage{graphicx}
\usepackage{tikz}

% Bibliografia Avançada
\usepackage[backend=biber, style=alphabetic, sorting=nyt]{biblatex}
\addbibresource{bibliography.bib}

% Links e Referências Inteligentes
\usepackage[colorlinks=true, linkcolor=blue, citecolor=teal, urlcolor=magenta]{hyperref}
\usepackage{cleveref}

% --- Macros Customizadas ---
\NewDocumentCommand{\vectornorm}{m}{%
  \left\lVert #1 \right\rVert
}

\title{\textbf{Modelagem Estocástica de Redes Complexas}}
\author{Dandara Gabriel \and Equipe de Pesquisa}
\date{\today}

\begin{document}

\maketitle

\begin{abstract}
Este trabalho apresenta um modelo matemático para previsão de convergência em grafos direcionados orientados a eventos.
\end{abstract}

\tableofcontents
\newpage

% --- Conteúdo Modular ---
\section{Introdução}
A análise de grafos dinâmicos é fundamental para a compreensão de sistemas complexos~\cite{smith2024}.

\section{Fundamentação Matemática}
Dada uma matriz de adjacência $A \in \mathbb{R}^{n \times n}$, a norma Frobenius do operador de transição é dada pela \cref{eq:norma}:

\begin{equation}
\label{eq:norma}
\vectornorm{A}_F = \sqrt{\sum_{i=1}^{n} \sum_{j=1}^{n} |a_{ij}|^2}
\end{equation}

\section{Resultados e Tabelas}
A \cref{tab:resultados} resume o desempenho obtido.

\begin{table}[htbp]
  \centering
  \caption{Desempenho de Convergência do Algoritmo}
  \label{tab:resultados}
  \begin{tabular}{@{}llrr@{}}
    \toprule
    \textbf{Grafo} & \textbf{Método} & \textbf{Iterações} & \textbf{Tempo (s)} \\
    \midrule
    Erdős--Rényi & Standard Power Iter & 1.420 & 3,45 \\
    Erdős--Rényi & Accelerated Krylov  & 310   & 0,82 \\
    Barabási--Albert & Accelerated Krylov & 540 & 1,12 \\
    \bottomrule
  \end{tabular}
\end{table}

\printbibliography

\end{document}

Caixa de Destaque Estilizada com tcolorbox e Diagrama TikZ

\usepackage[many]{tcolorbox}

% Definindo uma caixa de teorema/aviso elegante
\newtcolorbox{alertbox}[2][]{%
  colback=blue!5!white,
  colframe=blue!75!black,
  fonttitle=\bfseries,
  title=#2,
  arc=2mm,
  #1
}

% Exemplo de Uso:
\begin{alertbox}{Teorema Fundamental de Limite}
Se uma sequência $\{a_n\}$ é limitada e monotônica, então a sequência $\{a_n\}$ é convergente.
\end{alertbox}

% Exemplo de Diagrama TikZ Limpo:
\begin{figure}[htbp]
  \centering
  \begin{tikzpicture}[node distance=2cm, auto, >=stealth']
    \node [draw, circle, fill=blue!10] (A) {Nó A};
    \node [draw, circle, fill=green!10, right of=A, node distance=3cm] (B) {Nó B};
    \node [draw, circle, fill=orange!10, below of=B] (C) {Nó C};

    \draw[->, thick] (A) -- node {$\lambda_{ab}$} (B);
    \draw[->, thick] (B) -- node {$w_{bc}$} (C);
    \draw[->, thick] (C) -| node[near start] {$\mu_{ca}$} (A);
  \end{tikzpicture}
  \caption{Grafo de Transição de Estados}
  \label{fig:tikz_state}
\end{figure}

🔒 Questões de Segurança e Práticas Seguras

  • Shell Escape (Execução de Código): Desabilite a flag --shell-escape ao compilar documentos LaTeX contendo código de terceiros não confiáveis, prevenindo chamadas à diretiva \write18.
  • Inclusão Arbitrária de Arquivos: Limite o acesso a diretivas como \input, \include e \import para evitar leitura arbitrária de arquivos confidenciais do sistema host.
  • Negação de Serviço (DoS): Evite loops de recursão infinita em definições de macros personalizadas que possam paralisar ou travar a CPU do servidor de compilação.