blog doc space
v5.4.1
أبسط node.js cms & ssg!
لهب صغير في ظلام الخطأ ...
مهم
لم تعد هذه الوثائق تمثل الميزات المتنوعة لـ Blog-Doc. يرجى الرجوع إلى الوثائق الشاملة للحصول على معلومات محدثة حول وظائف المدونة DOC.
لتثبيت Blog-DOC على المساحة ، توجه عبر صفحة التثبيت الخاصة به وانقر فوق الزر Install App .
بمجرد التثبيت ، افتح التطبيق من أفقك أو عن طريق الوصول إلى مثيل المنشئ للتطبيق والنقر على زر Open Builder Instance .
سيتم إعادة توجيهك إلى عنوان التطبيق ونرى في متصفحك الرسالة التالية: Route Not Found .
من فضلك لا تخيف! لقد جربت بعض الطرق الأخرى ، لكن هذا هو أبسط وأكثر أمان.
الآن على افتراض أن مثيل المدونة الخاص بك لديه العنوان التالي:
https://abc-1-x234.deta.app ، في شريط العناوين لمتصفحك.
أضف بعد ذلك /admin-blog-doc-config ، العنوان الآن:
https://abc-1-x234.deta.app/admin-blog-doc-config ، اضغط على Enter.
سيتم إعادة توجيهك إلى صفحة ستوجهك عند تعيين التكوين الرئيسي للبدء في استخدام Blog-Doc ، خطوتين سهلين لمدة دقيقتين.
في النهاية ستقدم نموذجًا ، يستغرق الأمر 30 ثانية على الأقل لتحميل التكوين ، ثم يتم إعادة توجيهك إلى العنوان الأولي https://abc-1-x234.deta.app وانظر مرة أخرى: Route Not Found : Route Route Not Found .
مرة أخرى لا داعي للذعر! فقط أضف "/صفحات/توثيق" بعد العنوان. تصفح داخل التطبيق لمدة دقيقة (وقت للتفاعل مع الرمز مع محرك الأقراص الذي تم إنشاؤه حديثًا) دون زيارة المسار المنزلي ، ثم انتقل إلى المسار الرئيسي والبدء في استخدام مثيل المدونة الخاص بك؟
إذا لم ينجح ذلك من المرة الأولى ، ففعل ذلك مرة أخرى وسوف تفعل ذلك.
siteURL قبل نشر التطبيق.
Nota Bene: يجب أن ينتهي عنوان URL المباشر بقطع /
بالطبع ، يجب عليك أيضًا تعديل siteTitle و siteDescription و rssCopyright في صفحة الإعدادات.
يجب أن تحل محل قيم siteTitle و siteDescription و rssCopyright بذات موقعك.
يمكنك استبدال قيمة rssSiteLanguage بلغة موقعك.
يمكن العثور على قائمة برموز اللغة المتاحة على صفحة رموز لغة RSS.
⬆ العودة إلى الميزات
مثل خلاصة RSS ، يجب عليك توفير عنوان URL المباشر لموقعك في صفحة الإعدادات عن طريق تعديل قيمة siteURL لإنشاء الروابط الصحيحة لكل صفحة ، والنشر ، والعلامة والقالب وكذلك لطرق المدونة.
يرجى تذكر أن عنوان URL للموقع يجب أن ينتهي بقطع /
يمكنك التحقق من خارطة sitemp لموقعك تحت مسار /sitemap .
⬆ العودة إلى الميزات
يحتوي Blog-Doc على ميزة بحث مدمجة.
تتيح وظيفة البحث للمستخدم إجراء بحث على العناوين ومحتويات المنشورات.
يمكنك التحقق من البحث عن موقعك تحت مسار /search .
يمكنك تعطيل البحث في تطبيق Node.js وكذلك عن الموقع الثابت الذي تم إنشاؤه عن طريق إعطاء searchFeature قيمة false في صفحة إعدادات الموقع.
⬆ العودة إلى الميزات
يستخدم Blog-doc Aightlizing.js لتسليط الضوء على كتلة الكود .
لكتابة رمز مضمّن ، أحاط التعليمات البرمجية الخاصة بك مع backticks `` .
لتسليط الضوء عليه ، وفر اللغة للرمز المضمن من خلال وضعها بعد أن أقواس مجعد مع الاسم المستعار للغة الكود.
الأمثلة التالية ستمنحك فكرة أفضل.
على افتراض خط css هذا p : color { red } ، لتسليط الضوء عليه ، ستكتب `p { color: red }`{language=css} .
يحيط الرمز مع backticks `` ويتبعه {language=alias of code language} .
لكتابة كتلة من التعليمات البرمجية ، أحاط الكتلة الخاصة بك مع زوج من 3 backticks ``` .
لتسليط الضوء عليه ، وفر اسم الاسم المستعار للغة للكتلة بعد الـ 3 الأولى.
سنأخذ المثال السابق ونسلط الضوء عليه ككتلة:
```css
p { color: red }
```
سنحصل على الإخراج التالي:
p {
color : red;
}تفضل بزيارة اللغات المدعومة من Aightly.js للحصول على الاسم المستعار الصحيح إذا كنت غير متأكد.
بدلاً من ذلك ، يمكنك كتابة كتلة من التعليمات البرمجية دون توفير الاسم المستعار ، وسوف يكتشف jjs تلقائيًا اللغة.
إذا فشلت أداة التمييز في الكشف عن اللغة الصحيحة لمجموعة من الكود دون الاسم المستعار ، فما عليك سوى إضافة اللغة المطلوبة إلى الكتلة كما هو موضح أعلاه.
⬆ العودة إلى الميزات
تعد إضافة سمة id إلى علامة العنوان ، H2 حتى H4 فقط ، ميزة تنشيط اختيارية بشكل افتراضي.
تم تصميم هذه الميزة مع حالات الحافة وكتابة الأخطاء المطبعية في الاعتبار:
لإضافة id ، أضف أقواس مجعد مع علامة تصنيف تليها نص الهوية.
الأمثلة التالية ستمنحك فكرة أفضل:
<!-- Heading tags with an id property -->
## My awesome H2 title {# my-awesome-h2-title}
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >
### My awesome H3 title {# my awesome h3 title}
The HTML output will be : < h3 id = " my-awesome-h3-title " >My awesome H3 title</ h3 >
#### My awesome H4 title {# My awesome H4 title}
The HTML output will be : < h4 id = " my-awesome-h4-title " >My awesome H4 title</ h4 > يتم استبدال كل مسافة بيضاء تلقائيًا باصلت واصلة ويتم استبدال أي عدد من الواصلات المتتالية بوجه واحد فقط.
تتم إزالة أي عدد من الواصلة في بداية أو نهاية نص المعرف بحيث يكون ما يلي صالحًا أيضًا:
## My awesome H2 title { # ----- My ----- aWEsOMe ----- h2 ----- tITlE ----- }
Whatever the number of whitespace characters / hyphens is at the beginning,
between the words or at the end, the HTML output will still be :
< h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >أي شيء قبل تجاهل الهاشتاج الأخير ويتم تجاهل الأحرف الخاصة في نص الهوية أيضًا:
## My awesome H2 title { /!@# a comment ?%^& # -my= awesome+ h2 ( title ) | }
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >& will be parsed to amp (ampersand)
" will be parsed to quot (quotation)
> will be parsed to gt (greater then)
< will be parsed to lt (less then)كمثال:
## Honey & Bees {#Honey & Bees}
The HTML output will be : < h2 id = " honey-amp-bees " >Honey & Bees</ h2 > إذا كنت ترغب في تعطيل هذه الميزة ، فقم false قيمة addIdsToHeadings على صفحة إعدادات الموقع.
⬆ العودة إلى الميزات
منذ أن تحولت المدونة إلى CMS ، خططت لإضافة معرض وطريقة لاسترداد الصور للصفحات والمنشورات مباشرة.
الآن تم إنجازه تقريبًا. تقريبا ، لأن هناك دائما مساحة لإحداث تحسينات.
في الوقت الحالي ، يمكنك زيارة المعرض من خلال ضرب مسار /admin/gallery/images ، أو انتقل إلى صفحة الإدارة والنقر على رابط المعرض في القائمة أو بطاقةه.
في الروح العالمية لـ Blog-Doc ، فإن المطبخ سهل الاستخدام.
ستجد منطقة إسقاط حيث يمكنك إسقاط صورتك (الصور) أو النقر فوقها واختيار الصور (الصور) التي ترغب في تحميلها.
يمكنك أيضًا حذف صورة من المعرض بالنقر فوق الزر "حذف" .
أخيرًا ، لتعيين صورة إلى صفحة أو منشور ، يمكنك ، أثناء إنشاء أو تحديث ، اختيار صورة من المعرض عن طريق تحديدها مباشرة من الصفحة أو المنشور.
⬆ العودة إلى الميزات
(قريبا إلى الفضاء)
يمكنك التبديل بين الموضوعات واختيار التصميم الذي يناسب احتياجاتك.
المدونة DOC يأتي مع:
إذا كانت الصورة تساوي ألف كلمة ، فإن الفيديو يستحق مليون!
مقطع فيديو مدته 30 ثانية يوضح القدرة على تغيير مظهر وموقعك على الفور باستخدام المدونة.
سأضيف المزيد من الموضوعات إلى المدونة مع مرور الوقت.
إذا قمت بترميز سمة لـ Blog-Doc وترغب في إدراجها من بين الموضوعات المتاحة ، فيمكنك إخباري في مناقشات مستودع Blog-Doc بموجب فئة الأفكار.
يرجى الأخذ في الاعتبار أن موضوعات المدونة التي يجب أن تستخدم JavaScript العادي فقط ولا يمكن أن تحتوي على أي رمز أو صور (صور) تحتوي على قيود على النشر و/أو التوزيع!
⬆ العودة إلى الميزات
مع كل الاحترام الواجب للوقت والعمل الجاد لكل مطور قام بإنشاء مولد موقع ثابت مع Node.js ، بما في ذلك الإصدارات السابقة من Blog-Doc ، تلك هي غازات!
أقدم خالص اعتذاري مقدمًا لكل واحد من هؤلاء المطورين ، ولكن ليس من المفترض أن يكون التطبيق من أعمال الغازات ...
على الرغم من أن المنشورات التالية ليست ذات صلة بالنسخة الفعلية من المدونة ، فإنها تشرح بشكل جيد دوياري وقد يصدمك.
يرجى قراءة من 145 إلى 7؟
اقرأ أيضًا المدونة الجديدة
قراءة أيضا node_modules ليست ثقيلة ، المطورين كسول!
تستخدم Blog-Doc للمساحة الآن 14 وحدة فقط (1916.1 كيلو بايت أو 1.9161 ميغابايت) بدلاً من 131 (10082 كيلو بايت أو 10.082 ميغابايت)!
انتقل إلى صفحة المشكلات في مساحة المدونة على github وإنشاء مشكلة جديدة من خلال شرح أكبر قدر ممكن من المشكلة التي تواجهها.
انتقل إلى أفكار مساحة المدونة على Github وأخبرني عنها.
بما في ذلك SSG في Blog-Doc على المساحة يتطلب بعض التعديلات في الهندسة المعمارية.
سأدرس لاحقًا لتضمين SSG أو لا يعتمد على استخدام ومتطلبات المدونة DOC على المساحة.
يرجى قراءة قسم التثبيت.
أنوي إجراء الكثير من التحسينات على هذا التطبيق في وقت فراغي القصير.
يمكنك أخذ المدونة DOC كنموذج أولي وتعديله تمامًا لاستخدامه مع تصميم آخر و/أو لغة قالب آخر.
آمل حقًا أن يكون هذا التطبيق مفيدًا بأي طريقة لكثير من الأشخاص هناك ، وأنا أفكر في ذلك كمساهمتي الشخصية في مجتمعات Node.js ومخدلات التكلفة.
الأفكار والتعليقات والاقتراحات موضع ترحيب كبير.
SYA ، Lebcit
بنيت مع ❤ بواسطة lebcit
