الفرق بين المراجعتين ل"TypeScript/declaration files/introduction"
(إضافة الصّفحة) |
|||
| سطر 8: | سطر 8: | ||
ينقسم هذا الدليل إلى الأقسام التالية: | ينقسم هذا الدليل إلى الأقسام التالية: | ||
===هياكل المكتبات=== | ===هياكل المكتبات=== | ||
| − | يُساعد دليل هياكل المكتبات على فهم أشكال المكتبات الشائعة وكيفيّة كتابة ملفّ تصريحٍ سليمٍ لكلّ شكل. إذا كنت تُحرّر ملفّ تصريحات | + | يُساعد [[TypeScript/declaration files/library structures|دليل هياكل المكتبات]] على فهم أشكال المكتبات الشائعة وكيفيّة كتابة ملفّ تصريحٍ سليمٍ لكلّ شكل. إذا كنت تُحرّر ملفّ تصريحات موجودٍ أصلًا (كُتِب من طرف مبرمج آخر مثلًا)، فالغالب أنّك لا تحتاج إلى قراءة هذا القسم. ينبغي على كُتّاب ملفّات التصريحات الجديدة قراءةُ هذا القسم لفهم كيف يؤثّر شكل المكتبة على كتابة ملفّ تصريحات لها. |
| − | |||
===ملفات التصريحات اعتمادًا على الأمثلة=== | ===ملفات التصريحات اعتمادًا على الأمثلة=== | ||
| − | نحتاج أحيانًا إلى كتابة ملف تصريحاتٍ لمكتبةٍ ما انطلاقًا من أمثلة استخدام المكتبة (من توثيق المكتبة مثلا). يوضّح قسم كتابة ملفات التصريحات اعتمادًا على الأمثلة عددًا من أنماط الواجهات البرمجية (API patterns) الشائعة وكيفية إنشاء ملفات تصريحات لكل منها. هذا الدليل موجّه للمبتدئين في لغة TypeScript ممّن لا يفهمون جميع المبادئ الموجودة في TypeScript. | + | نحتاج أحيانًا إلى كتابة ملف تصريحاتٍ لمكتبةٍ ما انطلاقًا من أمثلة استخدام المكتبة (من توثيق المكتبة مثلا). يوضّح قسم [[TypeScript/declaration files/by example|كتابة ملفات التصريحات اعتمادًا على الأمثلة]] عددًا من أنماط الواجهات البرمجية (API patterns) الشائعة وكيفية إنشاء ملفات تصريحات لكل منها. هذا الدليل موجّه للمبتدئين في لغة TypeScript ممّن لا يفهمون جميع المبادئ الموجودة في TypeScript. |
| − | |||
===افعل ولا تفعل=== | ===افعل ولا تفعل=== | ||
| − | يمكن بسهولةٍ تجنّب العديد من الأخطاء الشائعة عند كتابة ملفات التعريفات. يوضّح قسم افعل ولا تفعل الأخطاء الشائعة ويصف كيفيّة اكتشافها وكيفيّة إصلاحها. ينبغي على الكل قراءة هذا القسم لتجنّب الأخطاء الشائعة. | + | يمكن بسهولةٍ تجنّب العديد من الأخطاء الشائعة عند كتابة ملفات التعريفات. يوضّح قسم [[TypeScript/declaration files/do s and don ts|افعل ولا تفعل]] الأخطاء الشائعة ويصف كيفيّة اكتشافها وكيفيّة إصلاحها. ينبغي على الكل قراءة هذا القسم لتجنّب الأخطاء الشائعة. |
| − | |||
===التعمق في ملفات التصريحات=== | ===التعمق في ملفات التصريحات=== | ||
| − | قسم التعمق في ملفات التصريحات موجَّهٌ للكتّاب الخبراء ممّن يريدون فهم آلية عمل ملفات التصريحات، إذ يشرح القسم عددًا من المبادئ المتقدمة في كتابة التصريحات، ويوضّح كيفيّة استغلال هذه المبادئ لإنشاء ملفّات تصريحات أوضح وأبسط. | + | قسم [[TypeScript/declaration files/deep dive|التعمق في ملفات التصريحات]] موجَّهٌ للكتّاب الخبراء ممّن يريدون فهم آلية عمل ملفات التصريحات، إذ يشرح القسم عددًا من المبادئ المتقدمة في كتابة التصريحات، ويوضّح كيفيّة استغلال هذه المبادئ لإنشاء ملفّات تصريحات أوضح وأبسط. |
===قوالب=== | ===قوالب=== | ||
| − | ستجد في قسم قوالب عددًا من ملفّات التصريحات التي ستكون بمثابة نقطة بداية عند كتابة ملفّ جديد. انظر توثيق هياكل المكتبات لفهم القالب الذي عليك استعماله في حالتك. | + | ستجد في قسم [[TypeScript/declaration files/templates|قوالب]] عددًا من ملفّات التصريحات التي ستكون بمثابة نقطة بداية عند كتابة ملفّ جديد. انظر توثيق [[TypeScript/declaration files/library structures|هياكل المكتبات]] لفهم القالب الذي عليك استعماله في حالتك. |
| − | |||
===النشر على منصة npm=== | ===النشر على منصة npm=== | ||
| − | يشرح قسم نشر ملفات التصريحات كيفيّة نشر ملفّاتك على npm ويوضّح كيفيّة إدارة الحزم التي تعتمد عليها. | + | يشرح قسم [[TypeScript/declaration files/publishing|نشر ملفات التصريحات]] كيفيّة نشر ملفّاتك على npm ويوضّح كيفيّة إدارة الحزم التي تعتمد عليها. |
| − | |||
===البحث عن ملفّات التصريحات وتثبيتها=== | ===البحث عن ملفّات التصريحات وتثبيتها=== | ||
| − | يشرح قسم استخدام ملفات التصريحات لمستخدمي مكتبات JavaScript الخطوات البسيطة التي عليك اتباعها للبحث عن ملفّات التصريحات الخاصة بالمكتبة وكيفيّة تثبيتها. | + | يشرح قسم [[TypeScript/declaration files/consumption|استخدام ملفات التصريحات]] لمستخدمي مكتبات JavaScript الخطوات البسيطة التي عليك اتباعها للبحث عن ملفّات التصريحات الخاصة بالمكتبة وكيفيّة تثبيتها. |
== مصادر == | == مصادر == | ||
* [https://www.typescriptlang.org/docs/handbook/declaration-files/introduction.html صفحة Introduction في توثيق TypeScript الرسمي.] | * [https://www.typescriptlang.org/docs/handbook/declaration-files/introduction.html صفحة Introduction في توثيق TypeScript الرسمي.] | ||
[[تصنيف:TypeScript]] | [[تصنيف:TypeScript]] | ||
المراجعة الحالية بتاريخ 14:51، 9 أكتوبر 2018
مقدمة
هذا الدليل مصمَّم لإرشادك إلى كيفيّة كتابة ملفّات تصريحاتٍ (Declaration Files) عاليّة الجودة في TypeScript.
يفترض هذا الدليل أنّ لك معرفةً بأساسيّات لغة TypeScript. اقرأ توثيق لغة TypeScript لتفهم مبادئ اللغة الأساسيّة، خاصّة الأنواع ومجالات الأسماء.
الأقسام
ينقسم هذا الدليل إلى الأقسام التالية:
هياكل المكتبات
يُساعد دليل هياكل المكتبات على فهم أشكال المكتبات الشائعة وكيفيّة كتابة ملفّ تصريحٍ سليمٍ لكلّ شكل. إذا كنت تُحرّر ملفّ تصريحات موجودٍ أصلًا (كُتِب من طرف مبرمج آخر مثلًا)، فالغالب أنّك لا تحتاج إلى قراءة هذا القسم. ينبغي على كُتّاب ملفّات التصريحات الجديدة قراءةُ هذا القسم لفهم كيف يؤثّر شكل المكتبة على كتابة ملفّ تصريحات لها.
ملفات التصريحات اعتمادًا على الأمثلة
نحتاج أحيانًا إلى كتابة ملف تصريحاتٍ لمكتبةٍ ما انطلاقًا من أمثلة استخدام المكتبة (من توثيق المكتبة مثلا). يوضّح قسم كتابة ملفات التصريحات اعتمادًا على الأمثلة عددًا من أنماط الواجهات البرمجية (API patterns) الشائعة وكيفية إنشاء ملفات تصريحات لكل منها. هذا الدليل موجّه للمبتدئين في لغة TypeScript ممّن لا يفهمون جميع المبادئ الموجودة في TypeScript.
افعل ولا تفعل
يمكن بسهولةٍ تجنّب العديد من الأخطاء الشائعة عند كتابة ملفات التعريفات. يوضّح قسم افعل ولا تفعل الأخطاء الشائعة ويصف كيفيّة اكتشافها وكيفيّة إصلاحها. ينبغي على الكل قراءة هذا القسم لتجنّب الأخطاء الشائعة.
التعمق في ملفات التصريحات
قسم التعمق في ملفات التصريحات موجَّهٌ للكتّاب الخبراء ممّن يريدون فهم آلية عمل ملفات التصريحات، إذ يشرح القسم عددًا من المبادئ المتقدمة في كتابة التصريحات، ويوضّح كيفيّة استغلال هذه المبادئ لإنشاء ملفّات تصريحات أوضح وأبسط.
قوالب
ستجد في قسم قوالب عددًا من ملفّات التصريحات التي ستكون بمثابة نقطة بداية عند كتابة ملفّ جديد. انظر توثيق هياكل المكتبات لفهم القالب الذي عليك استعماله في حالتك.
النشر على منصة npm
يشرح قسم نشر ملفات التصريحات كيفيّة نشر ملفّاتك على npm ويوضّح كيفيّة إدارة الحزم التي تعتمد عليها.
البحث عن ملفّات التصريحات وتثبيتها
يشرح قسم استخدام ملفات التصريحات لمستخدمي مكتبات JavaScript الخطوات البسيطة التي عليك اتباعها للبحث عن ملفّات التصريحات الخاصة بالمكتبة وكيفيّة تثبيتها.