/*
Theme Name: My Minimal Theme
Theme URI: https://yourwebsite.com/themes/my-minimal-theme
Author: Your Name
Author URI: https://yourwebsite.com
Description: A clean and minimal WordPress theme created as a learning project. Features responsive design, semantic HTML5 markup, and modern CSS styling. Perfect for blogs and simple websites.
Version: 1.0.0
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: my-minimal-theme
Tags: blog, one-column, custom-colors, custom-menu, featured-images, threaded-comments, translation-ready

This theme, like WordPress, is licensed under the GPL.
Use it to make something cool, have fun, and share what you've learned.
*/

/* =Reset & Base Styles
-------------------------------------------------------------- */
* {
    margin: 0;
    padding: 0;
    box-sizing: border-box;
}

body {
    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
    font-size: 16px;
    line-height: 1.6;
    color: #333;
    background: #fff;
}

/* =Layout
-------------------------------------------------------------- */
.site-container {
    max-width: 1200px;
    margin: 0 auto;
    padding: 0 20px;
}

/* =Header
-------------------------------------------------------------- */
.site-header {
    background: #2c3e50;
    color: #fff;
    padding: 2rem 0;
    margin-bottom: 2rem;
}

.site-title {
    font-size: 2.5rem;
    margin: 0;
    font-weight: bold;
}

.site-title a {
    color: #fff;
    text-decoration: none;
}

.site-description {
    font-size: 1.1rem;
    opacity: 0.9;
    margin-top: 0.5rem;
}

/* =Navigation
-------------------------------------------------------------- */
.main-navigation {
    background: #34495e;
    margin-bottom: 2rem;
}

.main-navigation ul {
    list-style: none;
    display: flex;
    flex-wrap: wrap;
}

.main-navigation li {
    margin-right: 2rem;
}

.main-navigation a {
    color: #ecf0f1;
    text-decoration: none;
    padding: 1rem 0;
    display: block;
    transition: color 0.3s ease;
}

.main-navigation a:hover {
    color: #3498db;
}

/* =Content
-------------------------------------------------------------- */
.site-main {
    margin-bottom: 3rem;
}

article {
    margin-bottom: 3rem;
    padding-bottom: 2rem;
    border-bottom: 1px solid #ecf0f1;
}

.entry-header {
    margin-bottom: 1.5rem;
}

.entry-title {
    font-size: 2rem;
    margin-bottom: 0.5rem;
    color: #2c3e50;
}

.entry-title a {
    color: inherit;
    text-decoration: none;
    transition: color 0.3s ease;
}

.entry-title a:hover {
    color: #3498db;
}

.entry-meta {
    color: #7f8c8d;
    font-size: 0.9rem;
}

.entry-content {
    margin-bottom: 1.5rem;
}

.entry-content p {
    margin-bottom: 1.25rem;
}

.entry-content h2 {
    margin: 2rem 0 1rem;
    color: #2c3e50;
}

.entry-content img {
    max-width: 100%;
    height: auto;
}

/* =Footer
-------------------------------------------------------------- */
.site-footer {
    background: #2c3e50;
    color: #ecf0f1;
    padding: 2rem 0;
    text-align: center;
}

/* =Responsive Design
-------------------------------------------------------------- */
@media (max-width: 768px) {
    .site-title {
        font-size: 2rem;
    }
    
    .main-navigation ul {
        flex-direction: column;
    }
    
    .main-navigation li {
        margin-right: 0;
    }
}

<?php
/**
 * The main template file
 *
 * This is the most generic template file in a WordPress theme
 * and one of the two required files for a theme (the other being style.css).
 * It is used to display a page when nothing more specific matches a query.
 *
 * @package My_Minimal_Theme
 */

get_header(); ?>

<div class="site-container">
    <main id="primary" class="site-main">
        
        <?php
        if ( have_posts() ) :
            
            // Display page title if on blog page
            if ( is_home() && ! is_front_page() ) :
                ?>
                <header class="page-header">
                    <h1 class="page-title"><?php single_post_title(); ?></h1>
                </header>
                <?php
            endif;
            
            // Start the Loop
            while ( have_posts() ) :
                the_post();
                ?>
                
                <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
                    <header class="entry-header">
                        <?php
                        if ( is_singular() ) :
                            the_title( '<h1 class="entry-title">', '</h1>' );
                        else :
                            the_title( '<h2 class="entry-title"><a href="' . esc_url( get_permalink() ) . '" rel="bookmark">', '</a></h2>' );
                        endif;
                        ?>
                        
                        <div class="entry-meta">
                            <span class="posted-on">
                                Posted on <time datetime="<?php echo esc_attr( get_the_date( 'c' ) ); ?>">
                                    <?php echo esc_html( get_the_date() ); ?>
                                </time>
                            </span>
                            <span class="posted-by">
                                by <a href="<?php echo esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) ); ?>">
                                    <?php echo esc_html( get_the_author() ); ?>
                                </a>
                            </span>
                            <?php
                            // Display categories
                            $categories_list = get_the_category_list( ', ' );
                            if ( $categories_list ) :
                                ?>
                                <span class="cat-links">
                                    in <?php echo $categories_list; ?>
                                </span>
                                <?php
                            endif;
                            ?>
                        </div>
                    </header>
                    
                    <div class="entry-content">
                        <?php
                        if ( is_singular() ) :
                            the_content();
                            
                            // Display pagination for multi-page posts
                            wp_link_pages( array(
                                'before' => '<div class="page-links">Pages: ',
                                'after'  => '</div>',
                            ) );
                        else :
                            // Display excerpt for archives
                            the_excerpt();
                            ?>
                            <a href="<?php echo esc_url( get_permalink() ); ?>" class="read-more">
                                Continue reading →
                            </a>
                            <?php
                        endif;
                        ?>
                    </div>
                    
                    <footer class="entry-footer">
                        <?php
                        // Display tags
                        $tags_list = get_the_tag_list( '', ', ' );
                        if ( $tags_list ) :
                            ?>
                            <span class="tags-links">
                                Tagged: <?php echo $tags_list; ?>
                            </span>
                            <?php
                        endif;
                        
                        // Display comments link
                        if ( ! is_singular() && comments_open() ) :
                            ?>
                            <span class="comments-link">
                                <?php comments_popup_link( 'Leave a comment', '1 Comment', '% Comments' ); ?>
                            </span>
                            <?php
                        endif;
                        ?>
                    </footer>
                </article>
                
                <?php
            endwhile;
            
            // Display pagination
            the_posts_pagination( array(
                'mid_size'  => 2,
                'prev_text' => '← Previous',
                'next_text' => 'Next →',
            ) );
            
        else :
            // No posts found
            ?>
            
            <article class="no-results not-found">
                <header class="page-header">
                    <h1 class="page-title">Nothing Found</h1>
                </header>
                
                <div class="page-content">
                    <?php
                    if ( is_home() && current_user_can( 'publish_posts' ) ) :
                        ?>
                        <p>Ready to publish your first post? 
                        <a href="<?php echo esc_url( admin_url( 'post-new.php' ) ); ?>">
                            Get started here
                        </a>.</p>
                        <?php
                    elseif ( is_search() ) :
                        ?>
                        <p>Sorry, but nothing matched your search terms. 
                        Please try again with different keywords.</p>
                        <?php
                        get_search_form();
                    else :
                        ?>
                        <p>It seems we can't find what you're looking for. 
                        Perhaps searching can help.</p>
                        <?php
                        get_search_form();
                    endif;
                    ?>
                </div>
            </article>
            
        <?php
        endif;
        ?>
        
    </main>
</div>

<?php
get_sidebar();
get_footer();

<?php
/**
 * Theme functions and definitions
 *
 * @package My_Minimal_Theme
 */

// Set content width
if ( ! isset( $content_width ) ) {
    $content_width = 800;
}

/**
 * Theme setup
 */
function my_minimal_theme_setup() {
    // Add default posts and comments RSS feed links
    add_theme_support( 'automatic-feed-links' );
    
    // Let WordPress manage the document title
    add_theme_support( 'title-tag' );
    
    // Enable support for Post Thumbnails
    add_theme_support( 'post-thumbnails' );
    
    // Register navigation menu
    register_nav_menus( array(
        'primary' => __( 'Primary Menu', 'my-minimal-theme' ),
    ) );
    
    // Switch default core markup to output valid HTML5
    add_theme_support( 'html5', array(
        'search-form',
        'comment-form',
        'comment-list',
        'gallery',
        'caption',
        'style',
        'script',
    ) );
    
    // Add theme support for selective refresh for widgets
    add_theme_support( 'customize-selective-refresh-widgets' );
    
    // Add support for core custom logo
    add_theme_support( 'custom-logo', array(
        'height'      => 250,
        'width'       => 250,
        'flex-width'  => true,
        'flex-height' => true,
    ) );
}
add_action( 'after_setup_theme', 'my_minimal_theme_setup' );

/**
 * Enqueue scripts and styles
 */
function my_minimal_theme_scripts() {
    // Enqueue main stylesheet
    wp_enqueue_style( 
        'my-minimal-theme-style', 
        get_stylesheet_uri(), 
        array(), 
        wp_get_theme()->get( 'Version' ) 
    );
    
    // Enqueue comment reply script on singular pages
    if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
        wp_enqueue_script( 'comment-reply' );
    }
}
add_action( 'wp_enqueue_scripts', 'my_minimal_theme_scripts' );

/**
 * Register widget area
 */
function my_minimal_theme_widgets_init() {
    register_sidebar( array(
        'name'          => __( 'Sidebar', 'my-minimal-theme' ),
        'id'            => 'sidebar-1',
        'description'   => __( 'Add widgets here.', 'my-minimal-theme' ),
        'before_widget' => '<section id="%1$s" class="widget %2$s">',
        'after_widget'  => '</section>',
        'before_title'  => '<h2 class="widget-title">',
        'after_title'   => '</h2>',
    ) );
}
add_action( 'widgets_init', 'my_minimal_theme_widgets_init' );