From 6fce7f0db410b75a1b5268a01367a051b4c1d615 Mon Sep 17 00:00:00 2001 From: Benjamin Deleze Date: Mon, 5 Jun 2023 15:48:12 +0200 Subject: [PATCH 01/10] fix simulation links --- docs/guide/webots-cloud.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guide/webots-cloud.md b/docs/guide/webots-cloud.md index 4d8612b6969..f1f55211c68 100644 --- a/docs/guide/webots-cloud.md +++ b/docs/guide/webots-cloud.md @@ -96,5 +96,5 @@ The server tab on webots.cloud contains information on the [Simulation Servers]( **Simulation**: -- [OroBOT Simulation](https://webots.cloud/run?version=R2022b&url=https://github.com/cyberbotics/orobot/blob/main/worlds/OroBOT_uneven.wbt) -- [Spot Simulation](https://webots.cloud/run?version=R2022b&url=https://github.com/cyberbotics/webots-cloud-simulation-examples/blob/main/2_compile_controller/worlds/spot.wbt) +- [OroBOT Simulation](https://webots.cloud/run?version=R2022b&url=https://github.com/cyberbotics/orobot/blob/main/worlds/OroBOT_uneven.wbt&type=demo) +- [Spot Simulation](https://webots.cloud/run?version=R2022b&url=https://github.com/cyberbotics/webots-cloud-simulation-examples/blob/main/2_compile_controller/worlds/spot.wbt&type=demo) From d4165836a207c5aad167e18a9908d8c0e9bdf892 Mon Sep 17 00:00:00 2001 From: Benjamin Deleze Date: Mon, 5 Jun 2023 15:49:25 +0200 Subject: [PATCH 02/10] fix blog --- docs/blog/Webots-2022-b-release.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/blog/Webots-2022-b-release.md b/docs/blog/Webots-2022-b-release.md index 29bafca621c..aefa311d6f3 100644 --- a/docs/blog/Webots-2022-b-release.md +++ b/docs/blog/Webots-2022-b-release.md @@ -80,8 +80,8 @@ This tool could be used to publish open-science results where both reviewers and #### Simulations -- [OroBOT Simulation](https://webots.cloud/run?version=R2022b&url=https://github.com/cyberbotics/orobot/blob/main/worlds/OroBOT_uneven.wbt) -- [Spot Simulation](https://webots.cloud/run?version=R2022b&url=https://github.com/cyberbotics/webots-cloud-simulation-examples/blob/main/2_compile_controller/worlds/spot.wbt) +- [OroBOT Simulation](https://webots.cloud/run?version=R2022b&url=https://github.com/cyberbotics/orobot/blob/main/worlds/OroBOT_uneven.wbt&type=demo) +- [Spot Simulation](https://webots.cloud/run?version=R2022b&url=https://github.com/cyberbotics/webots-cloud-simulation-examples/blob/main/2_compile_controller/worlds/spot.wbt&type=demo) --- From a167ba5ad772a3095aac1e101f78dd918167dd95 Mon Sep 17 00:00:00 2001 From: Benjamin Deleze Date: Mon, 5 Jun 2023 15:53:47 +0200 Subject: [PATCH 03/10] add proto examples --- docs/guide/webots-cloud.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/guide/webots-cloud.md b/docs/guide/webots-cloud.md index f1f55211c68..b0a170d37a3 100644 --- a/docs/guide/webots-cloud.md +++ b/docs/guide/webots-cloud.md @@ -94,6 +94,10 @@ The server tab on webots.cloud contains information on the [Simulation Servers]( - [PR2](https://webots.cloud/AcpeTj6) - [Nao room](https://webots.cloud/AcTNYs0) +**Proto** +- [NAO](https://webots.cloud/run?version=R2023b&url=https://github.com/cyberbotics/webots/blob/develop/projects/robots/softbank/nao/protos/Nao.proto) +- [WoodenPalletStack](https://webots.cloud/run?version=R2023b&url=https://github.com/cyberbotics/webots/blob/develop/projects/objects/factory/pallet/protos/WoodenPalletStack.proto) + **Simulation**: - [OroBOT Simulation](https://webots.cloud/run?version=R2022b&url=https://github.com/cyberbotics/orobot/blob/main/worlds/OroBOT_uneven.wbt&type=demo) From d865349a4db039ea127a0c1afa6f5385d4b622cd Mon Sep 17 00:00:00 2001 From: Benjamin Deleze Date: Tue, 6 Jun 2023 08:23:52 +0200 Subject: [PATCH 04/10] web proto doc --- docs/guide/webots-cloud.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/guide/webots-cloud.md b/docs/guide/webots-cloud.md index b0a170d37a3..3c8be0909e2 100644 --- a/docs/guide/webots-cloud.md +++ b/docs/guide/webots-cloud.md @@ -2,6 +2,7 @@ [webots.cloud](https://webots.cloud) is an open-source webservice to share simulations online. You can share 3D scenes and animations recorded from a simulation, but also fully interactive simulations. +This is also the place where you can see the complete library of protos available in Webots and add your own. ### Publish 3D Scenes and Animations @@ -11,6 +12,24 @@ Once your scene or animation is uploaded, you get a link (web URL) pointing to y Anyone with this link can view your 3D scene or animation with a simple mouse click. Scenes and animations can also be uploaded on webots.cloud by clicking the "Add a new scene/animation" button, and uploading locally saved `X3D`, `JSON`, thumbnail and texture files. +### Share and use your Proto + +The [protos section](https://webots.cloud/proto) of webots.cloud is the place where you can see the protos available in Webots, read about them and play with their parameters. +Anyone can add its own proto to the library. To do that, your proto files (`.proto` files, textures, meshes,...) shoud be hosted on a GitHub repository. +The proto folder must also have a `webots.yaml` file which should contain: `publish: true`. +To classify the proto correctly, webots.cloud needs to know what are the `keywords` of the proto. Please refer to [this section](../reference/proto-design-guidelines?#keywords) to learn more about `keywords` and how to set. +You can them add your proto by clicking the `Add a new proto` at the bottom of the [page](https://webots.cloud/proto). + +To add a proto from the library to a world, copy the github url of the proto and convert it to `raw.githubusercontent.com`. To to that, change `github.com` into `raw.githubusercontent.com` and remove the `/blob`. Then paste it at the top of the world file like this: +``` +#VRML_SIM R2023b utf8 + +IMPORTABLE EXTERNPROTO "https://raw.githubusercontent.com/cyberbotics/webots/develop/projects/appearances/protos/RoughOak.proto" + +WorldInfo { +``` + + ### Publish Cloud-Based Simulations It is also possible to run a Webots simulation in webots.cloud interactively. From 9a5a848fedde2ee0fbab769721f47cc44e17fba3 Mon Sep 17 00:00:00 2001 From: Benjamin Deleze Date: Tue, 6 Jun 2023 08:33:28 +0200 Subject: [PATCH 05/10] typo --- docs/guide/webots-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide/webots-cloud.md b/docs/guide/webots-cloud.md index 3c8be0909e2..e5d7a83e4f9 100644 --- a/docs/guide/webots-cloud.md +++ b/docs/guide/webots-cloud.md @@ -18,7 +18,7 @@ The [protos section](https://webots.cloud/proto) of webots.cloud is the place wh Anyone can add its own proto to the library. To do that, your proto files (`.proto` files, textures, meshes,...) shoud be hosted on a GitHub repository. The proto folder must also have a `webots.yaml` file which should contain: `publish: true`. To classify the proto correctly, webots.cloud needs to know what are the `keywords` of the proto. Please refer to [this section](../reference/proto-design-guidelines?#keywords) to learn more about `keywords` and how to set. -You can them add your proto by clicking the `Add a new proto` at the bottom of the [page](https://webots.cloud/proto). +You can then add your proto by clicking the `Add a new proto` button at the bottom of the [page](https://webots.cloud/proto). To add a proto from the library to a world, copy the github url of the proto and convert it to `raw.githubusercontent.com`. To to that, change `github.com` into `raw.githubusercontent.com` and remove the `/blob`. Then paste it at the top of the world file like this: ``` From 4f1f5edb74eea9598062eb1de1a8ab33b651a325 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20D=C3=A9l=C3=A8ze?= Date: Tue, 6 Jun 2023 09:00:01 +0200 Subject: [PATCH 06/10] Update webots-cloud.md --- docs/guide/webots-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide/webots-cloud.md b/docs/guide/webots-cloud.md index e5d7a83e4f9..9fde8b82992 100644 --- a/docs/guide/webots-cloud.md +++ b/docs/guide/webots-cloud.md @@ -12,7 +12,7 @@ Once your scene or animation is uploaded, you get a link (web URL) pointing to y Anyone with this link can view your 3D scene or animation with a simple mouse click. Scenes and animations can also be uploaded on webots.cloud by clicking the "Add a new scene/animation" button, and uploading locally saved `X3D`, `JSON`, thumbnail and texture files. -### Share and use your Proto +### Share and Use Your Proto The [protos section](https://webots.cloud/proto) of webots.cloud is the place where you can see the protos available in Webots, read about them and play with their parameters. Anyone can add its own proto to the library. To do that, your proto files (`.proto` files, textures, meshes,...) shoud be hosted on a GitHub repository. From 4e2bb82307dbd6c3c3259ca76a9ce6f87f307105 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20D=C3=A9l=C3=A8ze?= Date: Tue, 6 Jun 2023 09:11:15 +0200 Subject: [PATCH 07/10] Update webots-cloud.md --- docs/guide/webots-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide/webots-cloud.md b/docs/guide/webots-cloud.md index 9fde8b82992..6f158c1890e 100644 --- a/docs/guide/webots-cloud.md +++ b/docs/guide/webots-cloud.md @@ -17,7 +17,7 @@ Scenes and animations can also be uploaded on webots.cloud by clicking the "Add The [protos section](https://webots.cloud/proto) of webots.cloud is the place where you can see the protos available in Webots, read about them and play with their parameters. Anyone can add its own proto to the library. To do that, your proto files (`.proto` files, textures, meshes,...) shoud be hosted on a GitHub repository. The proto folder must also have a `webots.yaml` file which should contain: `publish: true`. -To classify the proto correctly, webots.cloud needs to know what are the `keywords` of the proto. Please refer to [this section](../reference/proto-design-guidelines?#keywords) to learn more about `keywords` and how to set. +To classify the proto correctly, webots.cloud needs to know what are the `keywords` of the proto. Please refer to [this section](../reference/proto-design-guidelines#keywords) to learn more about `keywords` and how to set. You can then add your proto by clicking the `Add a new proto` button at the bottom of the [page](https://webots.cloud/proto). To add a proto from the library to a world, copy the github url of the proto and convert it to `raw.githubusercontent.com`. To to that, change `github.com` into `raw.githubusercontent.com` and remove the `/blob`. Then paste it at the top of the world file like this: From 9b2a01798bc4e5fd1480af305eef875843ac3a2d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20D=C3=A9l=C3=A8ze?= Date: Tue, 6 Jun 2023 09:14:49 +0200 Subject: [PATCH 08/10] Update webots-cloud.md --- docs/guide/webots-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide/webots-cloud.md b/docs/guide/webots-cloud.md index 6f158c1890e..a8abaea7bf9 100644 --- a/docs/guide/webots-cloud.md +++ b/docs/guide/webots-cloud.md @@ -17,7 +17,7 @@ Scenes and animations can also be uploaded on webots.cloud by clicking the "Add The [protos section](https://webots.cloud/proto) of webots.cloud is the place where you can see the protos available in Webots, read about them and play with their parameters. Anyone can add its own proto to the library. To do that, your proto files (`.proto` files, textures, meshes,...) shoud be hosted on a GitHub repository. The proto folder must also have a `webots.yaml` file which should contain: `publish: true`. -To classify the proto correctly, webots.cloud needs to know what are the `keywords` of the proto. Please refer to [this section](../reference/proto-design-guidelines#keywords) to learn more about `keywords` and how to set. +To classify the proto correctly, webots.cloud needs to know what are the `keywords` of the proto. Please refer to [this section](../reference/proto-design-guidelines.md#keywords) to learn more about `keywords` and how to set. You can then add your proto by clicking the `Add a new proto` button at the bottom of the [page](https://webots.cloud/proto). To add a proto from the library to a world, copy the github url of the proto and convert it to `raw.githubusercontent.com`. To to that, change `github.com` into `raw.githubusercontent.com` and remove the `/blob`. Then paste it at the top of the world file like this: From 9019445daa94a513d4f1b6441d3b946a1c340727 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20D=C3=A9l=C3=A8ze?= Date: Tue, 6 Jun 2023 14:01:04 +0200 Subject: [PATCH 09/10] Update docs/guide/webots-cloud.md Co-authored-by: Olivier Michel --- docs/guide/webots-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide/webots-cloud.md b/docs/guide/webots-cloud.md index a8abaea7bf9..4227b062355 100644 --- a/docs/guide/webots-cloud.md +++ b/docs/guide/webots-cloud.md @@ -18,7 +18,7 @@ The [protos section](https://webots.cloud/proto) of webots.cloud is the place wh Anyone can add its own proto to the library. To do that, your proto files (`.proto` files, textures, meshes,...) shoud be hosted on a GitHub repository. The proto folder must also have a `webots.yaml` file which should contain: `publish: true`. To classify the proto correctly, webots.cloud needs to know what are the `keywords` of the proto. Please refer to [this section](../reference/proto-design-guidelines.md#keywords) to learn more about `keywords` and how to set. -You can then add your proto by clicking the `Add a new proto` button at the bottom of the [page](https://webots.cloud/proto). +You can then add your proto by clicking the `Add a new proto` button at the bottom of the [proto page](https://webots.cloud/proto). To add a proto from the library to a world, copy the github url of the proto and convert it to `raw.githubusercontent.com`. To to that, change `github.com` into `raw.githubusercontent.com` and remove the `/blob`. Then paste it at the top of the world file like this: ``` From 989fee9cd2d87edca25d99c7ddfb7f2d734ddb08 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20D=C3=A9l=C3=A8ze?= Date: Tue, 6 Jun 2023 14:01:35 +0200 Subject: [PATCH 10/10] Update docs/guide/webots-cloud.md Co-authored-by: Olivier Michel --- docs/guide/webots-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide/webots-cloud.md b/docs/guide/webots-cloud.md index 4227b062355..7d989703a7f 100644 --- a/docs/guide/webots-cloud.md +++ b/docs/guide/webots-cloud.md @@ -17,7 +17,7 @@ Scenes and animations can also be uploaded on webots.cloud by clicking the "Add The [protos section](https://webots.cloud/proto) of webots.cloud is the place where you can see the protos available in Webots, read about them and play with their parameters. Anyone can add its own proto to the library. To do that, your proto files (`.proto` files, textures, meshes,...) shoud be hosted on a GitHub repository. The proto folder must also have a `webots.yaml` file which should contain: `publish: true`. -To classify the proto correctly, webots.cloud needs to know what are the `keywords` of the proto. Please refer to [this section](../reference/proto-design-guidelines.md#keywords) to learn more about `keywords` and how to set. +To classify the proto correctly, webots.cloud needs to know what are the `keywords` of the proto. Please refer to [this section](../reference/proto-design-guidelines.md#keywords) to learn more about `keywords` and how to set them. You can then add your proto by clicking the `Add a new proto` button at the bottom of the [proto page](https://webots.cloud/proto). To add a proto from the library to a world, copy the github url of the proto and convert it to `raw.githubusercontent.com`. To to that, change `github.com` into `raw.githubusercontent.com` and remove the `/blob`. Then paste it at the top of the world file like this: