VulkanTutorial

تعليمي فولكان

يستضيف هذا المستودع محتويات Vulkan-Tutorial.com. يعتمد الموقع نفسه على daux.io ، والذي يدعم تخفيض النكهة github. يعمل الموقع الفعلي على تشغيل daux.io مع سمة مخصصة وبعض التعديلات (https://github.com/overv/daux.io) وهذا مدمج في صورة Docker.

استخدم المشكلات وسحب الطلبات لتقديم ملاحظات تتعلق بالموقع. إذا كانت لديك مشكلة في الكود الخاص بك ، فاستخدم قسم التعليقات في الفصل ذي الصلة لطرح سؤال. يرجى تقديم نظام التشغيل الخاص بك وبطاقة الرسومات وإصدار برنامج التشغيل والرمز المصدر والسلوك المتوقع والسلوك الفعلي.

الكتاب الإلكتروني

هذا الدليل متاح الآن بتنسيقات الكتب الإلكترونية أيضًا:

• Epub (الإنجليزية ، الفرنسية)
• PDF (الإنجليزية ، الفرنسية)

يمكن بناء الكتاب الإلكتروني من المحتوى الحالي عن طريق التشغيل:

 python3 build_ebook.py

يعتمد هذا البرنامج النصي على المرافق التالية المتاحة على المسار:

• inkscape : SVG to PNG Conversion (تم اختباره مع الإصدار 1.0.2)
• pandoc : بناء ملف PDF و EPUB من رمز التخفيض (تم اختباره مع الإصدار 2.13)

تحتاج أيضًا إلى تثبيت توزيع اللاتكس لتوليد PDF.

تغيير الكود عبر الفصول

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

• تحديث أي فصول تشير إلى الرمز المعدل.
• قم بعمل نسخة من الملف الأول الذي يستخدمه وتعديل الكود هناك ، على سبيل المثال base_code_fixed.cpp .
• قم بإنشاء تصحيح باستخدام diff -Naur base_code.cpp base_code_fixed.cpp > patch.txt .
• قم بتطبيق التصحيح على ملف الكود المحدد وجميع الملفات في الفصول اللاحقة باستخدام البرنامج النصي incremental_patch.sh . قم بتشغيله مثل هذا: ./incremental_patch.sh base_code.cpp patch.txt .
• قم بتنظيف ملفات base_code_fixed.cpp و patch.txt .
• يقترف.

تقديم البرنامج التعليمي

لتقديم البرنامج التعليمي (أي تحويل Markdown إلى HTML) ، لديك خياران:

1. تقديم الملفات المقدمة أثناء الطيران باستخدام خادم الويب الذي تم تثبيته PHP
2. إنشاء ملفات HTML ثابتة يمكنك عرضها محليًا أو وضعها على خادم

بالنسبة لأي من هذه الخيارات ، ستحتاج إلى php و daux patch'ed.

PHP

1. تأكد من تثبيت PHP (Daux مكتوب في PHP)
   1. يجب تمكين كل من امتدادات php_mbstring و php_openssl
   2. يجب ضبط إعداد phar.readonly على Off (لتكون قادرًا على إعادة بناء Daux)
2. تأكد من تثبيت الملحن ، وهو مدير تبعية PHP يستخدمه Daux

استنساخ ، تصحيح ، وإعادة بناء daux

1. استنساخ Daux
   • git clone https://github.com/dauxio/daux.io.git
2. قم بعمل فرع جديد في المراجعة القديمة التي يعارضها التصحيح المبتذلة:
   • git checkout d45ccff -b vtpatch
   • إن صنع فرع جديد ليس ضروريًا تمامًا ، حيث يمكنك إعادة ضبط master ، ولكن هذا يحافظ على سليمة.
3. انسخ على ملف daux.patch في دليل daux.io ، تأكد من أن نهايات الخط هي نمط UNIX (في حالة استخدام Windows) ، وتطبيق التصحيح. يجب أن تنطبق بشكل نظيف.
   • git am daux.patch
4. قم بتشغيل الملحن في دليل daux.io بحيث يقوم بتنزيل احتياجات Daux التبعية من أجل الإنشاء
   • composer install
5. إعادة بناء daux
   • php bin/compile (قد يستغرق هذا بعض الوقت)
   • سيكون daux.phar مصنوع حديثًا في دليلك الأساسي

باستخدام Daux لخدمة الملفات المقدمة أثناء الطيران

بمجرد الانتهاء من ما سبق ، اتبع الإرشادات الموجودة على موقع Daux لكيفية تشغيل Daux باستخدام خادم الويب.

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

1. في دليل daux.io ، تحرير global.json بحيث يشير خيار docs_directory
   • "docs_directory": "../VulkanTutorial",
2. في دليل daux.io ، قم بالتشغيل
   • php -S localhost:8080 index.php
3. اكتب localhost:8080 في شريط عنوان URL لتصفح الويب الخاص بك واضغط على Enter. يجب أن ترى الآن الصفحة الأولى في الفلكانتوت.

باستخدام Daux لإنشاء ملفات HTML بشكل ثابت

قبل أن ننشئ الملفات الثابتة ، نحتاج إلى تعديل Daux وإعداد البرنامج التعليمي لمنعها من محاولة تحميل بعض الموارد الخارجية (والتي ستوقف متصفحك عند محاولة تحميل الصفحة الثابتة على خلاف ذلك)

1. في دليل VulkanTutorial ، قم بتحرير config.json وإزالة خط google_analytics حتى لا يحاول Daux تحميل ذلك.
2. في دليل daux.io ، قم بتحرير themes/daux/config.json وإزالة خط font بحيث لا يحاول Daux تحميل خط خارجي.
3. أعد بناء Daux وفقًا للتعليمات السابقة حتى يلتقط تغييرات السمة.

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

الآن مع ما سبق ، يمكننا إنشاء الملفات الثابتة. تقع دلائل Daux.io و Vulkantutorial بجوار بعضها البعض ، انتقل إلى دليل daux.io وقم بتشغيل أمر مشابه لـ: php generate -s ../VulkanTutorial -d ../VulkanTutorial/out .

يخبرنا -s بمكان العثور على الوثائق ، بينما يخبرها -d إلى أين تضع الملفات التي تم إنشاؤها.

ملاحظة: إذا كنت ترغب في إنشاء مستندات مرة أخرى ، فاحذف الدليل out أولاً أو سيقوم Daux بإنشاء دليل جديد out الدليل out الحالي.

رخصة

يتم ترخيص محتويات هذا المستودع كـ CC BY-SA 4.0 ، ما لم ينص على خلاف ذلك. من خلال المساهمة في هذا المستودع ، فإنك توافق على ترخيص مساهماتك إلى الجمهور بموجب نفس الترخيص.

قوائم الرموز في دليل code مرخصة باسم CC0 1.0 Universal. من خلال المساهمة في هذا الدليل ، فإنك توافق على ترخيص مساهماتك للجمهور بموجب نفس الترخيص الشبيه بالمجال العام.