This repository contains the source code for my personal blog built with Hugo, a fast and modern static site generator.
This blog is built using Hugo and hosted on GitHub Pages.
To work with this repository, you'll need:
git clone https://github.com/yourusername/your-repo-name.git
cd your-repo-name
hugo server -D
This will start a local development server at https://localhost:1313/
with live reloading enabled.
.
├── archetypes/ # Template files for new content
├── assets/ # Unprocessed assets like SCSS or JS
├── content/ # Markdown files containing site content
├── data/ # Configuration files for the site
├── layouts/ # Templates for converting content into HTML
├── static/ # Static files like images, CSS, JS
├── themes/ # Site themes
├── config.toml # Site configuration
└── README.md # This file
To create a new blog post:
hugo new posts/my-new-post.md
Then edit the newly created file in the content/posts/
directory.
This site is deployed using [GitHub Actions/GitHub Pages/Netlify/etc.]. When changes are pushed to the main branch, the site is automatically built and deployed.
This blog uses the m10c theme, a minimalistic and responsive theme for Hugo.
If you're setting up the repository from scratch, you can install the theme with:
git clone https://github.com/vaga/hugo-theme-m10c.git themes/hugo-theme-m10c
Then add this line to your config.toml
file:
theme = "hugo-theme-m10c"
The m10c theme can be customized through the config.toml
file. Here are the main configuration options:
[params]
author = "Your Name"
description = "Your description here"
menu_item_separator = " - "
# Avatar/profile picture (place in static/images/)
avatar = "/images/your-avatar.jpg"
# Social media links
[[params.social]]
icon = "github"
name = "GitHub"
url = "https://github.com/yourusername"
[[params.social]]
icon = "twitter"
name = "Twitter"
url = "https://twitter.com/yourusername"
# You can add more social links following the same pattern
# Custom theme colors
[params.style]
darkestColor = "#242930"
darkColor = "#353b43"
lightColor = "#afbac4"
lightestColor = "#ffffff"
primaryColor = "#57cc8a"
Available social icons include: email
, facebook
, github
, gitlab
, instagram
, linkedin
, stackoverflow
, telegram
, twitter
, youtube
, and more.
The main configuration file is config.toml
. Edit this file to change site title, base URL, language settings, and other global configurations.
If you'd like to contribute to this blog:
- Fork the repository
- Create a new branch (
git checkout -b feature/your-feature
) - Make your changes
- Commit your changes (
git commit -m 'Add some feature'
) - Push to the branch (
git push origin feature/your-feature
) - Open a Pull Request