Skip to content

cellbang/style-guide

Repository files navigation

The Cellbang Style Guide

npm version npm downloads license

介绍

本存储库是 Cellbang 风格指南的所在地,其中包括以下配置:

安装

我们的所有配置都包含在一个包@celljs/style-guide中。安装命令如下:

# If you use npm
npm i --save-dev @celljs/style-guide

# If you use pmpm
pnpm i --save-dev @celljs/style-guide

# If you use Yarn
yarn add --dev @celljs/style-guide

我们的一些 ESLint 配置需要 peer 依赖。具体内容可以查看 ESLint

Prettier

注意:Prettier 是此软件包的对等依赖项,应安装 在项目的根目录下。

请参阅:https://prettier.io/docs/en/install.html

要使用共享 Prettier 配置,请在 package.json 中设置以下内容。

{
  "prettier": "@celljs/style-guide/prettier"
}

ESLint

注意:ESLint 是此软件包的 peer 依赖项,应安装 在项目的根目录下。

请参阅:https://eslint.org/docs/user-guide/getting-started#installation-and-usage

此 ESLint 配置被设计为可组合的,且要求 ESLint 版本为:^9.0.0。

以下基本配置可用。您可以使用其中之一或两者 配置,但它们应该始终位于配置数组中的第一个:

  • @celljs/style-guide/eslint/base
  • @celljs/style-guide/eslint/errors

请注意,您可以设置配置范围,以便配置仅针对特定文件。

以下附加配置可用:

  • @celljs/style-guide/eslint(所有配置)
  • @celljs/style-guide/eslint/base (基础配置)
  • @celljs/style-guide/eslint/errors(错误级别的配置)
  • @celljs/style-guide/eslint/build(构建级别的配置,包括基础和错误级别的配置)
  • @celljs/style-guide/eslint/warnings(警告级别的配置)
  • @celljs/style-guide/eslint/xxs(跨站脚本攻击相关的配置)

由于围绕 ESLint 配置解析的问题(请参阅 eslint/eslint#9188

例如,一个简单的项目复用 ESLint 配置,配置如下

module.exports = [
  ...require('@celljs/style-guide/eslint')
];

当然,也可以更具情况选择具体级别的一个或多个配置。

module.exports = [
  ...require('@celljs/style-guide/eslint/base'),
  ...require('@celljs/style-guide/eslint/errors')
];

如果是一个纯 javascript 项目,配置如下:

module.exports = [
  ...require('@celljs/style-guide/eslint/javascript')
];

TypeScript

要使用共享 TypeScript 配置,请在 tsconfig.json 中设置以下内容。

{
  "extends": "@celljs/style-guide/typescript"
}