水温注意!本文是强行写的。

Logseq作为开源软件,它的文件结构是对用户比较友好的。笔者将在文中简要介绍.logseq和graph(图谱)两个路径下的结构和各文件作用。更细致全面的描述请参考logseq官方的文档及其repo中的注释等。 部分内容为笔者自主解释,如有错误敬请指正。

⚠注意:本文内容有可能随着logseq代码更新而部分过时,特别是未来数据库版本开放后。

.logseq

位于C:/users/{username}/.logseq,是logseq的全局软件配置。只有打开graph时会读取一次,更改相关配置时会写入,其他时间都是无读写的。

~/config

  • config.edn 全局配置,即设置-常规-自定义全局配置 的文件。
  • plugins.edn 安装的插件及其元信息。可以使用该文件批量下载插件。操作方法:打开软件后,提示检测到某些插件未安装于~/plugins中,可以用命令Install plugins from plugins.edn或者在插件页点击展开后的选项,一键下载。

~/git

以各graph的路径命名文件夹,里面是.git文件夹

~/graphs

路径下是图谱的transit文件,作用是加快加载时间。

~/plugins

插件的安装路径

~/settings

插件的设置json文件

~/perferences.json

部分软件配置,包括当前主题、header上固定的插件等。

graph

即你的图谱,存放着你真正的内容。

~/.git

graph的git仓库,具体可以自行学习git。logseq的多版本控制功能会创建,建议使用logseq的内置自动commit而不是自行加入git。

~/assets

可相对引用的文件,理论上无硬限制。

assets下可以建立多级文件夹,都能引用到。当然相对引用也没那么自由,你在库目录内随便创个文件夹再用相对路径并不可行。

logseq内pdf截图标注会形成png文件自动存在同一个文件夹下。

~/journals

日志,格式.md,即markdown,markdown应该不需要进一步解释。

~/logseq

本graph的相关配置和文件。

  • ~/.recycle 回收站
  • ~/bak 备份,logseq检测到数据和硬盘上之间存在差异时会写入。当前的作用机制似乎不是很完善,相关代码之后应该还会更新。嗯确信操作无误的话可以删,但没必要。
  • ~/config.edn 当前库的配置,即设置-常规-自定义配置 的文件
  • ~/custom.css 当前库的主题,即设置-常规-自定义主题 的文件
  • ~/export.css 导出主题,即设置-常规-导出主题 的文件。默认并不存在,软件内编辑内容后会自动创建。
  • ~/graphs-txid.edn logseq官方同步功能所使用的文件。
  • ~/metadata.edn 用于存储加密状态,现已弃用。从较新版本开始使用的用户可能不会看到该文件。
  • ~/pages-metadata.edn 全部页面的元数据,包含名称及创建&修改时间。0.8.11版本后该文件已弃用,可以直接删。从之后版本开始使用的用户可能不会看到该文件。不过我懒的删了(

~/pages

除journals外的所有页面,格式同样是.md

~/whiteboards

logseq的白板。软件内关闭白板功能不会删除该文件夹,请放心关闭。格式.edn。