2.5 KiB
Portfolio Website
This repository hosts my personal website and project portfolio.
The site is built with Hugo, a fast static site generator, and is intended to showcase my work, projects, background, and selected professional information in a simple and maintainable format.
Purpose
This website is meant to:
- present my portfolio projects
- highlight my skills, experience, and interests
- provide a central place to share information about my work
- serve as the public source for my personal website
Tech Stack
- Framework: Hugo
- Output: Static website
- Language: Markdown for content, templates for layout
Getting Started
Prerequisites
Install Hugo before running the site locally.
- Hugo installation guide: https://gohugo.io/installation/
To verify your installation:
hugo version
Run Locally
Start the development server with:
hugo server -D
Then open:
http://localhost:1313
The -D flag includes draft content during local development.
Build for Production
Generate the static site with:
hugo
The generated files will be placed in the public/ directory.
Project Structure
Typical Hugo projects use a structure similar to the following:
.
├── archetypes/
├── assets/
├── content/
├── layouts/
├── static/
├── themes/
├── config.toml
└── README.md
Depending on the Hugo version and configuration style, the main config file may also be named hugo.toml, hugo.yaml, or hugo.json.
Content Management
Portfolio content is generally managed through the content/ directory. Typical updates include:
- adding new project pages
- editing homepage and about page content
- updating images and downloadable assets in
static/ - adjusting layouts and partials in
layouts/
To create a new content page:
hugo new content/projects/my-project.md
Deployment
This project is intended to be deployed as a static website.
Typical deployment options include:
- GitHub Pages
- Netlify
- Vercel
- any static file hosting provider
Deployment generally consists of building the site with Hugo and publishing the contents of the public/ directory.
Notes
- keep content in Markdown for simple maintenance
- use Hugo templates and partials to keep layouts reusable
- review generated pages locally before publishing changes
License
This repository contains the source code and content for my personal website. Reuse terms can be added here if needed.