This document provides a step-by-step guide on how to edit content on pages using YAML files for humanatlas.io. YAML files are used to define the content of pages on the website. By following these instructions, you can contribute to the Human Atlas project and help improve its content.
update-content.mp4
-
Navigate to the page that needs to be updated and copy the route.
-
In the URL, update '.com' with '.dev'. (https://github.com/cns-iu/humanatlas.io -> https://github.dev/cns-iu/humanatlas.io)
-
If not installed, install the YAML Extenstion (search 'redhat.vscode-yaml' in Extensions Marketplace)
-
Navigate to Source Control and create a new branch off the main/develop branch.
-
Enter your branch name and press Enter
-
Select the reference branch(main/develop) for your new branch and click 'Switch to Branch' to switch to your new branch.
-
Navigate to ../src/assets/content/pages in the directory and open the YAML file with the same name as the route copied earlier.
-
Type '- type:' and hit enter. You will be recommended with the list of the components which you can add.
-
Select the component you want to add. Hover over the component name for the description of the component.
-
If you see any error, hover over it to see what fields are missing and add them accordingly.
-
Once you are done with adding the new component, head back to Source Control. Add a commit message and push it to your branch.
-
From Views and More Actions, select Pull Request and create new Pull Request.
-
In MERGE CHANGES FROM section, select cns-iu/humanatlas.io in REMOTE and 'your_branch_name' in BRANCH. In INTO section, select cns-iu/humanatlas.io in REMOTE and main or develop in BRANCH (based on where you want to merge your changes). Add title and description for your Pull Request and click Create.
-
The maintainers of the humanatlas.io will now review your Pull Request. They may approve it or may ask you to make more changes.