Pelican ، مولد موقع ثابت قائم على Python

حول البجع

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

إذا كنت تستخدم بايثون وأنت تبحث عن شيء لإنشاء صفحات HTML ثابتة، سيسمح لك هذا المولد بإلقاء نظرة على العناصر الداخلية لكيفية عمله. استخدام لغة تعرفها يجعل الأمر أسهل. إذا كنت لا تحب Python ، فهناك مولدات مواقع ثابتة أخرى تستخدم لغات أخرى.

البجع هو مولد موقع ثابت شائع الاستخدام مكتوب بلغة بايثون. الشرق يدعم بشكل مباشر reStructuredText ويمكن أن تدعم Markdown، عندما يتم تثبيت الحزمة المطلوبة. يتم تنفيذ جميع المهام من خلال أدوات واجهة سطر الأوامر (CLI)، مما يجعلها سهلة لأي شخص على دراية بها. بالإضافة إلى أن أداة البدء السريع البسيطة الخاصة به تجعل إنشاء موقع ويب أمرًا سهلاً للغاية.

تركيب البجع والتكوين الأساسي

أقوم باختبار هذا البرنامج على Ubuntu 20.04. ستكون الخطوة الأولى التي يجب اتباعها خلق virtualenv وتثبيت البجع. يمكن القيام بذلك عن طريق فتح محطة طرفية (Ctrl + Alt + T) واستخدام الأوامر الموجودة فيها:

خلق البيئة الافتراضية

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

./venv/bin/pip install --upgrade pip

بعد تحديث النقطة ، يمكننا الآن تثبيت البجع:

منشأة البجع

./venv/bin/pip install pelican

قم بتشغيل الأمر pelican-quickstart

بمجرد التثبيت ، ستعمل أداة Pelican Quick Start CLI Tool على إنشاء التخطيط الأساسي وبعض الملفات حتى نتمكن من البدء.

لتبسيط الأمور ، عند تشغيل البداية السريعة ، استخدمت قيم العنوان والمؤلف وأجبت N إلى بادئة عنوان url و ترقيم الصفحات للمقالة. بالنسبة لبقية الأسئلة ، لقد استخدمت الافتراضي. من السهل جدًا تغيير هذه الإعدادات في ملف التكوين لاحقًا. يمكن تشغيل البدء السريع بالأمر:

بجع سريع

./venv/bin/pelican-quickstart

عند الانتهاء ، يمكننا تغيير جوانب معينة من الإعدادات. علينا فقط افتح ملف pelicanconf.py في محرر النصوص المفضل لدينا.

ملف الضبط

في الداخل يمكننا البحث عن الخط:

TIMEZONE = 'Europe/Paris'

ويمكننا التغيير إلى المنطقة الزمنية للبلد الذي يثير اهتمامك.

إلى تحديث إعدادات الارتباط الاجتماعي، عليك أن تبحث عن المتغير en pelicanconf.py. في ذلك يمكننا إضافة روابطنا على النحو التالي:

SOCIAL = (('Twitter (#Ubunlog)', 'https://twitter.com/UbunlogWeb'),)

يجب أن تلاحظ أن الفاصلة في النهاية مهمة. تساعد هذه الفاصلة بايثون على إدراك أن المتغير عبارة عن مجموعة بالفعل. تأكد من عدم حذفه.

ابدأ الخادم

الآن بعد أن أصبح لدينا أساسيات الموقع ، يمكننا أن نرى أن البداية السريعة قامت بإنشاء ملف Makefile بأهداف مختلفة. واحد منهم يجعل يمكن لـ devserver بدء تشغيل خادم تطوير على أجهزتنا حتى نتمكن من معاينة كل شيء نقوم بإنشائه. من المفترض أن تكون أوامر CLI المستخدمة في Makefile جزءًا من PATH ، لذا أولاً يجب علينا تفعيل virtualenv.

بدء الخادم

source ./venv/bin/activate

make devserver

عندما تبدأ ، نستطيع افتح متصفحنا وانتقل إلى URL http://localhost:8000 لمشاهدة المدونة التي تم إنشاؤها.

نموذج صفحة تم إنشاؤها باستخدام Pelican

إضافة محتوى

الآن بعد أن أصبح لدينا موقع أساسي ، يمكننا إضافة بعض المحتوى. أولا، سنقوم بإنشاء ملف يسمى أهلا وسهلا بك في دليل المحتوى (محتوى) من الجانب.

مع محرر النصوص المفضل لدينا ، سننشئ هذا الملف بنص يتبع الهيكل التالي:

إضافة محتوى في بجع

Bienvenid@ a este blog

######################

:date: 20210827 00:03

:tags: bienvenid@

:category: Intro

:slug: bienvenida

:author: ubunlog

:summary: Documento bienvenida

Bienvenid@ a este blog de prueba con Pelican.

Esta es una pequeña página se va a mostrar como página estática.
Pelican analiza automáticamente las líneas de metadatos (fecha, etiquetas, etc.).

بعد كتابة الملف ، يجب أن يقوم devserver بالتحديث وإنشاء شيء مثل هذا:

تمت إضافة ملف الترحيب

أعد تحميل موقع الاختبار الخاص بك في المتصفح لمعرفة التغييرات.

صفحة ترحيب ثابتة

تمت إضافة البيانات الوصفية تلقائيًا إلى الصفحة. ما هو أكثر من ذلك ، اكتشف Pelican تلقائيًا فئة المقدمة وأضف القسم إلى قائمة التنقل العلوية.

غير الموضوع

بالإضافة إلى كل ما سبق ، يمكننا بسهولة تغيير الموضوع. في المستودع مواضيع البجع، يمكنك العثور على سمات مختلفة أنشأها المستخدمون. من السهل جدًا اختبار السمات الجديدة ، ما عليك سوى تنزيلها من المستودع ، احفظها على جهاز الكمبيوتر الخاص بنا وفي الملف pelicanconf.py أضف السطر التالي بالمسار إلى السمة:

THEME = "/home/tu-usuario/pelican-tema/nombre-del-tema"

سيقوم devserver بإعادة إنشاء مخرجاته. أعد تحميل صفحة الويب في المتصفح لرؤية المظهر الجديد.

كانت هذه مقدمة صغيرة سريعة عن البجع. كل هذا تم على آلة محلية. إذا كنت تريد أن يرى الآخرون موقعك ، فسيتعين عليك تحميل ملفات HTML التي تم إنشاؤها مسبقًا إلى الخادم. إذا نظرت بالتفصيل في إخراج البجعة السريعة، سترى خيارات لاستخدام FTP و SSH و S3 وحتى صفحات GitHub.

فإنه يمكن الحصول على مزيد من المعلومات حول هذا المولد في موقع المشروع أو في مستودع جيثب.


اترك تعليقك

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها ب *

*

*

  1. المسؤول عن البيانات: ميغيل أنخيل جاتون
  2. الغرض من البيانات: التحكم في الرسائل الاقتحامية ، وإدارة التعليقات.
  3. الشرعية: موافقتك
  4. توصيل البيانات: لن يتم إرسال البيانات إلى أطراف ثالثة إلا بموجب التزام قانوني.
  5. تخزين البيانات: قاعدة البيانات التي تستضيفها شركة Occentus Networks (الاتحاد الأوروبي)
  6. الحقوق: يمكنك في أي وقت تقييد معلوماتك واستعادتها وحذفها.