pdssg
1.0.0
أنشئ موقعًا ثابتًا وخلاصات Atom باستخدام Markdown وshell وpandoc.
git clone pdssg، من الناحية المثالية بجانب الدليل المصدر لموقعك.
git clone https://github.com/torresjrjr/pdssgلتشغيل pdssg وإنشاء موقع ثابت، قم بتنفيذ البرنامج النصي pdssg في دليل واحد أعلى الدليل المصدر للموقع.
$ ls
src/ pdssg/
$ ./pdssg/pdssg pdssg هو برنامج نصي واحد قابل للتنفيذ، بدون علامات سطر الأوامر. إنه ببساطة يقوم بإنشاء دليل موقع مجاور dst/ (الوجهة) من دليل مجاور موجود src/ (مصدر) مع محتويات الموقع (ملفات Markdown المراد تحويلها إلى صفحات ويب HTML وملفات أخرى).
تصميم pdssg معياري وقائم على الشجرة. فيما يلي مثال للدليل المصدر للموقع .
src/
|-- _ignore
|-- _feeds
|-- index.md
|-- about.md
|-- posts.md
|-- posts/
| |-- _drafts/
| | `--- 2020-04-01-bored.md
| |-- 2020-01-01-new-year.md
| |-- 2020-02-01-corona-what.md
| `-- 2020-03-01-stuck-at-home.md
|-- feeds/
| `-- posts.md
|-- assets/
| `-- style.css
|-- _templates/
| |-- atom.xml
| `-- main.html
`-- _includes/
|-- header.html
|-- footer.html
`-- meta.html
إليك دليل البناء الناتج.
dst/
|-- index.html
|-- about.html
|-- posts.html
|-- posts/
| |--- 2020-01-01-new-year.html
| |--- 2020-02-01-corona-what.html
| `--- 2020-03-01-stuck-at-home.html
|-- feeds/
| `--- posts.html
`-- assets/
`--- style.css
ملاحظة: سيتم تجاهل الملفات والأدلة التي تبدأ بشرطة سفلية _ .
سيتم تحويل ملفات Markdown إلى ملفات HTML، وتكون جاهزة كصفحات ويب. الاستثناءات هي مسارات ملفات مطابقة للأنماط الموجودة في ملف ./_ignore ، مثل ملف .gitignore .
يتوقع pdssg أن تحتوي ملفات Markdown على كتلة YAML أمامية، وهي عبارة عن كتلة من بيانات تعريف YAML محاطة بزوج من --- ، يسبق بقية محتويات الملف.
يجب أن تحتوي المادة الأمامية على الأقل على قيمة title ، والتي سيتم استخدامها لإنشاء عنوان عنوان <h1> . تعد قيم author date شائعة، ويوصى بها عند الاقتضاء.
مثال لملف تخفيض السعر:
---
title : My Webpage Title
author : John Smith
date : 2020-12-30
---
## Subheading
contents... كما في المثال، سيتم استخدام الدلائل _includes و _templates لإنشاء ملفات HTML وAtom. ثم يتم التخلص منهم.
بالنسبة للملفات الموجودة في _templates :
atom.xml لإنشاء مستندات HTML.main.html لإنشاء خلاصات Atom. بالنسبة للملفات الموجودة في _includes :
meta.html في رأس المستند ضمن علامات <meta> .header.html في النص ضمن علامات <body> ، قبل المحتوى الرئيسي.footer.html في النص ضمن علامات <body> ، بعد المحتوى الرئيسي.خلاصات Atom هي خلاصات تشبه RSS وتعتمد على تنسيق مشاركة أحدث وأكثر قوة. يتم استخدامها بشكل أساسي تمامًا مثل RSS ويشار إليها على هذا النحو. تسمح خلاصات Atom للقراء بالاشتراك في المحتوى الجديد لموقع الويب، مثل المدونة.
يمكن لـ pdssg إنشاء خلاصات Atom من الدلائل، باستخدام ملفات الدليل كمدخلات موجزة. للقيام بذلك، تحتاج إلى إنشاء دليل محدد للخلاصات الخاصة بك، وإنشاء "ملف بذور Atom" على هذا النحو:
./feeds/ ) واكتب مساره في ملف التكوين _feeds./posts/ )../feeds/posts/ )..md بالمسار (على سبيل المثال ./feeds/posts.md ). ارجع إلى موقع المثال أعلاه للتوضيح ( posts/ الدليل).
سيتم تحويل الملف الأولي Atom إلى ملف موجز Atom. ستكون هذه التغذية الناتجة موجودة في المسار الجديد ولكن بامتداد .xml بدلاً من .md . في هذا المثال، ستظهر خلاصة الذرة على example.com/feeds/posts.xml . لاحظ أن الملف ./posts.md ليس ضروريًا للخلاصة، بل هو دليل فقط.
ملاحظة: يتم ترتيب إدخالات Atom أبجديًا رقميًا حسب أسماء الملفات المقابلة لها، وليس حسب date المحدد بواسطة المادة الأمامية YAML الخاصة بها.
لقد ولد هذا المشروع نتيجة تحدي شخصي لموقعي الخاص. بناءً على طلب أحد المدونين الصديقين، قمت بتنظيفه ونشره للعامة.
اتصل بي: t.me/torresjrjr
