V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
rodrick
V2EX  ›  程序员

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

  •  
  •   rodrick · 2021-03-31 13:27:10 +08:00 · 2728 次点击
    这是一个创建于 1317 天前的主题,其中的信息可能已经有所发展或是发生改变。
    公司内打算搭建一个放文档的静态站,只要支持渲染 markdown 文件和基本的目录层级划分功能就行,搭建越简单越好。
    wordpress,vuepress,Hexo 之类的,哪个相对来说更傻瓜式搭建,最好可以不要需要 node,npm,vue 这种基础的

    另外如果可以一键部署到本地 gitlab 最好,不过这个不重要,还是以简单好搭建为主
    第 1 条附言  ·  2021-03-31 14:05:12 +08:00
    感谢各位 用 hugo 了 因为要给不是需要给开发以外的人看的 所以直接建 repo 不太友好
    menc
        1
    menc  
       2021-03-31 13:32:06 +08:00   ❤️ 1
    doku,只需要一个 php 环境,数据库都省了
    dimlau
        2
    dimlau  
       2021-03-31 13:37:49 +08:00   ❤️ 1
    可以看一下 Grav CMS,也是只要 PHP 即可
    anson2017
        3
    anson2017  
       2021-03-31 13:38:35 +08:00
    石墨文档、线上 WPS 、语雀、有道云笔记都可以
    wangmn
        4
    wangmn  
       2021-03-31 13:39:39 +08:00
    gitea 挺好
    ljhrot
        5
    ljhrot  
       2021-03-31 13:41:57 +08:00   ❤️ 1
    可以试试 gitbook
    Mithril
        6
    Mithril  
       2021-03-31 13:42:28 +08:00   ❤️ 1
    https://docsify.js.org/
    连生成静态站这步都省了。
    就是特别复杂的目录支持的不太好。
    maocat
        7
    maocat  
       2021-03-31 13:43:47 +08:00 via Android
    gitbook in docker
    litchinn
        8
    litchinn  
       2021-03-31 13:44:59 +08:00
    mdbook
    youngxhui
        9
    youngxhui  
       2021-03-31 13:47:28 +08:00
    hugo 加个主题,只要一个 hugo 可执行文件,其他什么都不需要
    bthulu
        10
    bthulu  
       2021-03-31 13:48:49 +08:00
    wps 云文档啊, 搭建都免了
    rodrick
        11
    rodrick  
    OP
       2021-03-31 13:51:44 +08:00
    @anson2017
    @bthulu
    云端不行,公司内网
    dayeye2006199
        12
    dayeye2006199  
       2021-03-31 13:52:54 +08:00
    推荐 hugo,简单够用
    zhuweiyou
        13
    zhuweiyou  
       2021-03-31 13:57:16 +08:00
    如果没有 seo 需求的话, 可以用 docsify 直接动态渲染, 引入个 <script> 就行, 连 build 都不需要...

    要 build 成 html, 可以用 hugo 很简单
    vision1900
        14
    vision1900  
       2021-03-31 14:03:07 +08:00
    直接建个 Gitlab repo 不行吗
    vfxx
        15
    vfxx  
       2021-03-31 14:09:57 +08:00
    showdoc 是 php 的,不是静态,但是很好用。
    SmiteChow
        16
    SmiteChow  
       2021-03-31 14:23:35 +08:00   ❤️ 1
    文档当然用 gollum
    Sapp
        17
    Sapp  
       2021-03-31 14:51:50 +08:00
    用过好多,最后要么是不符合要求要么是用起来麻烦,要么是不习惯
    最后用的是语雀+自己做的转换发布平台,产品在语雀上写,写完了转换平台自动拉取数据做一下格式转换,再跑脚本打包成静态 html 发布到对应的环境去
    RiceMarch
        18
    RiceMarch  
       2021-03-31 16:53:59 +08:00
    我司用的 Confluence,个人体验海星
    ychost
        19
    ychost  
       2021-03-31 17:35:03 +08:00
    语雀文档
    caryyu
        20
    caryyu  
       2021-03-31 18:29:08 +08:00
    retrocode
        21
    retrocode  
       2021-03-31 19:28:14 +08:00
    docsify 装个 nginx 就能用
    F5Soft
        22
    F5Soft  
       2021-03-31 21:25:54 +08:00
    mkdocs
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   5592 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 26ms · UTC 03:30 · PVG 11:30 · LAX 19:30 · JFK 22:30
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.