Aurelia Website

The official website and blog for Aurelia (aurelia.io), built with Hugo.

🚀 Quick Start

1. Prerequisites

   • Hugo Extended (v0.110.0 or later)
   • Node.js (v16 or later)
   • npm (v8 or later)

2. Installation

   # Clone the repository
   git clone https://github.com/aurelia/website.git
   cd website
   
   # Install dependencies
   npm install

3. Development

   # Start the development server
   hugo server -D

   Visit http://localhost:1313 to see the site.

📁 Project Structure

website/
├── content/          # Site content
│   ├── blog/        # Blog posts organized by date
│   │   └── YYYY/    # Year folders
│   │       └── M/   # Month folders
│   │           └── D/# Day folders
│   ├── _index.md    # Homepage content
│   ├── faq.md       # FAQ page
│   ├── sponsor.md   # Sponsor page
│   └── roadmap.md   # Roadmap page
│
├── themes/
│   └── aurelia-theme/# Custom Aurelia theme
│       ├── assets/   # Theme assets (CSS, JS)
│       ├── data/     # Theme data files
│       └── layouts/  # Theme templates
│
└── static/          # Static files

📝 Content Management

Blog Posts

Create new blog posts in content/blog/YYYY/M/D/ with this frontmatter:

+++
title = "Post Title"
author = "Author Name"
author_url = "https://example.com" # Optional
description = "Post description"
date = 2024-01-01T10:00:00Z
lastmod = 2024-01-01T10:00:00Z
draft = false
+++

Post content goes here...

Navigation

Edit themes/aurelia-theme/data/header.yaml to modify the navigation:

menu:
  - name: "Home"
    link: "/"
  - name: "Docs"
    dropdown: true
    sections:
      - title: "Current"
        items:
          - name: "Aurelia 2 Docs"
            link: "https://docs.aurelia.io"

Footer Configuration

Edit themes/aurelia-theme/data/footer.yaml to update footer links:

footer:
  links:
    - name: "GitHub"
      link: "https://github.com/aurelia"
    - name: "Twitter"
      link: "https://twitter.com/aureliaeffect"

🛠 Development

Local Development

1. Start the Hugo server:

   hugo server -D

2. Make changes to content or theme files

3. Hugo will automatically reload your browser

Production Build

hugo

The site will be generated in the public/ directory.

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

🌟 License

• Code: Licensed under the MIT License
• Content: Licensed under CC0

🌟 Community & Support

• Discord
• Discourse
• GitHub Issues
• Twitter