الفصل 14 · الجزء III · في التطبيق
المساهمة في Postext
كيف تنضم إلى مجتمع Postext وتساهم في المشروع
باختصار
يبني Postext مجتمعٌ من المتطوعين، ويستطيع أي شخص أن يساعد. لا يلزمك أن تكون مبرمجًا، فيمكنك أن تساعد أيضًا بالاختبار، أو بكتابة التوثيق، أو بالترجمة، أو بمشاركة ما تعرفه عن التصميم والطباعة. تشرح هذه الصفحة طريقة عمل الفريق، والمواضع التي تحتاج إلى المساعدة أكثر من غيرها، وكيف تقدّم أول مساهمة لك. وتنتهي بالأهداف البعيدة للمشروع.
نبني معًا محرّك الإخراج التحريري الذي لم يعرفه الويب من قبل.
Postext مشروع مفتوح المصدر يقوده مجتمعه. يسعى إلى حل مشكلة أُهملت عقودًا: نقل الإخراج التحريري الاحترافي إلى الويب. هذا طموح كبير، ويحتاج إلى أكثر من شخص واحد.
المشروع حديث العهد، لكنه لم يعد صفحة بيضاء: صدرت سلسلة الإخراج الأساسية، وصيغة المستند، ونظام الإعدادات. ومع ذلك ما زالت قرارات تصميم كثيرة مفتوحة، ويملك المساهمون الذين ينضمون الآن تأثيرًا حقيقيًا في الاتجاه الذي يسلكه المشروع. إن كنت تنتظر الوقت المناسب للانضمام، فهذا هو.
لا يلزمك أن تكون مبرمجًا لتساهم. سواء كنت تكتب الشيفرة، أو تصمّم صفحات تحريرية، أو تفهم فن الطباعة، أو تختبر على متصفحات مختلفة، أو تكتب التوثيق، أو تترجم المحتوى، أو لديك أفكار عن الطريقة التي ينبغي أن يعمل بها المحتوى التحريري على الويب، فلك مكان هنا.
#لماذا تساهم
يواجه كل فريق تطوير تحريري في العالم المشكلة نفسها: لم تُصمَّم CSS للإخراج التحريري. لا دعم أصليًا فيها لموازنة الأعمدة، ولا لمنع الأسطر اليتيمة (orphans) والأسطر الأرامل (widows)، ولا لالتفاف النص حول العوائق، ولا لوضع الحواشي السفلية. فيحل كل فريق هذه المشكلات من الصفر، ويبني حلولًا هشّة تُصنع لمرة واحدة، صيانتها مكلفة ولا سبيل إلى تقاسمها مع غيره.
يسعى Postext إلى تغيير ذلك، لا بوصفه أداة مملوكة، بل معيارًا مفتوحًا مشتركًا: محرّك إخراج واحد عالي الجودة يمكن أن تعتمده دور النشر والمجلات والصحف ومنصات الكتب وفرق التطوير في أنحاء العالم، وأن تبني عليه.
لا يستطيع شخص واحد أو شركة واحدة بناء معيار من هذا النوع. يحتاج إلى منظور مصممي الحروف والطباعة من تقاليد مختلفة، والمتخصصين في PDF، وخبراء إتاحة الوصول، والمطوّرين الذين يعملون بأنظمة كتابة من اليمين إلى اليسار، والمصممين الذين يُخرجون المجلات، والمهندسين الذين يحسّنون سرعة رسم الصفحات. تنوّع عالم النشر يقتضي مجتمعًا متنوعًا وراء الأداة التي تخدمه.
#كيف نعمل
يجري التنسيق كله على GitHub. لا قنوات خاصة، ولا قوائم بريدية مغلقة، ولا قرارات تُتخذ خلف أبواب موصدة. كل شيء علني، وقابل للبحث، ومفتوح للمشاركة.
- Issues (المسائل): لبلاغات الأخطاء وطلبات الميزات والمهام المحددة. إن أردت العمل على شيء ما، فابدأ من هنا.
- Pull Requests (طلبات الدمج): لمساهمات الشيفرة. افتح مسألة أولًا لمناقشة المقاربة قبل كتابة الشيفرة.
- Discussions (النقاشات): للأفكار، وحوارات التصميم، والأسئلة، وكل ما ليس خطأً أو مهمة محددة. هذا هو المكان الذي تفكّر فيه بصوت عالٍ.
هذا مقصود: حين يكون كل شيء في مكان واحد، يستطيع أي شخص أن يجد السياق وراء أي قرار، ويستطيع المساهمون الجدد قراءة التاريخ.
#مجالات يمكنك المساعدة فيها
يحتاج المشروع إلى أنواع كثيرة من الخبرات. هذه بعض المجالات التي تكون فيها المساهمات ذات قيمة خاصة:
#الشيفرة والخوارزميات
- خوارزميات الإخراج الطباعي: محرّك ضبط الأسطر Knuth-Plass، وموازنة الأعمدة، والتقسيم الأمثل للفقرات إلى أسطر، والترقيم حسب نوع المورد، ووضع العناصر العائمة.
- إنتاج PDF: بناء PDF على المستوى المنخفض، وتضمين الخطوط، وإدارة الألوان، والتعامل مع بايتات الموارد في الأشكال ذات الحبر الواحد.
- رسم النص: الرسم على اللوحة (Canvas)، ومخرجات SVG، وإعادة تلوين SVG بحبر واحد (
diagramStyle.singleInk)، ومقاييس الخطوط. - تحسين الأداء: طبقة ذاكرة القياس المؤقتة، وخوارزمية Knuth-Plass لتقسيم الأسطر المكتوبة بلغة Rust والمترجمة إلى WebAssembly (
rust/)، وإبقاء محرّك الإخراج سريعًا بما يكفي للاستعمال الفوري عند كل تغيير في المقاس.
#Sandbox وواجهة المستخدم
صار Sandbox واجهة React كبيرة قائمة بذاتها: لوحة الموارد فيها محرّر جداول تفاعلي ورفع للصور وملفات SVG، ولوحة الخطوط، ومحرّرات لقوالب الصفحات ولصفحات القصص المصورة، ولوحة التصميم التي تغطي مجموعاتها كل أجزاء المحرّك. بُنيت عناصر التحكم فيه على مكوّنات Base UI الأولية (packages/postext-sandbox/src/ui/) وتُفحص بأداة axe-core وبفحوص المشروع الخاصة وفق WCAG 2.2 عند المستوى AAA، لذا ينبغي أن تعيد عناصر التحكم الجديدة استعمالها، وأن يبقى لكل حقل اسمٌ مأخوذ من تسميته ووصفٌ مأخوذ من نص المساعدة المرافق له. ويتبع كل نص في الواجهة اصطلاح تدويل (i18n) صارمًا: تمر كل تسمية عبر حزمة sandbox، وجسر التسميات في تطبيق الويب، وفهرس كل لغة من اللغات العشر. إن ساهمت في الواجهة الأمامية أو في تجربة المستخدم، فهذا هو ميدان عملك.
#التصميم وفن الطباعة
- خبرة التصميم التحريري: إن كانت لديك خبرة في إخراج المجلات أو الصحف أو الكتب، فمعرفتك بما يجعل الصفحة تنجح (أو تفشل) لا تُقدَّر بثمن، ولا تحتاج فيها إلى أي شيفرة.
- التقاليد الطباعية: ينبغي أن يحترم المشروع الأعراف الطباعية للغات وأنظمة الكتابة المختلفة، لا الحروف اللاتينية وحدها.
#التوثيق والمجتمع
- التوثيق: تحسين التوثيق وتوسيعه وصيانته. التوثيق الواضح هو ما يفرّق بين مشروع يعتمده الناس ومشروع يتركونه.
- الترجمات: التوثيق والموقع بعشر لغات: الإنجليزية والإسبانية والكتالونية والفرنسية والألمانية والإيطالية والبرتغالية البرازيلية والصينية المبسطة واليابانية والعربية. ونرحّب بمزيد من اللغات، وبمراجعة اللغات الموجودة.
- الاختبار: الاختبار على المتصفحات وأنظمة التشغيل المختلفة وفي الحالات الحدّية. والعثور على الصفحات التي يختلّ إخراجها لا يقلّ قيمةً عن بناء الصفحات التي يسلم إخراجها.
#تصميم الصيغة والمخطط
لم تعد الصيغة صفحة بيضاء: صدرت كتل ::resource، والإحالات داخل السطر :ref، وأقسام الإعدادات tableStyle وcaptionStyle وdiagramStyle. والمهمة الآن أن تتطور صيغة مستقرة من غير أن يتعطّل ما كُتب بها:
- قواعد المستند: ما زالت الحواشي الجانبية سؤالًا مفتوحًا، وهي مسألة تصميم بقدر ما هي مسألة تقنية.
- مخطط الإعدادات: إبقاء النظام قويًا بما يكفي للمحترفين وبسيطًا بما يكفي للمبتدئين وهو يكبر.
#البداية
الإعداد العملي، من استنساخ المستودع وتثبيت الاعتماديات إلى تشغيل الاختبارات، موثّق في CONTRIBUTING.md. ابدأ من هناك للخطوات العملية.
حين تنتهي من الإعداد، إليك ثلاث خطوات ملموسة، من الأخف التزامًا إلى الأثقل:
- عرّف بنفسك في Discussions: قل ما الذي تعمل عليه وما الذي أتى بك إلى هنا. لا سؤال أبسط من أن يُطرح، وهذه أسرع طريقة ليعرف المجتمع أنك وصلت.
- اختر مسألة من good first issue: مسائل منتقاة لتكون مدخلًا واقعيًا، ولا تفترض معرفةً مسبقة بتاريخ المشروع.
- ترجم التوثيق إلى لغة جديدة، أو راجع لغة منها: التوثيق اليوم بعشر لغات. وكل لغة جديدة تصل إلى قرّاء لا يقرؤون اللغات الأخرى.
إن كنت تنوي كتابة الشيفرة، فافتح مسألة أولًا لمناقشة المقاربة: هذا يجنّب تكرار العمل، ومحادثة قصيرة في البداية توفّر وقت الجميع.
أبقِ كل ملف مصدري دون 600 سطر تقريبًا وكل مجلد دون 25 ملفًا مصدريًا تقريبًا: الوحدة التي تتجاوز ذلك تصير مجلدًا بالاسم نفسه، ويبقى الملف القديم واجهةً تعيد تصديره. يتحقق التكامل المستمر من هذه الحدود بالأمر node scripts/source-size.mjs --check (انظر Code Layout في CONTRIBUTING.md).
#ماذا تقرأ بعد ذلك
لتتعرّف على المشروع قبل أن تغوص فيه:
- البنية: كيف تُبنى سلسلة الإخراج وأين يقع كل نظام فرعي.
- صيغة المستند: قواعد Markdown المُثرى التي يوسّعها المساهمون.
- Sandbox: الملعب الذي يسهل فيه رؤية معظم التغييرات واختبارها.
#المجتمع
ما زال Postext في بداياته، وهذا تحديدًا ما يجعل هذه اللحظة مميزة. المساهمون الذين ينضمون الآن لا يكتبون الشيفرة فحسب، بل يرسمون الأعراف والأولويات والثقافة.
يقدّر المشروع ما يلي:
- التصميم المتأني قبل السرعة. إحكام التجريدات أهم من الإصدار السريع. صُقل فن الطباعة على مدى قرون، ويمكننا أن نأخذ وقتنا لنتقنه.
- الوضوح قبل البراعة. الشيفرة السهلة القراءة والفهم أثمن من شيفرة مبهرة لكنها غامضة.
- التعاون قبل الاستئثار. لا أحد يملك جزءًا من الشيفرة. تُقيَّم الأفكار بجدارتها، لا بمن اقترحها.
يُنسب الفضل إلى كل المساهمين. هذا المشروع موجود لأن أناسًا يختارون أن يقضوا وقتهم في تحسينه.
#الرؤية
يسعى Postext إلى أن يصبح محرّك الإخراج المعياري للمحتوى التحريري على الويب: الأداة التي تلجأ إليها دور النشر والمجلات والصحف ومنصات الكتب حين تحتاج إلى طباعة احترافية.
إن كنت تعمل في التطوير التحريري وتحل مشكلات الإخراج هذه وحدك، فهذه دعوتك إلى أن تحلها مرة واحدة، كما ينبغي، مع الآخرين.