Samuel Onoja
eb84104940
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.
52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
# Panel composition
|
|
|
|
Ferese uses one panel configuration across all outputs, with each output laying
|
|
out its own workspace controls and focused-window title. Open **Settings →
|
|
Panel & Shell** to choose a style and position, then **Edit panel** to arrange
|
|
items in Start, Center and End groups. The composition preview stays visible
|
|
while you edit, and changes save automatically.
|
|
|
|
Choose style, opacity and corners for the whole panel; groups control layout and
|
|
spacing. The available styles are Floating, Capsules, Notch, Edge to edge,
|
|
Fused islands, Adaptive and Morph. Capsules and Fused islands join neighboring
|
|
**groups within a zone**, so a zone with one group remains a single island.
|
|
Adaptive follows window state independently on each output, while Morph combines
|
|
the panel into a centered hub with expandable workspace, media and status views.
|
|
|
|
Most panels default to 36 logical pixels high, Morph to 34, and detached styles
|
|
use 8-pixel margins unless your configuration overrides them. The packaged
|
|
configuration includes its own geometry overrides. For the complete options and
|
|
examples, see the [panel configuration guide](../panel-configuration.md).
|
|
|
|
```kdl
|
|
panel "main" {
|
|
edge "top"
|
|
style "floating"
|
|
geometry { height 36; edge-margin 8; window-clearance 4; }
|
|
start {
|
|
group "navigation" {
|
|
item "overview" kind="overview" overflow="never"
|
|
item "workspaces" kind="workspaces" style="dots" overflow="never"
|
|
}
|
|
}
|
|
center {
|
|
group "title" {
|
|
item "title" kind="focused-window" overflow="never"
|
|
}
|
|
}
|
|
end {
|
|
group "status" {
|
|
item "quick-settings" kind="quick-settings"
|
|
item "battery" kind="battery" percentage=#true
|
|
item "clock" kind="clock" representation="compact"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
If you omit the panel block, Ferese uses its default composition; if you write
|
|
one, its groups and items define the contents, and empty zones stay empty. Only
|
|
one panel block is accepted, and group and item IDs must be unique within it.
|
|
Use `edge "bottom"` to move the same arrangement to the bottom, with popups
|
|
opening toward the desktop and edge-relative corners mirroring vertically.
|