ShiOrI书签管理器安装与使用指南

目录结构及介绍

ShiOrI是一款采用Go语言开发的简单书签管理工具，其源代码结构清晰明了，便于理解和维护。

当你克隆或下载该项目后，你会看到以下主要目录：

• cmd: 此目录下包含了应用程序的主要执行入口点。
  • shiori: 此子目录下的代码是ShiOrI命令行界面的主程序。
  • web: 此子目录下的代码用于构建Web界面的应用程序。
• docs: 存放所有文档和说明文件的地方。
• internal: 包含应用内部逻辑的核心代码包。
  • archive: 用于网页内容抓取和归档的功能实现。
  • database: 数据库操作相关代码所在位置，支持sqlite3、PostgreSQL和MySQL。
  • model: 应用模型定义，如书签结构体等。
• static: 静态资源文件存放地，包括图片、CSS样式表等。
• templates: Web界面使用的HTML模板文件。
• README.md: 项目的基本介绍、功能特性以及快速入门指南。

启动文件介绍

命令行界面（CLI）启动

在cmd/shiori/main.go中，你可以找到CLI接口的初始化和运行函数。这个文件负责处理命令行参数并调用相应的业务逻辑方法来完成诸如添加、编辑、删除或搜索书签等功能。

网页界面启动

对于Web界面版本，你应该查看cmd/web/main.go中的代码。它将设置HTTP服务器，并注册路由以响应各种请求。通过访问预定端口上的特定URL，可以启动和管理Web服务。

配置文件介绍

ShiOrI通过.ini格式的配置文件进行配置。你可以自定义数据库连接字符串、应用监听地址以及其他一些高级选项。典型的配置文件可能会在你的工作目录下创建名为shiori.ini的文件。

示例配置文件如下：

[general]
http_address = ":8080"
ssl_enabled = false

[database]
type = "sqlite3"
connection_string = "data.db"

[auth]
method = "none" # 可选值: none|basic
username = ""
password = ""

[proxy]
enabled = false
address = ""

其中的关键部分有：

• [general] 部分允许你指定服务器的监听地址以及是否启用SSL加密。
• [database] 部分让你选择数据库类型和连接细节。
• [auth] 部分提供身份验证机制的选择及其用户名密码配置。
• [proxy] 部分允许通过代理服务器进行访问的设定。

确保在修改任何配置前都阅读了完整的文档，以避免不必要的错误。