Polish pinned rows and installation docs

This commit is contained in:
2026-09-12 16:28:35 +02:00
parent c16d79dc42
commit 6ade499301
3 changed files with 28 additions and 6 deletions

View File

@@ -81,6 +81,8 @@ Each bounded iteration must:
- [x] Add double-click-only full-content inspection for multiline entries (single selection does not open details) and confirmation before individual deletion from toolbar, row, or keyboard paths (28 X11-feature tests and Docker GTK/X11/package build, 2026-09-12); live GUI acceptance remains pending.
- [x] Add in-app Help documentation covering features, shortcuts, search ranking, installation, and uninstall/data removal (28 X11-feature tests and Docker GTK/X11/package build, 2026-09-12); content accuracy/live GUI acceptance remains pending.
- [x] Add state-specific icon-only pin/unpin controls on the left of every history row, routed through the existing pin-limit logic (27 X11-feature tests and Docker GTK/X11/package build, 2026-09-12); live GUI acceptance remains pending.
- [x] Give pinned history rows a subtle distinct background while preserving the compact row layout (28 tests and GUI check, 2026-09-12); live GUI acceptance remains pending.
- [x] Document a complete copy/paste installation command block in README and in-app Help (28 tests and GUI check, 2026-09-12).
- [x] Surface actionable status text for keyboard and toolbar action failures, including successful clipboard writes with failed history updates (Docker GTK/X11 build, 2026-09-10).
- [x] Replace the conflict-prone `Ctrl+R` pause shortcut with `Ctrl+Alt+R`, and expose the configured global shortcut in the window title/status (Docker GTK/X11 build; live tray/capture verified, 2026-09-10).
- [x] Use the Mint-friendly `Ctrl+Alt+V` as the default global popup shortcut;

View File

@@ -4,6 +4,19 @@ Cliphoard is a small, local-only, keyboard-first clipboard history utility for L
The core is implemented in Rust with SQLite persistence and TOML configuration. The default build intentionally keeps the GTK/X11 desktop integration behind the `gui` feature so the data model and persistence tests can run on machines without GTK development libraries.
## Install from a checkout
From the repository root, copy/paste this complete block:
```bash
sudo apt update
sudo apt install cargo rustc dpkg-dev libgtk-4-dev libdbus-1-dev libx11-dev libxfixes-dev libxtst-dev pkg-config
cargo build --release --features gui
packaging/build-deb.sh
sudo apt install ./target/cliphoard_0.1.0_amd64.deb
cliphoard
```
## Development
```bash
@@ -14,7 +27,7 @@ cargo run -- --diagnostics
To build the desktop application on Debian/Ubuntu, install the native dependencies first:
```bash
sudo apt install libgtk-4-dev libpango1.0-dev libdbus-1-dev libx11-dev libxfixes-dev libxtst-dev pkg-config
sudo apt install cargo rustc libgtk-4-dev libpango1.0-dev libdbus-1-dev libx11-dev libxfixes-dev libxtst-dev pkg-config
cargo run --features gui
```

View File

@@ -207,7 +207,7 @@ fn build_window(
.build();
let css = gtk4::CssProvider::new();
css.load_from_data(
"button.paused { background-color: #f3a6a6; color: #3d0000; font-weight: bold; }",
"button.paused { background-color: #f3a6a6; color: #3d0000; font-weight: bold; } row.pinned { background-color: rgba(79, 107, 237, 0.10); border-radius: 6px; }",
);
if let Some(display) = gtk4::gdk::Display::default() {
gtk4::style_context_add_provider_for_display(
@@ -849,6 +849,9 @@ fn refresh_list(
}
}
row.set_child(Some(&content));
if entry.pinned {
row.add_css_class("pinned");
}
row.set_tooltip_text(Some(&entry.id.to_string()));
list.append(&row);
if selected == Some(entry.id) {
@@ -915,7 +918,7 @@ fn show_text_dialog(window: &ApplicationWindow, title: &str, content: &str) {
fn show_help(window: &ApplicationWindow, shortcut: &str) {
let help = format!(
"Clipb(h)oard help\n\n\
"Cliphoard help\n\n\
Features\n\
• Records textual clipboard history locally.\n\
• Search, copy, paste, pin/unpin, delete, and clear history.\n\
@@ -936,11 +939,15 @@ substring matches, and finally fuzzy character matches. Pinned entries stay\n\
above unpinned results. Matching text is highlighted in each result.\n\n\
Install\n\
Build dependencies: GTK4, D-Bus, X11, XFixes, XTest, pkg-config, Rust, and Cargo.\n\
From the repository, run: cargo run --features gui\n\
For a package build, run the Docker build, then install it with:\n\
Copy/paste this from the repository root to build and install Cliphoard:\n\
sudo apt update\n\
sudo apt install cargo rustc dpkg-dev libgtk-4-dev libdbus-1-dev libx11-dev libxfixes-dev libxtst-dev pkg-config\n\
cargo build --release --features gui\n\
packaging/build-deb.sh\n\
sudo apt install ./target/cliphoard_0.1.0_amd64.deb\n\n\
Start it with: cliphoard\n\n\
Uninstall\n\
Run: sudo apt remove cliphoard\n\
Copy/paste: sudo apt remove cliphoard\n\
Optionally remove the local data directory shown by cliphoard --diagnostics\n\
to delete history and logs.\n",
shortcut