Skip to content

ejaa3/aquarelle

Repository files navigation

Aquarelle

REUSE status

Can be the following:

  • An experimental environment for color scheming.
  • A (pre)processor for color configuration files whose format is based on plain text.
  • A way to customize the appearance of software declaratively.
  • Let's say a part of my personal rice (the aquarelle namespace).

The current state is:

  • Incomplete documentation.
  • The CLI is functional, the GUI is not.
  • The API seems stable.

Development and testing

The following commands are assumed to be executed with bash in the project directory:

  1. Configure the project directory: meson setup build --prefix ~/install_dir
    Change ~/install_dir to the directory of your choice, and now you can use cargo properly.

  2. Run the CLI version as follows: cargo run --features cli
    To use arguments, append: -- <arg1> <arg2> <...>

  3. Before running the GUI version, the settings schema must be compiled:

    mkdir -p ~/.local/share/glib-2.0/schemas/
    ln -s $(pwd)/build/data/io.github.ejaa3.Aquarelle.Devel.gschema.xml ~/.local/share/glib-2.0/schemas/
    glib-compile-schemas ~/.local/share/glib-2.0/schemas/

    Now you can run the GUI version: cargo run --features gui --bin gui

  4. Installation: meson install -C build

Book

Install mdbook-i18n-helpers:

cargo install mdbook-i18n-helpers

View live translation for an xx language:

MDBOOK_BOOK__LANGUAGE=xx mdbook serve -d book/xx

Update translations:

meson compile -C build update-doc-l10n