آخر تحديث:

كيف تكتب مقالات تحتوي على أكواد برمجية في Publii؟

OpenTik Publii
محرر publii
محرر Publii

يعد اختيار المحرر المناسب في Publii هو الخطوة الأولى لإنتاج مقال تقني مريح للعين ومفيد للقارئ. يوفر النظام ثلاثة أنماط للكتابة، لكل منها غرض محدد. 

في عالم التدوين التقني، الكود البرمجي ليس مجرد نص، بل هو جوهر المقال. يمنحك Publii ثلاثة خيارات قوية لكتابة المحتوى، وفهم الفرق بينها سيوفر عليك ساعات من التنسيق اليدوي.

1. مقارنة المحررات الثلاثة: القوة والضعف

أولاً: محرر WYSIWYG (ما تراه هو ما تحصل عليه)

  • نقاط القوة: سهل جداً للمبتدئين، يشبه التعامل مع Microsoft Word، ممتاز للمقالات الأدبية أو البسيطة.

  • نقاط الضعف: قد يولد كود HTML "متسخاً" أحياناً، وصعب التحكم في تنسيق الأكواد البرمجية المعقدة.

ثانياً: محرر الكتل (Block Editor)

  • نقاط القوة: عصري ومنظم جداً. يسمح لك بإضافة "كتلة كود" (Code Block) مستقلة، مما يسهل نقلها وترتيبها داخل المقال.

  • نقاط الضعف: قد يبدو ثقيلاً لبعض المستخدمين الذين يفضلون الكتابة المستمرة دون انقطاع.

ثالثاً: محرر العلامات (Markdown Editor) - المفضل للمبرمجين

  • نقاط القوة: الأسرع على الإطلاق. يسمح لك بالتركيز على الكتابة فقط. متوافق تماماً مع Joplin.

  • نقاط الضعف: يتطلب معرفة بسيطة بصيغ Markdown (مثل استخدام ``` للأكواد).

2. كيف تظهر الأكواد بشكل احترافي؟

للحصول على صناديق أكواد ملونة وقابلة للنسخ في Publii، يجب عليك تفعيل إضافة Syntax Highlighter من قائمة Tools & Plugins. بعد التفعيل، سيتعرف النظام تلقائياً على لغة البرمجة ويقوم بتلوينها.

 

1. مقارنة محررات Publii

المحررأبرز المميزاتالعيوب
WYSIWYGسهولة التعامل المرئي (مثل Word).صعوبة التحكم في تفاصيل الـ HTML الدقيقة.
Block Editorتنظيم المحتوى في كتل مستقلة (صور، كود، نص).قد يبدو بطيئاً في الكتابة السريعة.
Markdownكتابة سريعة، كود نظيف، توافق تام مع المبرمجين.يحتاج لحفظ بعض الرموز البسيطة.

2. كتابة الأكواد في محرر Markdown

عند استخدام محرر Markdown، يمكنك كتابة الكود ببساطة عبر حصر النص بين ثلاث علامات (Backticks)، وسيتحول تلقائياً إلى صندوق كود منسق:


# هذا مثال لكود يتم تنسيقه تلقائياً في Publii
sudo apt update && sudo apt upgrade

3. تفعيل إضافة Syntax Highlighter

للحصول على أفضل مظهر للأكواد (مثل تلوين الأوامر البرمجية)، تأكد من القيام بالخطوات التالية:

  1. اذهب إلى Tools & Plugins في برنامج Publii.
  2. ابحث عن إضافة Syntax Highlighter وقم بتفعيلها.
  3. اختر السمة (Theme) المناسبة (مثل Dracula أو Tomorrow Night) لتناسب تصميم مدونتك.
نصيحة للمحترفين: إذا كنت تنقل مقالاتك من Joplin، فإن محرر Markdown في Publii هو الخيار الأمثل لك، حيث يمكنك نسخ النص ولصقه مباشرة دون الحاجة لإعادة التنسيق.