Update your template
Last updated
Last updated
If the template has been updated since you first created your website from it, you may want to pull in the updates.
👤 Your version of the template is located in the CITATION.cff
file in your website repo.
✨ The latest version of the template can be found in the main .
📋 A high-level description of changes for each version can be found in the main .
If you are coming from a pre-release version of the template (< v1.0.0
), we strongly recommend just starting from scratch and not even attempting the merge instructions below. It will be quicker, easier, and less error-prone. Forget everything you know, start a new copy of the template, read through and follow the new docs, and judiciously copy and modify code from your old site into your new site. We know this is frustrating, but we think the upgrade is worth it.
If you can't or don't want to start from scratch, go through the merge instructions below, then go run the and if applicable.
First, begin a merge of the latest template repo into your website repo. The method to do this depends on :
Based on :
After you've started a merge, you'll mostly likely have to resolve some merge conflicts.
If you generated your website, you'll have to resolve all of the conflicts manually. This is because generating from a template starts a completely new, unrelated Git repo with no shared commit history, so Git has a difficult time automating the process.
If you forked your website, the process should be a little bit easier, but you'll still probably have to manually resolve some conflicts.
Sometimes updates to the template will be "breaking changes" and will affect your user content, like a component parameter being renamed. Be sure to check the changelog for these changes. You may have also made modifications to template code, like tweaking the appearance of a component. In these cases, you'll have to judiciously decide how or if to merge in the updates.
Because this is a template and not an installable package, updating it can unfortunately be difficult. This process is very tricky, even for the maintainers of this template. When doing this, carefully check every page and section on your site before publishing the changes. We can if you have trouble.
We'll assume you already know how to .
The hard part is carefully picking out which changes to accept. This essentially boils down to distinguishing between . For template content, you want to "accept incoming/their changes" (pull in updates from the template). For user content, you want to "accept current/our changes" (keep the current content in your repo). There is also , which you should be careful not to re-add.