Merge pull request #1922 from DSD-DBS/t4c-image-upload

docs: Add instructions how to upload images to T4C repository

docs/docs/user/sessions/files/index.md

@@ -5,6 +5,8 @@
 
 # Browse, Upload and Download Files
 
+## Upload
+
 1.  Navigate to the `Session` tab.
 1.  On the right side, select the corresponding session. Select the persistent
     session to upload files into your persistent workspace. Click the
@@ -37,7 +39,7 @@
 1.  The upload can take a few seconds/minutes, depending on the file size.
 1.  When the upload was successful, the dialog closes without error message.
 
-# Download
+## Download
 
 1.  Navigate to the `Session` tab.
 1.  On the right side, select the corresponding session. Select the persistent

docs/docs/user/tools/capella/teamforcapella/upload-images/add-image-to-description.png.license

@@ -0,0 +1,2 @@
+SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors
+SPDX-License-Identifier: Apache-2.0

docs/docs/user/tools/capella/teamforcapella/upload-images/index.md

@@ -0,0 +1,58 @@
+<!--
+ ~ SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors
+ ~ SPDX-License-Identifier: Apache-2.0
+ -->
+
+1.  Upload the image into your personal session workspace via the file browser
+    upload:
+    [Upload files](../../../../sessions/files/index.md#browse-upload-and-download-files)
+1.  Connect to the TeamForCapella repository:
+    [Connect to a TeamForCapella repository](../connect/index.md)
+1.  Right-click on the `.team` project and select
+    `Manage Images From Remote Server`:
+    ![Manage Images From Remote Server](./manage-images.png){:style="width:200px"}
+
+    Alternatively, you can also open the dialog via the image icon from the
+    description editor:
+    ![Embed image in description](./add-image-to-description.png)
+
+1.  Choose the project name on the left side, expand it and select the folder
+    `Images`.
+
+    !!! danger "Important"
+
+        Do not upload images in the `*.team` project! Use the project name without the `.team`
+        suffix. Otherwise, images are not available after exports of the model.
+
+    !!! info "Project or folder not listed?"
+
+        If the project is not listed, you can create a new project:
+
+        1. Click `New Project` on the right side: <br />
+           ![New Project](./new-project.png){:style="width:400px"}
+        1. Enter the project name without the `.team` suffix.
+           Make sure that the project name matches exactly.
+        1. Confirm with `Ok`.
+        1. In the new project, create a new folder with `New Folder`: <br />
+           ![New Folder](./new-folder.png){:style="width:400px"}
+        1. Enter `Pictures` as name of the new folder and confirm.
+
+1.  Upload the images via the `Upload` button:
+
+    ![Upload images](./upload-from-workspace.png)
+
+    1. In the open dialog, select `Select local images`:
+       ![Select local images](./select-local-images.png)
+
+    1. Select `Other Locations` and `Computer`:
+       ![Select images](./select-images.png)
+
+    1. Select `workspace`: ![Select workspace](./select-workspace.png)
+
+    1. In this folder you can see the files uploaded via the File Browser.
+       Select the images to upload and click `Open`.
+
+    1. Confirm with `Ok`
+
+1.  Once uploaded, the images can be embedded using the description editor.
+1.  Commit the changes on the server.

docs/docs/user/tools/capella/teamforcapella/upload-images/manage-images.png.license

@@ -0,0 +1,2 @@
+SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors
+SPDX-License-Identifier: Apache-2.0

docs/docs/user/tools/capella/teamforcapella/upload-images/new-folder.png.license

@@ -0,0 +1,2 @@
+SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors
+SPDX-License-Identifier: Apache-2.0

docs/docs/user/tools/capella/teamforcapella/upload-images/new-project.png.license

@@ -0,0 +1,2 @@
+SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors
+SPDX-License-Identifier: Apache-2.0

docs/docs/user/tools/capella/teamforcapella/upload-images/select-images.png.license

@@ -0,0 +1,2 @@
+SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors
+SPDX-License-Identifier: Apache-2.0

docs/docs/user/tools/capella/teamforcapella/upload-images/select-local-images.png.license

@@ -0,0 +1,2 @@
+SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors
+SPDX-License-Identifier: Apache-2.0

docs/docs/user/tools/capella/teamforcapella/upload-images/select-workspace.png.license

@@ -0,0 +1,2 @@
+SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors
+SPDX-License-Identifier: Apache-2.0

docs/docs/user/tools/capella/teamforcapella/upload-images/upload-from-workspace.png.license

@@ -0,0 +1,2 @@
+SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors
+SPDX-License-Identifier: Apache-2.0

docs/mkdocs.yml

@@ -63,6 +63,7 @@ nav:
               - TeamForCapella commits and commit messages: user/tools/capella/teamforcapella/commit-messages/index.md
               - See Other Connected Users: user/tools/capella/teamforcapella/connected-users/index.md
               - Steps after a Model Migration: user/tools/capella/teamforcapella/migration/index.md
+              - Upload Images to TeamForCapella: user/tools/capella/teamforcapella/upload-images/index.md
           - Git:
               - Working with Git: user/tools/capella/git/index.md
           - Troubleshooting: user/tools/capella/troubleshooting/index.md