Taffybar 项目安装与使用教程

Taffybar 项目安装与使用教程

taffybarA gtk based status bar for tiling window managers such as XMonad项目地址:https://gitcode.com/gh_mirrors/ta/taffybar

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

Taffybar 项目的目录结构如下：

taffybar/
├── app/
│   └── Main.hs
├── src/
│   ├── System/
│   │   └── Taffybar/
│   │       ├── Config.hs
│   │       ├── Main.hs
│   │       └── ...
│   └── ...
├── test/
│   └── ...
├── taffybar.cabal
├── LICENSE
├── README.md
└── ...

目录结构介绍

• app/: 包含应用程序的主入口文件 Main.hs。
• src/: 包含 Taffybar 的核心代码，其中 System/Taffybar/ 目录下包含主要的配置文件和启动文件。
• test/: 包含项目的测试代码。
• taffybar.cabal: 项目的 Cabal 配置文件，用于定义项目的依赖和构建信息。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的介绍和使用说明。

2. 项目的启动文件介绍

Taffybar 的启动文件主要位于 src/System/Taffybar/Main.hs。该文件定义了 Taffybar 的主要启动逻辑。

主要函数

• dyreTaffybar :: TaffybarConfig -> IO (): 启动 Taffybar 并自动重新编译配置文件。
• dyreTaffybarMain :: TaffybarConfig -> IO (): 主函数，由 dyre 调用，传入 TaffybarConfig 配置。
• startTaffybar :: TaffybarConfig -> IO (): 启动 Taffybar，但不自动重新编译配置文件。

3. 项目的配置文件介绍

Taffybar 的配置文件主要位于 src/System/Taffybar/Config.hs。该文件定义了 Taffybar 的配置选项。

主要配置项

• TaffybarConfig: 定义了 Taffybar 的配置结构，包括颜色、图表数据、标签等。
• getTaffyFile :: String -> IO FilePath: 获取配置文件的路径。
• taffybarDyreParams :: Params TaffybarConfig (): 定义了传递给 dyre 的参数。

示例配置

以下是一个简单的 Taffybar 配置示例：

{-# LANGUAGE OverloadedStrings #-}
import Data.Default (def)
import System.Taffybar
import System.Taffybar.Information.CPU
import System.Taffybar.SimpleConfig
import System.Taffybar.Widget
import System.Taffybar.Widget.Generic.Graph

cpuCallback = do
  (_systemLoad, totalLoad) <- cpuLoad
  return [totalLoad, systemLoad]

main = do
  let cpuCfg = def
        { graphDataColors = [(0, 1, 0, 1), (1, 0, 1, 0.5)]
        , graphLabel = Just "cpu"
        }
  clock = textClockNew Nothing "%a %b %_d %I:%M %p" 1
  defaultTaffybar defaultTaffybarConfig
    { startWidgets = [textClockNew Nothing "%a %b %_d %I:%M %p" 1]
    , endWidgets = [cpuGraphNew cpuCfg]
    }

该配置定义了 CPU 图表和时钟显示。

taffybarA gtk based status bar for tiling window managers such as XMonad项目地址:https://gitcode.com/gh_mirrors/ta/taffybar