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

[repo.xml]: Add how to on customizing app icon #617

Open
joewiz opened this issue May 17, 2021 · 0 comments
Open

[repo.xml]: Add how to on customizing app icon #617

joewiz opened this issue May 17, 2021 · 0 comments

Comments

@joewiz
Copy link
Member

joewiz commented May 17, 2021

Describe the problem

The Package Repository article should describe how app icons work and how to supply one's own icon for an app. While not explicitly part of repo.xml or expath-pkg.xml, the icon facility is part of a package's metadata. It represents the app in apps like the public repo and the dashboard package manager. Its naming convention, supported formats, and any other important guidelines (resolution? dimensions? aspect ratio?) should be documented. The location of the default eXist icon should also be noted.

Context

On the e-editiones Slack community channel, @arojascastro asked:

do you know how to change the logo that appears in the eXist Launcher?

@duncdrum responded:

add your own icon.svg or icon.png at the root of your application repo.

you ll probably have to restart to see the changes take effect

@djbpitt suggested that this should be documented:

For what it’s worth: When I needed, a couple of years ago, to change the logo in the dashboard) for an app I was developing, I couldn’t find information about how to do that in the eXist-db documentation. I finally figured it out by copying someone else’s code (thanks, Joe!), but if it’s still missing from the documentation, it would be a small but welcome addition.

Screenshots

Accompanying illustration to @arojascastro's post:

launcher_logo

Please provide the following

  • exist-db version: 5.2.0
  • documentation version: 5.2.0
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

No branches or pull requests

1 participant