markdown here

تخفيض السعر هنا

قم بزيارة الموقع.
احصل عليه لمتصفح Chrome.
احصل عليه لمتصفح فايرفوكس.
احصل عليه لسفاري.
احصل عليه من أجل ثندربيرد.
احصل عليه للأوبرا.
ناقشها واطرح الأسئلة في مناقشات GitHub.

Markdown Here هو امتداد لـ Google Chrome وFirefox وSafari وOpera وThunderbird يتيح لك كتابة البريد الإلكتروني ^† في Markdown ^‡ وعرضه قبل الإرسال. كما أنه يدعم تمييز بناء الجملة (فقط حدد اللغة في كتلة التعليمات البرمجية المسيجة).

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

لاكتشاف ما يمكن فعله باستخدام Markdown في Markdown Here ، راجع ورقة الغش الخاصة بـ Markdown Here وصفحات wiki الأخرى.

^{†: ومنشورات مجموعات Google ومنشورات Blogger وملاحظات Evernote ومنشورات Wordpress! شاهد المزيد.
‡: وصيغ TeX الرياضية!}

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

تعليمات التثبيت
تعليمات الاستخدام
استكشاف الأخطاء وإصلاحها
التوافق
ملاحظات ومتنوعة
بناء حزم التمديد
الخطوات التالية، الاعتمادات، ردود الفعل، الترخيص

تعليمات التثبيت

الكروم

سوق كروم الإلكتروني

انتقل إلى صفحة Chrome Web Store لـ Markdown Here وقم بالتثبيت بشكل طبيعي.

بعد التثبيت، تأكد من إعادة تحميل بريد الويب الخاص بك أو إعادة تشغيل Chrome!

دليل / التطوير

1. استنساخ هذا الريبو.
2. في Chrome، افتح إعدادات الإضافات. (زر مفتاح الربط، الأدوات، الإضافات.)
3. في صفحة إعدادات الإضافات، انقر فوق مربع الاختيار "وضع المطور".
4. انقر فوق الزر "تحميل الإضافة غير المعبأة..." المرئي الآن. انتقل إلى الدليل الذي قمت باستنساخ الريبو فيه، ثم دليل src الموجود أسفله.
5. يجب أن يكون ملحق Markdown Here مرئيًا الآن في قائمة الإضافات الخاصة بك.
6. قم بإعادة تحميل صفحة بريد الويب الخاصة بك (وربما التطبيق) قبل محاولة تحويل البريد الإلكتروني.

فايرفوكس وثندربيرد

موقع إضافات موزيلا

انتقل إلى صفحة Firefox Add-ons لـ Markdown Here وقم بالتثبيت بشكل طبيعي.

أو انتقل إلى قائمة "الأدوات > الوظائف الإضافية" ثم ابحث عن "Markdown Here".

بعد التثبيت، تأكد من إعادة تشغيل Firefox/Thunderbird!

ملاحظة: يستغرق الأمر ما يصل إلى شهر حتى توافق Mozilla على التغييرات التي تم إجراؤها على ملحق Firefox/Thunderbird، لذا ستتأخر التحديثات (الميزات والإصلاحات) عما هو موضح هنا. يمكنك اختيار تثبيت الإصدار الأحدث يدويًا قبل مراجعته من قائمة الإصدارات: https://addons.mozilla.org/en-US/firefox/addon/markdown-here/versions/

دليل / التطوير

1. استنساخ هذا الريبو.
2. اتبع الإرشادات الواردة في مقالة MDN "Your WebExtension الأول".

سفاري

قم بتنزيل الامتداد مباشرة. عند الانتهاء من التنزيل، انقر نقرًا مزدوجًا فوقه للتثبيت.

التفضيلات

للوصول إلى تفضيلات Markdown Here، افتح تفضيلات Safari ثم انتقل إلى علامة التبويب "الإضافات". ثم انقر فوق المربع "انقر فوقي لإظهار خيارات Markdown Here".

الأوبرا

لاحظ أن Markdown Here يعمل فقط مع إصدارات Opera 16 والإصدارات الأحدث (أي تلك التي تعتمد على Chromium).

انتقل إلى صفحة متجر Opera Add-ons لـ Markdown Here وقم بالتثبيت بشكل طبيعي.

بعد التثبيت، تأكد من إعادة تحميل بريد الويب الخاص بك أو إعادة تشغيل Chrome!

تعليمات الاستخدام

قم بتثبيته ثم…

1. في Chrome/Safari/Opera، تأكد من إعادة تحميل صفحة بريد الويب الخاصة بك قبل محاولة استخدام Markdown Here.

2. في Chrome/Firefox/Safari/Opera، قم بتسجيل الدخول إلى حساب Gmail أو Hotmail أو Yahoo وابدأ بريدًا إلكترونيًا جديدًا. في Thunderbird، ابدأ رسالة جديدة.

3. تأكد من أنك تستخدم المحرر الغني.

   • في Gmail، انقر على رابط "التنسيق الغني" إذا كان مرئيًا.
   • في Thunderbird، تأكد من تمكين "إنشاء الرسائل بتنسيق HTML" في جزء "إعدادات الحساب" و"التركيب والعنونة".

4. إنشاء بريد إلكتروني في Markdown. على سبيل المثال:

    **مرحبا** ``العالم``.
   
   ```جافا سكريبت
   تنبيه ('مرحبا تسليط الضوء على بناء الجملة.')؛
   ```
   

5. انقر بزر الماوس الأيمن في مربع الإنشاء واختر عنصر "Markdown Toggle" من قائمة السياق. أو انقر فوق الزر الذي يظهر في شريط العناوين الخاص بك. أو استخدم مفتاح التشغيل السريع ( CTRL + ALT + M بشكل افتراضي).

6. من المفترض أن تشاهد بريدك الإلكتروني يتم عرضه بشكل صحيح من Markdown إلى HTML المنسق.

7. أرسل بريدك الإلكتروني الرائع إلى كل شخص تعرفه. سيظهر لهم بنفس الطريقة التي يبدو بها لك.

العودة إلى تخفيض السعر

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

لاحظ أن أي تغييرات تجريها على HTML الجميل ستفقد عند العودة إلى Markdown.

في Gmail، يمكنك أيضًا استخدام أمر التراجع في المتصفح ( CTRL + Z / CMD + Z ، أو من قائمة "تحرير"). كن حذرًا من أنك قد تفقد أيضًا الأحرف القليلة الأخيرة التي أدخلتها.

الردود

في Gmail وThunderbird ومجموعات Google، يمكنك استخدام "Markdown Toggle" بشكل طبيعي: فقط اكتب ردك (أعلى، أسفل، مضمن، في أي مكان) ثم قم بالتحويل. سيتم ترك رسالة البريد الإلكتروني الأصلية التي ترد عليها كما هي. (من الناحية الفنية: سيتم ترك كتل blockquote الحالية سليمة.)

في Hotmail وYahoo (اللذان لا يضعان النص الأصلي في blockquote )، واختياريًا في Gmail وThunderbird ومجموعات Google، يمكنك التأكد من تحويل جزء الرد الذي كتبته فقط عن طريق تحديد ما تريد تحويله ثم النقر على "تبديل Markdown" - راجع القسم التالي.

الاختيار/التحويل الجزئي

في بعض الأحيان لا ترغب في تحويل البريد الإلكتروني بالكامل؛ في بعض الأحيان، لا يكون بريدك الإلكتروني عبارة عن Markdown بالكامل. لتحويل جزء فقط من البريد الإلكتروني، حدد النص (باستخدام الماوس أو لوحة المفاتيح)، وانقر عليه بزر الماوس الأيمن، ثم انقر فوق عنصر القائمة "Markdown Toggle". يتم تقديم اختيارك بطريقة سحرية إلى HTML جميل.

للعودة مرة أخرى إلى Markdown، ما عليك سوى وضع المؤشر في أي مكان في كتلة النص المحول، والنقر بزر الماوس الأيمن، ثم النقر على عنصر القائمة "Markdown Toggle" مرة أخرى. الآن عادت بطريقة سحرية إلى Markdown الأصلي.

أشياء يجب معرفتها حول تحويل/التراجع عن التحديد

• إذا قمت بتحديد جزء فقط من كتلة النص، فسيتم تحويل هذا النص فقط. سيتم تغليف الكتلة المحولة بعنصر فقرة، وبالتالي سيتم تقسيم السطر الأصلي. ربما لا ترغب في القيام بذلك على الإطلاق.

• يمكنك تحديد وإرجاع عدة كتل محولة في نفس الوقت. إحدى نتائج ذلك هي أنه يمكنك تحديد بريدك الإلكتروني بالكامل، والنقر فوق "Markdown Toggle"، وسيتم إرجاع جميع الأجزاء التي قمت بتحويلها منه.

• إذا لم يكن لديك أي شيء محدد عند النقر فوق "Markdown Toggle"، فسوف يتحقق Markdown Here مما إذا كانت هناك كتل محولة في أي مكان في الرسالة وإعادتها. إذا لم يتم العثور على أي كتل محولة، فسيتم تحويل البريد الإلكتروني بالكامل.

خيارات

يمكن الوصول إلى صفحة خيارات Markdown Here عبر قائمة ملحقات Chrome أو Firefox أو Safari أو Thunderbird. تشمل الخيارات المتاحة ما يلي:

• تعديلات التصميم لـ Markdown المقدمة.
• بناء الجملة تسليط الضوء على اختيار الموضوع وتعديله.
• معالجة صيغ الرياضيات TeX وتمكينها وتخصيصها.
• ما ينبغي أن يكون مفتاح التشغيل السريع.

بالنسبة لمتصفح Chrome وFirefox، تتم مزامنة أي تغييرات يتم إجراؤها في خيارات Markdown Here تلقائيًا بين عمليات التثبيت الأخرى لذلك المتصفح (إذا تم تمكين ميزة المزامنة في المتصفح).

استكشاف الأخطاء وإصلاحها

راجع صفحة Wiki الخاصة باستكشاف الأخطاء وإصلاحها.

التوافق

راجع صفحة Wiki الخاصة بالتوافق.

ملاحظات ومتنوعة

• يستخدم Markdown هنا Github Flavoured Markdown، مع تقييد روابط GFM الخاصة غير المدعومة (الإصدار رقم 11)؛ ولن تكون كذلك، لأن MDH ليس خاصًا بـ Github.

• يمكن رؤية اللغات المتاحة لتسليط الضوء على بناء الجملة (والطريقة التي ينبغي كتابتها بها في كتلة التعليمات البرمجية المسيجة) على الصفحة التوضيحية Highlight.js.

• سيتم الاحتفاظ بالصور المضمنة في Markdown الخاص بك عند "تبديل Markdown". يسمح لك Gmail بوضع الصور في بريدك الإلكتروني - وقد يكون هذا أسهل بكثير من الإشارة إلى صورة خارجية.

• يتم استبعاد توقيعات البريد الإلكتروني تلقائيًا من التحويل. على وجه التحديد، يتم ترك أي شيء بعد العلامة شبه القياسية '-- ' (لاحظ المسافة الزائدة) كما هو.

  • لاحظ أن Hotmail وYahoo لا يضيفان العلامة '-- ' تلقائيًا إلى التوقيعات، لذا يتعين عليك إضافتها بنفسك.

• يظهر عنصر القائمة "Markdown Toggle" لعدد أكبر من أنواع العناصر التي يمكن عرضها بشكل صحيح. يهدف هذا إلى مساعدة الأشخاص على إدراك أنهم لا يستخدمون محررًا غنيًا. وإلا فإنهم لا يرون عنصر القائمة ولا يعرفون السبب.

• التصميم:

  • ينبغي تجنب استخدام الأنماط الخاصة بالمتصفح (-moz-، -webkit-). إذا تم استخدامها، فقد لا يتم عرضها بشكل صحيح للأشخاص الذين يقرؤون البريد الإلكتروني في متصفح مختلف عن المتصفح الذي تم إرسال البريد الإلكتروني إليه.
  • لا يعمل استخدام الأنماط المعتمدة على الحالة (مثل a:hover ) لأنها لا تتطابق في الوقت الذي تصبح فيه الأنماط صريحة. (في البريد الإلكتروني، يجب تطبيق الأنماط بشكل صريح على جميع العناصر - يتم تجريد أوراق الأنماط.)

• لمزيد من الميزات المعدلة، قم بزيارة قسم النصائح والحيل.

بناء حزم التمديد

 cd utils
node build.js

ملحق Chrome وOpera وFirefox (WebExtension).

قم بإنشاء ملف بامتداد .zip يحتوي على هذه الملفات والأدلة:

 manifest.json
common/
chrome/
_locales

امتداد ثندربيرد (XUL).

قم بإنشاء ملف بامتداد .xpi يحتوي على هذه الملفات والدلائل:

 chrome.manifest
install.rdf
common/
firefox/

امتداد سفاري

يوجد الكود الخاص بالمتصفح في مشروع markdown-here-safari .

استخدم منشئ ملحق Safari.

الخطوات التالية

راجع قائمة المشكلات وNotes Wiki. كل الأفكار والأخطاء والخطط والشكاوى والأحلام ستنتهي في أحد هذين المكانين.

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

يتطلب الأمر أيضًا قدرًا لا بأس به من العمل للبقاء على اطلاع بأحدث التغييرات في جميع التطبيقات ومواقع الويب التي يعمل بها Markdown Here.

الاعتمادات

تخفيض السعر هنا تم ترميزه على أكتاف العمالقة.

• تخفيض السعر إلى HTML: chjj/marked
• تسليط الضوء على بناء الجملة: isagalaev/highlight.js
• تحويل HTML إلى نص: mtrimpe/jsHtmlToText

تعليق

نرحب بجميع الأخطاء وطلبات الميزات وطلبات السحب والتعليقات وما إلى ذلك. خلق قضية. أو قم بالنشر في مناقشات GitHub.

رخصة

شفرة

ترخيص معهد ماساتشوستس للتكنولوجيا: https://adampritchard.mit-license.org/ أو راجع ملف LICENSE .

الشعار

حقوق الطبع والنشر 2015، أوستن أندرسون. مرخص لـ Markdown Here بموجب اتفاقية ترخيص المساهم MDH.

صور أخرى

ترخيص Creative Commons Attribution 3.0 Unported (CC BY 3.0).

---