تنزيل bitrock website - تنزيل كود مصدر bitrock website

bitrock website

فئات أخرى

v2.0.0 - VuePress

تنزيل

موقع bitrock

موقع الويب هذا هو مثيل VuePress مع سمة مخصصة مطبقة عليه، يمكنك قراءة الوثائق الرسمية لمعرفة كيفية تحرير المحتويات أو كيفية عمل السمة.

المتطلبات

تحتاج إلى تثبيت البرنامج التالي على جهازك للبدء:

Node.js أحدث مستقر
يمكن تثبيت كل من مدير حزم Yarn عبر Homebrew على بيئات MacOS وLinux.

خلق بيئة تطوير محلية

استنساخ الريبو محليا

$ git clone [email protected]:bitrockteam/bitrock-website.git

انتقل إلى المجلد وقم بتثبيت التبعيات باستخدام Yarn

$ cd bitrock-website && yarn

ابدأ تشغيل خادم الويب للتطوير على localhost:8080

$ yarn start

التأليف

يتم توفير المحتوى عبر ملفات Markdown في المجلد ./src ، ولا يوجد محرر مرئي مدمج لذا يمكن تأليفها أينما تريد، ولكن بالترتيب. يتم دعم مكونات Vue ضمن محتوى Markdown ويمكن اعتبار إضافة بعض المكونات المخصصة لتمكين المؤلفين بقدرات إضافية. يتم توفير البيانات التعريفية باستخدام مواصفات Frontmatter.

أضف صفحة

قم بإنشاء مجلد فرعي في المسار ./src ثم قم بإنشاء ملف readme.md بداخله، وأضف فوق الملف البيانات التالية:

---
layout : Page
---

مثال : سيصبح الملف ./src/about-us/readme.md هو صفحة https://bitrock.it/about-us .

لإضافة صفحة في قائمة التنقل، يجب تحديث ./src/.vuepress/config.js .

أضف مشاركة مدونة

قم بإنشاء مجلد فرعي في مسار ./src/blog ثم قم بإنشاء ملف readme.md بداخله، وأضف البيانات التالية في أعلى الملف:

---
title : Hello world!
image : /img/hello.jpg
author : writer
publish : 2018-12-21
layout : Post
category : news
tags :
  - greetings
  - hello
---

مثال : سيصبح الملف ./src/blog/hello-world/readme.md هو صفحة https://bitrock.it/blog/hello-world .

سيتم عرض المشاركات بترتيب زمني عكسي (الأحدث أولاً) على الصفحة الرئيسية.

الصور

يجب إضافة الصور على مستوى الموقع في المجلد ´./src/.vuepress/public/img´. لاحظ أنه إذا قمت بإضافة صورة داخل مجلد منشور أو صفحة، فلن يكون من الممكن الوصول إليها خارج عنوان URL للصفحة باستخدام مسار نسبي.

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

تطوير

توجد جميع ملفات مصدر التطوير داخل المجلد ./src/.vuepress/theme .

يعد ./src/.vuepress/public هو المكان الذي يمكنك فيه وضع أي نوع من الأصول التي يجب أن تكون متاحة كموارد ثابتة على مستوى الجذر لمجال النشر. سيتم الحفاظ على المجلدات الفرعية.

الإضافات فيوبريس

@vuepress/plugin-google-analytics يعطي معرف مراقبة Google Analytics، وسيقوم بإدخال الكود المطلوب في الصفحات.
@vuepress/plugin-pwa يقوم بإنشاء عامل خدمات في مرحلة الإنشاء لرسم خرائط لجميع الأصول الثابتة للتخزين المؤقت دون اتصال بالإنترنت. ولن يقوم بإنشاء بيان الويب المطلوب لتشغيل وظائف PWA، والذي يتم تأليفه يدويًا وتقديمه في المجلد العام.
@vuepress/plugin-back-to-top، ما عليك سوى إضافة زر السهم من الخلف إلى الأعلى بعد التمرير لأسفل قليلاً من منفذ العرض الأولي.
يضيف @vuepress/nprogress شريط التقدم أعلى الصفحات عند تحميل محتوى جديد، على غرار ما يحدث في YouTube.

المرافق شبيبة

التبعية الرئيسية هنا هي مكتبة Vue.js التي تُستخدم لبناء المكونات، وكل شيء آخر هو Vanilla Javascript.

المرافق CSS

نحن نستخدم مكتبات CSS هذه:

Normalize.css يجعل المتصفحات تعرض جميع العناصر بشكل أكثر اتساقًا وتماشيًا مع المعايير الحديثة.
typebase.css نقطة انطلاق لطباعة الويب.
قائمة الهامبرغر المتحركة CSS.

سياسة التفرع

يتبع هذا المشروع سياسة التفرع البسيطة:

يحتوي master على تعليمات برمجية مستقرة فقط، ولا ينبغي تحديثه مباشرة
development حيث تتم كتابة التعليمات البرمجية المتطورة أو التجريبية
gh-pages حيث يتم نشر الملفات الثابتة القابلة للتوزيع ولكن ** يجب عليك تجنب الالتزام/الدفع هنا مباشرة**

لا تقم بدمج development مباشرة في master ( إنه مقفل من قبل المسؤول... )، أرسل دائمًا العلاقات العامة للحصول على مراجعة.