Go-Shiori/Shiori 书签管理工具使用指南

Go-Shiori/Shiori 书签管理工具使用指南

shiori Simple bookmark manager built with Go 项目地址: https://gitcode.com/gh_mirrors/sh/shiori

前言

Go-Shiori/Shiori 是一款用 Go 语言编写的简单书签管理工具，它可以帮助用户高效地保存、组织和检索网页书签。本文将详细介绍 Shiori 的安装配置、Docker 容器运行、命令行界面使用以及 Web 界面操作等核心功能。

安装与配置

在使用 Shiori 之前，需要确保它已正确安装在系统中。默认情况下，Shiori 会将数据存储在 $HOME/.local/share/shiori 目录下。如果需要更改数据存储位置，可以通过设置环境变量 SHIORI_DIR 来指定自定义路径。

注意：在 1.5.0 版本之前，环境变量名称为 ENV_SHIORI_DIR

Docker 容器运行指南

对于使用 Docker 的用户，以下是详细的容器运行步骤：

1. 启动容器： 执行以下命令可以创建一个新的 Shiori 容器：

   docker run -d --rm --name shiori -p 8080:8080 -v $(pwd):/shiori shiori-image
   

   命令参数说明：

   • -d：后台运行容器
   • --rm：容器停止后自动删除
   • --name：设置容器名称
   • -p：端口映射（容器端口:主机端口）
   • -v：数据卷挂载（主机目录:容器目录）

2. 访问容器控制台： 如果需要进入容器执行命令，可以使用：

   docker exec -it shiori ash
   

3. 停止容器： 当需要停止容器时，执行：

   docker stop shiori
   

命令行界面(CLI)使用

Shiori 提供了丰富的命令行功能，通过 shiori -h 可以查看所有可用命令：

简单命令行书签管理器

可用命令:
  add         添加指定URL为书签
  check       检查书签是否仍然有效
  delete      删除已保存的书签
  export      导出书签为Netscape书签格式的HTML文件
  help        获取帮助
  import      从Netscape书签格式的HTML文件导入书签
  open        打开已保存的书签
  pocket      从Pocket导出的HTML文件导入书签
  print       打印已保存的书签
  server      启动Shiori网页服务器
  update      更新已保存的书签
  version     显示Shiori版本

高级搜索功能

使用 print 命令时，可以通过以下标志实现高级搜索：

• -s：在URL、标题、摘要或缓存内容中搜索关键词
• -t：包含特定标签
• -e：排除特定标签

Web界面使用

启动Web界面有两种方式：

1. 直接运行 shiori server
2. 通过Docker容器启动

如果需要更改默认端口(8080)，可以使用 -p 参数指定端口号。

首次访问Web界面时，使用默认凭证登录：

• 用户名：shiori
• 密码：gopher

登录后，可以在设置页面创建新账户。

Web界面搜索技巧

在Web界面搜索书签时：

• 使用 tag:tagname 包含特定标签
• 使用 -tag:tagname 排除特定标签
• 点击标签名称可包含该标签
• 按住Alt键点击标签名称可排除该标签

社区贡献功能

从Pocket导入书签

Shiori支持从Pocket导入书签，但默认只导入链接。要完整导入内容（包括文本和图片），可以按照以下步骤操作：

1. 从Pocket导出书签
2. 下载并运行专用转换脚本
3. 执行导入操作

从Wallabag导入书签

1. 从Wallabag导出JSON格式书签
2. 安装jq工具（用于处理JSON数据）
3. 下载并运行Wallabag转换脚本

Android设备添加书签

通过Termux应用，可以在Android设备上实现将网页直接分享到Shiori的功能：

1. 安装Termux应用
2. 创建并配置URL处理脚本
3. 通过分享菜单将链接发送到Termux

配置完成后，可以直接从Android设备的浏览器分享链接到Shiori，实现便捷的书签添加。

结语

Go-Shiori/Shiori 作为一个轻量级的书签管理工具，提供了从命令行到Web界面的多种操作方式，满足不同用户的使用习惯。通过本文介绍的各种功能和技巧，用户可以充分发挥Shiori的潜力，建立高效的个人知识管理体系。无论是简单的书签保存，还是复杂的内容归档和检索，Shiori都能提供可靠的解决方案。

shiori Simple bookmark manager built with Go 项目地址: https://gitcode.com/gh_mirrors/sh/shiori