content collections

مجموعات المحتوى

تحويل المحتوى الخاص بك إلى مجموعات البيانات الآمنة من النوع. التخلص من الحاجة إلى جلب البيانات اليدوية والتحليل. ما عليك سوى استيراد المحتوى الخاص بك وابدأ. يضمن التحقق المدمج دقة بياناتك. المعالجة المسبقة لبياناتك قبل دخول تطبيقك.

سمات

• جميلة DX : تم تصميم مجموعات المحتوى لتوفير تجربة مستخدم ممتعة. إنه يوفر تجربة مطور سلسة دون الحاجة إلى إعادة تشغيل الخادم أو تحديث المتصفح. يتم تحديث مجموعات المحتوى تلقائيًا عند إجراء تغييرات على المحتوى الخاص بك.

• النوع الآمن : يتم تحليل المحتوى الخاص بك والتحقق منه أثناء عملية الإنشاء ، مما يضمن الدقة والعملة. تقدم مجموعات المحتوى واجهة برمجة تطبيقات آمنة للوصول إلى المحتوى الخاص بك.

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

• التحويل : تتيح لك مجموعات المحتوى تحويل المحتوى الخاص بك قبل إدخال تطبيقك. يمكنك استخدامه لتعديل المحتوى الخاص بك أو الانضمام إلى مجموعتين أو حتى جلب البيانات من خادم.

تثبيت

تقدم مجموعات المحتوى مجموعة متنوعة من المحولات التي تتكامل بسلاسة مع أطر الويب الشهيرة. تعتمد عملية التثبيت على المحول المختار:

• Next.js
• Qwik
• ريمكس (Vite)
• بداية صلبة
• Sveltekit
• فيت

إذا لم يتم سرد إطار العمل الخاص بك ، فلا يزال بإمكانك استخدام مجموعات المحتوى باستخدام CLI. يرجى فتح تذكرة إذا كنت تريد رؤية إطار عملك مدرجًا.

الاستخدام

1. قم بإنشاء ملف محتوى محتوى.

    import { defineCollection , defineConfig } from "@content-collections/core" ;
   
   const posts = defineCollection ( {
     name : "posts" ,
     directory : "src/posts" ,
     include : "**/*.md" ,
     schema : ( z ) => ( {
       title : z . string ( ) ,
       summary : z . string ( ) ,
     } ) ,
   } ) ;
   
   export default defineConfig ( {
     collections : [ posts ] ,
   } ) ;

2. ابدأ في كتابة المحتوى في src/posts :

    ---
   title : Hello World
   summary : This is my first post
   ---
   
   # Hello World
   
   This is my first post.

3. استخدم المحتوى الخاص بك في تطبيقك:

    import { allPosts } from "content-collections" ;
   
   export function Posts ( ) {
     return (
       < ul >
         { allPosts . map ( ( post ) => (
           < li key = { post . _meta . path } >
             < a href = { `/posts/ ${ post . _meta . path } ` } >
               < h3 > { post . title } </ h3 >
               < p > { post . summary } </ p >
             </ a >
           </ li >
         ) ) }
       </ ul >
     ) ;
   }

   يرجى ملاحظة أن المثال أعلاه يوضح فقط أساسيات مجموعات المحتوى ولا يغطي تحويل المحتوى. لا تقوم مجموعات المحتوى بتحويل المحتوى مثل Markdown أو MDX بشكل افتراضي. ولكن لديها حزم يمكن أن تفعل ذلك من أجلك:

   • @Content-Collections/Markdown
   • @Content-Collections/MDX

   إذا كنت ترغب في رؤية المزيد من الأمثلة واستخدام الحالات ، فيرجى الرجوع إلى الوثائق.

الرعاة

كن راعيا

رخصة

مجموعات المحتوى مرخصة بموجب ترخيص معهد ماساتشوستس للتكنولوجيا.