With the Project Week GitHub Issue page, you have three options to create your Project Page:
Create a Proposal issue: If you have an idea for a project page but are not quite ready to create it yet, you can create a “Proposal” issue.
Create a Project issue: If you are ready to create your page, you can simply create a “Project” issue. This issue will allow you to fill out a convenient form to provide the necessary details.
Create the project page yourself using the template: If you prefer to create the Project Page yourself, you can still do so by using the provided template and submitting a pull request.
Get your project pages created early! The day before is best to make sure everything you need for you presentation is available. The ProjectWeek site will be closed to edits for the 10 minutes before both the opening and closing presentation session to ensure site generation. After this 10 minute period edits will be re-enabled.
If you are creating the project page yourself using the template, don’t reuse a project page template from a previous year. We have made significant updates to the template to support auto-generation of project pages, so previous years’ templates will not function properly.
Remember to fill out the title for your project when using the project creation issue
Check the formatting on the Key Investigators list when creating a project issue (this is critical for page generation):
- Firstname Lastname (Affiliation, Country)
Here are the steps using the GitHub web interface:
Navigate to your project’s
README.md on the GitHub website. For instance, if you want to update a project called YourProjectName, visit the URL like the following:
Click the edit button, as shown in this screenshot:
You can now edit the page, add images by dragging and dropping, and more.
Once done, click “Commit Changes”, and follow the instructions to create a fork and a pull request to add your changes to the webpage. See this screenshot for reference:
Here are some steps to make sure all of your awesome videos render correctly:
Videos added by drag and drop will render correctly when viewed through GitHub, but need some extra tweaks to work in the final generated website.
README.md, if you have a video link that looks like this:
Update it to:
<video controls muted src="https://github.com/NA-MIC/ProjectWeek/assets/66890913/8f257f29-fa9c-4319-8c49-4138003eba27" style="max-height:640px; min-height: 200px"> </video>
Links to externally hosted videos (such as YouTube) will need an iframe.
<iframe width="420" height="315" src="https://www.youtube.com/embed/ZWxE5QcGvE8"> </iframe>