github.io replacing with your Github user name. This is for all of your website content to go in This next part was the hardest for me when I built my site, so be sure to follow the directions carefully! For more tips/what your config file contains, check out your theme’s documentation or Github page. This way, your site will take the URL of your Github pages repo. One chance to make right away is to change the URL parameter to "/". Open this up in your text editor to check it out. Adjust some configurationsĪ lot of how your website functions is controlled by a file in your project directory called config.toml. But this isn’t yet visible to the rest of the world! Let’s get this stuff up onto Github. Paste that link into your browser and behold your beautiful website! This renders live, so each change you make and save will instantly appear (thus the “localhost” in the URL). Start by opening your terminal and type the following to install Hugo (you may need to first install Homebrew: The first thing we need to do is to install Hugo onto your computer. Some fancy scripting magic to build the site on Github pages.Commit/push the changes you’ve made to a Github repository.Build and test the site locally (using your computer as the web server).Add some basic content: a new page, a blog post.Use terminal/Hugo to build a simple website.Initiate a website directory (folder) and monitor it with git.You just need to build the site content and Github pages pretty much does the rest! What we’re going to do: Github pages is a nice way to learn a bit more about the “under the hood” operations that make a website work, while doing all of the annoying backend stuff of hosting the site, etc. However, using Wordpress forces you to lose some customizability and I don’t think you learn as much that way. Wordpress provided an easy way to pay a nominal fee to get someone else to worry about it for me. One of the most confusing things about building a website for me has always been figuring out hosting - or who stores the files for your site. This was the key for me as a recent Markdown convert. What’s more, you’re able to build pretty much the entire site by writing in Markdown rather than html. There are a bunch of free themes that will help you build out your site and very helpful documentation to help troubleshoot issues. You don’t need to know a ton about css or html and can get a site up and running in just a couple of hours. To borrow parlance from a language that may be more familiar, it’s kind of like an installing a package in R package that contains the functions and tools to easily build a website. Hugo is a nifty framework for quickly developing simple websites, like an online portfolio or CV. You have a rough idea of what you’d like your site to do/look like (i.e., you want a virtual CV, or blogging capabilities).You’re familiar with, or have heard of Markdown.You have a Github account and have used Github to host.You’ve used the terminal to use either.However, this tutorial does assume a few things: If none of that makes any sense to you, no worries! Two months ago I had no experience with either Github pages or Hugo. I recently moved my personal website from Wordpress to Github pages running a Hugo site. So, why not build a website for yourself (or a project you are working on)! Many of the tasks I queued up are now pushed way back, and there is a void of time that needs filling - preferably with something other than Netflix and binge-snacking… If your situation is at all similar to mine right now, the COVID pandemic has greatly impacted day-to-day research operations and probably has had an impact on your productivity.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |