چگونه SqlScript را به SVG تبدیل کنیم

چگونگی تبدیل یک فایل SqlScript به تصویر SVG

Sheetize یک API ساده و با کارآیی بالا ارائه می‌دهد که به شما امکان می‌دهد یک فایل اسکریپت SQL (.sqlscript) را به یک تصویر SVG (Scalable Vector Graphics) واضح تبدیل کنید. این ویژگی برای تجسم طرح‌واره‌های پایگاه‌داده، قرار دادن نتایج پرس‌وجو در مستندات، یا ساخت نمودارهای برداری که بدون کاهش کیفیت مقیاس می‌شوند، ایده‌آل است.

چرا برای تبدیل SqlScript به SVG از Sheetize استفاده کنیم؟

  • حفظ کامل – تمام کلیدواژه‌های SQL، قالب‌بندی و رنگ‌بندی نظرات را به‌دقت حفظ می‌کند و یک گرافیک برداری تمیز تولید می‌کند.
  • سرعت و مقیاس‌پذیری – برای .NET بهینه‌سازی شده و بر روی ویندوز، macOS و لینوکس کار می‌کند.
  • قابلیت سفارشی‌سازی سبک – می‌توانید فونت، رنگ‌ها و فاصله خطوط را متناسب با برند خود تنظیم کنید.
  • بدون وابستگی – نیازی به ابزارهای خارجی یا نصب Office نیست.

شروع کار

پکیج Sheetize.ImageConverter را به پروژه‌ .NET خود اضافه کنید (از طریق NuGet) و متد ImageConverter.Process را فراخوانی کنید.

نمونه کد C# 

using Sheetize;

var loadOptions = new LoadOptions
{
    // مسیر فایل SqlScript مبدا
    InputFile = @"D:\Database\CreateSchema.sqlscript"
};

var saveOptions = new ImageSaveOptions
{
    // مسیر فایل خروجی – پسوند SVG فرمت SVG را انتخاب می‌کند
    OutputFile = @"D:\Diagrams\CreateSchema.svg",

    // اختیاری: تنظیم سبک تصویر
    FontName = "Consolas",
    FontSize = 12,
    // اختیاری: تعیین تم تاریک یا روشن (BackgroundColor = "#FFFFFF" برای حالت روشن)
    BackgroundColor = "#FFFFFF"
};

ImageConverter.Process(loadOptions, saveOptions);

این قطعه کد، CreateSchema.sqlscript را بارگذاری و با استفاده از فونت و تنظیمات پس‌زمینه مشخص، CreateSchema.svg را می‌نویسد.

گزینه‌های کلیدی برای خروجی SVG

  • FontName / FontSize – نوع و اندازه فونت مورد استفاده برای نمایش متن SQL را تعیین می‌کند.
  • BackgroundColor – رنگ پس‌زمینه را تنظیم می‌کند؛ اگر حذف شود به‌صورت پیش‌فرض شفاف است.
  • LineHeight – فاصله عمودی بین خطوط را تنظیم می‌کند (مثلاً 1.2 برای ۱۲۰ %).
  • SyntaxHighlighting – فعال یا غیرفعال کردن رنگ‌بندی کلیدواژه‌ها (از طریق پرچم‌های اضافی API).

بهترین روش‌ها

  1. برای خوانایی بهتر، از یک فونت تک عرض (مانند Consolas یا Courier New) استفاده کنید.
  2. برای مطالب چاپی پس‌زمینه روشن و برای ارائه‌های صفحه‌نمایش پس‌زمینه تاریک انتخاب کنید.
  3. پس از تولید SVG، آن را در یک نمایشگر گرافیک برداری (مانند Inkscape یا مرورگر Chrome) باز کنید تا مطمئن شوید همه کاراکترها به درستی رندر شده‌اند و فایل به‌درستی مقیاس می‌شود.
 فارسی