عبد العزيز: بوت: إصلاح التحويلات

2022-12-12T23:12:29Z

بوت: إصلاح التحويلات

صفحة جديدة

{{بطاقة صيغة ملف
|الاسم = رموز التنسيق {{إنج|MarkDown}}
|النوع = [[لغة توصيف|لغة ترميز]]
|الإمتداد =.md
|المطور = [[جون غروبر]]
|موقع_المطور = http://daringfireball.net/projects/markdown/
}}

'''ماركداون''' {{إنج|MarkDown}} هي رموز للتنسيق تعتمد على [[لغة ترميز بسيطة]]، أنشأها [[جون غروبر]] وساهم فيها [[آرون سوارتز]]، تسمح بكتابة محتوى نصي بسيط يتميز بسهولة الكتابة والقراءة، ثم تحويله إلى لغة [[لغة توصيف النص الفائق|HTML]] أو [[لغة ترميز النص الفائق القابلة للتوسع|XHTML]].
<ref name=md>Markdown 1.0.1 readme source code {{استشهاد ويب|مسار=https://daringfireball.net/projects/markdown/|عنوان=Daring Fireball - Markdown|تاريخ=17-Dec-2004| مسار أرشيف = https://web.archive.org/web/20190909052124/https://daringfireball.net/projects/markdown/ | تاريخ أرشيف = 9 سبتمبر 2019 }}</ref>
وهي تأخذ العديد من التعليمات من [[عرف (مفهوم)|الأعراف]] الحالية التي تستخدم لترميز نص عادي في [[بريد إلكتروني|البريد الالكتروني]]. النص المنسق بواسطة تلك الرموز ينبغي أن يكون قابلاً للقراءة كما هو، من دون النظر إلى التوصيفات وعلامات التنسيق {{إنج|tags}}،
<ref name=philosophy>Markdown Syntax {{استشهاد ويب|مسار=https://daringfireball.net/projects/markdown/syntax#philosophy|عنوان=Daring Fireball - Markdown - Syntax|تاريخ=13-Jun-2013| مسار أرشيف = https://web.archive.org/web/20190909051956/https://daringfireball.net/projects/markdown/syntax | تاريخ أرشيف = 9 سبتمبر 2019 }}</ref>
على عكس النص المنسق بلغة توصيف أخرى مثل [[لغة توصيف النص الفائق|HTML]]، التي لديها تنسيقات واضحة وتعليمات تنسيق معينة. ماركداون تقوم ببناء جملة منسقة مقروءة وأيضاً يمكن تحويلها إلى [[لغة توصيف النص الفائق|HTML]] بسهولة.

الماركداون هو مخطوطة [[بيرل]] كتبها [[جون غروبر|غروبر]] {{إنج|Markdown.pl}} والتي تحول النص المدخل المرمز إلى نص [[لغة توصيف النص الفائق|HTML]] أو [[لغة ترميز النص الفائق القابلة للتوسع|XHTML]] صالح. ويمكن استخدامها كبرنامج نصي مستقل أو كبرنامج مساعد {{إنج|plugin}} ل[[بلوزكسوم]] أو [[موفابل تايب]] أو كمرشح نصوص ل BBEdit.
<ref name=md/>

منذ ذلك الحين أصبح يمكن استخدامها من قبل الآخرين بوصفها [[برمجة تركيبية|كتلة برمجية]] من بيرل متوفرة في [[أرشيف شبكة بيرل الشامل]]، واستخدمت أيضاُ في مجموعة [[لغة برمجة|لغات برمجة]] متنوعة. يتم توزيعه تحت [[رخص بي إس دي]] <ref>[https://daringfireball.net/projects/markdown/license Daring Fireball: Markdown: License] {{Webarchive|url=https://web.archive.org/web/20180107012702/https://daringfireball.net/projects/markdown/license |date=07 يناير 2018}}</ref> ويمكن أن يُتضمن أو يكون متاحاً كبرنامج مساعد للعديد من [[نظام إدارة المحتوى|أنظمة إدارة المحتوى]].
<ref>{{استشهاد ويب
| عنوان = MarsEdit 2.3 ties the knot with Tumblr support - Ars Technica
| تاريخ الوصول = 2009-08-11
| مسار = https://arstechnica.com/gadgets/2009/03/marsedit-23-ties-the-knot-with-tumblr-support/
| مسار أرشيف = https://web.archive.org/web/20110910193321/http://arstechnica.com/apple/news/2009/03/marsedit-23-ties-the-knot-with-tumblr-support.ars | تاريخ أرشيف = 10 سبتمبر 2011 }}</ref><ref>{{استشهاد ويب
| عنوان = Review: Practical Django Projects - Ars Technica
| تاريخ الوصول = 2009-08-11
| مسار = https://arstechnica.com/information-technology/2008/07/review-practical-django-projects/
| مسار أرشيف = https://web.archive.org/web/20110607191242/http://arstechnica.com/open-source/news/2008/07/review-practical-django-projects.ars | تاريخ أرشيف = 7 يونيو 2011 }}</ref>

تستخدم هذه اللغة في مواقع مثل [[غيت هاب]]، و[[ريديت]] و[[ستاك أوفرفلو]]، و[[سورس فورج|سورس فورج.نت]] لتسهيل المناقشة بين المستخدمين.
<ref name="gfm_on_github" >{{استشهاد ويب|عنوان=GitHub Flavored Markdown|مسار=https://docs.github.com/en/github/writing-on-github|ناشر=github.com|تاريخ الوصول=29 March 2013| مسار أرشيف = https://web.archive.org/web/20190205015447/https://help.github.com/articles/github-flavored-markdown/ | تاريخ أرشيف = 5 فبراير 2019 }}</ref><ref>{{استشهاد ويب|عنوان=Reddit markdown primer. Or, how do you do all that fancy formatting in your comments, anyway?|مسار=https://www.reddit.com/r/reddit.com/comments/6ewgt/reddit_markdown_primer_or_how_do_you_do_all_that/|ناشر=reddit.com|تاريخ الوصول=29 March 2013| مسار أرشيف = https://web.archive.org/web/20190611185827/https://www.reddit.com/r/reddit.com/comments/6ewgt/reddit_markdown_primer_or_how_do_you_do_all_that/ | تاريخ أرشيف = 11 يونيو 2019 }}</ref><ref>{{استشهاد ويب|عنوان=Markdown help|مسار=http://stackoverflow.com/editing-help|ناشر=http://stackoverflow.com|تاريخ الوصول=29 March 2013| مسار أرشيف = https://web.archive.org/web/20190910072518/https://stackoverflow.com/editing-help | تاريخ أرشيف = 10 سبتمبر 2019 }}</ref><ref>{{استشهاد ويب|عنوان=SourceForge: Markdown Syntax Guide|مسار=http://sourceforge.net/p/forge/documentation/markdown_syntax/|ناشر=sourceforge.net|تاريخ الوصول=2013-05-10| مسار أرشيف = https://web.archive.org/web/20190613130356/https://sourceforge.net/p/forge/documentation/markdown_syntax/ | تاريخ أرشيف = 13 يونيو 2019 }}</ref>

== أمثلة على قواعد اللغة ==
=== عناوين ===
نص العنوان في HTML ينتج عن طريق استبدال عدد الهاشات (#) الموجودة قبل نص العنوان الخاضع لمستوى الترويس المطلوب (HTML توفر ست مستويات لترويسات العناوين)، مثل:
# مستوى الترويس-(عنونة) أول

#### مستوى الترويس-(عنونة) رابع
هذا ما يترجم في لغة HTML إلى:
<syntaxhighlight lang="html4strict">
= مستوى ترويس (عنونة) أول =
==== مستوى ترويس (عنونة) رابع ====
</syntaxhighlight>
اختياريا، الترويسات يمكن أن يتم إغلاقها (ختمها) بهاشات (#) ليس بالضرورة أن يطابق عددها عدد الهاشات الموجودة في بداية الترويسة، وفقط لأسباب تجميلية يمكن أن نكتب:
# مستوى الترويس-(عنونة) الأول #

#### مستوى الترويس-(عنونة) الرابع ####

## مستوى الترويس-(عنونة) الثاني ##
مستويا العنونة الأول والثاني يمكن أن يستخدما قاعدة لغوية أخرى للتعبير عنهما:
مستوى الترويس-(عنونة) الأول
===================

مستوى الترويس-(عنونة) الثاني
--------------------

=== الفقرات ===
الفقرة: هي سطر واحد أو أكثر من النص يفصل بينها سطر فارغ أو أكثر.لا ينبغي أن تبدأ الفقرات العادية بمسافة بادئة أو بعلامات تبويب.

هذه فقرة. وهي مكونة من جملتين.
هذه فقرة أخرى. وتتكون من جملتين أيضاً.

يترجم المثال أعلاه إلى:
<syntaxhighlight lang="html4strict">
 هذا الفقرة. فقد اثنين من الجمل. 
 هذا فقرة أخرى. كما أن لديها جملتين. 
</syntaxhighlight>

=== فواصل الأسطر ===
لإدراج فاصل أسطر، قم بإنهاء السطر بمسافتين فارغتين أو أكثر متبوعة بزر الإدخال (Enter) كمثال:
def␣show_results␣␣
end
و هذا ما يترجم في لغة HTML إلى:
<syntaxhighlight lang="html4strict">
def show_results end
</syntaxhighlight>

=== القوائم ===
هناك نوعين من تصنيف القوائم: قوائم مرتبة وقوائم غير مرتبة كما في لغة html.

يتم إنشاء قائمة غير مرتبة عن طريق وضع عدد من المسافات البادئة و «الرموز النقطية» أمام عنصر القائمة. «الرموز النقطية» تشمل " * "، " + "،" - "

*عنصر في قائمة غير مرتبة.
+بند ويضمن 4 مسافات بادئة.
*عنصر آخر في قائمة غير مرتبة.
*أيضاً عنصر آخر.

وهذا يترجم إلى:
<syntaxhighlight lang="html4strict">
<ul>
<li> عنصر في قائمة غير مرتبة.
<ul>
<li> بند ويضمن 4 مسافات بادئة.</li>
</ul>
</li>
<li>عنصر آخر في قائمة غير مرتبة.</li>
<li>أيضاً عنصر آخر.</li>
</ul>
</syntaxhighlight>

أما بالنسبة للقوائم المرتبة قد لاتحتاج القوائم أن تكون مرتبة بما يوافق ترتيب العناصر.

1. عنصر في قائمة تعداد.
1. A بند فرعي، بادئة مع 4 مساحات.
2. بند آخر في قائمة تعداد.
3. بند آخر.
4. بند آخر.

وهذا يترجم بلغة html إلى:
<syntaxhighlight lang="html4strict">
<ol>
<li>عنصر في قائمة تعداد.
<ol>
<li> بند فرعي، بادئة مع 4 مساحات.</li>
</ol>
</li>
<li> بند آخر في قائمة تعداد.</li>
<li>بند آخر.</li>
<li>بند آخر.</li>
</ol>
</syntaxhighlight>

إذا وضعت أسطر فارغة بين العناصر، وستُحلل على أنها فقرات. يمكن إنشاء قائمة عناصر لائحة متعددة الفقرات من خلال المسافات البادئة بنسبة 4 مسافات{{إنج|spaces}} أو علامة التبويب {{إنج|tabs}}. على سبيل المثال:

* عنصر قائمة.
مع فقرات متعددة.
* عنصر آخر.

يترجم إلى لغة html كالتالي:

<syntaxhighlight lang="html4strict">
<ul>
<li>عنصر قائمةمع فقرات متعددة</li>
<li>عنصر آخر</li>
</ul>
</syntaxhighlight>

=== نص مؤكد ===
النص المؤكد يمكن أن يكون بنى جمل متعددة، إما ترفق مع العلامات النجمية أو تبرز. مرفق مع علامة نجمية واحدة أو تسطير يمثل المائل.
* التركيز (مائل) * أو توكيد (مائل) _وهذا يترجم إلى:<syntaxhighlight lang="html4strict">
 التركيز (المائل) أو التركيز (المائل) 
</syntaxhighlight>
أرفق مع اثنين من العلامات النجمية أو يبرز ويمثل بحروف بارزة.
** تركيز قوي (بحروف بارزة) ** أو __ تركيز قوي (بحروف بارزة) __

=== النص البرمجي (الشيفرة) ===
لإدراج نص برمجي (منسق بخط ثابت العرض)، بإمكانك إما أن تحيط الكود المضمن بإشارات اقتباس خلفية (`) أو أن تبدأ السطور العديدة من الكود على الأقل مع أربع مسافات بادئة
علامات الاقتباس الخلفية يمكن أن تستخدم في الجملة لتمثيل الكود:
نص ما مع ` شيفرة برمجية ما ` بداخله
هذا ما يترجم في لغة HTML إلى:
<syntaxhighlight lang="html4strict">
نص ما مع <code>شيفرة برمجية ما </code> بداخله
</syntaxhighlight>
الشيفرات البرمجية التي تتوضع على عدة أسطر أو القطع الأطول من الكود يجب أن تسبق بأربع مسافات بادئة كما المثال:
سطر 1 من الكود
سطر 2 من الكود
سطر 3 من الكود
هذا ما يترجم في لغة HTML إلى:
<syntaxhighlight lang="html4strict">
<pre>
<code>
سطر 1 من الكود
سطر 2 من الكود
سطر 3 من الكود
</code>
</pre>
</syntaxhighlight>
الخيار الثاني يجعل ماركداون تحتفظ بالمسافات الفارغة -على عكس السلوك المعتاد للغة الذي يعمل على إزالة فواصل الأسطر والمسافات الزائدة، قد يتم كسر المسافات البادئة وتغيير المظهر الخارجي للكود.

=== الاقتباس ===
يمكن إنشاءاقتباس بإضافة >

> "سيتم إحاطة هذه الفقرة بأكملها من النص في عنصر اقتباس.
عناصر الاقتباس قابلة لإعادة التدفق. تستطيع
إنهاءالنص بالشكل الذي يرضيك تعسفياً، وسوف يكون توزيعه
في عنصر الاقتباس فقرة واحدة ".

ويترجم إلى نص html كالتالي:

<syntaxhighlight lang="html4strict">
<blockquote> "سيتم إحاطة هذه الفقرة بأكملها من النص في عنصر اقتباس.
عناصر الاقتباس قابلة لإعادة التدفق. تستطيع
إنهاءالنص بالشكل الذي يرضيك تعسفياً، وسوف يكون توزيعه
في عنصر الاقتباس فقرة واحدة ".</blockquote>
</syntaxhighlight>

=== صور ===
للصور تركيب مشابه ليربط مع علامة التعجب السابقة.

![النص البديل](/path/to/img.jpg)

هذا يترجم إلى لغة html كالتالي:

<syntaxhighlight lang="html4strict">
<img src="/path/to/img.jpg" alt="النص البديل" />
</syntaxhighlight>

يمكن إضافة العنوان بشكل اختياري إلى نهاية عنوان الرابط بين علامتي اقتباس كما هو موضح:

![النص البديل](/path/to/img.jpg «العنوان الاختياري»)

يترجم إلى لغة html كالتالي:

<syntaxhighlight lang="html4strict">
<img src="/path/to/img.jpg" alt="النص البديل" title="العنوان الاخيتاري" />
</syntaxhighlight>

يمكن إضافة حاشية للصور مثل الروابط:

![Alt text][id]

كما يجب الإشارة إلى أنه يجب تحديد url لاحقاً في المستند.
<syntaxhighlight lang="html4strict">
[id]: url/to/image "العنوان الاختياري"
</syntaxhighlight>

=== مسطرة أفقية ===
يتم إنشاء مسطرة أفقية (خط أفقي فاصل) بكتابة ثلاثة أو أكثر من الشرطات أو الشرطات السفلية أو النجوم. ويمكن إضافة مسافات بينها. كل من الأسطر التالية سوف ينتج مسطرة أفقية:
<code><pre>***
***
*****
---
---------------------------------------</pre></code>
جميعا تُترجم في HTML إلى <code dir="ltr"><hr /></code>.

== المحررات ==
بالرغم من أن ماركداون هي لغة ترميز تتعلق بالحد الأدنى من الموارد وسهلة القراءة والتحرير بواسطة محرر نصوص عادي إلا أنه يوجد محررات مصممة خصيصاً تتيح معاينة الملفات مباشرة مع كافة التنسيقات، يوجد عدد من هذه المحررات متوافرة لكل من المنصات الأكثر انتشاراً. كما ويوجد إضافة تقوم بتلوين [[كلمة مفتاحية|الكلمات المحجوزة]] من اللغة مدمجة مع كل من المحررات emacs , gedit و vim

== تطبيقها ==
تطبق المارك داون في كثير من الأطر المختلفة، والمنصات واللغات.
* مولد التوثيق المصدري [[دي أكسجين]] يدعم المارك داون مع ميزات اضافية.<ref>[http://www.stack.nl/~dimitri/doxygen/manual/markdown.html Doxygen Manual: Markdown support] {{Webarchive|url=https://web.archive.org/web/20170718092919/http://www.stack.nl/~dimitri/doxygen/manual/markdown.html |date=18 يوليو 2017}}</ref> * *آرستدويو{{إنج|Rstdio}} هي [[بيئة تطوير متكاملة]] من [[R (لغة البرمجة)|R]] يوفر ميزة تغليف التوابع بال[[سي++]] لتنفيذ الماركدوان ببرمجيات سنداون.<ref>[https://github.com/rstudio/rstudio/blob/master/src/cpp/core/markdown/Markdown.cpp rstudio/Markdown.cpp at master · rstudio/rstudio · GitHub] {{Webarchive|url=https://web.archive.org/web/20170726011514/https://github.com/rstudio/rstudio/blob/master/src/cpp/core/markdown/Markdown.cpp |date=26 يوليو 2017}}</ref>
* [[إنتيليج إيديا]]، هي [[بيئة تطوير متكاملة]] [[جافا (لغة برمجة)|للجافا]]، وتدعم الماركداون كبرنامج مساعد.
<ref>[https://plugins.jetbrains.com/plugin/5970 JetBrains Plugin Repository :: Markdown] {{webarchive|url=https://web.archive.org/web/20150503171825/http://plugins.jetbrains.com/plugin/5970 |date=3 مايو 2015 }} {{استشهاد ويب |مسار=http://plugins.jetbrains.com/plugin?id=5970 |عنوان=نسخة مؤرشفة |تاريخ الوصول=13 سبتمبر 2013 |تاريخ أرشيف=3 مارس 2016 |مسار أرشيف=https://web.archive.org/web/20160303230628/http://plugins.jetbrains.com/plugin?id=5970 |حالة المسار=dead }}</ref><ref>[https://github.com/nicoulaj/idea-markdown nicoulaj/idea-markdown · GitHub] {{Webarchive|url=https://web.archive.org/web/20130910015609/https://github.com/nicoulaj/idea-markdown |date=10 سبتمبر 2013}}</ref>
* [[ملتيماركداون]] صيغة وبرنامج يمتلك مميزات أكثر في قواعد اللغة وخيارات التصدير من المارك داون التقليدية
* «الغيتهاب يفضل المارك داون»(GFM) ولها العديد من التطبيقات.<ref>
Joe Esposito.
[https://github.com/joeyespo/grip "Grip -- Github Readme Instant Preview"].
GitHub-Flavored Markdown in the Python language. {{Webarchive|url=https://web.archive.org/web/20180510215352/https://github.com/joeyespo/grip |date=10 مايو 2018}}</ref><ref>
Jeff Tratner.
[https://github.com/jtratner/vim-flavored-markdown "Vim-Flavored-Markdown"]:
Github Flavored Markdown in the [[فيم سكريبت]]ing language. {{Webarchive|url=https://web.archive.org/web/20150803023010/https://github.com/jtratner/vim-flavored-markdown |date=03 أغسطس 2015}}</ref><ref>
Evan Solomon.
[https://wordpress.org/plugins/github-flavored-markdown-comments/ "GitHub-Flavored Markdown Comments"]:
Github Flavored Markdown in the PHP language as a WordPress plugin. {{Webarchive|url=https://web.archive.org/web/20170307073239/https://wordpress.org/plugins/github-flavored-markdown-comments/ |date=07 مارس 2017}}</ref><ref>Gabriel Llamas.
[https://github.com/gagle/Node-GFM "Node-GFM"]:
GitHub flavored markdown in the JavaScript language. {{استشهاد ويب |مسار=https://github.com/Gagle/Node-GFM |عنوان=نسخة مؤرشفة |تاريخ الوصول=31 يناير 2018 |تاريخ أرشيف=14 يونيو 2016 |مسار أرشيف=https://web.archive.org/web/20160614002639/https://github.com/Gagle/Node-GFM |حالة المسار=bot: unknown }}</ref> ويضيف GFM [[تعليم الصيغة]] و[[نظريات الوقت|قائمة المهام]] إلى الماركدوان القياسية.<ref name="gfm_on_github" />

وهناك الكثير من التطبيقات [[مصدر مفتوح|المفتوحة المصدر]] المتوفرة على شبكة الإنترنت.

== توحيد المعايير ==
ليس هناك معايير محددة للماركداون بوضوح، عدا عن writeup الأصلي المنفذ من قبل جون غروبر. في أواخر عام 2012، بدأ جهد لتوحيد المعايير القياسية، كان السبب غالباً تدوينة من مدونة [[جيف أتوود]].<ref>[https://blog.codinghorror.com/the-future-of-markdown/ The Future of Markdown] {{Webarchive|url=https://web.archive.org/web/20140211233513/http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html |date=11 فبراير 2014}}</ref> يسعى مجتمع الإنترنت الآن إلى "وثيقة متنوعة من الأدوات والموارد المتاحة لمؤلفي المستندات والمطورين، فضلاً عن المنفذين لمختلف تطبيقات الماركداون
".<ref>[http://markdown.github.io/ Markdown Community Page] {{Webarchive|url=https://web.archive.org/web/20170321070501/http://markdown.github.io/ |date=21 مارس 2017}}</ref> والآن تتوفر أداة تسمى "Babelmark2" <ref>[https://johnmacfarlane.net/babelmark2/ Babelmark 2 - Compare markdown implementations] {{Webarchive|url=https://web.archive.org/web/20170718113552/http://johnmacfarlane.net/babelmark2/ |date=18 يوليو 2017}}</ref>)
لمقارنة خرج التطبيقات المختلفة«و» تشجيع المناقشة لتوضيح بعض الجوانب الغامضة من مواصفات المارك داون.<ref>[https://johnmacfarlane.net/babelmark2/faq.html Babelmark 2 - FAQ] {{Webarchive|url=https://web.archive.org/web/20170728115918/http://johnmacfarlane.net/babelmark2/faq.html |date=28 يوليو 2017}}</ref>

== انظر أيضا ==
* [[جون غروبر]]
* [[آرون سوارتز]]

== مراجع ==
{{مراجع}}

== روابط خارجية ==

* [http://daringfireball.net/projects/markdown/ المشروع الرسمي للماركداون على مدونة دارينغ فاير بول]
* [http://markdown.github.io/ صفحة مجتمع المارك داون]
{{روابط شقيقة}}
{{ضبط استنادي}}
{{شريط بوابات|تقنية المعلومات|برمجيات|عقد 2000|علم الحاسوب|تقانة}}

[[تصنيف:تنسيقات مفتوحة]]
[[تصنيف:استحداثات متعلقة بالحواسيب في 2004]]
[[تصنيف:تدوين الملاحظات]]
[[تصنيف:لغات الترميز خفيفة الوزن]]
[[تصنيف:لغات حاسوب]]

ماركداون - تاريخ المراجعة

عبد العزيز: بوت: إصلاح التحويلات