> 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/bnyh-almstnd/09-hyperlinks.md). # الارتباطات التشعبية تُعدّ LaTeX أداة رائعة للمستندات القابلة للطباعة ذات المظهر الاحترافي، ولكن يمكن استخدامها أيضًا لإنشاء ملفات PDF بأدوات تنقّل ممتازة. تشرح هذه المقالة كيفية إنشاء روابط تشعبية في مستندك، وكيفية إعداد مستندات LaTeX لعرضها باستخدام قارئ PDF. ## مقدمة لنبدأ بمثال عمليٍّ أدنى، وذلك بمجرد استيراد **hyperref** الحزمة all [العناصر المُشار إليها مرجعيًا](/latex/ar/bnyh-almstnd/03-cross-referencing-sections-equations-and-floats.md) تتحول إلى روابط تشعبية. ```latex \documentclass{book} \usepackage{blindtext} \usepackage{hyperref} \title{مثال على الروابط التشعبية} \author{Overleaf} \begin{document} \frontmatter \tableofcontents \clearpage \addcontentsline{toc}{chapter}{كلمة تمهيدية} {\huge {\bf تمهيد}} \Blindtext \clearpage \addcontentsline{toc}{chapter}{مدخل وهمي} {\huge {\bf مدخل وهمي}} \Blindtext \mainmatter \chapter{الفصل الأول} سيكون هذا فصلًا فارغًا \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} تُظهر المعادلة \ref{eq:1} مجموعًا متباينًا. ستُستخدم هذه الصيغة لاحقًا في الصفحة \pageref{second}. \Blindtext \clearpage \section{القسم الثاني} \label{second} \blindtext \Blinddocument \end{document} ``` [افتح هذا `hyperref` المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+hyperref+example\&snip=%5Cdocumentclass%7Bbook%7D%0A%5Cusepackage%7Bblindtext%7D%0A%5Cusepackage%7Bhyperref%7D%0A%0A%5Ctitle%7BExample+of+Hyperlinks%7D%0A%5Cauthor%7BOverleaf%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cfrontmatter%0A%5Ctableofcontents%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BForeword%7D%0A%7B%5Chuge+%7B%5Cbf+Foreword%7D%7D%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BDummy+entry%7D%0A%7B%5Chuge+%7B%5Cbf+Dummy+entry%7D%7D%0A%0A%5CBlindtext%0A%5Cmainmatter%0A%0A%5Cchapter%7BFirst+Chapter%7D%0A%0AThis+will+be+an+empty+chapter%0A%0A%5Cbegin%7Bequation%7D%0A%5Clabel%7Beq%3A1%7D%0A%5Csum_%7Bi%3D0%7D%5E%7B%5Cinfty%7D+a_i+x%5Ei%0A%5Cend%7Bequation%7D%0A%0AThe+equation+%5Cref%7Beq%3A1%7D+shows+a+sum+that+is+divergent.+This+formula+will+be+used+later+on+page+%5Cpageref%7Bsecond%7D.%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Csection%7BSecond+section%7D+%5Clabel%7Bsecond%7D%0A%0A%5Cblindtext%0A%5CBlinddocument%0A%5Cend%7Bdocument%7D) ![مستند مثال hyperref](/files/e76ee92e0f095c0b229b07cb694541dceb5b8932) تصبح الأسطر في جدول المحتويات روابط إلى الصفحات المقابلة في المستند بمجرد إضافة السطر التالي في مقدمة المستند ```latex \usepackage{hyperref} ``` يجب الحذر عند استيراد `hyperref`: عادةً، يجب أن تكون آخر حزمة يتم استيرادها—ولكن قد تكون هناك بعض الاستثناءات لهذه القاعدة. ## الأنماط والألوان يمكن تغيير التنسيق الافتراضي للروابط بحيث تُعرض المعلومات في مستنداتك بشكل أوضح. فيما يلي مثال: ```latex \documentclass{book} \usepackage{hyperref} \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={مثال Overleaf}, pdfpagemode=FullScreen, } \urlstyle{same} \begin{document} \tableofcontents \chapter{الفصل الأول} سيكون هذا فصلًا فارغًا وسأضع بعض النص هنا \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} تُظهر المعادلة \ref{eq:1} مجموعًا متباينًا. هذه الصيغة ستُستخدم لاحقًا في الصفحة \pageref{second}. لمزيد من المراجع انظر \href{http://www.overleaf.com}{Something Linky} أو انتقل إلى الرابط التالي: \url{http://www.overleaf.com} أو افتح الملف التالي \href{run:./file.txt}{File.txt} من الممكن أيضًا ربط أي كلمة مباشرةً أو \hyperlink{thesentence}{أي جملة} في مستندك. \end{document} ``` [افتح مثالًا على `hyperref` الحزمة في Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Another+hyperref+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ![HyperrefEx2OverleafVa.png](/files/826d44b6aa4a720cb428acc84d4701e04b9be9f9) ![HyperrefEx2OverleafVb.png](/files/c42304d5b97dfe01a18e7beeb6f0d99d37f070fa) هذا مثال كامل، وسيتم شرحه بالكامل في بقية المقالة. فيما يلي وصف للأوامر المتعلقة بلون الروابط وتنسيقها. **\hypersetup{ ... }** سيؤدي هذا إلى ضبط الخيارات لتكوين سلوك الروابط داخل المستند. يجب أن تكون كل معلمة مفصولة بفاصلة، وأن يكون التنسيق على النمط المعلمة=value. **colorlinks=true** ستكون الروابط ملوّنة، واللون الافتراضي هو الأحمر. **linkcolor=blue** تُعرض الروابط الداخلية، أي تلك التي تُنشأ بواسطة العناصر المشار إليها مرجعيًا، باللون الأزرق. **filecolor=magenta** ستُعرض الروابط إلى الملفات المحلية باللون الأرجواني (انظر ربط الملفات المحلية). **urlcolor=cyan** تُضبط روابط مواقع الويب على اللون السماوي (انظر ربط عناوين الويب). **urlstyle{same}** تطبع الإعدادات الافتراضية الروابط بخط أحادي التباعد، ويغيّر هذا الأمر ذلك ويعرض الروابط بالنمط نفسه لبقية النص. ## ربط عناوين الويب يمكن إضافة روابط إلى عنوان ويب أو بريد إلكتروني إلى ملف LaTeX باستخدام `\url` الأمر لعرض الرابط نفسه، أو `\href` لاستخدام رابط مخفي وعرض كلمة/جملة بدلًا منه. ```latex لمزيد من المراجع انظر \href{http://www.overleaf.com}{Something Linky} أو انتقل إلى الرابط التالي: \url{http://www.overleaf.com} ``` ![HyperlinkExampleUpdatedMore.png](/files/78cc8fafcec4abaf288b911e4af9aa0f8891258f) يوجد أمران في المثال ينشئان رابطًا في المستند النهائي: **\href{ Linky}** يتم تمرير معاملين إلى هذا الأمر؛ الأول هو عنوان URL للرابط، وهو هنا والثاني هو النص القابل للنقر الذي سيظهر، وهو Something Linky. **\url{** سيعرض هذا الأمر عنوان URL الممرّر كمعامل ويحوّله إلى رابط، وهو مفيد إذا كنت ستطبع المستند. [افتح مثالًا على حزمة hyperref في Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## ربط الملفات المحلية الأوامر `\href` و `\url` يمكن استخدامه كما عُرض في القسم السابق لفتح الملفات المحلية ```latex لمزيد من المراجع انظر \href{http://www.overleaf.com}{Something Linky} أو انتقل إلى الرابط التالي: \url{http://www.overleaf.com} أو افتح التالي الملف \href{run:./file.txt}{File.txt} ``` ![HyperlinkExampleUpdatedMoreNext.png](/files/9eac85d73b01667f06d5dbc8a79b5e72ea75c26b) الأمر `\href{run:./file.txt}{File.txt}` يطبع النص `File.txt` الذي يربط بملف محلي يُسمّى `file.txt` الموجود في دليل العمل الحالي. لاحظ النص `run:` قبل مسار الملف. يتبع مسار الملف الاصطلاحات الخاصة بأنظمة UNIX، باستخدام `.` للإشارة إلى الدليل الحالي و `..` للدليل السابق. الأمر `\url{}` يمكن أيضًا استخدامه، مع النحو نفسه الموصوف للمسار، ولكن يُذكر أن فيه بعض المشكلات. [افتح مثالًا على حزمة hyperref في Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## إدراج الروابط يدويًا ذُكر سابقًا أن جميع العناصر المشار إليها مرجعيًا تصبح روابط بمجرد **hyperref** استيراد `\label` يمكننا استخدامه في أي مكان في المستند ثم الإشارة إلى تلك التسميات لاحقًا لإنشاء روابط. وهذه ليست الطريقة الوحيدة لإدراج الروابط التشعبية يدويًا. ```latex من الممكن أيضًا ربط أي كلمة مباشرةً أو \hyperlink{thesentence}{أي جملة} في مستندك. إذا قرأت هذا النص، فلن تحصل على أي معلومات. حقًا؟ ألا توجد أي معلومات؟ على سبيل المثال \hypertarget{thesentence}{هذه الجملة}. ``` ![HyperlinkExampleUpdatedMoreNextAgain.png](/files/ea16860f43b44fdb0d41f43aee47f6f3085464df) هناك أمران لإنشاء روابط يحددها المستخدم. **\hypertarget{thesentence}{هذه الجملة}** المعامل الأول الممرّر داخل الأقواس إلى هذا الأمر هو معرّف فريد لهذه الجملة. أما المعامل الثاني فهو النص "هذه الجملة"، وسيُطبع بشكل عادي (اعتمادًا على قيمة anchorcolor، انظر دليل المرجع)، ولكن عند النقر على رابط يشير إلى المعرّف "thesentence" فسوف يمرر ملف PDF إلى هذا الموضع. **\hyperlink{thesentence}{أي جملة}** يطبع هذا الأمر النص "أي جملة" كعنصر قابل للنقر يعيد التوجيه إلى الموضع الذي معرّفه هو "thesentence". [افتح مثالًا على حزمة hyperref في Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=\&mainFile=main.tex) ## خيارات خاصة بـ PDF تُنشأ الروابط في المستند مع وضع مستند سيُقرأ بصيغة PDF في الاعتبار. ويمكن تخصيص ملف PDF أكثر لإضافة معلومات إضافية وتغيير الطريقة التي يعرض بها عارض PDF المستند. فيما يلي مثال: ```latex \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={مثال Overleaf}, pdfpagemode=FullScreen, } ``` ![Pdftitle.png](/files/b6c2bc75ce919ce3ac0b1e32593a7d5f8145e28b) باستخدام الأمر `\hypersetup`، الموصوف في القسم [الأنماط والألوان](#styles-and-colours)، يقبل معاملات إضافية لإعداد ملف PDF النهائي. **pdftitle={مثال Overleaf}** هو عنوان ملف إخراج PDF، ليُعرض في شريط عنوان النافذة. في المثال هو "Overleaf Example". **pdfpagemode=FullScreen** سيفتح المستند في وضع ملء الشاشة بواسطة قارئ PDF. انظر [دليل المراجع](#reference-guide) للحصول على قائمة كاملة بالخيارات التي يمكن تمريرها إلى `\hypersetup`. [افتح مثالًا على حزمة hyperref في Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## دليل المراجع **خيارات نمط الربط** | الخيار | القيمة الافتراضية | الوصف | | ------------- | ----------------- | ------------------------------------------------------------------- | | `hyperindex` | صحيح | يجعل أرقام الصفحات في عناصر الفهرس روابط تشعبية | | `linktocpage` | خطأ | يجعل أرقام الصفحات، بدلًا من النص، هي الرابط في جدول المحتويات. | | `breaklinks` | خطأ | يسمح بتقسيم الروابط إلى عدة أسطر. | | `colorlinks` | خطأ | يُلوّن نص الروابط والمرتكزات، وستظهر هذه الألوان في النسخة المطبوعة | | `linkcolor` | أحمر | لون الروابط الداخلية العادية | | `anchorcolor` | أسود | لون نص المرساة (الهدف) | | `citecolor` | أخضر | لون الاقتباسات الببليوغرافية | | `filecolor` | سماوي | لون الروابط التي تفتح ملفات محلية | | `urlcolor` | أرجواني | لون عناوين URL المرتبطة | | `frenchlinks` | خطأ | استخدم الأحرف الكبيرة الصغيرة بدلًا من الألوان للروابط | **خيارات خاصة بـ PDF** | الخيار | القيمة الافتراضية | الوصف | | ----------------- | ----------------- | ------------------------------------------------------------------------------------------------------------- | | `bookmarks` | صحيح | تُكتب علامات أكروبات المرجعية، على نحو مشابه لجدول المحتويات. | | `bookmarksopen` | خطأ | تُعرض العلامات المرجعية مع توسيع جميع الفروع الفرعية. | | `citebordercolor` | 0 1 0 | لون الإطار حول الاقتباسات بصيغة RGB. | | `filebordercolor` | 0 .5 .5 | لون الإطار حول الروابط إلى الملفات بصيغة RGB. | | `linkbordercolor` | 1 0 0 | لون الإطار حول الروابط العادية بصيغة RGB. | | `menubordercolor` | 1 0 0 | لون الإطار حول روابط القوائم بصيغة RGB. | | `urlbordercolor` | 0 1 1 | لون الإطار حول الروابط إلى عناوين URL بصيغة RGB. | | `pdfpagemode` | فارغ | يحدد كيفية فتح الملف. الاحتمالات هي UseThumbs (الصور المصغرة)، وUseOutlines (العلامات المرجعية)، وFullScreen. | | `pdftitle` | | يضبط عنوان المستند. | | `pdfauthor` | | يضبط مؤلف المستند. | | `pdfstartpage` | 1 | يحدد الصفحة التي يُفتح عندها ملف PDF. | ## قراءة إضافية لمزيد من المعلومات، انظر * [جدول المحتويات](/latex/ar/bnyh-almstnd/02-table-of-contents.md) * [الأقسام والفصول](/latex/ar/bnyh-almstnd/01-sections-and-chapters.md) * [الإحالة المتبادلة بين الأقسام والمعادلات](/latex/ar/bnyh-almstnd/03-cross-referencing-sections-equations-and-floats.md) * [استخدام الألوان في LaTeX](/latex/ar/altnsyq/13-using-colors-in-latex.md) * [الإدارة في مشروع كبير](/latex/ar/bnyh-almstnd/07-management-in-a-large-project.md) * [دليل Hyperref](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/hyperref/doc/manual.pdf) * [مقالة الروابط التشعبية على wikibooks](http://en.wikibooks.org/wiki/LaTeX/Hyperlinks) --- # 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/bnyh-almstnd/09-hyperlinks.md?ask=&goal= ``` `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.