Zotsite 项目使用教程

Zotsite 项目使用教程

zotsiteExport Zotero to a stand-alone web site项目地址:https://gitcode.com/gh_mirrors/zo/zotsite

1. 项目的目录结构及介绍

Zotsite 项目的目录结构如下：

zotsite/
├── CHANGELOG.md
├── LICENSE
├── README.md
├── bin/
│   └── zotsite
├── conf/
│   └── zotsite.conf
├── docs/
│   └── ...
├── src/
│   ├── css/
│   ├── html/
│   ├── js/
│   └── ...
└── tests/
    └── ...

• CHANGELOG.md: 记录项目的更新日志。
• LICENSE: 项目的许可证文件，采用 MIT 许可证。
• README.md: 项目的主文档，包含项目的基本信息和使用说明。
• bin/: 包含可执行文件 zotsite，用于启动项目。
• conf/: 包含项目的配置文件 zotsite.conf。
• docs/: 包含项目的详细文档。
• src/: 包含项目的源代码，分为 css、html 和 js 等子目录。
• tests/: 包含项目的测试文件。

2. 项目的启动文件介绍

项目的启动文件位于 bin/ 目录下，名为 zotsite。该文件是一个可执行脚本，用于启动 Zotsite 项目。启动文件的主要功能包括：

• 检查 Zotero 是否已关闭。
• 解析配置文件。
• 根据配置文件生成网站。

使用方法如下：

./bin/zotsite export -o <sitedir>

其中，<sitedir> 是生成的网站目录。

3. 项目的配置文件介绍

项目的配置文件位于 conf/ 目录下，名为 zotsite.conf。该文件包含了项目的主要配置选项，以下是一些关键配置项的介绍：

• [site_creator]: 网站生成器的配置部分。
  • robust_fs = True: 设置为 True 时，程序在遇到文件系统复制问题时会继续尝试导出，但会输出详细的错误信息。

配置文件示例：

[site_creator]
robust_fs = True

通过修改配置文件，可以调整项目的运行行为和生成的网站结构。

zotsiteExport Zotero to a stand-alone web site项目地址:https://gitcode.com/gh_mirrors/zo/zotsite