块编辑器开发文档

@wordpress/npm-package-json-lint-config

💡 云策文档标注

概述

本文档介绍了 @wordpress/npm-package-json-lint-config,一个用于 npm-package-json-lint 的 WordPress 可共享配置包。它提供了安装、使用和自定义规则的指南,适用于 WordPress 开发者以标准化 package.json 文件。

关键要点

  • 安装包需使用 npm install @wordpress/npm-package-json-lint-config,并确保 Node.js 版本为长期支持版。
  • 使用方式包括在 package.json 或 .npmpackagejsonlintrc.json 文件中通过 extends 字段引用此配置。
  • 支持自定义规则,可在配置中添加或覆盖 npm-package-json-lint 规则,例如 valid-values-author 或 require-publishConfig。
  • 此包是 Gutenberg 项目的一部分,采用 monorepo 结构,鼓励贡献者参考项目贡献指南。

代码示例

"npmpackagejsonlint": {
    "extends": "@wordpress/npm-package-json-lint-config",
    "rules": {
        "valid-values-author": [
            "error",
            [
                "WordPress"
            ]
        ]
    }
}

注意事项

此包要求 Node.js 版本为长期支持版(Active LTS 或 Maintenance LTS),不兼容旧版本。


📄 原文内容

WordPress npm-package-json-lint shareable configuration.

Installation

Install the module

$ npm install @wordpress/npm-package-json-lint-config

Note: This package requires Node.js version with long-term support status (check Active LTS or Maintenance LTS releases). It is not compatible with older versions.

Usage

Add this to your package.json file:

"npmpackagejsonlint": {
    "extends": "@wordpress/npm-package-json-lint-config",
},

Or to a .npmpackagejsonlintrc.json file in the root of your repo:

{
    "extends": "@wordpress/npm-package-json-lint-config"
}

To add, modify, or override any npm-package-json-lint rules add this to your package.json file:

"npmpackagejsonlint": {
    "extends": "@wordpress/npm-package-json-lint-config",
    "rules": {
        "valid-values-author": [
            "error",
            [
                "WordPress"
            ]
        ]
    }
},

Or to a .npmpackagejsonlintrc.json file in the root of your repo:

{
    "extends": "@wordpress/npm-package-json-lint-config",
    "rules": {
        "require-publishConfig": "error",
        "valid-values-author": [ "error", [ "WordPress" ] ]
    }
}

Contributing to this package

This is an individual package that’s part of the Gutenberg project. The project is organized as a monorepo. It’s made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to npm and used by WordPress as well as other software projects.

To find out more about contributing to this package or Gutenberg as a whole, please read the project’s main contributor guide.