[Scummvm-git-logs] scummvm master -> bac9108cb9b7629e719988139025ef8de2a8b1ba

cadihowley noreply at scummvm.org
Fri Oct 20 03:18:04 UTC 2023 

This automated email contains information about 1 new commit which have been
pushed to the 'scummvm' repo located at https://github.com/scummvm/scummvm .

Summary:
bac9108cb9 DOCS: Adds cloud wizard how-to


Commit: bac9108cb9b7629e719988139025ef8de2a8b1ba
    https://github.com/scummvm/scummvm/commit/bac9108cb9b7629e719988139025ef8de2a8b1ba
Author: CadiH (cadihowley at gmail.com)
Date: 2023-10-20T16:17:59+13:00

Commit Message:
DOCS: Adds cloud wizard how-to

Changed paths:
  A doc/docportal/images/cloud_and_lan/cloud_wizard_browser.png
  A doc/docportal/images/cloud_and_lan/cloud_wizard_manual.png
  A doc/docportal/images/cloud_and_lan/cloud_wizard_manual_1.png
  A doc/docportal/images/cloud_and_lan/cloud_wizard_manual_2.png
  A doc/docportal/images/cloud_and_lan/cloud_wizard_manual_3.png
  A doc/docportal/images/cloud_and_lan/cloud_wizard_manual_4.png
  A doc/docportal/images/cloud_and_lan/cloud_wizard_quick.png
  A doc/docportal/images/cloud_and_lan/cloud_wizard_quick_1.png
  A doc/docportal/images/cloud_and_lan/cloud_wizard_quick_2.png
  A doc/docportal/images/cloud_and_lan/cloud_wizard_success.png
  R doc/docportal/images/cloud_and_lan/cloud_code.png
  R doc/docportal/images/cloud_and_lan/cloud_connect.png
    doc/docportal/use_scummvm/connect_cloud.rst


diff --git a/doc/docportal/images/cloud_and_lan/cloud_code.png b/doc/docportal/images/cloud_and_lan/cloud_code.png
deleted file mode 100755
index 6b0079f3987..00000000000
Binary files a/doc/docportal/images/cloud_and_lan/cloud_code.png and /dev/null differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_connect.png b/doc/docportal/images/cloud_and_lan/cloud_connect.png
deleted file mode 100755
index f0e3344fb0b..00000000000
Binary files a/doc/docportal/images/cloud_and_lan/cloud_connect.png and /dev/null differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_browser.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_browser.png
new file mode 100644
index 00000000000..2f31c916696
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_browser.png differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_manual.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual.png
new file mode 100644
index 00000000000..b372e3fe342
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual.png differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_1.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_1.png
new file mode 100644
index 00000000000..87aa46c8dc0
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_1.png differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_2.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_2.png
new file mode 100644
index 00000000000..842d273d698
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_2.png differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_3.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_3.png
new file mode 100644
index 00000000000..2f35478bfe2
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_3.png differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_4.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_4.png
new file mode 100644
index 00000000000..1318576eb74
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_manual_4.png differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_quick.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_quick.png
new file mode 100644
index 00000000000..cc857ad703e
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_quick.png differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_quick_1.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_quick_1.png
new file mode 100644
index 00000000000..ebaa44e0110
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_quick_1.png differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_quick_2.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_quick_2.png
new file mode 100644
index 00000000000..1e3badf67e3
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_quick_2.png differ
diff --git a/doc/docportal/images/cloud_and_lan/cloud_wizard_success.png b/doc/docportal/images/cloud_and_lan/cloud_wizard_success.png
new file mode 100644
index 00000000000..c771716b409
Binary files /dev/null and b/doc/docportal/images/cloud_and_lan/cloud_wizard_success.png differ
diff --git a/doc/docportal/use_scummvm/connect_cloud.rst b/doc/docportal/use_scummvm/connect_cloud.rst
index 691ec4d2631..b37ae54f45a 100644
--- a/doc/docportal/use_scummvm/connect_cloud.rst
+++ b/doc/docportal/use_scummvm/connect_cloud.rst
@@ -11,34 +11,89 @@ Connecting ScummVM to a cloud storage service provides an easy way of sharing ga
 
 This guide explains how to connect a cloud service to ScummVM.
 
-From the Launcher, select **Options**, click the **>** scroll arrow until the Cloud tab is visible, and then select the **Cloud** tab.
+From the Launcher, select **Options** and then select the **Cloud** tab.
 
 Select your preferred cloud storage service from the **Active storage** dropdown.
 
 .. figure:: ../images/cloud_and_lan/cloud_storage.png
 
-Click on the link shown at **1.**, and sign in to your cloud storage account. A 6-digit code is displayed after you sign in.
+Click **Connect**.
 
-.. figure:: ../images/cloud_and_lan/cloud_code.png
+The cloud connection wizard
+------------------------------
 
-.. warning::
+The cloud connection wizard offers two ways to connect the cloud service: Quick mode and Manual mode. 
 
-    Do not share this 6-digit code with anyone before you connect your cloud storage account.
+Quick mode
+****************
+1. Select **Quick mode**
 
-For devices without a web browser, navigate to the following ScummVM links on a computer or any other device with a web browser:
+.. figure:: ../images/cloud_and_lan/cloud_wizard_quick.png
 
-`Dropbox <https://cloud.scummvm.org/dropbox>`_ | `OneDrive <https://cloud.scummvm.org/onedrive>`_ | `Google Drive <https://cloud.scummvm.org/gdrive>`_ | `Box <https://cloud.scummvm.org/box>`_
+2. Select **Run server**. This starts a :doc:`Local Webserver <../use_scummvm/LAN>`. Select **Next**.
 
-Copy the 6-digit code, click into the empty field next to **Paste**, and then click **Paste**. Alternatively, for devices without a web browser, manually enter the 6-digit code.
+.. figure:: ../images/cloud_and_lan/cloud_wizard_quick_1.png
 
-.. figure:: ../images/cloud_and_lan/cloud_connect.png
+3. Click on the link. 
 
-Click **3. Connect**. After the next page loads, click **Enable storage**.
+.. figure:: ../images/cloud_and_lan/cloud_wizard_quick_2.png
+
+4. In the browser window that opens, select the cloud service to connect. Untick the **ScummVM version 2.7.1 or newer** tickbox if you're using an older version.  
+
+.. figure:: ../images/cloud_and_lan/cloud_wizard_browser.png
+
+5. Sign in to the chosen cloud service. Once completed, return to ScummVM. On the success screen, select **Finish** to exit. 
+
+.. figure:: ../images/cloud_and_lan/cloud_wizard_success.png
+
+6. Back on the main Cloud tab, check the username for the connected service is correct, then select **Enable storage**.
 
 .. figure:: ../images/cloud_and_lan/cloud_enable.png
 
+Manual mode
+**************
+
+If the Local Webserver is not working, use manual mode to connect the cloud service. 
+
+1. Select **Manual mode**.
+
+.. figure:: ../images/cloud_and_lan/cloud_wizard_manual.png
+
+2. Click on the link. 
+
+.. figure:: ../images/cloud_and_lan/cloud_wizard_manual_1.png
+
+3. In the browser window that opens, select the cloud service to connect.  Untick the **ScummVM version 2.7.1 or newer** tickbox if you're using an older version. 
+
+.. figure:: ../images/cloud_and_lan/cloud_wizard_browser.png
+
+4. Sign in to the chosen cloud service.
+5. When the error screen appears, copy the JSON code found in the text box.
+
+.. figure:: ../images/cloud_and_lan/cloud_wizard_manual_2.png
+
+.. figure:: ../images/cloud_and_lan/cloud_wizard_manual_3.png
+
+6. Return to ScummVM, select **Paste** and then **Next**.
+
+.. figure:: ../images/cloud_and_lan/cloud_wizard_manual_4.png
+
+7. On the success screen, select **Finish** to exit. 
+
+.. figure:: ../images/cloud_and_lan/cloud_wizard_success.png
+
+8. Back on the main Cloud tab, check the username for the connected service is correct, then select **Enable storage**.
+
+.. figure:: ../images/cloud_and_lan/cloud_enable.png
+
+Using the cloud with ScummVM
+------------------------------
+
 Saved games sync automatically on launch, when a game is saved, and when a saved game is loaded. Select **Sync now** to manually sync.
 
 To download game files from your cloud ScummVM folder, click **Download game files**.
 
+.. note:: 
+    The game file download functionality is not available with Google Drive. To use this feature, choose another provider. 
+
 To change to a different cloud account, or to disconnect your cloud account from ScummVM, click **Disconnect**.
\ No newline at end of file

More information about the Scummvm-git-logs mailing list