集成Markdown编辑器和IDE功能的个人知识管理工具 MindForger 安装和使用手册

MindForger 个人知识管理工具集成了Markdown编辑器和IDE的功能，提供一个私密的空间来记录你的想法、计划。

以 Prusa MK2S 3D 打印机为例，可在 MindForger 中创建专属笔记，包括打印记录、技巧提示、安全注意事项、外壳制作计划、组装指南、安装手册、驱动设置、固件源代码、打印机软件等内容，能记录与 3D 打印相关的课程、技术会议、材料信息等关联事项。

笔记和知识管理功能

Markdown 支持：全面支持 Markdown 格式，包括文件、目录、配置、编辑器、大纲、视图模式切换等，能处理图片、链接、列表、任务、引用、表格、代码语法高亮、数学公式、图表等内容，支持 MathJax 公式渲染。

知识关联图谱：自动生成笔记间的关联，如 3D 打印机相关笔记和创意、课程、软件等的关联度，帮助用户发现知识间的潜在联系。

重构和模板：提供 IDE 风格的笔记重构功能，可克隆、提升、降级、移动、提取笔记，内置多种模板，如会议记录、软件分析、SMARTER 目标和 GROW 模型等，方便用户快速创建特定类型的笔记。

分析和同步功能：提供数据统计和完整性检查功能，用户可使用多种工具分析基于文本的 Markdown 存储库，数据可通过 SCM（如 Git、GitHub、BitBucket）和/或信任的云盘（带自定义加密）在所有设备间轻松同步。

MindForger安装和配置

各系统安装方法

macOS

Homebrew 安装：在终端运行 brew install mindforger。

DMG 安装：从 GitHub 发布页面下载 .dmg 文件，打开挂载后将 mindforger 拖到 Applications 文件夹，运行后会在 home 目录创建文档副本作为默认存储库。

Windows

从 GitHub 发布页面下载安装程序可执行文件，运行安装程序即可。

WSL（Windows 子系统 for Linux）

• 安装 WSL 并确保 Ubuntu 16.04 或更高版本，运行 lsb_release -a 检查，若不是则执行 sudo do-release-upgrade。

• 安装 X 服务器如 Xming，添加 PPA 并安装 MindForger：

sudo add-apt-repository ppa:ultradvorka/productivity
sudo apt update
sudo apt install mindforger
DISPLAY=:0.0 mindforger

Ubuntu

添加 PPA 并安装：

sudo add-apt-repository ppa:ultradvorka/productivity
sudo apt update
sudo apt install mindforger

Debian

DEB 包安装：从 GitHub 发布页面下载对应 Debian 版本的 .deb 包安装。

PPA 安装：添加 PPA 到 APT 源，如 Debian "bookworm"：

echo "deb http://www.mindforger.com/debian-ppa/bookworm bookworm main" | sudo tee /etc/apt/sources.list.d/mindforger.list
wget -qO - http://www.mindforger.com/gpgpubkey.txt | sudo apt-key add -
sudo apt update
sudo apt install mindforger

Fedora

下载 RPM 包并安装：

sudo dnf install mindforger-MAJOR.MINOR.REVISION.rpm

FreeBSD

运行 pkg install deskutils/mindforger 或 pkg install mindforger。

Arch Linux

从 Arch 用户仓库（AUR）安装：https://aur.archlinux.org/packages/mindforger/。

NixOS

运行 nix-env -i mindforger。

openSUSE

运行 sudo zypper in opi，然后 opi mindforger。

从源代码构建

以 macOS 为例：

• 安装 Xcode 命令行工具、HomeBrew，安装依赖如 ccache，下载 Qt（选择 5.x.x 版本，含 Qt Creator、qmake、CMake 等）。

• 获取源代码：

git clone https://github.com/dvorka/mindforger.git
git submodule init
git submodule update

• 构建依赖和源代码：

cd mindforger/deps/cmark-gfm
mkdir build && cd build
cmake -DCMARK_TESTS=OFF -DCMARK_SHARED=OFF ..
cmake --build .
cd ../../
qmake -r mindforger.pro
make

• 可选安装到应用程序文件夹：cd app && cp -rvf mindforger.app /Applications。

• 克隆文档存储库：cd ~ && git clone https://github.com/dvorka/mindforger-repository.git。