jonschlinkert/gray-matter
کاربرد:
این ابزار یک پارسر هوشمند برای استخراج و تحلیل فرانت‌متر (Front Matter) در فایل‌های متنی مثل مارک‌داون و اچ‌تی‌ام‌ال هست. فرانت‌متر بخشی از متادیتاست که معمولاً در ابتدای فایل قرار می‌گیره و اطلاعاتی مثل عنوان، تاریخ، تگ‌ها و غیره رو ذخیره می‌کنه.
این کتابخانه به صورت پیش‌فرض YAML رو پارس می‌کنه، اما پشتیبانی از JSON، CoffeeScript، TOML و همچنین پارسرهای سفارشی رو هم داره.
در چه شرایطی بهتره استفاده شود؟
وقتی که داری یک سیستم محتوای استاتیک (مثل Static Site Generator) می‌سازی یا با فایل‌هایی کار می‌کنی که دارای متادیتای ساختاریافته در ابتدایشون هستن، استفاده از این کتابخانه عالیه.
مخصوصاً در پروژه‌هایی مثل Gatsby، Netlify CMS، VitePress، Astro و Slidev که مدیریت محتوای مبتنی بر فرانت‌متر دارن، این ابزار یک قلب مرکزی محسوب می‌شه.
چند مثال از موارد استفاده
استخراج عنوان و تاریخ یک پست وبلاگ از فایل مارک‌داون
خواندن تنظیمات صفحه از JSON Front Matter در یک سایت مستندات
پشتیبانی از TOML برای پروژه‌هایی که از زبان Rust یا Hugo الهام گرفتن
ایجاد یک پارسر سفارشی برای قالب داده‌ای خاص در یک CMS شخصی‌سازی شده
- ##frontmatter
- ##yaml
- ##staticsite
- ##markdown
- ##json
- ##toml
- ##metalsmith
- ##gatsby
- ##vitepress
- ##astro