A basic Hugo static site project template configured with a minimal theme and essential site settings. This repository provides a starting point for building a Hugo-powered website with multilingual support and customizable content structure.
Features
- Hugo static site generator setup
- Minimal theme integration (
hugo-theme-mini) - Multilingual support with CJK language enabled
- Configured permalinks and pagination
- Syntax highlighting and table of contents support
- Social links and site metadata configuration
Tech Stack
- Hugo - Static site generator
- Go Modules (go.mod) for dependency management
- YAML for site configuration
Getting Started
Prerequisites
- Hugo installed (version compatible with Go 1.17)
- Go 1.17 or higher
Installation
Clone the repository:
git clone https://github.com/justin-napolitano/hugo_test.git
cd hugo_test
Running the site locally
Start the Hugo server:
hugo server -D
Open your browser at http://localhost:1313 to view the site.
Project Structure
├── archetypes/ # Default content templates
├── config.yaml # Site configuration file
├── content/ # Markdown content files
└── go.mod # Go module file
archetypes/default.md: Template for new content files with default front matterconfig.yaml: Main site configuration including baseURL, theme, languages, and parameterscontent/: Contains site content organized in directories (e.g.,journal)go.mod: Go module definition for dependency management
Future Work / Roadmap
- Add more comprehensive content and sections
- Enable comments and analytics by configuring Disqus and Google Analytics
- Expand multilingual support and translations
- Customize theme or develop a custom Hugo theme
- Implement additional site features such as RSS feeds, math rendering, and enhanced SEO