triumphmayflowerclub.com
ved Mark Smith's email address
TriumphmayflowerClub.com 
نادي Triumph Mayflower Club هو منظمة مخصصة للحفاظ على سيارة الخمسينيات الكلاسيكية ، Mayflower ، من قبل الشركة المصنعة للسيارات البريطانية Triumph. تشكل النادي نفسه في عام 1974 وجعل غزوته المبدئية المحدودة في شبكة الويب العالمية في عام 2005 ، ثم تم تكليف I (Andi ، Project Project) في عام 2017 لإنشاء موقع ويب جديد من نقطة الصفر عندما أصبح والدي أعضاء. انقر هنا إذا كنت مهتمًا بقراءة المزيد عن السيارة والنادي.
تم كتابة هذا الموقع الجديد في Vanilla HTML5 للحصول على علامة ترميز المستندات ، CSS3 للتصميم ، وهو كمية صغيرة من JavaScript (ES6) وتم تصميمها باستخدام Jekyll كمولد موقع ثابت لتقليل تكرار التعليمات البرمجية. إنه مصمم لتشغيله في أي متصفح "دائمة الخضرة" الرئيسية (أي Microsoft Edge المستندة إلى الكروم أو Google Chrome أو Mozilla Firefox أو Apple Safari أو Opera) أو سطح المكتب أو الهاتف المحمول ، دون مشكلة.
إن وضع الاستضافة الحالي لموقع الإنتاج مناسب حقًا حقًا لاستضافة موقع HTML ثابت (Yay ، قيود الميزانية على نادي متخصص) ، لذلك ليس من العملي حقًا استضافة أي شيء آخر غير ذلك ، على سبيل المثال ، Asp.net Core Server ، مع مراعاة المزيد من الأرقام المتقدمة ، من خلال التصنيف المتقدم ، مع مراعاة ذلك ، مع مراعاة ذلك ، فإنها تتميز بالتصوير المتقدم ، من خلال الحصول على المباراة المتقدمة ، من خلال المركز العلوي ، مع وجود تصنيف متميز. الاستضافة للسماح بحل أكثر تعقيدًا لخادم العميل.
يمكن العثور على الإصدارات المختلفة المستضافة من موقع الويب في المواقع التالية ، حيث يكون خادم Canary هو موقع GitHub Pages الذي تم إنشاؤه تلقائيًا على أحدث master ، وهي منطقة التدريج هي نطاق فرعي للموقع المباشر الذي ننشره يدويًا عندما نرغب في اختبار ميزات جديدة وموقع الإنتاج هو الموقع الحالي الذي ينشره أيضًا إلى مانوي):
أوه ، ولمجرد المتعة ، إليك ما بدا عليه الموقع القديم للمقارنة!
يتم استخدام نظام إصدارات Github لزيادة إصدار الإصدارات ووضع علامة ونشر ، وهو المصدر الوحيد للحقيقة لماهية الإصدار الحالي من موقع الويب. لا توجد أرقام إصدار بشكل صريح في ملفات الريبو.
نظرًا لأن قاعدة البيانات هذه هي موقع ويب ، فمن الواضح أنه لا توجد حاجة للحفاظ على أي فروع إصدار لإصلاحاتها الخلفية ، حيث سيكون هناك موقع حي واحد فقط سيكون له دائمًا أحدث التغييرات عليه.
عندما يتم إصدار إصدار جديد من الموقع عبر Github ، سيقوم موقع الويب بالاستعلام عن نقطة نهاية GitHub API في وقت التشغيل للحصول على رقم إصدار أحدث إصدار وتاريخ النشر ، والذي يتم عرضه بعد ذلك إلى المستخدم النهائي في تذييل كل صفحة.
يتم استخدام Semver ، وإن كان ذلك فضفاضًا ، كخطط ترقيم الإصدار للموقع. يتم صدم الأجزاء الرئيسية والثانوية والتصحيح لإصدار وفقًا للأنواع التالية من التغيير إلى قاعدة الشفرة:
كان هناك إصداران رئيسيان تم نشرهما حتى الآن ، وهما مدرجان أدناه مع تغييراتهما الرئيسية ، وكذلك الميزات الجارية حاليًا للتحديث الرئيسي التالي-كل إصدار تاريخي نُشر على الإطلاق منذ أن تم العثور على هذا الموقع الجديد على صفحة الإصدارات:
هذه قائمة غير شاملة للأشياء التي أرغب في إضافتها في التنمية المستقبلية ، بأي ترتيب معين. من الواضح أن هذا عرضة للتغيير ، ولكن يجب أن يكون مؤشرا جيدا على ما سيأتي. سأضع علامة على الأشياء وعندما ينجزون. أرغب في النهاية في الوصول إلى مرحلة قدمت فيها أدوات كافية بحيث يمكن نشر معظم المحتوى من قبل أشخاص آخرين ، بحيث أكون متحرراً للعمل في المقام الأول على إضافة ميزات جديدة.
لقد حاولت أن أكتب هذه القراءة بطريقة تجعل أولئك الذين ليسوا على دراية بالترميز فرصة للوقوف للمساهمة في تطوير موقع الويب إذا كانوا يميلون إلى حد كبير ؛ مثل أعضاء النادي. على هذا النحو ، إذا كنت مطورًا بالفعل ، فقد تبدو بعض هذه التعليمات أكثر من اللازم ، حتى تتمكن من تخطي بعض العناصر. على العكس من ذلك ، إذا لم تكن ذكاءً للغاية ، أوصي بقراءة كل شيء إذا كنت ترغب في أن تكون قادرًا على مساعدتنا في الموقع-بالمناسبة ، فأنت مرحب بك تمامًا هنا أي مستوى من الخبرة (إن وجد) ، ولهذا السبب حاولت أن أكون صريحًا قدر الإمكان مع التعليمات ، لذا يرجى عدم الشعور بالإغراء إذا بدا الأمر ساحقًا! أرسل لي بريدًا إلكترونيًا إذا كنت ترغب في المشاركة ولكن يمكنك أن تفعل بيد ، وسأكون سعيدًا بجذبك.
بالنسبة للجزء الأكبر ، فهذه هي متطلبات الحانة العارية للحصول على الصعود والتشغيل.
على الرغم من أن هذا الدليل ليس متطلبًا تمامًا ، إلا أنني أتطور شخصيًا على Windows بنفسي ، لذلك ، بطبيعة الحال ، تم تصميم هذا الدليل للحصول على بيئة تطوير على جهاز كمبيوتر يعمل بنظام Windows. إذا كنت على Windows ، فإنني أوصي بشدة بالترقية إلى Windows 10 إذا لم تكن قد فعلت ذلك بالفعل:
ليس لدي أي مشكلة في تطوير المساهمين باستخدام MacOS أو Linux على افتراض أنك تعرف ما تفعله والتمسك بنهايات الخط على طراز Windows ( CR+LF ). قد أقوم بتوسيع هذه الإرشادات في المستقبل إذا كان هناك طلب كافٍ للأشخاص الذين يرغبون في تطوير على منصات أخرى - لا تتردد في تقديم طلب سحب نفسك لتحديث ReadMe مع التعليمات المذكورة إذا كنت أحد المطورين!
GIT هو ما يُعرف باسم نظام التحكم في الإصدار (VCS) وهو ما يستخدمه ملايين المطورين في جميع أنحاء العالم كل يوم لإدارة قواعد الكود الخاصة بهم. إنه يوفر تاريخًا شاملاً من التغييرات التي تم إجراؤها على مستودع التعليمات البرمجية المصدر وكذلك الأدوات لمساعدة العديد من المطورين على العمل معًا على نفس قاعدة كودس عن بعد من أي مكان على هذا الكوكب. يتم تطوير موقع Triumph Mayflower الجديد حاليًا باستخدام GIT كـ VCs لتوفير العمود الفقري الصلب لعملية التطوير الخاصة بنا. اتبع هذه الخطوات لتثبيت Git لنظام التشغيل Windows:
يتم استضافة رمز مصدر الموقع على Github (موقع الويب الذي تقرأه حاليًا على ذلك). لتنزيل الكود المصدر وتغييره ، ستحتاج إلى الاشتراك في حساب GitHub:
ssh-keygencat ~/.ssh/id_rsa.pub > /dev/clipboardبالنسبة لأولئك غير المألوفين ، فإن "مستودع" GIT أو "repo" لفترة قصيرة ، هو مجموعة من ملفات التعليمات البرمجية المصدر (عادةً ما يتم تخزينها على خادم "عن بعد" مركزي في مكان ما) إلى جانب ملفات بيانات تعريف محددة تديرها GIT والتي تحتوي على معلومات محددة في كل ما تم إجراؤه في كل ما يتم إجراؤه في كل شيء تم إجراؤه على كل ما يتم إجراؤه في الكود على كل ما يتم إجراؤه في كل شيء. صنع ، الذين صنعوها وكيف تم دمجها مرة أخرى في التدفق الأساسي للرمز من "الفروع" المؤقتة حيث يمكن للمطورين العمل على نسخ معزولة من الكود دون التدخل مع Devs الآخرين الذين يعملون على نفس قاعدة الكود.
من أجل إجراء تغييرات على موقع الويب ومعرفة تأثير تلك التغييرات ، ستحتاج إلى تنزيل الرمز المصدر إلى جهازك المحلي في ما يسمى بعملية "استنساخ" . سيؤدي ذلك إلى تنزيل نسخة من مستودع رمز المصدر إلى نظام الملفات الخاص بك والسماح بإدارته بواسطة GIT:
C:dev ؛ أنا شخصياً أحتفظ بممثلي في C:DevelopmentRepositories ).C:dev ):cd /c/devgit clone [email protected]:Stack-in-a-box/triumphmayflowerclub.com.gityes واضغط على [Enter] .cd triumphmayflowerclub.comعندما تقوم بتنزيل نسخة محلية من المستودع ، تحتاج إلى تكوين GIT بحيث يعزولك تلقائيًا كمؤلف لأي رمز تقوم به:
<name> مع اسمك الأول والأخير:git config --local user.name "<name>"<email> بعنوان البريد الإلكتروني الذي استخدمته لتسجيل حساب GitHub الخاص بك (لا تحتاج إلى عروض أسعارها على جانبي عنوان البريد الإلكتروني كما هو الحال مع إعداد اسمك في الخطوة السابقة ، حيث لن يحتوي على أي مسافات):git config --local user.email <email>Jekyll هو ما يعرف باسم "منشئ الموقع الثابت" . يتيح لنا تقليل كمية الكود المتكرر في جميع أنحاء قاعدة الشفرة ، عن طريق "العوملة" الأجزاء الشائعة الاستخدام من الصفحة (مثل صورة العنوان ، شريط التنقل ، تذييل الصفحة ، الأنماط الأساسية ، إلخ) إلى ملفات واحدة تتم الإشارة إليها ببساطة في صفحات محددة ؛ بعد ذلك ، عندما يتم تشغيل Jekyll إلى "إنشاء" الموقع ، فإنه سيعيد إدخال رمز العائد في كل من الملفات المصدر التي تشير إليه ، وإنشاء مجموعة من الملفات التي أعيد بناؤها يمكنها بعد ذلك إلى الخادم المباشر وفتحها في متصفح الويب.
( ملاحظة: في وقت كتابة هذا التقرير ، وهو يوليو 2020 ، لا يدعم Jekyll بالكامل WSL 2 ، حيث لا تتلقى جميع أحداث تحديث نظام الملفات المطلوبة لميزة jekyll serve التي تسمح بإعادة البناء تلقائيًا كلما تغيرت ملفات المصدر ، لذلك التمسك بـ WSL 1 للوقت.)
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linuxbash ، الذي يجب أن يبدو شيئًا مثل <username>@<machine>:~$ ، قم بتشغيل الأمر التالي لتحديث قائمة الحزم التي يمكن تثبيتها وإعادة تثبيتها لتثبيتها من (أدخل كلمة مرور UNIX عند المطالبة). هذا سيستغرق بعض الوقت لإكمال:sudo apt-get update -y && sudo apt-get upgrade -ysudo apt-add-repository ppa:brightbox/ruby-ng (اضغط [Enter] للتأكيد)sudo apt-get updatesudo apt-get install ruby2.7 ruby2.7-dev build-essential (أدخل "y" عند سؤاله)sudo gem updatesudo gem install jekyll بمجرد الانتهاء من التثبيت ، في جلسة Ubuntu Terminal ، وافترض أنك اخترت C:dev كموقع لتخزين مستودعاتك ، قم بالتنفيذ الخطوات التالية لتوجيه مثيل خادم تطوير محلي:
cd /mnt/c/dev/triumphmayflowerclub.comjekyll serveServer running... press ctrl-c to stop. سيتم عرضه. في هذه المرحلة ، افتح متصفح الويب وانتقل إلى http: // localhost: 4000/لعرض الموقع الذي يعمل محليًا من نسختك المحلية من الرمز المصدر....done in x seconds. ، حيث x هو عدد الثواني التي استغرقتها لإنشاء التغييرات الجديدة). في هذه المرحلة ، يمكنك تحديث الصفحة المحملة في متصفحك وستظهر التغييرات على الموقع.( ملاحظة: لا تلاحظ Jekyll دائمًا عند إنشاء ملفات جديدة ، لذلك إذا قمت بتحديث متصفحك ولم يكن من الممكن الوصول إليه ، فحاول إغلاق Jekyll وتشغيله مرة أخرى ، ويجب تضمين الصفحة الجديدة في البناء.)
لقد أوصيت ببعض الأدوات التي قد ترغب في استخدامها للتطوير. لا مطلوب أي من هذه ، فقد يجعل العمل على الموقع أسهل.
ستحتاج إلى متصفح ويب ، ويفضل أن يكون مستندًا إلى الكروم ، مثل Microsoft Edge (المضمّن مع Windows 10) أو Google Chrome ، من أجل اختبار أي تغييرات تقوم بها على موقع الويب قبل الالتزام بها في قاعدة الشفرة.
إذا كنت ستقوم بتعديل رمز مصدر الموقع ، فستحتاج إلى محرر نص جيد. أوصي باستخدام Visual Studio Code لأنها حديثة وخفيفة الوزن وعبر المنصات ولديها العديد من الميزات التي عادة ما تجدها في IDE بالكامل مثل تسليط الضوء على بناء الجملة ، وإكمال الكود ، والانمنج ، ونظام بيئي كبير من الإضافات. لتطوير مواقع الويب البسيطة باستخدام الفانيليا HTML و CSS و JavaScript في بعض الأحيان ، يجب أن تعمل بشكل جيد للغاية خارج المربع دون أي تغييرات في التكوين أو الإضافات الإضافية:
ليست ضرورة ولكن يمكن أن تكون مفيدة عند تأليف المقالات الإخبارية أو المحتوى لإدراجها على الموقع ، حيث إنها تضيف تلقائيًا أحرف Unicode التي تتطلبها معايير الكود الخاصة بنا (المراد توثيقها في مرحلة ما في المستقبل) ، مثل "عروض الأسعار الذكية" ، وما إلى ذلك.
Photoshop هو ما أستخدمه لتحرير الصور ، ولكن يجب على معظم المحررين القيام بعمل جيد في مهام التحرير البسيطة.
رؤيتي لهذا المشروع ، كما يتطور ، هي أنه سيبدأ في جذب فريق أساسي من المطورين والمساهمين غير التقنيين ، بحيث يصبح مكانًا رائعًا حيث يمكن لأولئك الذين يريدون الحصول على أيديهم قذرة مع بعض تطوير موقع الويب المفتوح. سيؤدي امتلاك المزيد من أعضاء الفريق إلى تحرير لي للعمل على إضافات الميزات ، وإعادة البناء الكبرى ودمج التقنيات الجديدة.
في النهاية ، سيكون من الرائع أن يكون لدي وقت لتطوير مجموعة بسيطة ومخصصة لأدوات التأليف على طراز CMS من شأنها أن تتيح مؤلف أعضاء النادي غير التقنيين وتقديم مقالات إخبارية وغيرها من المحتوى لإدراجها على الموقع مع الحد الأدنى أو حتى الصفر الفني. كما هو الحال ، سيحتاج الموقع إلى التحديث يدويًا بواسطة قوم التفكير تقنيًا في المستقبل المنظور ، ولكن نأمل أن نصل إلى هذه المرحلة يومًا ما.
لنشر موقع التدريج أو المباشر ، قم بتنفيذ ما يلي:
jekyll build_site في جذر ريبو الخاص بك ، حيث هذا هو المكان الذي يضع فيه Jekyll الإخراج من عملية توليد الموقع.beta.triumphmayflowerclub.com أو public_html الدليل الفرعي ، اعتمادًا على ما إذا كنت تنتشر في موقع التدريج أو المباشر على التوالي.index.html وقم بإعادة تسمية updating.html إلى index.html . من الناحية المثالية ، ستكون هذه عملية ذرية لتقليل مخاطر عدم قدرة شخص ما على تحميل الصفحة الرئيسية ، ولكن الإطار الزمني الذي يحدث فيه هذا والقليل من الأشخاص الذين يصلون إلى موقعنا على الويب يعني أن هذه ليست مشكلة في الممارسة العملية. سيتم معالجة هذا بشكل صحيح بمجرد أن نبدأ في استخدام إجراءات GitHub للنشر المستمر.index.html ، واسحبها إلى لوحة الوجهة اليمنى.index.html من لوحة المصدر إلى الوجهة واحدة للكتابة فوقها. النشر اكتمل الآن. إذا كنت بحاجة إلى الدخول معي (Andi Emma Davies-Wilcox-مطور رئيسي) ، فيرجى القيام بذلك على عنوان البريد الإلكتروني التالي: [email protected]
حقوق الطبع والنشر © Stack-in-A-Box Software 2017-2021
حقوق الطبع والنشر © Triumph Mayflower Club 2005-2021
