jmmasw

فقط اجعلني موقعًا ثابتًا

JMMASW هي أداة بسيطة لمشكلة بسيطة: مواقع الويب الثابتة.

عملية

1. قم بتحميل جميع الملفات باستخدام الامتداد ".html" أو ".tmpl"
2. تحليل كل ملف في قالب GO
3. قم بتحميل ملف البيانات ("./data.json" لكل افتراضي)
4. قم بتشغيل جميع القوالب مع اسم ينتهي في ".html"
5. اكتب الإخراج إلى الملفات ما لم يكن فارغًا

الاستخدام

يقبل JMMASW معلمات سطر الأوامر التالي:

• data - موقع ملف البيانات
• dir - موقع المشروع ، الافتراضي هو الدليل الحالي
• static-out دليل الإخراج ، الافتراضي هو ./jasw-out
• ignore-no-data الإعدادات الافتراضية إلى True. إذا تم ضبطها على خطأ ، فإن ملف البيانات المفقود ينتج عنه إنهاء البرنامج

مبنى

تم تصميم JMMAMW باستخدام GO1.8 ، لذلك يجب عليك على الأقل تثبيت GO1.8 حتى يعمل هذا ولكن قد تعمل الإصدارات القديمة أيضًا (ولكن لا توجد وعود)

لتثبيت ببساطة تشغيل الأوامر التالية:

 go get go.rls.moe/jmmasw
go install go.rls.moe/jmmasw

قوالب

للحصول على معلومات حول تنسيق القالب ، ارجع إلى إدخالات GODOC على html/template text/template .

يتم تعريف القوالب بواسطة اسم الملف الخاص بهم ولكن إذا قمت بتعريف القوالب يدويًا ، فلا ينطبق ذلك.

سيتم تقديم القوالب التي تحمل اسمًا تنتهي فقط في ".html" ، "

وظائف القالب

• يقبل file سلسلة واحدة كمعلمة ويحاول قراءة نموذج الملف المحدد نظام الملفات
• تقوم json بتوصيف سلسلة معينة في تنسيق JSON ، يجب أن يكون الهيكل الأعلى خريطة ، ولا يُسمح بالمصفوفات البسيطة
• يقوم markdown بإعداد سلسلة معينة في HTML باستخدام معالجات Markdown دون أي تطهير (لا تستخدم في مدخلات المستخدم!)
• يقبل dict أي عدد من أزواج القيمة الرئيسية مع مفتاح من النوع المسمى ويعيد النتيجة. هذا يسمح للجمع بين عدة متغيرات في خط أنابيب واحد

خريطة الطريق

• قم بتضمين محلل التنسيق والملف المحمل
• وظيفة لتحليل ملفات .json إضافية من داخل القوالب
• طريقة لتجاهل الدلائل المحددة
• وظيفة لإخراج الملفات غير الموجودة كقوالب
  • مثال: الفهرس.

انتظر ماذا؟

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

لقد فكرت في Hugo ، وهو مولد صفحة ثابتة ممتازة ولكنه أيضًا معقد للغاية لهذا التطبيق. يعمل JMMASW مع قوالب "RAW" HTML ولا يجعل أي افتراض حول موقع الويب الخاص بك.

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