Skip to content

shahkochaki/multi-language-lorem-with-categories

Repository files navigation

🚀 Multi-Language Lorem Ipsum Pro

Version VS Code License TypeScript

The Ultimate Professional Lorem Ipsum Generator for VS Code

Generate contextual placeholder text in 17 languages with 10 categories, history tracking, templates, and more!

FeaturesInstallationUsageWhat's New


🎯 What Makes This Extension Special?

Unlike basic lorem ipsum generators, Multi-Language Lorem Ipsum Pro is a complete content generation toolkit:

  • 🌍 17 World Languages - From English to Norwegian, Arabic to Korean
  • 🎨 10 Topic Categories - Tourism, Medical, Technology, Business, Finance, Sports, and more
  • 📊 Built-in Sidebar Panel - Visual interface with history, templates, and statistics
  • 📝 History Tracking - Never lose your generated content
  • Custom Templates - Save your favorite configurations
  • 📋 Clipboard Operations - Copy without inserting
  • 🎯 Multi-Cursor Support - Insert at multiple positions simultaneously
  • 📈 Text Statistics - Word count, character count, and more
  • Lightning Fast - Instant generation with keyboard shortcuts
  • 🎲 Smart Variations - Multiple unique texts per combination

✨ Features

🌍 17 Languages Support

Language Native Language Native
English English Italian Italiano
Persian فارسی Portuguese Português
Arabic العربية Korean 한국어
Chinese 中文 Hindi हिन्दी
Japanese 日本語 Turkish Türkçe
Russian Русский Dutch Nederlands
Spanish Español Swedish Svenska
French Français Norwegian Norsk
German Deutsch

📂 10 Professional Categories

  • 🏖️ Tourism - Travel, destinations, cultural experiences
  • ⚕️ Medical - Healthcare, treatments, patient care
  • 💻 Technology - Software, AI, digital transformation
  • 💼 Business - Consulting, strategy, corporate services
  • 📚 Education - Learning, academic programs, training
  • 🍽️ Food - Culinary, restaurants, gastronomy
  • 🏅 Sports - Events, training, fixtures, analysis
  • 💹 Finance - Banking, investing, markets, trading
  • 🌱 Environment - Sustainability, climate, green tech
  • 🎬 Entertainment - Film, music, media, shows

📏 Three Length Options

  • Short (1 sentence) - Perfect for labels, buttons, headings
  • Medium (2-3 sentences) - Ideal for cards, previews, descriptions
  • Long (5+ sentences) - Great for articles, paragraphs, content blocks

🎉 What's NEW in v2.0?

🎨 Beautiful Sidebar Panel

A dedicated sidebar panel gives you instant access to:

  • 🎲 Quick generation button
  • 📊 Real-time statistics
  • ⭐ Saved templates
  • 📜 Generation history (last 10 items)
  • 🔍 Preview generated texts
  • 📋 Copy and insert from history

Sidebar Panel

📝 History Tracking

Never lose your generated content:

  • Automatically saves last 50 generations
  • View history with timestamps
  • Re-insert or copy from history
  • Delete individual items or clear all
  • Statistics on your most-used languages and categories

⭐ Custom Templates

Save your favorite configurations:

  • Create named templates (e.g., "Blog Header", "Product Description")
  • One-click generation from templates
  • Manage templates in sidebar
  • Perfect for repetitive workflows

📋 Enhanced Clipboard Support

New clipboard command:

  • Generate and copy without inserting
  • Perfect for external apps
  • Shows text statistics after copy

🎯 Multi-Cursor Support

Professional editing support:

  • Insert at multiple cursor positions simultaneously
  • Works with multi-select
  • Saves time on bulk editing

📈 Text Statistics

Real-time feedback:

  • Word count
  • Character count (with/without spaces)
  • Line count
  • Shown after every generation

🎨 Context Menu Integration

Right-click anywhere in editor:

  • Quick access to lorem generation
  • Generate, copy, view history
  • Integrated into VS Code's native menu

📦 Installation

From VS Code Marketplace (Recommended)

  1. Open VS Code
  2. Press Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (Mac)
  3. Search for "Multi-Language Lorem Ipsum Pro"
  4. Click Install

Manual Installation

# Clone the repository
git clone https://github.com/shahkochaki/multi-language-lorem-with-categories.git
cd multi-language-lorem-with-categories

# Install dependencies
npm install

# Compile
npm run compile

# Press F5 to test in Extension Development Host

🚀 Usage

Quick Start

  1. Open the Sidebar Panel

    • Click the Lorem icon in the Activity Bar (left sidebar)
  2. Generate Text

    • Click "🎲 Generate Lorem Text" button
    • OR use Command Palette: Ctrl+Shift+PLorem: Generate Custom Text
    • OR right-click in editor → Lorem Generator → choose option
  3. Choose Options

    • Select language
    • Select category
    • Select length
  4. Done!

    • Text inserted at cursor
    • Statistics shown
    • Saved to history automatically

⌨️ Keyboard Shortcuts

Shortcut Action
Ctrl+Alt+L (Mac: Cmd+Alt+L) Open Custom Generator
Ctrl+Alt+Shift+E (Mac: Cmd+Alt+Shift+E) Quick English Text

Customize shortcuts: File → Preferences → Keyboard Shortcuts


💡 Advanced Usage

Using Templates

  1. Generate lorem text as usual
  2. Click "Save as Template" in the notification
  3. Enter a name (e.g., "Product Headlines")
  4. Access from sidebar or use directly

Working with History

View History:

  • Open sidebar to see last 10 items
  • OR: Command Palette → Lorem: View History for last 20

Re-use History:

  • Click "Insert" to add to current cursor
  • Click "Copy" to copy to clipboard
  • Click "Delete" to remove item

Statistics Dashboard

Command Palette → Lorem: Show Statistics

Shows:

  • Total texts generated
  • Top 5 used languages
  • Top 5 used categories

Multi-Cursor Tips

  1. Place multiple cursors (Ctrl+Alt+Click or Alt+Shift+Down)
  2. Generate lorem text
  3. Text inserted at all cursor positions

📖 Examples

English - Technology (Medium)

Innovative software solutions powering digital transformation across industries. Our cutting-edge technology stack enables seamless integration and scalability.

Persian - Tourism (Long)

سفری به یاد ماندنی را با بازدید از جاذبه‌های گردشگری بی‌نظیر تجربه کنید. از کوهستان‌های مرتفع تا سواحل زیبا، هر مقصد داستانی دارد. تورهای گردشگری ما با راهنمایان حرفه‌ای و برنامه‌ریزی دقیق، لحظات فراموش‌نشدنی را برای شما رقم می‌زنند. با پکیج‌های سفر منحصر به فرد ما، دنیای جدیدی را کشف کنید.

Spanish - Food (Short)

Creaciones culinarias exquisitas con ingredientes frescos y auténticos.

🎨 Sidebar Panel Guide

📊 Statistics Section

  • Total Generated: Number of texts you've created
  • Templates Saved: Your saved templates count

⭐ Templates Section

  • List of all saved templates
  • Use: Generate from this template
  • Delete: Remove template

📜 History Section

  • Last 10 generated texts
  • Shows: timestamp, language, category, length
  • Preview first 150 characters
  • Copy: Copy to clipboard
  • Insert: Insert at cursor
  • Delete: Remove from history

⚙️ Configuration

Settings (File → Preferences → Settings)

Search for "Multi Language Lorem"

Available Settings:

Setting Description Default
multiLanguageLorem.defaultLanguage Default language english
multiLanguageLorem.defaultCategory Default category tourism
multiLanguageLorem.defaultLength Default length medium
multiLanguageLorem.useSettingsByDefault Auto-apply defaults without prompting false

Example settings.json:

{
  "multiLanguageLorem.defaultLanguage": "persian",
  "multiLanguageLorem.defaultCategory": "technology",
  "multiLanguageLorem.defaultLength": "medium",
  "multiLanguageLorem.useSettingsByDefault": true
}

🎯 Use Cases

Web Development

  • Mock website content during design
  • Test responsive layouts with realistic text
  • Multi-language site prototyping

UI/UX Design

  • Figma/Sketch mockups with real language text
  • Test text overflow and truncation
  • Create realistic user flows

Content Writing

  • Quick placeholder for blog posts
  • Draft structures before real content
  • Multiple language content templates

Documentation

  • Example data for API docs
  • Sample text for user guides
  • Multi-language documentation

Testing

  • Test internationalization (i18n)
  • RTL (Right-to-Left) layout testing
  • Unicode character handling

📊 Statistics

Metric Count
Languages 17
Categories 10
Length Options 3
Unique Combinations 510+
Text Variations 1500+
Commands 22

🤝 Contributing

We welcome contributions! Here's how:

Adding Languages

  1. Create file: src/lorem-data/your-language.ts
  2. Follow existing structure (10 categories × 3 lengths)
  3. Each length needs 3-5 variations
  4. Submit PR with examples

Adding Categories

  1. Update all language files
  2. Add to types.ts
  3. Update extension.ts categories array
  4. Submit PR

Reporting Issues

  • Use GitHub Issues
  • Provide VS Code version, OS, extension version
  • Include steps to reproduce

🗺️ Roadmap

v2.1 (Next)

  • AI-powered custom text generation
  • Export/import templates
  • Bulk generation (multiple paragraphs)
  • Custom text length (exact word count)

v2.2

  • Integration with popular frameworks (React, Vue, Angular snippets)
  • Markdown formatting options
  • HTML/CSS lorem snippets
  • API for external tools

v3.0

  • 30+ languages support
  • 20+ categories
  • Cloud sync for history/templates
  • Team collaboration features
  • Custom language packs

📝 License

MIT License - see LICENSE file


🙏 Acknowledgments

  • Built with ❤️ by Ali Shahkochaki
  • Thanks to all contributors and users
  • Inspired by multilingual web development needs

📞 Support


⭐ Show Your Support

If you find this extension useful:

  • ⭐ Star the GitHub repository
  • 📝 Write a review on VS Code Marketplace
  • 🐛 Report bugs and suggest features
  • 🤝 Contribute to the project

Made with 💙 for developers worldwide

Happy Coding! 🚀

⬆ Back to Top

About

The most comprehensive Lorem Ipsum generator for VS Code with support for 12 languages and topic-specific content

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published