fix: add dead link checker script and new documentation warning content files

Author: aladin002dz

scripts/deadLinkChecker.js

@@ -11,8 +11,8 @@ const path = require('path');
 const globby = require('globby');
 const chalk = require('chalk');
 
-const CONTENT_DIR = path.join(__dirname, '../src/content');
-const PUBLIC_DIR = path.join(__dirname, '../public');
+const CONTENT_DIR = path.join(__dirname, '../src/content').replace(/\\/g, '/');
+const PUBLIC_DIR = path.join(__dirname, '../public').replace(/\\/g, '/');
 const fileCache = new Map();
 const anchorMap = new Map(); // Map<filepath, Set<anchorId>>
 const contributorMap = new Map(); // Map<anchorId, URL>
@@ -135,7 +135,7 @@ async function findTargetFile(urlPath) {
 
     for (const p of publicPaths) {
       if (await fileExists(p)) {
-        return p;
+        return p.replace(/\\/g, '/');
       }
     }
   }
@@ -154,7 +154,7 @@ async function findTargetFile(urlPath) {
 
   for (const p of possiblePaths) {
     if (await fileExists(p)) {
-      return p;
+      return p.replace(/\\/g, '/');
     }
   }
   return null;

src/content/learn/add-react-to-an-existing-project.md

@@ -24,7 +24,7 @@ title: إضافة React إلى مشروع موجود بالفعل
 2. **حدد `/some-app` كـ *مسار أساسي*** في إعدادات إطار العمل الخاص بك (هنا كيف مع: [Next.js](https://nextjs.org/docs/app/api-reference/config/next-config-js/basePath), [Gatsby](https://www.gatsbyjs.com/docs/how-to/previews-deploys-hosting/path-prefix/)).
 3. **قم بتكوين خادمك أو بروكسي** بحيث يتم التعامل مع جميع الطلبات تحت `/some-app/` من قبل تطبيق React الخاص بك.
 
-يضمن هذا أن الجزء الخاص بـ React من تطبيقك يمكن أن يستفيد من [أفضل الممارسات](/learn/creating-a-react-app#can-i-use-react-without-a-framework) المدمجة في تلك الإطارات.
+يضمن هذا أن الجزء الخاص بـ React من تطبيقك يمكن أن يستفيد من [أفضل الممارسات](/learn/creating-a-react-app#full-stack-frameworks) المدمجة في تلك الإطارات.
 
 العديد من الإطارات القائمة على React هي إطارات full-stack وتتيح لتطبيق React الخاص بك الاستفادة من الخادم. ومع ذلك، يمكنك استخدام نفس النهج حتى إذا لم تتمكن أو لا تريد تشغيل JavaScript على الخادم. في هذه الحالة 
 ، قم بتصدير HTML/CSS/JS ([`next export`](https://nextjs.org/docs/advanced-features/static-html-export) لـ Next.js ، هذا هو الافتراضي لـ Gatsby) في `/some-app/` بدلاً من ذلك.

src/content/warnings/invalid-hook-call-warning.md

@@ -13,7 +13,7 @@ Hooks can only be called inside the body of a function component. \
 هُناك ثلاثة أسباب شائعه لظهور الخطأ أعلاه:
 
 1. لِديك **نُسخ غير مُتوافقة** من React و React DOM.
-2. قد تكون **تخرق [قواعد الخطاطيف](/docs/hooks-rules.html)**.
+2. قد تكون **تخرق [قواعد الخطاطيف](/reference/rules/rules-of-hooks)**.
 3. من المُحتمل أن يكون لديك **أكثر من نسخة React** في نفس التطبيق.
 
 دَعنا ننظُر إلى كُل من الحالات أعلاه.
@@ -27,9 +27,9 @@ Hooks can only be called inside the body of a function component. \
 يُكمنك استدعاء الخظافات **رَيْثَمَا تٌصيير React مكوّن دالّة** فقط:
 
 * ✅ استدعهم في المُتسوى الأعلى من بدن "body" مُكوّن الداّلة:
-* ✅ استدعهم في المُستوى الأعلى من بدن [خطاف مُخَصص](/docs/hooks-custom.html).
+* ✅ استدعهم في المُستوى الأعلى من بدن [خطاف مُخَصص](/learn/reusing-logic-with-custom-hooks).
 
-**تَعلّم المزيد عن ذلك في [قواعد الخطاطيف](/docs/hooks-rules.html)**
+**تَعلّم المزيد عن ذلك في [قواعد الخطاطيف](/reference/rules/rules-of-hooks)**
 
 ```js{2-3,8-9}
 function Counter() {
@@ -109,7 +109,7 @@ class Bad extends React.Component {
 
 <Note>
 
->[الخطاطيف المُخصّصة](/docs/hooks-custom.html) *من المُحتمل* أن تستدعي خطاطيف أُخرى (فذلك هو الهدف منها أساسًا). يعمل ذلك لأنه من المفروض أن الخطاطيف المُخصّصة تُستدعى فقط رَيْثَمَا يُصّيَّر يكون مكوّن الدالّة.
+>[الخطاطيف المُخصّصة](/learn/reusing-logic-with-custom-hooks) *من المُحتمل* أن تستدعي خطاطيف أُخرى (فذلك هو الهدف منها أساسًا). يعمل ذلك لأنه من المفروض أن الخطاطيف المُخصّصة تُستدعى فقط رَيْثَمَا يُصّيَّر يكون مكوّن الدالّة.
 
 </Note>
 

src/content/warnings/unknown-prop.md

@@ -6,13 +6,13 @@ title: Unknown Prop Warning
 
 هُناك بضعة أسباب شائعة أُخرى قد تُظهر التحذير:
 
-1. هل تستخدم `{...this.props}` أو `cloneElement(element, this.props)`؟ يَنقل مُكوّنك خواصُه مُباشرةً إلى المُكوّن الإبن ([نقل الخواص "transferring props"](/docs/transferring-props.html)). عند نقل الخواص إلى مُكوّن إبن ينبغي عليك التأكد أنّه لم يتم نقل خواص من المُفترض أن تُفَسّر من قِبَل المُكوّن الأب إلى مكوّن إبن
+1. هل تستخدم `{...this.props}` أو `cloneElement(element, this.props)`؟ يَنقل مُكوّنك خواصُه مُباشرةً إلى المُكوّن الإبن ([نقل الخواص "transferring props"](/learn/passing-props-to-a-component)). عند نقل الخواص إلى مُكوّن إبن ينبغي عليك التأكد أنّه لم يتم نقل خواص من المُفترض أن تُفَسّر من قِبَل المُكوّن الأب إلى مكوّن إبن
 
 2. تستخدم خواص DOM غير قياسية على عُقدة DOM أصلية ربما لعرض بيانات مُخصصة. إن كُنت تُحاول ربط بيانات مُخصصة بِعُنصر DOM تقليدي فعليك باستخدام خاصية بيانات مُخصصة "custom data attribute" كَما شُرِحَت [على MDN](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Using_data_attributes).
 
 3. لا تتعرّف React على الخاصية التي حددتها. سيتم غالبًا إصلاح ذلك في نُسخة مُستقبلية من React. على أية حال ، تُزيل React حاليًا جميع الخواص الغير معروفة ، مما يعني أن تحديدهم في تطبيق React خاصيك لن يؤدي إلى تصييرهم.
 
-4. تستخدم مُكوّن React بدون حروف كبيرة "upper case". تُفسّر React المُكون إلى وَسم "DOM tag" لأنّ [تحويل React JSX يستخدم ميثاق الحروف الكبيرة مُقابل الحروق الكبيرة للتميز بين المُكوّنات التي يُعرّفها المُستخدم وَوُسوم DOM](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized).
+4. تستخدم مُكوّن React بدون حروف كبيرة "upper case". تُفسّر React المُكون إلى وَسم "DOM tag" لأنّ [تحويل React JSX يستخدم ميثاق الحروف الكبيرة مُقابل الحروق الكبيرة للتميز بين المُكوّنات التي يُعرّفها المُستخدم وَوُسوم DOM](/learn/your-first-component#defining-a-component).
 
 ---