Skip to content

Docs-To-Wiki is not workign for the homepage #282

@MrHinsh

Description

@MrHinsh

Although the sub pages are pwkring greate for the docs to wiki workflow the homepage is not converting properly and links to sub docs do not work. Here is the current output:


# Scrum Guide Expansion Pack Documentation

Welcome to the documentation for the **Scrum Guide Expansion Pack** project. This documentation provides comprehensive information about the project structure, -Development-Guide workflow, and contribution guidelines.

## 🌐 Live Sites

- **Production**: [scrumexpansion.org](https://scrumexpansion.org) - **Live production site**
- **Preview**: [agreeable-island-0c966e810-preview.centralus.6.azurestaticapps.net](https://agreeable-island-0c966e810-preview.centralus.6.azurestaticapps.net/) - **Test your contributions here before they go live**

## Quick Navigation

- [Getting Started](Getting-Started)
- [-Contributing-to-the-Scrum-Guide-Expansion-Pack Guidelines](Contributing-to-the-Scrum-Guide-Expansion-Pack)
- [Content Management](Content-Management-Guide)

### Technical Documentation

- [-Architecture-Overview Overview](.__-Architecture-Overview)
- [-Development-Guide Guide](.__-Development-Guide)
- [-Deployment-Guide Guide](.__-Deployment-Guide)
- [-Configuration-Reference Reference](.__-Configuration-Reference)
- [Maintainer Guide](.__-Maintainer-Guide)
- [Translation Guide](.__Translation-Guide)
- [-Troubleshooting-Guide](.__-Troubleshooting-Guide)

> **🚨 Important**: This project uses Hugo's new template system (v0.146.0+). See the [-Development-Guide Guide](.__-Development-Guide) for details about template structure and migration.

## Project Overview

The Scrum Guide Expansion Pack is a multilingual static website built with Hugo that provides an expanded interpretation of the official 2020 Scrum Guide. The project includes:

- **Multi-language support** (English, German, Spanish, French)
- **Modern responsive design** with Bootstrap 5
- **Static site generation** with Hugo
- **Automated -Deployment-Guide** via Azure Static Web Apps
- **PDF generation** capabilities
- **Community contribution features**

## Key Features

### 📚 Content Features

- Comprehensive expansion of the Scrum Guide
- Multi-language Translation-Guide
- Downloadable PDF versions
- Creator profiles and attribution
- Structured navigation and table of contents

### 🔧 Technical Features

- Hugo static site generator
- Bootstrap 5 responsive design
- Font Awesome icons
- Google Analytics integration
- Azure Static Web Apps hosting
- GitHub Actions for CI/CD
- Environment-specific -Configuration-References

### 🌍 Internationalization

- English (default)
- German (Deutsch)
- Spanish (Español)
- French (Français)

## Project Structure

```text
ScrumGuide-ExpansionPack/
├── docs/                           # 📚 Documentation
├── site/                           # 🏗️ Hugo site source
│   ├── content/                    # 📝 Content files
│   ├── layouts/                    # 🎨 HTML templates
│   ├── static/                     # 📁 Static assets
│   ├── data/                       # 🗃️ Data files
│   ├── i18n/                       # 🌐 Translation-Guide
│   └── hugo.yaml                   # ⚙️ Hugo -Configuration-Reference
├── public/                         # 🚀 Generated site output
├── .github/                        # 🔄 GitHub Actions workflows
├── staticwebapp.config.*.json      # ⚙️ Azure SWA configs
└── readme.md                       # 📖 Project README
```

## Quick Start

1. **Clone the repository**

   ```bash
   git clone https://github.com/ScrumGuides/ScrumGuide-ExpansionPack.git
   cd ScrumGuide-ExpansionPack
   ```

2. **Install Hugo**

   ```bash
   # Using package managers
   choco install hugo-extended  # Windows (Chocolatey)
   brew install hugo            # macOS (Homebrew)
   snap install hugo           # Linux (Snap)
   ```

3. **Run the -Development-Guide server**

   ```bash
   cd site
   hugo server -D --bind 0.0.0.0
   ```

4. **Open your browser**
   Navigate to `http://localhost:1313`

## -Contributing-to-the-Scrum-Guide-Expansion-Pack

We welcome contributions from the community! Please see our [-Contributing-to-the-Scrum-Guide-Expansion-Pack Guidelines](.__-Contributing-to-the-Scrum-Guide-Expansion-Pack) for detailed information on:

- Setting up your -Development-Guide environment
- Content contribution process
- Translation guidelines
- Code contribution standards
- Pull request process

## Support and Community

- **GitHub Discussions**: Join conversations about the project
- **Issues**: Report bugs or suggest features
- **Pull Requests**: Contribute improvements

## License

This project is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. See the [LICENSE](https://github.com/ScrumGuides/ScrumGuide-ExpansionPack/blob/main/LICENSE) file for details.

## Authors and Attribution

The Scrum Guide Expansion Pack is created by:

- **Ralph Jocham**
- **John Coleman**
- **Jeff Sutherland**

Based on the original [2020 Scrum Guide](https://scrumguides.org/) by Ken Schwaber and Jeff Sutherland.

---

📚 **Next Steps**: Start with the [Getting Started Guide](.__-Getting-Started) to set up your -Development-Guide environment.

We need this to be resolved so that the links are clickable as each of the pages do actually exist.

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions