{"id":32718756,"url":"https://github.com/info-tech-io/hugo-templates","last_synced_at":"2026-05-16T17:06:57.558Z","repository":{"id":315420976,"uuid":"1059239955","full_name":"info-tech-io/hugo-templates","owner":"info-tech-io","description":"Hugo Template Factory Framework - The first parametrized scaffolding tool for Hugo ecosystem","archived":false,"fork":false,"pushed_at":"2025-11-01T10:10:57.000Z","size":6069,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-02T18:04:27.295Z","etag":null,"topics":["cli","education","factory","generator","hugo","parametrized","scaffolding","static-site","template"],"latest_commit_sha":null,"homepage":"https://github.com/info-tech-io/hugo-templates","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/info-tech-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-18T07:23:08.000Z","updated_at":"2025-11-01T10:11:01.000Z","dependencies_parsed_at":"2025-09-18T14:53:51.332Z","dependency_job_id":"a2c44b7b-5482-483e-beb5-2319d911c924","html_url":"https://github.com/info-tech-io/hugo-templates","commit_stats":null,"previous_names":["info-tech-io/hugo-templates"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/info-tech-io/hugo-templates","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/info-tech-io%2Fhugo-templates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/info-tech-io%2Fhugo-templates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/info-tech-io%2Fhugo-templates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/info-tech-io%2Fhugo-templates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/info-tech-io","download_url":"https://codeload.github.com/info-tech-io/hugo-templates/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/info-tech-io%2Fhugo-templates/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33111499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","education","factory","generator","hugo","parametrized","scaffolding","static-site","template"],"created_at":"2025-11-02T18:01:09.452Z","updated_at":"2026-05-16T17:06:57.552Z","avatar_url":"https://github.com/info-tech-io.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hugo Template Factory Framework\n\n\u003e The first parametrized scaffolding tool for Hugo - bringing Angular Schematics-like functionality to static site generation\n\n## 🚀 Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/info-tech-io/hugo-templates.git\ncd hugo-templates\n\n# Initialize submodules and install dependencies\ngit submodule update --init --recursive\nnpm ci\n\n# Create a site with default template and compose theme\n./scripts/build.sh --template=default --theme=compose --output=my-site\n\n# Create a minimal site for faster builds\n./scripts/build.sh --template=minimal --theme=minimal --output=quick-site\n\n# Add Quiz Engine component for educational content\n./scripts/build.sh --template=default --theme=compose --components=quiz-engine --output=education-site\n\n# Production build with optimization and performance monitoring\n./scripts/build.sh --template=enterprise --environment=production --minify --base-url=https://example.com --performance-track --performance-report\n\n# Development build with performance tracking\n./scripts/build.sh --template=minimal --performance-track --cache-stats\n\n# Federated builds: Orchestrate multiple Hugo sites from different repositories\n./scripts/federated-build.sh --config=examples/modules-simple.json --output=federated-site\n\n# Production InfoTech.io 5-module federation\n./scripts/federated-build.sh --config=examples/modules-infotech.json --output=production --minify\n\n# Dry-run to test federation configuration\n./scripts/federated-build.sh --config=modules.json --dry-run\n```\n\n## 🎯 Why Hugo Template Factory?\n\nHugo Template Factory solves the **scaffolding gap** in Hugo ecosystem by providing:\n\n- **🎯 Parametrized Generation**: Angular Schematics-like functionality for Hugo\n- **🧩 Component Modularity**: Reusable components without Go Modules complexity\n- **🎓 Educational Focus**: Built-in Quiz Engine and learning-oriented features\n- **🔧 Script-Based Simplicity**: Accessible to non-Go developers with Bash/Node.js\n- **⚡ Performance Optimized**: Smart caching and optimized CI/CD workflows\n- **🛡️ Enterprise Ready**: Error handling, monitoring, and production features\n\n### How We Compare\n\n| Approach | Example | Flexibility | Learning Curve | Our Advantage |\n|----------|---------|-------------|----------------|---------------|\n| **Hugo CLI** | `hugo new site` | ⭐ Too basic | ⭐⭐⭐⭐⭐ Very easy | We provide ready-to-use templates |\n| **Hugo Modules** | `hugo mod get` | ⭐⭐⭐⭐⭐ Maximum | ⭐ Expert only | We abstract complexity while keeping power |\n| **Starter Templates** | Hugoplate, Doks | ⭐⭐ Monolithic | ⭐⭐⭐⭐ Easy | We offer modular components vs all-or-nothing |\n| **Universal Tools** | Cookiecutter, Yeoman | ⭐⭐⭐ Generic | ⭐⭐⭐ Moderate | We're Hugo-native with theme integration |\n| **Platform Builders** | Hugo Blox Builder | ⭐⭐⭐ Ecosystem-locked | ⭐⭐⭐ Moderate | We stay open and Hugo-compatible |\n| **🚀 Hugo Template Factory** | **Our solution** | **⭐⭐⭐⭐⭐ Maximum** | **⭐⭐⭐⭐ Easy** | **Best of all worlds** |\n\n**The Sweet Spot**: We bridge the gap between \"too simple\" and \"too complex\" by offering the configurability of Hugo Modules with the simplicity of starter templates.\n\n## 🌐 Federated Build System\n\n**NEW: Layer 2 Federation** - Orchestrate multiple Hugo sites from different repositories into a unified GitHub Pages deployment.\n\n### What is Federation?\n\nThe federated build system allows you to:\n- **Merge content from multiple repositories** - Each team maintains their own Hugo site independently\n- **Deploy as unified site** - Single GitHub Pages deployment from distributed sources\n- **Maintain module independence** - Teams develop, test, and version their content separately\n- **Centralized orchestration** - One configuration controls the entire federation\n\n**Perfect for**: Multi-team documentation, multi-repository projects, content aggregation from distributed sources.\n\n### Why Use Federation?\n\n**Multi-Team Collaboration**\n- Each team has their own repository and workflow\n- Independent development and testing\n- No merge conflicts between teams\n- Centralized deployment without centralized development\n\n**Distributed Content Management**\n- Main documentation in one repo\n- API reference in another\n- Blog posts, tutorials, FAQs each in separate repos\n- Merge all into single site for users\n\n**Flexible Source Options**\n- Build from Git repositories (clone and build)\n- Download pre-built sites from GitHub Releases (fastest)\n- Use local module paths for development\n- Mix and match strategies per module\n\n### Key Capabilities\n\n**Three Merge Strategies**:\n1. **download-merge-deploy** - Download pre-built modules from GitHub Releases (fastest, CI/CD-friendly)\n2. **merge-and-build** - Clone and build all modules from source (full control)\n3. **preserve-base-site** - Merge modules into existing base site (incremental enhancement)\n\n**Intelligent Merge System**:\n- Automatic CSS path detection and rewriting\n- Content deduplication\n- Conflict resolution with priority-based merging\n- YAML front matter preservation\n\n**Enterprise-Grade**:\n- JSON Schema validation for configurations\n- 140 comprehensive tests (100% passing)\n- Detailed error reporting\n- Dry-run mode for testing\n\n### Federation vs Single-Site\n\n| Feature | Single-Site (Layer 1) | Federation (Layer 2) |\n|---------|----------------------|----------------------|\n| **Repositories** | Single repository | Multiple repositories |\n| **Teams** | One team | Multiple independent teams |\n| **Build Command** | `build.sh` | `federated-build.sh` |\n| **Use Case** | Simple projects | Multi-team collaboration |\n| **Setup Complexity** | ⭐ Simple | ⭐⭐⭐ Moderate |\n| **Scalability** | Limited | ⭐⭐⭐⭐⭐ Excellent |\n| **Independence** | Tight coupling | ⭐⭐⭐⭐⭐ Full independence |\n\n### Real-World Use Cases\n\n**Use Case 1: InfoTech.io Multi-Team Documentation**\n```\nScenario: 5 teams, each with their own repository\n- Team 1: Main documentation (base site)\n- Team 2: API reference\n- Team 3: Tutorials\n- Team 4: Blog posts\n- Team 5: FAQ and troubleshooting\n\nSolution: Federated build merges all 5 modules into single site\nResult: Unified documentation portal with independent team workflows\n```\n\n**Use Case 2: Multi-Repository Product Documentation**\n```\nScenario: Product with multiple components\n- Core product docs in main repo\n- Plugin documentation in plugin repos\n- Community content in separate repo\n\nSolution: Federation pulls from all repos automatically\nResult: Complete documentation from distributed sources\n```\n\n**Use Case 3: Content from Multiple Sources**\n```\nScenario: Static site with diverse content origins\n- Editorial content from Git\n- Product data from external API (pre-processed to Hugo)\n- User-generated content from database (exported to Hugo)\n\nSolution: Pre-process each source to Hugo modules, then federate\nResult: Unified static site from multiple data sources\n```\n\n### Quick Start: Federation\n\n**Step 1**: Create federation configuration (`modules.json`):\n```json\n{\n  \"baseSite\": {\n    \"name\": \"main-docs\",\n    \"source\": { \"type\": \"local\", \"path\": \"./base-site\" }\n  },\n  \"modules\": [\n    {\n      \"name\": \"api-reference\",\n      \"source\": {\n        \"type\": \"github\",\n        \"repo\": \"your-org/api-docs\",\n        \"tag\": \"v1.0.0\"\n      },\n      \"priority\": 1\n    }\n  ],\n  \"strategy\": \"download-merge-deploy\"\n}\n```\n\n**Step 2**: Run federated build:\n```bash\n./scripts/federated-build.sh --config=modules.json --output=public\n```\n\n**Step 3**: Deploy to GitHub Pages (automated in CI/CD)\n\n### Federation Documentation\n\n**User Guides**:\n- [Federated Builds Guide](docs/content/user-guides/federated-builds.md) - Complete configuration reference\n- [Compatibility Guide](docs/content/user-guides/federation-compatibility.md) - When to use federation\n\n**Tutorials**:\n- [Simple 2-Module Tutorial](docs/content/tutorials/federation-simple-tutorial.md) - Get started in 15 minutes\n- [Advanced 5-Module Tutorial](docs/content/tutorials/federation-advanced-tutorial.md) - Production InfoTech.io scenario\n- [Migration Checklist](docs/content/tutorials/federation-migration-checklist.md) - Migrate from single-site\n\n**Developer Documentation**:\n- [Federation Architecture](docs/content/developer-docs/federation-architecture.md) - Technical design and Layer 1/2 separation\n- [API Reference](docs/content/developer-docs/federation-api-reference.md) - Complete function documentation\n- [Testing Guide](docs/content/developer-docs/testing/federation-testing.md) - 140 tests with 100% coverage\n\n**Examples**:\n- [Simple Example](docs/content/examples/modules-simple.json) - 2-module federation\n- [Advanced Example](docs/content/examples/modules-advanced.json) - Complex configuration\n- [InfoTech.io Example](docs/content/examples/modules-infotech.json) - Production 5-module setup\n\n## 🏗️ Architecture\n\n```\nhugo-templates/\n├── .github/\n│   ├── actions/           # Reusable GitHub Actions\n│   │   └── setup-build-env/   # Optimized build environment setup\n│   └── workflows/         # CI/CD pipelines with smart caching\n├── templates/             # Parametrized site templates\n│   ├── default/          # Full-featured template\n│   ├── minimal/          # Lightweight for fast builds\n│   ├── academic/         # Academic publications \u0026 research\n│   ├── enterprise/       # Corporate features \u0026 analytics\n│   └── educational/      # Learning-focused template\n├── themes/               # Hugo themes (git submodules)\n│   ├── compose/          # Feature-rich responsive theme\n│   └── minimal/          # Clean, fast-loading theme\n├── components/           # Modular, reusable components\n│   ├── quiz-engine/      # Interactive educational quizzes\n│   ├── analytics/        # Web analytics integration\n│   └── auth/             # Authentication \u0026 access control\n├── scripts/              # Build automation \u0026 tooling\n│   ├── build.sh          # Layer 1: Single-site builds\n│   ├── federated-build.sh    # Layer 2: Multi-module federation ⭐ NEW\n│   ├── validate.js       # Configuration validation\n│   └── diagnostic.js     # System diagnostics \u0026 troubleshooting\n├── schemas/              # Configuration schemas ⭐ NEW\n│   └── modules.schema.json   # Federation configuration schema\n└── docs/                 # Comprehensive documentation\n    ├── content/\n    │   ├── user-guides/\n    │   │   ├── federated-builds.md          # Federation guide ⭐\n    │   │   └── federation-compatibility.md  # Compatibility guide ⭐\n    │   ├── tutorials/\n    │   │   ├── federation-simple-tutorial.md      # 2-module tutorial ⭐\n    │   │   ├── federation-advanced-tutorial.md    # 5-module tutorial ⭐\n    │   │   └── federation-migration-checklist.md  # Migration guide ⭐\n    │   ├── developer-docs/\n    │   │   ├── federation-architecture.md   # Technical design ⭐\n    │   │   ├── federation-api-reference.md  # API documentation ⭐\n    │   │   └── testing/\n    │   │       └── federation-testing.md    # Testing guide (140 tests)\n    │   └── examples/\n    │       ├── modules-simple.json         # 2-module example\n    │       ├── modules-advanced.json       # Complex configuration\n    │       └── modules-infotech.json       # Production 5-module setup\n    ├── user-guides/      # User documentation\n    ├── developer-docs/   # Developer guides\n    ├── troubleshooting/  # Problem resolution guides\n    └── api-reference/    # API documentation\n\n⭐ = Federation-related (Layer 2)\n```\n\n## 📦 Templates\n\n| Template | Description | Use Case | Features |\n|----------|-------------|----------|----------|\n| **default** | Full-featured template | General-purpose sites | All components, flexible layout |\n| **minimal** | Lightweight template | Fast builds, simple sites | Essential features only |\n| **academic** | Academic template | Research, publications | Citations, references, papers |\n| **enterprise** | Corporate template | Business websites | Analytics, auth, professional layout |\n| **educational** | Learning-focused | Educational platforms | Quiz engine, progress tracking |\n\n## 🧩 Components\n\n| Component | Status | Description | Features |\n|-----------|---------|-------------|----------|\n| **quiz-engine** | ✅ **Ready** | Interactive quiz system | Progress tracking, multiple question types, analytics |\n| **analytics** | 🚧 **Beta** | Web analytics tracking | Google Analytics, privacy-compliant, event tracking |\n| **auth** | 🚧 **Beta** | Authentication system | User management, access control, SSO |\n| **citations** | 📋 **Planned** | Academic citations | BibTeX, CSL, automatic formatting |\n| **search** | 📋 **Planned** | Site search functionality | Full-text search, instant results |\n| **comments** | 📋 **Planned** | Comment system | Moderation, notifications, integrations |\n\n## 🔧 System Requirements\n\n- **Hugo Extended** ≥ 0.148.0\n- **Node.js** ≥ 18.0.0\n- **Git** for theme management\n- **Bash** shell (Linux/macOS) or **Git Bash** (Windows)\n\n## 📚 Documentation\n\n### 👥 User Guides\n- **[Build System Guide](docs/user-guides/build-system.md)** - Complete build system documentation\n- **[Federated Builds Guide](docs/content/user-guides/federated-builds.md)** ⭐ - Multi-module federation reference\n- **[Federation Compatibility](docs/content/user-guides/federation-compatibility.md)** ⭐ - When to use federation\n- **[Getting Started](docs/tutorials/getting-started.md)** - Step-by-step tutorial\n- **[Template Usage](docs/user-guides/templates.md)** - Working with templates\n- **[Deployment Guide](docs/user-guides/deployment.md)** - Production deployment\n\n### 🛠️ Developer Documentation\n- **[Testing Documentation](docs/content/developer-docs/testing/)** - Comprehensive testing guide with 140 tests\n  - [Test Inventory](docs/content/developer-docs/testing/test-inventory.md) - Complete test catalog (Layer 1 + Layer 2)\n  - [Testing Guidelines](docs/content/developer-docs/testing/guidelines.md) - Standards and best practices\n  - [Coverage Matrix](docs/content/developer-docs/testing/coverage-matrix.md) - Function coverage analysis\n  - [Federation Testing](docs/content/developer-docs/testing/federation-testing.md) ⭐ - Federation test suite (140 tests, 100%)\n- **[Federation Architecture](docs/content/developer-docs/federation-architecture.md)** ⭐ - Layer 1/2 design and technical details\n- **[Federation API Reference](docs/content/developer-docs/federation-api-reference.md)** ⭐ - Complete function documentation (28 functions)\n- **[Alternatives Analysis](docs/developer-docs/alternatives.md)** - How we compare to other Hugo tools\n- **[Component Development](docs/developer-docs/components.md)** - Creating custom components\n- **[GitHub Actions Guide](docs/developer-docs/github-actions.md)** - CI/CD workflows and optimization\n- **[API Reference](docs/api-reference/)** - Complete API documentation\n- **[Contributing Guide](docs/developer-docs/contributing.md)** - Contribution guidelines (includes federation workflow)\n\n### 🚨 Troubleshooting\n- **[Common Issues](docs/troubleshooting/common-issues.md)** - Problem resolution guide\n- **[Error Reference](docs/troubleshooting/error-reference.md)** - Error codes and solutions\n- **[Performance Guide](docs/troubleshooting/performance.md)** - Optimization techniques\n\n### 📖 Tutorials\n- **[Use Cases \u0026 User Stories](docs/tutorials/use-cases.md)** - Real-world usage scenarios and examples\n- **[Simple 2-Module Federation](docs/content/tutorials/federation-simple-tutorial.md)** ⭐ - Get started with federation (15 min)\n- **[Advanced 5-Module Federation](docs/content/tutorials/federation-advanced-tutorial.md)** ⭐ - Production InfoTech.io scenario (45 min)\n- **[Federation Migration Checklist](docs/content/tutorials/federation-migration-checklist.md)** ⭐ - Migrate from single-site\n- **[First Site Tutorial](docs/tutorials/first-site.md)** - Create your first site\n- **[Getting Started Guide](docs/tutorials/getting-started.md)** - Comprehensive getting started tutorial\n- **[Educational Platform](docs/tutorials/educational-platform.md)** - Build a learning platform\n- **[Corporate Website](docs/tutorials/corporate-website.md)** - Business website setup\n- **[Academic Site](docs/tutorials/academic-site.md)** - Research publication site\n\n## 🎯 Development Status\n\n**Current Version**: `0.2.0` - **Build System v2.0**\n\n### ✅ Completed Features (Epic Status: 100% - COMPLETE)\n- **✅ Error Handling System** - Comprehensive error handling and diagnostics\n- **✅ Test Coverage Framework** - BATS testing with 95%+ coverage\n- **✅ GitHub Actions Optimization** - 50%+ performance improvement in CI/CD\n- **✅ Documentation Updates** - Comprehensive guides and troubleshooting\n- **✅ Performance Optimization** - 4-phase performance framework with intelligent caching, parallel processing, monitoring, and analytics\n\n### 🚀 New Performance Features\n- **Multi-Level Caching (L1/L2/L3)** - Intelligent caching for maximum build speed\n- **Parallel Processing** - Optimized parallel operations with job throttling\n- **Performance Monitoring** - Real-time tracking, historical analysis, and optimization recommendations\n- **Advanced CLI Options** - `--performance-track`, `--performance-report`, `--performance-history`, `--cache-stats`\n\nThis framework is under active development as part of the **info-tech-io** educational platform ecosystem.\n\n## 🤝 Contributing\n\nWe welcome contributions! This project aims to become the definitive scaffolding framework for the Hugo ecosystem.\n\n### Quick Contribution Guide\n1. **Fork** the repository\n2. **Create** a feature branch from `epic/build-system-v2.0`\n3. **Follow** our [Contributing Guidelines](docs/developer-docs/contributing.md)\n4. **Submit** a Pull Request\n\n### Development Workflow\n- **Epic Issues**: Large features tracked as Epics\n- **Child Issues**: Individual features within Epics\n- **Feature Branches**: Development branches for each Child Issue\n- **Epic Integration**: All features merge to Epic branch before main\n\n## 🎉 Success Stories\n\n\u003e *\"Hugo Template Factory reduced our site setup time from hours to minutes while maintaining full customization capabilities.\"* - Educational Platform Team\n\n\u003e *\"The component system allowed us to create standardized, reusable building blocks across multiple projects.\"* - Enterprise Development Team\n\n## 📄 License\n\n**Apache License 2.0** - see [LICENSE](LICENSE) file for details.\n\nThis project is licensed under Apache 2.0 in accordance with info-tech-io organization licensing policy.\n\n## 🔗 Links\n\n- **[Hugo Framework](https://gohugo.io/)** - Static site generator\n- **[info-tech-io Organization](https://github.com/info-tech-io)** - Open source projects\n- **[INFOTEKA Platform](https://infotecha.ru)** - Educational platform\n- **[Project Issues](https://github.com/info-tech-io/hugo-templates/issues)** - Bug reports and feature requests\n- **[Discussions](https://github.com/info-tech-io/hugo-templates/discussions)** - Community discussions\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ by the info-tech-io team**\n\n[⭐ Star this project](https://github.com/info-tech-io/hugo-templates) • [🐛 Report Bug](https://github.com/info-tech-io/hugo-templates/issues) • [💡 Request Feature](https://github.com/info-tech-io/hugo-templates/issues/new?template=feature_request.md)\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfo-tech-io%2Fhugo-templates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finfo-tech-io%2Fhugo-templates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfo-tech-io%2Fhugo-templates/lists"}