المدونة | Example Hugo site with Toph themehttps://justwheel.github.io/toph-hugo-theme/ar/blog/Honorary biography page of Septima Clark, a Civil Rights Movement pioneer and activist.Hugo -- gohugo.ioarSeptima Poinsette ClarkMon, 01 Jan 0001 00:00:00 +0000دعم تنبيهات AsciiDochttps://justwheel.github.io/toph-hugo-theme/ar/blog/asciidoc-admonitions/Sun, 05 Jul 2026 00:00:00 +0000https://justwheel.github.io/toph-hugo-theme/ar/blog/asciidoc-admonitions/

يوفر AsciiDoc خمسة أنواع مدمجة من التنبيهات للفت الانتباه إلى محتوى معين. يقوم Toph بتنسيق كل نوع كبطاقة تنبيه أنيقة بحد أيسر ملون، وخلفية بلون خفيف، وأيقونة.

أنواع التنبيهات

يحدد AsciiDoc خمسة أنواع من التنبيهات، لكل منها غرض مختلف.

Note
 استخدم الملاحظات لتقديم سياق إضافي أو معلومات تكميلية تدعم النص الرئيسي.
Tip
 استخدم النصائح لمشاركة أفضل الممارسات أو الاختصارات أو التوصيات التي تساعد القارئ.
Warning
 استخدم التحذيرات لتنبيه القارئ إلى المشكلات أو المخاطر المحتملة التي يجب أن يكون على علم بها.
Caution
 استخدم تنبيهات الحذر للإشارة إلى الإجراءات التي قد تسبب ضررًا أو فقدانًا للبيانات أو عواقب غير مقصودة إذا تم تنفيذها بلا حذر.
Important
 استخدم التنبيهات المهمة لإبراز المعلومات الحاسمة التي يجب ألا يتجاهلها القارئ.

التنبيهات الكتلية

يمكن أن تمتد التنبيهات أيضًا عبر عدة فقرات باستخدام صيغة الكتلة في AsciiDoc. هذا مفيد عندما تحتاج الرسالة إلى أكثر من جملة واحدة.

Note

تستخدم التنبيهات الكتلية صيغة المحدد بأربع علامات يساوي. يمكن أن تحتوي على عدة فقرات وقوائم وعناصر AsciiDoc أخرى.

هذه فقرة ثانية داخل نفس كتلة التنبيه.
Tip

عند كتابة التوثيق، ضع في اعتبارك أي نوع من التنبيهات يناسب رسالتك بشكل أفضل.

  • NOTE للسياق التكميلي

  • TIP للنصائح العملية

  • WARNING للمخاطر المحتملة

  • CAUTION لخطر الضرر أو فقدان البيانات

  • IMPORTANT للمعلومات الحاسمة
Warning

يجب استخدام التنبيهات باعتدال. الإفراط في استخدامها يقلل من تأثيرها ويجعل تصفح المحتوى أكثر صعوبة.

الصيغة

هناك طريقتان لكتابة التنبيهات في AsciiDoc.

الصيغة المضمنة

يضع الشكل الأبسط تسمية التنبيه في بداية الفقرة:

NOTE: هذه ملاحظة مضمنة.

TIP: هذه نصيحة مضمنة.

صيغة الكتلة

للتنبيهات متعددة الفقرات، استخدم محدد الكتلة:

[NOTE]
====
الفقرة الأولى من التنبيه.

الفقرة الثانية من التنبيه.
====

لمعرفة المزيد

]]>التدوين باستخدام AsciiDoc في Tophhttps://justwheel.github.io/toph-hugo-theme/ar/blog/asciidoc-blogging/Mon, 23 Mar 2026 00:00:00 +0000https://justwheel.github.io/toph-hugo-theme/ar/blog/asciidoc-blogging/

يتعامل Toph مع AsciiDoc باعتباره تنسيق محتوى من الدرجة الأولى. كل ما يعمل مع Markdown يعمل أيضًا مع AsciiDoc — شارات التصنيف، وبيانات المقالة الوصفية، وصور الغلاف، ومراسي العناوين، والتنقل.

لماذا AsciiDoc؟

يوفر AsciiDoc ميزات لا يوفرها Markdown:

  • جدول محتويات أصلي باستخدام خاصية المستند :toc:

  • كتل التنبيهات (NOTE، TIP، WARNING، IMPORTANT، CAUTION)

  • توجيهات التضمين لإعادة استخدام المحتوى عبر الصفحات

  • دعم مدمج للجداول المعقدة والقوائم المتداخلة

إذا كنت مرتاحًا بالفعل للكتابة بلغة AsciiDoc، فإن Toph سيلبي احتياجاتك دون أي تنازلات.

إنشاء مقالة بصيغة AsciiDoc

أنشئ ملفًا بامتداد .adoc في دليل مدونتك:

hugo new blog/my-post.adoc

أضف الواجهة الأمامية (front matter) بصيغة YAML في أعلى الملف، متبوعة بمحتوى AsciiDoc:

---
title: "عنوان مقالتي"
date: 2026-01-15
draft: false
categories:
  - "tech"
tags:
  - "hugo"
  - "asciidoc"
author: "اسم الكاتب"
description: "ملخص قصير للمقالة."
---

يبدأ محتوى AsciiDoc الخاص بك من هنا.

جدول المحتويات

لتفعيل جدول المحتويات، أضف الخاصية :toc: بعد الواجهة الأمامية:

---
title: "عنوان مقالتي"
toc: true
---
:toc:

== القسم الأول

ينسّق CSS الخاص بـ Toph جدول المحتويات الذي ينشئه AsciiDoc بنفس طريقة خيار toc: true في الواجهة الأمامية لـ Markdown. ينتج كلا التنسيقين نفس النتيجة المرئية.

مراسي العناوين

تظهر روابط مرساة قابلة للنقر (🔗) عند تمرير المؤشر فوق جميع عناوين الأقسام. بالنسبة لـ Markdown، يتم التعامل مع هذا عبر خطاف عرض (render hook). بالنسبة لـ AsciiDoc، يقوم Toph بحقن نفس ترميز المرساة عبر معالجة القوالب. ينتج كلا التنسيقين نتائج متطابقة.

لمعرفة المزيد

]]>مرحباً بالعالم: تقديم التدوين في Tophhttps://justwheel.github.io/toph-hugo-theme/ar/blog/hello-world/Sun, 22 Mar 2026 00:00:00 +0000https://justwheel.github.io/toph-hugo-theme/ar/blog/hello-world/يسعدنا أن نعلن أن قالب Toph لـ Hugo أصبح الآن يدعم التدوين! بدأ Toph كقالب خفيف للسيرة الذاتية والمعرض، لكنه تطور إلى منصة نشر قادرة. إليك جولة سريعة على الجديد.

دعم التصنيفات 🔗

يمكن تنظيم المقالات باستخدام الفئات والوسوم. الفئات هي تجميعات واسعة تُعرض كبطاقات بأسلوب المجلات في صفحة الفئات. الوسوم أكثر تفصيلاً وتُعرض كسحابة كلمات مرئية في صفحة الوسوم.

لاستخدامها، أضف categories وtags إلى الواجهة الأمامية (front matter) لمقالتك:

categories: ["announcements"]
tags: ["toph", "blogging", "hugo"]

بيانات المقالة الوصفية 🔗

تعرض كل مقالة تلقائيًا تاريخ نشرها والمؤلف ووقت القراءة وعدد الكلمات. تظهر الفئات والوسوم كشارات قابلة للنقر أسفل شريط البيانات الوصفية. إذا كان موقعك يحتوي على enableGitInfo: true، يظهر تاريخ “محدَّث” عند تعديل المقالة بعد نشرها.

أرشيف المدونة 🔗

يجمع أرشيف المدونة المقالات حسب السنة والشهر في تخطيط أكورديون قابل للطي. تكون السنة والشهر الأحدث موسعين افتراضيًا، مما يبقي الأرشيف سهل التصفح حتى مع نموه.

المقالات الحديثة في الصفحة الرئيسية 🔗

تظهر أحدث خمس مقالات تلقائيًا في الصفحة الرئيسية. تُعرض أحدث مقالة في بطاقة كبيرة، مع المقالات الأربع التالية في شبكة مدمجة أسفلها. لا حاجة لأي إعداد — إذا كانت هناك مقالات، فإنها تظهر.

التنقل بين المقالات 🔗

في أسفل كل مقالة، تتيح روابط “السابق” و"التالي" للقراء التنقل بين المقالات دون العودة إلى الأرشيف.

البدء 🔗

أنشئ مقالة مدونة جديدة باستخدام القالب المدمج في Hugo:

hugo new blog/my-first-post.md

هذا ينشئ مقالة جديدة بحقول الواجهة الأمامية الصحيحة. اضبط draft: false عندما تكون جاهزًا للنشر، ثم أعد بناء موقعك.

لمزيد من التفاصيل، راجع مستودع قالب Toph.

]]>