Contribuindo

Contribuições são bem-vindas: código, traduções, testes em outras distros e bugs bem descritos.

AmbienteCopiar link da seção

Rust 1.89 ou mais novo. No Ubuntu/Debian:

sudo apt install libxkbcommon-dev libwayland-dev libvulkan-dev pkg-config
git clone https://github.com/RafaelProfMgz/doknyu
cd doknyu

Comandos do dia a diaCopiar link da seção

cargo run                    # precisa de um daemon do Docker rodando
cargo run --features fake    # cliente falso em memória, sem Docker
cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo test
cargo test -- --ignored      # testes de integração, precisam de Docker

Antes de abrir um pull request, rode fmt, clippy e test.

Textos e traduçõesCopiar link da seção

Todo texto visível passa por t!("chave"), com entradas em locales/en.yml e locales/pt-BR.yml. Ao adicionar um texto, inclua a chave nos dois arquivos. Quer traduzir para outro idioma? Crie um novo arquivo em locales/ e abra um PR.

PacotesCopiar link da seção

cargo build --release
cargo install cargo-deb --locked && cargo deb --no-build   # target/debian/*.deb
packaging/appimage/build-appimage.sh                       # target/appimage/*.AppImage

As releases são geradas pelo GitHub Actions quando uma tag v* é enviada. Os arquivos de Flatpak, AUR, COPR e Nix ficam em packaging/.

Reportando bugsCopiar link da seção

Abra uma issue com:

• versão do doknyu e formato (.deb, AppImage, código-fonte);
• distro, versão e ambiente gráfico (Wayland ou X11);
• versão do Docker (docker version);
• passos para reproduzir e o que você esperava.

Logs detalhados ajudam muito:

RUST_LOG=debug doknyu