setramerican.blogg.se - Linux desklets

#LINUX DESKLETS INSTALL#
#LINUX DESKLETS UPDATE#
#LINUX DESKLETS MANUAL#
#LINUX DESKLETS ARCHIVE#
#LINUX DESKLETS CODE#

If the author fails to respond in a reasonable time, we will assume the desklet is abandoned (as mentioned above) and the pull request will be merged, assuming it meets all other requirements.We view this as essentially a bugfix, but it is included here for clarification. These are not going to affect the functionality of the code, and will make the desklet available to many users who couldn't use it before due to a language barrier. If the pull request adds translations it will likewise be merged.If it is a bug fix, the PR may be merged, though if the bug is minor, or the fix could potentially impact the way the desklet works, we may wait for author approval before merging.In addition to the checks specified above, if the pull request comes from somebody other than the author, it will be held until the author reviews it or gives a thumbs-up, with the following exceptions:

#LINUX DESKLETS UPDATE#

If everything is fine, the PR is merged, the website is updated and users can see a spice update in System Settings.

#LINUX DESKLETS CODE#

The changes do not introduce malicious code or code which would negatively impact the desktop environment.

The changes respect the spices file structure.

The changes only impact spices which belong to that author.

If the author of the pull request is the spice author (his github username matches the author field in UUID/info.json), the reviewer only has to perform the following checks: Members of the cinnamon-spices-developers team review the pull request. To modify a spice, developers create a Pull Request. If you plan to abandon a desklet, please notify us, so we don't have to guess as to whether it is abandoned or not. Several factors are used to determine if a desklet is abandoned, including prolonged inactivity, failure to respond to requests, and serious breakages that have occurred due to changes in API, etc. If an author abandons their desklet, the Linux Mint team will take over maintenance of the desklet or pass it on to someone else. In that case, the "author" field in UUID/info.json will be changed to the new developer and the "original_author" field will be added to give credit to the original developer.

They cannot introduce malicious code or code which would have a negative impact on the environmentĪuthors are able to accept or refuse changes from other people which modify the features or the look of their spice.Īuthors may choose to pass on development of their desklet to someone else.

They need to respect the file structure and workflow defined here.

The author is in charge of the development of the spice.Īuthors can modify their spice under the following conditions: To check if a spice with UUID satifies those requirements run the validate-spice script in this repo: It appears both in Github and on the website.

README.md is optional and can be used to show instructions and information about the spice.

screenshot.png is a screenshot of the spice in action.

For instance, this is the file which contains the github username of the spice's author.

info.json contains information about the spice.

Else the spice won't be installable through System Settings.

The UUID/files/ directory has to be "empty", which means that it should contain ONLY the UUID directory.

when users download the ZIP from the Cinnamon Spices website).

#LINUX DESKLETS MANUAL#

The presence of this UUID directory, inside of files/ isn't actually needed by Cinnamon (as Cinnamon creates it if it's missing), but it is needed to guarantee a proper manual installation (i.e. This guarantees files aren't extracted directly onto the file system, but placed in the proper UUID directory. This is the content which is interpreted by Cinnamon itself.Īs you can see, the content of the spice isn't placed inside UUID/files/ directly, but inside UUID/files/UUID/ instead.

#LINUX DESKLETS ARCHIVE#

UUID/files/ represents the content of the ZIP archive which users can download from or which is sent to Cinnamon when installing the spice from System Settings.UUID/ is the root level directory, it includes files which are used by the website and on github.File structureĪ spice can contain many files, but it should have the following file structure: The github username of the author is specified in the spice's info.json file. That name is their UUID and it is unique. Definitions UUIDĮach spice is given a name which uniquely identifies them.

#LINUX DESKLETS INSTALL#

Users can install spices from, or directly from within Cinnamon -> System Settings. This repository hosts all the desklets available for the Cinnamon desktop environment.