IOGKF_website_template — HTML 启动器模板

SHA-256: b0b379e21e92fc1f180f33aa1458c01394eea3ac667e0e1e8bac7784b98e5699

2026-10-04T23:08:20.497Z

# IOGKF Dojo Website Template

A modern, static website template for Goju-Ryu Karate dojos affiliated with the International Okinawan Goju-Ryu Karate-do Federation (IOGKF). Create a professional, mobile-responsive website for your dojo with minimal technical knowledge required.

> **Note**: This is an independent open-source project and is not officially affiliated with or endorsed by IOGKF.

## 🥋 Overview

This template provides a unified, professional web presence for IOGKF dojos worldwide while allowing complete customization of your dojo's specific information. Built with Hugo static site generator and featuring clean, traditional styling appropriate for martial arts organizations.

### Key Features

- ✅ **Easy Configuration** - Manage content through simple YAML files
- ✅ **Multi-language Support** - English and Portuguese included, extensible
- ✅ **Mobile Responsive** - Looks great on all devices
- ✅ **Fast & Secure** - Static site generation for optimal performance
- ✅ **Free Hosting** - Deploy to GitHub Pages at no cost
- ✅ **Professional Design** - Clean, traditional aesthetic for martial arts
- ✅ **IOGKF Branding** - Unified association identity with custom dojo details

## 🚀 Quick Start

### For Dojo Owners (Simplest Setup)

**Want your dojo website live in 15 minutes?** Perfect for dojo owners who just want to get online quickly with basic information.

👉 **[🥋 Dojo Owner's Quick Start Guide](docs/QUICK_START.md)** - Step-by-step for non-technical users

### For Developers

[![Deploy to GitHub Pages](https://img.shields.io/badge/Deploy%20to-GitHub%20Pages-blue?style=for-the-badge&logo=github)](https://github.com/karate-dojo/IOGKF_website_template/generate)

> **📝 Note**: After creating your repository, remember to enable GitHub Pages in Settings → Pages → Source: "GitHub Actions" before your first deployment.

**[📖 Complete Setup Guide](docs/SETUP.md)** - Local development and advanced configuration

## 📋 Prerequisites

- **Hugo Extended v0.100.0+** ([Installation Guide](https://gohugo.io/installation/))
- **GitHub Account** for hosting (free)
- Basic text editing skills for YAML configuration

_Verify Hugo installation: `hugo version` (must show "extended")_

## ⚙️ Configuration

All website content is managed through YAML configuration files. No HTML or technical knowledge required!

### Essential Files

| File                       | Purpose                                 |
| -------------------------- | --------------------------------------- |
| `data/en/dojo.yaml`        | Basic dojo information, contact details |
| `data/en/instructors.yaml` | Instructor names, ranks, photos         |
| `data/en/schedule.yaml`    | Class schedule and timetables           |
| `data/social.yaml`         | Social media links and handles          |
| `static/images/logo.png`   | Your dojo logo                          |

**📖 Complete reference:** [Configuration Guide](docs/CONFIGURATION.md)

## 🌍 Multi-language Support

The template includes English and Portuguese translations. To add more languages or customize translations, see [� Language Configuration](docs/LANGUAGE_CONFIGURATION.md)

## 📚 Documentation

### Getting Started

- [🥋 **Dojo Owner's Quick Start**](docs/QUICK_START.md) - **15-minute setup for dojo owners**
- [📖 Complete Setup Guide](docs/SETUP.md) - Advanced setup and local development
- [⚙️ Configuration Reference](docs/CONFIGURATION.md) - All YAML files explained
- [📊 Analytics Setup](docs/ANALYTICS.md) - Optional GA4 setup, consent behavior, and privacy responsibilities
- [SEO Configuration](docs/SEO.md) - Language-specific page titles and descriptions

### Customization & Advanced Topics

- [🎨 Customization Guide](docs/CUSTOMIZATION.md) - Layout, styling, and advanced features
- [📷 Images Guide](docs/IMAGES.md) - Photo requirements and upload
- [🚀 Deployment Guide](docs/DEPLOYMENT.md) - GitHub Pages setup and custom domains
- [📱 Social Media Setup](docs/SOCIAL_MEDIA.md) - Connect your social accounts

### Support & Troubleshooting

- [🔧 Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions
- [⚠️ Error Handling](docs/ERROR_HANDLING.md) - Template error recovery
- [🌐 Language Configuration](docs/LANGUAGE_CONFIGURATION.md) - Adding new languages

## 🤝 Contributing

This is an open-source project created to help IOGKF dojos worldwide. Contributions are welcome!

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

## 📄 License

MIT License - see [LICENSE](LICENSE) file for details.

## 🥋 About IOGKF

The International Okinawan Goju-Ryu Karate-do Federation (IOGKF) is the official worldwide organization for traditional Okinawan Goju-Ryu Karate, founded by Morio Higaonna Sensei.

- **Website**: [IOGKF.com](https://iogkf.com)

## 🆘 Support

- **Template Issues**: [GitHub Issues](https://github.com/gabrielpedepera/IOGKF_dojo_website_template/issues)

---

_This template is an independent open-source project created to help IOGKF dojos worldwide maintain professional websites while preserving the traditional values of Goju-Ryu Karate. Not officially affiliated with IOGKF._

## 🏆 Example Sites

_Add your dojo site here by submitting a pull request!_

---

**Made with ❤️ by Gabriel Pereira for the Goju-Ryu community**