الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

mdcat

cat فاخرة لـ Markdown (أي CommonMark): 

 $ mdcat sample.md

عرض mdcat بمواضيع ألوان مختلفة

mdcat في WezTerm، مع "One Light (base16)" و"Gruvbox Light" و"Darcula (base16)" (من اليسار إلى اليمين)، وJetBrains Mono كخط.

سمات

يعمل mdcat بشكل أفضل مع iTerm2 وWezTerm وkitty، كما أنه يتميز بخط طرفي جيد بأحرف مائلة. ثم ذلك

  • يعرض بشكل جيد كافة قواعد CommonMark الأساسية،
  • يسلط الضوء على كتل التعليمات البرمجية مع Syntect،
  • يعرض الروابط، وكذلك الصور المضمنة في المحطات المدعومة (انظر أعلاه، حيث يكون "Rust" رابطًا قابلاً للنقر عليه!)
  • يضيف علامات الانتقال للعناوين في iTerm2 (اقفز للأمام والخلف باستخدام ⇧⌘↓ و⇧⌘↑).
صالة بناء الجملة الأساسي تسليط الضوء على بناء الجملة الصور علامات القفز
ANSI الأساسي¹ ✓ ✓
وحدة تحكم ويندوز 10 ✓ ✓
مصطلحات ✓ ✓ ✓
iTerm2 ✓ ✓ ✓³ ✓
كيتي ✓ ✓ ✓³
WezTerm ✓ ✓ ✓³
VSCode ✓ ✓ ✓³
شبحي ✓ ✓ ✓³
  1. يتطلب mdcat أن يدعم الجهاز التنسيق الذي يتوسطه خط والروابط المضمنة. لن يعرض نصًا يتوسطه خط وروابط بشكل صحيح على المحطات الطرفية التي لا تدعمها (على سبيل المثال، وحدة التحكم النصية في Linux)
  2. VTE هي مكتبة محاكاة طرفية لـ Gnome تستخدمها العديد من المحاكيات الطرفية الشائعة على Linux، بما في ذلك Gnome Terminal وXfce Terminal وTilix وما إلى ذلك.
  3. يتم عرض صور SVG باستخدام resvg، راجع دعم SVG.

غير معتمد:

  • ملحق CommonMark للحواشي السفلية.
  • العلامات المضمنة والتفاف النص في خلايا الجدول.

الاستخدام

جرب mdcat --help أو اقرأ صفحة الدليل mdcat(1).

تثبيت

  • إصدار الثنائيات المبنية على Github Actions.
  • حزم الطرف الثالث في Repology
  • يمكنك أيضًا إنشاء mdcat يدويًا باستخدام cargo install mdcat (انظر أدناه للحصول على التفاصيل).

يمكن ربط mdcat أو نسخه إلى mdless ؛ إذا تم استدعاؤه كـ mdless فإنه يستخدم ترقيم الصفحات تلقائيًا.

مبنى

قم بتشغيل cargo build --release . ترتبط روابط mdcat القابلة للتنفيذ الناتجة بمكتبة SSL الخاصة بالنظام، أي opensl على Linux.

لإنشاء cargo build --features=static ؛ يستخدم الملف القابل للتنفيذ الناتج تطبيق Rust SSL خالصًا. ومع ذلك، فإنه لا يزال يستخدم جذور CA للنظام.

التعبئة والتغليف

عند تعبئة mdcat قد ترغب في تضمين العناصر الإضافية التالية:

  • رابط رمزي أو رابط ثابت من mdless إلى mdcat (انظر أعلاه).

  • إكمالات الصدفة للأصداف ذات الصلة، عن طريق استدعاء mdcat --completions بعد البناء، على سبيل المثال 

    $ mdcat --completions fish > /usr/share/fish/vendor_completions.d/mdcat.fish
$ mdcat --completions bash > /usr/share/bash-completion/completions/mdcat
$ mdcat --completions zsh > /usr/share/zsh/site-functions/_mdcat
# Same for mdless if you include it
$ mdless --completions fish > /usr/share/fish/vendor_completions.d/mdless.fish
$ mdless --completions bash > /usr/share/bash-completion/completions/mdless
$ mdless --completions zsh > /usr/share/zsh/site-functions/_mdless

  • إنشاء صفحة الدليل mdcat.1.adoc باستخدام AsciiDoctor: 

    $ asciidoctor -b manpage -a reproducible -o /usr/share/man/man1/mdcat.1 mdcat.1.adoc
$ gzip /usr/share/man/man1/mdcat.1
# If you include a mdless as above, you may also want to support man mdless
$ ln -s mdcat.1.gz /usr/share/man/man1/mdless.1.gz

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

يمكن لـ mdcat إخراج معلومات تتبع واسعة النطاق عندما يُطلب منك ذلك. قم بتشغيل mdcat باستخدام $MDCAT_LOG=trace للحصول على معلومات التتبع الكاملة، أو باستخدام $MDCAT_LOG=mdcat::render=trace لتتبع العرض فقط.

رخصة

حقوق الطبع والنشر لسيباستيان ويزنر [email protected]

تخضع الثنائيات لشروط ترخيص Mozilla العام، الإصدار 2.0، راجع الترخيص.

يخضع معظم المصدر لشروط ترخيص Mozilla العام، الإصدار 2.0، راجع الترخيص، ما لم يُذكر خلاف ذلك؛ تخضع بعض الملفات لشروط ترخيص Apache 2.0، راجع http://www.apache.org/licenses/LICENSE-2.0

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل