Opens in a new tab

Sharp Markdown: لغة Markdown في Confluence وJira

اكتب صفحات Confluence وتذاكر Jira وعدّلها بلغة Markdown، وتبقى الإشارات والماكروهات والعناصر الأخرى التي لا يستطيع Markdown عرضها محفوظة. هناك تطبيقان، واحد لكل منتج، وهما قادمان إلى Atlassian Marketplace.

اقرأ الوثائق (بالإنجليزية)الدعم (بالإنجليزية)ماكرو Sharp Markdown في صفحة Confluence: قائمة مهام ولوحة تحذير وكود مميَّز ومخطط Mermaid

ما هو Sharp Markdown؟

يجلب Sharp Markdown لغة Markdown إلى Confluence وJira. في Confluence تكتبها في ماكرو داخل الصفحة، ويمكنك أيضًا تعديل الصفحة كاملة بلغة Markdown. وفي Jira تكتب وصف التذكرة والتعليقات بلغة Markdown. ولغة Markdown نص عادي بعلامات بسيطة للتنسيق، مثل **bold** و# Heading.

هناك تطبيقان يستخدمان محرك Markdown نفسه. يضيف Sharp Markdown for Confluence ماكرو Markdown، ويتيح تعديل الصفحات ونسخها وتصديرها واستيرادها بلغة Markdown. ويضيف Sharp Markdown for Jira ثلاثة إجراءات إلى قائمة التذكرة: تعديل الوصف بلغة Markdown، والتعليق بلغة Markdown، ونسخ التذكرة بصيغة Markdown. ثبّت التطبيق الخاص بالمنتج الذي تستخدمه، أو الاثنين معًا.

لا تخرج أي بيانات من Atlassian. يعمل التطبيقان على منصة Forge من Atlassian، وليست لهما اتصالات خارجية، ولا يخزّنان شيئًا خاصًا بهما: يبقى نص Markdown في صفحة Confluence أو تذكرة Jira.

كيف أستخدم Markdown في Confluence وJira؟

يستخدم التطبيقان GitHub Flavored Markdown، وقواعده موضّحة في github.github.com/gfm (بالإنجليزية).

Confluence: ماكرو Markdown

  1. عدّل صفحة، واكتب /Sharp Markdown واختر Sharp Markdown.
  2. اكتب Markdown على اليسار. تتحدّث المعاينة على اليمين أثناء الكتابة. وعلى الشاشة الضيقة، بدّل بين Write وPreview.
  3. يضيف شريط الأدوات العناوين والخط الغامق والمائل والروابط والكود والقوائم وقوائم المهام والجداول ولوحات الملاحظات.
  4. اختر Save وانشر الصفحة. لتغيير نص Markdown لاحقًا، عدّل الصفحة واختر الماكرو ثم زر التعديل (القلم).

Confluence: الصفحات بلغة Markdown

توجد هذه الإجراءات في قائمة ••• الخاصة بالصفحة، تحت Apps.

  • يفتح Edit in Markdown الصفحة كاملة بلغة Markdown مع معاينة. عند الحفظ تُنشأ نسخة جديدة من الصفحة، ويحتفظ سجل الصفحة بالنسخ السابقة.
  • ينسخ Copy as Markdown الصفحة بصيغة Markdown، مثلًا لمحادثة مع أداة ذكاء اصطناعي.
  • ينزّل Export as Markdown الصفحة، أو الصفحة مع صفحاتها الفرعية. تُنزَّل الصفحة الواحدة التي لا صور فيها كملف md، وما عدا ذلك كملف zip.
  • يحوّل Import Markdown ملفات Markdown أو مجلدًا أو ملف zip إلى صفحات تحت الصفحة المفتوحة. وترى شجرة الصفحات والمرفقات والملاحظات قبل إنشاء أي شيء.

Jira

توجد هذه الإجراءات في قائمة ••• الخاصة بالتذكرة.

  • يفتح Edit description in Markdown الوصف بلغة Markdown مع معاينة. وإذا غيّر شخص آخر التذكرة أثناء تعديلك، يتوقف الحفظ.
  • يحفظ Comment in Markdown نص Markdown كتعليق عادي في Jira، مع العناوين والجداول وقوائم المهام والكود. وهو مناسب للإجابات الملصقة من أدوات الذكاء الاصطناعي.
  • ينسخ Copy issue as Markdown الملخص والحقول الرئيسية والوصف والتعليقات، أو ينزّلها كملف md.
  • عندما تلصق ترميز wiki من Jira في المحرر، مثل وصف قديم من سجل التذكرة، يعرض التطبيق تحويله إلى Markdown.

المزايا

ماكرو Markdown مع معاينة مباشرة

اكتب Markdown على اليسار فتتحدّث المعاينة على اليمين. وتظهر في الصفحة الجداول وقوائم المهام والاقتباسات والحواشي، ولوحات الملاحظات بألوان لوحات Confluence، في الوضعين الفاتح والداكن.

كود مميَّز ومخططات Mermaid

تُميَّز كتل الكود بـ 27 لغة، مثل JavaScript وPython وJava وSQL وYAML وBash. وتصبح كتلة الكود التي لغتها mermaid مخططًا.

البحث والتصدير إلى PDF وWord

يجد بحث Confluence نص الماكرو. وفي التصدير إلى PDF وWord يظهر الماكرو كمحتوى عادي للصفحة: عناوين وجداول وقوائم مهام ولوحات وكود. ويُصدَّر مخطط Mermaid ككود.

أي صفحة بلغة Markdown

يفتح Edit in Markdown أي صفحة بلغة Markdown. وتظهر الإشارات والحالات والتواريخ والماكروهات والصور والتخطيطات كعلامات بنفسجية، وتعود دون تغيير عند الحفظ.

لا يضيع شيء عن طريق الخطأ

إذا حذفت علامة، يعرض التطبيق العناصر قبل الحفظ ويطلب التأكيد. وإذا حفظ شخص آخر الصفحة أثناء تعديلك، لا تُحفظ تغييراتك فوق تغييراته.

تصدير شجرات الصفحات واستيرادها

صدّر صفحة مع صفحاتها الفرعية كملف zip يحافظ على الترتيب والصور والروابط بين الصفحات. واستورد ملفات Markdown أو مجلدًا أو ملف zip كشجرة صفحات مع المرفقات والروابط.

نسخ لأدوات الذكاء الاصطناعي

ينسخ Copy as Markdown صفحة Confluence بصيغة Markdown. وفي Jira ينسخ Copy issue as Markdown الملخص والحقول الرئيسية والوصف والتعليقات، أو ينزّلها كملف md.

الأوصاف والتعليقات في Jira

عدّل وصف التذكرة بلغة Markdown مع معاينة مباشرة. والصق إجابة من أداة ذكاء اصطناعي كتعليق، فتُحفظ عناوينها وجداولها وقوائم مهامها وكودها كتعليق عادي في Jira.

تحويل ترميز wiki القديم إلى Markdown

يعرض Jira الأوصاف السابقة في سجل التذكرة بترميز wiki، مثل h2. و{code}. الصقه في المحرر، فيعرض التطبيق تحويله إلى Markdown.

تبقى البيانات في Atlassian

لا اتصالات خارجية ولا تخزين خاص بالتطبيقين. يجري كل شيء في المتصفح بصلاحيات المستخدم نفسه، فلا يعرض التطبيقان ولا يغيّران إلا ما يستطيع هو عرضه وتغييره.

الأسعار

حتى 10 مستخدمين

مجاني في التطبيقين.

100 مستخدم في Confluence

350 دولارًا أمريكيًا سنويًا.

100 مستخدم في Jira

250 دولارًا أمريكيًا سنويًا.

يُفوتَر تطبيق Confluence وتطبيق Jira كلٌّ على حدة، وتتولى Atlassian الفوترة. ستظهر أسعار فئات المستخدمين الأخرى على Atlassian Marketplace بعد نشر التطبيقين. يحصل عملاء الفئة المجانية على الدعم نفسه الذي يحصل عليه العملاء الدافعون.

لقطات الشاشة

Edit in Markdown في Confluence: الصفحة بلغة Markdown على اليسار والمعاينة على اليمين والعناصر المحمية كعلامات بنفسجيةماكرو Sharp Markdown في صفحة Confluence: جدول وقائمة مهام ولوحة تحذير وكود ومخطط MermaidImport Markdown في Confluence: شجرة الصفحات ومرفق والمعاينة قبل إنشاء الصفحاتEdit description in Markdown في Jira: وصف التذكرة بلغة Markdown مع إشارة تظهر كعلامة بنفسجيةComment in Markdown في Jira: جدول وقائمة مهام وكود بلغة Markdown مع المعاينةترميز wiki من سجل تذكرة Jira بعد تحويله إلى Markdown: خطوات وجدول وكود

الأسئلة الشائعة

كم يكلّف Sharp Markdown؟
مجاني حتى 10 مستخدمين. ولـ 100 مستخدم يكلّف تطبيق Confluence مبلغ 350 دولارًا أمريكيًا سنويًا، وتطبيق Jira مبلغ 250 دولارًا أمريكيًا سنويًا. يُفوتَر التطبيقان كلٌّ على حدة، وتتولى Atlassian الفوترة.

هل أحتاج إلى التطبيقين معًا؟
لا. تطبيق Confluence يجلب Markdown إلى صفحات Confluence، وتطبيق Jira يجلبه إلى تذاكر Jira. ثبّت التطبيق الخاص بالمنتج الذي تستخدمه، أو الاثنين معًا.

هل تبقى الإشارات والماكروهات عند تعديل صفحة بلغة Markdown؟
نعم. العناصر التي لا يستطيع Markdown عرضها، مثل الإشارات والحالات والماكروهات والصور والتخطيطات، تظهر كعلامات بنفسجية وتعود دون تغيير عند الحفظ. لا يمكن تعديل جزء من العلامة، وإذا حذفت علامة يطلب التطبيق التأكيد قبل الحفظ.

كيف أصدّر صفحات Confluence كملفات Markdown؟
اختر Apps ثم Export as Markdown من قائمة ••• في الصفحة، ثم Export page and child pages (.zip). في ملف zip تكون كل صفحة ملف md مستقلًا، والصور والملفات في المجلد _attachments، وتصبح الروابط بين الصفحات روابط نسبية. يمكن تصدير حتى 500 صفحة في المرة الواحدة.

كيف أستورد ملفات Markdown إلى Confluence؟
افتح الصفحة التي ستوضع تحتها الصفحات الجديدة، واختر Apps ثم Import Markdown من قائمة •••. اختر ملفات Markdown أو مجلدًا أو ملف zip، مثل مستودع منزَّل من GitHub. ترى شجرة الصفحات والمرفقات والملاحظات قبل إنشاء أي شيء، وتُنشأ الصفحات بحسابك.

هل يعمل Sharp Markdown في بوابة العملاء في Jira Service Management؟
لا. تعمل الإجراءات في عرض التذكرة في Jira، وليس في بوابة العملاء في Jira Service Management ولا في تطبيقات الهاتف.

هل تخرج أي بيانات من Atlassian؟
لا. يعمل التطبيقان على منصة Forge من Atlassian، وليست لهما اتصالات خارجية. ولا يخزّنان شيئًا خاصًا بهما: يبقى نص Markdown في صفحات Confluence وتذاكر Jira. وتُنشأ الملفات المُصدَّرة في المتصفح وتُنزَّل إلى جهازك.

ماذا يحدث إذا لم يكن الترخيص نشطًا؟
يعرض الماكرو نص Markdown كنص عادي، فلا يضيع أي محتوى.

الدعم والشروط

الدعم: support@hdsoft.fi، من الاثنين إلى الجمعة من 9:00 إلى 17:00 بتوقيت فنلندا، بالإنجليزية والفنلندية. أوقات الاستجابة وبلاغات الأمان موجودة في صفحة الدعم (بالإنجليزية).

الوثائق: كيفية إعداد Sharp Markdown واستخدامه (بالإنجليزية).

الخصوصية: سياسة الخصوصية (بالإنجليزية).

الشروط والتطبيقات الأخرى: تطبيقات لـ Jira وConfluence.

قريبًا على Atlassian Marketplace

Sharp Markdown قادم إلى Confluence Cloud وJira Cloud عبر Atlassian Marketplace. توضّح الوثائق من الآن كيف يعمل.

اقرأ الوثائق (بالإنجليزية)

Atlassian وJira وConfluence علامات تجارية لشركة Atlassian. التطبيقات من صنع HD SofT وتدعمها HD SofT.