کتابخانه
@sap-theming/theming-base-content یه بسته npm از SAP SE با مجوز Apache هست که محتوای پایه تم های SAP رو نگه می داره؛ یعنی مقدارهای ظاهری و منابعی که کتابخونه های رابط کاربری SAP برای ظاهر یکدست بهشون تکیه می کنن. بیشتر کنار کامپوننت های SAP و به عنوان وابستگی استفاده می شه، نه به تنهایی.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز Apache-2.0؛ هش هر فایل با منبع بررسی شده است.
۲۳٫۷ مگابایت· ۱۸۰۲ فایل· انتشار
SHA-256: 93be8f3e242b594fce6565a71b7a89ce007f6cfa36cd90d87f4792eaaf447c1a
اگه اسم @sap-theming/theming-base-content رو توی package.json یا پوشه node_modules دیدی و نمی دونی چیه، تنها نیستی. این یه بسته جانبیه که SAP برای سیستم تم سازی خودش ساخته. توضیح رسمی منبع هم فقط می گه Theming Base Content، یعنی محتوای پایه تم ها.
ایده اش ساده است. ظاهر هر رابط کاربری از یه سری مقدار پایه ساخته می شه: رنگ، فاصله، گردی گوشه ها، فونت. SAP این مقدارها رو جدا از خود کامپوننت ها نگه می داره تا چند محصول و کتابخونه بتونن از یه منبع مشترک استفاده کنن و ظاهرشون یکدست بمونه. این بسته همون لایه پایه است. برای همین بعضی کتابخونه های رابط کاربری SAP، مثل خانواده UI5، ممکنه به شکل غیرمستقیم بهش وابسته باشن و موقع نصب خودشون اونو بیارن.
اگه با SAP UI5، کامپوننت های وب SAP یا برنامه های به سبک Fiori کار می کنی و می خوای ظاهر رو سفارشی کنی یا یه تم اختصاصی بسازی، باید بدونی این بسته کجای زنجیره قرار می گیره. ولی اگه صاحب یه سایت وردپرسی معمولی هستی و دنبال یه کتابخونه ظاهری عمومی می گردی، این گزینه به درد تو نمی خوره. بسته فریم ورک مستقل مثل بوت استرپ نیست و دکمه، جدول یا منوی آماده نداره که بذاری توی قالبت. اگه هم فقط می خوای چند فایل CSS یا فونتش رو جدا برداری، اول ساختار پوشه ها و شرایط مجوز رو با دقت بررسی کن.
چند نکته برای انتخاب و استفاده. چون این بسته معمولا وابستگی یه کتابخونه دیگه است، نسخه اش باید با نسخه همون کتابخونه سازگار بمونه. جدا از بقیه ارتقاش نده و فایل lock پروژه رو توی مخزن نگه دار. مجوز Apache استفاده تجاری رو اجازه می ده، به شرط اینکه اعلان مجوز رو حفظ کنی.
اگه پروژه ات روی سرور داخلی بیلد می شه و دسترسی به npm بین المللی گاهی قطع یا کند می شه، نسخه های رسمی و بدون تغییر این بسته توی مخزن داخلی ما هم در دسترسه.
اول مطمئن شو واقعا به این بسته نیاز داری. اگه از یه کتابخونه SAP استفاده می کنی، احتمالا خودش این بسته رو به عنوان وابستگی نصب می کنه و لازم نیست دستی کاری بکنی. برای نصب مستقیم توی پروژه ای که با npm مدیریت می شه، این دستور رو بزن:
npm install @sap-theming/theming-base-content
بعدش این کارها رو انجام بده:
اگه ظاهر کامپوننت ها عوض نشد، اول ببین نسخه این بسته با نسخه کتابخونه اصلی هماهنگه یا نه. بیشتر مشکل ها از ناسازگاری نسخه ها میاد، نه از خود بسته.
یه بسته npm از SAP SE که محتوای پایه تم های SAP رو نگه می داره، یعنی مقدارها و منابعی که ظاهر کامپوننت های رابط کاربری SAP روشون ساخته می شه. توضیح رسمی منبع Theming Base Content هست. معمولا کنار کتابخونه های SAP کار می کنه و به تنهایی ابزار ظاهری کامل نیست.
فقط اگه سایتت از کامپوننت ها یا برنامه های مبتنی بر SAP استفاده کنه. برای یه قالب یا افزونه معمولی وردپرس کاربردی نداره، چون خودش دکمه، فرم و چیدمان آماده نمی ده. برای ظاهر عمومی سایت بهتره سراغ یه فریم ورک CSS معمولی بری.
معمولا همراه کتابخونه هایی که بهش وابسته ان نصب می شه و لازم نیست جدا اضافه اش کنی. فقط اگه بخوای مستقیم به محتوای پایه تم ها دسترسی داشته باشی یا یه تم اختصاصی بسازی، نصب جداگونه منطقیه. برای اطمینان، پوشه node_modules رو نگاه کن یا با دستور npm ls @sap-theming/theming-base-content ببین بسته الان توی پروژه ات هست یا نه. اگه بود، دوباره نصبش نکن.
بله، این مجوز به طور کلی استفاده تجاری و تغییر رو اجازه می ده. در عوض باید اعلان مجوز رو حفظ کنی و تغییرهایی که دادی رو مشخص کنی. اگه پروژه ات حساسه، متن کامل مجوز داخل خود بسته رو یه بار بخون.
می تونی نسخه رسمی و بدون تغییر بسته رو از مخزن داخلی ما بگیری و توی پروژه یا رجیستری داخلی خودت بذاری. بعدش نصب مثل همیشه انجام می شه و دیگه به دسترسی خارجی وابسته نیستی. اگه پروژه ات رجیستری داخلی داره، آدرسش رو توی تنظیمات npm بذار تا بسته ها از همون گرفته بشن. یادت نره نسخه بسته با نسخه کتابخونه اصلی هماهنگ بمونه.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.