Publish topic guides to the wiki and document tabbed windows
Publish the guides from this repository to the GitHub Wiki. Organize them into Usage, Configuration and Development, with 15 separate configuration topics and redirects for the former website guide URLs. Add a tabbed-windows guide covering grouping, switching tabs and taking windows out. Document the scrolling indicator's defaults and limits, and link the guide from the README, shortcuts and IPC pages. Update from main, including the latest tabbed-layout changes. Separate Activities setup, configuration and publishing documentation. Review the guide prose with the unslop skill, keeping existing examples and heading links. The wiki workflow uses GitHub's built-in token to publish documentation changes on main. Validation: - 20 documentation tests pass, including README links and Activities/tab-indicator field coverage. - The publisher builds 46 wiki pages; the site build and Python syntax checks pass. - All 115 code examples from main are preserved. - The Python suite passes: 90 tests passed and 31 opt-in integration tests skipped, with the system GI module available.
This commit is contained in:
1 parent
eaeabebe73
commit
eb84104940
37 files changed
+2178
-1510
No files matched your search
@@ -0,0 +1,59 @@
|
||||
# Status controls
|
||||
|
||||
| `status` key | Type | Default | Meaning |
|
||||
| --- | --- | --- | --- |
|
||||
| `keybinding-guide` | boolean | `true` | Show the active shortcut guide at login until disabled in Settings → Keyboard & mouse → Shortcuts. |
|
||||
| `low-battery-threshold` | integer 0–100 | `20` | Warning-color threshold |
|
||||
| `settings-command` | argument array | `["ferese-settings"]` | Settings launcher; `[]` hides the action |
|
||||
|
||||
Configure the panel in **Panel & Shell** or its KDL block, as described in the
|
||||
[panel guide](../panel-configuration.md). The panel's appearance applies to every
|
||||
group, while popup and notification backgrounds follow the shared shell theme.
|
||||
Transparent gaps between islands pass clicks through to the windows beneath.
|
||||
|
||||
## Now Playing
|
||||
|
||||
The Media item can show artwork, the track title and a play/pause button wherever
|
||||
you place it in the panel. Click the artwork or title to open playback controls
|
||||
for MPRIS players; Morph presents playback in its Music view.
|
||||
Scroll over the control to change the player's volume, or
|
||||
middle-click to raise its window when supported. The menu has previous/next
|
||||
buttons, a seek slider when supported, and a player chooser. It uses the same
|
||||
colors, transparency and animations as the other bar menus.
|
||||
|
||||
Automatic selection prefers the player that most recently started playing.
|
||||
When none is playing, it selects the most recently active paused player. Players
|
||||
already running at startup have no known activity order; ties use their bus names.
|
||||
Stopped players hide the control. Pin a player through the chooser to keep it
|
||||
selected, or ignore it to exclude it. These choices last until that player leaves
|
||||
the bus or the media service reconnects. `Choose automatically` clears the pin.
|
||||
|
||||
The bar and media keys share one MPRIS monitor. Playback updates come from D-Bus
|
||||
signals. Progress updates only while the menu is open and playback is running:
|
||||
once a second, or every three seconds on battery. Album art loads while the
|
||||
bar or menu is visible, on a worker with download, decode and cache limits. A placeholder
|
||||
keeps its space while loading or when art is unavailable.
|
||||
|
||||
The default Play/Pause, Next and Previous keys use `media-play-pause`,
|
||||
`media-next` and `media-previous`. These actions take no arguments. Custom
|
||||
bindings can use them too:
|
||||
|
||||
```kdl
|
||||
binding "Super+P" "media-play-pause"
|
||||
```
|
||||
|
||||
Inspect players or control the selected one from the terminal:
|
||||
|
||||
```sh
|
||||
feresectl media
|
||||
feresectl media play-pause
|
||||
feresectl media next
|
||||
feresectl media previous
|
||||
feresectl media pin org.mpris.MediaPlayer2.example
|
||||
feresectl media ignore org.mpris.MediaPlayer2.example
|
||||
feresectl media unignore org.mpris.MediaPlayer2.example
|
||||
feresectl media auto
|
||||
```
|
||||
|
||||
`unignore` restores an ignored player even when the bar control is hidden. Apps
|
||||
without MPRIS support do not appear here.
|
||||
Reference in new issue
Block a user