Hugo Start Template

A starter template for Hugo static site generator with the Ananke theme.

Features

• Clean and modern design using the Ananke theme
• Responsive layout
• Category and tag support
• Easy customization
• NPM-based workflow

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v18 or later)
• Git
• Hugo

Quick Start

1. Clone the repository

   git clone <your-repo-url>
   
   cd hugo-start
   
   git submodule update --init
   

2. Install dependencies

   npm install
   

3. Start the development server

   npm run dev
   

4. View your site Open your browser and visit http://localhost:1313

Project Structure

hugo-start/
├── archetypes/        # Content templates
├── assets/           # Unprocessed assets (SCSS, JS, etc.)
├── content/          # Site content
│   └── get-start/    # Getting started guide
├── data/            # Configuration files
├── layouts/         # Template files
├── static/          # Static files
├── themes/          # Theme files (Ananke)
├── hugo.toml        # Site configuration
├── edgeone.json     # deployment configuration
└── package.json     # NPM configuration

Available Scripts

• npm run dev - Start development server
• npm run build - Build production site
• npm run preview - Preview production build locally
• npm run clean - Clean build directory

Content Management

• Build static files:

  npm run build
  

Customization

1. Site Configuration

   • Edit hugo.toml to modify site-wide settings

2. Theme Customization

   • Override theme templates in /layouts
   • Modify styles in /assets

3. Content Organization

   • Organize content in /content
   • Create sections and categories

Deployment

1. Build the site

   npm run build
   

2. Deploy the /public directory

   • Upload to your web server
   • Deploy to EdgeOne Pages
   • Use a static site hosting service

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

Support

For support, please:

1. Check the Hugo documentation
2. Open an issue in this repository
3. Join the Hugo community