Persona

A portfolio, a resume, a blog, and a Zola theme.

Author: Chang, Heng-Sheng

This theme requires Zola version 0.23.0 and above

License: MIT

Homepage: https://github.com/hanson-hschang/Persona-Zola-Theme

Live Demo: https://hanson-hschang.github.io/Persona-Zola-Theme

Tags:

• portfolio
• resume
• blog

Last updated: 2026-10-12T05:13:27Z

Persona Zola Theme

a modern, responsive and lightweight theme for resume, portfolio, and blog

Demo](https://hanson-hschang.github.io/Persona-Zola-Theme/) • Features • Showcase • Installation • Configuration • Troubleshooting • [Credits

✨ Features

• 🎨 Modern Design: Clean, professional, and minimalist aesthetic
• 📱 Fully Responsive: Optimized for desktop, tablet, and mobile devices
• ⚡️ Fast Performance: Lightweight and optimized for speed
• 📋 Resume/CV: Build-in structure designed for customization
• 🎭 Portfolio with Posts: Showcase your work with previews and posts
• 📧 Contact Forms: Integrated contact form email support
• 🔍 Search Ready: Built-in search index generation (--upcoming feature--)

🌟 Showcase

Using Persona for your site? We'd love to see it! Submit a Pull Request to add your site to our showcase.

• Show Your Site - Add your site with us!
• Hanson.HSChang - Personal website of Heng-Sheng Chang

🚀 Installation

This is a theme built with Zola 0.23 or newer. Please proceed to install the theme after initializing your Zola site.

The easiest way to install the theme is to add it as a git submodule to your themes directory:

# Navigate to your Zola site directory
cd your-zola-site

# Add the theme as a submodule
git submodule add https://github.com/hanson-hschang/Persona-Zola-Theme.git themes/persona

To update the theme:

# Update the submodule
git submodule update --init --recursive

⚙️ Configuration

Basic Setup

1. Copy the configuration and the landing page content from the theme to your website root to get started quickly:

   # Copy the configuration
   cp themes/persona/config.toml config.toml
   
   # Copy the landing page content
   cp themes/persona/content/_index.md content/_index.md

2. Enable the theme by adding the following line at the beginning of your config.toml file:

   theme = "persona"

Build & Serve

After completing the setup, build and serve your site with Zola:

[!TIP] For a complete walkthrough of configuration and customization, see the Begin with Persona post.

🆘 Troubleshooting

Common Issues

• Theme not loading:

  • Ensure theme = "persona" is set at the first line of config.toml
  • Check that the theme is in the correct directory: themes/persona/

• Contact form not working:

  • Verify web3form_public_key is set in configuration
  • Check Web3Forms documentation for setup

Getting Help

• Read the Zola documentation
• Check ARCHITECTURE.md for detailed theme codebase structure
• Report issues or request features by contributing on GitHub

🙏 Credits

Persona is built with and inspired by: