Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create a new doc page for Main UI‘s special features #2188

Closed
wants to merge 14 commits into from

Conversation

florian-h05
Copy link
Contributor

@florian-h05 florian-h05 commented Dec 27, 2023

This new page aims at documenting „special“ features of Main UI that really need documentation, like the developer sidebar search (content moved from the tips & tricks section), web audio sink support or the UI Command Item (openhab/openhab-webui#2055).

Copy link

netlify bot commented Dec 27, 2023

Thanks for your pull request to the openHAB documentation! The result can be previewed at the URL below (this comment and the preview will be updated if you add more commits).

Name Link
🔨 Latest commit 910ae8c
🔍 Latest deploy log https://app.netlify.com/sites/openhab-docs-preview/deploys/6591979d9d2d8d0008cc3968
😎 Deploy Preview https://deploy-preview-2188--openhab-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@florian-h05 florian-h05 marked this pull request as ready for review December 27, 2023 12:14
@florian-h05
Copy link
Contributor Author

Preview: https://deploy-preview-2188--openhab-docs-preview.netlify.app/docs/ui/mainui.html

@digitaldan FYI this adds the docs for the UI command Item.

Copy link
Contributor

@digitaldan digitaldan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @florian-h05 !!!!!

ui/mainui.md Outdated Show resolved Hide resolved
ui/building-pages.md Outdated Show resolved Hide resolved
- label & service id of persistence service
- Items persisted by persistence service

## Web Audio Sink
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This Info is also available here: https://www.openhab.org/docs/settings/aboutpage.html#enable-web-audio-sink-support
Please merge the content of the two pages and link accordingly.

ui/mainui.md Outdated

Main UI implements a web audio sink, which means the openHAB server can play audio through on a client device through the browser.

To enable web audio sink support for a client, open the "Help & About" page from the menu and turn on the "Enable Web Audio sink support" option.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

open the "Help & About" page -> Link to aboutpage.html#enable-web-audio-sink-support

ui/mainui.md Outdated
Main UI can be controlled from the openHAB server by setting up a so-called UI command Item.

Similarly to web audio support, this is a setting specific to your local browser environment, so you have to define the UI command Item for each client, which also allows you to different UI command Items for different clients.
To setup an Item as the UI command Item on your device, open the "Help & About" page from the menu and select an Item for "Listen for UI command to".
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To setup an Item as the UI command Item on your device, first create a particular Item of type String, then open the ...
"Help & About" -> link page, see above

ui/mainui.md Outdated
Currently, the supported commands are:

- `navigate:$path`:
Navigate to a given `$path`, e.g. `navigate:/locations` to navigate to the "Locations" tab of the home page or `navigate:/page/my_custom_page` to navigate to a page with the ID `my_custom_page`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This would make the particular client to open that page automatically. For example, you could listen to the door bell and open a video camera page of the door automatically.

ui/mainui.md Show resolved Hide resolved
ui/mainui.md Outdated
- `close`:
Close all popups, popovers and sheets.
- `back`:
Naviate back.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Navigate


### Enable Web Audio sink support

- This setting is also part of the miscellaneous settings.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

From here on:

I have the feeling you deleted most of what I have written here. Please don't as I have put quite an amount of work by providing context, background and examples into it.

You move around redundant information but don't drop it, thanks.

Signed-off-by: Florian Hotze <[email protected]>
Signed-off-by: Florian Hotze <[email protected]>
Signed-off-by: Florian Hotze <[email protected]>
Signed-off-by: Florian Hotze <[email protected]>
Signed-off-by: Florian Hotze <[email protected]>
Signed-off-by: Florian Hotze <[email protected]>
Signed-off-by: Florian Hotze <[email protected]>
Signed-off-by: Florian Hotze <[email protected]>
Signed-off-by: Florian Hotze <[email protected]>
Signed-off-by: Florian Hotze <[email protected]>
@florian-h05
Copy link
Contributor Author

Superseded by #2198.

@florian-h05 florian-h05 closed this Jan 3, 2024
@florian-h05 florian-h05 deleted the mainui branch January 17, 2024 21:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants