diff --git a/website/docs/en/guide/start/index.mdx b/website/docs/en/guide/start/index.mdx index 193bee806..6f567322a 100644 --- a/website/docs/en/guide/start/index.mdx +++ b/website/docs/en/guide/start/index.mdx @@ -16,7 +16,7 @@ Rslib has the following features: - **Easy to Configure**: Rslib aims to simplify library development by offering ready-to-use build capabilities, enabling developers to kickstart their library projects with minimal configuration. -- **Performance Oriented**: Rslib integrates high-performance Rust-based tools from the community, including Rspack, SWC and Lightning CSS, to deliver first-class build speed and development experience. +- **Performance Oriented**: Rslib integrates high-performance Rust-based tools from the community, including [Rspack](https://rspack.dev/), [SWC](https://swc.rs/) and [Lightning CSS](https://lightningcss.dev/), to deliver first-class build speed and development experience. - **Plugin Ecosystem**: Powered by Rsbuild, Rslib benefits from a lightweight plugin system and a collection of high-quality official plugins. Furthermore, Rsbuild's compatibility with most webpack plugins and all Rspack plugins allows library developers to seamlessly integrate existing community or in-house plugins into their library projects. @@ -39,7 +39,7 @@ The following diagram illustrates the relationship between Rslib and other tools - [rspack-examples](https://github.com/rspack-contrib/rspack-examples): Examples for Rspack, Rsbuild, Rspress and Rsdoctor. - [storybook-rsbuild](https://github.com/rspack-contrib/storybook-rsbuild): Storybook builder powered by Rsbuild. - [rsbuild-plugin-template](https://github.com/rspack-contrib/rsbuild-plugin-template): Use this template to create your own Rsbuild plugin. -- [rstack-design-resources](https://github.com/rspack-contrib/rstack-design-resources): Design resources for Rspack, Rsbuild, Rspress and Rsdoctor. +- [rstack-design-resources](https://github.com/rspack-contrib/rstack-design-resources): Design resources for Rspack, Rsbuild, Rslib, Rspress and Rsdoctor. ## 🧑‍💻 Community diff --git a/website/docs/zh/_meta.json b/website/docs/zh/_meta.json index a89e83d15..28b2cb648 100644 --- a/website/docs/zh/_meta.json +++ b/website/docs/zh/_meta.json @@ -8,15 +8,5 @@ "text": "配置", "link": "/config/", "activeMatch": "/config/" - }, - { - "text": "API", - "link": "/api/javascript-api/core", - "activeMatch": "/api/" - }, - { - "text": "博客", - "link": "/blog/", - "activeMatch": "/blog/" } ] diff --git a/website/docs/zh/config/_meta.json b/website/docs/zh/config/_meta.json new file mode 100644 index 000000000..67215f215 --- /dev/null +++ b/website/docs/zh/config/_meta.json @@ -0,0 +1,17 @@ +[ + { + "type": "file", + "name": "index", + "label": "配置总览" + }, + { + "type": "dir", + "name": "lib", + "label": "Lib 配置" + }, + { + "type": "dir", + "name": "rsbuild", + "label": "Rsbuild 配置" + } +] diff --git a/website/docs/zh/config/index.mdx b/website/docs/zh/config/index.mdx new file mode 100644 index 000000000..503af5c53 --- /dev/null +++ b/website/docs/zh/config/index.mdx @@ -0,0 +1,6 @@ +--- +overview: true +title: 配置总览 +--- + +本页面列出了 Rslib 的所有配置项。详细配置请查阅 [配置 Rslib](/guide/basic/configure-rslib)。 diff --git a/website/docs/zh/config/lib/_meta.json b/website/docs/zh/config/lib/_meta.json new file mode 100644 index 000000000..dfd5c8550 --- /dev/null +++ b/website/docs/zh/config/lib/_meta.json @@ -0,0 +1,15 @@ +[ + "format", + "bundle", + "auto-extension", + "auto-external", + "redirect", + "syntax", + "external-helpers", + "banner", + "footer", + "dts", + "shims", + "id", + "umd-name" +] diff --git a/website/docs/zh/config/lib/auto-extension.mdx b/website/docs/zh/config/lib/auto-extension.mdx new file mode 100644 index 000000000..7d736367a --- /dev/null +++ b/website/docs/zh/config/lib/auto-extension.mdx @@ -0,0 +1 @@ +# lib.autoExtension diff --git a/website/docs/zh/config/lib/auto-external.mdx b/website/docs/zh/config/lib/auto-external.mdx new file mode 100644 index 000000000..5a8277b88 --- /dev/null +++ b/website/docs/zh/config/lib/auto-external.mdx @@ -0,0 +1,5 @@ +--- +overviewHeaders: [2, 3] +--- + +# lib.autoExternal diff --git a/website/docs/zh/config/lib/banner.mdx b/website/docs/zh/config/lib/banner.mdx new file mode 100644 index 000000000..411e019eb --- /dev/null +++ b/website/docs/zh/config/lib/banner.mdx @@ -0,0 +1,5 @@ +--- +overviewHeaders: [2, 3] +--- + +# lib.banner diff --git a/website/docs/zh/config/lib/bundle.mdx b/website/docs/zh/config/lib/bundle.mdx new file mode 100644 index 000000000..da9ef7c32 --- /dev/null +++ b/website/docs/zh/config/lib/bundle.mdx @@ -0,0 +1 @@ +# lib.bundle diff --git a/website/docs/zh/config/lib/dts.mdx b/website/docs/zh/config/lib/dts.mdx new file mode 100644 index 000000000..21394ddcd --- /dev/null +++ b/website/docs/zh/config/lib/dts.mdx @@ -0,0 +1,5 @@ +--- +overviewHeaders: [2, 3] +--- + +# lib.dts diff --git a/website/docs/zh/config/lib/external-helpers.mdx b/website/docs/zh/config/lib/external-helpers.mdx new file mode 100644 index 000000000..0742c9ce4 --- /dev/null +++ b/website/docs/zh/config/lib/external-helpers.mdx @@ -0,0 +1 @@ +# lib.externalHelpers diff --git a/website/docs/zh/config/lib/footer.mdx b/website/docs/zh/config/lib/footer.mdx new file mode 100644 index 000000000..0b90ea4e2 --- /dev/null +++ b/website/docs/zh/config/lib/footer.mdx @@ -0,0 +1,5 @@ +--- +overviewHeaders: [2, 3] +--- + +# lib.footer diff --git a/website/docs/zh/config/lib/format.mdx b/website/docs/zh/config/lib/format.mdx new file mode 100644 index 000000000..a6428bf66 --- /dev/null +++ b/website/docs/zh/config/lib/format.mdx @@ -0,0 +1 @@ +# lib.format diff --git a/website/docs/zh/config/lib/id.mdx b/website/docs/zh/config/lib/id.mdx new file mode 100644 index 000000000..95550af66 --- /dev/null +++ b/website/docs/zh/config/lib/id.mdx @@ -0,0 +1 @@ +# lib.id diff --git a/website/docs/zh/config/lib/index.mdx b/website/docs/zh/config/lib/index.mdx new file mode 100644 index 000000000..b034987cf --- /dev/null +++ b/website/docs/zh/config/lib/index.mdx @@ -0,0 +1 @@ +# Lib 配置 diff --git a/website/docs/zh/config/lib/redirect.mdx b/website/docs/zh/config/lib/redirect.mdx new file mode 100644 index 000000000..3f144c2e4 --- /dev/null +++ b/website/docs/zh/config/lib/redirect.mdx @@ -0,0 +1 @@ +# lib.redirect diff --git a/website/docs/zh/config/lib/shims.mdx b/website/docs/zh/config/lib/shims.mdx new file mode 100644 index 000000000..66bcb9301 --- /dev/null +++ b/website/docs/zh/config/lib/shims.mdx @@ -0,0 +1,5 @@ +--- +overviewHeaders: [2, 3] +--- + +# lib.shims diff --git a/website/docs/zh/config/lib/syntax.mdx b/website/docs/zh/config/lib/syntax.mdx new file mode 100644 index 000000000..89cf6a15a --- /dev/null +++ b/website/docs/zh/config/lib/syntax.mdx @@ -0,0 +1 @@ +# lib.syntax diff --git a/website/docs/zh/config/lib/umd-name.mdx b/website/docs/zh/config/lib/umd-name.mdx new file mode 100644 index 000000000..0ef9a503e --- /dev/null +++ b/website/docs/zh/config/lib/umd-name.mdx @@ -0,0 +1 @@ +# lib.umdName diff --git a/website/docs/zh/config/rsbuild/_meta.json b/website/docs/zh/config/rsbuild/_meta.json new file mode 100644 index 000000000..03c9920bb --- /dev/null +++ b/website/docs/zh/config/rsbuild/_meta.json @@ -0,0 +1,10 @@ +[ + "source", + "output", + "tools", + { + "type": "file", + "name": "plugins", + "label": "plugins" + } +] diff --git a/website/docs/zh/config/rsbuild/index.mdx b/website/docs/zh/config/rsbuild/index.mdx new file mode 100644 index 000000000..6c0b6b446 --- /dev/null +++ b/website/docs/zh/config/rsbuild/index.mdx @@ -0,0 +1 @@ +# Rsbuild 配置 diff --git a/website/docs/zh/config/rsbuild/output.mdx b/website/docs/zh/config/rsbuild/output.mdx new file mode 100644 index 000000000..2580f6310 --- /dev/null +++ b/website/docs/zh/config/rsbuild/output.mdx @@ -0,0 +1 @@ +# output diff --git a/website/docs/zh/config/rsbuild/plugins.mdx b/website/docs/zh/config/rsbuild/plugins.mdx new file mode 100644 index 000000000..5319b531e --- /dev/null +++ b/website/docs/zh/config/rsbuild/plugins.mdx @@ -0,0 +1,3 @@ +import { RsbuildDocBadge } from '@components/RsbuildDocBadge'; + +# plugins diff --git a/website/docs/zh/config/rsbuild/source.mdx b/website/docs/zh/config/rsbuild/source.mdx new file mode 100644 index 000000000..5acc8032f --- /dev/null +++ b/website/docs/zh/config/rsbuild/source.mdx @@ -0,0 +1 @@ +# source diff --git a/website/docs/zh/config/rsbuild/tools.mdx b/website/docs/zh/config/rsbuild/tools.mdx new file mode 100644 index 000000000..896a03e8d --- /dev/null +++ b/website/docs/zh/config/rsbuild/tools.mdx @@ -0,0 +1 @@ +# tools diff --git a/website/docs/zh/guide/_meta.json b/website/docs/zh/guide/_meta.json new file mode 100644 index 000000000..e62cedb42 --- /dev/null +++ b/website/docs/zh/guide/_meta.json @@ -0,0 +1,27 @@ +[ + { + "type": "dir", + "name": "start", + "label": "开始" + }, + { + "type": "dir", + "name": "solution", + "label": "解决方案" + }, + { + "type": "dir", + "name": "basic", + "label": "基础" + }, + { + "type": "dir", + "name": "advanced", + "label": "进阶" + }, + { + "type": "dir", + "name": "migration", + "label": "迁移" + } +] diff --git a/website/docs/zh/guide/advanced/_meta.json b/website/docs/zh/guide/advanced/_meta.json new file mode 100644 index 000000000..c9bbf4c49 --- /dev/null +++ b/website/docs/zh/guide/advanced/_meta.json @@ -0,0 +1,7 @@ +[ + "third-party-deps", + "output-compatibility", + "dts", + "module-federation", + "storybook" +] diff --git a/website/docs/zh/guide/advanced/assets.mdx b/website/docs/zh/guide/advanced/assets.mdx new file mode 100644 index 000000000..97e7d6cbd --- /dev/null +++ b/website/docs/zh/guide/advanced/assets.mdx @@ -0,0 +1 @@ +# 静态资源 diff --git a/website/docs/zh/guide/advanced/css.mdx b/website/docs/zh/guide/advanced/css.mdx new file mode 100644 index 000000000..9db95efe0 --- /dev/null +++ b/website/docs/zh/guide/advanced/css.mdx @@ -0,0 +1 @@ +# 样式 diff --git a/website/docs/zh/guide/advanced/dts.mdx b/website/docs/zh/guide/advanced/dts.mdx new file mode 100644 index 000000000..889b94684 --- /dev/null +++ b/website/docs/zh/guide/advanced/dts.mdx @@ -0,0 +1 @@ +# 类型生成 diff --git a/website/docs/zh/guide/advanced/module-doc.mdx b/website/docs/zh/guide/advanced/module-doc.mdx new file mode 100644 index 000000000..99fbd8297 --- /dev/null +++ b/website/docs/zh/guide/advanced/module-doc.mdx @@ -0,0 +1 @@ +# 模块文档 diff --git a/website/docs/zh/guide/advanced/module-federation.mdx b/website/docs/zh/guide/advanced/module-federation.mdx new file mode 100644 index 000000000..da97a8b7b --- /dev/null +++ b/website/docs/zh/guide/advanced/module-federation.mdx @@ -0,0 +1 @@ +# 模块联邦 diff --git a/website/docs/zh/guide/advanced/monorepo.mdx b/website/docs/zh/guide/advanced/monorepo.mdx new file mode 100644 index 000000000..11636556f --- /dev/null +++ b/website/docs/zh/guide/advanced/monorepo.mdx @@ -0,0 +1 @@ +# Monorepo diff --git a/website/docs/zh/guide/advanced/output-compatibility.mdx b/website/docs/zh/guide/advanced/output-compatibility.mdx new file mode 100644 index 000000000..6d5ceba8f --- /dev/null +++ b/website/docs/zh/guide/advanced/output-compatibility.mdx @@ -0,0 +1 @@ +# 产物兼容性 diff --git a/website/docs/zh/guide/advanced/storybook.mdx b/website/docs/zh/guide/advanced/storybook.mdx new file mode 100644 index 000000000..f4df7e238 --- /dev/null +++ b/website/docs/zh/guide/advanced/storybook.mdx @@ -0,0 +1 @@ +# 使用 Storybook diff --git a/website/docs/zh/guide/advanced/third-party-deps.mdx b/website/docs/zh/guide/advanced/third-party-deps.mdx new file mode 100644 index 000000000..eadfe73a6 --- /dev/null +++ b/website/docs/zh/guide/advanced/third-party-deps.mdx @@ -0,0 +1 @@ +# 处理三方依赖 diff --git a/website/docs/zh/guide/basic/_meta.json b/website/docs/zh/guide/basic/_meta.json new file mode 100644 index 000000000..84caefa98 --- /dev/null +++ b/website/docs/zh/guide/basic/_meta.json @@ -0,0 +1,8 @@ +[ + "cli", + "configure-rslib", + "typescript", + "output-format", + "output-structure", + "upgrade-rslib" +] diff --git a/website/docs/zh/guide/basic/cli.mdx b/website/docs/zh/guide/basic/cli.mdx new file mode 100644 index 000000000..80898d198 --- /dev/null +++ b/website/docs/zh/guide/basic/cli.mdx @@ -0,0 +1 @@ +# 命令行工具 diff --git a/website/docs/zh/guide/basic/configure-rslib.mdx b/website/docs/zh/guide/basic/configure-rslib.mdx new file mode 100644 index 000000000..420cef5b6 --- /dev/null +++ b/website/docs/zh/guide/basic/configure-rslib.mdx @@ -0,0 +1 @@ +# 配置 Rslib diff --git a/website/docs/zh/guide/basic/output-format.mdx b/website/docs/zh/guide/basic/output-format.mdx new file mode 100644 index 000000000..6ac089a5e --- /dev/null +++ b/website/docs/zh/guide/basic/output-format.mdx @@ -0,0 +1 @@ +# 产物输出格式 diff --git a/website/docs/zh/guide/basic/output-structure.mdx b/website/docs/zh/guide/basic/output-structure.mdx new file mode 100644 index 000000000..c18a7339e --- /dev/null +++ b/website/docs/zh/guide/basic/output-structure.mdx @@ -0,0 +1 @@ +# 产物结构 diff --git a/website/docs/zh/guide/basic/typescript.mdx b/website/docs/zh/guide/basic/typescript.mdx new file mode 100644 index 000000000..8b199f180 --- /dev/null +++ b/website/docs/zh/guide/basic/typescript.mdx @@ -0,0 +1 @@ +# 使用 Typescript diff --git a/website/docs/zh/guide/basic/upgrade-rslib.mdx b/website/docs/zh/guide/basic/upgrade-rslib.mdx new file mode 100644 index 000000000..3c34eec28 --- /dev/null +++ b/website/docs/zh/guide/basic/upgrade-rslib.mdx @@ -0,0 +1 @@ +# 升级 Rslib diff --git a/website/docs/zh/guide/faq/_meta.json b/website/docs/zh/guide/faq/_meta.json new file mode 100644 index 000000000..7e1ef5ec4 --- /dev/null +++ b/website/docs/zh/guide/faq/_meta.json @@ -0,0 +1 @@ +["general", "features", "exceptions"] diff --git a/website/docs/zh/guide/faq/exceptions.mdx b/website/docs/zh/guide/faq/exceptions.mdx new file mode 100644 index 000000000..a1263cb27 --- /dev/null +++ b/website/docs/zh/guide/faq/exceptions.mdx @@ -0,0 +1 @@ +# 异常类问题 diff --git a/website/docs/zh/guide/faq/features.mdx b/website/docs/zh/guide/faq/features.mdx new file mode 100644 index 000000000..894d595ae --- /dev/null +++ b/website/docs/zh/guide/faq/features.mdx @@ -0,0 +1 @@ +# 功能类问题 diff --git a/website/docs/zh/guide/faq/general.mdx b/website/docs/zh/guide/faq/general.mdx new file mode 100644 index 000000000..a4ae1f104 --- /dev/null +++ b/website/docs/zh/guide/faq/general.mdx @@ -0,0 +1 @@ +# 通用类问题 diff --git a/website/docs/zh/guide/migration/_meta.json b/website/docs/zh/guide/migration/_meta.json new file mode 100644 index 000000000..d841f9470 --- /dev/null +++ b/website/docs/zh/guide/migration/_meta.json @@ -0,0 +1 @@ +["modernjs-module", "tsup"] diff --git a/website/docs/zh/guide/migration/esbuild.mdx b/website/docs/zh/guide/migration/esbuild.mdx new file mode 100644 index 000000000..1d625c5a9 --- /dev/null +++ b/website/docs/zh/guide/migration/esbuild.mdx @@ -0,0 +1 @@ +# esbuild diff --git a/website/docs/zh/guide/migration/modernjs-module.mdx b/website/docs/zh/guide/migration/modernjs-module.mdx new file mode 100644 index 000000000..e435abd7f --- /dev/null +++ b/website/docs/zh/guide/migration/modernjs-module.mdx @@ -0,0 +1 @@ +# Modern.js Module diff --git a/website/docs/zh/guide/migration/rollup.mdx b/website/docs/zh/guide/migration/rollup.mdx new file mode 100644 index 000000000..37db6ad52 --- /dev/null +++ b/website/docs/zh/guide/migration/rollup.mdx @@ -0,0 +1 @@ +# rollup diff --git a/website/docs/zh/guide/migration/tsup.mdx b/website/docs/zh/guide/migration/tsup.mdx new file mode 100644 index 000000000..befc87dc2 --- /dev/null +++ b/website/docs/zh/guide/migration/tsup.mdx @@ -0,0 +1 @@ +# Tsup diff --git a/website/docs/zh/guide/solution/_meta.json b/website/docs/zh/guide/solution/_meta.json new file mode 100644 index 000000000..d81e0c779 --- /dev/null +++ b/website/docs/zh/guide/solution/_meta.json @@ -0,0 +1 @@ +["nodejs", "react"] diff --git a/website/docs/zh/guide/solution/index.mdx b/website/docs/zh/guide/solution/index.mdx new file mode 100644 index 000000000..b60f2bce7 --- /dev/null +++ b/website/docs/zh/guide/solution/index.mdx @@ -0,0 +1 @@ +# 解决方案 diff --git a/website/docs/zh/guide/solution/nodejs.mdx b/website/docs/zh/guide/solution/nodejs.mdx new file mode 100644 index 000000000..b0b41091a --- /dev/null +++ b/website/docs/zh/guide/solution/nodejs.mdx @@ -0,0 +1 @@ +# Node.js diff --git a/website/docs/zh/guide/solution/react.mdx b/website/docs/zh/guide/solution/react.mdx new file mode 100644 index 000000000..4a55d1124 --- /dev/null +++ b/website/docs/zh/guide/solution/react.mdx @@ -0,0 +1 @@ +# React diff --git a/website/docs/zh/guide/start/_meta.json b/website/docs/zh/guide/start/_meta.json new file mode 100644 index 000000000..ededa64aa --- /dev/null +++ b/website/docs/zh/guide/start/_meta.json @@ -0,0 +1 @@ +["index", "quick-start", "glossary", "npm-packages"] diff --git a/website/docs/zh/guide/start/components/CJS.mdx b/website/docs/zh/guide/start/components/CJS.mdx new file mode 100644 index 000000000..6914198b9 --- /dev/null +++ b/website/docs/zh/guide/start/components/CJS.mdx @@ -0,0 +1 @@ +a module system used in JavaScript, particularly in server-side environments like Node.js. It was created to allow JavaScript to be used outside of the browser by providing a way to manage modules and dependencies. diff --git a/website/docs/zh/guide/start/components/ESM.mdx b/website/docs/zh/guide/start/components/ESM.mdx new file mode 100644 index 000000000..8774f4bc9 --- /dev/null +++ b/website/docs/zh/guide/start/components/ESM.mdx @@ -0,0 +1 @@ +a modern module system introduced in ES2015 that allows JavaScript code to be organized into reusable, self-contained modules. ESM is now the standard for both [browser](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) and [Node.js](https://nodejs.org/api/esm.html) environments, replacing older module systems like [CommonJS (CJS)](https://nodejs.org/api/modules.html) and [AMD](https://requirejs.org/docs/whyamd.html). diff --git a/website/docs/zh/guide/start/components/MF.mdx b/website/docs/zh/guide/start/components/MF.mdx new file mode 100644 index 000000000..9fbaa0a5a --- /dev/null +++ b/website/docs/zh/guide/start/components/MF.mdx @@ -0,0 +1,3 @@ +Module Federation is an architectural pattern for JavaScript application decomposition (similar to microservices on the server-side), allowing you to share code and resources between multiple JavaScript applications (or micro-frontends). + +See [Module Federation](https://rsbuild.dev/guide/advanced/module-federation) for more details. diff --git a/website/docs/zh/guide/start/components/UMD.mdx b/website/docs/zh/guide/start/components/UMD.mdx new file mode 100644 index 000000000..14851f7aa --- /dev/null +++ b/website/docs/zh/guide/start/components/UMD.mdx @@ -0,0 +1 @@ +UMD stands for [Universal Module Definition](https://github.com/umdjs/umd), a pattern for writing JavaScript modules that can work universally across different environments, such as both the browser and Node.js. Its primary goal is to ensure compatibility with the most popular module systems, including AMD (Asynchronous Module Definition), CommonJS (CJS), and browser globals. diff --git a/website/docs/zh/guide/start/features.mdx b/website/docs/zh/guide/start/features.mdx new file mode 100644 index 000000000..bd4eb1984 --- /dev/null +++ b/website/docs/zh/guide/start/features.mdx @@ -0,0 +1 @@ +# 功能导航 diff --git a/website/docs/zh/guide/start/glossary.mdx b/website/docs/zh/guide/start/glossary.mdx new file mode 100644 index 000000000..b8909dd6c --- /dev/null +++ b/website/docs/zh/guide/start/glossary.mdx @@ -0,0 +1 @@ +# 术语表 diff --git a/website/docs/zh/guide/start/index.mdx b/website/docs/zh/guide/start/index.mdx new file mode 100644 index 000000000..f364eecae --- /dev/null +++ b/website/docs/zh/guide/start/index.mdx @@ -0,0 +1,48 @@ +# 介绍 + +Rslib 是一个库开发工具，它基于 [Rsbuild](https://rsbuild.dev/zh/) 精心设计的配置和插件，使库开发者得以复用 webpack 和 Rspack 繁荣的知识和生态系统。 + +Rslib 提供了丰富的构建功能，包括： + +- **多种语言的编译**: TypeScript、JSX、Sass、Less、CSS Modules、Wasm 等。 +- **灵活的构建模式**: Bundle 和 bundleless 模式以满足不同的需求。 +- **多种输出格式**: ESM、CJS 和 UMD 以实现最大兼容性。 +- **类型声明文件生成**: 包括 isolated declarations。 +- **进阶功能**: 模块联邦、资源压缩、PostCSS、Lightning CSS 等。 + +## 🔥 特性 + +Rslib 具备以下特性： + +- **易于配置**: Rslib 旨在通过提供开箱即用的构建能力，简化库的开发，使库开发者能够以最少的配置启动库项目。 + +- **性能优先**: Rslib 集成了社区中基于 Rust 的高性能工具，包括 [Rspack](https://rspack.dev/zh/)、[SWC](https://swc.rs/) 和 [Lightning CSS](https://lightningcss.dev/)，以提供一流的构建速度和开发体验。 + +- **插件生态**: Rslib 基于 Rsbuild 轻量级的插件系统和一系列高质量的官方插件。此外，Rsbuild 兼容大多数的 webpack 插件和所有 Rspack 插件，这意味着库开发者可以无缝集成现有的社区或公司内插件到库项目中。 + +## 🎯 生态 + +Rslib 基于 Rsbuild 实现，并完全复用 Rsbuild 的能力和生态系统。 + +下图说明了 Rsbuild 与生态中其他工具之间的关系： + +![Rspack stack layers](https://assets.rspack.dev/rsbuild/assets/rspack-stack-layers.png) + +## 🦀 链接 + +- [Rspack](https://github.com/web-infra-dev/rspack): 基于 Rust 的高性能打包工具。 +- [Rsbuild](https://github.com/web-infra-dev/rsbuild): 由 Rspack 驱动的构建工具。 +- [Rspress](https://github.com/web-infra-dev/rspress): 基于 Rsbuild 的静态站点生成器。 +- [Rsdoctor](https://github.com/web-infra-dev/rsdoctor): 针对 Rspack 和 webpack 的一站式构建分析工具。 +- [Modern.js](https://github.com/web-infra-dev/modern.js): 基于 Rsbuild 的渐进式 React 框架。 +- [awesome-rspack](https://github.com/web-infra-dev/awesome-rspack): 与 Rspack 和 Rsbuild 相关的精彩内容列表。 +- [rspack-examples](https://github.com/rspack-contrib/rspack-examples): Rspack、Rsbuild、Rspress 和 Rsdoctor 的示例项目。 +- [storybook-rsbuild](https://github.com/rspack-contrib/storybook-rsbuild): 基于 Rsbuild 构建的 Storybook。 +- [rsbuild-plugin-template](https://github.com/rspack-contrib/rsbuild-plugin-template): 使用此模板创建你的 Rsbuild 插件。 +- [rstack-design-resources](https://github.com/rspack-contrib/rstack-design-resources): Rspack、Rsbuild、Rslib、Rspress 和 Rsdoctor 的设计资源。 + +## 🧑‍💻 社区 + +欢迎加入我们的 [Discord](https://discord.gg/XsaKEEk4mW) 交流频道！Rspack / Rsbuild / Rslib 团队和用户都在那里活跃，并且我们一直期待着各种贡献。 + +你也可以加入 [飞书群](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=3c3vca77-bfc0-4ef5-b62b-9c5c9c92f1b4) 与大家一起交流。 diff --git a/website/docs/zh/guide/start/npm-packages.mdx b/website/docs/zh/guide/start/npm-packages.mdx new file mode 100644 index 000000000..84bb11992 --- /dev/null +++ b/website/docs/zh/guide/start/npm-packages.mdx @@ -0,0 +1 @@ +# NPM 包 diff --git a/website/docs/zh/guide/start/quick-start.mdx b/website/docs/zh/guide/start/quick-start.mdx new file mode 100644 index 000000000..1ed038f21 --- /dev/null +++ b/website/docs/zh/guide/start/quick-start.mdx @@ -0,0 +1 @@ +# 快速上手 diff --git a/website/docs/zh/index.mdx b/website/docs/zh/index.mdx index 5a91ec216..806cf2c59 100644 --- a/website/docs/zh/index.mdx +++ b/website/docs/zh/index.mdx @@ -1,4 +1,4 @@ --- pageType: home -titleSuffix: ' - 基于 Rsbuild 的库构建工具' +titleSuffix: ' - 基于 Rsbuild 的库开发工具' --- diff --git a/website/i18n.json b/website/i18n.json index 722fa5439..8ffd38450 100644 --- a/website/i18n.json +++ b/website/i18n.json @@ -9,7 +9,7 @@ }, "subtitle": { "en": "Rsbuild-based Library Development Tool", - "zh": "基于 Rsbuild 的 Library 开发工具" + "zh": "基于 Rsbuild 的库开发工具" }, "slogan": { "en": "Create JavaScript libraries in a simple and intuitive way", diff --git a/website/rspress.config.ts b/website/rspress.config.ts index f4b57772b..f87c33541 100644 --- a/website/rspress.config.ts +++ b/website/rspress.config.ts @@ -53,23 +53,28 @@ export default defineConfig({ text: '📝 Edit this page on GitHub', }, }, - // { - // lang: 'zh', - // label: '简体中文', - // title: 'Rslib', - // outlineTitle: '目录', - // prevPageText: '上一页', - // nextPageText: '下一页', - // searchPlaceholderText: '搜索文档', - // searchNoResultsText: '无法找到相关搜索结果', - // searchSuggestedQueryText: '请使用不同的关键字重试', - // description: '基于 Rsbuild 的库构建工具', - // editLink: { - // docRepoBaseUrl: - // 'https://github.com/web-infra-dev/rslib/tree/main/website/docs', - // text: '📝 在 GitHub 上编辑此页', - // }, - // }, + { + lang: 'zh', + label: '简体中文', + title: 'Rslib', + outlineTitle: '目录', + prevPageText: '上一页', + nextPageText: '下一页', + searchPlaceholderText: '搜索文档', + searchNoResultsText: '无法找到相关搜索结果', + searchSuggestedQueryText: '请使用不同的关键字重试', + description: '基于 Rsbuild 的库构建工具', + overview: { + filterNameText: '过滤', + filterPlaceholderText: '输入关键词', + filterNoResultText: '未找到匹配的 API', + }, + editLink: { + docRepoBaseUrl: + 'https://github.com/web-infra-dev/rslib/tree/main/website/docs', + text: '📝 在 GitHub 上编辑此页', + }, + }, ], }, builderConfig: { diff --git a/website/theme/index.tsx b/website/theme/index.tsx index 1cbc79675..ae0bef88d 100644 --- a/website/theme/index.tsx +++ b/website/theme/index.tsx @@ -5,8 +5,6 @@ import Theme from 'rspress/theme'; import { HomeLayout } from './pages'; import './index.scss'; -const ANNOUNCEMENT_URL = '/'; - const Layout = () => { const { page } = usePageData(); const lang = useLang(); @@ -16,14 +14,10 @@ const Layout = () => { beforeNav={ }