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-namehugo server -DThis will start a local development server at http://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.mdThen 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-m10cThen 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