الصفحة الرئيسية>موارد بناء الموقع>بيانات الموقع
تنزيل

موقع OpenFaas ومدونة

يحتوي هذا المستودع على صفحة ويب OpenFaas والمدونة - https://www.openfaas.com ، التي تم إنشاؤها باستخدام Jekyll وشوكة معدلة من قالب CloudCannon Frisco وتم تصميمه/استضافته باستخدام صفحات GitHub.

المساهمة

توفر الأقسام التالية دليلًا أساسيًا لبعض التغييرات الشائعة التي سيتم إجراؤها على الموقع ، وإضافة المنشورات ، والمؤلفين ، إلخ.

إرشادات التحرير / النمط

هيكل ما بعد

يجب أن تحتوي جميع منشورات المدونة على عنوان ووصف ، وهذا يساعد مع كبار المسئولين الاقتصاديين. يمكن ذكر اسم المؤلف في الوصف.

شكل:

  • مقدمة قصيرة/نظرة عامة (150 كلمة)

  • سلسلة من الخطوات المنطقية أو النقاط / الموضوعات

تضمين الرسم البياني المفاهيمي أو الفيديو أو الصورة للمساعدة في جعل العلبة.

  • دعوة إلى العمل

أشر إلى المستندات/github أو أي شيء آخر.

  • شكر وتقدير

إذا لزم الأمر ، أظهر شكر وتقدير للآخرين الذين تعاونوا أو قدموا ملاحظات استخدمتها. عند العمل على Github ، يتوفر هذا في التاريخ العام ، لذا استخدم بشكل ضئيل.

صوت

  • العناوين

عند استخدام الخطوات ، استخدم الصوت النشط/الضروري للعناوين.

جيد:

  • "ابدأ"
  • "تكوين العقدة"

سيء:

  • "ابدء"
  • "تكوين العقدة"

استخدم اللغة الإنجليزية العادية

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

اكتب باللغة الإنجليزية البسيطة في جميع الأوقات ، عند وجود كلمة أبسط ، استخدمها ، وتجنب الكلمات المستمدة من اللاتينية عندما يكون ذلك ممكنًا ، تجنب الجيرونز حيث يمكن للفعل النشط استبداله.

إذا كنت تكتب مقالًا ، فيجب أن يكون صوتك قد وصل وتجربتك. هذا هو السبب في أنك تكتب المنشور - حاول تجنب استخدام التوتر السلبي أو العبارات ، حيث يمكنك استخدام جملة تبدأ بـ I .

قبل:

  • في أي خدمة إنتاج ، تعتبر السجلات مكونًا مهمًا من قابلية الملاحظة والتصحيح للنظام

بعد:

  • تعتبر السجلات ضرورية لمراقبة وتصحيح أنظمة الإنتاج مرة واحدة في الإنتاج.
  • السجلات ضرورية لمراقبة وتصحيح أنظمة الإنتاج.

استخدم جمل قصيرة:

قبل:

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

بعد:

  • مزيج من Loki و Grafana يجعل من الأسهل تصحيح وظائف الأخطاء من ذي قبل. يمكنك حتى إنشاء لوحات معلومات تجمع بين مقاييس الوظائف والسجلات في مكان واحد.

للحصول على بعض التوصيات الإضافية ، انظر:

  • هذا المنشور ، بقلم رافائيل أ. فينكل ، جامعة كنتاكي.

  • و [قبل وبعد] http://www.plainenglish.co.uk/campaigning/examples/before-and-after.html] من plainenglish.co.uk

لهجة / نمط

  • كن موضوعيًا ، تجنب أن تكون "لطيفًا"

في حين أن استخدام مصطلحات ممتعة مثل "Boom!" ، "المرح والربح" وصنع النكات في النص ، يمكن أن تعمل بشكل جيد على مدونة شخصية. يجب أن يكون لمدونة ووثائق OpenFaas الحد الأدنى من هذا النوع من المصطلحات "المرح" أو "اللطيفة".

  • الرأي مقابل الحقائق

يجب تقديم الآراء كنقطة وجهة نظرك الخاصة. إذا كان لديك بيانات لدعم موقفك ، فسيساعد ذلك على جعل وجهة نظرك ذات مصداقية. إذا لم يكن لديك أي بيانات ، فتأكد من أن القارئ يفهم هذا من خلال الارتباط بنفسك I believe that .. ، I found it easier to ..

إذا كنت تذكر بيانات حقيقة / موضوعية ، فيجب عليك أيضًا نسخ هذا مع علامات الاقتباس والروابط وما إلى ذلك.

  • اقتبس مصادرك

احذر من قوانين حقوق الطبع والنشر. إذا كنت تستخدم مخططًا أو قمت بتضمين اقتباس من مكان ما ، فتأكد من إعطائه إسنادًا مناسبًا.

الصور

ضع جميع الصور في مجلد فرعي ./images/<post-name>

  • أضف منشور خلفية

يجب أن يكون لكل منشور صورة خلفية تم التقاطها من الصور الفوتوغرافية المجانية أو تزويدها برخصة مشاعات إبداعية. لا تقم بسحب الصور من Google دون التحقق من أن الاستخدام / الترخيص صالح أولاً. اقتصاص الخلفية لعرض 1600 بكسل. استخدم JPEG وتهدف من 200 كيلو بايت إلى 280 كيلو بايت في الحجم عند التصدير (زيادة الضغط)

يمكنك تقليل الحجم عن طريق الحد من "جودة" JPEG من 100 ٪ إلى شيء أقل مثل 70-75 ٪.

  • Pexels

  • غير مصممة

  • صور ولقطات شاشة

يجب أن يكون لكل منشور مدونة رسم تخطيطي واحد على الأقل. يجب أن يوضح هذا التدفق المنطقي أو العرض التجريدي للميزة أو الأخبار أو التصميم. يمكن أن تخدم تغريدة أو مقطع فيديو مضمن أيضًا هذا الغرض.

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

محتوى النشر المتقاطع

يؤثر المحتوى المتقاطع سلبًا على درجات SEO ، لذلك لا ينبغي القيام به ما لم يتم تقديم رعاية واهتمام إضافيان لتشمل رؤوس "OG" المطلوبة. تأكد من أن جميع المحتوى على مدونة OpenFaas Community هو الأصلي.

النمو محليا

يتم توفير ملف Conpose Docker لتبسيط تطوير/المساهمة في موقع الويب والمدونة ، وقد تم التحقق من ذلك للعمل على كل من OSX و Windows 10 (عند تطوير/الكتابة على Windows ، يرجى استخدام نهايات خط Unix في المحرر الخاص بك).

قم بتشغيل الموقع محليًا مع: 

 docker compose up

هذا سيجعل الموقع متاحًا محليًا على - http: // localhost: 4000. 

 Starting openfaas-www_openfaas-jekyll_1 ... done
Attaching to openfaas-www_openfaas-jekyll_1
openfaas-jekyll_1  | ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux-musl]
openfaas-jekyll_1  | Configuration file: /srv/jekyll/_config.yml
openfaas-jekyll_1  |             Source: /srv/jekyll
openfaas-jekyll_1  |        Destination: /srv/jekyll/_site
openfaas-jekyll_1  |  Incremental build: disabled. Enable with --incremental
openfaas-jekyll_1  |       Generating...
openfaas-jekyll_1  |       Remote Theme: Using theme cloudcannon/frisco-jekyll-template
openfaas-jekyll_1  |                     done in 3.074 seconds.
openfaas-jekyll_1  |  Auto-regeneration: enabled for '/srv/jekyll'
openfaas-jekyll_1  |     Server address: http://0.0.0.0:4000
openfaas-jekyll_1  |   Server running... press ctrl-c to stop.

سيتم التقاط أي تغييرات تم إجراؤها على الموقع في المحرر داخل الحاوية وسيتم تجديد الموقع ( لاحظ أن هذا لا يتضمن تغييرات على _config.yml ، يجب إعادة تشغيل حاوية Docker لالتقاط هذه التغييرات).

على سبيل المثال ، إذا قمت بإضافة مشاركتك الخاصة في _posts/2018-07-31-my-post.md ، فسترى Jekyll يكتشف التغيير وتجديد الموقع ، وسيؤدي تحديث متصفحك إلى التقاط أي تغييرات. 

 openfaas-jekyll_1  |       Regenerating: 1 file(s) changed at 2018-07-31 21:28:36
openfaas-jekyll_1  |                     _posts/2018-08-22-my-post.md
openfaas-jekyll_1  |       Remote Theme: Using theme cloudcannon/frisco-jekyll-template
openfaas-jekyll_1  |                     ...done in 2.0199265 seconds.

أضف شركة المستخدم النهائي

  • تحرير _data/users.yml
  • انسخ الشعار في تنسيق SVG أو PNG إلى images/users-logos/

مستخدمي الصفحة المقصودة

يتم إنشاء قسم المساهمين في الصفحة المقصودة باستخدام برنامج نصي node صغير يقع في ملف generate-stats.js . يوصى بتشغيل هذا البرنامج النصي قبل فتح العلاقات العامة. سيضمن ذلك أن يكون قسم المساهمين محدثًا: 

 node generate-stats.js

ملاحظة: يتطلب تثبيت Node.js على نظامك.

إضافة مؤلف/عضو في الفريق

من أجل الحصول على منشور مدونة يعزى بشكل صحيح إلى مؤلف ، يجب إضافتها إلى الفريق من خلال إنشاء ملف <author_name>.md في دليل _staff_members .

يعتمد عرض عضو الفريق على صفحة الفريق على موقف في ملف البيانات/الأعضاء.

يعتمد الإسناد في منشور المدونة على اسم الملف.

على سبيل المثال ، يمكن استخدام _staff_members/alex.md للإسناد عن طريق تعيين البيانات الوصفية التالية: 

 author_staff_member: alex

مما يؤدي إلى عرض مربع مؤلف مع كل منشور مخصص:

مربع المؤلف

يأخذ تعريف المؤلف التنسيق التالي: 

 ---
name: Alex Ellis
position: Founder
image_path: /images/author/ellis.jpg
twitter_username: alexellisuk
blurb: Founder of <a href="https://twitter.com/openfaas">@openfaas</a>. Open Source <a     href="https://twitter.com/vmware">@vmware</a>.
---
مفتاح تفاصيل
اسم الاسم الكامل للمؤلف المساهم
موضع وصف نصي مجاني لعلاقتهم بالمشروع
Image_path الطريق إلى صورة المؤلفين ، يجب أن تكون هذه صورة 154px * 154px
twitter_username مؤلفون تويتر مقبض (بدون @ )
دعاية مغالى فيها معلومات نصية مجانية عن المستخدم ، يجب أن يكون هذا قصيرًا جدًا

### المساهمة في منشور

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

يجب إنشاء تخفيض النشر الخاص بك في دليل _posts ويجب أن يأخذ الملف الهيكل التالي. 

 yyyy-mm-dd-short-description-of-post.md

إذا كنت في حالة شك ، ألق نظرة على المنشورات الحالية للأفكار حول ما هو مقبول.

يتكون المنشور من جزأين ، رأس المادة الأمامية في Yaml يصف المنشور ويوفر Jekyll مع العظة لتقديم/إسناد وما إلى ذلك ، والجسم المنشور وهو مجرد تخفيض قياسي.

المسألة الأمامية Yaml

يأخذ البيانات الوصفية بعد النموذج التالي: 

 ---
title: Introducing the OpenFaaS Operator for Serverless on Kubernetes
date: 2018-07-14
image: /images/kubernetes-operator-crd/pexels-asphalt-blue-sky-clouds-490411.jpg
categories:
  - kubernetes
author_staff_member: alex
canonical_url: https://blog.alexellis.io/introducing-the-openfaas-operator/
---
مفتاح تفاصيل
عنوان عنوان منشور المدونة
تاريخ نشر تاريخ منشور المدونة بتنسيق yyyy-mm-dd
صورة المسار إلى الصورة التي سيتم عرضها خلف العنوان ، يجب إضافة هذا في دليل يحمل نفس اسم منشور المدونة ضمن دليل images .
فئات قائمة اختيارية للفئات التي يندرج بها المنشور ، يجب عليك دائمًا إعادة استخدام الفئات الحالية من المشاركات السابقة حيث كان ذلك ممكنًا
مؤلف_ستاف_member اسم ملف المؤلفين في دليل _staff_members ، يستخدم للإسناد (انظر القسم السابق)
Canonical_url يجب عليك تعيين هذا الحقل إذا تم نشر منشور المدونة بالفعل في عنوان URL آخر. يتم إعطاء التفضيل للمحتوى الأصلي.

بعد الجسم

بينما يدعم Jekyll تنسيقات متعددة ، يجب عليك إرسال مشاركتك بتنسيق Markdown.

يصف الدليل التالي بناء الجملة:

  • https://daringfireball.net/projects/markdown/

من المفيد جدًا أيضًا مقارنة المنشورات الموجودة مع ملفات Markdown الأساسية عندما تريد معرفة كيفية تنسيق مشاركتك.

تستخدم إضافة الصور تنسيق Markdown العادي ، وعلى الرغم من أن الصور الخارجية ممكنة ، إلا أنه من الممكن أن تقوم بتضمين أي صور في العلاقات العامة الخاصة بك ، يجب أن تذهب في دليل يحمل نفس الاسم مثل Post أسفل دليل images ، على سبيل المثال images/kubernetes-operator-crd/ .

ملاحظة احرص على تضمين أحجام الصور المعقولة فقط ، يجب عليك التأكد من أنك قد قمت بتغيير حجم/معالجة أي صور قبل إضافتها إلى العلاقات العامة.

التصميم

يستخدم الموقع لغة ورقة أنماط SASS ، وأي تعديلات على مظهر المواقع يجب أن تكون باستخدام SASS ، لا تساهم في ملفات RAW .css .

نحن نستخدم أيضًا Bulma كإطار CSS الخاص بنا. قبل إجراء أي تغييرات / إضافات نمط ، يرجى النظر في:

  • اتبع إرشادات Bulma
  • لا تكتب ملفات bulma مباشرة. استخدم ملفات SaaS و/أو المتغيرات المخصصة
  • استفد من متغيرات Sass المعلنة والمخوانات
  • يجب أن يكون لكل قسم على موقع الويب ملف SASS الخاص به

تغيير الرأس والتذييل

يتم تكوين Navbar و Footer في الموقع عبر Yaml في الملفات التالية:

  • _data/footer.yml
  • _data/navigation.yml

يجب أن تكون إضافة إدخالات إلى أي من الملاذ الأخير لأنه يجب ألا تتشوش.

مزيد من القراءة

للحصول على فهم أكثر تفصيلاً لكيفية بناء الموقع ، يرجى الرجوع إلى وثائق صفحات Jekyll و Github:

  • jekyll documenation
  • باستخدام jekyll مع صفحات github

يستخدم الموقع أيضًا الإضافات التالية:

  • jekyll-sitemap
  • Jekyll-seo-tag
  • جيكيل غذ
  • Jekyll-paginate
  • jekyll-archives

ارجع إلى المستندات المذكورة أعلاه للحصول على تفاصيل حول كيفية استخدام كل مكون إضافي وتكوينه.

توليد GIF 

rm -rf outg/ * ; ffmpeg -i videoplayback.mp4 -vf " select='not(mod(n,2000))',setpts='N/(30*TB)' " -f image2 -y outg/out%03d.jpg

ffmpeg -f image2 -framerate 1 -i outg/out%003d.jpg  -vf " scale=width=-2:height=ih/2 " out.gif
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل