xiaoz
1.03D
V2EX  ›  问与答

有适合自建的文档系统推荐吗?

  •  1
     
  •   xiaoz · Aug 7, 2021 · 7265 views
    This topic created in 1924 days ago, the information mentioned may be changed or developed.

    主要用来给自己的开源产品写文档用的,需求如下:

    • 支持 markdown
    • 支持私有部署
    • 支持后台管理
    • 免费

    1. 目前已知的有 MinDoc,但是作者好久都没更新了。
    2. bookstackapp 似乎还可以,但是不知道用来写文档怎么样,有用过的老哥给个地址看看么。
    Supplement 1  ·  Aug 8, 2021

    感谢各位的推荐,目前觉得两款比较满意,showdoc和bookstackapp

    • showdoc部署简单,支持客户端,界面简洁,国内用户貌似比较多
    • bookstackapp界面美观,支持多语言,国内使用者貌似比较少,部署相对复杂

    最终选择了bookstackapp,已经上线:https://doc.xiaoz.me/

    19 replies  •  2022-08-07 16:46:16 +08:00
    hotcool100
    hotcool100
    Aug 7, 2021❤️3
    1
    vuepress
    vate32
    vate32
    Aug 7, 2021❤️2
    2
    阮一峰昨天刚推荐的 https://www.showdoc.com.cn/
    ruixue
    ruixue
    Aug 7, 2021❤️1
    3
    BookStack 挺不错的,可以一试。开发也比较活跃,使用也简单方便

    帮你找了个示例:

    https://wiki.mcxk.net
    QingXuJiaZhi
    QingXuJiaZhi
    Aug 7, 2021❤️1
    4
    一般产品用 github 的 wiki 就够用了吧?
    liufish
    liufish
    Aug 7, 2021❤️1
    5
    现在用 mkdocs,把一些成体系的东西放进去了
    xiaoz
    xiaoz
    OP
    Aug 7, 2021
    6
    @cmdOptionKana #4 github 的 wiki 不能自己部署,不太符合需求。
    Felldeadbird
    Felldeadbird
    Aug 7, 2021❤️1
    7
    要不试下我重构的 2.0 文档系统? 下周发布正式版 。https://gitee.com/fallBirds/PESCMS-DOC/tree/dev-2.0.0/

    效果可以看 https://document.pescms.com/ 。我最近在重写新全部系统文档。
    QingXuJiaZhi
    QingXuJiaZhi
    Aug 7, 2021❤️1
    8
    啊,突然想起一个混 V 站的前端大佬做的产品

    V 站贴子 https://www.v2ex.com/t/698343
    官方示例 https://ts.xcatliu.com/
    xiaoz
    xiaoz
    OP
    Aug 7, 2021
    10
    @wdssmq #9,谢谢,这个以前用过,界面简洁,可惜没有后台管理,有点不方便。
    xiaoz
    xiaoz
    OP
    Aug 7, 2021
    11
    @vate32 #2,这个貌似还不错,部署也简单。
    Rainshaw
    Rainshaw
    Aug 7, 2021❤️1
    12
    https://js.wiki
    用着还行
    xiaoz
    xiaoz
    OP
    Aug 7, 2021
    13
    @Rainshaw #12,老哥能给个你的演示地址吗?之前部署过 wiki.js ,感觉略微复杂。
    Rainshaw
    Rainshaw
    Aug 7, 2021
    14
    @xiaoz #13 我是内网建的,目前 v2 部署挺简单的,甚至官网还给了 docker-compose.yml 直接就能用。
    w3cll
    w3cll
    Aug 7, 2021❤️1
    15
    showdoc
    star7th
    star7th
    Aug 7, 2021❤️1
    16
    推荐 showdoc,一开始简单好用,深入后使用,功能也强大得满足各种需求。https://www.showdoc.com.cn ,而且开源持续更新。
    FantasyPupil
    FantasyPupil
    Jul 27, 2022
    17
    楼主现在用的什么文档管理呢?网站看着很舒服
    xiaoz
    xiaoz
    OP
    Jul 27, 2022 via Android
    18
    FantasyPupil
    FantasyPupil
    Aug 7, 2022
    19
    @xiaoz 谢谢,我瞅瞅
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   4448 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 62ms · UTC 08:33 · PVG 16:33 · LAX 00:33 · JFK 03:33
    ♥ Do have faith in what you're doing.