Skip to content

h-ravi/pyblog

Repository files navigation

PyBlog - Python & Data Science Resource Hub

A modern, responsive educational website for Python, Data Science, AI/ML, and Data Analytics enthusiasts. Built with HTML, CSS, and JavaScript.

🌟 Features

Pages

  • Home: Landing page with hero section, featured articles, and topic overview
  • Blog: Article listing with categories, search, and pagination
  • Tutorials: Step-by-step learning paths with progress tracking
  • E-Notes: Downloadable resources, cheat sheets, and PDFs
  • Source Code: Code snippets with syntax highlighting and copy functionality
  • About: Team information, mission, and values

Design Features

  • ✨ Modern dark theme with accent colors
  • 📱 Fully responsive (mobile, tablet, desktop)
  • 🎨 Clean and professional UI/UX
  • 🔍 Search functionality
  • 📊 Interactive elements and animations
  • ♿ Accessible with semantic HTML and ARIA labels
  • 🚀 Optimized performance

Interactive Elements

  • Mobile-friendly hamburger menu
  • Scroll-to-top button
  • Search and filter functionality
  • Copy-to-clipboard for code snippets
  • Collapsible tutorial sections
  • Animated cards and transitions
  • Newsletter subscription forms

🗂️ Project Structure

pyblog/
├── index.html          # Home page
├── blog.html           # Blog listing
├── tutorials.html      # Tutorials page
├── e-notes.html        # E-Notes/Resources
├── source-code.html    # Code snippets
├── about.html          # About page
├── styles.css          # Main stylesheet
├── script.js           # JavaScript functionality
├── prompt.txt          # Original requirements
└── README.md           # This file

🎨 Color Scheme

  • Primary: #16a085 (Teal green)
  • Secondary: #3498db (Blue)
  • Accent: #9b59b6 (Purple)
  • Background: #0f0f0f (Dark)
  • Cards: #16213e (Dark blue)
  • Text: #e4e4e4 (Light gray)

🚀 Getting Started

Prerequisites

  • A modern web browser (Chrome, Firefox, Safari, Edge)
  • A local web server (optional, but recommended)

Installation

  1. Clone or Download the project files to your local machine

  2. Open in Browser:

    • Simply open index.html in your web browser
    • Or use a local server (recommended):

    Using Python:

    # Python 3
    python -m http.server 8000
    
    # Python 2
    python -m SimpleHTTPServer 8000

    Using Node.js (http-server):

    npx http-server -p 8000

    Using VS Code:

    • Install "Live Server" extension
    • Right-click on index.html and select "Open with Live Server"
  3. Navigate to http://localhost:8000 in your browser

📝 Customization

Changing Colors

Edit the CSS variables in styles.css:

:root {
    --primary-color: #16a085;
    --secondary-color: #3498db;
    --accent-color: #9b59b6;
    /* ... more colors */
}

Adding Content

  • Blog Posts: Edit blog.html and add new .blog-post-card elements
  • Tutorials: Add new .tutorial-item in tutorials.html
  • Resources: Add .resource-card in e-notes.html
  • Code Snippets: Add .code-card in source-code.html

Modifying Navigation

Edit the navigation menu in each HTML file:

<ul class="nav-menu" id="navMenu">
    <li><a href="your-page.html">Your Page</a></li>
</ul>

🛠️ Technologies Used

  • HTML5: Semantic markup
  • CSS3: Flexbox, Grid, Animations, Custom Properties
  • JavaScript: Vanilla JS (no frameworks)
  • Font Awesome: Icons (CDN)
  • Prism.js: Code syntax highlighting (CDN)
  • Google Fonts: Roboto, Montserrat (optional)

📱 Browser Support

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)
  • Mobile browsers (iOS Safari, Chrome Mobile)

🔧 Features to Add (Optional Enhancements)

  • Backend integration for dynamic content
  • Real newsletter subscription
  • User authentication
  • Comment system
  • Code playground/editor
  • Dark/Light mode toggle
  • Multi-language support
  • Search with autocomplete
  • Blog post tags and advanced filtering
  • Analytics integration

📄 License

This project is open source and available for educational purposes.

🤝 Contributing

Feel free to fork this project and customize it for your needs!

Suggestions for Improvement:

  1. Add real blog content
  2. Implement a backend (Node.js, Python Flask/Django)
  3. Add a CMS for easy content management
  4. Implement user accounts and profiles
  5. Add social sharing buttons
  6. Create an RSS feed
  7. Add commenting functionality
  8. Implement site-wide search

📞 Support

For questions or issues, please refer to the documentation or create an issue in the project repository.

🎉 Acknowledgments

  • Font Awesome for icons
  • Prism.js for syntax highlighting
  • All Python and Data Science educators who inspire learning

Built with ❤️ for Python & Data Science learners

Happy Learning! 🚀

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published