The Exile Website

The promotional website for the Exile game. Designed to serve as a quick professional introduction for any promotional purposes. Everything is on a single page, summarizes basic information, and presents things in an appealing way.

How to Build the Site

Constructing and editing the site is fairly easy, but will require setting up some tools first. If you face seemingly unsolvable errors, you might be lacking something needed by the theme you are using.

Step 1: Building

• The site is built using the Hugo static site generator: https://gohugo.io/
• You will need an up to date version of Hugo extended version.
• in terminal, use cd to access the directory of the site.
• use hugo server to test the site locally
• use hugo to build the site
• the build will go into the public folder. Be sure to delete old build files before building.

Step 2: Hosting

• We are using codeberg pages https://docs.codeberg.org/codeberg-pages/
• The main branch contains the build files.
• the pages branch contains the actual website which will be published online.
• copy the contents of the public folder into the pages branch.
• Codeberg should automatically use the repository's webhook to turn the pages into a published site (assuming you haven't disabled it).
• Check out the site at MYUSERNAME.codeberg.page/exile_website/

Theme

• The theme does the heavy lifting. It is stored in the Themes folder.
• You may wish to update the theme to the latest version if things are now out of date.
• Changing to a new theme will break the website.
• We are using Hugo story: https://github.com/caressofsteel/hugo-story
• Hugo Story comes with an example website full of examples you may find useful.
• While Hugo itself supports a wide array of features, this particular theme has been designed for single page websites.
• If you want to add entirely new features you may need to create custom code.
• If you want to add radically different features (e.g. a wiki or a blog), it would be easier to create a new site using an appropriate theme. https://themes.gohugo.io/

Other Important Files

• The data folder contains the written contents of each part of the page.
• Look at the theme's example website for details on how to format the data files.
• The layouts > index.html file combines the data with templates ("partials") from the theme, and decides the order of presentation.
• static > images contains the screenshots etc.
• Those are the files to know about if you just need to fix a typo, update a link, add a screenshot etc.
• For more advanced changes, see the Hugo documentation, or this tutorial series: https://www.youtube.com/playlist?list=PLLAZ4kZ9dFpOnyRlyS-liKL5ReHDcj4G3

Screenshots and Gallery

• This is not a great place for a large gallery of every screenshot ever taken (as tempting as it may be to add one).
• The gallery gives a minimum introduction to Exile. About 12 screenshots would be an appropriate maximum.
• Ideally screenshots should be ones that will age gracefully (e.g. not displaying content likely to become obsolete). That means we don't need to replace them often or ever.
• If you find better screenshots, you might want to replace lower quality ones rather than just adding more.
• Luanti can produce screenshots with large file sizes. You may need to adjust them.

License

CC BY-SA 4.0 for content. GPLv3 or later for code.

Credit

Originally created by Dokimi, in April 2026