Thiago Sueto authored Sep 07, 2022 and Nicolas Fella committed Sep 07, 2022

This MR:

* Bumps the runtime version up
* Prefers and elaborates upon x11-fallback
* Most importantly, recommends installation of development flatpaks as --user instead of root

Replace with https://web.archive.org/web/20120305211113/http://www.baxleydesign.com/pdfs/dux03_baxleyUIModel.pdf

Having everything in a single line chokes git

The script expects the metadata to be .desktop files, but we use .json nowadays

Fixes #81

It's a standard python module, no need to add it there, which actually breaks things

Use same install prefix as kdesrc-build uses by default

Drop some unneeded fluff

Make some wording more accurate

Use kcoreaddons_add_plugin and kcmutils_generate_desktop_file

Remove unneeded stuff

Thiago Sueto authored Aug 23, 2022 and Nicolas Fella committed Aug 23, 2022

* Use KDECompilerSettings instead of KDEFrameworksCompilerSettings
* Fix json file name
* witches the build instructions to use only cmake
* Remove bash syntax from files list
* Add links to other content

Helio Loureiro authored Jul 28, 2022 and Ben Cooksley committed Aug 07, 2022

  - Code refactored.
  - Handling failed urls fetched.

process applets in tray also

(cherry picked from commit d02b3ccb)

This reverts commit d02b3ccb

process applets in tray also

It was never updated to reflect the current requirements after the HIG
was moved to this repo.

A lot of what was on this page was outdated and not matching the
current state of KDE software. This commit fixes those issues.

Natalie Clarius authored Jun 29, 2022 and Vlad Zahorodnii committed Jun 29, 2022

I made a number of additions and corrections to the KWin scripting tutorial with things that either tripped me up when I first got into it or which I saw asked about by others. 

Main points:  
- where to find the output from the console or installed scripts
- warn that the console output window will not show any output and how to retrieve it instead
- warn that configuration button will not be visible without manual intervention on older Plasma version and how to fix it
- clearer depiction of package structure
- use `metadata.json` instead of deprecated `metadata.desktop`
- add info that installed scripts must be enabled after installation
- more info about where to find installed scripts and how to publish them
- new section with basic tutorial on how to set up a user configuration (declaration + UI)


To do (in MRs in the future):  
- more thorough explanation and example of a configuration menu (in progress)
- once the merging of the abstract client and toplevel classes and the renaming of 'client' to 'window' is reflected in the API, change the section on clients
- the actual API documentation! It’s bad. Unfortunately I don’t understand enough about how the interiors of the scripting module work to act on this myself (yet), but:
  - Many elements that actually are exposed to the API are just completely missing from the documentation - most notably the pretty important `workspace.clientList()`. And just print out a client object and look at all the available but undocumented keys, e.g. [stacking order](https://bugs.kde.org/show_bug.cgi?id=409889). 
  - Half of the elements don’t have any description at all.
  - Some entries could use more thorough explanation and usage examples, in particular the global objects and functions such as `options`,  `registerShortcut` and `callDBus`.  
  - Some of the documented functionality [is broken](https://www.reddit.com/r/kde/comments/s5kfdg/comment/hszbo79/?utm_source=share&utm_medium=web2x&context=3).
  - Some information appears to be outright incorrect, e.g. `workspace.activateClient(client)` doesn’t seem to work, but `workspace.activeClient = client` does?
  - Not as a matter of the documentation but the API itself, there are a few functions and properties that would useful to have exposed to the API but currently aren’t (e.g. a client list sorted in stacking order and a client `maximized` property would be useful).

Chris Holland authored May 26, 2022 and Chris Holland committed Jun 19, 2022

The current docs suggest Copying audio-volume-high.svg and Pasting to
icons/audio-volume-high.svg but that will not work.

I also added a blurb about how to make the Plasma Style fallback to
icons from the current Icon Theme.