My personal website. Statically compiled by Hugo and handwritten by Will Garrison. For more information about this repository, read my project analysis here.
This is a Hugo site. For those unfamiliar, I will describe the use cases of the various files and directories you'll find.
-
static: This directory will be dumped into the root of the public directory upon build. Files like stylesheets, scripts, and images will all be here for direct referencing
-
content: This directory contains all the markdown files that hold the "content" for my website. Each markdown file is converted to html and wrapped in the layouts, before being put in the public directory.
- _index.md: These files fill in content for the index.html files, or act to provide more metadata about a specific directory (or section in hugo terms).
-
layouts: This directory contains the html files that wrap around the content generated from the markdown documents. They use hugo methods and variables wrapped in {{ two curly bracets }} to tell our mighty assembler how to use the particular layout.
- Some parts are pretty straightforward like
{{ .Content }}, which denotates the location for Hugo to throw all the content converted from the markdown file, and some parts are a bit more like code like the begining ofpartials/head.htmlwhere I create variables to decide what to put for the title and description of each page. - _default: This directory contains 3 files that act as the main content-wrappers.
baseof.htmlis wrapped around every page on the site, whilesingle.htmlandlist.htmlare placed inside of that to wrap around the content for indivdual pages, and section indexes respectivly. The homepage is wrapped inside ofbaseof.html, but is devined asindex.htmloutside of the_defaultdirectory.- _markup: These files override Hugo's markdown renderer to add more customized functionality to the site generation. I use
render-link.htmlto addtarget="_blank"to all external links, meaning they will open in a new tab instead of replacing the current tab with it. I also userender-heading.htmlto add relative links to that part of the page using element ids and #.
- _markup: These files override Hugo's markdown renderer to add more customized functionality to the site generation. I use
- partials: This directory acts as a parts bin for frequently used chunks of html. I use three.
head.htmlbuilds the<head>section of a page,footer.htmlbuilds the footer, andcard.htmlbuilds those cards that I use for holding all the posts in a particular section of my website (about, projects, blog). These are referenced in the other html files as{{ partial x.html . }}where the . is the context given for it to pull variables from.
- Some parts are pretty straightforward like
-
config.yaml: This file holds the overal configuration for the hugo site. This cascades down to every page, but some values can be overwritten by markdown frontmatter (yaml surronded by a line of
---).
This website directly relies on the following projects/pieces of media:
- Hugo, the static site generator
- Fonts by Joe Prince and Mark Simonson
- Social Icons by Freepik
- Color Scheme adapted from Gruvbox
All code, including all html, css, js, and yaml files, are licensed under the GNU General Public License. You can read that in the LICENSE.GPL file.
All content, including all images and markdown files, are licensed under the Creative Commons Attribution Share Alike license. You can read that in the LICENSE.CCASA file.