jdDesktopEntryEdit

Name	jdDesktopEntryEdit JSON
Version	1.4 JSON
	download
home_page
Summary	A graphical Program to create and edit Desktop Entries
upload_time	2024-01-18 09:31:48
maintainer
docs_url	None
author
requires_python	>=3.10
license	GPL-3
keywords	jakobdev linux .desktop freedesktop
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

<h1 align="center">jdDesktopEntryEdit</h1>

<h3 align="center">A graphical Program to create and edit Desktop Entries</h3>

jdDesktopEntryEdit allows you to create and edit Desktop Entries according to the Freedesktop Specification.

Unlike other Programs, which try to make things easy by implementing only the main parts, the Goal of jdDesktopEntryEdit is to support the full specification.

## Install

### Flatpak
You can get jdDesktopEntryEdit from [Flathub](https://flathub.org/apps/details/page.codeberg.JakobDev.jdDesktopEntryEdit)

### AUR
Arch Users can get jdDesktopEntryEdit from the [AUR](https://aur.archlinux.org/packages/jddesktopentryedit)

### SourceForge
You can get Windows and AppImage Builds from [SourceForge](https://sourceforge.net/projects/jddesktopentryedit)

### pip
You can install jdDesktopEntryEdit from [PyPI](https://pypi.org/project/jdDesktopEntryEdit) using `pip`:
```shell
pip install jdDesktopEntryEdit
```
Using this Method, it will not include a Desktop Entry or any other Data file, so you need to run jdDesktopEntryEdit from the Command Line.
Use this only, when nothing else works.

#### From source
This is only for experienced Users and someone, who wants to package jdDesktopEntryEdit for a Distro.
jdDesktopEntryEdit should be installed as a Python package.
You can use `pip` or any other tool that can handle Python packages.
YOu need to have `lrelease` installed to build the Package.
After that, you should run `install-unix-datafiles.py` which wil install things like the Desktop Entry or the Icon in the correct place.
It defaults to `/usr`, but you can change it with the `--prefix` argument.
It also applies the translation to this files.
You need gettext installed to run `install-unix-datafiles.py`.

Here's a example of installing jdDesktopEntryEdit into `/usr/local`:
```shell
sudo pip install --prefix /usr/local .
sudo ./install-unix-datafiles.py --prefix /usr/local
```

## Translate
You can help translating jdDesktopEntryEdit on [Codeberg Translate](https://translate.codeberg.org/projects/jdDesktopEntryEdit)

## Develop
jdDesktopEntryEdit is written in Python and uses PyQt6 as GUI toolkit. You should have some experience in both.
You can run `jdDesktopEntryEdit.py`to start jdDesktopEntryEdit from source and test your local changes.
It ships with a few scripts in the tools directory that you need to develop.

#### CompileUI.py
This is the most important script. It will take all `.ui` files in `jdDesktopEntryEdit/ui` and compiles it to a Python class
and stores it in `jdDesktopEntryEdit/ui_compiled`. Without running this script first, you can't start jdDesktopEntryEdit.
You need to rerun it every time you changed or added a `.ui` file.

#### BuildTranslations.py
This script takes all `.ts` files and compiles it to `.qm` files.
The `.ts` files are containing the translation source and are being used during the translation process.
The `.qm` contains the compiled translation and are being used by the Program.
You need to compile a `.ts` file to a `.qm` file to see the translations in the Program.

#### UpdateTranslations.py
This regenerates the `.ts` files. You need to run it, when you changed something in the source code.
The `.ts` files are contains the line in the source, where the string to translate appears,
so make sure you run it even when you don't changed a translatable string, so the location is correct.

#### UpdateUnixDataTranslations.py
This regenerates the translation files in `deploy/translations`. these files contains the translations for the Desktop Entry and the AppStream File.
It uses gettext, as it is hard to translate this using Qt.
These files just exists to integrate the translation with Weblate, because Weblate can't translate the Desktop Entry and the AppStream file.
Make sure you run this when you edited one of these files.
You need to have gettext installed to use it.

#### UpdateTranslators.py
This uses git to get a list of all Translators and writes it to `jdDesktopEntryEdit/data/translators.json`.
This is used to display the translators in the About Dialog.
You need git to run this script.

#### WriteChangelogHtml.py
This read the Changelog from `deploy/page.codeberg.JakobDev.jdDesktopEntryEdit.metainfo.xml`, converts it to HTML and writes it to `jdDesktopEntryEdit/data/changelog.html`.
This is used to display the Changelog in the About Dialog.
You need [appstream-python](https://pypi.org/project/appstream-python) to be installed to use this script.

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "jdDesktopEntryEdit",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "",
    "keywords": "JakobDev,Linux,.desktop,freedesktop",
    "author": "",
    "author_email": "JakobDev <jakobdev@gmx.de>",
    "download_url": "https://files.pythonhosted.org/packages/8b/9a/028ba77357eb23a39d2a86bbbc611fca92b8d7d7ff5ebf8068a12518c7a3/jdDesktopEntryEdit-1.4.tar.gz",
    "platform": null,
    "description": "<h1 align=\"center\">jdDesktopEntryEdit</h1>\n\n<h3 align=\"center\">A graphical Program to create and edit Desktop Entries</h3>\n\n<p align=\"center\">\n    <img alt=\"jdDesktopEntryEdit\" src=\"screenshots/MainWindow.png\"/>\n</p>\n\njdDesktopEntryEdit allows you to create and edit Desktop Entries according to the Freedesktop Specification.\n\nUnlike other Programs, which try to make things easy by implementing only the main parts, the Goal of jdDesktopEntryEdit is to support the full specification.\n\n## Install\n\n### Flatpak\nYou can get jdDesktopEntryEdit from [Flathub](https://flathub.org/apps/details/page.codeberg.JakobDev.jdDesktopEntryEdit)\n\n### AUR\nArch Users can get jdDesktopEntryEdit from the [AUR](https://aur.archlinux.org/packages/jddesktopentryedit)\n\n### SourceForge\nYou can get Windows and AppImage Builds from [SourceForge](https://sourceforge.net/projects/jddesktopentryedit)\n\n### pip\nYou can install jdDesktopEntryEdit from [PyPI](https://pypi.org/project/jdDesktopEntryEdit) using `pip`:\n```shell\npip install jdDesktopEntryEdit\n```\nUsing this Method, it will not include a Desktop Entry or any other Data file, so you need to run jdDesktopEntryEdit from the Command Line.\nUse this only, when nothing else works.\n\n#### From source\nThis is only for experienced Users and someone, who wants to package jdDesktopEntryEdit for a Distro.\njdDesktopEntryEdit should be installed as a Python package.\nYou can use `pip` or any other tool that can handle Python packages.\nYOu need to have `lrelease` installed to build the Package.\nAfter that, you should run `install-unix-datafiles.py` which wil install things like the Desktop Entry or the Icon in the correct place.\nIt defaults to `/usr`, but you can change it with the `--prefix` argument.\nIt also applies the translation to this files.\nYou need gettext installed to run `install-unix-datafiles.py`.\n\nHere's a example of installing jdDesktopEntryEdit into `/usr/local`:\n```shell\nsudo pip install --prefix /usr/local .\nsudo ./install-unix-datafiles.py --prefix /usr/local\n```\n\n## Translate\nYou can help translating jdDesktopEntryEdit on [Codeberg Translate](https://translate.codeberg.org/projects/jdDesktopEntryEdit)\n\n## Develop\njdDesktopEntryEdit is written in Python and uses PyQt6 as GUI toolkit. You should have some experience in both.\nYou can run `jdDesktopEntryEdit.py`to start jdDesktopEntryEdit from source and test your local changes.\nIt ships with a few scripts in the tools directory that you need to develop.\n\n\n#### CompileUI.py\nThis is the most important script. It will take all `.ui` files in `jdDesktopEntryEdit/ui` and compiles it to a Python class\nand stores it in `jdDesktopEntryEdit/ui_compiled`. Without running this script first, you can't start jdDesktopEntryEdit.\nYou need to rerun it every time you changed or added a `.ui` file.\n\n#### BuildTranslations.py\nThis script takes all `.ts` files and compiles it to `.qm` files.\nThe `.ts` files are containing the translation source and are being used during the translation process.\nThe `.qm` contains the compiled translation and are being used by the Program.\nYou need to compile a `.ts` file to a `.qm` file to see the translations in the Program.\n\n#### UpdateTranslations.py\nThis regenerates the `.ts` files. You need to run it, when you changed something in the source code.\nThe `.ts` files are contains the line in the source, where the string to translate appears,\nso make sure you run it even when you don't changed a translatable string, so the location is correct.\n\n####  UpdateUnixDataTranslations.py\nThis regenerates the translation files in `deploy/translations`. these files contains the translations for the Desktop Entry and the AppStream File.\nIt uses gettext, as it is hard to translate this using Qt.\nThese files just exists to integrate the translation with Weblate, because Weblate can't translate the Desktop Entry and the AppStream file.\nMake sure you run this when you edited one of these files.\nYou need to have gettext installed to use it.\n\n#### UpdateTranslators.py\nThis uses git to get a list of all Translators and writes it to `jdDesktopEntryEdit/data/translators.json`.\nThis is used to display the translators in the About Dialog.\nYou need git to run this script.\n\n#### WriteChangelogHtml.py\nThis read the Changelog from `deploy/page.codeberg.JakobDev.jdDesktopEntryEdit.metainfo.xml`, converts it to HTML and writes it to `jdDesktopEntryEdit/data/changelog.html`.\nThis is used to display the Changelog in the About Dialog.\nYou need [appstream-python](https://pypi.org/project/appstream-python) to be installed to use this script.\n",
    "bugtrack_url": null,
    "license": "GPL-3",
    "summary": "A graphical Program to create and edit Desktop Entries",
    "version": "1.4",
    "project_urls": {
        "Donation": "https://ko-fi.com/jakobdev",
        "Issues": "https://codeberg.org/JakobDev/jdDesktopEntryEdit/issues",
        "Source": "https://codeberg.org/JakobDev/jdDesktopEntryEdit",
        "Translate": "https://translate.codeberg.org/projects/jdDesktopEntryEdit"
    },
    "split_keywords": [
        "jakobdev",
        "linux",
        ".desktop",
        "freedesktop"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2185fc4e463cad4a4bee6ea7450aa11105f4b730cdf28a1aac9682cdc8864310",
                "md5": "eff8365c4ded1573ff5da118921561f3",
                "sha256": "90824f3ae2114e35c389038d0320b367111c1b22424320c79f51085c57e20709"
            },
            "downloads": -1,
            "filename": "jdDesktopEntryEdit-1.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "eff8365c4ded1573ff5da118921561f3",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 74379,
            "upload_time": "2024-01-18T09:31:46",
            "upload_time_iso_8601": "2024-01-18T09:31:46.274511Z",
            "url": "https://files.pythonhosted.org/packages/21/85/fc4e463cad4a4bee6ea7450aa11105f4b730cdf28a1aac9682cdc8864310/jdDesktopEntryEdit-1.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8b9a028ba77357eb23a39d2a86bbbc611fca92b8d7d7ff5ebf8068a12518c7a3",
                "md5": "4e0d475988fee46f96a566bd89210612",
                "sha256": "cee28f5f5f46d569fade9f82577f913627b243459079a21ac4e18179d9b6e288"
            },
            "downloads": -1,
            "filename": "jdDesktopEntryEdit-1.4.tar.gz",
            "has_sig": false,
            "md5_digest": "4e0d475988fee46f96a566bd89210612",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 55749,
            "upload_time": "2024-01-18T09:31:48",
            "upload_time_iso_8601": "2024-01-18T09:31:48.407400Z",
            "url": "https://files.pythonhosted.org/packages/8b/9a/028ba77357eb23a39d2a86bbbc611fca92b8d7d7ff5ebf8068a12518c7a3/jdDesktopEntryEdit-1.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-18 09:31:48",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": true,
    "codeberg_user": "JakobDev",
    "codeberg_project": "jdDesktopEntryEdit",
    "lcname": "jddesktopentryedit"
}