Open Source Ecosystems

$\tt{Ficus}$ 是一款 markdown 文档的编辑管理软件，由 $\tt{gg=G}$ 团队开发。

$\tt{Ficus}$ 释义为“榕树”，榕树具有“冠盖如伞、一木成林“的特点。这也恰是本款软件想要为用户提供的核心服务：让用户的 md 文档可以像一棵榕树一样被浏览和编辑，同时让用户的多个 md 文档像榕树林一样进行多种形式的关联。我们希望用户的体验如这款软件的标语一样：

$\tt{Ficus}$ 基于 Vue3, Electron 框架开发，提供 Windows、macOS 和 Linux 系统的安装包。

详细信息可以在ficus官网进一步了解。

先览

富文本模式

源码模式

榕树模式

榕林模式

榕图模式

构建

可以在下载链接处直接下载打包的应用。

如果希望自己构建，建议使用 node v16.19.1 版本，预先安装好 yarn 包管理器，使用 yarn 进行包管理。在 shell 中执行如下操作：

git clone [email protected]:Thysrael/Ficus.git
cd ./Ficus/
yarn install
yarn electron:build

在Ficus/dist_electron/linux_unpacked 或 Ficus/dist_electron/win_unpacked 就是成品的构建结果。

需要注意安装路径中不能有中文，同时对于 win 用户，安装程序中只支持 Only for me 选项：

运行

建议使用 node v16.19.1 版本，预先安装好 yarn 包管理器，使用 yarn 进行包管理。在 shell 中执行如下操作：

git clone [email protected]:Thysrael/Ficus.git
cd ./Ficus/
yarn install
yarn electron:serve

架构

项目的架构图如图所示

项目目录架构如下：

├── build: 构建需要的资源
├── public: 美工样式资源
│   └── css
│       └── content-theme
├── src: 项目源码
│   ├── common: 公用资源
│   ├── IR: FicIR 
│   │   ├── block: IR 基本数据结构
│   │   │   ├── base 
│   │   │   │   ├── content: 节点信息
│   │   │   │   ├── linkedList
│   │   │   │   └── type: 类型
│   │   │   └── factory: 工厂方法
│   │   ├── component: IR 顶层数据结构
│   │   ├── history: 历史记录
│   │   ├── manager: 数据管理器，对外唯一接口
│   │   └── utils: 外部工具
│   │       └── marked: markdown 词法解析器
│   ├── main: electron 后端
│   │   ├── filesystem: 文件操作方法
│   │   ├── helper: 工具方法
│   │   └── update: 打包方法
│   └── renderer: Vue 前端
│       ├── assets: 前端静态资源
│       ├── components: vue 组件
│       │   ├── header: 顶栏
│       │   ├── mindEditor: Ficus 模式编辑器
│       │   │   └── assets
│       │   ├── richTextEditor: 富文本编辑器
│       │   ├── sideBar: 侧边栏
│       │   └── textArea: 文本编辑器
│       ├── store: 存储
│       └── utils
│           └── keyboardbinding: 快捷键绑定
└── test: 单元测试
    ├── IR: IR 测试
    │   ├── data
    │   ├── factory
    │   └── manager
    └── main: 主进程方法测试
        ├── data
        └── filesystem