Intlayer 配置文档
概述
Intlayer 配置文件允许自定义插件的各种方面,例如国际化、中间件和内容处理。本文件提供配置中每个属性的详细描述。
配置文件支持
Intlayer 接受 JSON、JS、MJS 和 TS 配置文件格式:
- intlayer.config.ts
- intlayer.config.js
- intlayer.config.json
- intlayer.config.cjs
- intlayer.config.mjs
- .intlayerrc
示例配置文件
intlayer.config.ts
import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = { internationalization: { locales: [Locales.ENGLISH], }, content: { typesDir: "content/types", }, middleware: { noPrefix: false, },};export default config;
配置参考
以下部分描述 Intlayer 可用的各种配置设置。
国际化配置
定义与国际化相关的设置,包括可用的语言环境和应用程序的默认语言环境。
属性
- locales:
- 类型: string[]
- 默认: ['zh']
- 描述: 应用程序中支持的语言环境列表。
- 示例: ['zh', 'fr', 'es']
strictMode:
- 类型: string
- 默认: required_only
- 描述: 使用 TypeScript 确保国际化内容的强,实现。
- 注意: 如果设置为 "strict",翻译 t 函数将要求每个声明的语言环境都被定义。如果缺少一个语言环境,或者在您的配置中没有声明某个语言环境,它将抛出一个错误。
- 注意: 如果设置为 "required_only",翻译 t 函数将要求每个声明的语言环境都被定义。如果缺少一个语言环境,它将抛出一个警告。但如果一个语言环境在您的配置中没有声明,但存在,它将被接受。
- 注意: 如果设置为 "loose",翻译 t 函数将接受任何现有的语言环境。
defaultLocale:
- 类型: string
- 默认: 'zh'
- 描述: 用作后备的默认语言环境,如果请求的语言环境未找到。
- 示例: 'zh'
- 注意: 这用于确定在 URL、cookie 或标头中未指定时的语言环境。
编辑器配置
定义与集成编辑器相关的设置,包括服务器端口和活动状态。
属性
backendURL:
- 类型: string
- 默认: https://back.intlayer.org
- 描述: 后端服务器的 URL。
- 示例: http://localhost:4000
enabled:
- 类型: boolean
- 默认: true
- 描述: 指示编辑器是否处于活动状态。
- 示例: true
- 注意: 可以使用 NODE_ENV 或其他专用环境变量设置
clientId:
- 类型: string | undefined
- 默认: undefined
- 描述: clientId 和 clientSecret 允许 intlayer 包使用 oAuth2 身份验证与后端进行身份验证。访问令牌用于验证与项目相关的用户。要获取访问令牌,请访问 /dashboard/project 并创建一个账户。
- 示例: true
- 注意: 重要:clientId 和 clientSecret 应保持机密,不应公开共享。请确保将其保存在安全的位置,例如环境变量。
clientSecret:
- 类型: string | undefined
- 默认: undefined
- 描述: clientId 和 clientSecret 允许 intlayer 包使用 oAuth2 身份验证与后端进行身份验证。访问令牌用于验证与项目相关的用户。要获取访问令牌,请访问 /dashboard/project 并创建一个账户。
- 示例: true
- 注意: 重要:clientId 和 clientSecret 应保持机密,不应公开共享。请确保将其保存在安全的位置,例如环境变量。
中间件配置
控制中间件行为的设置,包括应用程序如何处理 cookie、标头和语言环境管理的 URL 前缀。
属性
- headerName:
- 类型: string
- 默认: 'x-intlayer-locale'
- 描述: 用于确定语言环境的 HTTP 标头的名称。
- 示例: 'x-custom-locale'
- 注意: 这对于基于 API 的语言环境确定很有用。
- cookieName:
- 类型: string
- 默认: 'intlayer-locale'
- 描述: 用于存储语言环境的 cookie 的名称。
- 示例: 'custom-locale'
- 注意: 用于在会话之间持久化语言环境。
- prefixDefault:
- 类型: boolean
- 默认: true
- 描述: 是否在 URL 中包含默认语言环境。
- 示例: false
- 注意: 如果 false,默认语言环境的 URL 将没有语言环境前缀。
- basePath:
- 类型: string
- 默认: ''
- 描述: 应用程序 URL 的基本路径。
- 示例: '/my-app'
- 注意: 这会影响应用程序 URL 的构建方式。
- serverSetCookie:
- 类型: string
- 默认: 'always'
- 描述: 在服务器上设置语言环境 cookie 的规则。
- 选项: 'always', 'never'
- 示例: 'never'
- 注意: 控制是在每次请求时设置语言环境 cookie 还是从不设置。
- noPrefix:
- 类型: boolean
- 默认: false
- 描述: 是否从 URLs 中省略语言环境前缀。
- 示例: true
- 注意: 如果 true,URL 将不包含语言环境信息。
内容配置
与应用程序中的内容处理相关的设置,包括目录名称、文件扩展名和派生配置。
属性
- watch:
- 类型: boolean
- 默认: process.env.NODE_ENV === 'development'
- 描述: 指示 Intlayer 是否应监视应用程序中的内容声明文件的更改以重新构建相关字典。
- fileExtensions:
- 类型: string[]
- 默认: ['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']
- 描述: 构建字典时要查找的文件扩展名。
- 示例: ['.data.ts', '.data.js', '.data.json']
- 注释: 自定义文件扩展名可以帮助避免冲突。
- baseDir:
- 类型: string
- 默认: process.cwd()
- 描述: 项目的基本目录。
- 示例: '/path/to/project'
- 注意: 这用于解析所有与 Intlayer 相关的目录。
- dictionaryOutput:
- 类型: string[]
- 默认: ['intlayer']
- 描述: 要使用的字典输出类型,例如 'intlayer' 或 'i18next'。
- contentDirName:
- 类型: string
- 默认: 'src'
- 描述: 存放内容的目录名称。
- 示例: 'data', 'content', 'locales'
- 注意: 如果不在基本目录级别,请更新 contentDir。
contentDir:
- 类型: string
- 派生自: 'baseDir' / 'contentDirName'
- 描述: 存放内容的目录路径。
- resultDirName:
- 类型: string
- 默认: '.intlayer'
- 描述: 存放结果的目录名称。
- 示例: 'outputOFIntlayer'
- 注意: 如果此目录不在基级别,请更新 resultDir。
resultDir:
- 类型: string
- 派生自: 'baseDir' / 'resultDirName'
- 描述: 存放中间或输出结果的目录路径。
moduleAugmentationDirName:
- 类型: string
- 默认: 'types'
- 描述: 用于模块增强的目录,允许更好的 IDE 建议和类型检查。
- 示例: 'intlayer-types'
- 注意: 确保将其包含在 tsconfig.json 中。
moduleAugmentationDir:
- 类型: string
- 派生自: 'baseDir' / 'moduleAugmentationDirName'
- 描述: 模块增强和额外类型定义的路径。
- dictionariesDirName:
- 类型: string
- 默认: 'dictionary'
- 描述: 存放字典的目录。
- 示例: 'translations'
- 注意: 如果不在结果目录级别,请更新 dictionariesDir。
dictionariesDir:
- 类型: string
- 派生自: 'resultDir' / 'dictionariesDirName'
- 描述: 存放本地化字典的目录。
- i18nextResourcesDirName:
- 类型: string
- 默认: 'i18next_dictionary'
- 描述: 存放 i18n 字典的目录。
- 示例: 'translations'
- 注意: 如果不在结果目录级别,请更新 i18nextResourcesDir。
- 注意: 确保 i18n 字典输出包括 i18next 以构建 i18next 的字典。
i18nextResourcesDir:
- 类型: string
- 派生自: 'resultDir' / 'i18nextResourcesDirName'
- 描述: 存放 i18n 字典的目录。
- 注意: 确保此目录为 i18next 输出类型配置。
typeDirName:
- 类型: string
- 默认: 'types'
- 描述: 存放字典类型的目录。
- 示例: 'intlayer-types'
- 注意: 如果不在结果目录级别,请更新 typesDir。
typesDir:
- 类型: string
- 派生自: 'resultDir' / 'typeDirName'
- 描述: 存放字典类型的目录。
- mainDirName:
- 类型: string
- 默认: 'main'
- 描述: 存放主要文件的目录。
- 示例: 'intlayer-main'
- 注意: 如果不在结果目录级别,请更新 mainDir。
- mainDir:
- 类型: string
- 派生自: 'resultDir' / 'mainDirName'
- 描述: 存放主要应用程序文件的目录。
- excludedPath:
- 类型: string[]
- 默认: ['node_modules']
- 描述: 从内容搜索中排除的目录。
- 注意: 此设置尚未使用,但计划在将来实现。
日志记录配置
控制日志记录的设置,包括日志级别和使用的前缀。
属性
- enabled:
- 类型: boolean
- 默认: true
- 描述: 指示日志记录器是否启用。
- 示例: true
- 注意: 可以使用 NODE_ENV 或其他专用环境变量设置。
- level:
- 类型: 'info' | 'warn' | 'debug' | 'log'
- 默认: 'log'
- 描述: 日志记录器的级别。
- 示例: 'info'
- 注意: 日志记录器的级别。可以是 'log'、'info'、'warn'、'error' 或 'debug'。
- prefix:
- 类型: string
- 默认: '[intlayer] '
- 描述: 日志记录器的前缀。
- 示例: '[my custom prefix] '
- 注意: 日志记录器的前缀。
如果您有改善此文档的想法,请随时通过在GitHub上提交拉取请求来贡献。
文档的 GitHub 链接