公司内文档用静态站搭建推荐

2021-03-31 13:27:10 +08:00
 rodrick
公司内打算搭建一个放文档的静态站,只要支持渲染 markdown 文件和基本的目录层级划分功能就行,搭建越简单越好。
wordpress,vuepress,Hexo 之类的,哪个相对来说更傻瓜式搭建,最好可以不要需要 node,npm,vue 这种基础的

另外如果可以一键部署到本地 gitlab 最好,不过这个不重要,还是以简单好搭建为主
2735 次点击
所在节点    程序员
22 条回复
menc
2021-03-31 13:32:06 +08:00
doku,只需要一个 php 环境,数据库都省了
dimlau
2021-03-31 13:37:49 +08:00
可以看一下 Grav CMS,也是只要 PHP 即可
anson2017
2021-03-31 13:38:35 +08:00
石墨文档、线上 WPS 、语雀、有道云笔记都可以
wangmn
2021-03-31 13:39:39 +08:00
gitea 挺好
ljhrot
2021-03-31 13:41:57 +08:00
可以试试 gitbook
Mithril
2021-03-31 13:42:28 +08:00
https://docsify.js.org/
连生成静态站这步都省了。
就是特别复杂的目录支持的不太好。
maocat
2021-03-31 13:43:47 +08:00
gitbook in docker
litchinn
2021-03-31 13:44:59 +08:00
mdbook
youngxhui
2021-03-31 13:47:28 +08:00
hugo 加个主题,只要一个 hugo 可执行文件,其他什么都不需要
bthulu
2021-03-31 13:48:49 +08:00
wps 云文档啊, 搭建都免了
rodrick
2021-03-31 13:51:44 +08:00
@anson2017
@bthulu
云端不行,公司内网
dayeye2006199
2021-03-31 13:52:54 +08:00
推荐 hugo,简单够用
zhuweiyou
2021-03-31 13:57:16 +08:00
如果没有 seo 需求的话, 可以用 docsify 直接动态渲染, 引入个 <script> 就行, 连 build 都不需要...

要 build 成 html, 可以用 hugo 很简单
vision1900
2021-03-31 14:03:07 +08:00
直接建个 Gitlab repo 不行吗
vfxx
2021-03-31 14:09:57 +08:00
showdoc 是 php 的,不是静态,但是很好用。
SmiteChow
2021-03-31 14:23:35 +08:00
文档当然用 gollum
Sapp
2021-03-31 14:51:50 +08:00
用过好多,最后要么是不符合要求要么是用起来麻烦,要么是不习惯
最后用的是语雀+自己做的转换发布平台,产品在语雀上写,写完了转换平台自动拉取数据做一下格式转换,再跑脚本打包成静态 html 发布到对应的环境去
RiceMarch
2021-03-31 16:53:59 +08:00
我司用的 Confluence,个人体验海星
ychost
2021-03-31 17:35:03 +08:00
语雀文档
caryyu
2021-03-31 18:29:08 +08:00

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/766833

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX