safwan/stdf

介绍

感谢你使用 STDF。

以下是关于向 STDF 提交反馈或代码的指南。在向 STDF 提交 issue 或者 PR 之前，请先花几分钟时间阅读以下内容。

在进行本地开发前，请先确保你的开发环境中安装了 Git 与 Node.js。

调试 STDF 必须要有个工程环境，为此提供了一个简单的 Demo 工程。STDF 本身不受 Node 版本限制，Demo 使用 Vite 开发，所以请确保你的 Node.js 版本 >= 14.18+，参考 Vite 官网。

推荐：使用 pnpm 进行包管理；安装针对 Svelte 的 VSCode 插件或者 WebStorm 插件进行开发；安装针对 Tailwind 的 VSCode 插件，WebStorm 默认集成，了解更多。

按照下面的步骤操作，即可在本地快速启动 STDF Demo。

## 克隆 STDF Demo 仓库
git clone git@github.com:dufu1991/demo-stdf.git

## 进入项目目录
cd demo-stdf

## 安装依赖
pnpm i
## or
npm i

## 启动项目
npm run dev

启动成功之后，可在浏览器中打开 http://localhost:8888 查看效果，请将浏览器的开发者工具切换为移动端模式。

针对 Demo 内的组件，可以在 node_modules/stdf/src 目录下找到对应文件进行修改并实时查看修改效果。注意，VS Code 与 WebStorm 都支持在调用组件时直接跳转到组件源码。

如果此仓库的 STDF 不是最新版本，请先升级到最新版本。

如果不想本地开发，可以选择使用 StackBlitz 在线简单调试。直接打开 STDF Demo 即可开始在线调试。

如果你是第一次在 GitHub 上提 Pull Request ，可以阅读下面这两篇文章来学习：

请先 fork 一份 STDF (https://github.com/dufu1991/stdf) 到自己的仓库，如果已经 fork 过，请同步主仓库的最新代码。
基于 fork 后仓库的 main 分支新建一个分支，比如 feature/add_Loading_type，克隆至本地。
将上述 Demo 工程中内 node_modules/stdf/src 下修改并验证通过的组件文件复制到新分支中 components/src 对应目录下。
补充此次修改的中英文档中，文档位于 doc/components 目录下。根据具体修改内容可能需要修改 api、FAQ、guide、version 等文档。对 version 的修改请增加 tag，具体参考 STDF Version tag。
提 Pull Request 到主仓库的 main 分支。
Pull Request 会在 Review 通过后被合并到主仓库，并发布新版本至 npm。

在提交 Pull Request 时，请注意：