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

CLI المحتوى

أداة واجهة سطر الأوامر الخاصة بـ Contentful. استخدم ميزات المحتوى مباشرةً من واجهة سطر الأوامر (CLI) الخاصة بك.

يوفر Contentful بنية أساسية للمحتوى للفرق الرقمية لتشغيل المحتوى في مواقع الويب والتطبيقات والأجهزة. على عكس نظام إدارة المحتوى (CMS)، تم تصميم Contentful للتكامل مع مجموعة البرامج الحديثة. إنه يوفر مركزًا مركزيًا للمحتوى المنظم، وواجهات برمجة التطبيقات القوية للإدارة والتسليم، وتطبيق ويب قابل للتخصيص يمكّن المطورين ومنشئي المحتوى من شحن المنتجات الرقمية بشكل أسرع.

سمات

  • ابدأ مع Contentful باستخدام الأمر init .
  • إدارة المساحات - القائمة، الإنشاء، الحذف،...
  • قم بتصدير المساحة الخاصة بك إلى ملف JSON.
  • قم باستيراد المساحة الخاصة بك من ملف JSON.
  • تنفيذ البرامج النصية للترحيل المكتوبة في Contentful Migration DSL
  • قم بإنشاء برامج نصية للترحيل لـ Contentful Migration DSL من المساحات الموجودة.
  • قم بتزويد مساحتك ببيانات نموذجية.
  • إدارة تثبيت الملحقات في الفضاء.
  • قم بتسجيل الدخول والخروج بشكل آمن باستخدام خدمة OAuth الخاصة بنا.
  • ابحث عن جميع الأوامر المتاحة في قسم المستندات.

☁️ التثبيت

تأكد من تثبيت Node LTS

ثم باستخدام npm أو الغزل: 

npm install -g contentful-cli
# Or
yarn global add contentful-cli

يرجى ملاحظة أنه بالنسبة للإصدارات غير المستقلة، فأنت بحاجة إلى Node LTS لاستخدام واجهة سطر الأوامر (CLI).

الاستخدام

استخدم المعلمة --help لعرض قسم المساعدة لأداة CLI أو دمجها مع أمر محدد للحصول على قسم المساعدة لهذا الأمر. 

contentful --help
# Or
contentful space --help

التوثيق

يمكن العثور على وثائق أكثر تفصيلاً لكل أمر في قسم المستندات.

استخدام أداة CLI مع الوكيل

يمكنك حفظ تكوين الوكيل في .contentfulrc.json الخاص بك عبر: 

contentful config add --proxy user:auth@host:port

نحن أيضًا نحترم متغيرات البيئة http(s)_proxy : 

https_proxy=user:auth@host:port contentful

عند وجود تكوينات وكيل متعددة، يتم أخذ الأسبقية بهذا النموذج:

  1. http_proxy له الأسبقية على .contentfulrc.json
  2. https_proxy له الأسبقية على .contentfulrc.json
  3. https_proxy له الأسبقية على http_proxy

تكوين CLI لاستخدام الاتحاد الأوروبي

يمكنك تجاوز تكوين المضيف في .contentfulrc.json الخاص بك عبر: 

contentful config add --host api.eu.contentful.com

ثم سيستخدم أي أمر لاحق مضيف الاتحاد الأوروبي. على سبيل المثال، سيؤدي contentful login إلى تسجيل دخولك إلى مثيل المحتوى الخاص بالاتحاد الأوروبي.

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

  • غير قادر على الاتصال بـ Contentful من خلال الوكيل الخاص بك؟ جرب إعدادات rawProxy: true في .contentfulrc.json الخاص بك عبر: 
contentful config add --raw-proxy

تطوير

  1. تثبيت التبعيات 
    npm i
  2. لتجنب تصادم إصدار التطوير مع Contentful CLI المثبت بالفعل، قم بتغيير اسم الأمر في package.json 
      "bin": {
-     "contentful": "bin/contentful.js"
+     "ctfl": "bin/contentful.js"
  }
  3. ربط النسخة المحلية الخاصة بك، والقرصنة سعيدة؟ 
    npm link

؟ اختبار

اختبارات التكامل

لتشغيل اختبارات التكامل محليًا، ستحتاج إلى ما يلي:

  1. قم بتعيين متغيرات البيئة في .jest/env.js (يمكن العثور عليها في 1Password) 
     process . env . CONTENTFUL_INTEGRATION_TEST_CMA_TOKEN = '<cma_auth_token>'
process . env . CLI_E2E_ORG_ID = '<organization_id>'
  2. قم بتشغيل وكيل talkback لتسجيل وتشغيل طلبات http 
    npm run talkback-proxy
  3. في غلاف طرفي آخر، قم بإجراء الاختبارات المفضلة لديك 
     # # Run all integration tests
npm run test:jest
# # Or run specific tests
npx jest test/integration/cmds/space/ * --watch

اختبارات الوحدة

ببساطة قم بتشغيل: 

 # Run all unit tests
npm run test:unit:watch
# Or run specific tests
npx jest test/unit/cmds/ * --watch

راجع وثائق jest لمزيد من التفاصيل حول تشغيل الاختبارات والعلامات الاختيارية.

تحديث اللقطات

قد تحتاج إلى تحديث اللقطات ويكون الأمر صعبًا مع التسجيلات.

نصيحة: قم بإجراء الاختبارات بدون تسجيلات لتحديث اللقطات. 

 npx jest test/integration/cmds/<path to the affected test file> --updateSnapshot

❓ الدعم

إذا كانت لديك مشكلة مع هذه الأداة، يرجى تقديم مشكلة هنا على Github.

إذا كانت لديك مشاكل أخرى مع Contentful لا تتعلق بهذه المكتبة، فيمكنك الاتصال بدعم العملاء.

✍️ المساهمة

انظر CONTRIBUTING.md

رخصة

معهد ماساتشوستس للتكنولوجيا

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