Our great sponsors
-
pages-gem
A simple Ruby Gem to bootstrap dependencies for setting up and maintaining a local Jekyll environment in sync with GitHub Pages
-
WorkOS
The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.
-
Puts Debuggerer
Ruby library for improved puts debugging, automatically displaying bonus useful information such as source line number and source code.
-
Grav
Modern, Crazy Fast, Ridiculously Easy and Amazingly Powerful Flat-File CMS powered by PHP, Markdown, Twig, and Symfony
The great thing about Hugo is we can just use a theme as is or we can edit and add to the theme over time. Just make sure the theme you want to edit has a license that allows for it! Most of the themes have a MIT License, which is fine to edit and build on. Editing Hugo themes does require some level of knowledge in html and css. Don't know it? That's fine, just leave the theme as is! That's the great thing about building a site with Hugo. The theme on our website is based on beautifulhugo.
GitHub Pages has its own quick start guide. Following this will generate a basic "hello world" html website. The website can be viewed at https://{{your-github-username}}.github.io. By default, GitHub will serve the website from the base directory. Serving from the base directory means we can't place our Hugo project into this repo. But we can change some settings so that this repo both stores the Hugo project and serves the static web files.
Hugo is a static site generator. Hugo allows the developer to write website content in (easy to write and understand) Markdown files then converts that content into static html and css. Static in this sense means we lost the ability to create server side scripts or processes. For most gamedevs promoting their game, this is a completely reasonable trade off.
GitHub is a website that allows devs to store and manage code with the source control tool git. If you aren't using version control, even if you are a solo dev, this is my plea for you to start. They also have a pretty cool feature called GitHub Pages, that allows a GitHub repo to host a website for free. The catch? It will only host client side static web files, ie html, css, js.
As an alternative to a static site with Hugo you can use grav for dynamic sites. Can't use it with GitHub pages, of course, but it does allow you to add searches and such to your site, while still writing your content in markdown files.
Eyyy nice to see GitHub Pages receiving some love, this is exactly the approach I used to self-publish my game! I used NSIS to make an installer for my game, then released it on GitHub. Then made a very simple little site and linked the download button to the GitHub release, and voila! Super basic self-publishing.
Related posts
- Deploying flask app to Kubernetes using Minikube
- How to Build a Personal Website Using GitHub Pages and Hugo?
- Refactoring GitOps repository to support both real-time and reconciliation window changes
- "Git-based Jamstack" is the way to go for engineers who want to start a blog
- Top 5 DevOps Best Practices You Should Use