إنتقل إلى المحتوى الرئيسي

إدارة ترويسات حقوق النشر

يضيف هذا المشروع تلقائيًا ترويسات حقوق النشر إلى جميع ملفات TypeScript/JavaScript المصدرية باستخدام برنامج نصي مخصص.

ترويسة حقوق النشر​

ستُضاف تلقائيًا ترويسة حقوق النشر التالية إلى جميع الملفات المصدرية (.ts و.tsx و.js و.jsx) في الدليلين frontend/src وbackend/src:

/*
 * Libre WebUI
 * Copyright (C) 2025 Kroonen AI, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at:
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

الاستخدام​

إضافة الترويسة تلقائيًا​

تُضاف ترويسة حقوق النشر تلقائيًا عند تشغيل:

npm run format

ينفذ هذا الأمر ما يلي:

  1. يشغّل برنامج إضافة الترويسات
  2. ينسّق جميع الملفات باستخدام Prettier

إضافة الترويسة يدويًا​

يمكنك أيضًا إضافة الترويسات يدويًا من دون تنسيق:

npm run add-headers

الاكتشاف الذكي للترويسات​

يقوم البرنامج بما يلي:

  • ✅ إضافة الترويسات إلى الملفات التي لا تحتوي عليها
  • ✅ تجاوز الملفات التي تحتوي بالفعل على ترويسات حقوق النشر
  • ✅ تجاهل ملفات التهيئة ومخرجات البناء والتبعيات
  • ✅ معالجة ملفات TypeScript/JavaScript المصدرية فقط

الملفات والأدلة المتجاهلة​

تُتجاهل العناصر التالية تلقائيًا:

  • node_modules/
  • dist/
  • build/
  • coverage/
  • public/
  • ملفات التهيئة (*.config.js و*.config.ts)
  • ملفات تعريف الأنواع (vite-env.d.ts)
  • تهيئة ESLint ‏(eslint.config.js)

التنفيذ​

تُنّفذ إدارة الترويسات في /scripts/add-headers.js وتُدمج في سير عمل التنسيق داخل package.json.