دليل استخدام Presswork (AR)

يشرح هذا الدليل جميع وظائف Presswork، مع مسار موجَّه لكل منطقة من مناطق التطبيق.

1. نظرة عامة

Presswork هو محرّر Markdown احترافي للنشر والنشر الذاتي. يجمع بين الكتابة النظيفة والأدوات التحريرية (الأسلوب، الملخص، الإصدارات) والتصدير الاحترافي (PDF, PDF/X, EPUB, DOCX, HTML, ICML, FDX). يتضمّن Typst لملفات PDF سريعة، ويدعم LaTeX + Ghostscript لملفات PDF/X المعتمدة.

2. المتطلبات والتثبيت

مضمّن: Pandoc، Typst (PDF أساسي)، محركات داخلية.
اختياري (Pro): LaTeX و Ghostscript لملفات PDF/X المعتمدة.

أين تتحقق:

الأدوات ← فحص التصدير: التحقق ودليل التثبيت.

3. الأوضاع والتراخيص (Base / Pro)

Base: واجهة مبسطة، PDF سريع عبر Typst، خيارات أقل.
Pro: PDF/X، الفحص المسبق، التصدير المتعدد، خيارات متقدمة وأدوات تحريرية كاملة.
بدّل سريعاً عبر مفتاح Base/Pro في الشريط العلوي؛ تُدار الخطة الكاملة والترخيص من الإعدادات ← التطبيق ← عرض العمل.

4. الواجهة الرئيسية

الشريط العلوي: وصول سريع إلى المستند، الأدوات، التصدير، العرض، الترخيص، الدليل.
المحرّر: منطقة Markdown مع شريط أدوات واختصارات.
الشريط الجانبي: Outline، Snapshot، Backlink، Scrivener.
شريط الحالة: كلمات، أحرف، سطر/عمود، أهداف.

5. قائمة المستندات

جديد: ينشئ مستنداً جديداً.
حفظ MD / حفظ باسم…: يحفظ بصيغة .md.
استيراد مستند: Word (.docx, .doc)، ODT، HTML، Markdown، PDF، ICML، Final Draft. الصور تدخل مع النص: صور مستند Word — بما فيها جداول Excel المُلصقة كصورة — والصور المضمّنة في ملف PDF تُستخرج إلى مجلد بجوار الملف المستورد. أما ما هو رسم متجهي داخل PDF (وكثير من الرسوم البيانية كذلك) فليس صورة ولا يمكن استخراجه.
فتح مشروع: يحمّل مشروعاً منظماً بالفصول.
وضع البنية: إدارة الفصول/الترتيب.
إدارة المشروع: إنشاء/تحديث المشاريع التحريرية.
طباعة: يطبع المستند الحالي.
الإصدارات: سجل الحفظ التلقائي والاستعادة.

سير العمل الموصى به:

أنشئ مستنداً أو مشروعاً.
احفظ كثيراً.
استخدم «الإصدارات» لاستعادة المراجعات.

6. قائمة الأدوات

الأهداف: أهداف كلمات يومية أو لكل مستند.
الإحصائيات: مسار الكتابة، الإيقاع، الصعوبة، التدفق.
دليل المستخدم: دليل مدمج.
فحص التصدير: يتحقق من LaTeX/Ghostscript.
Command Palette: بحث عن الأوامر (Ctrl/Cmd + P).
تحليل الأسلوب: التكرارات، سهولة القراءة، النبرة، الشمولية.
مساعد الذكاء الاصطناعي: ملخصات، إعادة صياغة، اتساق.
وضع Vim: أوامر Vim.
Collab: جلسات تعاونية P2P مع دعوة سريعة عبر معرّف الجلسة.
- بداية سريعة: افتح الأدوات ← Collab، اكتب اسمك، أنشئ أو الصق معرّف جلسة (pw-...) واضغط اتصال.
- أثناء المكالمة: استخدم مفتاحي الميكروفون والكاميرا في اللوحة العائمة؛ إذا فشل WebRTC فاضبط مرحّل WebSocket ‏(presswork-collab-relay-url).
الجولة: مسار موجَّه للصيغ الخاصة.
التوقيع الرقمي: توقيع PDF بشهادة (Pro).

7. قائمة التصدير

الصيغ الرئيسية

PDF (Typst، سريع)
PDF/X (LaTeX، معتمد)
PDF سيناريو (هوليوود)
FDX (Final Draft)
DOCX / ODT
EPUB
HTML
ICML (InCopy/InDesign)

الخيارات

نمط PDF: اختيار قالب PDF.
PDF/X: ملف ICC، التحقق، تضمين الخطوط.
علامات القص/الهامش الزائد: خيارات الطباعة.
بيانات EPUB الوصفية + الغلاف.
الفحص المسبق: قائمة تحقق للجودة والطباعة.
سجل التصدير: سجل عمليات التصدير.
تصدير متعدد: عدة ملفات في ملف واحد.
تصدير متعدد الصيغ: PDF + EPUB + HTML إلخ.
تصدير مع الموارد: يشمل الصور/الموارد.
تحويل مجلد: تحويل دفعي.

8. قائمة العرض

الأوضاع: كتابة، كود، معاينة، صفحة، Split.
اللغة: 9 لغات للواجهة.
السمة: فاتح/داكن.
الآلة الكاتبة: السطر النشط في المنتصف.
وضع التركيز: يخفي الواجهة (F11).
العرض التقديمي: شرائح ملء الشاشة.
إمكانية الوصول: حجم النص، التباين، خط عسر القراءة.

9. شريط أدوات المحرّر

التنسيق: عريض، مائل، مسطّر.
العناوين: H1/H2/H3.
العناصر: روابط، صور، كود سطري/كتلي.
القوائم: نقطية/مرقّمة.
الاقتباسات.
الجداول.
CriticMarkup: إدراج، حذف، تعليق.
القوالب: إعدادات تنسيق جاهزة.
البيانات الوصفية: YAML front matter.
Snapshot: لقطات المشاهد.
الملخص: ملخصات لكل فصل.

10. لوحات الشريط الجانبي

Outline: التنقل بين الأقسام.
Snapshot: إدارة اللقطات.
Backlink: روابط بين المستندات.
Scrivener: الفصول والسحب والإفلات.
Scene Navigator: للسيناريوهات.

11. الكتابة بـ Markdown

التركيب الأساسي

# عنوان / ## عنوان فرعي
**عريض**، *مائل*
- قائمة / 1. قائمة مرقّمة
[رابط](url)
![alt](صورة)
> اقتباس
\newpage لفاصل صفحة

نصائح

اسحب وأفلت الصور.
استخدم Split أو المعاينة لمراقبة التنسيق.

12. القوالب

قوالب جاهزة: الوصول من شريط الأدوات (Tpl).
قوالب مخصصة:
- استيراد ملف واحد أو مجلد (قائمة القوالب ← «استيراد ملف / استيراد مجلد»).
- تصنيف تلقائي في تبويبات: css←UI Kit، ‏xlsx/xls/ods/csv←Business، والبقية←مستندات.
- شارة Custom وتلميح كامل عند التحويم (الاسم + الوصف).
- .md: يمكن تحميلها في المحرّر.
- .tex/.pdfx/.pdft: تُستخدم كأنماط تصدير PDF.
- .xlsx/.xls/.ods/.csv: تُستخدم في تدفقات جداول البيانات/التقارير.
الاقتران التلقائي UI↔PDF: يمكن لسمات CSS الاقتران تلقائياً بقالب PDF (مفتاح + فك الاقتران).
مكتبة مشتركة: حفظ إعدادات طباعية مشتركة.
المرجع الكامل لوظائف القوالب: docs/template-functions-overview-en.md.

13. البيانات الوصفية و front matter

محرّر بيانات وصفية للعنوان والمؤلف و ISBN.
‏YAML front matter لتصدير متسق.
EPUB: يُنصح بشدة بالغلاف والبيانات الوصفية.

14. المشاريع ووضع البنية

المستندات ← إدارة المشروع.
أنشئ مجلد المشروع.
أضف الفصول (.md).
أعد الترتيب بالسحب والإفلات.
صدّر الكل بترتيب تلقائي.

15. التصدير بالتفصيل

15.1 PDF أساسي (Typst)

سريع، بلا LaTeX.
مثالي للمسودات والمراجعات.

15.2 PDF/X (LaTeX)

يستخدم قالباً معتمداً.
يتطلب LaTeX + Ghostscript.
يدعم ICC والتحقق والفحص المسبق.

15.3 PDF سيناريو

تنسيق هوليوود.
متوافق مع Fountain.

15.4 FDX (Final Draft)

تصدير لتدفقات العمل السينمائية، مع تقرير .breakdown.json مرافق (مشاهد، شخصيات، وسوم).
الحوار المتزامن: أضف ^ بعد اسم الشخصية الثانية (GUIDO^) — في Final Draft يظهر الحواران متجاورين (dual dialogue أصلي)؛ وعند استيراد .fdx يعود ^ تلقائيًا.
وسوم الإنتاج: انقر بالزر الأيمن على كلمة محددة → وسم للإنتاج، أو اكتب [[prop: مصباح]] أو #prop: مصباح في نهاية السطر. في FDX تصبح وسوم Tagger أصلية؛ وفي بقية الصيغ تُزال العلامات؛ والوسوم المطبقة في Final Draft تعود عند الاستيراد.
المفاتيح الرئيسية (بالإيطالية أو الإنجليزية): prop، costume، vehicle، sound، music، makeup، animal، effects، location، note.
العنوان والمؤلف (من الـ front matter أو # العنوان + "by …" في بداية المستند) ينتقلان إلى Title Page في Final Draft.

15.5 DOCX/ODT

تحويل عبر Pandoc.

15.6 EPUB

يُنصح بالبيانات الوصفية + الغلاف.
متوافق مع المتاجر الرقمية.

15.7 HTML

إخراج ويب مع الموارد.

15.8 ICML

أنماط مُعيَّنة لـ InDesign/InCopy.
تتحول العناوين والقوائم والاقتباسات والسيناريو إلى أنماط مخصصة.
إعدادات قوالب مضمّنة + استيراد ملف .icml مخصص.
حواشٍ حقيقية (يرقّمها InDesign)، وروابط بوجهات، وجداول برؤوس ومحاذاة، وصور كإطارات مرتبطة (لوحة الروابط)، وحروف علوية/سفلية وأحرف صغيرة — حتى داخل الخلايا والحواشي والروابط.
استيراد وفيّ: ملف ICML مُصدَّر ثم يُعاد فتحه في PressWork يحافظ على المستند (الذهاب والإياب متحقق منه في CI حتى مع المخطوطات الطويلة).

15.9 Excel

تصدير Excel مع تفصيل المشاهد والشخصيات والإنتاج.
دعم القوالب: يكتب في الأوراق الموجودة للحفاظ على الأنماط الأساسية.
استيراد متعدد الأوراق إلى جداول Markdown (مع بيانات وصفية للنوع/الخلية).
اختيار الورقة والنطاق عند الاستيراد لتجنّب البيانات غير المرغوبة.
Chart Mapper: اختياري، يولّد رسوماً بيانية للمعاينة من بيانات Excel.

16. التصدير المتقدم

تصدير متعدد: يدمج عدة مستندات.
تصدير متعدد الصيغ: يولّد PDF+EPUB+HTML في مجلد واحد.
تصدير مع الموارد: ينسخ الصور والموارد.
سجل التصدير: السجل والنتائج.

17. KDP (أمازون)

Quick Export: ‏PDF + EPUB بتسمية KDP.
الحاسبة: الأبعاد والهوامش.
قوالب KDP: أغلفة/تنسيقات مخصصة.
مدقّق ePub: قائمة تحقق، معاينة Kindle وتقرير قابل للتنزيل.

18. تحليل الأسلوب

الجمل الطويلة، التكرارات، المبني للمجهول.
اقتراحات ضمن النص.
مقاييس سهولة القراءة.

19. مساعد الذكاء الاصطناعي

ملخصات، إعادة صياغة، اتساق، عناوين.
خدمات سحابية جاهزة في القائمة: OpenAI وAnthropic (Claude) وMistral والوسطاء مثل OpenRouter. اختيار إحداها يضبط العنوان والنموذج، ولا يبقى سوى لصق المفتاح.
كل خدمة تتذكّر مفتاحها: الانتقال من واحدة إلى أخرى لم يعد يتطلّب إدخاله في كل مرة. المفاتيح محفوظة في سلسلة مفاتيح نظام التشغيل، لا في ملف من ملفات التطبيق.
النماذج المحلية: بالضغط على «اكتشاف Ollama» تظهر النماذج المثبّتة على حاسوبك. هناك لا حاجة إلى أي مفتاح، ولا يغادر شيء الجهاز.
اختبار الاتصال يفحص القناة التي تستعملها فعلاً — السحابية إن كان لديك مفتاح، والمحلية بخلاف ذلك — ويقول أيّهما فحص.

20. التعاون (P2P)

جلسات مشتركة مع مؤشرات بعيدة ملوّنة وتعليقات ضمن النص ومزامنة حية.
مكالمات صوت/فيديو مدمجة أثناء الجلسة.
معرّف جلسة قابل للمشاركة (pw-...) لدعوة مستخدمين آخرين بسرعة.

كيفية الاستخدام (خطوة بخطوة)

افتح الأدوات ← Collab واختر اسماً يسهل تمييزه.
أنشئ جلسة جديدة أو الصق المعرّف الذي وصلك من زميل.
انتظر حالة Online وتحقق من المشاركين في لوحة التعاون.
إذا احتجت الصوت/الفيديو، ابدأ المكالمة من لوحة Collab واستخدم أزرار كتم الصوت/الكاميرا.
في الشبكات المؤسسية المقيّدة، اضبط مرحّل WebSocket ‏(مفتاح localStorage: presswork-collab-relay-url).

21. التوقيع الرقمي

توقيع PDF بشهادة PAdES-T.
ختم زمني RFC 3161 (يتطلب اتصالاً بالشبكة).

22. العرض التقديمي

يحوّل المستندات إلى شرائح.
تنسيقات ولوحات ألوان قابلة للتخصيص.

23. إمكانية الوصول

حجم النص 12–18px.
تباين عالٍ.
خط مناسب لعسر القراءة.

24. الاختصارات الرئيسية

Ctrl/Cmd + S ← حفظ
Ctrl/Cmd + N ← جديد
Ctrl/Cmd + P ← Command Palette
Ctrl/Cmd + Shift + P ← عرض تقديمي
F11 ← وضع التركيز
Ctrl/Cmd + B/I/U ← عريض/مائل/مسطّر
Ctrl + Alt + V ← Vim

25. حل المشكلات

PDF/X غير متاح: ثبّت LaTeX + Ghostscript وأعد التشغيل.
القوالب غير ظاهرة: استخدم «فتح مجلد القوالب» وتحقق من الامتدادات.
تصدير بطيء: عطّل التحقق في مرحلة المسودة.

26. مسارات مفيدة

القوالب المخصصة: مجلد presswork/templates داخل دليل إعدادات المستخدم.
PDF/X ICC: مجلد presswork/pdfx.

يجمع Presswork بين البساطة والأدوات التحريرية الاحترافية: اكتب بسرعة في Base، وانشر في Pro.

التحديثات الأخيرة (Data Hub / الرسوم البيانية)

إدراج رسم بياني من Excel Data Hub يعرض الآن معاينة صورة فورية في المحرّر أيضاً، وليس في لوحة المعاينة فقط.
تم تصغير المعاينة الضمنية (نحو 50%) لتكون أقل إزعاجاً أثناء الكتابة.
تبديل ثنائي الاتجاه: 📝 إظهار الكود يفتح كتلة chart-data، و**🖼️ العودة إلى الرسم** يستعيد عرض الصورة.
تبقى كتلة chart-data في Markdown لضمان التوافق مع المعاينة/العرض/التصدير.
إدراج جدول أو رسم بياني كصورة يحفظ الملف الآن في موارد المستند (اسم_المستند.assets/images/) ولا يدخل المحرّر سوى مرجع Markdown: يعمل حتى مع الأوراق الكبيرة جداً.
إذا لم يكن المستند محفوظاً بعد، يعرض التطبيق حفظه فوراً (كما مع سحب الصور)؛ عند الرفض يدخل الجدول كنص Markdown ويبقى الرسم في الورقة.
سؤال نص/صورة يفهم أيضاً إجابات مثل "png" و"jpg" و"صورة"؛ الإجابة غير المفهومة تعيد طرح السؤال.
شبكة البيانات تتبع السمة الفاتحة/الداكنة النشطة.
حفظ كقالب: نافذة أعيد تصميمها بنمط التطبيق ومترجمة. تتطلب بيانات في الشبكة ونموذجاً في المحرّر بعناصر نائبة {{اسم_العمود}}؛ «توليد Markdown» يكرر النموذج لكل صف.
تصدير Excel (التفصيل): يقرأ نص المحرّر (مشاهد INT./EXT. أو فصول #)؛ إذا لم يجد مشاهد ينبّه الآن بدلاً من توليد ملف فارغ.
تبسيط قائمة Tables: أُزيل البند المكرر «استيراد كقالب» (مطابق لـ«فتح ورقة Tables»).
لوحة الاستيراد/التصدير: تبويب متعدد جديد (بجوار الصيغة الأساسية / الطباعة الاحترافية / السيناريو / النشر) يجمع الإجراءات الدفعية: تحويل مجلد، تصدير متعدد، متعدد الصيغ، مع الموارد. الخيارات المتقدمة تعرض فقط ما يخص الصيغة المختارة.
🧪 التحقق من ICML: في لوحة التصدير (صيغة ICML) يفحص المستند المولَّد — التسلسل، front matter، الهروب، الفقرات الفارغة — دون كتابة أي شيء على القرص؛ تظهر التفاصيل في نافذة داخل التطبيق. يجري الفحص نفسه على أي حال عند كل تصدير ICML.
تصدير FDX أكثر أماناً: يتحول Markdown العام (قوائم، جداول، ملاحظات) دائماً إلى Action — ولا يصبح شخصية/حواراً بالخطأ أبداً؛ تظل السيناريوهات الحقيقية مفسَّرة (مشاهد، شخصيات، حوارات، انتقالات). يصبح \newpage فاصل صفحة حقيقياً (وفي ICML أيضاً عبر نمط «فاصل صفحة» قابل لإعادة التعيين).
الطباعة عبر PDF: زر الطباعة يولّد PDF مؤقتاً (Typst، بنفس طباعة التصدير) ويفتحه في عارض النظام — تتم الطباعة من الحوار الأصلي بمعاينة دقيقة.
إعدادات معاد ترتيبها: قسم التثبيتات (LaTeX بنقرة واحدة، حالة Ghostscript)، اللغة في عرض مضغوط، السمة برقاقتي داكن/فاتح. المطالبات السريعة في لوحة الذكاء الاصطناعي قابلة للطي.

27. تحليل معمّق للوظائف (سد الثغرات)

يكمل هذا القسم الوظائف المتقدمة التي كثيراً ما تُهمل لقلة ظهورها في القوائم.

27.1 الذكاء الاصطناعي: الإعداد والتشخيص وجودة الاستجابة

‏endpoints سحابية/محلية قابلة للإعداد (متوافقة مع OpenAI و Ollama و LM Studio) عبر المتغيرات PRESSWORK_AI_ENDPOINT وPRESSWORK_AI_MODEL وPRESSWORK_AI_API_KEY.
تشخيص اتصال الذكاء الاصطناعي مع تقرير JSON قابل للتصدير (مفيد للدعم الفني/فرق تقنية المعلومات).
التحكم في أسلوب الاستجابة (موجز/متوازن/مفصّل)، معاينة المطالبة التقنية وإعادة إرسال آخر مطالبة.
تثبيت endpoint/نموذج لكل مشروع: يحافظ على الاتساق التحريري بين المستندات.

27.2 الإحصائيات: طريقة الحساب (عملياً)

متوسط الإنتاجية: يُحسب على السجل اليومي (7 أيام / 30 يوماً).
سرعة الكتابة: إجمالي الكلمات مقسوماً على نافذة الجلسات (كلمة/ساعة وكلمة/دقيقة).
‏TTR (نسبة الأنواع إلى الرموز): الكلمات الفريدة / إجمالي الكلمات.
‏MSTTR: متوسط TTR على نوافذ من 50 كلمة (يقلل التحيّز في النصوص الطويلة).
حالة التدفق الفورية: متوسط الفاصل بين الضغطات + نسبة الحذف الأخيرة.
توقّع الإنجاز: تقدير متفائل/متشائم باستخدام متوسطي 7 أيام و30 يوماً.

27.3 عمليات تصدير متقدمة غائبة عن الدليل السريع

‏Final Draft (.fdx): يعيّن العناوين إلى Scene Headings حقيقية، ويدعم الملاحظات/فواصل الصفحات/ترقيم المشاهد، ويولّد الملف المرافق .breakdown.json.
‏ICML: تعيين طباعي متقدم (عناوين/قوائم/اقتباسات/سيناريو) + إعدادات جاهزة + استيراد .icml مخصص.
معالج EPUB/ICML: يمنع التصدير حتى تُضبط البيانات الوصفية الدنيا (العنوان/المؤلف/ISBN) والغلاف.
توقيع PDF: ‏PKCS#7 منفصل + ختم زمني RFC 3161.

27.4 وضع الحزمة (.pwk)

الإجراء الرئيسي: تصدير مع اختيار الوجهة.
أهداف إخراج تلقائية لتقليل أخطاء المسار اليدوية.
مفتاح في الشريط العلوي لإظهار التصدير السريع الكلاسيكي مؤقتاً.

27.5 التعاون (P2P) في السياقات الواقعية

معرّف جلسة قابل للمشاركة pw-...، مؤشرات بعيدة ملوّنة، تعليقات ضمن النص، مزامنة حية.
مكالمة صوت/فيديو مدمجة في الجلسة التحريرية نفسها.
مرحّل WebSocket احتياطي إذا لم يمرّ WebRTC (شبكات مؤسسية/جدران نارية)، عبر المفتاح presswork-collab-relay-url.

27.6 نظام القوالب (استخدام احترافي)

استيراد ملف/مجلد مع تصنيف تلقائي (Business / مستندات / UI Kit).
دعم القوالب الثنائية وجداول البيانات لتدفقات التقارير.
الاقتران التلقائي UI↔PDF لربط سمة المحرّر بنمط التصدير، مع خيار فك الاقتران.

27.7 قائمة تحقق تشغيلية موصى بها

اضبط وضع Base/Pro حسب المخرَج المطلوب.
تحقق من المتطلبات في فحص التصدير (LaTeX/Ghostscript فقط إذا احتجت PDF/X).
نفّذ الفحص المسبق قبل التسليم.
لملفات EPUB/ICML أكمل معالج البيانات الوصفية + الغلاف.
للمستندات الموقّعة فعّل توقيع PKCS#7 + الختم الزمني.
في الفرق، احفظ معرّف جلسة Collab والمرحّل الاحتياطي في السياسة الداخلية.

28. ربط مساعد (MCP)

بدءاً من 4.2 يعمل PressWork جسر MCP: مساعدو الذكاء الاصطناعي في الدردشة (Claude Desktop وCodex CLI وGemini CLI…) يقرؤون مشاريع .pwk مباشرة من حاسوبك — الفصول والملاحظات والإحصاءات — دون نسخ ولصق. قراءة فقط: لا يملك الجسر أي أداة للكتابة، بل سبع أدوات للقراءة فقط. وإذا كان المساعد الذي تربطه يملك أدواته الخاصة للوصول إلى ملفات الحاسوب، فتلك لا تمرّ عبر PressWork.

الإعداد بنقرة واحدة: الإعدادات ← الذكاء الاصطناعي ← ربط مساعد (MCP) ← «هيّئ لي» (Claude Desktop / Codex CLI / Gemini CLI). يُربط مجلد المشروع المفتوح بكل ملفات .pwk التي يحويها.
أغلق المساعد تماماً قبل الإعداد (يعيد Claude Desktop كتابة تكوينه عند الإغلاق) ثم أعد فتحه. يأخذ التطبيق نسخة احتياطية من التكوين قبل الكتابة.
المجلدات تتراكم: هيّئ من مشاريع في مجلدات مختلفة وسيراها المساعد كلها. يعمل حتى مع PressWork مغلق.
في Claude: الدردشات العادية تعيش في السحابة ولا تصل إلى حاسوبك — اختر نشاط «على حاسوبك» أو علّم موصل presswork.
عملاء MCP آخرون (Cursor وOpenCode…): مقتطف تكوين يدوي للنسخ. وبـتصدير المهارة تنشئ الـ skill التي تعلّم Claude الاستفادة المثلى من مشاريعك (تُضاف مرة واحدة وتبقى للأبد).
الخصوصية بصراحة: ما يقرؤه المساعد يُرسل إلى خدمته السحابية لمعالجة الإجابة — مثل نسخ ولصق، لكن تلقائياً. لا تربط مشاريع لا تودّ إرسالها في الدردشة.
يتطلب عرض العمل Complete.

29. الفروع ومتغيّرات الفصل

أداتان مختلفتان تجيبان عن السؤال نفسه — «وماذا لو بدلاً من ذلك…» — على مقياسين مختلفين.

الفرع كتاب آخر. وفي كل كتاب، يمكن لكل فصل أن تكون له متغيّراته.

29.1 الفروع

الفرع نسخة بديلة من المستند كله: تغيير النهاية، حذف شخصية، تجربة بنية أخرى. ويبقى المستند الرئيسي سليماً.
اللوحة: Ctrl/Cmd+Shift+B أو من القائمة. فتح فرع يعني الدخول إليه: من تلك اللحظة تكتب فيه.
موضعك مرئي دائماً: تظهر أسفل النافذة شارة باسم الفرع. غياب الشارة = أنت في المستند الرئيسي، الذي يذهب إلى الطباعة.
الترقية تجعل الفرع هو المستند الحقيقي (ويُؤرشف الرئيسي القديم كفرع). المقارنة تقابل سطراً بسطر. التصدير يفصل الفرع في ملف .pwk مستقل.
كل الفروع داخل الحزمة .pwk نفسها: لا ملفات إضافية ولا Git.
بطاقات المُلخّص تقول أين تفترق الطرق: تظهر على كل بطاقة فصل علامة بلون الفرع حيث يختلف ذلك الفصل، ومشطوبة حيث لا وجود له. نقرة واحدة تفتح الفروع. أما البطاقات المتطابقة في كل الفروع فتبقى نظيفة: الصمت يعني «لم يفترق شيء هنا». وداخل فرع ما، تشمل المقارنة المستند الرئيسي، وهو تحديداً ما يلزم مقارنته أثناء استكشاف طريق آخر.
الفصول التي تعيش في مكان آخر فقط لا تختفي من الحساب: يظهر في أسفل المُلخّص، عند الحاجة، سرد بالفصول الموجودة في نسخة أخرى فقط. وهو مفيد خصوصاً للفصول المعاد تسميتها، لأن الفصول تُعرف بعناوينها.

29.2 متغيّرات الفصل

المتغيّر صياغة ثانية لفصل واحد: على الورق كان شطب مقطع وإعادة كتابته إلى جانبه. يبقى واحد فقط حياً في النص، وهو الذي يخرج في الملفات.
الإنشاء: الملخص ← مرّر المؤشر فوق بطاقة الفصل ← ⑂ في الأعلى. يصبح النص الحالي الصياغة الأولى؛ وتسمّي الجديدة.
التبديل: انقر شارة ⑂ على البطاقة واختر. النشط موسوم بـ«في النص». يتغيّر ذلك الفصل وحده.
الحذف: رمز السلة في القائمة. لا يمكن حذف النشط: انتقل إلى غيره أولاً.
أين يُرى: شريط الحالة، بجانب عدّاد الكلمات — ⑂ متغيّر: الاسم. وإن كان الفصل الذي فيه المؤشر بلا متغيّرات، يُقال ذلك أيضاً بالرمادي.
لكل فرع متغيّراته: ما يُنشأ داخل فرع لا يظهر في المستند الرئيسي، وهذا مقصود.

29.3 إذا اختلّ شيء

غيّرت اسم فصل فاختفت المتغيّرات: لم تُفقد. في أسفل الملخص شريط «متغيّرات بلا فصل» يجمع كل ما لا يجد مكانه الآن؛ ومن قائمة «أسند إلى…» تعيده إلى موضعه. يحاول PressWork تتبّع العناوين المعدّلة وحده، لكنه حين لا يتيقّن يفضّل أن يعرض عليك المادة بدل أن يخمّن.
التراجع صالح هنا أيضاً: تبديل المتغيّر تعديل نصي كأي تعديل (Ctrl/Cmd+Z).
على القرص: versions/branches/<id>/ وversions/variants/ داخل .pwk. ملفات .md عادية: يبقى العمل مقروءاً حتى بدون PressWork.