DevRhylme - Open Source Blog

A modern, feature-rich blog site for the DevRhylme open source community. Built with Hugo for blazing-fast performance and easy content management.

🚀 Features

• 📝 Blog System - Categorized posts with tags, authors, and reading time
• 🎨 Modern Design - Responsive, clean interface with dark/light mode
• 💻 Syntax Highlighting - Beautiful code blocks for technical content
• 🔍 Search Functionality - Fast client-side search
• 📱 Mobile Responsive - Works seamlessly on all devices
• 🌐 Multilingual Ready - Support for multiple languages
• 📊 GitHub Integration - Display repository stats and contributors
• 💬 Comments System - Community engagement via Giscus/Utterances
• 📖 Documentation - Comprehensive docs section
• 👥 Team Pages - Showcase your contributors
• 🎯 Project Showcase - Highlight your open source projects
• 🎉 Events Calendar - Community meetups and events
• ⚡ Performance - Lightning-fast static site generation
• 🔒 Privacy-Focused - Respects user privacy

📋 Prerequisites

Before you begin, ensure you have the following installed:

• Hugo Extended (v0.120.0 or higher)
• Git
• Node.js (optional, for asset processing)

🛠️ Installation

1. Clone the repository

   git clone https://github.com/yourusername/devrhylme.blog.git
   cd devrhylme.blog

2. Install dependencies (if using npm for assets)

   npm install

3. Run the development server

   hugo server -D

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

📁 Project Structure

devrhylme.blog/
├── archetypes/          # Content templates
├── content/             # All site content (markdown)
│   ├── blog/           # Blog posts
│   ├── projects/       # Project pages
│   ├── docs/           # Documentation
│   ├── team/           # Team member profiles
│   ├── community/      # Community guidelines
│   └── events/         # Events and meetups
├── data/               # Data files (JSON/YAML)
├── static/             # Static assets
├── themes/             # Custom theme
│   └── opensourceorg/
│       ├── layouts/    # HTML templates
│       ├── static/     # Theme assets
│       └── assets/     # Processed assets
└── hugo.toml           # Site configuration

✍️ Creating Content

Create a new blog post

hugo new blog/my-first-post.md

Create a new project

hugo new projects/awesome-project.md

Create a team member profile

hugo new team/john-doe.md

⚙️ Configuration

Edit hugo.toml to customize:

• Site title and description
• Social media links
• GitHub organization/repository
• Enable/disable features
• Menu items
• Theme colors

🎨 Customization

Modify theme colors

Edit themes/opensourceorg/assets/scss/_variables.scss

Add custom CSS

Place files in themes/opensourceorg/static/css/

Add custom JavaScript

Place files in themes/opensourceorg/static/js/

🚀 Deployment

Build for production

hugo --minify

The site will be generated in the public/ directory.

Deploy to GitHub Pages

hugo --minify
# Push the public/ directory to gh-pages branch

Deploy to Netlify

1. Connect your repository to Netlify
2. Build command: hugo --minify
3. Publish directory: public

Deploy to Vercel

1. Import your repository
2. Framework: Hugo
3. Build command: hugo --minify
4. Output directory: public

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

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

📝 Content Guidelines

• Write in Markdown format
• Use proper frontmatter metadata
• Include relevant tags and categories
• Add featured images when possible
• Follow the style guide

🐛 Bug Reports

Found a bug? Please open an issue with:

• Clear description of the problem
• Steps to reproduce
• Expected vs actual behavior
• Screenshots if applicable

📄 License

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

👥 Community

• Website: https://devrhylme.blog
• GitHub: github.com/yourusername/devrhylme.blog
• Twitter: @devrhylme
• Discord: Join our community

🙏 Acknowledgments

• Hugo community for the amazing static site generator
• All our contributors and supporters
• Open source projects that inspired this design

📞 Support

Need help?

• Check the Documentation
• Join our Discord community
• Open an issue

---

Made with ❤️ by the DevRhylme community