> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/base-de-conhecimento/099-is-there-a-way-to-run-a-word-count-that-doesn-t-include-latex-commands.md).

# Existe alguma forma de executar uma contagem de palavras que não inclua comandos LaTeX?

## Introdução

Sim, pode obter uma contagem de palavras que exclui automaticamente os comandos LaTeX ao selecionar `Menu` e depois `Contagem de palavras` como demonstrado neste breve screencast:

![Wordcount.gif](/files/176571bdf6917428043c9cb9663a774eed312a0a)

Isto irá executar o [utilitário texcount](http://app.uio.no/ifi/texcount) para contar as palavras no ficheiro principal do projeto e em quaisquer ficheiros importados para o ficheiro principal do seu projeto através de `\include` e `\input`. Note que o documento principal do seu projeto tem de estar ao nível superior do projeto (ou seja, não dentro de uma pasta) para o texcount funcionar no Overleaf.

## Incluir referências na contagem de palavras

Por predefinição, referências, cabeçalhos, legendas, elementos flutuantes, equações apresentadas, etc. não são incluídos na contagem. Para incluir as citações e referências:

1. Adicionar `%TC:incbib` no preâmbulo do seu ficheiro .tex, e depois
2. Adicione um ficheiro chamado latexmkrc (sem extensão de ficheiro) no seu projeto, com a seguinte linha (altere "main" para o nome que tiver o seu ficheiro .tex do documento principal)

   ```perl
   END { system('cp', 'output.bbl', 'main.bbl'); }
   ```

**Note que esta solução alternativa só é aplicável se estiver a utilizar um `thebibliography` lista ou BibTeX.** [**O texcount não suporta atualmente biblatex**](https://tex.stackexchange.com/q/102882/226)**.**

Consulte [#Executar texcount com parâmetros personalizados](#run-texcount-with-custom-parameters) para mostrar contagens de palavras para cabeçalhos, legendas, elementos flutuantes, equações apresentadas, etc.

## Ignorar algumas secções

Por vezes, pode querer excluir certas secções ou regiões da contagem de palavras. Pode colocar `%TC:ignore` e `%TC:endignore` à volta dessas regiões. Por exemplo:

```latex
%TC:ignore
\maketitle

\begin{abstract}
...Assim, a página de título e o resumo não serão contabilizados...
\end{abstract}
%TC:endignore
```

## Executar texcount com parâmetros personalizados

Se quiser usar o seu próprio conjunto de [parâmetros do texcount](http://app.uio.no/ifi/texcount/documentation.html) para personalizar a saída, ou para efetuar uma contagem de caracteres, ou para incluir legendas etc., pode fazê-lo definindo alguns comandos no seu projeto (embora isso implique então usar comandos LaTeX...). Por exemplo:

```latex
\usepackage{verbatim}

\newcommand{\detailtexcount}[1]{%
  \immediate\write18{texcount -merge -sum -q #1.tex output.bbl > #1.wcdetail }%
  \verbatiminput{#1.wcdetail}%
}

\newcommand{\quickwordcount}[1]{%
  \immediate\write18{texcount -1 -sum -merge -q #1.tex output.bbl > #1-words.sum }%
  \input{#1-words.sum} palavras%
}

\newcommand{\quickcharcount}[1]{%
  \immediate\write18{texcount -1 -sum -merge -char -q #1.tex output.bbl > #1-chars.sum }%
  \input{#1-chars.sum} caracteres (sem incluir espaços)%
}
```

Assumindo que o seu ficheiro se chama `main.tex`, ao invocar estes comandos no seu projeto, a saída no PDF será a seguinte. A saída inclui a decomposição de cada subsecção, bem como de legendas, elementos flutuantes, equações apresentadas, etc. Note que, devido à forma como o processo de compilação do Overleaf está configurado, tem de incluir \`output.bbl\` no comando \`texcount\` para que as listas de referências produzidas por BibTeX sejam também contabilizadas.

```latex
% Não conte isto!
%TC:ignore
\quickwordcount{main}
\quickcharcount{main}
\detailtexcount{main}
%TC:endignore
```

![Custom-texcount.png](/files/147ce1a3c7d8a9a6758ff6d321c307cafff185c3)

Veja o [documentação do texcount](http://app.uio.no/ifi/texcount/documentation.html#options) para o que faz cada sinalizador em tempo de execução. Pode ver estes exemplos em ação [aqui](https://www.overleaf.com/read/dqvrqghbtmbc).

"Words in headers" e "headers" na decomposição secção a secção servem para `\section`, `\subsection` etc., mas excluindo o número 1, 1.1, etc.

"Word outside text" e "captions" na decomposição secção a secção servem para `\caption`, mas excluindo o prefixo "Table 1" etc.

Por predefinição, as citações no texto não são contabilizadas. Se quiser contá-las, adicione estas linhas ao seu preâmbulo:

```latex
%TC:macro \cite [option:text,text]
%TC:macro \citep [option:text,text]
%TC:macro \citet [option:text,text]
% ... e para quaisquer outros comandos \cite que possa usar
```

No entanto, note que cada `\citep{ddd}` conta apenas como uma palavra no texcount (o que faz algum sentido; caso contrário, pode inflacionar artificialmente as contagens de palavras de forma enorme ao citar referências com vários autores). Assim, `\cite{faye1996}`, embora seja apresentado como (Fay, 1996), é contado como uma palavra pelo texcount, mas como 2 palavras por outros processadores de texto.

Para incluir palavras em tabulares e tabelas na contagem de "words in main text", pode [adicionar estas instruções do texcount](https://tex.stackexchange.com/a/37777/226) também:

```latex
%TC:group table 0 1
%TC:group tabular 1 1
```

## Utilizar o comando \import com o texcount

Por predefinição, o texcount reconhece comandos comuns como `\input`, `\include` para contabilizar subficheiros incluídos. No entanto, o comando `\import` do `import` não é suportado por predefinição.

Portanto, se estiver a usar `\import` no seu documento, poderá querer usar os mais comuns `\input` e `\include` comandos em vez disso, e o texcount funcionará sem quaisquer alterações adicionais.

Se preferir continuar a usar `\import`, pode adicionar uma instrução do texcount no preâmbulo para que `\import{foo}{bar}` pareça `\include{foo/bar}` para o texcount, de modo a que ele contabilize as palavras nos subficheiros:

```latex
%TC:fileinclude \import dir,file
```

Note que terá de recompilar primeiro depois de adicionar esta linha, antes de clicar em "Contagem de palavras".

## Leitura adicional

* [Documentação completa do texcount](http://app.uio.no/ifi/texcount/documentation.html)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/base-de-conhecimento/099-is-there-a-way-to-run-a-word-count-that-doesn-t-include-latex-commands.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
