Blended Download - تنزيل شفرة المصدر Blended

Blended

فئات أخرى

1.0.0

تنزيل

المخلوطة

Blended هو منشئ مواقع ويب ثابت مكتوب بلغة Python ومرخص بموجب ترخيص GPL 3.0 مفتوح المصدر. وهو يدعم نظام القوالب المستند إلى HTML، والمحتوى المكتوب بلغة HTML، وMarkdown، وTextile، وreStructuredText، وJade، وDocx، وPlain Text. كما أنه يدعم تجميع SASS، وLess، وStylus، وCoffeeScript. يجعل Blended من السهل نشر مواقع الويب الخاصة بك عن طريق تضمين برنامج تحميل FTP مدمج. بالإضافة إلى ذلك، Blended قابل للترقية بقوة لأنه يدعم نظام Python الإضافي.

التثبيت

لتثبيت Blended من PyPi (مستحسن)، قم بتشغيل:

pip install blended

لإنشاء برنامج Blended من المصدر وتثبيته:

git clone https://github.com/johnroper100/Blended.git

cd Blended

pip install .

جري

لاستخدام Blended بعد تثبيته، قم بتشغيل:

blended init

سيساعدك هذا على بدء موقع ويب جديد. إذا كنت بحاجة إلى مساعدة، قم بتشغيل:

blended --help

وسترى كافة الأوامر المتوفرة.

بناء موقعك

لبناء الموقع الذي قمت بإنشائه باستخدام Blended run

blended build

أو

blended interactive (لبناء تغيير الملف)

بالنسبة لأي أمر تقوم بتشغيله، يمكنك تحديد بديل --outdir للإنشاء أو العرض منه. على سبيل المثال، للإنشاء في المجلد source_output ، قم بتشغيل blended build --outdir source_output .

داخل ملف config.py ، يمكنك ضبط minify_css و minify_js على القيمة true لتحسين ملفات CSS وJS بعد الإنشاء.

العمل مع القوالب

يمكنك تثبيت القوالب من GitHub باستخدام blended install-template .

يستخدم كل موقع ويب Blended أربعة ملفات نموذجية:

header.html (مطلوب)
footer.html (مطلوب)
home_page.html (غير مطلوب ولكن الموقع يبدو أفضل)
content_page.html (غير مطلوب ولكن الموقع يبدو أفضل)
nav(name).html (يمكنك الحصول على ما يصل إلى 6 قوالب تنقل مختلفة. على سبيل المثال، navTest.html أو nav_test.html )
page_list_item.html (غير مطلوب، إذا تم استخدامه، فسيؤدي ذلك إلى استبدال محتوى كل عنصر في قائمة الصفحات. يمكن أن يحتوي على المتغيرات {name} ، {content} ، {content_short} ، {date} ، {day} ، {month} ، {month_name} {year} ، {path} )

في هذه الملفات تقوم بوضع العلامات لكل قسم سيتم إنشاؤه.

عند العمل مع الصفحات، يمكنك اختياريًا تحديد القالب الذي تريده (بخلاف content_page.html ) عن طريق إضافة اسم ملف القالب بدون الامتداد إلى السطر الأول من الصفحة، ثم إضافة خمسة + s على الأقل إلى السطر الثاني . على سبيل المثال، إذا أردت استخدام قالب يسمى blog_page.html لصفحة معينة، فسأضعه

 blog_page
+++++

في أعلى الصفحة. تأكد من وضعه في الأعلى وإلا فلن يعمل!

لديك بعض المتغيرات التي يمكنك استخدامها في القوالب الخاصة بك لسحب القيم أثناء الإنشاء:

{website_name}
{website_description}
{website_description_long} (يُستخدم للأوصاف الطويلة مثل السيرة الذاتية للمؤلف)
{author_name}
{author_bio}
{website_language}
{website_license}
{website_url}
{page_content} (لا يمكن استخدامه إلا في ملف قالب content_page.html)
{page_date} (تاريخ/وقت كتابة/تعديل الصفحة)
{page_day} (يوم كتابة/تعديل الصفحة)
{page_month} (شهر كتابة/تعديل الصفحة)
{page_month_name} (اسم الشهر الذي تم فيه كتابة/تعديل الصفحة)
{page_year} (سنة كتابة/تعديل الصفحة)
{relative_root} (إرجاع مسار نسبي للملف الحالي)
{random_number}
{build_date}
{build_time}
{build_datetime}
{ (page_filename) _active} (عند الإنشاء، إذا كانت الصفحة النشطة تساوي اسم الملف الموجود في العلامة، فسيتم استبدال العلامة بالمثال active {getting-started.html_active} )
{nav (name) } (يُستخدم لوضع أشرطة التنقل. لإضافة شريط تنقل، اكتب nav بالإضافة إلى شيء آخر. على سبيل المثال، {nav2} أو {nav_test} )
{page_list} (يسرد كافة الصفحات بتنسيق <ul><li><a href="page-name.html">page-name</a></li></ul> )
{page_file} (اسم الملف الكامل للصفحة. على سبيل المثال، getting-started.html )
{page_filename} (اسم ملف الصفحة بدون الامتداد .html. على سبيل المثال، getting-started )
{page_name} (يعطي اسم الصفحة الحالية. ويجعل اسم الصفحة يبدو أكثر جمالاً. على سبيل المثال، يتم تحويل getting-started.html إلى Getting Started )
{page_folder} (يعطي اسم مجلد الصفحة الحالية. ويجعل اسم المجلد يبدو أكثر جمالاً. على سبيل المثال، يتم تحويل getting-started إلى Getting Started " )
{page_folder_orig} (يعطي اسم مجلد الصفحة الحالية)
{blended_version} (يعطي الإصدار الحالي من Blended)
{blended_version_message} (يعطي الإصدار الحالي من Blended برسالة لطيفة: Built with Blended v4.9 )

أينما تضع هذه المتغيرات في القوالب، سيتم استبدالها بالقيم الموجودة في ملف config.py الخاص بك. يجب أن تبقى المتغيرات داخل الأقواس المتعرجة. يمكنك حتى وضع المتغيرات داخل محتوى المتغيرات الأخرى!

العمل مع الإضافات

يمكنك تثبيت المكونات الإضافية من PyPi، على سبيل المثال pip install blended_google_analytics . يمكنك أيضًا تثبيت المكونات الإضافية من GitHub باستخدام blended install-plugin .

لاستخدام المكونات الإضافية، قم بتضمينها في قائمة plugins في config.py .

إذا كان المقصود من البرنامج المساعد أن يتم استدعاؤه في القوالب الخاصة بك، على سبيل المثال. {html_comment_box} ثم أدخله في قائمة الإضافات مثل plugins = ["html_comment_box"] .

يمكنك استخدام مكونات إضافية متعددة في وقت واحد، على سبيل المثال. plugins = ["html_comment_box", "minify_images"]

العمل مع المتغيرات المخصصة

يوجد داخل config.py متغير custom_variables = {} . هذا قاموس لجميع المتغيرات المخصصة التي ترغب في استخدامها. لإضافة متغير، قم بإضافته كعنصر قاموس.

فيما يلي بعض الأمثلة:

custom_variables = {"software_name": "Blended"}

custom_variables = {"software_name": "Blended", "software_version": "5.0"}

الاستيراد من ووردبريس

يمكنك استيراد موقع ويب ومنشورات من WordPress. للقيام بذلك، قم بالتصدير من WordPress باستخدام خيار Posts وقم بتنزيل الملف إلى الدليل الذي تريد إنشاء موقع الويب الخاص بك فيه.

قم بتشغيل الأمر blended import-wp وسيطالبك باسم/مسار الملف الخاص بالملف. اكتب اسم الملف وسيقوم Blended بإنشاء موقع ويب جديد يحتوي على المعلومات.

الاستيراد من بلوجر

يمكنك استيراد المشاركات من Blogger. للقيام بذلك، قم بالتصدير من Blogger باستخدام خيار Backup Site وقم بتنزيل الملف إلى الدليل الذي تريد إنشاء موقع الويب الخاص بك فيه.

قم بتشغيل الأمر blended import-blogger وسيطالبك باسم/مسار الملف الخاص بالملف. اكتب اسم الملف وسيقوم Blended بإنشاء موقع ويب جديد يحتوي على المعلومات.