Compare revisions

stages:

  - build

ubuntu_deb:

  stage: build

  image: ubuntu:14.04

  only:

    - master

    - /^release\-.+/

  script:

    - ./scripts/package ubuntu_deb

  artifacts:

    paths:

    - build_*/ocs-url*.deb

    expire_in: 2 days

fedora_rpm:

  stage: build

  image: fedora:20

  only:

    - master

    - /^release\-.+/

  script:

    - ./scripts/package fedora_rpm

  artifacts:

    paths:

    - build_*/RPMS/x86_64/ocs-url*.rpm

    expire_in: 2 days

opensuse_rpm:

  stage: build

  image: opensuse:42.3

  only:

    - master

    - /^release\-.+/

  script:

    - ./scripts/package opensuse_rpm

  artifacts:

    paths:

    - build_*/RPMS/x86_64/ocs-url*.rpm

    expire_in: 2 days

archlinux_pkg:

  stage: build

  image: archlinux/base:latest

  only:

    - master

    - /^release\-.+/

  script:

    - ./scripts/package archlinux_pkg

  artifacts:

    paths:

    - build_*/ocs-url*.pkg.tar.xz

    expire_in: 2 days

dist: trusty

sudo: required

services:

  - docker

branches:

  only:

    - master

    - /^release\-.+/

script:

  - mntdir='/mnt/ocs-url'

  - docker run --rm -v $(pwd):${mntdir} ubuntu:14.04 /bin/bash -c "${mntdir}/scripts/package ci_ubuntu_deb"

  - docker run --rm -v $(pwd):${mntdir} fedora:20 /bin/bash -c "${mntdir}/scripts/package ci_fedora_rpm"

  - docker run --rm -v $(pwd):${mntdir} opensuse:42.1 /bin/bash -c "${mntdir}/scripts/package ci_opensuse_rpm"

  - docker run --rm -v $(pwd):${mntdir} base/archlinux:latest /bin/bash -c "${mntdir}/scripts/package ci_archlinux_pkg"

  - cat transfer.log

# ocs-url

[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

[![Build Status](https://travis-ci.org/opendesktop/ocs-url.svg?branch=master)](https://travis-ci.org/opendesktop/ocs-url)

An install helper program for items served on OpenCollaborationServices (OCS).

An install helper program for items served via OpenCollaborationServices (ocs://).

Copyright: 2016-2018, Opendesktop.org

Copyright: 2016-2019, Opendesktop.org

License: GPL-3+

Download Linux package from:

https://www.linux-apps.com/p/1136805/

https://www.opendesktop.org/p/1136805/

And please check the ocs-url wiki for more information.

https://github.com/opendesktop/ocs-url/wiki

And please see docs/* for more information.

{

    "id": "ocs-url",

    "name": "ocs-url",

    "version": "3.0.3",

    "version": "3.1.0",

    "organization": "Opendesktop.org",

    "domain": "org.opendesktop.ocs-url",

    "icon": ":/desktop/ocs-url.svg",

    "description": "An install helper program for items served on OpenCollaborationServices (OCS).",

    "description": "An install helper program for items served via OpenCollaborationServices (ocs://).",

    "license": "GPL-3+",

    "author": "Opendesktop.org",

    "contact": "contact@opendesktop.org",

    "homepage": "https://github.com/opendesktop/ocs-url"

    "homepage": "https://git.opendesktop.org/akiraohgaki/ocs-url"

}

# How to install

## Install from package

Download Linux package from: https://www.opendesktop.org/p/1136805/

Then click the downloaded package and continue to installation with package manager.

Or install the downloaded package using terminal:

Ubuntu 14.04

    $ sudo apt install libqt5svg5 qtdeclarative5-qtquick2-plugin qtdeclarative5-window-plugin qtdeclarative5-controls-plugin

    $ sudo dpkg -i /path/to/ocs-url*.deb

Ubuntu 16.04

    $ sudo apt install libqt5svg5 qml-module-qtquick-controls

    $ sudo dpkg -i /path/to/ocs-url*.deb

Fedora 20

    # yum insall qt5-qtbase qt5-qtbase-gui qt5-qtsvg qt5-qtdeclarative qt5-qtquickcontrols

    # rpm -i /path/to/ocs-url*.rpm

Fedora 22

    # dnf insall qt5-qtbase qt5-qtbase-gui qt5-qtsvg qt5-qtdeclarative qt5-qtquickcontrols

    # rpm -i /path/to/ocs-url*.rpm

openSUSE 42.1

    # zypper install libQt5Svg5 libqt5-qtquickcontrols

    # rpm -i /path/to/ocs-url*.rpm

Arch Linux

    # pacman -S qt5-base qt5-svg qt5-declarative qt5-quickcontrols

    # pacman -U /path/to/ocs-url*.pkg.tar.xz

## Install from source

Make git clone, or download the source archive and extract it.

Build and install

    $ cd /path/to/ocs-url

    $ ./scripts/prepare

    $ qmake PREFIX=/usr

    $ make

    $ sudo make install

Uninstall

    $ sudo make uninstall

# How to use

## Web browser

Just click a OCS-URL (ocs://) links, or type OCS-URL in browser's address bar.

If you use Firefox, a program selection window opens the first time you open OCS-URL,

and you can choose "ocs-url" as custom URL handler.

If you don't get the program selection window or you are using another browser,

please set the ocs-url program as custom URL handler for ocs:// scheme in the browser's settings.

## Command-line

Execute ocs-url program with argument OCS-URL.

    $ ocs-url "ocs://install?url=http%3A%2F%2Fexample.com%2Ficons.tar.gz&type=icons"

# Internationalization

ocs-url/i18n/ is sub project for program internationalization.

## Localization for program

Using two tools lupdate and lrelease to make translation.

Text is gathered from program source files and included in QM files for translation along with other resource files.

### Creating TS (Translation Source) files

To generate TS files, sets TS file name to definition TRANSLATIONS in i18n.pro and run lupdate with i18n.pro.

    $ cd /path/to/ocs-url/i18n/

    $ lupdate i18n.pro

Then adds translations to the generated TS files using Qt Linguist or text editor.

### Creating QM (Qt Message) files

To generate QM files, run lrelease with i18n.pro.

    $ cd /path/to/ocs-url/i18n/

    $ lrelease i18n.pro

Then adds the path of the generated QM files to i18n.qrc.

# OCS-URL specification

OCS-URL is a custom URL that represent the installation method of items served on OpenCollaborationServices (OCS).

## URL structure

    [scheme]://[command]?[query string]

For example:

    ocs://install?url=http%3A%2F%2Fexample.com%2Ficons.tar.gz&type=icons

## Scheme

Scheme | Description

-------|------------

ocs | ocs scheme

ocss | ocs scheme for secure protocol

"ocss" scheme is the same of the ocs scheme for now,

it's a reserved name for secure protocol in the future.

## Command

Command | Description

--------|------------

download | Download the file from specified URL to the installation destination of specified install-type.

install | Make file downloading and trigger installation process.

## Query string

OCS-URL's query string is an option of command.

*All query string values should be urlencoded.*

Parameter | Required | Default | Description

----------|----------|---------|------------

url | Yes | - | File URL

type | - | downloads | Install-type

filename | - | File name from URL | Alternative file name

"filename" option is useful if the file URL does not represent a file name.

### Install-type

Available install-type:

Install-type | Installation destination

-------------|------------------

bin | $HOME/.local/bin

downloads | $HOME/Downloads

documents | $HOME/Documents

pictures | $HOME/Pictures

music | $HOME/Music

videos | $HOME/Videos

wallpapers | $XDG_DATA_HOME/wallpapers

fonts | $HOME/.fonts

cursors | $HOME/.icons

icons | $XDG_DATA_HOME/icons

emoticons | $XDG_DATA_HOME/emoticons

themes | $HOME/.themes

emerald_themes | $HOME/.emerald/themes

enlightenment_themes | $HOME/.e/e/themes

enlightenment_backgrounds | $HOME/.e/e/backgrounds

fluxbox_styles | $HOME/.fluxbox/styles

pekwm_themes | $HOME/.pekwm/themes

icewm_themes | $HOME/.icewm/themes

plasma_plasmoids | $XDG_DATA_HOME/plasma/plasmoids

plasma_look_and_feel | $XDG_DATA_HOME/plasma/look-and-feel

plasma_desktopthemes | $XDG_DATA_HOME/plasma/desktoptheme

kwin_effects | $XDG_DATA_HOME/kwin/effects

kwin_scripts | $XDG_DATA_HOME/kwin/scripts

kwin_tabbox | $XDG_DATA_HOME/kwin/tabbox

aurorae_themes | $XDG_DATA_HOME/aurorae/themes

dekorator_themes | $XDG_DATA_HOME/deKorator/themes

qtcurve | $XDG_DATA_HOME/QtCurve

color_schemes | $XDG_DATA_HOME/color-schemes

gnome_shell_extensions | $XDG_DATA_HOME/gnome-shell/extensions

cinnamon_applets | $XDG_DATA_HOME/cinnamon/applets

cinnamon_desklets | $XDG_DATA_HOME/cinnamon/desklets

cinnamon_extensions | $XDG_DATA_HOME/cinnamon/extensions

nautilus_scripts | $XDG_DATA_HOME/nautilus/scripts

amarok_scripts | $KDEHOME/share/apps/amarok/scripts

yakuake_skins | $KDEHOME/share/apps/yakuake/skins

cairo_clock_themes | $HOME/.cairo-clock/themes

books | $APP_DATA/books

comics | $APP_DATA/comics

$APP_DATA is not environment variable, it's internal variable in the program and expressed to $XDG_DATA_HOME/{application ID or name}.

Available alias name of the install-type:

Alias | Install-type

------|-------------

gnome_shell_themes | themes

cinnamon_themes | themes

gtk2_themes | themes

gtk3_themes | themes

metacity_themes | themes

xfwm4_themes | themes

openbox_themes | themes

kvantum_themes | themes

compiz_themes | emerald_themes

beryl_themes | emerald_themes

plasma4_plasmoids | plasma_plasmoids

plasma5_plasmoids | plasma_plasmoids

plasma5_look_and_feel | plasma_look_and_feel

plasma5_desktopthemes | plasma_desktopthemes

plasma_color_schemes | color_schemes

# Maintainer: Akira Ohgaki <akiraohgaki@gmail.com>

pkgname='ocs-url'

pkgver='3.0.3'

pkgver='3.1.0'

pkgrel='1'

pkgdesc='An install helper program for items served on OpenCollaborationServices (OCS).'

pkgdesc='An install helper program for items served via OpenCollaborationServices (ocs://).'

arch=('i686' 'x86_64')

url='https://github.com/opendesktop/ocs-url'

url='https://git.opendesktop.org/akiraohgaki/ocs-url'

license=('GPL3')

depends=('qt5-base>=5.2.0' 'qt5-svg>=5.2.0' 'qt5-declarative>=5.2.0' 'qt5-quickcontrols>=5.2.0')

makedepends=('git')

#source=("https://github.com/opendesktop/ocs-url/archive/release-${pkgver}.tar.gz")

#source=("https://git.opendesktop.org/akiraohgaki/ocs-url/-/archive/release-${pkgver}/ocs-url-release-${pkgver}.tar.gz")

source=("${pkgname}.tar.gz")

md5sums=() #autofill using updpkgsums

Summary: OCS-URL

Name: ocs-url

Version: 3.0.3

Version: 3.1.0

Release: 1%{?dist}

License: GPLv3+

Group: Applications/Internet

URL: https://github.com/opendesktop/ocs-url

URL: https://git.opendesktop.org/akiraohgaki/ocs-url

#Source0: https://github.com/opendesktop/ocs-url/archive/release-%{version}.tar.gz

#Source0: https://git.opendesktop.org/akiraohgaki/ocs-url/-/archive/release-%{version}/ocs-url-release-%{version}.tar.gz

Source0: %{name}.tar.gz

Requires: qt5-qtbase >= 5.2.0, qt5-qtbase-gui >= 5.2.0, qt5-qtsvg >= 5.2.0, qt5-qtdeclarative >= 5.2.0, qt5-qtquickcontrols >= 5.2.0

BuildRequires: git, make, automake, gcc, gcc-c++, libtool, qt5-qtbase-devel >= 5.2.0, qt5-qtsvg-devel >= 5.2.0, qt5-qtdeclarative-devel >= 5.2.0, rpm-build

%description

An install helper program for items served on OpenCollaborationServices (OCS).

An install helper program for items served via OpenCollaborationServices (ocs://).

%prep

#%%autosetup -n %{name}-release-%{version}

rm -rf %{buildroot}

%changelog

* Thu Jul 05 2018 Akira Ohgaki <akiraohgaki@gmail.com> - 3.1.0-1

- Drop old xdg:// and xdgs:// schemes

- Update library

* Tue Feb 06 2018 Akira Ohgaki <akiraohgaki@gmail.com> - 3.0.3-1

- Update library

- Fix spelling

Summary: OCS-URL

Name: ocs-url

Version: 3.0.3

Version: 3.1.0

Release: 1%{?dist}

License: GPLv3+

Group: Applications/Internet

URL: https://github.com/opendesktop/ocs-url

URL: https://git.opendesktop.org/akiraohgaki/ocs-url

#Source0: https://github.com/opendesktop/ocs-url/archive/release-%{version}.tar.gz

#Source0: https://git.opendesktop.org/akiraohgaki/ocs-url/-/archive/release-%{version}/ocs-url-release-%{version}.tar.gz

Source0: %{name}.tar.gz

Requires: libQt5Svg5 >= 5.2.0, libqt5-qtquickcontrols >= 5.2.0

BuildRequires: git, make, automake, gcc, gcc-c++, libtool, libqt5-qtbase-devel >= 5.2.0, libqt5-qtsvg-devel >= 5.2.0, libqt5-qtdeclarative-devel >= 5.2.0, rpm-build

%description

An install helper program for items served on OpenCollaborationServices (OCS).

An install helper program for items served via OpenCollaborationServices (ocs://).

%prep

#%%autosetup -n %{name}-release-%{version}

rm -rf %{buildroot}

%changelog

* Thu Jul 05 2018 Akira Ohgaki <akiraohgaki@gmail.com> - 3.1.0-1

- Drop old xdg:// and xdgs:// schemes

- Update library

* Tue Feb 06 2018 Akira Ohgaki <akiraohgaki@gmail.com> - 3.0.3-1

- Update library

- Fix spelling

ocs-url (3.1.0-0ubuntu1) trusty; urgency=low

  * Drop old xdg:// and xdgs:// schemes

  * Update library

 -- Akira Ohgaki <akiraohgaki@gmail.com>  Thu, 05 Jul 2018 05:43:18 +0000

ocs-url (3.0.3-0ubuntu1) trusty; urgency=low

  * Update library

Architecture: any

Depends: ${shlibs:Depends}, ${misc:Depends}, libqt5svg5 (>= 5.2.0), qml-module-qtquick2 (>= 5.2.0) | qtdeclarative5-qtquick2-plugin (>= 5.2.0), qml-module-qtquick-window2 (>= 5.2.0) | qtdeclarative5-window-plugin (>= 5.2.0), qml-module-qtquick-controls (>= 5.2.0) | qtdeclarative5-controls-plugin (>= 5.2.0)

Description: OCS-URL

 An install helper program for items served on OpenCollaborationServices (OCS).

 An install helper program for items served via OpenCollaborationServices (ocs://).

Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/

Upstream-Name: ocs-url

Upstream-Contact: Opendesktop.org <contact@opendesktop.org>

Source: https://github.com/opendesktop/ocs-url

Source: https://git.opendesktop.org/akiraohgaki/ocs-url

Files: *

Copyright: 2016-2018, Opendesktop.org

Copyright: 2016-2019, Opendesktop.org

License: GPL-3+

 On Debian systems, the full text of the GNU General Public License version 3

 can be found in the `/usr/share/common-licenses/GPL-3' file.

BUILDDIR="${PROJDIR}/build_${PKGNAME}"

ci_ubuntu_deb() { # docker-image: ubuntu:14.04

ubuntu_deb() { # docker-image: ubuntu:14.04

    install_build_deps_ubuntu_deb

    add_pkguser

    su -c "export HOME=/home/${PKGUSER} && "${PKGSCRIPT}" build_ubuntu_deb" ${PKGUSER}

}

install_build_deps_ubuntu_deb() {

    apt update -qq

    apt -y install curl git

    apt -y install build-essential qt5-default libqt5svg5-dev qtdeclarative5-dev

    apt -y install devscripts debhelper fakeroot

    useradd -m ${PKGUSER}

    chown -R ${PKGUSER} "${PROJDIR}"

    su -c "export HOME=/home/${PKGUSER} && "${PKGSCRIPT}" build_ubuntu_deb" ${PKGUSER}

    transfer_file "$(find "${BUILDDIR}" -type f -name "${PKGNAME}*.deb")"

}

build_ubuntu_deb() {

    debuild -uc -us -b

}

ci_fedora_rpm() { # docker-image: fedora:20

fedora_rpm() { # docker-image: fedora:20

    install_build_deps_fedora_rpm

    add_pkguser

    su -c "export HOME=/home/${PKGUSER} && "${PKGSCRIPT}" build_fedora_rpm" ${PKGUSER}

}

install_build_deps_fedora_rpm() {

    yum -y install curl git

    yum -y install make automake gcc gcc-c++ libtool qt5-qtbase-devel qt5-qtsvg-devel qt5-qtdeclarative-devel

    yum -y install rpm-build

    useradd -m ${PKGUSER}

    chown -R ${PKGUSER} "${PROJDIR}"

    su -c "export HOME=/home/${PKGUSER} && "${PKGSCRIPT}" build_fedora_rpm" ${PKGUSER}

    transfer_file "$(find "${BUILDDIR}" -type f -name "${PKGNAME}*.rpm")"

}

build_fedora_rpm() {

    rpmbuild --define "_topdir ${BUILDDIR}" -bb "${BUILDDIR}/SPECS/${PKGNAME}.spec"

}

ci_opensuse_rpm() { # docker-image: opensuse:42.1

opensuse_rpm() { # docker-image: opensuse:42.3

    install_build_deps_opensuse_rpm

    add_pkguser

    su -c "export HOME=/home/${PKGUSER} && "${PKGSCRIPT}" build_opensuse_rpm" ${PKGUSER}

}

install_build_deps_opensuse_rpm() {

    zypper --non-interactive refresh

    zypper --non-interactive install curl git

    zypper --non-interactive install make automake gcc gcc-c++ libtool libqt5-qtbase-devel libqt5-qtsvg-devel libqt5-qtdeclarative-devel

    zypper --non-interactive install rpm-build

    useradd -m ${PKGUSER}

    chown -R ${PKGUSER} "${PROJDIR}"

    su -c "export HOME=/home/${PKGUSER} && "${PKGSCRIPT}" build_opensuse_rpm" ${PKGUSER}

    transfer_file "$(find "${BUILDDIR}" -type f -name "${PKGNAME}*.rpm")"

}

build_opensuse_rpm() {

    rpmbuild --define "_topdir ${BUILDDIR}" -bb "${BUILDDIR}/SPECS/${PKGNAME}.spec"

}

ci_archlinux_pkg() { # docker-image: base/archlinux:latest

archlinux_pkg() { # docker-image: archlinux/base:latest

    install_build_deps_archlinux_pkg

    add_pkguser

    su -c "export HOME=/home/${PKGUSER} && "${PKGSCRIPT}" build_archlinux_pkg" ${PKGUSER}

}

install_build_deps_archlinux_pkg() {

    pacman -Syu --noconfirm

    pacman -S --noconfirm curl git

    pacman -S --noconfirm base-devel qt5-base qt5-svg qt5-declarative qt5-quickcontrols

    useradd -m ${PKGUSER}

    chown -R ${PKGUSER} "${PROJDIR}"

    su -c "export HOME=/home/${PKGUSER} && "${PKGSCRIPT}" build_archlinux_pkg" ${PKGUSER}

    transfer_file "$(find "${BUILDDIR}" -type f -name "${PKGNAME}*.pkg.tar.xz")"

    pacman -S --noconfirm pacman-contrib

}

build_archlinux_pkg() {

    makepkg -s

}

export_srcarchive() {

    if [[ "${1}" ]]; then

        $(cd "${PROJDIR}" && git archive --prefix="${PKGNAME}/" --output="${1}" HEAD)

    fi

add_pkguser() {

    useradd -m ${PKGUSER}

    chown -R ${PKGUSER} "${PROJDIR}"

}

transfer_file() {

    if [[ -f "${1}" ]]; then

        filename="$(basename "${1}")"

        transferlog="${PROJDIR}/transfer.log"

        echo "Uploading ${filename}" >> "${transferlog}"

        curl -fsSL -T "${1}" "https://transfer.sh/${filename}" >> "${transferlog}"

        echo '' >> "${transferlog}"

export_srcarchive() {

    if [ "${1}" ]; then

        (cd "${PROJDIR}" && git archive --prefix="${PKGNAME}/" --output="${1}" HEAD)

    fi

}

if [[ "${1}" = 'ci_'* || "${1}" = 'build_'* ]]; then

if [ "${1}" ]; then

    ${1}

fi

PROJDIR="$(cd "$(dirname "${0}")/../" && pwd)"

if [[ ! -d "${PROJDIR}/lib/qtil" ]]; then

if [ ! -d "${PROJDIR}/lib/qtil" ]; then

    git clone https://github.com/akiraohgaki/qtil.git -b release-0.4.0 --single-branch --depth=1 "${PROJDIR}/lib/qtil"

fi