[network/kio-s3] /: Add documentation, metadata and shorcut from remote:/

[Elvis Angelaccio]

Git commit a0ce75a31ce05f1bc10f8227a13978001ba1e9bd by Elvis Angelaccio.
Committed on 06/01/2021 at 23:00.
Pushed by elvisangelaccio into branch 'master'.

Add documentation, metadata and shorcut from remote:/

M  +2    -2    CMakeLists.txt
A  +7    -0    desktop/CMakeLists.txt
A  +37   -0    desktop/org.kde.kio_s3.metainfo.xml
A  +7    -0    desktop/s3-network.desktop
A  +6    -0    doc/CMakeLists.txt
A  +41   -0    doc/index.docbook

https://invent.kde.org/network/kio-s3/commit/a0ce75a31ce05f1bc10f8227a13978001ba1e9bd

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 24e8a2a..6956d7b 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -57,8 +57,8 @@ add_definitions(-DTRANSLATION_DOMAIN=\"kio5_s3\")
 if(BUILD_TESTING)
     add_subdirectory(autotests)
 endif()
-#add_subdirectory(desktop)
-#add_subdirectory(doc)
+add_subdirectory(desktop)
+add_subdirectory(doc)
 add_subdirectory(src)
 
 feature_summary(WHAT ALL INCLUDE_QUIET_PACKAGES FATAL_ON_MISSING_REQUIRED_PACKAGES)
diff --git a/desktop/CMakeLists.txt b/desktop/CMakeLists.txt
new file mode 100644
index 0000000..66d13e9
--- /dev/null
+++ b/desktop/CMakeLists.txt
@@ -0,0 +1,7 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# SPDX-FileCopyrightText: 2020 Elvis Angelaccio <elvis.angelaccio at kde.org>
+
+install(FILES s3-network.desktop
+        DESTINATION ${KDE_INSTALL_DATADIR}/remoteview)
+install(FILES org.kde.kio_s3.metainfo.xml
+        DESTINATION ${KDE_INSTALL_METAINFODIR})
diff --git a/desktop/org.kde.kio_s3.metainfo.xml b/desktop/org.kde.kio_s3.metainfo.xml
new file mode 100644
index 0000000..9c7c2ea
--- /dev/null
+++ b/desktop/org.kde.kio_s3.metainfo.xml
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+    SPDX-License-Identifier: CC0-1.0
+    SPDX-FileCopyrightText: 2020 Elvis Angelaccio <elvis.angelaccio at kde.org>
+-->
+<component type="addon">
+  <id>org.kde.kio_s3</id>
+  <metadata_license>CC0-1.0</metadata_license>
+  <project_license>GPL-2.0+</project_license>
+  <extends>org.kde.dolphin.desktop</extends>
+  <extends>org.kde.konqueror.desktop</extends>
+  <extends>org.kde.krusader.desktop</extends>
+  <extends>org.kde.gwenview.desktop</extends>
+  <name>KIO S3</name>
+  <summary>Amazon S3 integration with KDE Plasma and KDE applications</summary>
+  <description>
+    <p>KIO S3 enables KIO-aware applications (such as Dolphin, Kate or Gwenview) to access and edit Amazon S3 buckets and objects.</p>
+  </description>
+<!--  <url type="homepage">https://apps.kde.org/en/kio_s3</url>-->
+<!--  <url type="bugtracker">https://bugs.kde.org/enter_bug.cgi?format=guided&product=kio-s3</url>-->
+<!--   <url type="help">https://docs.kde.org/?application=kioslave5%2Fs3</url> -->
+  <update_contact>elvis.angelaccio_at_kde.org</update_contact>
+  <screenshots>
+    <screenshot type="default">
+      <caption>Dolphin showing a picture uploaded on an Amazon S3 bucket.</caption>
+      <image type="source" width="1494" height="825">https://cdn.kde.org/screenshots/kio-s3/kio-s3.png</image>
+    </screenshot>
+  </screenshots>
+<!--  <releases>
+    <release version="20.08.1" date="2020-09-03"/>
+  </releases>-->
+  <project_group>KDE</project_group>
+  <categories>
+    <category>Network</category>
+  </categories>
+  <icon type="stock">folder-network</icon>
+</component>
diff --git a/desktop/s3-network.desktop b/desktop/s3-network.desktop
new file mode 100644
index 0000000..b63ebbb
--- /dev/null
+++ b/desktop/s3-network.desktop
@@ -0,0 +1,7 @@
+# SPDX-License-Identifier: CC0-1.0
+# SPDX-FileCopyrightText: 2020 Elvis Angelaccio <elvis.angelaccio at kde.org>
+[Desktop Entry]
+Icon=folder-network
+Name=Amazon S3
+Type=Link
+URL=s3://
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
new file mode 100644
index 0000000..2850108
--- /dev/null
+++ b/doc/CMakeLists.txt
@@ -0,0 +1,6 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# SPDX-FileCopyrightText: 2020 Elvis Angelaccio <elvis.angelaccio at kde.org>
+
+kdoctools_create_handbook(index.docbook
+    INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en
+    SUBDIR kioslave5/s3)
diff --git a/doc/index.docbook b/doc/index.docbook
new file mode 100644
index 0000000..ede580d
--- /dev/null
+++ b/doc/index.docbook
@@ -0,0 +1,41 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
+<!ENTITY % addindex "IGNORE">
+<!ENTITY % English "INCLUDE" >
+]>
+<!--
+    SPDX-License-Identifier: CC0-1.0
+    SPDX-FileCopyrightText: 2020 Elvis Angelaccio <elvis.angelaccio at kde.org>
+-->
+<article lang="&language;" id="s3">
+<title>kio-s3</title>
+
+<articleinfo>
+
+<authorgroup>
+  <author><firstname>Elvis</firstname><surname>Angelaccio</surname>
+    <affiliation>
+      <address>
+        <email>elvis.angelaccio at kde.org</email>
+      </address>
+    </affiliation>
+  </author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2021-01-05</date>
+<releaseinfo>kio-s3 0.9.70</releaseinfo>
+
+</articleinfo>
+
+<para>KIO S3 allows you to list Amazon S3 buckets and objects, to upload files and folders to a bucket and to delete objects from a bucket. You can also copy folders or objects within S3, as well as move or rename objects.</para>
+
+<para>You can use the s3 kioslave like this:</para>
+<para><userinput>s3://</userinput> or <userinput>s3://<replaceable>mybucket/mykey</replaceable></userinput>.</para>
+
+<para>The first URL shows all your S3 buckets.</para>
+
+<para>The URL <userinput>s3://<replaceable>mybucket/mykey</replaceable></userinput> lists all the files and folders
+from your <userinput>mybucket</userinput> bucket.</para>
+
+</article>