Obsidian 数字花园搭建指南

本指南将引导您了解并设置oleeskild/obsidian-digital-garden这个开源项目，帮助您在Obsidian中创建并发布个人数字花园至网络。我们将会覆盖以下三个核心部分：

1. 项目目录结构及介绍

项目目录结构是这样的：

.
├── src                  # 主要源代码存放地
│   ├── dg-testVault     # 用于本地开发的测试资料库
│   ├── ...
├── env                   # 环境变量文件（本地开发时用于配置GitHub访问）
├── editorconfig         # 编辑器配置文件
├── gitignore             # Git忽略文件配置
├── husky                 # 版本控制钩子工具相关配置
├── package-lock.json    # NPM依赖锁文件
├── package.json         # 项目配置与依赖列表
├── prettierrc.json      # Prettier代码格式化配置
├── README.md            # 项目说明文档
├── LICENSE              # 许可证文件
└── ...

• src 目录包含了模板网站的主要代码，如果您想自定义网站样式或功能，这里将是主要操作区域。
• env 文件用于保存敏感信息如GitHub访问令牌，在本地开发时使用。
• 配置文件如.editorconfig, .gitignore, husky等，是用来保证代码风格一致性和版本控制流程的标准配置。

2. 项目的启动文件介绍

此项目并非传统意义上的“启动”应用，它的核心在于Obsidian插件和与其协同工作的前端展示模板。不过，对于开发者想要本地预览或修改前端展现，主要通过NPM命令进行：

• 开发模式下启动服务，您可以运行 npm run dev 命令。这将启动一个开发服务器，允许您实时查看对前端模板所做的更改。

若是在Obsidian中启动您的数字花园过程，实际上是通过安装插件并在其内部设置完成的，没有特定的“启动文件”。

3. 项目的配置文件介绍

Obsidian内配置

• 在Obsidian设置中找到“Digital Garden”插件设置。
• 必填项包括您的GitHub用户名、之前创建的仓库名称以及访问令牌。
• 可选配置包括个性化设置，如主题和样式调整。

外部配置（例如package.json）

• package.json 包含了项目的元数据和脚本命令，比如开发和构建流程。这里的scripts部分定义了如dev这样的命令，用于本地开发环境的快速启动。
• 对于环境配置，虽然不是直接在项目根目录可见，但在实际部署或本地开发中，可能涉及到.env文件来存储诸如GitHub仓库凭据等敏感信息。

综上所述，oleeskild/obsidian-digital-garden项目通过结合Obsidian插件与前端模板，使您能够轻松创建和管理在线的个人知识花园。确保遵循官方文档中的步骤，尤其是关于GitHub账号和Vercel部署的部分，以便顺利搭建属于自己的数字花园。