eww-quick-start

先看一下usage,

$ eww -h
Widgets for everyone!
 
Usage: eww [OPTIONS] <COMMAND>
 
Commands:
  shell-completions  Generate a shell completion script
  daemon             Start the Eww daemon
  logs               Print and watch the eww logs
  ping               Ping the eww server, checking if it is reachable
  update             Update the value of a variable, in a running eww instance
  poll               Update a polling variable using its script
  inspector          Open the GTK debugger
  open               Open a window
  open-many          Open multiple windows at once. NOTE: This will in the future be part of eww open, and will then be removed
  close              Close the given windows
  reload             Reload the configuration
  kill               Kill the eww daemon
  close-all          Close all windows, without killing the daemon
  state              Prints the variables used in all currently open window
  get                Get the value of a variable if defined
  list-windows       List the names of active windows
  active-windows     Show active window IDs, formatted linewise `<window_id>: <window_name>`
  debug              Print out the widget structure as seen by eww
  graph              Print out the scope graph structure in graphviz dot format
  help               Print this message or the help of the given subcommand(s)
 
Options:
      --debug            Write out debug logs. (To read the logs, run `eww logs`)
      --force-wayland    Force eww to use wayland. This is a no-op if eww was compiled without wayland support
  -c, --config <CONFIG>  override path to configuration directory (directory that contains eww.yuck and eww.(s)css)
      --logs             Watch the log output after executing the command
      --no-daemonize     Avoid daemonizing eww
      --restart          Restart the daemon completely before running the command
  -h, --help             Print help
  -V, --version          Print version

注意几点,

  1. eww命令首先要指定配置文件夹路径(默认为$HOME/.config/eww),如果前期调试配置文件不在这个目录,则需要每次执行命令使用-c <path>指定配置文件夹路径。
  2. 通常在调试时,打开eww -c . logs,在编写widget和css时,reload出错能够及时发现。
  3. 注意eww仅支持gtk3-css,并非全量css,有些属性是不能用的。高级样式可以使用eww -c . inspector调试。