From 717953039922a8e4d5e6f1b9b4b1c696bed0cdef Mon Sep 17 00:00:00 2001 From: Imken Luo Date: Fri, 25 Aug 2023 13:46:46 +0800 Subject: [PATCH] mention that SSR is experimental and incomplete --- README.md | 2 +- ssr.md | 14 ++++++++------ 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index e4333d5..d68b998 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ docsify 可以快速帮你生成文档网站。不同于 GitBook、Hexo 的地 - 丰富的 API - 支持 Emoji - 兼容 IE11 -- 支持服务端渲染 SSR ([示例](https://github.com/docsifyjs/docsify-ssr-demo)) +- 实验性服务端渲染(SSR)支持 ([示例](https://github.com/docsifyjs/docsify-ssr-demo)) ## 示例 diff --git a/ssr.md b/ssr.md index 09cabdf..062a28b 100644 --- a/ssr.md +++ b/ssr.md @@ -1,14 +1,18 @@ # 服务端渲染(SSR) -先看例子 https://docsify.now.sh +!> :construction: SSR 支持是实验性的并且尚未完成。我们仍在继续开发。插件和部分 docsify 的特性在 SSR 模式中无法使用。 :construction: -项目地址在 https://github.com/docsifyjs/docsify-ssr-demo + -![](https://dn-mhke0kuv.qbox.me/2bfef08c592706108055.png) +示例项目地址 https://github.com/docsifyjs/docsify-ssr-demo 文档依旧是部署在 GitHub Pages 上,Node 服务部署在 now.sh 里,渲染的内容是从 GitHub Pages 上同步过来的。所以静态部署文档的服务器和服务端渲染的 Node 服务器是分开的,也就是说你还是可以用之前的方式更新文档,并不需要每次都部署。 -## 什么是 SSR? +## 为什么选择 SSR? + - 更好的 SEO - 更酷的感觉 @@ -111,8 +115,6 @@ module.exports = { ``` - - ## 更多玩法 你可以直接在你的 Node 服务器上执行 `docsify start` 。