Cultura 通过从各种来源（如reddit、维基百科等）提供有趣的事实，帮助您每天提高您的文化知识 🤓。

• 安装
• 配置
• 故障排除
• 提交新的提供商

安装

如何安装

从 rust

运行

cargo install cultura

从 GitHub

从发布页面下载二进制文件 => https://github.com/antham/cultura/releases/latest 并将其安装到您的二进制路径。

从 docker

从 docker.io/antham/cultura 拉取镜像，更多信息请参阅 shell配置部分。

Shell配置

要在您的shell中设置Cultura，请参考以下针对您的shell的特定配置

Bash

这取决于bash的设置。

在您的bash配置文件中添加

eval "$(cultura init bash)"

如果您使用的是docker容器，请下载文件 scripts/docker.bash 并在您的bash配置文件中添加

source <path_of_the_script>/docker.bash

Fish

在您的fish配置文件中添加

cultura init fish | source

如果您使用的是docker容器，请下载文件 scripts/docker.fish 并在您的fish配置文件中添加

source <path_of_the_script>/docker.fish

Zsh

这取决于zsh的设置。

在您的zsh配置文件中添加

eval "$(cultura init zsh)"

如果您使用的是docker容器，请下载文件 scripts/docker.zsh 并在您的zsh配置文件中添加

source <path_of_the_script>/docker.zsh

ℹ️ 如果您在使用p10k时遇到一些缓慢问题，请确保您已将初始化命令移至p10k即时提示符的初始化之前。

配置

可以通过提供的命令编辑配置，或者直接通过配置文件编辑，运行 cultura config get-config-file-path 以获取配置文件的路径。

必须停止守护进程才能使配置生效，因此请在编辑完成后简单地运行 cultura daemon stop。

如果您使用Docker与cultura一起使用，可以将cultura命令替换为docker exec cultura-af2fce60 cultura。在执行命令之前，请确保容器已经正在运行。

事实渲染

您可以使用命令cultura config set-template来自定义事实的渲染方式。

让我们看看一个例子

__A new fact__:cyan:bold __=>__ $fact:yellow

您的文本必须位于四个下划线之间，您可以提供颜色并使用示例中的样式。

$fact变量是一个特殊变量，它将与事实进行插值。

提供者

您可以定义希望使用的特定事实提供者，默认是显示所有，如果您想自定义使用哪一个，例如执行cargo run config set-providers TIL,DYK，它将使用DYK和TIL作为事实提供者。

可用的提供者

故障排除

在守护程序上调试问题

使用二进制文件

• 运行cultura daemon start true以在前景启动守护程序并检查错误。

使用docker

• 运行docker logs cultura-af2fce60

检查提供者

使用二进制文件

• 通过调用cultura doctor run-providers，您可以确保提供者正常运行，您将看到每个提供者的解析器是否正常工作。

使用docker

• 通过调用docker exec cultura-af2fce60 cultura doctor run-providers，您可以确保提供者正常运行，您将看到每个提供者的解析器是否正常工作。

重置应用程序

使用二进制文件

• 您可以通过运行cultura doctor reset来重置应用程序，它将删除整个现有配置和数据库。

使用docker

• 使用docker rm -f cultura-af2fce60删除容器。

提交新的提供商

如果您有关于可以向cultura添加的事实来源的想法，请随时创建一个问题并提供您建议的必要细节和推理。