This site was built using (and adapting) the Academic Template for Hugo. The Hugo Academic Resumé Template empowers you to create your job-winning online resumé and showcase your academic publications. Wowchemy makes it easy to create a beautiful website for free. Edit your site in Markdown, Jupyter, or RStudio (via Blogdown), generate it with Hugo, and deploy with GitHub or Netlify. Customize anything on your site with widgets, themes, and language packs.

I encourage anyone to use this site as a starting point for their own academic website. Keeping the site acknowledgement footer is encouraged, but not mandatory.

Below, you will find detailed instructions about what to do after creating your site from the template.

1. First, select Use this template at the top of this repository and choose Create a new repository, or open Create a new repository from this template. Choose an owner and repository name, then create the repository. This gives you a clean, independent copy without inheriting this site’s commit history. Please do not fork this repository: it is maintained as my personal website and does not accept external pull requests or direct contributions.

2. Second, you will need to create an account at https://www.netlify.com/, click Add a new site, Import an existing project, then choose GitHub as provider, then pick the repository you created from the template. You'll see a few more screens where you can simply use the default options.

3. There! You have your website up and running already! The URL to your new site will look something like this yoursitename.netlify.app. You can change the name of the subdomain (yoursitename, before the .netlify) from the Netlify site settings, but if you have your own custom domain name, you can also change it. Try your new site URL in your browser to confirm it works.

4. Now it's time to make some changes, like changing the name, bio, photo, publications, etc. Exciting!! Note that it is possible to make changes directly on github.com, but it is easier to see them in real time. Therefore, I recommend that you download GitHub Desktop, log in, and make a local copy (a “clone”) of the repository you created from this template.

5. Next, to view the website in real time, you will need to use Windows PowerShell. It is already installed with Windows, you just have to type the name in the search bar and it will pop up.

6. Install Git for Windows and Go if they are not already available. You do not need to install Hugo globally. This repository includes a preview script that downloads and uses its own isolated copy of Hugo Extended 0.110.0—the version known to work with this legacy Wowchemy site. It will not interfere with Hugo versions used by other websites.

So far, so good. Next, in Windows PowerShell, there are two commands you need to kickstart your live website preview. First, change the working directory to the repository you cloned from your account. This might look like this:

cd "D:\github\starter-academic"

Second, run the repository’s preview script:

.\preview.ps1

The script downloads the correct Hugo version on its first run, starts the live preview, and opens it in your browser. Changes refresh automatically. Press Ctrl+C when you want to stop the preview.

The local address will usually be:

http://localhost:1313/

Nice! Now is time to have fun. Make sure to change the following:

1. The site title and menu layout.

   1. For the site title, edit the following file: config\_default\config.toml.
   2. For the menu layout, edit the following file: config\_default\menus.toml.

2. The website icon (you will see that when seeing your site in Google search results for example)

   1. For this, change the photo located at assets\media\icon.png.

3. On the home page: your name and catchy intro sentence.

   1. For this, edit the following file: content\en\home\blank.md (beware, that part was made in custom HTML so could be confusing! However, you don't need to worry about that part if you only change the name and personalized sentence).

4. On the bio page: Your photo, name, title, university, social media URLs, bio, interests, education, and skills.

   1. For this, change the name of the following folder to your name: content\en\authors\remi-theriault.

   2. Next, within that folder, change the photo called avatar.jpg and edit the file called _index.md.

   3. Next, change the name of the specified author in the following file: content\en\bio\bio.md.)

   4. Next, to change your skills, edit the following file: content\en\bio\skills.md.

5. On the contact page: your email, phone number, address, google maps coordinates, and directions.

   1. For this, edit the following file: config\_default\params.toml.

   2. To remove the picture of the building, first delete the ![SU](SU.jpg) line in the content\en\contact\contact.md file. Next, you can delete the other pictures within that folder to clean things up (unless you want to use your own photo of course).

6. On the publications page: your publications (duh!)

   1. For this, edit the individual publication folders in the following folder: content\en\publication. You'll have to edit each publication's index.md file individually.

7. You can delete some sections of the website if they don't apply to you: News, Blog, Media, Tutorials, Donate, etc.

   1. Those sections are located in content\en.

8. Note that there is still things that you don't see on the site but might want to clean anyway (more below).

Some tips:

• To change the French (or other language) version of the site, you will need to repeat those steps in the content\fr subfolder.
• Normally, for folders located in the content folder, there is a index.md file. That's the file you don't usually want to change. Edit the other file instead. But for project pages (blog, media, news, tutorials), it works a bit differently. The page has its own folders, but individual elements have their own folder too, usually called "project-media" or something like that, and in those cases, you want to edit the index.md file.
• To host files at the root of your site, place them in the static folder. Feel free to delete all of my other files there (EXCEPT the admin folder, which is needed for administrative reasons). You can ignore all other files that we haven't covered so far.
• Redirects can be specified in the root file netlify.toml. In that file, please delete the "Strict-Transport-Security" headers paragraph (unless you have your own Report URI account).
• Google analytics can be specified in config\_default\params.toml (please delete/replace my GA ID).
• Don't hesitate to ask me questions, or ask on the wonderful Wowchemy discord: https://discord.gg/z8wNYzb
• Make sure to read the docs first though: https://wowchemy.com/docs/

If you used this site as a template and enjoy it, consider sponsoring me and Geo Cushen, the creator of Wowchemy.