feat: 优化初始化表单样式&文案 || 优化 rss 订阅生成字段取值

Mereithhh · Sep 4, 2022 · 43d0c93 · 43d0c93
1 parent 5c3a085
commit 43d0c93
Show file tree

Hide file tree

Showing 5 changed files with 41 additions and 10 deletions.
diff --git a/docs/feature/advance/rss.md b/docs/feature/advance/rss.md
@@ -29,3 +29,13 @@ PS：但我没找到不增加额外组件优雅的实现后端渲染 `mermaid`
 您可以在后台的 `布局设置` 中关闭此选择，关闭后前台所有位置都将不会显示 `RSS` 按钮。
 
 PS：因为按钮太多了，所以小尺寸的后台按钮放到抽屉导航栏中了。
+
+## 注意
+
+RSS 订阅中的作者邮箱优先取自 `评论设置` 中的作者邮箱，其次是启动 `VanBlog` 时传递的 `EMAIL` 环境变量。
+
+订阅中的 `favicon` 和 `images` 属性的优先级如下：
+
+![](https://www.mereith.com/static/img/27f6636bfe5a53cf51544ab8affd6961.clipboard-2022-09-04.png)
+
+订阅中每篇文章的 `description` 字段取自每篇文章 `more 标记` 前面的部分 （`<!-- more -->`前面的部分，和前台阅读全文前的展示逻辑一样）。但如果没有 `more 标记`，则会用截取整篇文章。
diff --git a/docs/feature/basic/setting.md b/docs/feature/basic/setting.md
@@ -22,7 +22,7 @@ title: 站点设置
 | 网站图标  | 是   | 浏览器标签的图标                       |
 | 网站名    | 是   | 会展示在浏览器标签和友链中的本站信息上 |
 | 网站描述  | 是   | 会展示在友链中的本站信息上，并用于 SEO |
-| 网站 Url  | 是   | 会被前后台用来展示一些跳转的链接       |
+| 网站 Url  | 是   | 会被前后台用来展示一些跳转的链接以及作为 RSS 订阅中的链接基址      |
 
 ![](https://pic.mereith.com/img/2c4254e19beaad471b275e897ff54fbe.clipboard-2022-08-15.png)
 

diff --git a/packages/admin/src/components/SiteInfoForm/index.tsx b/packages/admin/src/components/SiteInfoForm/index.tsx
@@ -195,7 +195,7 @@ export default function (props: {
               true: '显示',
               false: '隐藏',
             }}
-            tooltip={'默认隐藏，如果显示的是网站名，开启此项可能会对不齐。'}
+            tooltip={'默认隐藏，开启后将在主导航栏下方显示分类子导航栏（其实就是双层导航栏）。'}
           ></ProFormSelect>
 
           <ProFormDigit
@@ -216,7 +216,7 @@ export default function (props: {
               siteName: '网站名',
             }}
             placeholder="网站名"
-            tooltip={'显示网站logo的前提是已设置正确的网站logo哦。默认显示网站名'}
+            tooltip={'显示网站 logo 的前提是已设置正确的网站 logo 哦。默认显示网站名'}
           ></ProFormSelect>
           <ProFormSelect
             name={'showAdminButton'}
@@ -226,7 +226,7 @@ export default function (props: {
               true: '显示',
               false: '隐藏',
             }}
-            tooltip={'默认显示，关闭后导航栏会隐藏后台按钮'}
+            tooltip={'默认显示，关闭后前台会隐藏后台按钮'}
           ></ProFormSelect>
           <ProFormSelect
             name={'showFriends'}
@@ -236,7 +236,7 @@ export default function (props: {
               true: '显示',
               false: '隐藏',
             }}
-            tooltip={'默认显示，关闭后导航栏会隐藏友情链接'}
+            tooltip={'默认显示，关闭后导航栏会隐藏友情链接入口'}
           ></ProFormSelect>
           <ProFormSelect
             name={'showDonateInfo'}

diff --git a/packages/admin/src/pages/InitPage/index.tsx b/packages/admin/src/pages/InitPage/index.tsx
@@ -24,7 +24,11 @@ const InitPage = () => {
           title={
             <div>
               <p style={{ fontSize: 20, marginBottom: 0 }}>欢迎使用 VanBlog 个人博客系统</p>
-              <a target={'_blank'} rel="noreferrer" href="https://vanblog.mereith.com">
+              <a
+                target={'_blank'}
+                rel="noreferrer"
+                href="https://vanblog.mereith.com/feature/basic/setting.html"
+              >
                 帮助文档
               </a>
             </div>
@@ -60,6 +64,11 @@ const InitPage = () => {
             }}
           >
             <StepsForm.StepForm name="step1" title="配置用户">
+              <Alert
+                type="info"
+                message="初始化页面所有配置都可在初始化后进入后台修改。"
+                style={{ marginBottom: 8 }}
+              ></Alert>
               <ProFormText
                 name="name"
                 required={true}
@@ -78,7 +87,8 @@ const InitPage = () => {
             <StepsForm.StepForm name="step2" title={'基本配置'} formRef={formRef1}>
               <Alert
                 type="info"
-                message="默认的上传图片会到内置图床，如需配置 oss 图床，可在初始化后去设置页更改。"
+                message="默认的上传图片会到内置图床，如需配置 oss 图床，可在初始化后去设置页更改。初始化页面所有配置都可在初始化后进入后台修改。"
+                style={{ marginBottom: 8 }}
               ></Alert>
               <SiteInfoForm
                 showRequire={true}
@@ -91,7 +101,8 @@ const InitPage = () => {
             <StepsForm.StepForm name="step3" title={'高级配置'} formRef={formRef2}>
               <Alert
                 type="info"
-                message="默认的上传图片会到内置图床，如需配置 oss 图床，可在初始化后去设置页更改。"
+                message="默认的上传图片会到内置图床，如需配置 oss 图床，可在初始化后去设置页更改。初始化页面所有配置都可在初始化后进入后台修改。"
+                style={{ marginBottom: 8 }}
               ></Alert>
               <SiteInfoForm
                 showRequire={false}
@@ -102,6 +113,11 @@ const InitPage = () => {
               />
             </StepsForm.StepForm>
             <StepsForm.StepForm name="step4" title={'布局配置'}>
+              <Alert
+                type="info"
+                message="初始化页面所有配置都可在初始化后进入后台修改。"
+                style={{ marginBottom: 8 }}
+              ></Alert>
               <SiteInfoForm
                 isInit={true}
                 showRequire={false}

diff --git a/packages/server/src/provider/rss/rss.provider.ts b/packages/server/src/provider/rss/rss.provider.ts
@@ -43,11 +43,16 @@ export class RssProvider {
       link: meta.siteInfo.baseUrl,
     };
     const siteUrl = new URL(meta.siteInfo.baseUrl).toString();
-    const siteLogo =
+    const favicon =
       meta.siteInfo.favicon ||
       meta.siteInfo.siteLogo ||
       meta.siteInfo.authorLogo ||
       `${siteUrl}logo.svg`;
+    const siteLogo =
+      meta.siteInfo.siteLogo ||
+      meta.siteInfo.authorLogo ||
+      meta.siteInfo.favicon ||
+      `${siteUrl}logo.svg`;
     const date = new Date();
     const feed = new Feed({
       title: meta.siteInfo.siteName,
@@ -56,7 +61,7 @@ export class RssProvider {
       link: siteUrl,
       language: '	zh-cn',
       image: siteLogo,
-      favicon: siteLogo,
+      favicon: favicon,
       copyright: `All rights reserved ${date.getFullYear()}, ${
         meta.siteInfo.author
       }`,