1.1 万象云档是什么

万象云档(WanXiangYunDang)是基于 BookStack 二次开发的知识文档平台,把「写作、协作、分享、阅读、托管」集中在一个系统里。它的核心概念是书籍(Book)与文档(Document)

  • 一本书就是一个知识专题,可以包含多篇文档
  • 一篇文档就是一个章节,用 Markdown 写作
  • 书发布后,读者可以通过网址直接在线阅读

适合用来做教程、手册、技术文档、学习笔记、电子书等。

1.2 登录与进入书籍管理

打开网站首页,使用账号登录后,点击顶部或左侧的「我的书籍」,进入书籍管理列表页。

我的书籍列表页

列表页能完成这些事:

  • 添加书籍:右上角绿色按钮,创建新书
  • 书籍搜索:按书名关键词快速查找
  • 私有书籍 / 公开书籍:切换查看自己名下不同权限的书
  • 每本书右侧的操作:查看书籍、书籍设置、拷贝书籍、编辑文档、导入书籍、导出书籍

1.3 一本书的完整生命周期

在动手之前,先建立整体概念。发布一本书的完整流程是:

  1. 建书:填书名、唯一标识、描述,选访问权限
  2. 书籍设置:上传封面、勾选分类、添加标签
  3. 编辑文档:新建文档、写 Markdown 内容、插图
  4. 保存:每篇文档先保存,内容才会写入服务器
  5. 发布:点击「发布」,把全部文档同步到前台阅读页
  6. 验证:打开阅读页确认排版与内容正常

记住一个关键点:文档要「先保存、再发布」,两步都做了,前台才会显示内容。