安装

目前，LeftWM-theme只能通过Git和AUR获取。

要通过AUR安装（仅适用于基于Arch的发行版），使用包 leftwm-theme-git。

要手动安装，克隆此仓库

git clone https://github.com/leftwm/leftwm-theme

然后进入仓库

cd leftwm-theme

然后使用Cargo构建

cargo build --release

然后您可以安装LeftWM-theme

# for production installations (does not update when recompiled)
sudo install -s -Dm755 ./target/release/leftwm-theme -t /usr/bin
#-- or --
# for developer installations (updates when recompiled)
sudo ln -s "$(pwd)"/target/release/leftwm-theme /usr/bin/leftwm-theme

使用方法

首次使用

第一次启动LeftWM-theme时，它将从社区主题仓库中的主题生成一个名为 themes.toml 的文件，位于您的 ~/.config/leftwm/ 文件夹中。为此，请运行

leftwm-theme update

安装主题

LeftWM-theme在 安装 主题和 应用 主题之间有所区别。安装主题类似于下载；在幕后，LeftWM-theme运行 git clone {theme}。在安装时不会执行依赖项检查，而是在应用时进行。例如，要安装令人惊叹的橙林主题，请运行（带有空格的名称需要引号）

leftwm-theme install "Orange Forest"

注意：LeftWM-theme是区分大小写的，所以请小心！

应用主题

在应用过程中，LeftWM-theme会检查依赖项、LeftWM版本等。现在您已安装橙林（或您喜欢的任何主题），要将它设置为当前主题，请运行

leftwm-theme apply "Orange Forest"

注意：LeftWM应自动重新启动以使用新主题

列出已安装的主题

要列出LeftWM-theme所知的所有已安装主题，请运行

leftwm-theme list

查看当前主题

尽管多个命令都会列出已安装的主题，但使用以下命令可以提供额外的上下文

leftwm-theme status

更新主题列表

要更新主题副本，请使用以下命令

leftwm-theme update

注意：这不会更新主题，只是更新仓库列表！要更新主题，请参阅升级

更新主题

要更新主题，请使用以下命令

leftwm-theme upgrade

注意：此命令还会更新仓库

添加仓库

Leftwm-theme 允许使用多个 known.toml 仓库。要添加另一个仓库，它必须有一个 known.toml 文件，你可以将其添加到你的 LeftWM 配置文件夹中的 themes.toml 文件中。

注意：在添加新仓库之前备份你的 themes.toml 文件是个明智的做法。

要添加一个仓库，请将以下内容添加到 themes.toml 文件的底部，该文件位于 ~/.config/leftwm/themes.toml

# To add additional repos, you MUST specify a url, a UNIQUE ALPHANUMERIC name, and an empty array of themes
# e.g.:
# [[repos]]
# url = "https://raw.githubusercontant.com/mautamu/leftwm-community-themes/master/known.toml"
# name = "mautamu"
# themes = []
[[repos]]
url = ""
name = ""
themes = []

注意：确保 URL 指向一个名为 known.toml 的文件，例如 https://raw.githubusercontent.com/leftwm/leftwm-community-themes/master/known.toml

然后填写该仓库的 URL，并添加一个只包含字母和数字 [A-z0-9] 的描述性名称。要从仓库加载主题，请使用以下命令

leftwm-theme -vvv update

注意：-vvv 标志不是必需的，但在你的新仓库出现问题时将提供额外的输出

故障排除

themes.toml 几乎为空，或者 LeftWM 不会更新我的主题

尝试删除 themes.toml 并运行 update 命令，添加任何已删除的仓库，然后运行 autofind 以重新填充你的已安装主题。

我无法安装主题

请仔细检查名称。尽管 update 可能显示 mautam/theme，但你只需输入 theme，而不是 mautam/theme。注意大小写和拼写。

路线图

版本 0.1.0

• 允许用户安装主题
• 允许用户删除主题
• 允许将主题应用于当前
  • 检查主题的依赖项
  • 允许使用 -n 选项覆盖依赖项
  • 为依赖项安装提供建议
  • 检查主题的 theme.toml 文件是否有效
• 允许主题指定兼容的 LeftWM 版本
• 自动查找位于 ~/.config/leftwm/themes/ 中的主题
• 允许用户添加更多主题仓库
  • 允许用户从哪个仓库安装主题进行选择
• 允许用户创建新主题
  • 为用户提供基本主题以供他们进行分支
  • 生成适当的 known.toml 和 theme.toml pull 请求文件
  • 确保主题不包含 / 或其他操作系统特定的标记。 部分完成
• 允许用户使用 update 命令（类似于 apt-get 形式）更新他们的仓库主题列表
• 允许用户使用 upgrade 命令（类似于 apt-get 形式）更新他们的主题
  • 允许用户跳过仓库更新
  • 在更新当前主题之前执行依赖项检查
• 允许用户通过名称搜索主题

版本 0.2.0

• 扩展 theme.toml 以允许在 theme.toml 中进行上下文指定
• 更好地整合 themes.toml 和 known.toml
• 减少依赖项数量
  • 用具有较少依赖项的 crate 替换 Reqwest
  • 检查其他重叠功能的其他区域
• 为不同发行版的依赖项提供名称别名
• 改进文档
• 更好的、更一致的错误处理
• 通过在 Options 上替换 ? 删除 nightly Rust 要求
• 添加测试套件