Skip to content

aktech/aktech.github.io

Repository files navigation

Personal Blog and Webpage

Website: https://iamit.in Blog: https://iamit.in/blog

Built with Hugo and deployed via GitHub Actions to GitHub Pages.

Quick Start

Prerequisites

  • Hugo (v0.152.0 or later, extended version)
  • htmltest (optional, for link checking)

Local Development

# Serve the site locally with live reload
hugo server

# Open http://localhost:1313 in your browser

Building

# Build the site (outputs to public/)
./build.sh

# Or manually:
hugo --gc --minify
cp public/index.xml public/atom.xml

Testing

# Check for broken links
htmltest

Writing a New Post

  1. Create a new markdown file in content/blog/:

    # Format: YYYY-MM-DD-Title.md
    touch "content/blog/$(date +%Y-%m-%d)-My-New-Post.md"
  2. Add front matter:

    ---
    date: "2024-01-15"
    title: My New Post
    tags:
      - Tag1
      - Tag2
    url: /blog/my-new-post/
    ---
  3. Write your content in Markdown

  4. Preview locally:

    hugo server -D  # -D includes drafts
  5. Commit and push - GitHub Actions will automatically deploy

Project Structure

├── content/           # Markdown content
│   ├── blog/         # Blog posts
│   ├── about.md      # About page
│   ├── talks.md      # Talks page
│   └── publications.md
├── layouts/          # Hugo templates
├── static/           # Static assets (images, CSS, JS)
├── hugo.toml         # Hugo configuration
└── .github/workflows/
    ├── hugo.yml      # Deployment workflow
    └── pr-check.yml  # PR validation workflow

Deployment

The site automatically deploys via GitHub Actions when you push to main:

  1. Build with Hugo
  2. Run htmltest for link validation
  3. Deploy to GitHub Pages

RSS Feeds

License

See LICENSE

About

My Homepage/Blog at Github. 📝

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages