vscode spell checker

شفرة المصدر الأخرى

v4.0.21

تنزيل

المدقق الإملائي لرمز Visual Studio

مدقق إملائي أساسي يعمل بشكل جيد مع التعليمات البرمجية والمستندات.

الهدف من المدقق الإملائي هذا هو المساعدة في اكتشاف الأخطاء الإملائية الشائعة مع الحفاظ على انخفاض عدد النتائج الإيجابية الخاطئة.

دعم مزيد من التطوير

الوظيفة

قم بتحميل ملف TypeScript، وJavaScript، وText، وما إلى ذلك. الكلمات غير الموجودة في ملفات القاموس سيكون لها تسطير متعرج.

مثال

اقتراحات

لرؤية قائمة الاقتراحات:

بعد وضع المؤشر في الكلمة، يجب أن يعرض أي مما يلي قائمة الاقتراحات:

انقر على (المصباح) الموجود في الهامش الأيسر.
أمر إجراء محرر Quick Fix :

ماك: ⌘ + . أو Cmd + .
الكمبيوتر: Ctrl + .

ثَبَّتَ

افتح VS Code واضغط على F1 واكتب ext ، حدد install واكتب code-spell-checker ثم اضغط على زر الإدخال وإعادة التحميل للتمكين.

اللغات المدعومة

الإنجليزية (الولايات المتحدة)
الإنجليزية (GB) - قم بالتشغيل عن طريق تغيير "cSpell.language": "en" إلى "cSpell.language": "en-GB"

القواميس الإضافية

قواميس اللغة

اليونانية القديمة - ملحق القاموس اليوناني القديم لرمز VS.
العربية - امتداد القاموس العربي لرمز VS.
الإنجليزية الأسترالية - امتداد قاموس اللغة الإنجليزية الأسترالية لرمز VS.
الألمانية النمساوية - ملحق القاموس الألماني النمساوي لرمز VS.
لغة الباسك - امتداد القاموس الباسكي لرمز VS.
الإنجليزية البريطانية - امتداد قاموس اللغة الإنجليزية البريطانية لرمز VS.
البلغارية - امتداد القاموس البلغاري لرمز VS.
اللغة الإنجليزية الكندية - امتداد قاموس اللغة الإنجليزية الكندية لرمز VS.
الكاتالانية - ملحق القاموس الكاتالوني لرمز VS.
الكرواتية - امتداد القاموس الكرواتي لرمز VS.
التشيكية - ملحق القاموس التشيكي لرمز VS.
الدنماركية - امتداد القاموس الدنماركي لرمز VS.
الهولندية - ملحق القاموس الهولندي / Nederlands لـ VS Code.
الاسبرانتو - ملحق قاموس الاسبرانتو لرمز VS.
الإستونية - ملحق القاموس الإستوني لرمز VS.
الفنلندية - ملحق القاموس الفنلندي لرمز VS.
الفرنسية - ملحق القاموس الفرنسي لرمز VS.
French Réforme 90 - امتداد القاموس الفرنسي Réforme 90 لرمز VS.
الألمانية - امتداد القاموس الألماني لرمز VS.
اليونانية - ملحق القاموس اليوناني لرمز VS.
العبرية - ملحق القاموس العبري لرمز VS.
المجرية - ملحق القاموس الهنغاري لرمز VS.
الإندونيسية - ملحق القاموس الإندونيسي لرمز VS.
الإيطالية - امتداد القاموس الإيطالي لرمز VS.
اللاتينية - امتداد القاموس اللاتيني لرمز VS.
اللاتفية - ملحق القاموس اللاتفي لرمز VS.
الليتوانية - امتداد القاموس الليتواني لرمز VS.
المقدونية - امتداد القاموس المقدوني لرمز VS.
البوكمال النرويجية - ملحق قاموس البوكمال النرويجي لرمز VS.
الفارسية - ملحق القاموس الفارسي لرمز VS.
البولندية - ملحق القاموس البولندي لرمز VS.
البرتغالية - ملحق القاموس البرتغالي لرمز VS.
البرتغالية البرازيلية - ملحق القاموس البرتغالي البرازيلي لرمز VS.
الرومانية - امتداد القاموس الروماني لرمز VS.
الروسية - ملحق القاموس الروسي لرمز VS.
الصربية - ملحق القاموس الصربي لرمز VS.
السلوفاكية - ملحق القاموس السلوفاكي لرمز VS.
السلوفينية - امتداد القاموس السلوفيني لرمز VS.
الإسبانية - الوظيفة الإضافية الإسبانية للمدقق الإملائي للرمز
السويدية - امتداد القاموس السويدي لرمز VS.
الألمانية السويسرية - ملحق القاموس الألماني السويسري لرمز VS.
التركية - امتداد القاموس التركي لرمز VS.
الأوكرانية - ملحق القاموس الأوكراني لرمز VS.
الفيتنامية - ملحق القاموس الفيتنامي لرمز VS.

القواميس التقنية

المصطلحات الطبية - الوظيفة الإضافية للمصطلحات الطبية للمدقق الإملائي للرمز
المصطلحات العلمية - ملحق قاموس المصطلحات العلمية لرمز VS.
Win32 - ملحق قاموس Win32 لرمز VS.

أنواع الملفات الممكّنة

AsciiDoc
ج، سي++
ج #
المغلق، أقل، SSS
دارت
إكسير
يذهب
أتش تي أم أل
جافا
جافا سكريبت
جسون / جسونك
مطاط
تخفيض السعر
PHP
بوويرشيل
الصلصال / اليشم
بايثون
reStructuredText
روبي
الصدأ
سكالا
نص
تايب سكريبت
يامل
SQL

تمكين / تعطيل أنواع الملفات

لتمكين أو تعطيل التدقيق الإملائي لنوع الملف:

انقر فوق حالة المدقق الإملائي في شريط الحالة:

شريط حالة المدقق الإملائي

في شاشة المعلومات، انقر فوق خانة الاختيار.

نافذة معلومات المدقق الإملائي

كيف يعمل مع CamelCase

المفهوم بسيط، قم بتقسيم كلمات الجمل قبل التحقق منها مقابل قائمة الكلمات الإنجليزية المعروفة.

حالة الجمل -> حالة الجمل
HTMLInput -> إدخال html - لاحظ أن I مرتبط Input وليس بـ HTML
Snake_case_words -> كلمات حالة الثعبان
Camel2snake -> ثعبان الجمل - (تم تجاهل الرقم 2)

حالة خاصة مع كل الكلمات بالأحرف الكبيرة

هناك بعض الحالات الخاصة للمساعدة في الممارسات الإملائية الشائعة للكلمات التي تحتوي على حروف كبيرة.

زائدة s , ing , ies , es , ed يتم الاحتفاظ بها مع الكلمة السابقة.

تجعيد الشعر -> تجعيد الشعر - s
CURLedRequest -> طلب ملتف - ed اللاحقة

أشياء يجب ملاحظتها

هذا المدقق الإملائي حساس لحالة الأحرف. لن يلتقط أخطاء مثل اللغة الإنجليزية التي يجب أن تكون الإنجليزية.
يستخدم المدقق الإملائي قاموس الكلمات المحلي. ولا يرسل أي شيء خارج جهازك.
يمكن أن تحتوي الكلمات الموجودة في القاموس على أخطاء.
هناك كلمات مفقودة.
يتم فحص الكلمات الأطول من 3 أحرف فقط. لم يتم تحديد "jsj" بينما تم تحديد "jsja" وسيتم وضع علامة عليها على أنها غير صحيحة لأنها غير موجودة في أي من القواميس.
يتم تجاهل كافة الرموز وعلامات الترقيم.

في إعدادات المستند

من الممكن إضافة إعدادات التدقيق الإملائي إلى كود المصدر الخاص بك. هذا للمساعدة في حل مشكلات الملف المحددة التي قد لا تنطبق على المشروع بأكمله.

جميع الإعدادات مسبوقة بـ cSpell: أو spell-checker: .

disable - قم بإيقاف تشغيل المدقق الإملائي لقسم من التعليمات البرمجية.
enable - أعد تشغيل المدقق الإملائي بعد إيقاف تشغيله.
ignore - تحديد قائمة الكلمات التي سيتم تجاهلها.
words - حدد قائمة الكلمات التي تعتبر صحيحة وسوف تظهر في قائمة الاقتراحات.
locale - تعيين الإعدادات المحلية (على سبيل المثال: cSpell:locale fr,en لاستخدام اللغتين الفرنسية والإنجليزية)
ignoreRegExp - لن يتم فحص أي نص يطابق التعبير العادي للتأكد من صحته.
includeRegExp - سيتم فحص النص المطابق لمجموعة includeRegExp فقط.
enableCompoundWords / disableCompoundWords - السماح / عدم السماح بكلمات مثل: "stringlength".

تمكين / تعطيل التحقق من أقسام التعليمات البرمجية

من الممكن تعطيل/تمكين المدقق الإملائي عن طريق إضافة تعليقات إلى التعليمات البرمجية الخاصة بك.

تعطيل التحقق

cSpell:disable
spell-checker: disable
spellchecker: disable
cspell: disable-line
cspell: disable-next-line

تمكين التحقق

cSpell:enable
spell-checker: enable
spellchecker: enable

مثال جافا سكريبت

 // cSpell:disableconst wackyWord = ['zaallano', 'wooorrdd', 'zzooommmmmmmm'];/* cSpell:enable */// Nest Disable / Enable غير مدعوم // المدقق الإملائي: Disable// تم تعطيله الآن .var liep = 1;/* cspell:disable */// لا يزال معطلاً// cSpell:enable// تم تمكينه الآنconst str = 'goededag'; // <- سيتم وضع علامة على أنه خطأ.// المدقق الإملائي:enable <- لا يفعل أي شيء// cSPELL:DISABLE <-- يعمل أيضًا.// إذا لم يكن هناك تمكين، فسيتم تعطيل التدقيق الإملائي حتى نهاية الملف.const str = 'goedemorgen'; // <- لن يتم وضع علامة على الخطأ.

مثال تخفيض السعر

 <!--- cSpell:disable --->لم يتم تحديد هذا النص.<!--- cSpell:enable --->تم تحديد هذا النص.

يتجاهل

يتيح لك التجاهل تحديد قائمة الكلمات التي تريد تجاهلها داخل المستند.

 // cSpell:ignore zaallano, wooorrdd// cSpell:ignore zzooommmmmmmmconst wackyWord = ['zaallano', 'wooorrdd', 'zzooommmmmmmmmm'];

ملاحظة: سيتم تجاهل الكلمات المحددة بـ ignore للملف بأكمله.

كلمات

تسمح لك قائمة الكلمات بإضافة الكلمات التي سيتم اعتبارها صحيحة وسيتم استخدامها كاقتراحات.

 // cSpell:words woorxs sweeetbeatconst CompanyName = 'woorxs sweeetbeat';

ملاحظة: سيتم استخدام الكلمات المحددة words للملف بأكمله.

تمكين / تعطيل الكلمات المركبة

من الشائع في بعض لغات البرمجة لصق الكلمات معًا.

 // cSpell:enableCompoundWordschar * errormessage;  // هل يناسبك cSpell:enableCompoundWordsint errornumber;   // لا بأس به أيضًا.

ملاحظة: لا يمكن تشغيل/إيقاف تشغيل فحص الكلمات المركبة في نفس الملف. يحدد الإعداد الأخير في الملف قيمة الملف بأكمله.

استبعاد وتضمين النص المراد التحقق منه.

بشكل افتراضي، يتم التدقيق الإملائي للمستند بأكمله. يتيح لك cSpell:disable / cSpell:enable أعلاه حجب أجزاء من المستند. يمنحك ignoreRegExp و includeRegExp القدرة على تجاهل أنماط النص أو تضمينها. افتراضيًا، تتم إضافة علامات gim في حالة عدم إعطاء أي علامات.

يعمل المدقق الإملائي بالطريقة التالية:

ابحث عن كافة النصوص المتطابقة includeRegExp
قم بإزالة أي نص مطابق excludeRegExp
تحقق من النص المتبقي.

استبعاد المثال

 // cSpell:ignoreRegExp 0x[0-9a-f]+ -- سوف يتجاهل الأرقام السداسية لنمط c // cSpell:ignoreRegExp /0x[0-9A-F]+/g -- سيتجاهل الأرقام السداسية ذات الأحرف الكبيرة لنمط c. // cSpell:ignoreRegExp g{5} h{5} -- سوف يتطابق فقط مع ggggg، وليس hhhhh أو 'ggggg hhhhh'// cSpell:ignoreRegExp g{5}|h{5} -- سيطابق كلاً من ggggg وhhhhh// cSpell:ignoreRegExp /g{5} h{5}/ -- سيطابق 'ggggg hhhhh'/* cSpell:ignoreRegExp /n {5}/ -- لن يعمل كما هو متوقع بسبب التعليق النهائي -> *//* cSpell:ignoreRegExp /q{5}/ -- سوف يتطابق qqqqq جيد ولكن ليس QQQQQ*/// cSpell:ignoreRegExp /[^s]{40,}/ -- سوف يتجاهل السلاسل الطويلة بدون مسافات.// cSpell:ignoreRegExp Email - سيؤدي هذا إلى تجاهل أنماط البريد الإلكتروني المشابهة - راجع تعبيرات RegExp المحددة مسبقًاvar encodedImage = 'HR+cPzr7XGAOJNurPL0G8I2kU0UhKcqFssoKvFTR7z0T3VJfK37vS025uKroHfJ9nA6WWbHZ/ASn...';var email1 = '[email protected]';var email2 = '<[email protected]>';

ملاحظة: يتم تطبيق تجاهلRegExp وincludeRegExp على الملف بأكمله. إنهم لا يبدأون ويتوقفون.

تضمين المثال

بشكل عام، لا يجب أن تحتاج إلى استخدام includeRegExp . ولكن إذا كنت تقوم بخلط اللغات، فقد يكون ذلك مفيدًا.

 # cSpell:includeRegExp #.*# cSpell:includeRegExp /(["]{3}|[']{3})[^1]*?1/g# سيتم فحص التعليقات وسلاسل الحظر فقط من أجل التدقيق الإملائي.def sum_it( self, seq):"""تم التدقيق الإملائي"""variabele = 0alinea = 'لم يتم التحقق من هذا'للرقم في seq:# ستكون الحالة المحلية لـ 'value' تم الاحتفاظ بها بين التكراراتvariabele += numyield variabele

تعبيرات RegExp المحددة مسبقًا

استبعاد الأنماط

Urls ¹ - تطابق عناوين URL
HexValues - يطابق التنسيق السداسي الشائع مثل #aaa و 0xfeef و u0134
EscapeCharacters ¹ - يتطابق مع الأحرف الخاصة: n و t وما إلى ذلك.
Base64 ¹ - يطابق كتل النص base64 التي يزيد طولها عن 40 حرفًا.
Email - يطابق معظم عناوين البريد الإلكتروني.

تضمين الأنماط

Everything ¹ - بشكل افتراضي، نقوم بمطابقة مستند بأكمله وإزالة الاستثناءات.
string - يطابق هذا تنسيقات السلاسل الشائعة مثل '...' و"..." و`...`
CStyleComment - هذه هي تعليقات نمط C /* */ و//
PhpHereDoc - يطابق هذا سلاسل PHPHereDoc.

^1. تعد هذه الأنماط جزءًا من قائمة التضمين/الاستبعاد الافتراضية لكل ملف.

التخصيص

يمكن التحكم في تكوين المدقق الإملائي عبر تفضيلات VS Code أو ملف التكوين cspell.json .

ترتيب الأسبقية:

مجلد مساحة العمل cspell.json
مجلد مساحة العمل .vscode/cspell.json
قسم cSpell لتفضيلات VS Code.

إضافة كلمات إلى قاموس مساحة العمل

لديك خيار إضافة الكلمات الخاصة بك إلى قاموس مساحة العمل. الأسهل هو وضع المؤشر على الكلمة التي ترغب في إضافتها، وعندما يظهر المصباح، اضغط على Ctrl+. (ويندوز) / Cmd+. (ماك). سوف تحصل على قائمة الاقتراحات وخيار إضافة الكلمة.

يمكنك أيضًا كتابة الكلمة التي تريد إضافتها إلى القاموس: F1 add word - حدد Add Word to Dictionary واكتب الكلمة التي ترغب في إضافتها.

cspell.json

يتم وضع الكلمات المضافة إلى القاموس في ملف cspell.json في مجلد مساحة العمل . لاحظ أن الإعدادات الموجودة في cspell.json ستتجاوز إعدادات cSpell المكافئة في settings.json الخاصة بـ VS Code.

مثال لملف cspell.json

 // إعدادات cSpell{// إصدار ملف الإعداد.  دائمًا 0.2"الإصدار": "0.2"،// اللغة - لغة التهجئة النشطة الحالية"language": "en"،// الكلمات - قائمة الكلمات التي يجب اعتبارها صحيحة دائمًا"words": ["mkdirp"،"tsmerge" "githubusercontent"، "streetsidesoftware"، "vsmarketplacebadge"، "visualstudio"]،// flagWords - قائمة الكلمات التي تعتبر دائمًا غير صحيحة// وهذا مفيد للكلمات المسيئة والتهجئة الشائعة Errors.// على سبيل المثال، "hte" يجب أن يكون "the""flagWords": ["hte"]}

إعدادات تكوين رمز VS

    //-------- تكوين المدقق الإملائي للكود --------// لغة اللغة المستخدمة عند التدقيق الإملائي. يتم حاليًا دعم "en" و"en-US" و"en-GB" افتراضيًا. ,// يتحكم في عدد الاقتراحات المعروضة."cSpell.numSuggestions": 8,// الحد الأدنى لطول الكلمة قبل التحقق منها في القاموس."cSpell.minWordLength": 4,// حدد أنواع الملفات للتدقيق الإملائي."cSpell.enabledLanguageIds": ["csharp"، "go"، "javascript"، "javascriptreact"، "markdown"، "php"، "plaintext"، "Typescript"، "typescriptreact"، "yaml"، "sql"]،// تمكين / تعطيل المدقق الإملائي."cSpell.enabled": true،// الكلمات المراد إضافتها إلى القاموس لمساحة العمل."cSpell.words": [],// تمكين / تعطيل الكلمات المركبة مثل 'errormessage'"cSpell.allowCompoundWords": false،// الكلمات التي سيتم تجاهلها وعدم اقتراحها."cSpell.ignoreWords": ["behaviour"]،// كلمات المستخدم المراد إضافتها إلى القاموس.  يجب أن يكون فقط في إعدادات المستخدم. "node_modules"، // نفس الشيء بالنسبة لهذا "**/node_modules/**"، // نفس الشيء بالنسبة لهذا "node_modules/**"، // لا يعمل حاليًا بسبب كيف يتم تحديد دليل العمل الحالي."vscode-extension"، //".git"، // تجاهل دليل .git"*.dll"، // تجاهل جميع ملفات .dll."**/*.dll" // تجاهل جميع ملفات .dll],// flagWords - قائمة الكلمات التي يجب اعتبارها دائمًا غير صحيحة// وهذا مفيد للكلمات المسيئة والأخطاء الإملائية الشائعة.// على سبيل المثال، "hte" يجب أن يكون "the"`"cSpell. كلمات العلم": ["hte"],// اضبط التأخير قبل التدقيق الإملائي للمستند. الافتراضي هو 50."cSpell.spellCheckDelayMs": 50،// تعيين مستوى التقارير التشخيصية// خطأ - الإبلاغ عن المشكلات الإملائية كأخطاء// تحذير - الإبلاغ عن المشكلات الإملائية كتحذيرات// معلومات - الإبلاغ عن المشكلات الإملائية كمعلومات (افتراضي)// تلميح - الإبلاغ عن مشكلات إملائية باعتبارها تلميحات، لن تظهر في المشكلات"cSpell.diagnosticLevel": "المعلومات"،

القواميس

يتضمن المدقق الإملائي مجموعة من القواميس الافتراضية.

قواميس عامة

wordEn - مشتقة من الكلمات الإنجليزية الأمريكية Hunspell.
wordEnGb - مشتقة من الكلمات الإنجليزية Hunspell GB.
الشركات - قائمة الشركات المعروفة
مصطلحات البرمجيات - مصطلحات ومفاهيم البرمجيات مثل "coroutine"، و"debounce"، و"tree"، وما إلى ذلك.
Misc - مصطلحات لا تنتمي إلى القواميس الأخرى.

قواميس لغات البرمجة

Typescript - الكلمات الرئيسية لـ Typescript وJavascript
العقدة - المصطلحات المتعلقة باستخدام العقدة.
php - الكلمات الرئيسية وأساليب المكتبة php
اذهب - اذهب الكلمات الرئيسية وأساليب المكتبة
بيثون - الكلمات الرئيسية بيثون
بوويرشيل - الكلمات الرئيسية بوويرشيل
html - الكلمات الرئيسية ذات الصلة بـ html
CSS - CSS ، أقل ، والكلمات الرئيسية ذات الصلة بـ SSS

قواميس متنوعة

الخطوط - قائمة طويلة من الخطوط - للمساعدة في CSS

استنادا إلى لغة البرمجة، سيتم تحميل قواميس مختلفة.

فيما يلي بعض القواعد الافتراضية:

"*" يطابق أي لغة برمجة/نوع ملف.
يتم استخدام "locale" للتصفية بناءً على إعداد "cSpell.language" .

 {"cSpell.languageSettings": [
  { "languageId": '*', "locale": 'en', "القواميس": ['wordsEn'] },
  { "languageId": '*', "locale": 'en-US', "dictionaries": ['wordsEn'] },
  { "languageId": '*', "locale": 'en-GB', "القواميس": ['wordsEnGb'] },
  { "languageId": '*'، "القواميس": ['الشركات'، 'مصطلحات البرامج'، 'متفرقات'] }،
  { "languageId": "python"، "القواميس": ["python"]}،
  { "languageId": "go"، "القواميس": ["go"] }،
  { "languageId": "javascript"، "القواميس": ["typescript"، "node"] }،
  { "languageId": "javascriptreact"، "القواميس": ["typescript"، "node"] }،
  { "languageId": "typescript"، "القواميس": ["typescript"، "node"] }،
  { "languageId": "typescriptreact"، "القواميس": ["typescript"، "node"] }،
  { "languageId": "html"، "القواميس": ["html"، "fonts"، "typescript"، "css"] }،
  { "languageId": "php"، "القواميس": ["php"، "html"، "fonts"، "css"، "typescript"] }،
  { "languageId": "css"، "القواميس": ["fonts"، "css"] }،
  { "languageId": "أقل"، "القواميس": ["الخطوط"، "css"] }،
  { "languageId": "scss"، "القواميس": ["fonts"، "css"] },];}

كيفية إضافة القواميس الخاصة بك

`cSpell.customDictionaries`

 إعدادات الواجهة {'cSpell.customDictionaries': {[name: string]: CustomDictionary;};}interface CustomDictionary {/** * @title اسم القاموس * الاسم المرجعي للقاموس.     * * * مثال: `كلماتي` أو `مخصص` * * * إذا كان الاسم يتطابق مع قاموس محدد مسبقًا، فسوف يتجاوز القاموس المحدد مسبقًا.     * إذا كنت تستخدم: `typescript` فسوف يحل محل قاموس TypeScript المدمج.     */name?: DictionaryId;/** * @title وصف القاموس * اختياري: وصف يمكن قراءته بواسطة الإنسان.     */description?: string;/** * @title المسار إلى ملف القاموس النصي * حدد المسار إلى ملف القاموس النصي.     * * * **ملاحظة:** إذا كان المسار "غير محدد"، فمن المتوقع العثور على قاموس "الاسم" * في "التعريفات".     * * * تنسيق الملف: يعتبر كل سطر في الملف إدخالاً في القاموس.     * يتم الحفاظ على حالة الأحرف أثناء إزالة المسافة البادئة والزائدة.     * يجب أن يكون المسار مطلقًا، أو نسبيًا لمساحة العمل.     * * **مثال:** بالنسبة إلى مجلد المستخدم * * ``` * ~/dictionaries/custom_dictionary.txt * ``` * * **مثال:** بالنسبة إلى مجلد ``العميل`` في مساحة عمل متعددة الجذور * * ``` * ${workspaceFolder:client}/build/custom_dictionary.txt * ``` * * **مثال:** نسبة إلى الحالي مجلد مساحة العمل في مساحة عمل ذات جذر واحد * * **ملاحظة:** قد لا يكون هذا كما هو متوقع في مساحة عمل متعددة الجذور نظرًا لأنه يعتمد على مساحة العمل * النسبية للملف المفتوح حاليًا.     * * ``` * ${workspaceFolder}/build/custom_dictionary.txt * ``` * * **مثال:** نسبة إلى مجلد مساحة العمل في مساحة عمل أحادية الجذر أو المجلد الأول في * مساحة عمل متعددة الجذر * * ``` * ./build/custom_dictionary.txt * ``` */path?: FsPath;/** * @title أضف كلمات إلى القاموس * وضح ما إذا كان يجب استخدام هذا القاموس المخصص لتخزين الكلمات المضافة.     * @default true */addWords?: boolean;/** * @title نطاق القاموس * الخيارات هي * - `المستخدم` - الكلمات التي تنطبق على كافة المشاريع ومساحات العمل * - `مساحة العمل` - الكلمات التي تنطبق على مساحة العمل بأكملها * - `مجلد` - الكلمات التي تنطبق على مجلد مساحة العمل فقط */النطاق؟: CustomDictionaryScope | CustomDictionaryScope[];}

القاموس العالمي

لإضافة قاموس عالمي، ستحتاج إلى تغيير إعدادات المستخدم الخاصة بك.

تعريف القاموس

في إعدادات المستخدم الخاصة بك، ستحتاج إلى إخبار المدقق الإملائي بمكان العثور على قائمة الكلمات الخاصة بك.

مثال على إضافة مصطلحات طبية، بحيث يمكن العثور على كلمات مثل acanthopterygious .

إعدادات رمز VS

 "cSpell.customDictionaries": {
  "myWords": {"name": "myWords"، "path": "~/my-words.txt"، "النطاق": "user"، "addWords": صحيح
  }}

موضح: في هذا المثال، أخبرنا المدقق الإملائي بمكان العثور على قاموسنا الشخصي المسمى myWords .

name - هذا هو اسم القاموس، كل المراجع لهذا القاموس تتم بالاسم.
path - هذا هو المسار إلى ملف القاموس. نظرًا لوجوده في إعدادات المستخدم، يتعين علينا استخدام المسارات المطلقة أو المسارات المتعلقة بدليل المستخدم باستخدام ~/ .
scope - (اختياري) يُستخدم هذا "لنطاق" القاموس إلى user أو workspace أو folder . يتم استخدام النطاق للمساعدة في توصيل الاستخدام المقصود للقاموس.
addWords - (اختياري) الافتراضي - true - يُستخدم لإظهار/إخفاء القاموس كهدف محتمل لإضافة الكلمات.

قاموس المشروع/مساحة العمل باستخدام `cspell.json`

يجب تحديد إضافة قاموس على مستوى المشروع في ملف cspell.json بحيث يمكن استخدامه مع أداة سطر أوامر cspell . يمكن أن يكون هذا الملف إما في جذر المشروع أو في دليل .vscode.

مثال على إضافة المصطلحات الطبية، حيث يتم التحقق من المصطلحات في المشروع ونريد استخدامها فقط لملفات .md.

 {"dictionaryDefinitions": [{ "name": "medicalTerms"، "path": "./dictionaries/medicalterms-en.txt"}، { "name": "cities"، "path": "./dictionaries/ citys.txt"}],"dictionaries": ["cities"],"languageSettings": [{ "languageId": "markdown", "dictionaries": ["medicalTerms"] },{ "languageId": "نص عادي"، "قواميس": ["medicalTerms"] }]}

موضح: في هذا المثال، تم تعريف قاموسين: المدن والمصطلحات الطبية . ترتبط المسارات بموقع ملف cSpell.json . وهذا يسمح لفحص القواميس في المشروع.

يتم استخدام قاموس المدن لكل نوع ملف، لأنه تمت إضافته إلى قائمة القواميس . يتم استخدام قاموس MedicalTerms فقط عند تحرير ملفات تخفيض السعر أو الملفات النصية العادية .

تعريف القاموس

 واجهة تعريف القاموس {/** * هذا هو اسم القاموس.     * * تنسيق الاسم: * - يجب أن يحتوي على رقم أو حرف واحد على الأقل.     * - مسموح بالمسافات .     * - ستتم إزالة المسافة البادئة والزائدة.     * - الأسماء حساسة لحالة الأحرف.     * - يجب ألا يحتوي على `*`، `!`، `؛`، `،`، `{`، `}`، `[`، `]`، `~`.     */الاسم: معرف القاموس؛/** وصف اختياري. */description?: string;/** المسار إلى ملف نص القاموس المخصص. */path: CustomDictionaryPath;/** * يحدد النطاق الذي ستتم فيه إضافة الكلمات إلى القاموس.     * قيم النطاق: `المستخدم`، `مساحة العمل`، `المجلد`.     */النطاق ؟: CustomDictionaryScope | CustomDictionaryScope[];/** * عندما يكون الأمر "صحيحًا"، فلنعلم المدقق الإملائي أنه يمكن إضافة الكلمات إلى هذا القاموس.     */addWords: منطقية؛}