واجهة سطر الأوامر (CLI) للتحقق من صحة صفحات HTML باستخدام validator.w3.org.
html-w3c-validator عبارة عن أداة CLI للتحقق من صحة صفحات HTML باستخدام validator.w3.org.
يمكنك استخدام إطار عمل JavaScript أو ببساطة استخدام HTML ولكن يجب عليك دائمًا التحقق من صحة HTML الخاص بالإنتاج ويجب أن يكون هذا التحقق جزءًا من مسار CI/CD (الاختبارات والفحص وما إلى ذلك).
اقتباس من https://validator.w3.org/docs/help.html#why-validate:
أحد المبادئ المهمة لبرمجة الكمبيوتر هو: "كن محافظًا فيما تنتجه، وكن ليبراليًا فيما تقبله".
تتبع المتصفحات النصف الثاني من هذا المبدأ من خلال قبول صفحات الويب ومحاولة عرضها حتى لو لم تكن HTML قانونية. يعني هذا عادةً أن المتصفح سيحاول إجراء تخمينات مدروسة حول ما تقصده على الأرجح. تكمن المشكلة في أن المتصفحات المختلفة (أو حتى الإصدارات المختلفة من نفس المتصفح) ستقدم تخمينات مختلفة حول نفس البنية غير القانونية؛ والأسوأ من ذلك، إذا كان HTML الخاص بك مرضيًا حقًا، فقد يرتبك المتصفح بشكل ميؤوس منه وينتج عنه فوضى مشوهة، أو حتى يتعطل.
يمكنك دمج html-w3c-validator مع start-server-and-test للتحقق من صحة صفحات HTML الخاصة بمشروعك.
Node.js >= 16.0.0
npm install --save-dev html-w3c-validator start-server-and-test
package.json
{
"scripts" : {
// Command to start the server serving your HTML pages (e.g: using vercel/serve)
"start" : "serve "./build"" ,
// Command to validate your HTML pages
"test:html-w3c-validator" : "start-server-and-test "start" "http://127.0.0.1:3000" "html-w3c-validator"" ,
} ,
}
.html-w3c-validatorrc.json
{
"$schema" : "./node_modules/html-w3c-validator/schema/schema.json" ,
// URLs to validate.
"urls" : [ "http://127.0.0.1:3000/" , "http://127.0.0.1:3000/about" ] ,
// Files to validate.
"files" : [ "./index.html" , "./about.html" ] ,
// Specify the severities of the validator messages to report. (default: ["warning", "error"])
"severities" : [ "info" , "warning" , "error" ] ,
}
node --run test:html-w3c-validator
مثال على الإخراج (في حالة النجاح):
✔ Validating http://127.0.0.1:3000/
✔ Validating http://127.0.0.1:3000/about
Success: HTML validation (W3C) passed! ?
راجع المجلد ./example للاستخدام العملي.
--current-working-directory <path> The current working directory (default: `process.cwd()`).
-V, --version Output the version number.
-h, --help Display help for command.
يمكن لأي شخص المساعدة في تحسين المشروع أو إرسال طلب ميزة أو تقرير خطأ أو حتى تصحيح خطأ إملائي بسيط.
يمكن العثور على خطوات المساهمة في ملف CONTRIBUTING.md.
معهد ماساتشوستس للتكنولوجيا