إعادة هيكلة النص

لغة reStructuredText ( RST أو ReST أو reST ) هي لغة ترميز نصية بسيطة تُستخدم بشكل أساسي في التوثيق التقني والبيانات النصية الأخرى. وهي تؤدي دورًا مشابهًا للغة Markdown، ولكنها تتضمن ميزات دلالية إضافية لهيكلة المستندات الأكثر تعقيدًا. ومن أبرز المشاريع مفتوحة المصدر واسعة النطاق التي تعتمد على reStructuredText: مجتمع لغة برمجة بايثون لتوثيقها الرسمي، ووثائق نواة لينكس ، و CMake ، ومشروع مُصرّف LLVM .

يُعدّ Docutils جزءًا من مشروع Docutils التابع لمجموعة Python Doc-SIG (مجموعة الاهتمام الخاصة بالتوثيق)، والذي يهدف إلى إنشاء مجموعة أدوات للغة بايثون تُشبه Javadoc للغة جافا أو Plain Old Documentation (POD) للغة بيرل . يستطيع Docutils استخراج التعليقات والمعلومات من برامج بايثون، وتنسيقها في أشكال مختلفة من توثيق البرامج. ^{[ 2 ]}

وبهذا المعنى، فإن reStructuredText هي لغة ترميز خفيفة الوزن مصممة لتكون قابلة للمعالجة بواسطة برامج معالجة الوثائق مثل Docutils، وأن تكون سهلة القراءة من قبل المبرمجين البشريين الذين يقرؤون ويكتبون شفرة مصدر بايثون .

تطورت لغة reStructuredText من لغة ترميز خفيفة الوزن سابقة تُسمى StructuredText ^{[ 3 ]} (طورتها شركة Zope ). وقد واجهت StructuredText عددًا من المشاكل، فتم تطوير reST لمعالجتها. ^{[ 4 ]} واختير اسم reStructuredText للدلالة على أنها "نسخة مُنقحة ومُعاد صياغتها ومُعاد تفسيرها من StructuredText". ^{[ 5 ]}

استُلهمت أجزاء من بنية reST من لغة Setext من أوائل التسعينيات. كما تم النظر في تضمين عناصر من تنسيق رسائل الإنترنت RFC822 وتنسيقات Javadoc الشائعة في التصميم. ^{[ 6 ]}

تم إصدار reStructuredText لأول مرة في يونيو 2001. ^{[ 1 ]} وبدأ استخدامه بشكل كبير في مجتمع بايثون في عام 2002. ^{[ 7 ]}

يُعد التنفيذ المرجعي لمحلل reST مكونًا من مكونات إطار عمل معالجة النصوص Docutils في لغة البرمجة بايثون ، ولكن تتوفر محللات أخرى.

لم يُسجّل مشروع Docutils أي نوع MIME لـ reStructuredText ، ولم يُصنّف أي نوع MIME غير مُسجّل كنوع رسمي، ولكنه يُوثّق استخدام هذا النوع من MIME text/x-rstفعليًا ، على سبيل المثال، في نظام بناء موقع Python الإلكتروني. ^{[ 8 ]} ويُستخدم النوع نفسه من MIME في قاعدة بيانات أنواع الملفات freedesktop.org التي تستخدمها بيئات سطح المكتب على نظام Linux . ^{[ 9 ]} وقد سُجّل نوع MIME آخر، ، كنوع MIME مُخصّص من قِبل جهة خارجية في عام 2003 لتمثيل reStructuredText، ولا يزال النوع الوحيد المُسجّل لدى IANA لـ reStructuredText، ^{[ 10 ]} على الرغم من أن مشروع Docutils لا يعترف به كذلك. ^{[ 8 ]}text/prs.fallenstein.rst

يُستخدم reStructuredText عادةً في التوثيق التقني، على سبيل المثال، في توثيق مكتبات بايثون. ^{[ 11 ]} ومع ذلك، فهو مناسب لمجموعة واسعة من النصوص.

منذ عام 2008، أصبح reST مكونًا أساسيًا لنظام توليد المستندات Sphinx الخاص بلغة بايثون .

يدعم Trac أيضًا reStructuredText، ^{[ 12 ]} كما يفعل GitHub و Bitbucket .

في عام 2011، كانت شركة Distributed Proofreaders ، التي أعدت النصوص لمشروع غوتنبرغ ، تدرس اعتماد تنسيق reST كتنسيق أساسي يمكن من خلاله إنشاء تنسيقات أخرى للكتب الإلكترونية. ^{[ 13 ]}

في يوليو 2016، قرر مشروع نواة لينكس الانتقال من التوثيق القائم على DocBook إلى reStructuredText ومجموعة أدوات Sphinx . ^{[ 14 ] [ 15 ]}

انتقلت أداة بناء البرمجيات CMake من لغة ترميز مخصصة إلى لغة reStructuredText في الإصدار 3.0 لتوثيقها. ^{[ 16 ]}

يدعم نظام JetBrains IDE تحرير reStructuredText من خلال إضافات مثل reStructuredText Pro ، التي توفر دعمًا لتوثيق RST وSphinx بما في ذلك المعاينة المباشرة وتمييز بناء الجملة. ^{[ 17 ]}

• مقارنة لغات ترميز المستندات
• مقارنة بين مولدات الوثائق
• مقارنة برامج تدوين الملاحظات

• الموقع الرسمي لـ reStructuredText مع صفحات مرجعية