alpha — Hugo 启动器模板

SHA-256: b0015c71a0a17f53f79118383494902f1d54a55ed587a228a4257c1110f023d4

2026-10-04T00:47:07.958Z

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/oxypteros/alpha/refs/heads/main/.github/screenshots/alpha-header-dark.webp">
  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/oxypteros/alpha/refs/heads/main/.github/screenshots/alpha-header.webp">
  <img alt="Alpha header demo screenshot" src="https://raw.githubusercontent.com/oxypteros/alpha/refs/heads/main/.github/screenshots/alpha-header.webp">
</picture>

# Alpha — Hugo Theme

[![Latest Release](https://img.shields.io/github/v/release/oxypteros/alpha?label=Alpha&style=flat&color=5f5f5f)](https://github.com/oxypteros/alpha/releases/latest)
[![Hugo Version](https://img.shields.io/badge/Hugo-%5E0.159.2-5f5f5f?&style=flat&logoColor=white)](https://github.com/gohugoio/hugo/releases)
[![License](https://img.shields.io/github/license/oxypteros/alpha?label=License&style=flat&color=5f5f5f)](https://github.com/oxypteros/alpha/blob/main/LICENSE)
[![Last Commit](https://img.shields.io/github/last-commit/oxypteros/alpha?label=Last%20Commit&style=flat&color=5f5f5f)](https://github.com/oxypteros/alpha/commits/main)
[![Stars](https://img.shields.io/github/stars/oxypteros/alpha?label=Stars&style=flat&color=5f5f5f)](https://github.com/oxypteros/alpha/stargazers)

[![Live Demo](https://img.shields.io/badge/Demo-alpha.oxypteros.com-2196f3)](https://alpha.oxypteros.com)
[![Docs](https://img.shields.io/badge/Docs-Available-2196f3)](https://alpha.oxypteros.com/docs)

![Netlify](https://img.shields.io/netlify/865e5cb8-b588-4738-a1ea-169c89f3d3c5?label=Netlify&style=flat&logo=netlify&logoColor=ffffff)
![Vercel Deploy](https://deploy-badge.vercel.app/vercel/alpha-build?color=4cc61e&logoColor=ffffff)
![Cloudflare Pages](https://img.shields.io/badge/Cloudflare%20Pages-live-4cc61e?style=flat&logo=cloudflarepages&logoColor=ffffff)

## Write Freely. Publish Beautifully. Alpha Does the Rest.

**Alpha** is a Hugo theme designed for _personal_, _text-first_ websites. It gives you a **zero-distraction canvas** while providing a professional, flexible engine that automatically handles SEO, social sharing, and layout details.

Whether you write **blogs, essays, stories, or long-form content**, Alpha feels less like a template and more like a **writing partner**.

### Why Alpha Stands Out

Alpha isn’t just another Hugo theme. It’s built around three core principles:

1. **Worry-Free Writing with LiVa**:
   Forget guessing about configuration or frontmatter mistakes. Alpha’s built-in **LiVa validator** gives instant feedback in your local dev environment, helping you get everything right the first time.

2. **A Stability Contract with Hugo**:
   Updates to Hugo? No worries. Alpha defines a tested range of compatible Hugo versions and delivers updates that are safe and reliable. Focus on content, not maintenance.

3. **Guidance, Not Just Templates**:
   Alpha includes a [step-by-step Beginner’s Guide](https://alpha.oxypteros.com/get-started/) and [comprehensive Reference Docs](https://alpha.oxypteros.com/docs/), so you always know what to do next.

## Key Features That Matter

- **Flexible Layouts** — Build pages easily using shortcodes without touching the theme code.
- **Automated SEO Engine** — Schema.org, Open Graph, and Twitter Cards handled automatically.
- **Unobtrusive Design** — Minimalist, accessible-first, and content-focused.
- **Performance Optimized** — Fast out-of-the-box with lightweight code.
- **Modern Development** — Optional Tailwind CSS mode for full customization.
- **Built-in Integrations** — Pagefind search and privacy-friendly GoatCounter analytics.
- **Multilingual Support** — Ready for content in multiple languages, including simplified Chinese.

## Get Started Quickly

**New to Hugo?** Follow ["From Zero with Zero"](https://alpha.oxypteros.com/get-started) for step-by-step guidance.  
For detailed instructions, configuration, and examples, see the [documentation](https://alpha.oxypteros.com/docs).

## Table of Contents

- [Installation](#quick-install)
- [Demo](#demo)
- [Need help?](#need-help)
- [Feedback or Questions](#feedback-or-questions)
- [Versioning & Changelog](#versioning--changelog)
- [License](#license)

### Quick Install

#### Prerequisites

- **Git**
- **Hugo** (`^0.146.1`)
- Node.js (_optional, for Tailwind CSS_)
- Go (_only if using Hugo Module method_)

#### For a new site or testing

**Manual Setup — Option 1**

1. [Download the Alpha Starter](https://alpha.oxypteros.com/downloads/alpha-starter.zip).
2. Unzip and navigate into the folder:

```bash
cd alpha-starter
hugo server

```

**Use GitHub template — Option 2**

1. Go to the [Alpha Starter](https://github.com/oxypteros/alpha-starter).
2. Click the **“Use this template”** button to create a new repository.
3. Clone your new repo locally a navigate into the repo folder and run:

```bash
cd YOUR-PROJECT-NAME
hugo server
```

#### For a existing Hugo site

**Git Submodule — Option 1**

```bash
git submodule add https://github.com/oxypteros/alpha.git themes/alpha
```

In your `hugo.toml`:

```toml
theme = "alpha"
```

**Hugo module — Option 2** (_requires golang_)

1. Initialize your site as a module (_if not already_):

```bash
hugo mod init github.com/yourusername/yoursite
```

2. Add Alpha as a dependency:

```bash
hugo mod get github.com/oxypteros/alpha
```

3. Reference the theme in `hugo.toml`:

```toml
theme = ["github.com/oxypteros/alpha"]
```

> Copy or [download](https://alpha.oxypteros.com/downloads/config.zip) the `themes/alpha/config/_default/` to your root `config/` folder and merge carefully to avoid overwriting your existing setup.

## Demo

[Alpha in action](https://alpha.oxypteros.com)

## Need help?

- [Documentation](https://alpha.oxypteros.com/docs)
<!-- - [Developing Alpha (Tailwind setup)](https://alpha.oxypteros.com/docs/developing-alpha) -->

## Feedback or Questions?

- [Open an issue](https://github.com/oxypteros/alpha/issues)
- [Contact me](mailto:[email protected]?subject=Alpha%20theme).

## Versioning & Changelog

### Versioning

This theme uses Semantic Versioning:

```
MAJOR.MINOR.PATCH

```

- **MAJOR** — Breaking changes, large reworks, changes incompatible with previous configurations, or significant updates required due to incompatible changes in upstream dependencies (like Hugo).
- **MINOR** — New features, enhancements, or content that is backward compatible.
- **PATCH** — Bug fixes, content tweaks, small updates, or non-breaking config changes.

**Hugo Version Compatibility:** Alpha is a _"living theme"_, it evolves alongside Hugo itself. My goal is to adopt improvements and best practices from new Hugo releases as they become relevant and beneficial to the theme.

This means Alpha **does not aim to stay locked to older Hugo versions**. But to embrace modern Hugo capabilities to provide a better user and developer experience.
If a theme update requires a new minimum Hugo version, this will be clearly noted in the documentation and in the changelog.

### Changelog

You can find all changes in [CHANGELOG.md](./CHANGELOG.md).

## License

This theme is released under the [MIT License](./LICENSE).

<picture>
  <source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/alpha-footer-dark.webp">
  <source media="(prefers-color-scheme: light)" srcset=".github/screenshots/alpha-footer.webp">
  <img alt="Alpha footer demo screenshot" src=".github/screenshots/alpha-footer.webp">
</picture>