diff --git a/external/contribute/add-edit-card/add-edit-card.md b/external/contribute/add-edit-card/add-edit-card.md new file mode 100644 index 0000000000000000000000000000000000000000..b83c6d80c3922ca2b01a7a152ceba43dc4bf202a --- /dev/null +++ b/external/contribute/add-edit-card/add-edit-card.md @@ -0,0 +1,89 @@ +--- +layout: page +permalink: /internal/contribute/add-edit-card/ +shortcut: contribute:add-edit-card +redirect_from: + - /cards/contribute:add-edit-card + - /internal/cards/contribute:add-edit-card + +--- +# How to add or edit a howto card + +This shows how to use Visual Studio Code to write a howto-card: + +## Step 0: Update your local copy of your fork + +Please update your fork first, by View > Command Palette and searching for 'Git: Fetch from all remotes'. + +## Step 1: Create a new Branch + +For each how-to card, it is strongly recommended to create a new branch. + +- click on: + <img src="visual-code_img_1.png" height="50"> (on the bottom left) + +- click on: `create new branch from...` + + <img src="visual-code_img_2.png"> + +- add a name of the branch (e.g., name of the how-to card) and press Enter + +- choose `upstream/develop` + + <img src="visual-code_img_3.png"> + +- the new branch is created as can be seen on the bottom left of the screen + + <img src="visual-code_img_4.png"> + + +## Step 2: Create a new folder + +- To create a new folder, browse to `howto-cards-internal` + + <img src="visual-code_img_5.png"> + +- Then, select the `internal` folder: + + <img src="visual-code_img_6.png"> + +- Click on new folder (the name of the folder should be the name of the howto card). Please only use lowercase letters. + + <img src="visual-code_img_7.png" height="60"> + +## Step 3: Create a new file + +- Click on `New file`. Name the file the same as the folder using lowercase letters linked by dashes + + <img src="visual-code_img_8.png" height="60"> + +## Step 4: Write the procedure in Markdown + +If you need more details on how to do this, refer to the [corresponding howto-card](.../write-markdown). + +## Step 5: Commit your changes + +- on the left side click on: <img src="visual-code_img_11.png" height="50" width="50"> + +- below changes click on: + + <img src="visual-code_img_12.png"> + + stated changes + +- add a message (description of your changes) and click "commit" + + <img src="visual-code_img_13.png"> + +## Step 6: Push to git-r3lab + +- When you push your procedure for the first time click on the cloud icon: + + <img src="visual-code_img_15.png"> + +- Choose origin/"your gitlab user name" +- Open git-r3lab: https://git-r3lab.uni.lu/ + + <img src="visual-code_img_16.png"> + +- To synchronize changes: <img src="visual-code_img_17.png"> diff --git a/external/contribute/add-edit-card/visual-code_img_1.png b/external/contribute/add-edit-card/visual-code_img_1.png new file mode 100644 index 0000000000000000000000000000000000000000..cfb45db1373d3e37b91f99c523c3319d6a32d3d1 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_1.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:f5ffa8cab10fb9f9dfd0a356369fff8d05b1bfb8e675ffaab1fe0ff0f94d4477 +size 10871 diff --git a/external/contribute/add-edit-card/visual-code_img_11.png b/external/contribute/add-edit-card/visual-code_img_11.png new file mode 100644 index 0000000000000000000000000000000000000000..5e8171e75b35883c18bdff2c97b8b263d5b784af --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_11.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0849422764b47ac2ce6835b477e642a6b26dbcb0e112a9ecdb9cab6d2be675c5 +size 2750 diff --git a/external/contribute/add-edit-card/visual-code_img_12.png b/external/contribute/add-edit-card/visual-code_img_12.png new file mode 100644 index 0000000000000000000000000000000000000000..1893abfccf69f7f81d2368bd15d4c6830cfd9717 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_12.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:8f7e682f12fd9c1633d28cd31ecd07eb4e34b37f6b8cd5511dc45b63dce91849 +size 7640 diff --git a/external/contribute/add-edit-card/visual-code_img_13.png b/external/contribute/add-edit-card/visual-code_img_13.png new file mode 100644 index 0000000000000000000000000000000000000000..9a7198cc74be9bc4fbe05316b8e8d019af9eb6b0 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_13.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:3245505c6f26797b7cb2256b742b06374ca15ea27ac9544b3d494be16b4a1060 +size 9355 diff --git a/external/contribute/add-edit-card/visual-code_img_14.png b/external/contribute/add-edit-card/visual-code_img_14.png new file mode 100644 index 0000000000000000000000000000000000000000..9a7198cc74be9bc4fbe05316b8e8d019af9eb6b0 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_14.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:3245505c6f26797b7cb2256b742b06374ca15ea27ac9544b3d494be16b4a1060 +size 9355 diff --git a/external/contribute/add-edit-card/visual-code_img_15.png b/external/contribute/add-edit-card/visual-code_img_15.png new file mode 100644 index 0000000000000000000000000000000000000000..fbb1f40937d92559751159607bacdafa1c1f1dac --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_15.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:b5d534b8163e2971f342e34d62f728df073b7cada70ca1f253113bde25cc7635 +size 2383 diff --git a/external/contribute/add-edit-card/visual-code_img_16.png b/external/contribute/add-edit-card/visual-code_img_16.png new file mode 100644 index 0000000000000000000000000000000000000000..bbaf0ed3f2f185d8ee79df9bccb3c84bdc5e5685 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_16.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:fbe6954b54e29add982a2a887916017e3330419b5e365f174e92a2bbe56621ec +size 17713 diff --git a/external/contribute/add-edit-card/visual-code_img_17.png b/external/contribute/add-edit-card/visual-code_img_17.png new file mode 100644 index 0000000000000000000000000000000000000000..8155cc298aef17a504de567ab06701bfa010b1da --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_17.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:be826b590de05512b1d2de621723cc57174c99debd9584e7da3e305fc98835d7 +size 1578 diff --git a/external/contribute/add-edit-card/visual-code_img_2.png b/external/contribute/add-edit-card/visual-code_img_2.png new file mode 100644 index 0000000000000000000000000000000000000000..da3c1108926788f8343f8a1244f46be41b26b6b9 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_2.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:37b6312f2e23657fa00bba8aa1588e3118044edd4349cbeff5bff1e73286fe2d +size 29932 diff --git a/external/contribute/add-edit-card/visual-code_img_3.png b/external/contribute/add-edit-card/visual-code_img_3.png new file mode 100644 index 0000000000000000000000000000000000000000..b7af083c0c667ab11ef0a848c64a35910b2ac664 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_3.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:95cce8a990c1d564ae2441b8571e83838bd930140fb73fcf1fcabb717238e0d6 +size 31804 diff --git a/external/contribute/add-edit-card/visual-code_img_4.png b/external/contribute/add-edit-card/visual-code_img_4.png new file mode 100644 index 0000000000000000000000000000000000000000..7873603b8ce72078062df040c01b9dee6520646a --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_4.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:bae5ebc1f00da9afadc7d7655035b72c49feaae24f89043d9a2f281523569718 +size 5271 diff --git a/external/contribute/add-edit-card/visual-code_img_5.png b/external/contribute/add-edit-card/visual-code_img_5.png new file mode 100644 index 0000000000000000000000000000000000000000..544bbbe8d6964f3c3d379cd9a1c7c93b7438e821 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_5.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:667ca64f12c712905f49a61384b90a4702c44617df027083e525996f5ae4fd17 +size 11910 diff --git a/external/contribute/add-edit-card/visual-code_img_6.png b/external/contribute/add-edit-card/visual-code_img_6.png new file mode 100644 index 0000000000000000000000000000000000000000..7c0425fbb1bbad4baf21632203d4644076addbca --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_6.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:19cdd5a344e2e0eee8352e26d8bc185b9dd48f77c48c83cfb6028b3f76724295 +size 43609 diff --git a/external/contribute/add-edit-card/visual-code_img_7.png b/external/contribute/add-edit-card/visual-code_img_7.png new file mode 100644 index 0000000000000000000000000000000000000000..95a585cbd64f405a78bb12406f4c9bdff7379a32 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_7.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:cd537ae62bcb0504cbc5ae85a41a8bc52cc4e494407e882e297f36e06d9e70b2 +size 11287 diff --git a/external/contribute/add-edit-card/visual-code_img_8.png b/external/contribute/add-edit-card/visual-code_img_8.png new file mode 100644 index 0000000000000000000000000000000000000000..eef39d63a5dee5e3c0c0455ad1af15dea813a5f9 --- /dev/null +++ b/external/contribute/add-edit-card/visual-code_img_8.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:7610f4cefc4edb7707943fffac4c7c95794e2eeccd942ab3dd60421f283e7a0f +size 8827 diff --git a/external/contribute/write-markdown/visual-code_img_10.png b/external/contribute/write-markdown/visual-code_img_10.png new file mode 100644 index 0000000000000000000000000000000000000000..4a213b7a0904beda2b2c5abc89f246fd21e50e83 --- /dev/null +++ b/external/contribute/write-markdown/visual-code_img_10.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:7527cb203fe2f008008bad19e3a15e36fa240ff8e27a95fdbcf8eea523334a09 +size 6849 diff --git a/external/contribute/write-markdown/visual-code_img_18.png b/external/contribute/write-markdown/visual-code_img_18.png new file mode 100644 index 0000000000000000000000000000000000000000..797815e068fa1a5578f10d8989d4cb34f4481cbe --- /dev/null +++ b/external/contribute/write-markdown/visual-code_img_18.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:879b78a83cae09b679506900dc9aa28595444a23b3a7b3ead8695fa68b021ee5 +size 108243 diff --git a/external/contribute/write-markdown/visual-code_img_19.png b/external/contribute/write-markdown/visual-code_img_19.png new file mode 100644 index 0000000000000000000000000000000000000000..a10520b2b6085e4434a01eb8fa94fdeb2ae6e7c8 --- /dev/null +++ b/external/contribute/write-markdown/visual-code_img_19.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d6877f753a009ce482e4fe1ce4ec408f5268536befbef4953477da48ee94b842 +size 758461 diff --git a/external/contribute/write-markdown/visual-code_img_20.png b/external/contribute/write-markdown/visual-code_img_20.png new file mode 100644 index 0000000000000000000000000000000000000000..dc4611b12ac4ec24192fc024b9d20ebb33c374d5 --- /dev/null +++ b/external/contribute/write-markdown/visual-code_img_20.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:f1698349a3586409eb34ff127cf7c7869454ccd5a14eb8935ed715079aacfc6f +size 81932 diff --git a/external/contribute/write-markdown/visual-code_img_9.png b/external/contribute/write-markdown/visual-code_img_9.png new file mode 100644 index 0000000000000000000000000000000000000000..36348db1a3fe5f58c8b387093315bcb6d15a830f --- /dev/null +++ b/external/contribute/write-markdown/visual-code_img_9.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:6dcb324075b435090a6d7dd66baececeb93f17b08971c26e6ed9497e5e94d1ef +size 566 diff --git a/external/contribute/write-markdown/write-markdown.md b/external/contribute/write-markdown/write-markdown.md new file mode 100644 index 0000000000000000000000000000000000000000..b14811a9329c7db867c21ec44fe648a7dd8dc15d --- /dev/null +++ b/external/contribute/write-markdown/write-markdown.md @@ -0,0 +1,27 @@ +--- +layout: page +permalink: /internal/contribute/write-markdown/ +shortcut: contribute:write-markdown +redirect_from: + - /cards/contribute:write-markdown + - /internal/cards/contribute:write-markdown +--- +# How to write in markdown + +- The following symbol <img src="visual-code_img_9.png" height="20"> behind the file name means that your changes/writing is not saved. + + press crt+s to save your procedure + +- To preview your writing click on: + + <img src="visual-code_img_10.png"> + +- **tips to write in markdown:** + + <img src="visual-code_img_18.png"> + +**insert pictures:** + <img src="visual-code_img_19.png" width="1000"> + +**create a table** + <img src="visual-code_img_20.png">