المنهج الدراسي الدرس 208 من 250 · المشاريع: بناء أشياء حقيقية
المشاريع: بناء أشياء حقيقية

المشروع: Markdown -> HTML

كل تطبيق ملاحظات، وREADME، وصندوق دردشة يعرض Markdown يقوم بتشغيل دالة تشبه إلى حد كبير تلك التي ستكتبها الآن. ستقوم ببناء to_html(md): خذ سلسلة Markdown وأرجع سلسلة HTML. هذا هو parser حقيقي، والجزء المثير هو blocks that span multiple lines: مجموعة من النقاط تتحول إلى قائمة واحدة، ومجموعة من أسطر النص تتحول إلى فقرة واحدة.

الحيلة التي تجعل هذا الأمر نظيفا هي حلقة buffer-and-flush. أنت تمر على الأسطر واحدا تلو الآخر. تتراكم أسطر النقاط في list buffer؛ وتتراكم أسطر النص في paragraph buffer. عندما تصل إلى سطر ينهي الكتلة الحالية (سطر فارغ، أو عنوان، أو نوع كتلة مختلف)، أنت flush الـ buffer إلى HTML block مكتمل.

blocks, para, items = [], [], []
for line in md.split("\n"):
    s = line.strip()
    if s == "":
        flush_list(); flush_para()   # blank line ends any open block
    elif s.startswith("- "):
        items.append(s[2:])          # keep collecting bullets
    else:
        ...

القواعد (تمت إضافتها هنا حتى تتمكن من قراءة العلامات):

  • # text -> <h1>text</h1>
  • ## text -> <h2>text</h2>
  • consecutive - item lines -> one <ul><li>item</li>...</ul>
  • نصوص مفصولة بأسطر فارغة
  • -> واحدة <p>...</p> لكل منها (اجمع الأسطر بمسافة)
  • **bold** في أي مكان -> <strong>bold</strong>

تعامل مع الخط العريض داخل السطر بتعبير نمطي واحد: re.sub(r"\*\*(.+?)\*\*", r"<strong>\1</strong>", text) وطبّقه على نص كل كتلة. اربط الكتل المكتملة دون فاصل. انتبه للحالات الحدّية التي تفحصها الاختبارات: خط عريض داخل عنوان، وقائمة تلي عنواناً مباشرة دون سطر فارغ، وأسطر فارغة شاردة في البداية أو النهاية. اضغط Run لتحويل مستند كامل إلى HTML.

دورك

اكتب to_html(md) الذي يحول Markdown إلى سلسلة HTML: عناوين # H1 و ## H2، أسطر - item المتتالية إلى <ul> واحد، النص المفصول بأسطر فارغة إلى فقرات <p> (الأسطر مدمجة بمسافة)، و **bold** إلى <strong>. استخدم حلقة buffer-and-flush لضمان دمج كتل الأسطر المتعددة بشكل صحيح.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.