diff --git a/.gitignore b/.gitignore deleted file mode 100644 index 378eac2..0000000 --- a/.gitignore +++ /dev/null @@ -1 +0,0 @@ -build diff --git a/AUTHORS b/AUTHORS index 5b94db3..a66be6d 100644 --- a/AUTHORS +++ b/AUTHORS @@ -4,7 +4,7 @@ Upstream Authors: Copyright: Copyright (c) 2010-2012 Razor team - Copyright (c) 2012-2014 LXQt team + Copyright (c) 2012-2016 LXQt team License: LGPL-2.1+ The full text of the licenses can be found in the 'COPYING' file. diff --git a/CMakeLists.txt b/CMakeLists.txt index 7a02dfe..d8ef2f9 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -68,6 +68,16 @@ lxqt_translate_ts(lxqt-policykit-agent_QM_FILES ${lxqt-policykit-agent_UI} INSTALL_DIR "${LXQT_TRANSLATIONS_DIR}/${PROJECT_NAME}" + PULL_TRANSLATIONS + ${PULL_TRANSLATIONS} + CLEAN_TRANSLATIONS + ${CLEAN_TRANSLATIONS} + TRANSLATIONS_REPO + ${TRANSLATIONS_REPO} + TRANSLATIONS_REFSPEC + ${TRANSLATIONS_REFSPEC} + REPO_SUBDIR + "lxqt-policykit/${PROJECT_NAME}" ) lxqt_app_translation_loader(QM_LOADER ${PROJECT_NAME}) diff --git a/README.md b/README.md new file mode 100644 index 0000000..39c77df --- /dev/null +++ b/README.md @@ -0,0 +1,75 @@ +# lxqt-policykit + +## Overview + +lxqt-policykit is the polkit authentification agent of LXQt. + +[polkit](https://www.freedesktop.org/wiki/Software/polkit/) is a software framework to handle privileges of processes. +In LXQt it is e. g. used to extend the privileges of the GUI tools of [lxqt-admin](https://github.com/lxde/lxqt-admin/). +These are launched by a regular user. But in order to apply the settings that can be adjusted root privileges are needed +and acquired via polkit. + +Among the various components of polkit the authentication agent is the one to query the user for credentials and hence +comes with its own GUI like this one of lxqt-policykit. + +![lxqt-policykit: GUI](lxqt-policykit_gui.png) + +While there's only a single implementation of all other polkit components there are various different authentication +agents provided by the various desktop environments. Normally these can be used interchangeably, that is lxqt-policykit +can be used in an LXDE session or lxpolkit, the authentication agent of LXDE, can be used in an Xfce session. Normally +it's better to use the implementation provided by a distinct desktop environment as it integrates better, though. + +Technically, lxqt-policykit is just a single binary `lxqt-policykit-agent` which has to be running all over the LXQt +sessions and is therefor launched as so-called LXQt Module, see [Configuration](#configuration). + +Note that the naming lxqt-policykit is strictly speaking an anachronism. It refers to Policykit which was the predecessor +of polkit. The name wasn't changed when Policykit was replaced by polkit as both provide roughly the same features albeit +they are technically different. + +## Installing + +### Compiling sources + +Runtime dependencies are [liblxqt](https://github.com/lxde/liblxqt) and its dependency +[libqtxdg](https://github.com/lxde/libqtxdg) as well as polkit-qt5, to build Git and CMake are needed in addition. +By default lxqt-policykit is pulling translations from repository [translations](https://github.com/lxde/translations/) at +compile time, see file README.md of the latter. + +To compile, run `cmake`, `make` and `make install`. +`cmake` can be invoked in an out of source build directory and will normally need variable `-DCMAKE_INSTALL_PREFIX=/usr`. +`make install` can be invoked with `DESTDIR=`. + +### Binary packages + +#### Arch Linux + +The latest release is provided by package `lxqt-policykit` in repository community, the actual master checkout can be +compiled by packages `lxqt-policykit-git` from the [AUR](https://aur.archlinux.org). + +#### Debian + +Package `lxqt-policykit` is available in the official repositories as of Debian stretch. For now it is comprising the +translations as well but these will probably be outsourced in package `lxqt-policykit-l10n` one day. + +#### Fedora + +Package `lxqt-policykit` is available as of Fedora 22. + +#### openSUSE + +Package `lxqt-policykit` is providing the binary, `lxqt-policykit-lang` the translations. Both are available as of +openSUSE Leap 42.1. + +## Configuration + +As mentioned in section [Overview](#overview) binary `lxqt-policykit-agent` is started as LXQt Module, which is a particular +way of LXQt to launch binaries at the beginning of an LXQt session and keep them running all the time. +This is handled by desktop entry file `/etc/xdg/autostart/lxqt-policykit-agent.desktop`. It belongs to +[lxqt-common](https://github.com/lxde/lxqt-common/) and is featuring key `OnlyShowIn=LXQt;` restricting it to LXQt sessions. +So no further action has to be taken as far as LXQt is concerned. In order to use lxqt-policykit in other sessions the key has +to be modified accordingly and/or removed, optionally after copying the file to a user specific directory, normally +`~/.config/autostart/`. + +## Usage + +From a user's point of view the usage is limited to interacting with the GUI as seen above. diff --git a/lxqt-policykit_gui.png b/lxqt-policykit_gui.png new file mode 100644 index 0000000..cb72296 Binary files /dev/null and b/lxqt-policykit_gui.png differ diff --git a/translations/lxqt-policykit-agent.ts b/translations/lxqt-policykit-agent.ts deleted file mode 100644 index 31ee586..0000000 --- a/translations/lxqt-policykit-agent.ts +++ /dev/null @@ -1,51 +0,0 @@ - - - - - LXQtPolicykit::PolicykitAgent - - - - PolicyKit Information - - - - - Another authentization in progress. Please try it again later. - - - - - Authorization Failed - - - - - Authorization failed for some reason - - - - - PolicyKit Error - - - - - PolicykitAgentGUI - - - Authentication Required - - - - - Identity: - - - - - Password: - - - - diff --git a/translations/lxqt-policykit-agent_de.ts b/translations/lxqt-policykit-agent_de.ts deleted file mode 100644 index f889855..0000000 --- a/translations/lxqt-policykit-agent_de.ts +++ /dev/null @@ -1,51 +0,0 @@ - - - - - LXQtPolicykit::PolicykitAgent - - - - PolicyKit Information - PolicyKit Information - - - - Another authentization in progress. Please try it again later. - Eine andere Authentisierung wird gerade durchgeführt. Bitte später noch einmal versuchen. - - - - Authorization Failed - Autorisierung fehlgeschlagen - - - - Authorization failed for some reason - Autorisierung aus irgendeinem Grund fehlgeschlagen - - - - PolicyKit Error - PolicyKit Fehler - - - - PolicykitAgentGUI - - - Authentication Required - Authentisierung benötigt - - - - Identity: - Identität: - - - - Password: - Kennwort: - - - diff --git a/translations/lxqt-policykit-agent_el.ts b/translations/lxqt-policykit-agent_el.ts deleted file mode 100644 index d229859..0000000 --- a/translations/lxqt-policykit-agent_el.ts +++ /dev/null @@ -1,51 +0,0 @@ - - - - - LXQtPolicykit::PolicykitAgent - - - - PolicyKit Information - Πληροφορίες PolicyKit - - - - Another authentization in progress. Please try it again later. - Μια άλλη ταυτοποίηση είναι σε εξέλιξη. Παρακαλώ προσπαθήστε ξανά αργότερα. - - - - Authorization Failed - Η ταυτοποίηση απέτυχε - - - - Authorization failed for some reason - Η ταυτοποίηση για κάποια αιτία απέτυχε - - - - PolicyKit Error - Σφάλμα PolicyKit - - - - PolicykitAgentGUI - - - Authentication Required - Απαιτείται ταυτοποίηση - - - - Identity: - Ταυτότητα: - - - - Password: - Κωδικός πρόσβασης: - - - diff --git a/translations/lxqt-policykit-agent_hu.ts b/translations/lxqt-policykit-agent_hu.ts deleted file mode 100644 index 20df8b9..0000000 --- a/translations/lxqt-policykit-agent_hu.ts +++ /dev/null @@ -1,51 +0,0 @@ - - - - - LXQtPolicykit::PolicykitAgent - - - - PolicyKit Information - Policykit információ - - - - Another authentization in progress. Please try it again later. - - - - - Authorization Failed - Hitelesítés sikertelen - - - - Authorization failed for some reason - Hitelesítés valami miatt sikertelen - - - - PolicyKit Error - Policykit hiba - - - - PolicykitAgentGUI - - - Authentication Required - Hitelesítés kell - - - - Identity: - Név: - - - - Password: - Jelszó: - - - diff --git a/translations/lxqt-policykit-agent_pt.ts b/translations/lxqt-policykit-agent_pt.ts deleted file mode 100644 index cc56168..0000000 --- a/translations/lxqt-policykit-agent_pt.ts +++ /dev/null @@ -1,51 +0,0 @@ - - - - - LXQtPolicykit::PolicykitAgent - - - - PolicyKit Information - Informaçoes PolicyKit - - - - Another authentization in progress. Please try it again later. - - - - - Authorization Failed - Falha de autenticação - - - - Authorization failed for some reason - A autenticação falhou por alguma razão - - - - PolicyKit Error - Erro PolicyKit - - - - PolicykitAgentGUI - - - Authentication Required - Requer autenticação - - - - Identity: - Identidade: - - - - Password: - Senha: - - - diff --git a/translations/lxqt-policykit-agent_ru.ts b/translations/lxqt-policykit-agent_ru.ts deleted file mode 100644 index 1ad2255..0000000 --- a/translations/lxqt-policykit-agent_ru.ts +++ /dev/null @@ -1,51 +0,0 @@ - - - - - LXQtPolicykit::PolicykitAgent - - - - PolicyKit Information - Информация PolicyKit - - - - Another authentization in progress. Please try it again later. - - - - - Authorization Failed - Авторизация не удалась - - - - Authorization failed for some reason - Авторизация не удалась по какой-то причине - - - - PolicyKit Error - Ошибка PolicyKit - - - - PolicykitAgentGUI - - - Authentication Required - Требуется аутентификация - - - - Identity: - Идентификация: - - - - Password: - Пароль: - - - diff --git a/translations/lxqt-policykit-agent_ru_RU.ts b/translations/lxqt-policykit-agent_ru_RU.ts deleted file mode 100644 index 06c8602..0000000 --- a/translations/lxqt-policykit-agent_ru_RU.ts +++ /dev/null @@ -1,51 +0,0 @@ - - - - - LXQtPolicykit::PolicykitAgent - - - - PolicyKit Information - Информация PolicyKit - - - - Another authentization in progress. Please try it again later. - - - - - Authorization Failed - Авторизация не удалась - - - - Authorization failed for some reason - Авторизация не удалась по какой-то причине - - - - PolicyKit Error - Ошибка PolicyKit - - - - PolicykitAgentGUI - - - Authentication Required - Требуется аутентификация - - - - Identity: - Идентификация: - - - - Password: - Пароль: - - -