ryouze.net is a personal website built with Hugo that uses the Gokarna theme.

The website is hosted on GitHub Pages and is accessible via the custom domain ryouze.net.

I wanted a personal blog to share my thoughts with the world. I chose Hugo because it allows me to write content in Markdown and generate static HTML files that can be hosted on GitHub Pages.

I also included a manual theme update script, because I couldn't get the theme to update automatically using git submodules when using GitHub Actions.

• Automatic rebuilds using GitHub Actions.
• Easy content management with Markdown.

The project is organized as follows:

• .github: Contains GitHub Actions workflows (for automatic rebuilds).
• archetypes: Contains templates for new posts (e.g., title, date).
• assets: Contains static assets (e.g., images).
• content: Contains the actual content of the website (posts).
• data: Contains configuration files (e.g., JSON, TOML, YAML).
• i18n: Contains internationalization files for multilingual websites.
• layouts: Contains templates for the website.
• public: Contains the generated static files.
• static: Contains static files (e.g., CSS, JavaScript).
• themes: Contains the theme used by the website.

This project has been tested on the following systems:

• MacOS 14.4 (Sonoma)

To run this project, you'll need:

• Hugo

Follow these steps to build the project:

1. Clone the repository:

   git clone https://github.com/ryouze/ryouze.github.io.git

2. Update the Gokarna theme:

   cd ryouze.github.io
   chmod +x update-theme.sh
   ./update-theme.sh

3. Build the project (generate static files):

   hugo

After successful build, you can access the generated static files in the public directory.

To create a new post:

hugo new posts/title.md

To start the Hugo server and view changes in real-time:

hugo server

To build the site and generate static files:

hugo

To update the Gokarna theme:

./update-theme.sh

All contributions are welcome.

This project is licensed under the GNU GPLv3 License.

• Hugo
• Gokarna