ملاحظات LaTeX

ملفات .tex و.latex ملاحظات لا مستوردات: تُحرَّر وتُنشر وتُبحث وتُربط كما تُعامل ملاحظات ماركداون تمامًا.

LaTeX هي لغة التنضيد التي يكتب بها العلماء والرياضيون أوراقهم، وملف .tex هو مصدرها. وفي أسطرلاب، ملف .tex ملاحظة، لا شيء يُستورد ويُحوَّل. فهو في الشجرة، وفي البحث، وفي المخطط، وفي لوحة الروابط الراجعة، وفي أعداد الوسوم، وفي قائمة التدوينات، وفي خلاصة RSS، ويُنشر على المدونة كما تُنشر ملاحظة .md بالضبط: الخطوط نفسها، والسمات نفسها، والحدود نفسها لما يراه الزائر، باللغتين. ويظل مع ذلك pdflatex ينضّده كما كان، لأن كل ما يضيفه أسطرلاب إما تعليق LaTeX وإما ماكرو (أمر تعرّفه بنفسك) تضعه بجانب الملف.

• محرر معاينة حية. وضع stex في CodeMirror، بألوان أي سمة من السمات الست والأربعين أنت فيها، وبالاتفاق نفسه الذي يعقده محرر ماركداون: يعرض السطر الذي عليه المؤشر TeX خامًا، ويُقرأ كل سطر آخر كما سيصير بعد التنضيد. تظهر عناوين الأقسام بخط مُذيَّل؛ وتُعرض \emph و\textbf و\texttt بأثرها؛ ويصير \item نقطة أو رقمًا؛ ويُنضَّد $…$ وبيئات العرض بـKaTeX؛ ويصير \cite شريحة؛ ويعرض \begin{figure} صورة خزانتك الفعلية بتعليقها. (أما أرقام الأقسام والمعادلات فلعرض القراءة. فهي خاصية للمستند كله، ورقم يعيد ترقيم نفسه كلما كتبت فوقه تشتيت لا معاينة؛ وتطبعها لوحة المحتويات بجانب المحرر.) واطوِ أي بيئة أو قسم من السهم الصغير الذي بجانبه. ويغطي الإكمال التلقائي \note{ و\ref{ و\cite{ و\begin{ (الذي يكتب لك \end المقابل).
• مفاتيح التنسيق تكتب LaTeX هنا. يكتب Ctrl/Cmd B في ملاحظة .tex الأمر \textbf{…} لا **…**؛ ويكتب Ctrl/Cmd I الأمر \emph{…}؛ والكود السطري \texttt{…}؛ و«عنوان 2» هو \subsection{…}؛ والقائمة النقطية بيئة itemize؛ ورابط الويكي \note{…}. أما الشطب والتظليل وقائمة المهام ومربعات الألوان فغائبة من القائمة في ملاحظة .tex بدل تقريبها: فلا يستطيع LaTeX أن يكتبها من غير حزمة قد لا يحمّلها مستندك، ومفتاح يكتب في صمت شيئًا لا يستطيع أسطرلاب ولا pdflatex عرضه أسوأ من مفتاح لا يفعل شيئًا.
• القراءة والنشر. يُعرض الملف باللغة البصرية نفسها التي لماركداون: أقسام مرقّمة، ومعادلات مرقّمة، وتعليقات «الشكل 1»، وصناديق مبرهنات، وإحالات مرجعية محلولة، وقائمة مراجع من \bibitem، وحواشٍ. وتتبع لوحة المحتويات تسلسل \section.
• مقدمة يتجاهلها pdflatex. كتلة تعليق في أول الملف:

  %---
  % publish: true
  % tags: [physics, fourier]
  % banner: "Media/heat.png"
  %---%
  

  أو، إن فضّلت أن تكتب ماكرو، \astrolabe{publish=true, citekey=fourier1822}.
• روابط بثلاث طرق. \note{Fourier Transform} و\note[the transform]{Fourier Transform} ماكرو أسطرلاب الخاص (ضع astrolabe.sty بجانب الملف فيُنضَّد في أي مكان). و%% [[Private Scratch]] %% رابط لا يظهر في PDF أبدًا. أما المشروع الموجود أصلًا فتعمل روابطه من غير تعديل، لأن \input و\include و\cite و\ref و\eqref تقول ما تعنيه أصلًا: لا يزيد أسطرلاب على أن يبحث عمّا تسمّيه في الخزانة أيضًا، بعد أن يبحث بجانب الملف أولًا، فلا يغيّر جلب مشروع إلى الخزانة شيئًا مما ينتجه.
• العناوين والتسميات شيء واحد. عنوان ماركداون و\label في LaTeX شيء واحد من حيث النوع، لذلك [[Heat Equation#eq:fourier]] و\note{Notes\#Derivation} بحث واحد في أي من الاتجاهين، ويضمّن ![[Heat Equation#eq:fourier]] تلك المعادلة وحدها، معروضة بـKaTeX، في ملاحظة ماركداون.

تأخذ ملاحظة .tex اتجاه نص الموقع، فتُكتب الورقة العربية من اليمين إلى اليسار، لكنها ترفض إعداد المحاذاة: فمصدرها ترميز من أوله إلى آخره.

astrolabe.sty

الأسطر الاثنا عشر التي تجعل \note{…} مفهومًا خارج أسطرلاب. نزّله من نسختك على /api/astrolabe.sty (أو «LaTeX: نزّل astrolabe.sty» في لوحة الأوامر)، وضعه بجانب مستندك، وأضف \usepackage{astrolabe}. من غيره يظل الملف يُفتح في أسطرلاب؛ ومعه ينضّد pdflatex الملف نفسه بالضبط.

ما يُعرض وما لا يُعرض

حدّ صادق خير من ادّعاء «LaTeX كامل» لا يصمد. كل ما ليس في القائمة أدناه يُمرَّر علامةً سطرية هادئة، لا مصدرًا خامًا ولا انهيارًا، والمستند الذي لا يمكن تحليله يظل يُفتح ويُدرج ويُنشر ويُبحث عنه بعنوانه.

وثمة تبسيطات معروفة، نقولها لك مقدمًا بدل أن تكتشفها بنفسك: الترقيم بأسلوب المقالة (1 و1.1 و1.1.1) أيًّا كان صنف المستند؛ ويطبع \ref رقمًا حين تكون التسمية في الملاحظة نفسها، وعنوان الهدف حين تكون في ملاحظة أخرى، لأن «1» مجردة لا تعني شيئًا في ورقة شخص آخر؛ ولا يُشغَّل BibTeX، فيبحث \cite عن \bibitem في المستند أو عن ملاحظة تحمل ذلك citekey:، وإلا تُرك كما هو.