SkullSpace Website and Blog

A Hugo-based static website and blog for SkullSpace, a hackerspace located in Winnipeg, Canada.

About SkullSpace

SkullSpace is a hackerspace in Winnipeg, Manitoba, providing a collaborative environment for individuals interested in technology, art, and learning. Our community-driven space serves as a hub for innovation, creativity, and knowledge sharing.

About This Project

This repository contains the source code for the SkullSpace website and blog, built with Hugo, a fast and flexible static site generator written in Go.

Prerequisites

Before you begin, ensure you have the following installed:

• Hugo (Extended version recommended)
• Git
• A text editor or IDE of your choice

Getting Started

Installation

1. Clone the repository:

   git clone [email protected]:skullspace/skullspace.ca-2025.git
   cd skullspace.ca-2025

2. Install Hugo (if not already installed):

   macOS (using Homebrew):

   brew install hugo

   Linux:

   sudo apt-get install hugo

   Windows (using Chocolatey):

   choco install hugo-extended

   For other installation methods, see the Hugo installation guide.

Development

1. Start the development server:

   hugo server

   Or with draft content and future posts:

   hugo server -D -F

2. View the site: Open your browser and navigate to http://localhost:1313/

3. Stop the server: Press Ctrl+C in the terminal

Building for Production

To build the static site for production:

hugo

The generated site will be in the public/ directory, ready to be deployed.

Project Structure

.
├── archetypes/          # Content templates
├── content/             # Site content (pages, blog posts)
├── data/                # Data files (JSON, YAML, TOML)
├── layouts/             # HTML templates
├── static/              # Static assets (CSS, JS, images)
├── themes/              # Hugo themes
├── config.toml          # Site configuration
└── public/              # Generated static site (gitignored)

Content Management

Creating a New Blog Post

hugo new posts/my-new-post.md

Creating a New Page

hugo new pages/my-new-page.md

Contributing

We welcome contributions from the SkullSpace community! Here's how you can help:

1. Fork the repository on GitHub
2. Create a feature branch:

   git checkout -b feature/your-feature-name

3. Make your changes and test them locally
4. Commit your changes with descriptive commit messages:

   git commit -m "Add: description of your changes"

5. Push to your fork:

   git push origin feature/your-feature-name

6. Submit a pull request on GitHub

Note that by contributing you agree to assign copyright to SkullSpace Winnipeg Inc. and abide the by LICENSE

Guidelines

• Follow existing code style and conventions
• Test your changes locally before submitting
• Write clear, descriptive commit messages
• Update documentation if needed
• Be respectful and constructive in discussions

Deployment

The site is typically deployed automatically via CI/CD when changes are pushed to the main branch. For manual deployment:

1. Build the site: hugo
2. Deploy the contents of the public/ directory to your hosting provider

Common hosting options:

• GitHub Pages
• Cloudflare Pages
• Netlify
• Vercel

Resources

• Hugo Documentation
• Hugo Themes
• SkullSpace Website
• SkullSpace Wiki

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For questions, suggestions, or support:

• Email: [email protected]
• Website: https://skullspace.ca/
• Discord: Join our Discord server
• Mailing List: Subscribe to our mailing list

Acknowledgments

• Built with Hugo
• Maintained by the SkullSpace community
• Special thanks to all contributors and members