feat: |Doc| add Google ads doc (#598)

README.md

@@ -56,25 +56,26 @@
   - [查看部署文档](#查看部署文档)
   - [CHANGELOG](#changelog)
   - [在线演示](#在线演示)
-  - [功能/TODO](#功能todo)
+  - [功能](#功能)
   - [Reference](#reference)
   - [Join Community](#join-community)
 
-## 功能/TODO
+## 功能
 
-- [x] 使用 `password` 重新登录之前的邮箱
+- [x] 使用 `rust wasm` 解析邮件, 解析速度快, 几乎所有邮件都能解析, node 的解析模块解析邮件失败的邮件, rust wasm 也能解析成功
+- [x] 使用 `凭证` 重新登录之前的邮箱
+- [x] 添加完整的用户注册登录功能，可绑定邮箱地址，绑定后可自动获取邮箱JWT凭证切换不同邮箱
+- [x] 前后台均支持多语言
 - [x] 获取自定义名字的邮箱，`admin` 可配置黑名单
-- [x] 支持多语言
 - [x] 增加访问密码，可作为私人站点
+- [x] admin 控制台
 - [x] 增加自动回复功能
 - [x] 增加查看 `附件` 功能
-- [x] 使用 `rust wasm` 解析邮件
 - [x] 支持发送邮件
 - [x] 支持 `DKIM`
 - [x] `admin` 后台创建无前缀邮箱
 - [x] 添加 `SMTP proxy server`，支持 `SMTP` 发送邮件, `IMAP` 查看邮件
-- [x] 添加完整的用户注册登录功能，可绑定邮箱地址，绑定后可自动获取邮箱JWT凭证切换不同邮箱
+- [x] 完整的 `Telegram Bot` 支持，以及 `Telegram` 推送, Telegram Bot 小程序
-- [x] `Telegram Bot` 使用，以及 `Telegram` 推送
 
 ## Reference
 

vitepress-docs/docs/.vitepress/zh.ts

@@ -151,6 +151,7 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] {
                 { text: '新建邮箱地址 API', link: 'feature/new-address-api' },
                 { text: 'Oauth2 第三方登录', link: 'feature/user-oauth2' },
                 { text: '配置其他worker增强', link: 'feature/another-worker-enhanced' },
+                { text: '给网页增加 Google Ads', link: 'feature/google-ads.md' },
             ]
         },
         {

vitepress-docs/docs/zh/guide/cli/pages.md

@@ -22,7 +22,7 @@ cp .env.example .env.prod
 
 ```bash
 pnpm build --emptyOutDir
-# 根据提示创建 pages
+# 第一次部署会提示创建项目, production 分支请填写 production
 pnpm run deploy
 ```
 

vitepress-docs/docs/zh/guide/feature/google-ads.md

@@ -0,0 +1,29 @@
+# 给网页增加 Google Ads
+
+## 命令行部署
+
+修改 `.env.prod` 文件
+
+增加下列两个变量, 具体的值请参考 [Google AdSense](https://www.google.com/adsense/start/) 的说明
+
+```txt
+VITE_GOOGLE_AD_CLIENT=ca-pub-123456
+VITE_GOOGLE_AD_SLOT=123456
+```
+
+然后执行下列命令, 重新部署 pages 即可.
+
+```bash
+pnpm build --emptyOutDir
+# 第一次部署会提示创建项目, production 分支请填写 production
+pnpm run deploy
+```
+
+## GitHub Action 部署
+
+修改 `FRONTEND_ENV`, 增加下列两个变量, 具体的值请参考 [Google AdSense](https://www.google.com/adsense/start/) 的说明, 重新部署 pages 即可.
+
+```txt
+VITE_GOOGLE_AD_CLIENT=ca-pub-123456
+VITE_GOOGLE_AD_SLOT=123456
+```