> 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/ar/qaadh-almarfh/099-is-there-a-way-to-run-a-word-count-that-doesn-t-include-latex-commands.md).

# هل توجد طريقة لإجراء عدّ للكلمات لا يتضمن أوامر LaTeX؟

## مقدمة

نعم، يمكنك الحصول على عدد الكلمات الذي يستبعد أوامر LaTeX تلقائيًا عن طريق اختيار `القائمة` ثم `عدد الكلمات` كما هو موضح في هذا العرض القصير:

![Wordcount.gif](/files/eb41a00daff568babed3c217e40db2c6a634dede)

سيؤدي هذا إلى تشغيل أداة [texcount](http://app.uio.no/ifi/texcount) لحساب الكلمات في الملف الرئيسي للمشروع وأي ملفات يتم استيرادها إلى الملف الرئيسي لمشروعك عبر `\include` و `\input`. لاحظ أن المستند الرئيسي لمشروعك يجب أن يكون في المستوى الأعلى للمشروع (أي ليس داخل مجلد) لكي يعمل texcount على Overleaf.

## تضمين المراجع في عدد الكلمات

بشكل افتراضي، لا تُدرج المراجع، والترويسات، والتعليقات التوضيحية، والعناصر العائمة، والمعادلات المعروضة، إلخ في العدد. لتضمين الاستشهادات والمراجع:

1. إضافة `%TC:incbib` في مقدمة ملف .tex الخاص بك، ثم
2. أضف ملفًا باسم latexmkrc (من دون امتداد ملف) في مشروعك، مع السطر التالي بداخله (غيّر "main" إلى اسم ملف .tex لمستندك الرئيسي)

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

**لاحظ أن هذا الحل البديل ينطبق فقط إذا كنت تستخدم `thebibliography` قائمة أو BibTeX.** [**لا يدعم texcount حاليًا biblatex**](https://tex.stackexchange.com/q/102882/226)**.**

راجع [#شغّل texcount باستخدام معاملات مخصصة](#run-texcount-with-custom-parameters) لإظهار عدد الكلمات للترويسات، والتعليقات التوضيحية، والعناصر العائمة، والمعادلات المعروضة، إلخ.

## تجاهل بعض الأقسام

في بعض الأحيان، قد ترغب في استبعاد أقسام أو مناطق معينة من عدد الكلمات. يمكنك وضع `%TC:ignore` و `%TC:endignore` حول هذه المناطق. على سبيل المثال:

```latex
%TC:ignore
\maketitle

\begin{abstract}
...لذا لن يُحسب عدد كلمات صفحة العنوان والملخص...
\end{abstract}
%TC:endignore
```

## شغّل texcount باستخدام معاملات مخصصة

إذا كنت ترغب في استخدام مجموعة خاصة بك من [معاملات texcount](http://app.uio.no/ifi/texcount/documentation.html) لتخصيص المخرجات، أو لإجراء عدٍّ للأحرف، أو لتضمين التعليقات التوضيحية، إلخ، يمكنك فعل ذلك بتعريف بعض الأوامر في مشروعك (مع أن ذلك يتضمن استخدام أوامر LaTeX...). على سبيل المثال:

```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} كلمات%
}

\newcommand{\quickcharcount}[1]{%
  \immediate\write18{texcount -1 -sum -merge -char -q #1.tex output.bbl > #1-chars.sum }%
  \input{#1-chars.sum} أحرف (لا تشمل المسافات)%
}
```

بافتراض أن اسم ملفك هو `main.tex`، فإن استدعاء هذه الأوامر في مشروعك سيعطي بعد ذلك المخرجات التالية في ملف PDF. تتضمن المخرجات تفصيلاً لكل قسم فرعي (subsection) ولكل ما يتعلق بالتعليقات التوضيحية، والعناصر العائمة، والمعادلات المعروضة، إلخ. لاحظ أنه بسبب طريقة إعداد عملية البناء في Overleaf، يجب تضمين \`output.bbl\` في أمر \`texcount\` لكي تُحتسب أيضًا قوائم المراجع الناتجة عن BibTeX.

```latex
% لا تحسب هذه!
%TC:ignore
\quickwordcount{main}
\quickcharcount{main}
\detailtexcount{main}
%TC:endignore
```

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

انظر [توثيق texcount](http://app.uio.no/ifi/texcount/documentation.html#options) للتعرف على ما يفعله كل خيار تشغيل. يمكنك مشاهدة هذه الأمثلة قيد التنفيذ [هنا](https://www.overleaf.com/read/dqvrqghbtmbc).

"Words in headers" و"headers" في التفصيل حسب الأقسام مخصصان لـ `\section`, `\subsection` إلخ، ولكن مع استثناء الرقم 1 و1.1 إلخ.

"Word outside text" و"captions" في التفصيل حسب الأقسام مخصصان لـ `\caption`، ولكن مع استثناء السابقة "Table 1" إلخ.

بشكل افتراضي، لا تُحسب الاستشهادات داخل النص. إذا كنت تريد عدّها، فأضف هذه الأسطر إلى المقدمة:

```latex
%TC:macro \cite [option:text,text]
%TC:macro \citep [option:text,text]
%TC:macro \citet [option:text,text]
% ... وأي أوامر \cite أخرى قد تستخدمها
```

ومع ذلك، لاحظ أن كل `\citep{ddd}` تُحتسب فقط كلمة واحدة في texcount (وهذا منطقي إلى حد ما؛ وإلا يمكنك رفع عدد الكلمات بشكل مصطنع وبدرجة كبيرة جدًا عن طريق الاستشهاد بمراجع متعددة المؤلفين). لذا `\cite{faye1996}`، رغم أنه يظهر بصيغة (Fay, 1996)، يُحتسب كلمة واحدة بواسطة texcount ولكن كلمتين بواسطة معالجات النصوص الأخرى.

لتضمين الكلمات في الجداول وبيئات tabular ضمن عدد "words in main text"، يمكنك [إضافة تعليمات texcount هذه](https://tex.stackexchange.com/a/37777/226) أيضًا:

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

## استخدام الأمر \import مع texcount

بشكل افتراضي، يتعرّف texcount على الأوامر الشائعة مثل `\input`, `\include` لعدّ الملفات الفرعية المضمّنة. ومع ذلك، فإن الأمر `\import` من `import` الحزمة غير مدعومة افتراضيًا.

لذلك إذا كنت تستخدم `\import` في مستندك، فقد ترغب في استخدام الأوامر الأكثر شيوعًا `\input` و `\include` بدلاً منها، وسيعمل texcount من دون أي تغييرات إضافية.

إذا كنت تفضّل الاستمرار في استخدام `\import`، يمكنك إضافة تعليمات texcount في المقدمة بحيث `\import{foo}{bar}` يبدو مثل `\include{foo/bar}` بالنسبة إلى texcount، بحيث يحسب الكلمات في الملفات الفرعية:

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

يرجى ملاحظة أنه سيتعين عليك إجراء إعادة ترجمة أولًا بعد إضافة هذا السطر، قبل النقر على "عدد الكلمات".

## قراءات إضافية

* [التوثيق الكامل لـ 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/ar/qaadh-almarfh/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.