SEO Guide

Optimize your ABC showcase for better search rankings and social media sharing.

Meta Tags

Basic SEO Meta Tags

<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>SEO Guide | Minecraft Mods & Packs Showcase</title>
  <meta
    name="description"
    content="Optimize your ABC showcase for search engines and social sharing."
  />
  <meta name="keywords" content="seo, meta-tags, open-graph, search, optimization" />
  <meta name="author" content="" />
  <link rel="canonical" href="https://abc-site.devvyy.xyz/docs/seo-guide/" />
</head>

Jekyll SEO Tag Plugin

Install and configure:

# Gemfile
gem 'jekyll-seo-tag'
# _config.yml
plugins:
  - jekyll-seo-tag

title: ABC Showcase
description: Showcase your Minecraft modpacks beautifully
url: https://yoursite.com
author:
  name: Your Name
  twitter: yourusername

social:
  name: ABC Showcase
  links:
    - https://twitter.com/yourusername
    - https://github.com/yourusername

Include in layout:

<head>
  {% seo %}
</head>

Open Graph Tags

For Social Media Sharing

<meta property="og:title" content="SEO Guide" />
<meta property="og:description" content="Optimize your ABC showcase for search engines and social sharing." />
<meta
  property="og:image"
  content=""
/>
<meta property="og:url" content="https://abc-site.devvyy.xyz/docs/seo-guide/" />
<meta property="og:type" content="website" />
<meta property="og:site_name" content="Minecraft Mods & Packs Showcase" />

Twitter Cards

<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@yourusername" />
<meta name="twitter:creator" content="@yourusername" />
<meta name="twitter:title" content="SEO Guide" />
<meta name="twitter:description" content="Optimize your ABC showcase for search engines and social sharing." />
<meta name="twitter:image" content="" />

Page-Specific OG Images

# In page frontmatter
---
title: My Modpack
description: An amazing tech-focused modpack
image: /assets/images/modpack-preview.png
---

Structured Data

JSON-LD for Projects

<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "SoftwareApplication",
    "name": "",
    "description": "",
    "url": "",
    "downloadUrl": "",
    "image": "",
    "applicationCategory": "Game",
    "operatingSystem": "Windows, macOS, Linux",
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "4.5",
      "ratingCount": ""
    },
    "offers": {
      "@type": "Offer",
      "price": "0",
      "priceCurrency": "USD"
    }
  }
</script>

Organization Schema

<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "Minecraft Mods & Packs Showcase",
    "url": "https://abc-site.devvyy.xyz",
    "logo": "https://abc-site.devvyy.xyz/assets/images/logo.png",
    "sameAs": [
      "https://twitter.com/yourusername",
      "https://github.com/yourusername"
    ]
  }
</script>
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://abc-site.devvyy.xyz/"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Developer",
        "item": "https://abc-site.devvyy.xyz/docs-category-developer/"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "SEO Guide"
      }
    ]
  }
</script>

Sitemap

Generate with Jekyll

# Gemfile
gem 'jekyll-sitemap'
# _config.yml
plugins:
  - jekyll-sitemap

url: https://yoursite.com

Custom Sitemap

Create sitemap.xml:

---
layout: null
---
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://abc-site.devvyy.xyz/</loc>
    <lastmod>2025-12-17T01:31:20+00:00</lastmod>
    <changefreq>daily</changefreq>
    <priority>1.0</priority>
  </url>
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/404.html</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/about/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/blog/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/category/community/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/category/developer/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/category/help/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/category/setup/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/category/styling/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/category/user-guide/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/changelog/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/compare/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/contact/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/cookie-policy/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/disclaimer/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/discord/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/eula/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/fr/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/licensing/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/privacy/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/projects/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/summary/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/terms/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
    <url>
      <loc>https://abc-site.devvyy.xyz/testing/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>weekly</changefreq>
      <priority>0.8</priority>
    </url>
    
  
    
  
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/accessibility/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/add-modpack/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/api-reference/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/browser-support/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/common-errors/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/content-guidelines/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/contributing/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/css-variables/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/customization/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/deployment/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/faq/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/getting-started/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/github-actions/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/how-to-install/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/liquid-templates/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/performance/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/project-structure/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/seo-guide/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/setup/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
    <url>
      <loc>https://abc-site.devvyy.xyz/docs/troubleshooting/</loc>
      <lastmod>2025-12-17T01:31:20+00:00</lastmod>
      <changefreq>monthly</changefreq>
      <priority>0.6</priority>
    </url>
  
</urlset>

Robots.txt

# /robots.txt
User-agent: *
Allow: /
Disallow: /admin/
Disallow: /_site/
Sitemap: https://yoursite.com/sitemap.xml

URL Structure

SEO-Friendly URLs

# _config.yml
permalink: /:categories/:title/

collections:
  docs:
    output: true
    permalink: /docs/:name/

Good URLs:

  • /docs/getting-started/
  • /projects/
  • /docs/category/setup/

Bad URLs:

  • /page.html?id=123
  • /p/456
  • /docs/doc1/

Content Optimization

Title Tags

<!-- Page titles -->
<title>SEO Guide | Minecraft Mods & Packs Showcase</title>

<!-- Keep under 60 characters -->
<!-- Include primary keyword -->
<!-- Make descriptive and unique -->

Meta Descriptions

---
description: Learn how to set up your ABC showcase in under 5 minutes with this comprehensive guide.
---

Best practices:

  • 150-160 characters
  • Include target keyword
  • Make compelling and actionable
  • Unique for each page

Heading Structure

<h1>Main Page Title</h1>
<!-- Only one per page -->
<h2>Major Section</h2>
<h3>Subsection</h3>
<h2>Another Section</h2>

Internal Linking

<!-- Link to related content -->
<p>See our <a href="/docs/setup/">setup guide</a> for more details.</p>

<!-- Use descriptive anchor text -->
<!-- Avoid "click here" -->

Performance for SEO

Page Speed

# Fast loading = better SEO
# Target metrics:
# - First Contentful Paint: < 1.8s
# - Largest Contentful Paint: < 2.5s
# - Time to Interactive: < 3.8s

See Performance Guide for optimization.

Mobile-Friendly

<!-- Responsive viewport -->
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
/* Mobile-first design */
.container {
  padding: 20px;
}

@media (min-width: 768px) {
  .container {
    padding: 40px;
  }
}

Analytics

Google Analytics 4

<!-- Global site tag (gtag.js) -->
<script
  async
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"
></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag() {
    dataLayer.push(arguments);
  }
  gtag("js", new Date());
  gtag("config", "G-XXXXXXXXXX");
</script>

Google Search Console

  1. Add property at search.google.com/search-console
  2. Verify ownership via HTML tag or DNS
  3. Submit sitemap
  4. Monitor performance and issues

Track Important Metrics

  • Organic search traffic
  • Click-through rates
  • Average position
  • Core Web Vitals
  • Mobile usability
  • Index coverage

Social Sharing Optimization

Social Share Buttons

<div class="share-buttons">
  <a
    href="https://twitter.com/intent/tweet?url=https://abc-site.devvyy.xyz/docs/seo-guide/&text=SEO Guide"
    target="_blank"
    rel="noopener"
    aria-label="Share on Twitter"
  >
    <i class="fab fa-twitter"></i>
  </a>

  <a
    href="https://www.facebook.com/sharer/sharer.php?u=https://abc-site.devvyy.xyz/docs/seo-guide/"
    target="_blank"
    rel="noopener"
    aria-label="Share on Facebook"
  >
    <i class="fab fa-facebook"></i>
  </a>

  <a
    href="https://reddit.com/submit?url=https://abc-site.devvyy.xyz/docs/seo-guide/&title=SEO Guide"
    target="_blank"
    rel="noopener"
    aria-label="Share on Reddit"
  >
    <i class="fab fa-reddit"></i>
  </a>
</div>

Test Social Cards

Best Practices Checklist

  • Unique title and description for each page
  • Proper heading hierarchy (h1 → h2 → h3)
  • SEO-friendly URLs (descriptive, lowercase, hyphens)
  • Alt text for all images
  • Internal linking between related pages
  • Mobile-responsive design
  • Fast page load times (< 3s)
  • HTTPS enabled
  • Sitemap.xml submitted to search engines
  • Robots.txt configured
  • Structured data (JSON-LD) implemented
  • Open Graph tags for social sharing
  • Canonical URLs set
  • No broken links
  • Google Analytics installed
  • Google Search Console configured

Common Issues

Duplicate Content

<!-- Use canonical tags -->
<link rel="canonical" href="https://abc-site.devvyy.xyz/docs/seo-guide/" />
# Check with htmlproofer
gem install html-proofer
bundle exec htmlproofer ./_site --assume-extension

Missing Alt Text


Tools

  • Google Search Console: Monitor search performance
  • Google PageSpeed Insights: Test page speed
  • Screaming Frog: Crawl and audit your site
  • Ahrefs/SEMrush: Keyword research and tracking
  • Lighthouse: Automated SEO auditing

Next Steps