#!/usr/bin/env node

const fs = require('fs');
const path = require('path');
const matter = require('gray-matter');

// Configuration
const BLOG_DIR = path.join(__dirname, '../blog');
const OUTPUT_FILE = path.join(BLOG_DIR, 'auto-index.mdx');

// Ensure blog directory exists
if (!fs.existsSync(BLOG_DIR)) {
  fs.mkdirSync(BLOG_DIR, { recursive: true });
}

// Get all MDX files from blog directory
function getBlogPosts() {
  const files = fs.readdirSync(BLOG_DIR)
    .filter(file => file.endsWith('.mdx') && file !== 'index.mdx');
  
  const posts = files.map(file => {
    const filePath = path.join(BLOG_DIR, file);
    const content = fs.readFileSync(filePath, 'utf8');
    const { data } = matter(content);
    
    return {
      slug: file.replace('.mdx', ''),
      title: data.title || 'Untitled',
      description: data.description || '',
      date: data.date || new Date().toISOString().split('T')[0],
      author: data.author || 'LaTeX Cloud Studio Team',
      tags: data.tags || [],
      category: data.category || 'General',
      image: data.image || null,
      readTime: data.readTime || '5 min read'
    };
  });
  
  // Sort by date (newest first)
  return posts.sort((a, b) => new Date(b.date) - new Date(a.date));
}

// Get icon for category
function getCategoryIcon(category) {
  const iconMap = {
    'Tutorial': 'book-open',
    'Tips & Tricks': 'lightbulb',
    'Platform Updates': 'rocket',
    'User Stories': 'user-circle',
    'Technical': 'code',
    'General': 'newspaper',
    'LaTeX': 'file-text',
    'Collaboration': 'users',
    'Templates': 'layout-template'
  };
  return iconMap[category] || 'newspaper';
}

// Generate the index page
function generateBlogIndex(posts) {
  const postsByYear = {};
  const postsByCategory = {};
  const allCategories = new Set();
  const allTags = new Set();
  
  // Group posts by year and category
  posts.forEach(post => {
    const year = new Date(post.date).getFullYear();
    if (!postsByYear[year]) {
      postsByYear[year] = [];
    }
    postsByYear[year].push(post);
    
    if (!postsByCategory[post.category]) {
      postsByCategory[post.category] = [];
    }
    postsByCategory[post.category].push(post);
    
    allCategories.add(post.category);
    post.tags.forEach(tag => allTags.add(tag));
  });
  
  let content = `---
title: Blog
description: Insights, tutorials, and updates from the LaTeX Cloud Studio team
---

# LaTeX Cloud Studio Blog

Stay updated with the latest LaTeX tips, tutorials, and platform updates.

## Categories

Browse posts by category:

<CardGroup cols={3}>
${Array.from(allCategories).map(category => {
  const count = postsByCategory[category].length;
  const icon = getCategoryIcon(category);
  return `<Card title="${category}" icon="${icon}" href="#category-${category.toLowerCase().replace(/\s+/g, '-').replace(/&/g, '')}">
  ${count} post${count !== 1 ? 's' : ''}
</Card>`;
}).join('\n')}
</CardGroup>

## All Posts

`;

  // Generate posts by year
  Object.keys(postsByYear)
    .sort((a, b) => b - a)
    .forEach(year => {
      content += `## ${year}\n\n`;
      
      postsByYear[year].forEach(post => {
        const formattedDate = new Date(post.date).toLocaleDateString('en-US', {
          month: 'long',
          day: 'numeric'
        });
        
        content += `<Card title="${post.title}" icon="${getCategoryIcon(post.category)}" href="/blog/${post.slug}">
  **${post.category}** • ${formattedDate} • ${post.author} • ${post.readTime}
  
  ${post.description}
  ${post.tags.length > 0 ? `
  
  Tags: ${post.tags.join(', ')}` : ''}
</Card>

`;
      });
    });

  // Add category sections
  content += `\n## Posts by Category\n\n`;
  
  Object.keys(postsByCategory)
    .sort()
    .forEach(category => {
      content += `### ${category} {#category-${category.toLowerCase().replace(/\s+/g, '-').replace(/&/g, '')}}\n\n`;
      
      postsByCategory[category].forEach(post => {
        const formattedDate = new Date(post.date).toLocaleDateString('en-US', {
          month: 'short',
          day: 'numeric',
          year: 'numeric'
        });
        
        content += `<Card title="${post.title}" icon="${getCategoryIcon(post.category)}" href="/blog/${post.slug}">
  ${formattedDate} • ${post.readTime}
  
  ${post.description}
</Card>

`;
      });
    });

  // Add RSS feed link
  content += `
---

<Info>
  Subscribe to our RSS feed to stay updated with the latest posts.
  
  [RSS Feed](/blog/rss.xml)
</Info>`;

  fs.writeFileSync(OUTPUT_FILE, content);
  console.log(`Generated blog index with ${posts.length} posts`);
}

// Generate RSS feed
function generateRSSFeed(posts) {
  const baseUrl = 'https://docs.latex-cloud-studio.com';
  
  const rss = `<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>LaTeX Cloud Studio Blog</title>
    <description>Insights, tutorials, and updates from the LaTeX Cloud Studio team</description>
    <link>${baseUrl}/blog</link>
    <atom:link href="${baseUrl}/blog/rss.xml" rel="self" type="application/rss+xml" />
    <language>en-us</language>
    <lastBuildDate>${new Date().toUTCString()}</lastBuildDate>
    ${posts.slice(0, 20).map(post => `
    <item>
      <title>${post.title}</title>
      <description>${post.description}</description>
      <link>${baseUrl}/blog/${post.slug}</link>
      <guid>${baseUrl}/blog/${post.slug}</guid>
      <pubDate>${new Date(post.date).toUTCString()}</pubDate>
      <author>${post.author}</author>
      ${post.tags.map(tag => `<category>${tag}</category>`).join('\n      ')}
    </item>`).join('')}
  </channel>
</rss>`;

  fs.writeFileSync(path.join(BLOG_DIR, 'rss.xml'), rss);
  console.log('Generated RSS feed');
}

// Main execution
const posts = getBlogPosts();
generateBlogIndex(posts);
generateRSSFeed(posts);

#!/usr/bin/env node

const fs = require('fs');
const path = require('path');
const matter = require('gray-matter');

// Configuration
const BLOG_DIR = path.join(__dirname, '../blog');
const INDEX_FILE = path.join(BLOG_DIR, 'index.mdx');

// Get all MDX files from blog directory
function getBlogPosts() {
  const files = fs.readdirSync(BLOG_DIR)
    .filter(file => file.endsWith('.mdx') && file !== 'index.mdx' && file !== 'auto-index.mdx');
  
  const posts = files.map(file => {
    const filePath = path.join(BLOG_DIR, file);
    const content = fs.readFileSync(filePath, 'utf8');
    const { data } = matter(content);
    
    return {
      slug: file.replace('.mdx', ''),
      title: data.title || 'Untitled',
      description: data.description || '',
      date: data.date || new Date().toISOString().split('T')[0],
      author: data.author || 'LaTeX Cloud Studio Team',
      tags: data.tags || [],
      category: data.category || 'General',
      image: data.image || null,
      readTime: data.readTime || '5 min read'
    };
  });
  
  // Sort by date (newest first)
  return posts.sort((a, b) => new Date(b.date) - new Date(a.date));
}

// Update featured posts section
function updateFeaturedPosts() {
  const posts = getBlogPosts();
  const featuredPosts = posts.slice(0, 4); // Take the 4 most recent posts
  
  // Read current index
  const indexContent = fs.readFileSync(INDEX_FILE, 'utf8');
  
  // Generate featured posts cards
  const featuredCardsContent = featuredPosts.map(post => {
    const icon = getCategoryIcon(post.category);
    return `<Card 
  title="${post.title}" 
  icon="${icon}" 
  href="/blog/${post.slug}"
>
  ${post.description}
</Card>`;
  }).join('\n\n');
  
  // Update the featured posts section
  const updatedContent = indexContent.replace(
    /(<CardGroup cols={2}>)([\s\S]*?)(<\/CardGroup>)/,
    `$1\n${featuredCardsContent}\n$3`
  );
  
  fs.writeFileSync(INDEX_FILE, updatedContent);
  console.log(`Updated featured posts with ${featuredPosts.length} posts`);
}

// Get icon for category
function getCategoryIcon(category) {
  const iconMap = {
    'Tutorial': 'book-open',
    'Tips & Tricks': 'lightbulb',
    'Platform Updates': 'rocket',
    'User Stories': 'user-circle',
    'Technical': 'code',
    'General': 'newspaper',
    'LaTeX': 'file-text',
    'Collaboration': 'users',
    'Templates': 'layout-template'
  };
  return iconMap[category] || 'newspaper';
}

// Main execution
if (require.main === module) {
  updateFeaturedPosts();
}

module.exports = { updateFeaturedPosts, getBlogPosts };

Quick Navigation

Lowercase and Uppercase Greek Letters

Greek letters

Arrows

Miscellaneous symbols

Binary Operation/Relation Symbols

LaTeX Symbols Reference - Complete List

LaTeX Cloud Studio Documentation

Master LaTeX with our comprehensive, user-friendly documentation. From beginners to advanced users, learn document preparation with clear examples and practical guides.

Learn LaTeX - Free Documentation & Tutorials

Quick start guide for LaTeX Cloud Studio. Learn how to create your first document, use templates, and navigate the interface in minutes.

Getting Started with LaTeX Cloud Studio

The quickest way to learn LaTeX. Create your first professional document in just 30 minutes with our beginner-friendly tutorial.

Learn LaTeX in 30 minutes

Learn how to create your first LaTeX document from scratch. Step-by-step guide for beginners using LaTeX Cloud Studio.

Creating your first LaTeX document

Understand different LaTeX compilers and engines. Learn about pdfLaTeX, XeLaTeX, and LuaLaTeX to choose the right one for your documents.

Choosing a LaTeX Compiler

Master paragraph formatting and line breaks in LaTeX. Learn how to control spacing, indentation, and text flow in your documents.

Paragraphs and new lines

Learn how to emphasize text in LaTeX using bold, italics, underline, and other formatting options. Complete guide with examples.

Bold, italics and underlining

Create bullet points, numbered lists, and custom lists in LaTeX. Learn about itemize, enumerate, and description environments.

Lists

Fix LaTeX errors quickly with our comprehensive troubleshooting guide. Solutions for the most common LaTeX compilation errors and warnings.

LaTeX Common Errors & Troubleshooting

Master text formatting in LaTeX including font sizes, styles, colors, alignment, and special formatting techniques.

Text Formatting in LaTeX

Master paragraph spacing, indentation, line spacing, and vertical space control in LaTeX for professional document layout.

Advanced Paragraph Spacing

Complete guide to font selection, customization, and typography in LaTeX. Learn about font families, packages, and advanced font features.

Fonts in LaTeX

Complete guide to LaTeX measurement units, lengths, and spacing. Learn how to use points, ems, centimeters, and other units for precise document formatting.

LaTeX Lengths and Units

Complete guide to customizing headers and footers in LaTeX. Learn to use fancyhdr, create custom page styles, and design professional document headers.

Headers and Footers in LaTeX

Complete guide to page numbering in LaTeX. Learn to customize page numbers, create different numbering schemes, and handle complex document structures.

Page Numbering in LaTeX

Complete guide to creating multiple column layouts in LaTeX. Learn to use multicol package, newspaper-style columns, and balanced column layouts.

Multiple Columns Layout

Complete guide to LaTeX counters and custom numbering systems. Learn to create, modify, and customize automatic numbering for any document element.

LaTeX Counters and Numbering

Complete guide to displaying source code in LaTeX using listings and minted packages. Learn syntax highlighting, custom styles, and advanced formatting options.

Advanced Code Listings and Minted

Master mathematical typesetting in LaTeX. Learn how to write equations, use math symbols, and create beautiful mathematical documents.

LaTeX Mathematics - Getting Started

Master subscripts and superscripts in LaTeX. Learn proper notation for indices, exponents, chemical formulas, and complex mathematical expressions.

Subscripts and Superscripts in LaTeX - Complete Guide

Master all types of brackets and parentheses in LaTeX. Learn automatic sizing, manual control, and advanced techniques for mathematical expressions.

Brackets and Parentheses in LaTeX - Complete Guide

Master complex mathematical equations in LaTeX. Learn multi-line equations, alignment, numbering, and advanced equation environments.

Mathematical Equations

Comprehensive guide to mathematical symbols in LaTeX. Learn operators, relations, delimiters, and special notation for professional mathematical documents.

Mathematical Symbols Guide

Master LaTeX matrices and arrays. Learn pmatrix, bmatrix, determinants, block matrices, and advanced layouts with visual examples.

LaTeX Matrices - Complete Guide with Examples

Learn how to insert, scale, and format images in LaTeX documents. Covers supported formats, the graphicx package, and image customization.

Inserting Images in LaTeX

Master figure positioning in LaTeX. Learn about float placement, positioning options, and advanced layout techniques for professional documents.

Figure Positioning and Layout

Learn to create professional LaTeX tables. Master tabular, booktabs, multirow/column cells, alignment and formatting with examples.

LaTeX Tables - Complete Tutorial Guide

Master complex table layouts in LaTeX. Learn about long tables, landscape orientation, nested tables, and professional formatting techniques.

Advanced Table Features

Master chemistry notation in LaTeX. Learn chemical formulas, reactions, molecular structures, and specialized chemistry symbols.

Chemistry Notation

Master physics notation in LaTeX - from quantum mechanics to relativity. Learn vectors, tensors, bra-ket notation, and specialized physics symbols.

Physics Notation and Symbols

Master music notation in LaTeX. Learn musical symbols, notes, chord notation, and how to create professional music scores and examples.

Music Notation

Master electronic circuit diagrams in LaTeX. Learn circuit symbols, components, and professional electronic schematics with CircuiTikZ.

Circuit Diagrams and Electronics

Master linguistic notation in LaTeX. Learn phonetic symbols, syntax trees, morphological analysis, and specialized linguistics formatting.

Linguistics Notation

Master algorithm notation in LaTeX. Learn pseudocode formatting, complexity analysis, data structures, and computer science notation.

Algorithms and Pseudocode

Master bibliography management and citations in LaTeX. Learn BibTeX, BibLaTeX, citation styles, and reference management for academic writing.

Bibliography and Citations in LaTeX

Master bibliography management in LaTeX using BibTeX. Learn citation styles, .bib files, and automated reference formatting with examples.

Bibliography Management with BibTeX - Complete Guide

Master LaTeX cross-referencing system. Learn to reference figures, tables, equations, sections with labels, and use advanced packages like cleveref.

Cross-referencing in LaTeX

Deep dive into TeX's box model using LuaTeX. Learn how LaTeX creates pages, debug layout issues, and manipulate boxes programmatically.

Understanding TeX Boxes with LuaTeX - Advanced Guide

Complete step-by-step guide to creating your first LaTeX project. Learn project setup, document structure, compilation, and best practices for beginners.

Creating Your First LaTeX Project

Master LaTeX templates for efficient document creation. Learn to find, customize, create, and share templates for various document types.

Using LaTeX Templates Effectively

Master LaTeX debugging and error resolution. Learn to identify, understand, and fix common compilation errors with practical solutions and prevention strategies.

Fixing LaTeX Compilation Errors

Complete guide to writing academic research papers in LaTeX. Learn structure, citations, formatting requirements, and submission preparation for journals and conferences.

Writing a Research Paper in LaTeX

Master LaTeX presentations using Beamer. Learn slides, themes, animations, overlays, graphics, and professional presentation techniques with comprehensive examples.

Creating Presentations with Beamer - Complete Guide

Write your thesis or dissertation in LaTeX. Free templates, formatting guides, bibliography management, and university-specific requirements.

LaTeX Thesis & Dissertation Templates - Complete Guide

Create stunning CVs and resumes with LaTeX. Free templates, ATS-friendly designs, and step-by-step tutorials for academic and professional CVs.

LaTeX CV & Resume Templates - Professional Guide

Design professional conference posters in LaTeX. Learn layout techniques, poster packages, visual hierarchy, and best practices for academic poster presentations.

Creating Academic Posters in LaTeX

Complete guide to creating professional books with LaTeX. Learn book structure, design, typography, and preparation for print and digital publishing.

Book Publishing with LaTeX

Comprehensive guide to including, positioning, and formatting images in LaTeX. Learn professional techniques for graphics, subfigures, and advanced image layouts.

Working with Images in LaTeX

Master advanced table creation in LaTeX. Learn booktabs, multirow, multicolumn, longtable, and professional formatting techniques for publication-quality tables.

Creating Professional Tables in LaTeX

Master TikZ for creating professional diagrams in LaTeX. Learn drawing commands, libraries, flowcharts, graphs, and advanced visualization techniques.

Creating Diagrams with TikZ

Master multi-file LaTeX projects. Learn document structuring, file organization, cross-referencing, and compilation strategies for books, theses, and reports.

Managing Large Documents in LaTeX

Master team collaboration in LaTeX. Learn version control, cloud platforms, change tracking, commenting systems, and best practices for multi-author documents.

Collaboration Workflow for LaTeX Projects

Create documents in multiple languages with LaTeX. Learn babel, polyglossia, font selection, and internationalization best practices for global documents.

Multi-language Documents in LaTeX

Comprehensive reference guide for LaTeX commands. Find syntax, usage examples, and options for all essential LaTeX commands.

LaTeX Commands Reference

Complete guide to essential LaTeX packages. Learn what each package does, how to use it, and see practical examples.

LaTeX Packages Reference

Complete guide to LaTeX document classes. Learn when to use article, report, book, and specialized classes for different document types.

LaTeX Document Classes Reference

Essential LaTeX commands for text formatting, structure, and document elements

Basic LaTeX Commands

Understanding LaTeX document structure, classes, and organization

Document Structure

Commands and techniques for formatting text in LaTeX documents

Text Formatting

Mathematical typesetting commands and environments in LaTeX

Math Mode

Professional LaTeX article templates for academic papers, journals, and scientific publications. Copy-paste ready templates with examples.

Article Templates

Comprehensive LaTeX templates for PhD dissertations and Master's theses. Includes all necessary components for academic submissions.

LaTeX Thesis & Dissertation Template

Professional CV and resume templates for job applications. Clean, ATS-friendly designs with multiple layout options.

LaTeX CV/Resume Template

Professional LaTeX Beamer templates for academic presentations, conference talks, and lectures. Ready-to-use presentation templates.

Presentation Templates

Insights, tutorials, and updates from the LaTeX Cloud Studio team

Blog

A comprehensive guide to transitioning from Microsoft Word to LaTeX for academic writing. Learn the real benefits, common challenges, and practical steps to get started.

Making the Switch from Word to LaTeX - A Practical Guide

The story behind LaTeX Cloud Studio and why we believe everyone deserves access to beautiful, professional document creation without the complexity.

Why We Built LaTeX Cloud Studio - Making LaTeX Accessible to Everyone

Introducing our new cloud-based LaTeX editor with real-time collaboration and powerful features

Welcome to LaTeX Cloud Studio

Learn advanced techniques for creating stunning diagrams with TikZ in LaTeX. Master flowcharts, network graphs, and mathematical visualizations.

Mastering TikZ Diagrams - Tips and Tricks

Intelligent assistance for LaTeX writing. AI error correction, citation suggestions, paragraph rewriting, and smart document restructuring.

AI-Powered LaTeX Features

Work together seamlessly on LaTeX documents. Real-time editing, live cursors, instant sync, and version control for teams.

Real-time Collaboration

Lightning-fast LaTeX compilation in the cloud. Near-real-time PDF generation, intelligent error handling, and complete TeX Live distribution.

Cloud Compilation System

Enterprise-grade security with GDPR compliance. EU data storage, end-to-end encryption, and complete privacy protection for your documents.

Symbol	LaTeX	Symbol	LaTeX
α A	`\alpha` `A`	ν N	`\nu` `N`
β B	`\beta` `B`	ξ Ξ	`\xi` `\Xi`
γ Γ	`\gamma` `\Gamma`	o O	`o` `O`
δ Δ	`\delta` `\Delta`	π Π	`\pi` `\Pi`
ε ϵ E	`\epsilon` `\varepsilon` `E`	ρ ϱ P	`\rho` `\varrho` `P`
ζ Z	`\zeta` `Z`	σ Σ	`\sigma` `\Sigma`
η H	`\eta` `H`	τ T	`\tau` `T`
θ ϑ Θ	`\theta` `\vartheta` `\Theta`	υ Υ	`\upsilon` `\Upsilon`
ι I	`\iota` `I`	φ φ Φ	`\phi` `\varphi` `\Phi`
κ K	`\kappa` `K`	χ X	`\chi` `X`
λ Λ	`\lambda` `\Lambda`	ψ Ψ	`\psi` `\Psi`
μ M	`\mu` `M`	ω Ω	`\omega` `\Omega`

Symbol	LaTeX	Symbol	LaTeX
←	`\leftarrow`	⇐	`\Leftarrow`
→	`\rightarrow`	⇒	`\Rightarrow`
↔	`\leftrightarrow`	⇔	`\Leftrightarrow`
↑	`\uparrow`	⇑	`\Uparrow`
↓	`\downarrow`	⇓	`\Downarrow`
↕	`\updownarrow`	⇕	`\Updownarrow`
↦	`\mapsto`	⟼	`\longmapsto`
↗	`\nearrow`	↘	`\searrow`
↙	`\swarrow`	↖	`\nwarrow`
↪	`\hookrightarrow`	↩	`\hookleftarrow`

Symbol	LaTeX	Symbol	LaTeX
∞	`\infty`	∀	`\forall`
∃	`\exists`	∄	`\nexists`
∅	`\emptyset`	∅	`\varnothing`
∇	`\nabla`	∂	`\partial`
√	`\surd`	⊤	`\top`
⊥	`\bot`	ℵ	`\aleph`
ℶ	`\beth`	ℷ	`\gimel`

Symbol	LaTeX	Symbol	LaTeX
×	`\times`	÷	`\div`
±	`\pm`	∓	`\mp`
∪	`\cup`	∩	`\cap`
**	`\setminus`	⊂	`\subset`
⊃	`\supset`	⊆	`\subseteq`
⊇	`\supseteq`	∈	`\in`
∉	`\notin`	∋	`\ni`
≤	`\leq`	≥	`\geq`
∼	`\sim`	≈	`\approx`
≡	`\equiv`	≠	`\neq`

Quick Reference

Detailed Syntax

LaTeX Symbols Reference - Complete List

Quick Navigation

Contents

Greek letters

Lowercase and Uppercase Greek Letters

Arrows

Miscellaneous symbols

Binary Operation/Relation Symbols

Further reading

Mathematical Expressions

Advanced Mathematics

Chemistry Notation

Physics Symbols

Quick Reference

Detailed Syntax

​Quick Navigation

​Contents

​Greek letters

​Lowercase and Uppercase Greek Letters

​Arrows

​Miscellaneous symbols

​Binary Operation/Relation Symbols

​Further reading

Mathematical Expressions

Advanced Mathematics

Chemistry Notation

Physics Symbols

Quick Navigation

Contents

Greek letters

Lowercase and Uppercase Greek Letters

Arrows

Miscellaneous symbols

Binary Operation/Relation Symbols

Further reading