diff --git a/words/arabic/net/basic-conversions/_index.md b/words/arabic/net/basic-conversions/_index.md index c94cb16ecc..ded857dd1c 100644 --- a/words/arabic/net/basic-conversions/_index.md +++ b/words/arabic/net/basic-conversions/_index.md @@ -26,6 +26,7 @@ | [تحويل ملف Word إلى PDF](./docx-to-pdf/) تعرّف على كيفية تحويل ملفات Word إلى PDF بسهولة باستخدام Aspose.Words for .NET من خلال دليلنا. مثالي للمطورين الذين يبحثون عن تحويل سريع وموثوق للمستندات. | | [تحويل Word إلى PDF باستخدام C# و Aspose.Words – دليل](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | تعرّف على كيفية تحويل مستندات Word إلى PDF باستخدام C# و Aspose.Words خطوة بخطوة مع أمثلة عملية. | | [حفظ مستند Word كـ PDF باستخدام Aspose.Words – دليل C# كامل](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | تعرّف على طريقة حفظ مستندات Word بصيغة PDF باستخدام Aspose.Words في C# مع شرح مفصل وأمثلة عملية. | +| [تحويل Word إلى PDF باستخدام Aspose.Words – دليل كامل](./convert-word-to-pdf-with-aspose-words-complete-guide/) | تعرّف على طريقة تحويل مستندات Word إلى PDF باستخدام Aspose.Words في دليل شامل خطوة بخطوة مع أمثلة عملية. | | [تحويل Docx إلى بايت](./docx-to-byte/) | تعلّم كيفية تحويل ملفات Docx إلى مصفوفة بايت في .NET باستخدام Aspose.Words لمعالجة مستندات فعّالة. دليل خطوة بخطوة مُرفق. | | [تحويل Docx إلى Epub](./docx-to-epub/) حوّل ملفات DOCX إلى EPUB بسهولة باستخدام Aspose.Words لـ .NET. اتبع دليلنا التعليمي لدمجها بسلاسة في تطبيقات .NET. | [تحويل Docx إلى Mhtml وإرسال البريد الإلكتروني](./docx-to-mhtml-and-sending-email/) | تعلّم كيفية تحويل DOCX إلى MHTML وإرسال رسائل البريد الإلكتروني باستخدام Aspose.Words لـ .NET في هذا الدليل التفصيلي. حسّن إنتاجيتك مع الأتمة السهلة. | diff --git a/words/arabic/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/arabic/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..ced063120f --- /dev/null +++ b/words/arabic/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: حوّل ملفات Word إلى PDF بسرعة باستخدام Aspose.Words. تعلّم كيفية حفظ + Word كملف PDF، وتصدير docx إلى PDF، وإنشاء PDF يمكن الوصول إليه في C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: ar +og_description: تحويل Word إلى PDF في C# باستخدام Aspose.Words. يوضح هذا الدليل كيفية + حفظ ملف Word كـ PDF، وتصدير docx إلى PDF، وإنشاء PDF يمكن الوصول إليه. +og_title: تحويل Word إلى PDF باستخدام Aspose.Words – خطوة بخطوة +tags: +- Aspose.Words +- C# +- PDF conversion +title: تحويل Word إلى PDF باستخدام Aspose.Words – دليل كامل +url: /ar/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convert Word to PDF with Aspose.Words – Complete Guide + +هل تساءلت يوماً كيف **convert Word to PDF** دون الحاجة إلى أدوات ويب من طرف ثالث؟ ربما تقوم ببناء محرك تقارير آلي وتحتاج إلى طريقة موثوقة لـ *save word as pdf* في الوقت الفعلي. الخبر السار هو أن Aspose.Words يجعل العملية بأكملها سهلة للغاية، ويمكنك حتى إنتاج ملف متوافق مع **PDF/UA‑2** — مثالي لمتطلبات إمكانية الوصول. + +في هذا الدرس سنستعرض كل ما تحتاجه: تحميل ملف `.docx`، ضبط خيارات PDF بحيث يمكنك *export docx to pdf* مع توافق PDF/UA، وأخيراً حفظ النتيجة كملف PDF يمكن الوصول إليه. في النهاية ستحصل على مقتطف جاهز للإنتاج يمكنك إدراجه في أي مشروع .NET. + +![Convert Word to PDF using Aspose.Words](convert-word-to-pdf.png) + +## What You’ll Learn + +- **Why Aspose.Words** هو خيار قوي لسيناريوهات *generate accessible pdf*. +- الخطوات الدقيقة لـ *save document as pdf* مع توافق PDF/UA‑2. +- كيفية التعامل مع الحالات الشائعة مثل الخطوط المفقودة أو الملفات المحمية بكلمة مرور. +- نصائح سريعة لتصحيح مخرجات البرنامج والتحقق من توافق إمكانية الوصول. + +### Prerequisites + +- .NET 6 أو أحدث (تعمل الواجهة البرمجية أيضاً على .NET Framework 4.6+). +- رخصة صالحة لـ Aspose.Words for .NET (الإصدار التجريبي المجاني يكفي للتقييم). +- معرفة أساسية بـ C# — لا حاجة لأنماط معقدة. + +إذا كان لديك كل ما سبق، فلنبدأ. + +--- + +## Convert Word to PDF – Step‑by‑Step Implementation + +سنقسم الحل إلى خمس خطوات واضحة. كل خطوة تحتوي على عنوان، مقتطف شفرة قصير، وتوضيح *لماذا* الشفرة مهمة. + +### Step 1: Load the Word Document You Want to Convert + +الأمر الأول الذي تحتاجه هو كائن `Document` يمثل الملف المصدر. Aspose.Words يقرأ **.docx**، **.doc**، **.rtf** والعديد من الصيغ الأخرى، لذا يمكنك *save word as pdf* بغض النظر عن طريقة إنشاء الملف أصلاً. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Why this matters:** +- تحميل الملف مبكراً يتيح لك اكتشاف أخطاء عدم وجود الملف قبل إهدار موارد المعالج. +- فئة `Document` تُجردك من تفاصيل بنية ملف Word الداخلية، وتوفر لك نموذج كائن نظيف للعمل معه. + +### Step 2: Configure PDF Save Options for Accessibility + +إذا كنت بحاجة إلى *generate accessible pdf*، يجب إخبار Aspose.Words بإنتاج مستند متوافق مع PDF/UA‑2. فئة `PdfSaveOptions` تمنحك تحكمًا دقيقًا في المخرجات. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Why this matters:** +- `PdfCompliance.PdfUa2` يطلب من المكتبة إضافة العلامات، معلومات الهيكل، والبيانات الوصفية التي تعتمد عليها برامج قراءة الشاشة. +- تضمين الخطوط (`EmbedFullFonts = true`) يمنع ظهور تحذيرات “الخط غير موجود” عند فتح PDF على نظام تشغيل مختلف. +- تعيين `Title` يساعد تقنيات المساعدة على الإعلان عن المستند بشكل صحيح. + +### Step 3: Save the Document as a PDF + +الآن بعد أن تم تحميل المصدر وضبط الخيارات، التحويل الفعلي يتم بسطر واحد. هنا تقوم بـ *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Why this matters:** +- طريقة `Save` تحترم `PdfSaveOptions` التي قمنا بإعدادها، مما يضمن تضمين ميزات إمكانية الوصول. +- وضع الاستدعاء داخل كتلة `try/catch` يمنحك فرصة لتسجيل أو إظهار أي أخطاء ترخيص أو أذونات قد تواجه المبتدئين. + +### Step 4: Verify the PDF/UA Compliance (Optional but Recommended) + +على الرغم من أن Aspose.Words تقوم بالجزء الأكبر من العمل، من الممارسات الجيدة التحقق مرة أخرى من النتيجة، خاصةً عند تسليم مستندات للجهات الحكومية أو الكيانات الخاضعة للتنظيم. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Why this matters:** +- `IsTagged` فحص سريع للمنطقية؛ التحقق الكامل من PDF/UA يتطلب أداة مخصصة، لكن معظم مشاكل التوافق تظهر كعلامات مفقودة. +- إذا أعاد العلم `false`، يمكنك مراجعة `PdfSaveOptions` — ربما نسيت ضبط `Compliance` أو أن المستند المصدر يفتقر إلى أنماط العناوين الصحيحة. + +### Step 5: Common Pitfalls & Pro Tips + +| Pitfall | What Happens | How to Fix | +|---------|--------------|------------| +| **Missing fonts** | يظهر النص على شكل مربعات في الـ PDF. | اضبط `EmbedFullFonts = true` **أو** قم بتثبيت الخطوط المفقودة على الخادم. | +| **Unlicensed library** | يضيف Aspose علامة مائية على كل صفحة. | أضف ملف الترخيص (`Aspose.Words.lic`) مبكراً في التطبيق (مثال: `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Password‑protected source** | `InvalidOperationException` عند `new Document(path)`. | استخدم overload `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Large documents cause OOM** | استثناء نفاد الذاكرة على ملفات ضخمة. | فعّل `MemoryOptimization` في `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Accessibility tags missing** | فشل التحقق من PDF/UA. | تأكد من أن ملف Word المصدر يستخدم أنماط عناوين صحيحة (`Heading 1`, `Heading 2`, إلخ) — Aspose يطابقها تلقائيًا مع علامات PDF. | + +**Pro tip:** إذا كنت تقوم بتحويل العديد من المستندات دفعة واحدة، أعد استخدام كائن `PdfSaveOptions` واحد. إن إنشاؤه مرة واحدة يقلل من استهلاك الذاكرة ويقلل من عبء التخصيص. + +--- + +## Full Working Example (Copy‑Paste Ready) + +البرنامج الكامل التالي يجمع كل ما سبق. احفظه كملف `Program.cs`، أضف حزم NuGet الخاصة بـ Aspose.Words و Aspose.PDF، ثم شغّله. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Expected result:** +سيظهر ملف باسم `output.pdf` في `C:\MyFiles`. عند فتحه في Adobe Acrobat سيظهر “PDF/A‑2b, PDF/UA‑1” في لوحة التوافق، مما يؤكد أنك نجحت في *convert word to pdf*. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/arabic/net/programming-with-markdownsaveoptions/_index.md b/words/arabic/net/programming-with-markdownsaveoptions/_index.md index 46ce6eb44b..6b4bc7ae91 100644 --- a/words/arabic/net/programming-with-markdownsaveoptions/_index.md +++ b/words/arabic/net/programming-with-markdownsaveoptions/_index.md @@ -42,6 +42,12 @@ ### [كيفية تصدير Markdown من DOCX – دليل كامل](./how-to-export-markdown-from-docx-complete-guide/) +### [كيفية تصدير LaTeX من Word – تحويل DOCX إلى Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) + +### [إنشاء markdown من Word – دليل C# كامل](./create-markdown-from-word-full-c-guide/) + +### [كيفية تصدير LaTeX من DOCX – تحويل إلى Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/arabic/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/arabic/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..ecb6ad9001 --- /dev/null +++ b/words/arabic/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,250 @@ +--- +category: general +date: 2026-03-27 +description: إنشاء ملف ماركداون من Word باستخدام Aspose.Words C#. تعلم تحويل ملفات + docx إلى ماركداون، استخراج الصور من Word، وكيفية استخدام الـ callback في دليل واحد. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: ar +og_description: إنشاء ملف ماركداون من Word باستخدام Aspose.Words. يوضح هذا الدليل + كيفية تحويل docx إلى ماركداون، واستخراج الصور من Word، واستخدام رد نداء لمعالجة + الموارد. +og_title: إنشاء ماركداون من Word – دورة C# كاملة +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: إنشاء ماركداون من Word – دليل C# الكامل +url: /ar/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# إنشاء markdown من Word – دورة C# كاملة + +هل احتجت يومًا إلى **إنشاء markdown من Word** لكن لم تكن متأكدًا من أين تبدأ؟ لست وحدك؛ يواجه العديد من المطورين هذه المشكلة عندما يحاولون نقل المحتوى من ملف .docx إلى مولد موقع ثابت أو مستودع توثيق. الخبر السار؟ باستخدام Aspose.Words يمكنك **تحويل docx إلى markdown**، استخراج كل صورة من الملف الأصلي، والتحكم بدقة في مكان وضع هذه الموارد—كل ذلك عبر رد نداء بسيط. + +> **نصيحة احترافية:** إذا كان لديك قالب Word يحتوي على لقطات شاشة أو مخططات أو شعارات، فإن هذه الطريقة ستحافظ على كل عنصر بصري دون الحاجة إلى النسخ واللصق يدويًا. + +--- + +## ما ستحتاجه + +- **.NET 6+** (أو .NET Framework 4.6+). يعمل الكود على أي بيئة تشغيل حديثة. +- **Aspose.Words for .NET** (حزمة NuGet `Aspose.Words`). النسخة التجريبية المجانية تكفي لمعظم السيناريوهات. +- مستند **Word** (`input.docx`) يحتوي على نص وعلى الأقل صورة واحدة. +- فهم أساسي للغة C# وVisual Studio (أو أي بيئة تطوير مفضلة لديك). + +لا توجد مكتبات إضافية مطلوبة—كل شيء آخر يتم التعامل معه بواسطة Aspose.Words نفسه. + +--- + +## الخطوة 1: إعداد المشروع وتثبيت Aspose.Words + +للحفاظ على التنظيم، ابدأ مشروعًا جديدًا من نوع console: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **لماذا هذه الخطوة مهمة:** تثبيت حزمة NuGet يضمن حصولك على أحدث API، والتي تتضمن الفئة `MarkdownSaveOptions` التي تم تقديمها في الإصدار 22.9. بدونها سيتعين عليك كتابة محول مخصص. + +--- + +## الخطوة 2: تحميل مستند Word المصدر + +السطر الأول من الكود يفتح ملف `.docx` الذي تريد تحويله. استبدل `YOUR_DIRECTORY` بالمسار الفعلي على جهازك. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **ماذا يحدث؟** `Document` يقوم بتحليل الملف، يبني شجرة DOM داخلية، ويجعل كل فقرة، جدول، وصورة قابلة للوصول. إذا كان الملف مفقودًا، يرمي Aspose استثناء `FileNotFoundException` واضح، يمكنك التقاطه لتوفير واجهة مستخدم أكثر سلاسة. + +--- + +## الخطوة 3: تكوين خيارات حفظ Markdown مع رد نداء حفظ الموارد + +هنا يأتي سحر **كيفية استخدام رد النداء**. يتيح لك رد النداء تحديد مكان وضع كل صورة مستخرجة. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **لماذا رد نداء؟** بشكل افتراضي، سيقوم Aspose بدمج الصور كسلاسل base‑64 داخل ملف markdown—وهو ما يمثل كابوسًا لإدارة الإصدارات. يمنحك رد النداء تحكمًا كاملاً في أسماء الملفات وبنية المجلدات. + +--- + +## الخطوة 4: حفظ المستند كـ Markdown + +الآن نولد ملف `.md`. جميع الصور ستمر عبر رد النداء المحدد في الخطوة التالية. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +إذا سارت الأمور على ما يرام، ستجد `Document.md` في المجلد المستهدف ومجلدًا فرعيًا اسمه `Resources` يحتوي على كل الصور المستخرجة من ملف Word الأصلي. + +--- + +## الخطوة 5: تنفيذ رد النداء الذي يخزن كل صورة مستخرجة + +فيما يلي التنفيذ الكامل لـ `MyResourceSaver`. يقوم بإنشاء دليل `Resources` (إذا لم يكن موجودًا)، يبني اسم ملف فريد لكل صورة، ويكتب تدفق الصورة إلى القرص. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **شرح الوسائط:** +> - `args.Index` – عداد يبدأ من الصفر يضمن التفرد. +> - `args.FileName` – اسم الملف الأصلي الذي يقترحه Aspose (غالبًا شيء مثل `image001.png`). +> - `args.Stream` – تدفق الإخراج حيث تُكتب بايتات الصورة. +> - `args.KeepResourceStreamOpen` – يُضبط على `false` حتى يقوم Aspose بإغلاق التدفق تلقائيًا، مما يمنع تسرب مقبض الملف. + +--- + +## مثال كامل يعمل + +بدمج كل ما سبق، إليك ملف واحد يمكنك نسخه ولصقه في `Program.cs`. تذكر استبدال `YOUR_DIRECTORY` بمسار مطلق أو نسبي يناسب بيئتك. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### النتيجة المتوقعة + +- `YOUR_DIRECTORY/Document.md` – ملف markdown يحتوي على روابط صور markdown قياسية، مثال: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – يحتوي على `img_0.png`، `img_1.jpg`، إلخ، وفقًا لترتيب ظهورها في مستند Word الأصلي. + +تشغيل البرنامج يطبع رسالة تأكيد ودية، تُخبرك بأن العملية نجحت. + +--- + +## الأسئلة المتكررة (FAQ) + +### كيف تستخرج الصور من Word دون فقدان الجودة؟ + +يقوم رد النداء بكتابة تدفق البايتات الخام مباشرة إلى ملف، مما يحافظ على الدقة الأصلية. لا يحدث أي تحويل أو ضغط ما لم تقم بإضافة منطق معالجة صور خاص داخل `ResourceSaving`. + +### هل يمكنني تغيير صيغة الصورة (مثال: PNG → JPEG) أثناء الاستخراج؟ + +بالتأكيد. داخل `ResourceSaving` يمكنك فحص `args.FileName` أو `args.Stream`، تحميل الصورة باستخدام `System.Drawing` أو `ImageSharp`، ثم إعادة ترميزها قبل الكتابة. فقط تذكر تحديث امتداد رابط markdown وفقًا لذلك. + +### ماذا إذا كنت أحتاج أن تشير ملفات markdown إلى CDN بدلاً من مجلد محلي؟ + +عدّل رد النداء لإضافة عنوان URL أساسي إلى رابط markdown. يمكنك تحقيق ذلك عن طريق تعيين `args.FileName` إلى URL كامل بعد رفع الصورة إلى CDN الخاص بك. + +### هل يعمل هذا مع الجداول، الحواشي، أو ميزات Word المتقدمة الأخرى؟ + +نعم. يقوم Aspose.Words بترجمة معظم بنى Word إلى ما يعادلها في markdown. الجداول تتحول إلى جداول markdown، الحواشي إلى روابط مرجعية، والقوائم المتداخلة تُعالج بسلاسة. إذا ظهر شيء غير متوقع، راجع ملاحظات الإصدار الأخيرة—فـ Aspose يواصل تحسين دقة التحويل. + +### كيف تحول docx إلى markdown في خط أنابيب CI/CD؟ + +ما عليك سوى إضافة الملف التنفيذي `.exe` إلى خطوات البناء، وتوجيهه إلى ملفات `.docx` التي تم إنشاؤها، ثم دفع ملفات `.md` ومجلد `Resources/` إلى مستودع الموقع الثابت. نظرًا لأن العملية حتمية بالكامل، فهي تعمل جيدًا في البيئات الآلية. + +--- + +## الخلاصة + +لقد استعرضنا كيفية **إنشاء markdown من Word** باستخدام Aspose.Words، غطينا سير عمل **تحويل docx إلى markdown** بالكامل، وأظهرنا طريقة عملية **لاستخراج الصور من Word** عبر تنفيذ **كيفية استخدام رد النداء** المخصص. النتيجة هي ملف markdown نظيف مع مجلد صور أصلي—مثالي لمواقع التوثيق، المدونات الثابتة، أو أي سير عمل يفضّل الصيغ النصية البسيطة. + +الخطوات التالية التي قد تفكر فيها: + +- **معالجة دفعات** لعدة ملفات `.docx` في مجلد (استخدام حلقة `Directory.GetFiles`). +- **أنظمة تسمية مخصصة** للصور (مثلاً باستخدام نص التسمية التوضيحية الأصلي). +- **معالجة لاحقة** للmarkdown لاستبدال روابط الصور بروابط CDN. +- استكشاف **صيغ تصدير Aspose الأخرى** مثل HTML، PDF، أو EPUB للنشر متعدد القنوات. + +هل لديك أسئلة إضافية أو ملف Word معقد يرفض التحويل؟ اترك تعليقًا أدناه، ولنحل المشكلة سويًا. برمجة سعيدة، واستمتع ببساطة تحويل Word إلى markdown! + +--- + +![مخطط يوضح عملية تحويل Word إلى Markdown](image.png "مخطط إنشاء markdown من Word") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/arabic/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/arabic/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..11c7acd16a --- /dev/null +++ b/words/arabic/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: كيفية تصدير LaTeX من DOCX باستخدام Aspose.Words. تعلم تحويل DOCX إلى + Markdown، ضبط DPI، وتمكين الاستعادة في C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: ar +og_description: كيفية تصدير LaTeX من DOCX باستخدام Aspose.Words. يوضح هذا البرنامج + التعليمي خطوة بخطوة التحويل إلى Markdown، التحكم في DPI، ووضع الاستعادة. +og_title: كيفية تصدير LaTeX من DOCX – التحويل إلى Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: كيفية تصدير LaTeX من DOCX – التحويل إلى Markdown +url: /ar/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية تصدير LaTeX من DOCX – التحويل إلى Markdown + +هل تساءلت يومًا **كيف تصدر LaTeX** من ملف DOCX دون فقدان جمال معادلاتك؟ أنت لست وحدك. حسب تجربتي، أكبر نقطة ألم هي تحويل كائنات OfficeMath إلى تنسيق نظيف ومحمول لمولدات المواقع الثابتة أو المدونات العلمية. + +في هذا الدليل سنستعرض عملية تحويل DOCX إلى Markdown باستخدام Aspose.Words، مع توضيح **كيفية ضبط DPI**، **كيفية تمكين الاسترداد**، وبعض الحيل المفيدة لإنشاء خط أنابيب ثابت. في النهاية ستحصل على برنامج C# واحد ينتج ملف Markdown يحتوي على معادلات LaTeX، صور عالية الدقة، ومعالجة صحيحة للروابط. + +## ما ستحتاجه + +- **.NET 6+** (أو .NET Framework 4.7.2 – الواجهة البرمجية تعمل بنفس الطريقة) +- **Aspose.Words for .NET** (أحدث نسخة مستقرة حتى مارس 2026) +- ملف DOCX يحتوي على معادلات، صور، وروابط +- Visual Studio، VS Code، أو أي محرر تفضله + +لا توجد حزم NuGet إضافية مطلوبة بخلاف Aspose.Words، لكن تأكد من وجود ترخيص صالح إذا لم تكن تستخدم النسخة التجريبية. + +## الخطوة 1 – تحميل DOCX بوضع الاسترداد الصارم + +قبل أن نفكر في التصدير، يجب التأكد من أن المستند المصدر لا يخفي أي فساد. هنا يأتي دور **كيفية تمكين الاسترداد**. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**لماذا الاسترداد الصارم؟** +إذا تركت Aspose يصلح المشكلات بصمت، قد ينتهي بك الأمر إلى فقرات مفقودة أو صور مكسورة—وهو ما لا يريده أحد عند تصدير LaTeX. عبر الفشل السريع، يمكنك اكتشاف المشكلة مبكرًا وتحديد ما إذا كنت ستصلح ملف DOCX الأصلي أو تسجل المشكلة للمعالجة لاحقًا. + +### نصيحة احترافية +غلف عملية التحميل داخل try/catch وسجل `DocumentLoadingException`. بهذه الطريقة يمكن لخط أنابيب CI الخاص بك الإشارة إلى الملفات المسببة للمشكلات دون إيقاف عملية البناء بالكامل. + +## الخطوة 2 – إعداد خيارات تصدير Markdown + +الآن بعد أن أصبح المستند في الذاكرة بأمان، نقوم بتكوين طريقة حفظه. هذا هو جوهر **كيفية تصدير latex** ويشمل أيضًا **كيفية ضبط DPI** للصور المضمنة. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**ما الذي يفعله كل خيار** + +| الخيار | السبب | الصلة بالكلمات المفتاحية | +|--------|--------|---------------------------| +| `OfficeMathExportMode = LaTeX` | يجيب مباشرةً على **how to export latex** من المعادلات. | الكلمة المفتاحية الأساسية | +| `ImageResolution = 300` | يتحكم في جودة الصورة – الجواب على **how to set dpi**. | ثانوية | +| `ResourceSavingCallback` | يحفظ الملفات المضمنة إلى القرص، حاجة شائعة عند **convert docx to markdown**. | ثانوية | +| `EmptyParagraphExportMode` | يضمن مخرجات Markdown نظيفة، ويمنع وجود وسوم HTML عشوائية. | يحسن جودة التحويل العامة | +| `LinkExportMode = AsReference` | يجعل الروابط سهلة القراءة والتعديل، إضافة أخرى لـ **convert docx to markdown**. | | + +## الخطوة 3 – تنفيذ مُحفظ موارد مخصص (اختياري لكنه مفيد) + +عند تحويل DOCX إلى Markdown، تحتاج الصور والموارد الثنائية إلى مكان على نظام الملفات. يتيح لك Aspose التحكم في ذلك عبر `IResourceSavingCallback`. المقتطف أعلاه يوضح تنفيذًا بسيطًا، لكن دعنا نفصل ما يحدث: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**لماذا ذلك؟** +إذا تخطيت هذه الخطوة، سيقوم Aspose بدمج الصور كسلاسل base‑64، مما يضاعف حجم ملف Markdown ويجعل التحكم في الإصدارات صعبًا. عبر حفظ الموارد في مجلد منفصل، تحافظ على خفة Markdown وتجعله ملائمًا لمولدات المواقع الثابتة مثل Hugo أو Jekyll. + +## الخطوة 4 – حفظ المستند كـ Markdown + +تم إنجاز كل الأعمال الشاقة. الآن سطر واحد يكتب الملف النهائي. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +افتح `output.md` وسترى: + +- المعادلات تُعرض ككتل LaTeX `$…$` +- الصور تُشار إليها كـ `![Alt text](resources/image001.png)` بدقة 300 dpi +- الروابط تتحول إلى نمط المرجع: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +هذه هي عملية **how to convert docx** بالكامل باختصار. + +## أسئلة شائعة وحالات خاصة + +### 1️⃣ ماذا لو كان الـ DOCX يحتوي على كائنات غير مدعومة؟ +ستطلق Aspose.Words استثناءً من نوع `FeatureNotSupportedException`. لأننا استخدمنا **how to enable recovery** في الوضع الصارم، سيظهر الاستثناء فورًا. يمكنك إما: + +- تحويل `RecoveryMode` إلى `RecoveryMode.Default` للحصول على تحويل بأفضل جهد ممكن، **أو** +- معالجة الـ DOCX مسبقًا (مثلاً، إزالة SmartArt غير المدعوم) قبل تشغيل المحول. + +### 2️⃣ هل يمكنني تغيير DPI لكل صورة؟ +إعداد `ImageResolution` عالمي. للتحكم في DPI بصورة منفردة، نفّذ `ImageSavingCallback` مخصص مشابه لـ `MyResourceSaver` واضبط `args.ImageResolution` بناءً على `args.ImageFileName` أو البيانات الوصفية. + +### 3️⃣ كيف أدمج LaTeX المُولد في موقع Jekyll؟ +دعم MathJax المدمج في Jekyll يعمل مباشرة. فقط تأكد من أن القالب الخاص بك يتضمن سكريبت MathJax وأن كتل LaTeX محاطة بـ `$$` للمعادلات العرضية أو `$` للمعادلات داخل النص. + +### 4️⃣ هل هذا متوافق مع .NET Core على Linux؟ +بالطبع. Aspose.Words متعدد المنصات. فقط تأكد من أن مسار `YOUR_DIRECTORY` يتبع صيغ Linux (مثلاً، `/home/user/docs`). + +## مثال عملي كامل + +فيما يلي برنامج جاهز للنسخ واللصق. استبدل `YOUR_DIRECTORY` بمسار فعلي على جهازك. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**الناتج المتوقع** – افتح `output.md` ويجب أن ترى شيئًا مشابهًا: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +إذا فتحت الملف في معاينة Markdown تدعم MathJax، سيظهر التكامل بشكل صحيح. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/arabic/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/arabic/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..2043f1e7b1 --- /dev/null +++ b/words/arabic/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: كيفية تصدير LaTeX من مستندات Word باستخدام Aspose.Words – تحويل DOCX + إلى Markdown مع المعادلات بصيغة LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: ar +og_description: كيف يتم تصدير LaTeX من مستندات Word موضح في الجملة الأولى، موضحًا + لك كيفية تحويل DOCX إلى Markdown مع المعادلات بصيغة LaTeX. +og_title: كيفية تصدير LaTeX من Word – دليل شامل +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: كيفية تصدير LaTeX من Word – تحويل DOCX إلى Markdown +url: /ar/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية تصدير LaTeX من Word – تحويل DOCX إلى Markdown + +هل تساءلت يومًا **كيف تصدر LaTeX** من ملف Word دون أن ينتهي بك الأمر بمجموعة من ملفات PNG؟ لست الوحيد؛ المطورون يواجهون هذه المشكلة باستمرار عندما يحتاجون إلى معادلات نظيفة وقابلة للتحرير للمواقع الثابتة أو المدونات العلمية. الخبر السار؟ باستخدام Aspose.Words يمكنك **تحويل Word إلى Markdown** والاحتفاظ بكل كائن OfficeMath كـ LaTeX أصلي—بدون الحاجة إلى معالجة لاحقة. + +في هذا الدرس سنستعرض العملية الكاملة **لحفظ مستند Word كملف Markdown** مع **تصدير المعادلات كـ LaTeX**. في النهاية ستحصل على مقطع C# قابل للتنفيذ، شرح واضح لكل خيار، ونصائح للتعامل مع الحالات الخاصة مثل الصيغ المعقدة أو المحتوى المختلط. لا أدوات خارجية، مجرد حزمة NuGet واحدة وعدة أسطر من الشيفرة. + +## ما ستحتاجه + +- .NET 6+ (أو .NET Framework 4.7.2 وما أعلى) – أحدث نسخة من الـ runtime هي الأفضل. +- Visual Studio 2022 أو أي محرر يمكنه تجميع مشاريع C#. +- رخصة Aspose.Words for .NET (الإصدار التجريبي المجاني يكفي للتجربة). +- ملف DOCX يحتوي على معادلة واحدة على الأقل (OfficeMath). + +إذا كان لديك كل ذلك، رائع—لنبدأ. + +## كيفية تصدير LaTeX من Word – نظرة عامة + +فيما يلي عرض عالي المستوى للخطوات المتضمنة: + +1. **تثبيت** حزمة Aspose.Words عبر NuGet. +2. **تحميل** ملف `.docx` المصدر الذي يحتوي على المعادلات. +3. **تهيئة** `MarkdownSaveOptions` بحيث يتم ضبط `OfficeMathExportMode` على `LaTeX`. +4. **حفظ** المستند كملف `.md`. +5. **التحقق** من أن الـ Markdown الناتج يحتوي على كتل LaTeX (`$$…$$`). + +سيتم شرح كل خطوة بالتفصيل في الأقسام التالية. + +![مخطط يوضح تدفق التحويل من DOCX إلى Markdown مع معادلات LaTeX](how-to-export-latex.png){alt="مخطط كيفية تصدير LaTeX من مستند Word"} + +## الخطوة 1 – تثبيت Aspose.Words for .NET (convert word to markdown) + +أولًا وقبل كل شيء: تحتاج إلى المكتبة التي تقوم بالعمل الفعلي. افتح الطرفية (أو Package Manager Console) ونفّذ الأمر التالي: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **نصيحة محترف:** إذا كنت تستخدم Visual Studio، انقر بزر الماوس الأيمن على المشروع → *Manage NuGet Packages* → ابحث عن “Aspose.Words” وثبّت أحدث نسخة مستقرة. + +لماذا هذا مهم: Aspose.Words تُجرد تنسيق Open XML، وتوفر لك API نظيف للتعامل مع مستندات Word دون الحاجة إلى معالجة XML منخفض المستوى. كما أنها تدعم تحويل OfficeMath إلى LaTeX مدمجًا، وهو جوهر متطلب **تصدير المعادلات كـ LaTeX**. + +## الخطوة 2 – تحميل ملف DOCX (how to convert docx) + +بعد تثبيت الحزمة، قم بتحميل الملف الذي تريد تحويله. استبدل `YOUR_DIRECTORY` بالمسار الذي يتواجد فيه ملف `.docx` الخاص بك: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **لماذا نحمل الملف بهذه الطريقة؟** مُنشئ `Document` يقرأ الملف بالكامل إلى نموذج كائنات، مما يمنحك وصولًا فوريًا إلى الفقرات والجداول—والأهم من ذلك—كائنات OfficeMath. إذا كان الملف مفقودًا أو تالفًا، ستطرح Aspose استثناءً وصفيًا `FileNotFoundException` يمكنك التقاطه للتعامل مع الأخطاء برشاقة. + +## الخطوة 3 – تهيئة MarkdownSaveOptions (export equations as latex) + +السحر يحدث داخل كائن `MarkdownSaveOptions`. بشكل افتراضي، كانت Aspose ستحول المعادلات إلى صور PNG، لكننا نريد LaTeX. اضبط `OfficeMathExportMode` على `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +ملاحظة سريعة حول العلامات الاختيارية: `ExportImagesAsBase64` يُخبر Aspose بعدم تضمين البيانات الثنائية، مما يبقي الـ Markdown نظيفًا. `ExportHeadersFooters` يضمن عدم فقدان أي سياق قد يكون موجودًا في تلك الأقسام—مفيد عندما يحتوي الرأس على عنوان أو اسم مؤلف. + +## الخطوة 4 – حفظ المستند (save word as markdown) + +أخيرًا، اكتب المحتوى المحوّل إلى ملف `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +بعد تنفيذ هذا السطر، ستجد `output.md` بجوار ملف المصدر. افتحه في أي محرر نصوص وسترى كتل LaTeX تشبه ما يلي: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +بهذا تكون **حفظ Word كـ Markdown** قد اكتمل—بدون خطوات تحويل إضافية. + +## الخطوة 5 – التحقق من النتيجة (export equations as latex) + +من السهل إغفال التحقق، لكن فحص سريع يوفر عليك ساعات لاحقًا. شغّل سكريبت بسيط يقرأ الملف المُولد ويطبع أول كتلة LaTeX: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +إذا رأيت `First LaTeX block: $$ … $$` مطبوعًا، فقد نجحت في **تصدير LaTeX** من Word. إذا لم يحدث ذلك، تأكد من أن المستند المصدر يحتوي فعليًا على كائنات OfficeMath؛ المعادلات النصية العادية لن تُحوَّل. + +## التعامل مع الحالات الشائعة + +| السيناريو | ما يجب مراقبته | الإصلاح الموصى به | +|----------|-------------------|-----------------| +| **مزيج من الصور والمعادلات** | قد تظل Aspose تُضمّن صورًا للرسومات غير الـ OfficeMath. | اضبط `ExportImagesAsBase64 = false` واترك الصور كملفات خارجية، ثم أشر إليها يدويًا في Markdown. | +| **معادلات متداخلة معقدة** | التداخل العميق قد ينتج LaTeX يحتاج إلى تعديل يدوي. | عالج الكتلة لاحقًا بأداة تنسيق LaTeX (مثل `latexindent`) أو اضبط `mdOptions` → `ExportMathAsDisplay = true`. | +| **مستندات ضخمة** | استهلاك الذاكرة يرتفع عند تحميل ملفات `.docx` الكبيرة. | استخدم `LoadOptions` مع `LoadFormat.Docx` وفعل البث (streaming) إذا كان متاحًا. | +| **غياب الرخصة** | النسخة التجريبية تضيف تعليقًا كعلامة مائية إلى الناتج. | طبّق رخصة صالحة عبر `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +هذه النصائح تجعل سير عملك أكثر صلابة، خاصةً عندما **تحول Word إلى Markdown** في خطوط الإنتاج. + +## مثال كامل يعمل (جميع الخطوات في ملف واحد) + +فيما يلي تطبيق Console مكتمل يمكنك نسخه ولصقه في مشروع .NET جديد وتشغيله فورًا. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +شغّل البرنامج، افتح `output.md`، وسترى معادلاتك مُصدَّرة كـ LaTeX نظيف. هذا هو الجواب الكامل على سؤال **كيفية تصدير LaTeX** من مستند Word. + +## الخلاصة + +غطّينا **كيفية تصدير LaTeX** من Word خطوة بخطوة، موضحين لك كيفية **تحويل Word إلى Markdown**، **حفظ Word كـ Markdown**، و**تصدير المعادلات كـ LaTeX** باستخدام Aspose.Words. الفكرة الأساسية بسيطة: حمّل الـ DOCX، عدّل `MarkdownSaveOptions`، ودع المكتبة تتولى العمل الشاق. + +إذا كنت جاهزًا لأتمتة خطوط توثيقك، جرّب ربط هذا الكود مع مولّد مواقع ثابتة مثل Hugo أو Jekyll—فقط ادفع ملفات `.md` المُولدة إلى المستودع ودع الموقع يُعيد بناء نفسه. للمزيد من القراءة، استكشف دليل Aspose “Export to LaTeX”، جرّب `HtmlSaveOptions` للمعاينات على الويب، أو تعمّق في API `DocumentVisitor` لتحويلات مخصصة. + +هل لديك أسئلة حول الحالات الخاصة، الترخيص، أو دمج هذا في CI/CD؟ اترك تعليقًا أدناه، وتمنياتنا لك ببرمجة سعيدة! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/arabic/net/programming-with-pdfsaveoptions/_index.md b/words/arabic/net/programming-with-pdfsaveoptions/_index.md index 9e6e92466c..71a0138f02 100644 --- a/words/arabic/net/programming-with-pdfsaveoptions/_index.md +++ b/words/arabic/net/programming-with-pdfsaveoptions/_index.md @@ -26,26 +26,26 @@ | --- | --- | | [عرض عنوان المستند في شريط عنوان النافذة](./display-doc-title-in-window-titlebar/) |تعرف على كيفية عرض عنوان المستند في شريط عنوان النافذة في ملفات PDF الخاصة بك باستخدام Aspose.Words for .NET من خلال هذا الدليل خطوة بخطوة. | | [تحذيرات عرض PDF](./pdf-render-warnings/) |دليل خطوة بخطوة للتعامل مع تحذيرات عرض PDF باستخدام Aspose.Words لـ .NET. | -| [إضافة التوقيع الرقمي إلى ملف PDF باستخدام حامل الشهادة](./digitally-signed-pdf-using-certificate-holder/) أمّن ملفات PDF الخاصة بك بتوقيع رقمي باستخدام Aspose.Words لـ .NET. اتبع هذا الدليل خطوة بخطوة لإضافة توقيع رقمي إلى ملفات PDF الخاصة بك بسهولة. -| [تضمين الخطوط في مستند PDF](./embedded-all-fonts/) أدرج الخطوط في مستندات PDF بسهولة باستخدام Aspose.Words for .NET مع هذا الدليل المفصل خطوة بخطوة. تأكد من تناسق المظهر على جميع الأجهزة. -| [تضمين مجموعة فرعية من الخطوط في مستند PDF](./embedded-subset-fonts/) قلّل حجم ملف PDF بتضمين مجموعات الخطوط الضرورية فقط باستخدام Aspose.Words لـ .NET. اتبع دليلنا خطوة بخطوة لتحسين ملفات PDF بكفاءة. -| [تقليل حجم ملف PDF عن طريق تعطيل الخطوط المضمنة](./disable-embed-windows-fonts/) قلّل حجم ملف PDF بتعطيل الخطوط المُضمّنة باستخدام Aspose.Words لـ .NET. اتبع دليلنا خطوة بخطوة لتحسين مستنداتك لتخزينها ومشاركتها بكفاءة. -| [تحسين حجم ملف PDF باستخدام الخطوط المضمنة Arial و Times Roman](./skip-embedded-arial-and-times-roman-fonts/) حسّن حجم ملفات PDF بتخطي خطوط Arial وTimes Roman المدمجة باستخدام Aspose.Words لـ .NET. اتبع هذا الدليل خطوة بخطوة لتبسيط ملفات PDF. +| [إضافة التوقيع الرقمي إلى ملف PDF باستخدام حامل الشهادة](./digitally-signed-pdf-using-certificate-holder/) أمّن ملفات PDF الخاصة بك بتوقيع رقمي باستخدام Aspose.Words لـ .NET. اتبع هذا الدليل خطوة بخطوة لإضافة توقيع رقمي إلى ملفات PDF الخاصة بك بسهولة. | +| [تضمين الخطوط في مستند PDF](./embedded-all-fonts/) أدرج الخطوط في مستندات PDF بسهولة باستخدام Aspose.Words for .NET مع هذا الدليل المفصل خطوة بخطوة. تأكد من تناسق المظهر على جميع الأجهزة. | +| [تضمين مجموعة فرعية من الخطوط في مستند PDF](./embedded-subset-fonts/) قلّل حجم ملف PDF بتضمين مجموعات الخطوط الضرورية فقط باستخدام Aspose.Words لـ .NET. اتبع دليلنا خطوة بخطوة لتحسين ملفات PDF بكفاءة. | +| [تقليل حجم ملف PDF عن طريق تعطيل الخطوط المضمنة](./disable-embed-windows-fonts/) قلّل حجم ملف PDF بتعطيل الخطوط المُضمّنة باستخدام Aspose.Words لـ .NET. اتبع دليلنا خطوة بخطوة لتحسين مستنداتك لتخزينها ومشاركتها بكفاءة. | +| [تحسين حجم ملف PDF باستخدام الخطوط المضمنة Arial و Times Roman](./skip-embedded-arial-and-times-roman-fonts/) حسّن حجم ملفات PDF بتخطي خطوط Arial وTimes Roman المدمجة باستخدام Aspose.Words لـ .NET. اتبع هذا الدليل خطوة بخطوة لتبسيط ملفات PDF. | | [تقليل حجم ملف PDF عن طريق عدم تضمين الخطوط الأساسية](./avoid-embedding-core-fonts/) | تعرّف على كيفية تقليل حجم ملف PDF دون تضمين الخطوط الأساسية باستخدام Aspose.Words لـ .NET. اتبع دليلنا خطوة بخطوة لتحسين ملفات PDF الخاصة بك. | | [الهروب من عنوان URI في مستند PDF](./escape-uri/) تعلّم كيفية تجاوز عناوين URI في ملفات PDF باستخدام Aspose.Words لـ .NET. يشرح لك هذا الدليل المفصل العملية خطوة بخطوة. | | [تصدير الإشارات المرجعية لرأس وتذييل مستند Word إلى مستند PDF](./export-header-footer-bookmarks/) |تعرف على كيفية تصدير إشارات مرجعية للرأس والتذييل من مستند Word إلى PDF باستخدام Aspose.Words for .NET من خلال دليلنا خطوة بخطوة. | | [تقليل حجم ملف PDF باستخدام مقياس خطوط WMF إلى حجم الملف التعريفي](./scale-wmf-fonts-to-metafile-size/) |دليل خطوة بخطوة لتقليل حجم ملف pdf باستخدام خطوط wmf المتغيرة حسب حجم الملف التعريفي عند التحويل إلى ملف PDF باستخدام Aspose.Words لـ .NET. | -| [تحسين وضع نص PDF باستخدام وضع نص إضافي](./additional-text-positioning/) تعلّم كيفية تحسين وضع نص PDF باستخدام Aspose.Words لـ .NET بخطوات بسيطة. حسّن مظهر مستندك. -| [تحويل مستند Word إلى PDF 1.7](./conversion-to-pdf-17/) حوّل مستندات Word إلى PDF 1.7 بسهولة باستخدام Aspose.Words لـ .NET. اتبع هذا الدليل لضمان سهولة الوصول إلى مستنداتك وتنسيقها بشكل احترافي. -| [تقليل حجم مستند PDF باستخدام تقليل حجم الصور](./downsampling-images/) قلّل حجم ملف PDF بتقليل حجم الصور باستخدام Aspose.Words لـ .NET. حسّن ملفات PDF لديك لتسريع أوقات التحميل والتنزيل. -| [تعيين خيارات المخطط التفصيلي في مستند PDF](./set-outline-options/) تعرّف على كيفية ضبط خيارات المخطط التفصيلي في مستند PDF باستخدام Aspose.Words لـ .NET. حسّن تصفح PDF من خلال ضبط مستويات العناوين والمخططات التفصيلية الموسعة. +| [تحسين وضع نص PDF باستخدام وضع نص إضافي](./additional-text-positioning/) تعلّم كيفية تحسين وضع نص PDF باستخدام Aspose.Words لـ .NET بخطوات بسيطة. حسّن مظهر مستندك. | +| [تحويل مستند Word إلى PDF 1.7](./conversion-to-pdf-17/) حوّل مستندات Word إلى PDF 1.7 بسهولة باستخدام Aspose.Words لـ .NET. اتبع هذا الدليل لضمان سهولة الوصول إلى مستنداتك وتنسيقها بشكل احترافي. | +| [تقليل حجم مستند PDF باستخدام تقليل حجم الصور](./downsampling-images/) قلّل حجم ملف PDF بتقليل حجم الصور باستخدام Aspose.Words لـ .NET. حسّن ملفات PDF لديك لتسريع أوقات التحميل والتنزيل. | +| [تعيين خيارات المخطط التفصيلي في مستند PDF](./set-outline-options/) تعرّف على كيفية ضبط خيارات المخطط التفصيلي في مستند PDF باستخدام Aspose.Words لـ .NET. حسّن تصفح PDF من خلال ضبط مستويات العناوين والمخططات التفصيلية الموسعة. | | [تصدير الخصائص المخصصة في مستند PDF](./custom-properties-export/) |تعرف على كيفية تصدير الخصائص المخصصة في مستند PDF باستخدام Aspose.Words for .NET باستخدام دليلنا المفصل خطوة بخطوة. | -| [تصدير هيكل مستند Word إلى مستند PDF](./export-document-structure/) صدّر بنية مستند Word إلى ملف PDF باستخدام Aspose.Words لـ .NET. اتبع دليلنا خطوة بخطوة للحفاظ على تصميم المستند وتحسين تصفح ملفات PDF. +| [تصدير هيكل مستند Word إلى مستند PDF](./export-document-structure/) صدّر بنية مستند Word إلى ملف PDF باستخدام Aspose.Words لـ .NET. اتبع دليلنا خطوة بخطوة للحفاظ على تصميم المستند وتحسين تصفح ملفات PDF. | | [ضغط الصور في مستند PDF](./image-compression/) تعلّم كيفية ضغط الصور في مستندات PDF باستخدام Aspose.Words لـ .NET. اتبع هذا الدليل لتحسين حجم الملف وجودته. | | [تحديث آخر خاصية مطبوعة في مستند PDF](./update-last-printed-property/) |تعرف على كيفية تحديث آخر خاصية مطبوعة في مستند PDF باستخدام Aspose.Words لـ .NET من خلال دليلنا خطوة بخطوة. | | [عرض تأثيرات DML 3D ثلاثية الأبعاد في مستند PDF](./dml-3deffects-rendering/) |تعرف على كيفية تقديم تأثيرات DML ثلاثية الأبعاد المذهلة في مستندات PDF باستخدام Aspose.Words for .NET باستخدام هذا الدليل الشامل خطوة بخطوة. | | [استيفاء الصور في مستند PDF](./interpolate-images/) | تعلّم كيفية دمج الصور في مستند PDF باستخدام Aspose.Words for .NET من خلال دليلنا المفصل. حسّن جودة صور ملف PDF بسهولة. | - +| [كيفية حفظ PDF من DOCX باستخدام Aspose.Words – دليل خطوة بخطوة](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | تعلم كيفية تحويل مستند DOCX إلى PDF باستخدام Aspose.Words خطوة بخطوة. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/arabic/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/arabic/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..ab8657082d --- /dev/null +++ b/words/arabic/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-03-27 +description: تعلم كيفية حفظ ملف PDF من ملف DOCX باستخدام Aspose.Words. يتضمن تحويل + DOCX إلى PDF، حفظ PDF مع الخيارات، ومعالجة الأشكال العائمة. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: ar +og_description: كيفية حفظ PDF من ملف DOCX باستخدام Aspose.Words. يوضح هذا الدليل تحويل + DOCX إلى PDF، حفظ PDF مع الخيارات، ومعالجة الأشكال العائمة. +og_title: كيفية حفظ PDF من DOCX – دليل Aspose.Words الكامل +tags: +- Aspose.Words +- C# +- PDF conversion +title: كيفية حفظ PDF من DOCX باستخدام Aspose.Words – دليل خطوة بخطوة +url: /ar/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية حفظ PDF من DOCX باستخدام Aspose.Words – دليل كامل + +هل تساءلت يومًا **كيفية حفظ PDF** من مستند Word دون فقدان تخطيط الأشكال العائمة؟ لست وحدك. في العديد من المشاريع—مولدات الفواتير، مُصدِّري التقارير، أو مؤرّخات المستندات البسيطة—يحتاج المطورون إلى طريقة موثوقة لتحويل DOCX إلى PDF مع الحفاظ على كل شيء يبدو تمامًا كما هو في Word. + +في هذا الدليل سنستعرض تحويل ملف DOCX إلى PDF **باستخدام Aspose.Words for .NET**، ونظهر لك **كيفية تحويل docx إلى pdf** مع خيارات حفظ مخصصة، ونشرح لماذا علم `ExportFloatingShapesAsInlineTag` مهم. في النهاية ستحصل على مقطع جاهز للتنفيذ يحفظ PDF مع الخيارات التي تتحكم فيها. + +## ما ستتعلمه + +- الخطوات الدقيقة **لتحويل word document pdf** باستخدام Aspose.Words. +- كيفية تكوين `PdfSaveOptions` لمعالجة الأشكال العائمة كعلامات مضمنة. +- المشكلات الشائعة عند التعامل مع الكائنات العائمة وكيفية تجنّبها. +- برنامج C# كامل وقابل للتنفيذ يمكنك إدراجه في أي مشروع .NET. + +> **المتطلبات المسبقة:** تحتاج إلى ترخيص Aspose.Words for .NET (أو نسخة تجريبية مجانية) وبيئة تطوير .NET (Visual Studio، Rider، أو `dotnet` CLI). + +## الخطوة 1: إعداد المشروع وإضافة Aspose.Words + +أولاً، أنشئ تطبيق console جديد (أو أضفه إلى مشروع موجود) وأضف مرجع حزمة Aspose.Words من NuGet. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **نصيحة احترافية:** إذا كنت تعمل على خادم CI، قم بتثبيت نسخة الحزمة (`Aspose.Words --version 24.10`) لضمان بناءات قابلة للتكرار. + +## الخطوة 2: تحميل ملف DOCX الذي يحتوي على أشكال عائمة + +يمكن للصور العائمة، صناديق النص، أو SmartArt أن تتسبب في تغيرات التخطيط عند التحويل. تحميل المستند سهل، لكننا سنتحقق أيضًا من وجود الملف لتجنب استثناء `FileNotFoundException` أثناء التشغيل. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +لاحظ عبارات `Console.WriteLine`—فهي توفر لك ملاحظات سريعة عند تشغيل التطبيق من الطرفية. + +## الخطوة 3: تكوين خيارات حفظ PDF (Save PDF with Options) + +هنا يحدث السحر. بشكل افتراضي، يحاول Aspose.Words الحفاظ على الكائنات العائمة كما هي، مما قد يفسد التخطيط في ملف PDF الناتج. ضبط `ExportFloatingShapesAsInlineTag` إلى `true` يخبر المكتبة بمعالجة تلك الأشكال كعلامات مضمنة، مما يضمن بقاءها مرتبطة بالنص المحيط. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +لماذا هذا مهم؟ تخيل صندوق نص يطفو فوق فقرة. بدون تحويل العلامة المضمنة، قد يدفع PDF الفقرة إلى الأسفل أو يقطع الصندوق تمامًا. العلم يحافظ على العلاقة البصرية سليمة—تفصيل دقيق لكنه أساسي للتقارير الاحترافية. + +## الخطوة 4: حفظ المستند كـ PDF + +الآن نقوم فعليًا بكتابة ملف PDF. طريقة `Save` تستقبل مسار الإخراج بالإضافة إلى الخيارات التي حددناها. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +تشغيل البرنامج سينتج ملف `output.pdf` في نفس المجلد الذي يحتوي على ملف DOCX المصدر. افتحه بأي عارض PDF وسترى أن جميع الأشكال العائمة تم عرضها تمامًا في موضعها الصحيح. + +## مثال كامل يعمل + +فيما يلي البرنامج بالكامل في كتلة واحدة. انسخه‑الصقه في `Program.cs` (أو أي ملف C#) واضغط **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### النتيجة المتوقعة + +- **تم إنشاء الملف:** `output.pdf` في الدليل المستهدف. +- **دقة التخطيط:** الأشكال العائمة (الصور، صناديق النص، SmartArt) تظهر مدمجة مع النص المحيط. +- **بدون استثناءات:** ينتهي البرنامج بنعومة، مطبعًا رسائل الحالة إلى الطرفية. + +## الأسئلة المتكررة والحالات الخاصة + +| السؤال | الإجابة | +|----------|--------| +| **ماذا لو احتجت جودة صورة أعلى؟** | Set `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **هل يمكنني تحويل عدة ملفات DOCX دفعة واحدة؟** | Wrap the loading/saving logic in a `foreach (var file in Directory.GetFiles(..., "*.docx"))` loop. Remember to reuse a single `PdfSaveOptions` instance for performance. | +| **هل يعمل هذا مع .NET Core؟** | Absolutely. Aspose.Words 24.x supports .NET Standard 2.0+, so you can run the same code on Windows, Linux, or macOS. | +| **ماذا عن ملفات DOCX المحمية بكلمة مرور؟** | Load with `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. The same `PdfSaveOptions` apply when saving. | +| **هل تحويل العلامة المضمنة آمن للجداول المعقدة؟** | Generally yes, but very intricate table layouts with overlapping shapes may still need manual tweaking. Test a representative sample before a bulk migration. | + +## نصائح للمشاريع الواقعية + +- **سجِّل، لا تكتفِ بـ `Console.WriteLine`** – في الإنتاج، استبدل مخرجات الطرفية بإطار تسجيل (Serilog، NLog) لالتقاط الأخطاء. +- **تحرير الموارد** – `Document` يطبق `IDisposable`. ضعها داخل كتلة `using` إذا كنت تعالج ملفات متعددة لتفريغ الذاكرة بسرعة. +- **تحقق من صحة PDF** – استخدم أداة تحقق من PDF (مثل مدقق التوافق PDF/A) إذا كنت تحتاج إلى ملفات PDF بأعلى مستوى أرشيفي. +- **المعالجة المتوازية** – لأحمال العمل الضخمة، فكر في استخدام `Parallel.ForEach` مع `PdfSaveOptions` آمن للخطوط (انسخه لكل خيط) لتسريع التحويل. + +## الخلاصة + +لقد غطينا **كيفية حفظ PDF** من ملف DOCX باستخدام Aspose.Words، وأظهرنا **كيفية تحويل docx إلى pdf** مع خيارات مخصصة، وشرحنا تأثير `ExportFloatingShapesAsInlineTag`. المثال الكامل القابل للتنفيذ يوضح أنك يمكن أن **تحول word document pdf** في بضع أسطر فقط، والآن تعرف كيف **تحفظ pdf مع خيارات** تتناسب مع جودة ومتطلبات الامتثال لمشروعك. + +هل أنت مستعد للتحدي التالي؟ جرّب التصدير إلى صيغ أخرى (مثل HTML، EPUB) باستخدام `document.Save("output.html")`، أو جرب الامتثال لـ PDF/A للأرشفة طويلة الأمد. المبادئ نفسها—التحميل، تكوين الخيارات، الحفظ—تنطبق على جميع الحالات. + +برمجة سعيدة، ولتظل ملفات PDF الخاصة بك دائمًا كما تريد! + +![مخطط يوضح كيفية تحميل ملف DOCX، تطبيق الخيارات، وإنتاج PDF – كيفية حفظ pdf](https://example.com/images/how-to-save-pdf-diagram.png "مخطط كيفية حفظ pdf") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/arabic/net/programming-with-shapes/_index.md b/words/arabic/net/programming-with-shapes/_index.md index a6dc8fd1ae..2bebaaa276 100644 --- a/words/arabic/net/programming-with-shapes/_index.md +++ b/words/arabic/net/programming-with-shapes/_index.md @@ -27,13 +27,14 @@ | [إضافة شكل المجموعة](./add-group-shape/) |تعرف على كيفية إضافة أشكال المجموعة إلى مستندات Word باستخدام Aspose.Words for .NET من خلال هذا البرنامج التعليمي الشامل خطوة بخطوة. | | [إدراج الشكل](./insert-shape/) |تعرف على كيفية إدراج الأشكال ومعالجتها في مستندات Word باستخدام Aspose.Words for .NET من خلال دليلنا خطوة بخطوة. | | [نسبة العرض إلى الارتفاع مقفلة](./aspect-ratio-locked/) | تعلّم كيفية تثبيت نسبة أبعاد الأشكال في مستندات Word باستخدام Aspose.Words لـ .NET. اتبع هذا الدليل خطوة بخطوة للحفاظ على تناسب صورك وأشكالك. | -| [التخطيط في الخلية](./layout-in-cell/) تعرّف على كيفية ضبط تخطيط الخلية باستخدام Aspose.Words لـ .NET من خلال هذا الدليل الشامل. مثالي للمطورين الذين يرغبون في تخصيص مستندات Word. +| [التخطيط في الخلية](./layout-in-cell/) تعرّف على كيفية ضبط تخطيط الخلية باستخدام Aspose.Words لـ .NET من خلال هذا الدليل الشامل. مثالي للمطورين الذين يرغبون في تخصيص مستندات Word. | | [إضافة زوايا مقطوعة](./add-corners-snipped/) | تعرّف على كيفية إضافة شكل زوايا مقطوعة إلى مستندات Word باستخدام Aspose.Words لـ .NET. يضمن لك هذا الدليل التفصيلي تحسين مستنداتك بسهولة. | | [احصل على نقاط حدود الشكل الفعلية](./get-actual-shape-bounds-points/) اكتشف كيفية الحصول على نقاط حدود الأشكال الفعلية في مستندات Word باستخدام Aspose.Words لـ .NET. تعلّم معالجة الأشكال بدقة مع هذا الدليل المفصل. | | [مرساة عمودية](./vertical-anchor/) | تعلّم كيفية ضبط مواضع الربط الرأسية لمربعات النص في مستندات Word باستخدام Aspose.Words لـ .NET. مرفق دليل سهل خطوة بخطوة. | | [اكتشاف شكل الفن الذكي](./detect-smart-art-shape/) تعرّف على كيفية اكتشاف أشكال SmartArt في مستندات Word باستخدام Aspose.Words for .NET من خلال هذا الدليل الشامل. مثالي لأتمتة سير عمل مستنداتك. | | [تحديث رسم الفن الذكي](./update-smart-art-drawing/) | تعرّف على كيفية تحديث رسومات Smart Art في مستندات Word باستخدام Aspose.Words for .NET من خلال هذا الدليل المفصل. تأكد من دقة رسوماتك دائمًا. | | [إنشاء شكل مستطيل في Word باستخدام Aspose.Words – دليل خطوة بخطوة](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | تعلم كيفية إنشاء شكل مستطيل في مستند Word باستخدام Aspose.Words خطوة بخطوة. | +| [إنشاء مستند Word C# – إضافة شكل بظل](./create-word-document-c-add-shape-with-shadow/) | تعلم كيفية إنشاء مستند Word وإضافة شكل مع تأثير الظل باستخدام Aspose.Words for .NET وC# خطوة بخطوة. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/arabic/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/arabic/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..b2d15773f1 --- /dev/null +++ b/words/arabic/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: إنشاء مستند Word باستخدام C# وتعلم كيفية إضافة شكل، وتطبيق الظل على الشكل، + وتحديد مسافة الظل. دليل خطوة بخطوة لـ Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: ar +og_description: إنشاء مستند Word باستخدام C# مع شكل مستطيل وظل مخصص. اتبع هذا الدرس + الكامل لضبط مسافة الظل والنمط. +og_title: إنشاء مستند Word بـ C# – إضافة شكل بظل +tags: +- Aspose.Words +- C# +- Document Automation +title: إنشاء مستند Word باستخدام C# – إضافة شكل بظل +url: /ar/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# إنشاء مستند Word C# – إضافة شكل بظل + +هل احتجت يوماً إلى **create word document c#** يحتوي على مستطيل مصمم بشكل أنيق؟ ربما تقوم بإنشاء قالب تقرير وتريد ظلًا خفيفًا لجعل التصميم يبرز. في هذا الدرس سنستعرض ذلك بالضبط – كيفية إضافة شكل، تطبيق ظل على الشكل، وحتى تعديل مسافة الظل باستخدام Aspose.Words. + +سنبدأ بمستند فارغ، نضيف مستطيلًا، نمنحه ظلًا مسبقًا، ثم نحفظ الملف. في النهاية ستحصل على ملف .docx جاهز للاستخدام يمكنك فتحه في Word ورؤية التأثير فورًا. لا أدوات خارجية، فقط كود C# نقي. + +## المتطلبات المسبقة + +- .NET 6 (أو أي إطار .NET حديث) مثبت. +- Visual Studio 2022 أو VS Code مع ملحق C#. +- حزمة NuGet Aspose.Words لـ .NET (`Aspose.Words` الإصدار 23.12 أو أحدث). + يمكنك إضافتها عبر Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +هذا كل شيء – لا حاجة إلى DLLs إضافية أو COM interop. + +## الخطوة 1: تهيئة مستند جديد وBuilder – أساسيات *create word document c#* + +أولاً نحتاج إلى كائن `Document` الذي يمثل ملف Word و`DocumentBuilder` لتعديله. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **لماذا هذه الخطوة مهمة:** فئة `Document` هي الحاوية لجميع أجزاء Word (الصفحات، الأنماط، الصور). الـ builder هو API عالي المستوى يُج abstracts عن التعامل مع العقد منخفضة المستوى، مما يجعل من السهل **create word document c#** دون الحاجة للتعامل مع XML مباشرة. + +## الخطوة 2: إدراج شكل مستطيل – *how to create rectangle* + +الآن سنضع مستطيلًا على الصفحة. الحجم يُعبّر عنه بالنقاط (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **نصيحة احترافية:** إذا كنت بحاجة إلى شكل مختلف، فقط استبدل `ShapeType.Rectangle` بـ `ShapeType.Ellipse` أو `ShapeType.Triangle`، إلخ. نفس الكود يعمل مع **how to add shape** من أي نوع. + +## الخطوة 3: تطبيق ظل مسبق وتعديله – *apply shadow to shape* + +تأتي Aspose.Words مع عدة صيغ ظل مسبقة. سنستخدم `Preset1` ثم نخصص المسافة، التشويش، الشفافية، واللون. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **لماذا تخصيص الظل؟** خاصية `Distance` تتحكم في بعد الظل عن المستطيل – فكر فيها كـ “الارتفاع” الذي تراه في عرض ثلاثي الأبعاد. تغيير `BlurRadius` ينعّم الحواف، بينما `Transparency` يتيح لك إنشاء مظهر خفيف واحترافي. هذا يغطي متطلب **set shadow distance** ويظهر لك كيفية **apply shadow to shape** بطريقة مرنة. + +## الخطوة 4: حفظ المستند – إكمال *create word document c#* + +أخيرًا، احفظ المستند على القرص. عدّل المسار إلى مجلد لديك صلاحية كتابة فيه. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +افتح الملف الناتج في Microsoft Word، وسترى مستطيلًا أزرق فاتحًا مع ظل رمادي ناعم إزاحة 5 pt. هذا هو الدليل البصري على أنك نجحت في **create word document c#** مع شكل مُصمم. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="مثال create word document c# يظهر مستطيلًا بظل"} + +## تنويعات اختيارية وحالات حافة + +| السيناريو | ما الذي يجب تغييره | لماذا يهم | +|----------|----------------|----------------| +| **نمط ظل مختلف** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | يوفر لك مظهرًا أكثر دراماتيكية دون الحاجة إلى كود إضافي. | +| **بدون إعداد مسبق – ظل مخصص** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | تحكم كامل في الاتجاه والعمق. | +| **أشكال متعددة** | Call `builder.InsertShape` again before saving. | مفيد للقوالب المعقدة التي تحتوي على أيقونات، شعارات، إلخ. | +| **التوافق مع إصدارات Aspose القديمة** | Use `ShadowEffect` class (available in v20.x). | يضمن تشغيل الكود على المشاريع القديمة. | +| **الحفظ كملف PDF** | `document.Save("ShadowShape.pdf");` | يظهر نفس تأثير الظل في مخرجات PDF. | + +> **سؤال شائع:** *ماذا لو لم يظهر الظل في Word؟* +> تأكد من أنك تستخدم نسخة حديثة من Aspose.Words (≥ 22.9). الإصدارات القديمة كان لديها دعم محدود للظلال. كما تحقق من أن المستند يُفتح في نسخة حديثة من Word (2016+). + +## مثال كامل يعمل + +فيما يلي البرنامج الكامل الجاهز للنسخ واللصق. يتضمن جميع توجيهات `using`، التعليقات، ومعالجة الأخطاء لتجربة سلسة. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +شغّل البرنامج، انتقل إلى `C:\Temp\ShadowShape.docx`، وسترى المستطيل مع الظل الدقيق الذي قمنا بإعداده. + +## ملخص وخطوات قادمة + +- أنت الآن تعرف كيف **create word document c#**، وتدرج مستطيلًا، وت **apply shadow to shape** مع **set shadow distance** مخصص. +- المثال يستخدم Aspose.Words، الذي يُج abstracts عن تعقيدات OpenXML ويضمن عرضًا متسقًا عبر إصدارات Word. +- هل تريد التعمق أكثر؟ جرّب دمج أشكال متعددة، إضافة نص داخل المستطيل، أو تصدير نفس المستند كملف PDF لرؤية كيفية تحويل الظل. + +### مواضيع ذات صلة قد ترغب في استكشافها + +- **How to add shape** إلى رأس/تذييل للعلامة التجارية. +- استخدام **Aspose.Words** لإدراج المخططات والجداول برمجيًا. +- تخصيص **shadow effects** على الصور بدلاً من الأشكال المتجهية. +- أتمتة إنشاء المستندات الجماعية للفواتير أو الشهادات. + +لا تتردد في التجربة، كسر الكود، ثم إعادة بنائه – هذه أسرع طريقة لاستيعاب المفاهيم. إذا واجهت مشكلة، اترك تعليقًا أدناه أو راجع وثائق Aspose.Words الرسمية للحصول على رؤى أعمق حول API. + +برمجة سعيدة، واستمتع بجعل ملفات Word تبدو أكثر صقلًا! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/arabic/net/programming-with-txtsaveoptions/_index.md b/words/arabic/net/programming-with-txtsaveoptions/_index.md index b047adbbaf..0837b27ece 100644 --- a/words/arabic/net/programming-with-txtsaveoptions/_index.md +++ b/words/arabic/net/programming-with-txtsaveoptions/_index.md @@ -24,10 +24,10 @@ ## دروس تعليمية | العنوان | الوصف | | --- | --- | -| [إضافة علامات Bidi في مستند Word](./add-bidi-marks/) تعرّف على كيفية إضافة علامات ثنائية الاتجاه (Bidi) في مستندات Word باستخدام Aspose.Words لـ .NET من خلال هذا الدليل. تأكد من اتجاه النص الصحيح للمحتوى متعدد اللغات. +| [إضافة علامات Bidi في مستند Word](./add-bidi-marks/) تعرّف على كيفية إضافة علامات ثنائية الاتجاه (Bidi) في مستندات Word باستخدام Aspose.Words لـ .NET من خلال هذا الدليل. تأكد من اتجاه النص الصحيح للمحتوى متعدد اللغات. | | [استخدم حرف Tab لكل مستوى لتقسيم القائمة](./use-tab-character-per-level-for-list-indentation/) | تعلّم كيفية إنشاء قوائم متعددة المستويات مع مسافات بادئة مبوبة باستخدام Aspose.Words لـ .NET. اتبع هذا الدليل لتنسيق القوائم بدقة في مستنداتك. | | [استخدم حرف المسافة لكل مستوى لتجويف القائمة](./use-space-character-per-level-for-list-indentation/) | تعلّم كيفية إنشاء قوائم متعددة المستويات مع إضافة مسافة بادئة في Aspose.Words لـ .NET. دليل خطوة بخطوة لتنسيق المستندات بدقة. | - +| [حفظ ملف docx كـ txt – دليل كامل لتصدير معادلات Word إلى LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | تعلم كيفية حفظ مستندات docx كملفات txt وتصدير المعادلات إلى تنسيق LaTeX باستخدام Aspose.Words لـ .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/arabic/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/arabic/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..f2cf3254d8 --- /dev/null +++ b/words/arabic/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,246 @@ +--- +category: general +date: 2026-03-27 +description: احفظ ملف docx كملف txt باستخدام Aspose.Words وحوّل مستند Word إلى LaTeX. + تعلّم كيفية تصدير المعادلات، الحفاظ على النص العادي، والحصول على تنسيق LaTeX في + دقائق. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: ar +og_description: احفظ ملف docx كملف txt باستخدام Aspose.Words. يوضح هذا الدليل كيفية + تحويل Word إلى LaTeX، وتصدير المعادلات، والحفاظ على مستندك كنص عادي. +og_title: حفظ ملف docx كملف txt – تصدير معادلات Word إلى LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: حفظ ملف docx كملف txt – دليل كامل لتصدير معادلات Word إلى LaTeX +url: /ar/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# حفظ ملف docx كـ txt – تصدير معادلات Word إلى LaTeX + +هل احتجت يومًا إلى **حفظ ملف docx كـ txt** لكنك خفت من فقدان الرياضيات المتقدمة الموجودة داخل ملف Word؟ لست وحدك. في العديد من سير عمل البحث العلمي يكون الإصدار النصي البسيط للمستند أمرًا ضروريًا، ومع ذلك تريد أن تبقى المعادلات على شكل ترميز LaTeX نظيف. + +في هذا الدرس سنستعرض الخطوات الدقيقة **لتحويل Word إلى LaTeX** باستخدام Aspose.Words for .NET، بحيث يتم تصدير المعادلات بشكل صحيح بينما يتحول باقي المستند إلى نص عادي منظم. في النهاية ستعرف كيف **تصدّر المعادلات إلى LaTeX**، وتحافظ على باقي الملف كنص بسيط، وتتجنب المشكلات الشائعة التي تواجه المبتدئين. + +## ما ستتعلمه + +- كيفية تحميل ملف *.docx* يحتوي على Office Math. +- ضبط `TxtSaveOptions` بشكل صحيح لجعل Aspose ينتج LaTeX لكل معادلة. +- حفظ النتيجة كملف **save word plain text** يمكنك إدخاله في نظام التحكم بالإصدارات، خطوط أنابيب CI، أو أي أداة لاحقة. +- الحالات الخاصة الشائعة—ماذا تفعل عندما يخلط المستند بين الصور والمعادلات، أو عندما تحتاج إلى الحفاظ على أحرف Unicode. +- عينة كود كاملة جاهزة للتنفيذ يمكنك وضعها في تطبيق Console. + +### المتطلبات المسبقة + +- .NET 6.0 أو أحدث (الكود يعمل أيضًا مع .NET Framework 4.7+). +- نسخة مرخصة من **Aspose.Words for .NET** (الإصدار التجريبي المجاني يكفي للاختبار). +- Visual Studio 2022 أو أي بيئة تطوير تدعم تجميع مشاريع C#. +- مستند Word (`input.docx`) يحتوي بالفعل على بعض كائنات Office Math. + +> **نصيحة احترافية:** إذا لم تكن لديك رخصة بعد، يمكنك طلب مفتاح مؤقت من موقع Aspose—فقط استبدل العنصر النائب في الكود بمفتاحك قبل التشغيل. + +## الخطوة 1 – تثبيت Aspose.Words عبر NuGet + +أولًا: تحتاج إلى إضافة المكتبة إلى مشروعك. افتح **Package Manager Console** وشغّل الأمر التالي: + +```powershell +Install-Package Aspose.Words +``` + +هذا السطر الواحد يجلب لك كل ما تحتاجه، بما في ذلك مساحة الاسم `Saving` التي توجد فيها `TxtSaveOptions`. لا ملفات DLL إضافية، ولا تبعيات أصلية—فقط كود مُدار بالكامل. + +## الخطوة 2 – تحميل مستند Word المصدر + +الآن نقرأ فعليًا الملف الذي يحتوي على المعادلات. فئة `Document` تمثل بنية *.docx* بالكامل، لذا يمكنك التعامل معها ككائن عالي المستوى. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**لماذا هذا مهم:** تحميل المستند مبكرًا يتيح لك فحص شجرة العقد. إذا تخطيت الفحص وكان الملف لا يحتوي على معادلات، ستحصل على ملف txt نظيف—but لن تعرف لماذا يكون إخراج LaTeX فارغًا. + +## الخطوة 3 – تكوين TxtSaveOptions لتصدير LaTeX + +توفر Aspose تحكمًا دقيقًا في طريقة تصيير Office Math. عبر ضبط `OfficeMathExportMode` إلى `LaTeX`، تتحول كل معادلة إلى ما يعادلها في LaTeX بدلاً من إزالتها أو تحويلها إلى صورة. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**لماذا هذا مهم:** وضع التصدير الافتراضي سيحذف المعادلات تمامًا. التحويل إلى `LaTeX` يحافظ على النية الرياضية، وهو ما تحتاجه عندما تُدخل الملف لاحقًا إلى مُترجم LaTeX أو معالج markdown يدعم صيغة `$…$`. + +## الخطوة 4 – حفظ المستند كنص عادي + +مع ضبط الخيارات، يصبح حفظ الملف سطرًا واحدًا. سيُنتج ملف `.txt` حيث تظهر كل معادلة ككود LaTeX محاط بحدود `$` (يمكنك تعديل ذلك لاحقًا إذا فضلت كتل `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### النتيجة المتوقعة + +افتح `output.txt` في أي محرر وسترى شيئًا مشابهًا لـ: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +لاحظ كيف يبقى النص العادي كما هو، بينما تتحول المعادلات إلى سلاسل LaTeX صافية. يمكنك نسخها ولصقها مباشرةً في مستند LaTeX، أو دفتر Jupyter، أو أي أداة تُظهر الرياضيات. + +## الخطوة 5 – التعامل مع الحالات الخاصة + +### محتوى مختلط (صور + معادلات) + +إذا كان ملف Word يحتوي أيضًا على صور، سيتجاهلها Aspose عند استخدام `TxtSaveOptions`. هذا عادةً يكفي لسير عمل **save word plain text**، لكن إذا احتجت الصور كعناصر نائبة يمكنك: + +1. تصدير المستند إلى HTML أولًا (`HtmlSaveOptions`) لالتقاط الصور كوسوم ``. +2. تشغيل تمريرة ثانية باستخدام `TxtSaveOptions` للحصول على معادلات LaTeX. +3. دمج النتيجتين يدويًا أو عبر سكربت صغير. + +### رموز Unicode + +بعض المعادلات تستخدم أحرف Unicode خاصة (مثل الحروف اليونانية). ضبط `Encoding = Encoding.UTF8` في `TxtSaveOptions` (كما هو موضح في الخطوة 3) يضمن بقاء هذه الرموز بعد التحويل. + +### مستندات ضخمة + +للملفات الكبيرة (> 100 MB)، فكر في تنفيذ عملية الحفظ بطريقة تدفقية: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +التدفق يتجنب تحميل الإخراج بالكامل في الذاكرة، وهو ما قد ينقذك على عوامل بناء ذات ذاكرة محدودة. + +## مثال عملي كامل + +فيما يلي البرنامج الكامل الجاهز للنسخ واللصق الذي يجمع كل الخطوات. ما عليك سوى تعديل مسارات الملفات، وإذا كان لديك رخصة فأضف سطر الترخيص. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +شغّل البرنامج (`dotnet run` إذا كنت تستخدم مشروع Console) وتفقد `output.txt`. لقد قمت الآن **بحفظ ملف docx كـ txt** مع الحفاظ على كل معادلة كـ LaTeX—دون الحاجة إلى نسخ يدوي. + +## الأسئلة المتكررة + +**س: هل يمكنني تغيير الفاصل من `$…$` إلى `\(...\)`؟** +ج: نعم. بعد الحفظ، نفّذ استبدالًا بسيطًا على الملف: `output = output.Replace("$", @"\(").Replace("$", @"\)");`—احرص فقط على عدم استبدال علامات `$` الأصلية التي قد تكون جزءًا من النص. + +**س: هل يعمل هذا مع ملفات Word من 2007‑2019؟** +ج: بالتأكيد. يدعم Aspose.Words الصيغ `.doc`، `.docx`، `.docm`، وحتى عائلة `.dotx` الأحدث. الكود نفسه يعمل على جميع الإصدارات. + +**س: ماذا لو أردت الحفاظ على تنسيق الفقرات الأصلي (علامات التبويب، المسافات المتعددة)؟** +ج: اضبط `txtSaveOptions.PreserveTableLayout = true;` و `txtSaveOptions.PreserveSpace = true;` للحفاظ على الفراغات كما هي. + +## الخلاصة + +غطّينا كل ما تحتاجه **لحفظ ملف docx كـ txt** مع **تصدير المعادلات إلى LaTeX** باستخدام Aspose.Words. الخطوات الأساسية هي تحميل المستند، ضبط `TxtSaveOptions` بـ `OfficeMathExportMode.LaTeX`، ثم حفظ النتيجة. بهذه الثلاثة أسطر من الكود يمكنك بثقة **تحويل Word إلى LaTeX**، والحفاظ على مستندك كـ **save word plain text**، وتفادي فقدان الرموز الرياضية. + +هل أنت مستعد للتحدي التالي؟ جرّب ربط هذه العملية بمولد markdown لإنشاء ملف `.md` كامل يتضمن النص وLaTeX—مثالي لتوثيق مدعوم بـ Git أو مولّدات مواقع ثابتة. أو استكشف `PdfSaveOptions` من Aspose للحصول على نسخة PDF إلى جانب الملف النصي. + +إذا واجهتك أي صعوبات، اترك تعليقًا أدناه. برمجة سعيدة، واستمتع ببساطة تحويل معادلات Word إلى LaTeX نظيف! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/arabic/net/working-with-fonts/_index.md b/words/arabic/net/working-with-fonts/_index.md index f958b30423..b4328f22ad 100644 --- a/words/arabic/net/working-with-fonts/_index.md +++ b/words/arabic/net/working-with-fonts/_index.md @@ -26,28 +26,29 @@ | العنوان | الوصف | | --- | --- | | [تنسيق الخط](./font-formatting/) |تعرف على كيفية تنسيق الخطوط في مستندات Word باستخدام Aspose.Words for .NET من خلال دليل مفصل خطوة بخطوة. | -| [الحصول على تباعد أسطر الخط](./get-font-line-spacing/) تعلّم كيفية ضبط مسافات أسطر الخطوط باستخدام Aspose.Words لـ .NET من خلال هذا البرنامج التعليمي خطوة بخطوة. مثالي للمطورين. +| [الحصول على تباعد أسطر الخط](./get-font-line-spacing/) تعلّم كيفية ضبط مسافات أسطر الخطوط باستخدام Aspose.Words لـ .NET من خلال هذا البرنامج التعليمي خطوة بخطوة. مثالي للمطورين. | | [التحقق من تأثير نص DrawingML](./check-drawingml-text-effect/) تعرّف على كيفية التحقق من تأثيرات نص DrawingML في مستندات Word باستخدام Aspose.Words لـ .NET من خلال دليلنا المفصل خطوة بخطوة. حسّن مستنداتك بسهولة. | | [تعيين تنسيق الخط](./set-font-formatting/) | تعرّف على كيفية ضبط تنسيق الخط في مستندات Word باستخدام Aspose.Words لـ .NET. اتبع دليلنا المفصل خطوة بخطوة لتحسين أتمتة مستنداتك. | -| [تعيين علامة التأكيد على الخط](./set-font-emphasis-mark/) تعرّف على كيفية ضبط علامات توكيد الخطوط في مستندات Word باستخدام Aspose.Words لـ .NET من خلال هذا الدليل المفصل خطوة بخطوة. مثالي لمطوري .NET. -| [تعيين مجلدات الخطوط](./set-fonts-folders/) تعرّف على كيفية إعداد مجلدات خطوط مخصصة في Aspose.Words لـ .NET من خلال هذا الدليل الشامل خطوة بخطوة. مثالي للمطورين الذين يرغبون في تحسين خطوط المستندات. -| [تمكين تعطيل استبدال الخط](./enable-disable-font-substitution/) تعرّف على كيفية تفعيل أو تعطيل استبدال الخطوط في مستندات Word باستخدام Aspose.Words لـ .NET. تأكد من تناسق مستنداتك على جميع المنصات. +| [تعيين علامة التأكيد على الخط](./set-font-emphasis-mark/) تعرّف على كيفية ضبط علامات توكيد الخطوط في مستندات Word باستخدام Aspose.Words لـ .NET من خلال هذا الدليل المفصل خطوة بخطوة. مثالي لمطوري .NET. | +| [تعيين مجلدات الخطوط](./set-fonts-folders/) تعرّف على كيفية إعداد مجلدات خطوط مخصصة في Aspose.Words لـ .NET من خلال هذا الدليل الشامل خطوة بخطوة. مثالي للمطورين الذين يرغبون في تحسين خطوط المستندات. | +| [تمكين تعطيل استبدال الخط](./enable-disable-font-substitution/) تعرّف على كيفية تفعيل أو تعطيل استبدال الخطوط في مستندات Word باستخدام Aspose.Words لـ .NET. تأكد من تناسق مستنداتك على جميع المنصات. | | [تعيين إعدادات الخط الاحتياطي](./set-font-fallback-settings/) |تعرف على كيفية تعيين إعدادات استبدال الخط في Aspose.Words لـ .NET وتخصيص استبدال الخط في مستندات Word الخاصة بك. | | [تحميل إعدادات Noto الاحتياطية](./load-noto-fallback-settings/) | تعرّف على كيفية تحميل إعدادات Noto الاحتياطية في مستند Word باستخدام Aspose.Words لـ .NET. اتبع دليلنا خطوة بخطوة لضمان عرض جميع الأحرف بشكل صحيح. | -| [تعيين مثيلات مجلدات الخطوط الافتراضية](./set-fonts-folders-default-instance/) تعرّف على كيفية تعيين مجلدات الخطوط للنسخة الافتراضية في Aspose.Words لـ .NET من خلال هذا البرنامج التعليمي خطوة بخطوة. خصّص مستندات Word بسهولة. -| [تعيين مجلدات الخطوط مجلدات متعددة](./set-fonts-folders-multiple-folders/) تعرّف على كيفية تعيين مجلدات خطوط متعددة في مستندات Word باستخدام Aspose.Words لـ .NET. يضمن هذا الدليل التفصيلي استخدام مستنداتك للخطوط التي تحتاجها بالضبط. +| [تعيين مثيلات مجلدات الخطوط الافتراضية](./set-fonts-folders-default-instance/) تعرّف على كيفية تعيين مجلدات الخطوط للنسخة الافتراضية في Aspose.Words لـ .NET من خلال هذا البرنامج التعليمي خطوة بخطوة. خصّص مستندات Word بسهولة. | +| [تعيين مجلدات الخطوط مجلدات متعددة](./set-fonts-folders-multiple-folders/) تعرّف على كيفية تعيين مجلدات خطوط متعددة في مستندات Word باستخدام Aspose.Words لـ .NET. يضمن هذا الدليل التفصيلي استخدام مستنداتك للخطوط التي تحتاجها بالضبط. | | [تعيين نظام مجلدات الخطوط والمجلد المخصص](./set-fonts-folders-system-and-custom-folder/) |تعرف على كيفية تعيين مجلدات الخطوط المخصصة والنظامية في مستندات Word باستخدام Aspose.Words لـ .NET، مما يضمن عرض مستنداتك بشكل صحيح عبر بيئات مختلفة. | | [تعيين مجلدات الخطوط حسب الأولوية](./set-fonts-folders-with-priority/) | تعرّف على كيفية تحديد أولوية مجلدات الخطوط في مستندات Word باستخدام Aspose.Words لـ .NET. يضمن دليلنا عرض مستنداتك بشكل مثالي في كل مرة. | | [تعيين مجلد خطوط True Type](./set-true-type-fonts-folder/) | تعرّف على كيفية إعداد مجلد خطوط True Type في مستندات Word باستخدام Aspose.Words لـ .NET. اتبع دليلنا المفصل خطوة بخطوة لضمان إدارة متسقة للخطوط. | -| [تحديد الخط الافتراضي عند العرض](./specify-default-font-when-rendering/) تعرّف على كيفية تحديد خط افتراضي لعرض مستندات Word باستخدام Aspose.Words لـ .NET. احرص على تناسق مظهر المستندات على مختلف المنصات. -| [إعدادات الخط مع خيارات التحميل](./font-settings-with-load-options/) تعرّف على كيفية إدارة إعدادات الخطوط باستخدام خيارات التحميل في Aspose.Words لـ .NET. دليل خطوة بخطوة للمطورين لضمان تناسق مظهر الخطوط في مستندات Word. +| [تحديد الخط الافتراضي عند العرض](./specify-default-font-when-rendering/) تعرّف على كيفية تحديد خط افتراضي لعرض مستندات Word باستخدام Aspose.Words لـ .NET. احرص على تناسق مظهر المستندات على مختلف المنصات. | +| [إعدادات الخط مع خيارات التحميل](./font-settings-with-load-options/) تعرّف على كيفية إدارة إعدادات الخطوط باستخدام خيارات التحميل في Aspose.Words لـ .NET. دليل خطوة بخطوة للمطورين لضمان تناسق مظهر الخطوط في مستندات Word. | | [تعيين مجلد الخطوط](./set-fonts-folder/) |تعرف على كيفية تعيين مجلد خطوط مخصصة في Aspose.Words لـ .NET لضمان عرض مستندات Word الخاصة بك بشكل صحيح دون فقدان الخطوط. | | [إعدادات الخط الافتراضية](./font-settings-default-instance/) |في هذا البرنامج التعليمي، تعلم كيفية تكوين إعدادات الخط الافتراضية في مستند Word باستخدام Aspose.Words لـ .NET. | -| [احصل على قائمة الخطوط المتوفرة](./get-list-of-available-fonts/) اكتشف كيفية الحصول على قائمة بالخطوط المتاحة باستخدام Aspose.Words لـ .NET في هذا الدليل التعليمي المفصل خطوة بخطوة. طوّر مهاراتك في إدارة الخطوط. +| [احصل على قائمة الخطوط المتوفرة](./get-list-of-available-fonts/) اكتشف كيفية الحصول على قائمة بالخطوط المتاحة باستخدام Aspose.Words لـ .NET في هذا الدليل التعليمي المفصل خطوة بخطوة. طوّر مهاراتك في إدارة الخطوط. | | [تلقي إشعارات الخطوط](./receive-notifications-of-fonts/) |تعرف على كيفية تلقي إشعارات الخطوط المفقودة أو المستبدلة عند استخدام Aspose.Words لـ .NET. | | [تلقي إشعار تحذير](./receive-warning-notification/) |تعرف على كيفية تلقي إشعار تحذير عند استخدام Aspose.Words لـ .NET وإدارة أي مشكلات أو تحذيرات في مستنداتك. | | [مثال على مصدر خط Steam](./resource-steam-font-source-example/) |تعرف على كيفية استخدام مصدر خط Resource Stream لتحميل الخطوط المخصصة في Aspose.Words لـ .NET. | | [الحصول على الاستبدال بدون لاحقات](./get-substitution-without-suffixes/) |في هذا البرنامج التعليمي، تعلم كيفية الحصول على تجاوزات بدون لاحقات في مستند Word باستخدام Aspose.Words لـ .NET. | +| [استبدال خطوط Aspose – كيفية تكوين إعدادات الخط في C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) |تعرف على كيفية تكوين إعدادات الخط في Aspose.Words لـ .NET باستخدام C# لتفعيل أو تعطيل استبدال الخطوط. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/arabic/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/arabic/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..4cbd3daf37 --- /dev/null +++ b/words/arabic/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-03-27 +description: 'استبدال الخطوط في Aspose بسهولة: تعلم كيفية تكوين إعدادات الخط، التقاط + التحذيرات، ومعالجة الخطوط المفقودة في تطبيقات .NET الخاصة بك.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: ar +og_description: إتقان استبدال الخطوط في Aspose عن طريق تكوين إعدادات الخط ومعالجة + الخطوط المفقودة باستخدام رد نداء تحذيري. دليل كامل بلغة C#. +og_title: استبدال الخطوط في Aspose – تكوين إعدادات الخط في C# +tags: +- Aspose.Words +- C# +- Font Management +title: استبدال الخطوط في Aspose – كيفية تكوين إعدادات الخط في C# +url: /ar/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – دليل كامل لتكوين إعدادات الخطوط + +هل صادفت مستندًا يقوم فجأة باستبدال الخط المخصص الخاص بك بشيء عام؟ هذا هو **aspose font substitution** يقوم بعمله — استبدال الخطوط المفقودة بأقرب تطابق يمكنه العثور عليه. إنه مفيد، ولكن إذا كنت بحاجة إلى معرفة *بالضبط* أي خط تم استبداله، عليك الاستفادة من نظام التحذير في المكتبة وتكوين إعدادات الخطوط بنفسك. + +> **ما ستحتاجه** +> • .NET 6+ (or .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • A DOCX that references a missing font (we’ll call it `MissingFont.docx`) + +هيا نبدأ. + +--- + +## الخطوة 1: تثبيت Aspose.Words وتحضير المشروع + +قبل كتابة أي كود، تأكد من الإشارة إلى حزمة Aspose.Words: + +```bash +dotnet add package Aspose.Words +``` + +> **نصيحة احترافية:** استخدم أحدث نسخة مستقرة؛ حتى مارس 2026 الإصدار هو 23.11.0. الإصدارات الأحدث تحسن خوارزميات مطابقة الخطوط وتضيف أنواع تحذير إضافية. + +أنشئ تطبيقًا جديدًا من نوع console (أو ضع الكود في مشروع موجود) وأضف توجيهات `using` المعتادة: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +هذه المساحات الاسمية تمنحنا الوصول إلى `Document` و `LoadOptions` والفئات المتعلقة بالخطوط التي سنحتاجها. + +## الخطوة 2: تكوين إعدادات الخطوط باستخدام LoadOptions + +جوهر التحكم في **aspose font substitution** يكمن في `LoadOptions.FontSettings`. من خلال توفير كائن `FontSettings` فارغ نخبر Aspose باستخدام مسارات البحث الافتراضية *و* الإبلاغ عن أي استبدال عبر رد نداء التحذير. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +لماذا لا نكتفي بالإعدادات الافتراضية؟ لأن ربط رد نداء التحذير (الخطوة التالية) يعمل فقط عندما تكون خاصية `FontSettings` غير فارغة. هذه السطر الصغير يمنحنا نقطة ربط بعملية الاستبدال دون تغيير سلوك البحث الفعلي عن الخطوط. + +## الخطوة 3: ربط رد نداء التحذير لالتقاط عمليات الاستبدال + +Aspose.Words يطبق واجهة `IWarningCallback`. كلما حدث شيء جدير بالذكر — مثل خط مفقود — يستدعي طريقة `Warning` الخاصة بنا. سنقوم بتنفيذ معالج صغير يفلتر `WarningType.FontSubstitution` ويطبع الوصف. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +وهنا المعالج نفسه: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **لماذا هذا مهم** – بدون رد نداء التحذير، يقوم Aspose باستبدال الخطوط بصمت، ولن تعرف أي خط تم استخدامه. يجعل رد نداء التحذير العملية شفافة، وهو أمر أساسي لتقارير الامتثال أو لتصحيح مشكلات التخطيط. + +## الخطوة 4: تحميل المستند باستخدام الخيارات المكوَّنة + +الآن نقوم أخيرًا بتحميل المستند، مع تمرير `loadOptions` التي أعددناها للتو. إذا كان الملف المصدر يشير إلى خط غير مثبت، سيتفاعل معالجنا. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +استبدل `YOUR_DIRECTORY` بالمسار الفعلي حيث يوجد `MissingFont.docx`. عند تشغيل البرنامج، يجب أن ترى مخرجات مشابهة لـ: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +هذا السطر يخبرك بالضبط أي خط كان مفقودًا وأي خط بديل اختارته Aspose. + +## الخطوة 5: (اختياري) تحسين مسارات البحث عن الخطوط + +إذا كان لديك مجلد خاص يحتوي على خطوط الشركة، يمكنك إخبار Aspose بمكان البحث قبل أن يلجأ إلى خطوط النظام. هذا استخدام متقدم لـ **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +تعيين `recursive: true` يجعل Aspose يفحص المجلدات الفرعية أيضًا. الآن ستجرب المكتبة خطوطك الخاصة أولاً، مما يقلل من احتمال الاستبدال غير المرغوب. + +## مثال كامل يعمل + +بجمع كل شيء معًا، إليك البرنامج الكامل الجاهز للتنفيذ: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**المخرجات المتوقعة** (عند مواجهة خط مفقود): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +إذا كانت جميع الخطوط موجودة، يعمل البرنامج بصمت (بدون تحذيرات) ولا يزال ينتج ملف PDF. + +## أسئلة شائعة وحالات خاصة + +### ماذا لو أردت *منع* الاستبدال تمامًا؟ + +قم بتعيين `FontSettings.SubstitutionSettings` إلى `null` أو استخدم `FontSettings.FontSubstitutionSettings` للتحكم في السلوك. على سبيل المثال: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +الآن سيطرح Aspose استثناءً بدلاً من الاستبدال الصامت، ويمكن التقاطه ومعالجته. + +### هل يعمل هذا مع صيغ ملفات أخرى (مثل .doc، .rtf)؟ + +بالطبع. يمكن تمرير كائن `LoadOptions` نفسه إلى أي مُنشئ `Document` يقبل مسار ملف. سيُستدعى رد نداء التحذير لجميع الصيغ التي تعتمد على الخطوط. + +### هل يمكنني التقاط اسم الخط البديل *بالضبط*؟ + +نعم. يحتوي سلسلة `info.Description` على كل من الخط المفقود والبديل. إذا كنت بحاجة إلى الاسم برمجيًا، يمكنك تحليله أو استخدام كائن `FontInfo` (متاح في الإصدارات الأحدث). + +### كيف يتصرف هذا في بيئة متعددة الخيوط؟ + +`FontSettings` **ليس** آمنًا للمتعدد الخيوط. أنشئ `LoadOptions` منفصل (مع `FontSettings` الخاص به) لكل خيط، أو احمِ الوصول باستخدام قفل. + +## الخلاصة + +لقد غطينا كل ما تحتاجه لإتقان **aspose font substitution** و **configure font settings** في تطبيق C#: + +1. تثبيت Aspose.Words وإضافة توجيهات `using` اللازمة. +2. إنشاء كائن `LoadOptions` مع `FontSettings` جديد. +3. ربط `IWarningCallback` مخصص لعرض أحداث الاستبدال. +4. تحميل المستند، والسماح لرد نداء التحذير بالإبلاغ عن أي خطوط مفقودة. +5. (اختياري) توسيع مسار البحث أو تعطيل الاستبدال تمامًا. + +مع هذا النمط يمكنك تسجيل الخطوط المفقودة للامتثال، تنبيه المستخدمين في واجهة المستخدم، أو تضمين الخطوط البديلة تلقائيًا قبل النشر. بعد ذلك، قد تستكشف **سياسات استبدال خطوط Aspose.Words** أو تدمج سير العمل في خط أنابيب معالجة مستندات أكبر. + +برمجة سعيدة، ولتظهر مستنداتك دائمًا بالخط المناسب! + +--- + +![مخطط يوضح Aspose.Words يقوم بتحميل مستند، يستدعي FontSettings، يُطلق رد نداء التحذير، ويُخرج معلومات الاستبدال](image-placeholder.png "سير عمل استبدال خطوط Aspose") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/chinese/net/basic-conversions/_index.md b/words/chinese/net/basic-conversions/_index.md index b1a77577d3..9a10d06767 100644 --- a/words/chinese/net/basic-conversions/_index.md +++ b/words/chinese/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ | [如何从 Word 导出 LaTeX – 步骤指南](./how-to-export-latex-from-word-step-by-step-guide/) | 学习如何使用 Aspose.Words for .NET 将 Word 文档导出为 LaTeX，提供分步指南和代码示例，帮助开发者实现文档转换。| | [使用 Aspose.Words 将 Word 转换为 PDF（C#）指南](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | 学习如何使用 Aspose.Words for .NET 在 C# 中将 Word 文档转换为 PDF，提供分步指南和代码示例。| | [使用 Aspose.Words 将 Word 保存为 PDF – 完整 C# 指南](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | 学习如何使用 Aspose.Words for .NET 在 C# 中将 Word 文档保存为 PDF，提供完整的分步指南和代码示例。| +| [使用 Aspose.Words 将 Word 转换为 PDF – 完整指南](./convert-word-to-pdf-with-aspose-words-complete-guide/) | 学习如何使用 Aspose.Words for .NET 在 C# 中完整地将 Word 文档转换为 PDF，提供详细步骤和代码示例。| {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/chinese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/chinese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..7da7fa750a --- /dev/null +++ b/words/chinese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: 使用 Aspose.Words 快速将 Word 转换为 PDF。了解如何将 Word 保存为 PDF、将 docx 导出为 PDF，以及在 + C# 中生成可访问的 PDF。 +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: zh +og_description: 使用 Aspose.Words 在 C# 中将 Word 转换为 PDF。本指南展示了如何将 Word 保存为 PDF、将 docx + 导出为 PDF，以及生成可访问的 PDF。 +og_title: 使用 Aspose.Words 将 Word 转换为 PDF – 步骤指南 +tags: +- Aspose.Words +- C# +- PDF conversion +title: 使用 Aspose.Words 将 Word 转换为 PDF – 完整指南 +url: /zh/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 使用 Aspose.Words 将 Word 转换为 PDF – 完整指南 + +是否曾想过如何在不使用第三方网页工具的情况下**将 Word 转换为 PDF**？也许你正在构建一个自动化报告引擎，需要一种可靠的方式在运行时*将 Word 保存为 PDF*。好消息是 Aspose.Words 让整个过程轻而易举，甚至可以生成符合 **PDF/UA‑2** 标准的文件——完美满足可访问性需求。 + +在本教程中，我们将逐步演示所有必需的操作：加载 `.docx`，配置 PDF 选项以实现*导出 docx 为 pdf*并符合 PDF/UA 标准，最后将结果保存为可访问的 PDF。完成后，你将拥有一个自包含、可直接投入生产的代码片段，可在任何 .NET 项目中使用。 + +![使用 Aspose.Words 将 Word 转换为 PDF](convert-word-to-pdf.png) + +## 你将学到 + +- **为什么 Aspose.Words** 是 *生成可访问 pdf* 场景的可靠选择。 +- 实现 *将文档保存为 pdf* 并符合 PDF/UA‑2 标准的完整步骤。 +- 如何处理常见的边缘情况，如缺失字体或受密码保护的源文件。 +- 调试输出并验证可访问性合规性的快速技巧。 + +### 前置条件 + +- .NET 6 或更高版本（API 也支持 .NET Framework 4.6+）。 +- 有效的 Aspose.Words for .NET 许可证（免费试用可用于评估）。 +- 基础的 C# 知识——无需复杂的设计模式。 + +如果你已经满足以上条件，下面我们开始吧。 + +--- + +## 将 Word 转换为 PDF – 步骤实现 + +我们将解决方案拆分为五个清晰的步骤。每一步都有标题、简短的代码片段以及对*为何*该代码重要的解释。 + +### 步骤 1：加载要转换的 Word 文档 + +首先需要一个表示源文件的 `Document` 对象。Aspose.Words 能读取 **.docx**、**.doc**、**.rtf** 以及许多其他格式，因此无论文件最初是如何创建的，都可以*将 word 保存为 pdf*。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**为何这一步重要：** +- 提前加载文件可以在消耗 CPU 资源之前捕获缺失文件错误。 +- `Document` 类抽象了 Word 文件的内部结构，为你提供了干净的对象模型。 + +### 步骤 2：为可访问性配置 PDF 保存选项 + +如果需要*生成可访问 pdf*，必须告诉 Aspose.Words 生成符合 PDF/UA‑2 标准的文档。`PdfSaveOptions` 类让你对输出进行细粒度控制。 + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**为何这一步重要：** +- `PdfCompliance.PdfUa2` 指示库添加屏幕阅读器所依赖的标签、结构信息和元数据。 +- 嵌入字体 (`EmbedFullFonts = true`) 可防止在不同操作系统上打开 PDF 时出现“未找到字体”的警告。 +- 设置 `Title` 有助于辅助技术正确朗读文档标题。 + +### 步骤 3：将文档保存为 PDF + +在加载源文件并设置好选项后，实际转换只需一行代码。这就是*导出 docx 为 pdf*的地方。 + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**为何这一步重要：** +- `Save` 方法会遵循我们配置的 `PdfSaveOptions`，确保可访问性特性已嵌入。 +- 将调用包装在 `try/catch` 中，可记录或抛出常见的许可证或权限错误，帮助新手快速定位问题。 + +### 步骤 4：验证 PDF/UA 合规性（可选但推荐） + +虽然 Aspose.Words 已完成大部分工作，但在向政府机构或其他受监管的实体交付文档时，最好再次检查输出。 + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**为何这一步重要：** +- `IsTagged` 是一个快速的完整性检查；完整的 PDF/UA 验证需要专用验证器，但大多数合规问题都会表现为缺失标签。 +- 如果该标志返回 `false`，可以重新检查 `PdfSaveOptions`——可能忘记设置 `Compliance`，或源文档缺少正确的标题样式。 + +### 步骤 5：常见陷阱与专业提示 + +| 陷阱 | 会发生什么 | 解决办法 | +|---------|--------------|------------| +| **缺失字体** | PDF 中的文字显示为方框。 | 设置 `EmbedFullFonts = true` **或** 在服务器上安装缺失的字体。 | +| **未授权的库** | Aspose 在每页添加水印。 | 在应用程序启动时尽早加载许可证文件 (`Aspose.Words.lic`)，例如 `License license = new License(); license.SetLicense("Aspose.Words.lic");`。 | +| **受密码保护的源文件** | 在 `new Document(path)` 时抛出 `InvalidOperationException`。 | 使用重载 `new Document(path, new LoadOptions { Password = "secret" })`。 | +| **大文档导致 OOM** | 在处理超大文件时出现内存不足异常。 | 在 `PdfSaveOptions` 中启用 `MemoryOptimization` (`saveOptions.MemoryOptimization = true`)。 | +| **缺少可访问性标签** | PDF/UA 验证失败。 | 确保源 Word 文件使用正确的标题样式（`Heading 1`、`Heading 2` 等），Aspose 会自动映射这些样式为 PDF 标签。 | + +**专业提示：** 如果一次性批量转换大量文档，复用同一个 `PdfSaveOptions` 实例。只创建一次可以减少分配开销，保持内存占用低。 + +--- + +## 完整可运行示例（复制粘贴即用） + +下面是把所有步骤整合在一起的完整程序。将其保存为 `Program.cs`，添加 Aspose.Words 和 Aspose.PDF NuGet 包后运行。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**预期结果：** +在 `C:\MyFiles` 下会生成名为 `output.pdf` 的文件。使用 Adobe Acrobat 打开时，合规性面板会显示 “PDF/A‑2b, PDF/UA‑1”，证明你已经成功*将 word 转换为 pdf*。 + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/chinese/net/programming-with-markdownsaveoptions/_index.md b/words/chinese/net/programming-with-markdownsaveoptions/_index.md index 5c051cfedf..7d8d609bfa 100644 --- a/words/chinese/net/programming-with-markdownsaveoptions/_index.md +++ b/words/chinese/net/programming-with-markdownsaveoptions/_index.md @@ -49,7 +49,19 @@ ### [如何从 DOCX 导出 Markdown – 完整 C# 指南](./how-to-export-markdown-from-docx-complete-guide/) -使用 Aspose.Words for .NET 将 DOCX 文档导出为 Markdown，提供完整的 C# 示例和分步指南。 +使用 Aspose.Words for .NET 将 DOCX 文档导出为 Markdown，提供完整示例和分步指南。 + +### [如何从 Word 导出 LaTeX – 将 DOCX 转换为 Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) + +使用 Aspose.Words for .NET 将 Word 文档中的 LaTeX 导出为 Markdown，提供完整示例和分步指南。 + +### [从 Word 创建 Markdown – 完整 C# 指南](./create-markdown-from-word-full-c-guide/) + +使用 Aspose.Words for .NET 将 Word 文档创建为 Markdown，提供完整的 C# 示例和分步指南。 + +### [如何从 DOCX 导出 LaTeX – 转换为 Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) + +使用 Aspose.Words for .NET 将 DOCX 文档中的 LaTeX 导出为 Markdown，提供完整示例和分步指南。 {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/chinese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/chinese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..5d471ee526 --- /dev/null +++ b/words/chinese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,251 @@ +--- +category: general +date: 2026-03-27 +description: 使用 Aspose.Words C# 将 Word 转换为 Markdown。学习如何将 docx 转换为 markdown，提取 Word + 中的图片，以及如何在单个教程中使用回调。 +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: zh +og_description: 使用 Aspose.Words 将 Word 转换为 Markdown。本指南展示了如何将 docx 转换为 markdown、从 + Word 中提取图像，以及使用回调进行资源处理。 +og_title: 从 Word 创建 Markdown – 完整 C# 教程 +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: 从 Word 创建 Markdown – 完整 C# 指南 +url: /zh/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 从 Word 创建 Markdown – 完整 C# 教程 + +是否曾经需要 **从 Word 创建 markdown**，却不知从何入手？你并不孤单；许多开发者在尝试将 .docx 内容迁移到静态站点生成器或文档仓库时都会遇到这个难题。好消息是？使用 Aspose.Words，你可以 **将 docx 转换为 markdown**，把原始文件中的所有图片提取出来，并且精确控制这些资源的存放位置——只需一个简单的回调即可。 + +在本指南中，我们将通过一个真实案例演示如何从 Word 中提取图片、如何使用回调保存它们，以及为什么这种方式是自动化流水线中最可靠的方案。阅读完毕后，你将拥有一个可直接运行的 C# 程序，能够生成干净的 `.md` 文件以及一个存放提取图片的文件夹。 + +> **小技巧：** 如果你已经有包含截图、图表或徽标的 Word 模板，这种方法会在不需要手动复制粘贴的情况下完整保留每个视觉元素。 + +--- + +## 你需要准备的东西 + +- **.NET 6+**（或 .NET Framework 4.6+）。代码可在任何近期运行时上运行。 +- **Aspose.Words for .NET**（NuGet 包 `Aspose.Words`）。免费试用版已能满足大多数场景。 +- 一个包含文本和至少一张图片的 **Word 文档**（`input.docx`）。 +- 对 C# 和 Visual Studio（或你喜欢的 IDE）有基本了解。 + +不需要额外的库——其余全部由 Aspose.Words 自身处理。 + +--- + +## 第一步：创建项目并安装 Aspose.Words + +为了保持整洁，先新建一个控制台项目： + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **为什么这一步重要：** 安装 NuGet 包可确保你拥有最新的 API，其中包括在 22.9 版本中引入的 `MarkdownSaveOptions` 类。若没有它，你只能自行编写转换器。 + +--- + +## 第二步：加载源 Word 文档 + +下面的第一行代码打开你想要转换的 `.docx`。将 `YOUR_DIRECTORY` 替换为你机器上的实际路径。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **发生了什么？** `Document` 会解析文件，构建内部 DOM，并让每个段落、表格和图片都可访问。如果文件不存在，Aspose 会抛出明确的 `FileNotFoundException`，你可以捕获它以实现更友好的 UI。 + +--- + +## 第三步：使用资源保存回调配置 Markdown 保存选项 + +这里就是 **如何使用回调** 的关键所在。回调让你决定每个提取的图片保存到何处。 + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **为什么要使用回调？** 默认情况下，Aspose 会把图片以 base‑64 字符串嵌入 markdown，这对版本控制来说是噩梦。回调让你完全掌控文件名和文件夹结构。 + +--- + +## 第四步：将文档保存为 Markdown + +现在我们真正生成 `.md` 文件。所有图片都会交给下一步定义的回调处理。 + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +如果一切顺利，你将在目标文件夹中看到 `Document.md`，以及一个名为 `Resources` 的子文件夹，里面存放着从原始 Word 文件中提取的所有图片。 + +--- + +## 第五步：实现用于存储每张提取图片的回调 + +下面是 `MyResourceSaver` 的完整实现。它会创建 `Resources` 目录（如果不存在），为每张图片生成唯一文件名，并将图片流写入磁盘。 + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **参数说明：** +> - `args.Index` – 从零开始的计数器，保证唯一性。 +> - `args.FileName` – Aspose 建议的原始文件名（通常类似 `image001.png`）。 +> - `args.Stream` – 用于写入图片字节的输出流。 +> - `args.KeepResourceStreamOpen` – 设置为 `false`，让 Aspose 自动释放流，防止文件句柄泄漏。 + +--- + +## 完整可运行示例 + +将所有内容整合在一起，下面是一份可以直接复制到 `Program.cs` 的单文件代码。记得将 `YOUR_DIRECTORY` 替换为适合你环境的绝对或相对路径。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### 预期输出 + +- `YOUR_DIRECTORY/Document.md` – 一个包含标准 markdown 图片链接的文件，例如： + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – 包含 `img_0.png`、`img_1.jpg` 等文件，顺序对应原始 Word 文档中出现的顺序。 + +运行程序后会打印友好的确认信息，告知过程已成功完成。 + +--- + +## 常见问题解答 (FAQ) + +### 如何在不损失质量的情况下从 Word 提取图片？ + +回调直接将原始二进制流写入文件，保留原始分辨率。除非你在 `ResourceSaving` 中自行加入图像处理逻辑，否则不会进行任何转换或压缩。 + +### 能否在提取时更改图片格式（例如 PNG → JPEG）？ + +完全可以。在 `ResourceSaving` 中检查 `args.FileName` 或 `args.Stream`，使用 `System.Drawing` 或 `ImageSharp` 加载图片后重新编码，然后再写入。别忘了相应地更新 markdown 链接的扩展名。 + +### 如果需要 markdown 文件引用 CDN 而不是本地文件夹怎么办？ + +修改回调，在 markdown 链接前添加基础 URL。你可以在上传图片到 CDN 后，将 `args.FileName` 设置为完整的 URL。 + +### 这能否处理表格、脚注或其他高级 Word 功能？ + +可以。Aspose.Words 会将大多数 Word 构造转换为 markdown 等价物。表格会变成 markdown 表格，脚注会变成引用链接，甚至嵌套列表也能优雅处理。如果出现异常，请查看最新的发行说明——Aspose 持续提升转换精度。 + +### 如何在 CI/CD 流水线中转换 docx 为 markdown？ + +只需在构建步骤中加入编译好的 `.exe`，指向生成的 `.docx` 构件，然后将生成的 `.md` 与 `Resources/` 文件夹推送到你的静态站点仓库。由于过程完全确定性，十分适合自动化环境。 + +--- + +## 结语 + +我们已经演示了如何使用 Aspose.Words **从 Word 创建 markdown**，完整覆盖了 **将 docx 转换为 markdown** 的工作流，并展示了使用自定义 **回调** 提取图片的实用方法。最终得到的是一个干净的 markdown 文件配合原始图片文件夹——非常适合文档站点、静态博客或任何偏好纯文本格式的工作流。 + +后续可考虑的方向： + +- **批量处理** 文件夹中的多个 `.docx`（使用 `Directory.GetFiles` 循环）。 +- **自定义图片命名规则**（例如使用原始标题文字）。 +- **后处理** markdown，将图片链接替换为 CDN URL。 +- 探索 **其他 Aspose 导出格式** 如 HTML、PDF、EPUB，以实现多渠道发布。 + +还有其他问题或遇到难以转换的 Word 文件？在下方留言，我们一起排查。祝编码愉快，享受将 Word 转换为 markdown 的简洁体验！ + +--- + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/chinese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/chinese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..6144cb2d00 --- /dev/null +++ b/words/chinese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,264 @@ +--- +category: general +date: 2026-03-27 +description: 如何使用 Aspose.Words 从 DOCX 导出 LaTeX。学习将 DOCX 转换为 Markdown、设置 DPI 并在 C# + 中启用恢复。 +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: zh +og_description: 如何使用 Aspose.Words 从 DOCX 导出 LaTeX。本教程展示了逐步转换为 Markdown、DPI 控制和恢复模式。 +og_title: 如何从 DOCX 导出 LaTeX – 转换为 Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: 如何从 DOCX 导出 LaTeX – 转换为 Markdown +url: /zh/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何从 DOCX 导出 LaTeX – 转换为 Markdown + +是否曾想过 **如何从 DOCX 导出 LaTeX** 而不失去公式的美感？你并不孤单。根据我的经验，最大的问题是将 OfficeMath 对象转换为干净、可移植的格式，以供静态站点生成器或科学博客使用。 + +在本指南中，我们将演示如何使用 Aspose.Words 将 DOCX 转换为 Markdown，同时展示 **如何设置 DPI**、**如何启用恢复**，以及一些实用技巧，以构建坚固的流水线。完成后，你将拥有一个完整的 C# 程序，能够生成包含 LaTeX 公式、高分辨率图片以及正确超链接处理的 Markdown 文件。 + +## 您需要的环境 + +- **.NET 6+**（或 .NET Framework 4.7.2 – API 的行为相同） +- **Aspose.Words for .NET**（截至 2026 年 3 月的最新稳定版本） +- 包含公式、图片和链接的 DOCX 文件 +- Visual Studio、VS Code 或任意你喜欢的编辑器 + +除 Aspose.Words 外无需额外的 NuGet 包，但如果不是使用试用版，请确保拥有有效许可证。 + +## 第 1 步 – 使用严格恢复模式加载 DOCX + +在考虑导出之前，必须确保源文档没有隐藏的损坏。这正是 **如何启用恢复** 发挥作用的地方。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**为什么使用严格恢复？** +如果让 Aspose 静默修复问题，可能会导致段落缺失或图片损坏——在导出 LaTeX 时没人愿意看到这种情况。通过快速失败，你可以提前捕获问题，决定是修复源 DOCX 还是记录问题以供后续处理。 + +### 小技巧 +将加载代码放在 try/catch 中并记录 `DocumentLoadingException`。这样你的 CI 流水线可以在不阻塞整个构建的情况下标记出有问题的文件。 + +## 第 2 步 – 配置 Markdown 导出选项 + +文档已安全加载到内存后，接下来配置保存方式。这是 **如何导出 latex** 的核心，同时涵盖 **如何设置 DPI** 以处理嵌入的图片。 + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**每个选项的作用** + +| 选项 | 原因 | 与关键词的关联 | +|--------|--------|-----------------------| +| `OfficeMathExportMode = LaTeX` | 直接回答 **如何导出 latex**（从公式） | 主要关键词 | +| `ImageResolution = 300` | 控制图像质量——对应 **如何设置 dpi** 的答案 | 次要 | +| `ResourceSavingCallback` | 将嵌入文件保存到磁盘，这是在 **convert docx to markdown** 时的常见需求 | 次要 | +| `EmptyParagraphExportMode` | 确保 Markdown 输出干净，防止出现杂散的 HTML 标签 | 提升整体转换质量 | +| `LinkExportMode = AsReference` | 使链接易于阅读和编辑，对 **convert docx to markdown** 也是一个加分项 | | + +## 第 3 步 – 实现自定义资源保存器（可选但实用） + +在将 DOCX 转换为 Markdown 时，图片和其他二进制资源需要写入文件系统。Aspose 通过 `IResourceSavingCallback` 让你自行控制。上面的代码片段已经展示了最小实现，下面我们逐步解析： + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**为什么要这样做？** +如果跳过此步骤，Aspose 会把图片以 base‑64 字符串嵌入 Markdown，导致文件体积膨胀，版本控制也会变得困难。将资源保存到单独的文件夹，可保持 Markdown 轻量，并且对 Hugo、Jekyll 等静态站点生成器友好。 + +## 第 4 步 – 将文档保存为 Markdown + +所有繁重的工作已经完成。只需一行代码即可写出最终文件。 + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +打开 `output.md`，你会看到： + +- 公式渲染为 `$…$` LaTeX 块 +- 图片引用为 `![Alt text](resources/image001.png)`，分辨率为 300 dpi +- 超链接转换为引用样式： + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +这就是整个 **how to convert docx** 过程的简要概述。 + +## 常见问题与边缘情况 + +### 1️⃣ 如果 DOCX 包含不受支持的对象怎么办？ +Aspose.Words 会抛出 `FeatureNotSupportedException`。由于我们在严格模式下使用了 **如何启用恢复**，异常会立即显现。你可以： + +- 将 `RecoveryMode` 切换为 `RecoveryMode.Default`，进行最佳努力的转换，**或** +- 在运行转换器之前预处理 DOCX（例如，删除不受支持的 SmartArt）。 + +### 2️⃣ 能否为每张图片单独设置 DPI？ +`ImageResolution` 设置是全局的。若需对单张图片进行控制，可实现自定义的 `ImageSavingCallback`（类似 `MyResourceSaver`），并根据 `args.ImageFileName` 或元数据调整 `args.ImageResolution`。 + +### 3️⃣ 如何在 Jekyll 站点中嵌入生成的 LaTeX？ +Jekyll 内置的 MathJax 支持开箱即用。只需确保布局中包含 MathJax 脚本，并且 LaTeX 块使用 `$$` 包裹显示公式，或使用 `$` 包裹行内公式。 + +### 4️⃣ 这在 Linux 上的 .NET Core 环境中兼容吗？ +完全兼容。Aspose.Words 是跨平台的。只需确保 `YOUR_DIRECTORY` 路径遵循 Linux 约定（例如 `/home/user/docs`）。 + +## 完整可运行示例 + +下面是一段可直接复制粘贴的程序。将 `YOUR_DIRECTORY` 替换为你机器上的实际路径。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**预期输出** – 打开 `output.md`，你应该会看到类似如下内容： + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +如果在支持 MathJax 的 Markdown 预览中打开该文件，积分符号将正确渲染 + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/chinese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/chinese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..b96fb8de15 --- /dev/null +++ b/words/chinese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,209 @@ +--- +category: general +date: 2026-03-27 +description: 如何使用 Aspose.Words 从 Word 文档导出 LaTeX —— 将 DOCX 转换为带有 LaTeX 公式的 Markdown。 +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: zh +og_description: 如何从 Word 文档导出 LaTeX 已在第一句中说明，向您展示如何将带有公式的 DOCX 转换为使用 LaTeX 的 Markdown。 +og_title: 如何从 Word 导出 LaTeX——完整指南 +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: 如何从 Word 导出 LaTeX – 将 DOCX 转换为 Markdown +url: /zh/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何从 Word 导出 LaTeX – 将 DOCX 转换为 Markdown + +是否曾想过 **如何从 Word 文件导出 LaTeX** 而不产生一堆 PNG？你并不是唯一遇到这个问题的人；开发者在需要用于静态站点或科学博客的干净、可编辑的公式时经常碰壁。好消息是？使用 Aspose.Words，你可以 **将 Word 转换为 Markdown**，并将每个 OfficeMath 对象保留为原生 LaTeX——无需后处理。 + +在本教程中，我们将完整演示 **将 Word 文档保存为 Markdown** 并 **将公式导出为 LaTeX** 的全过程。结束时，你将拥有可运行的 C# 代码片段、每个选项的清晰说明，以及处理复杂公式或混合内容等边缘情况的技巧。无需外部工具，只需一个 NuGet 包和几行代码。 + +## 所需条件 + +- .NET 6+（或 .NET Framework 4.7.2 及更高）——最新的运行时效果最佳。 +- Visual Studio 2022 或任何能够编译 C# 项目的编辑器。 +- Aspose.Words for .NET 许可证（免费试用版可用于实验）。 +- 包含至少一个公式（OfficeMath）的 DOCX 文件。 + +如果你已经具备这些条件，太好了——让我们开始吧。 + +## 如何从 Word 导出 LaTeX – 概览 + +下面是涉及步骤的高级视图： + +1. **Install** the Aspose.Words NuGet package. +2. **Load** the source `.docx` that holds your equations. +3. **Configure** `MarkdownSaveOptions` so that `OfficeMathExportMode` is set to `LaTeX`. +4. **Save** the document as a `.md` file. +5. **Verify** that the generated Markdown contains LaTeX blocks (`$$…$$`). + +![展示从 DOCX 到 Markdown 且包含 LaTeX 公式的流程图](how-to-export-latex.png){alt="如何从 Word 导出 LaTeX 的示意图"} + +## 步骤 1 – 安装 Aspose.Words for .NET（将 Word 转换为 Markdown） + +首先，你需要能够完成核心工作的库。打开终端（或 Package Manager Console）并运行： + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **专业提示：** 如果你使用 Visual Studio，右键单击项目 → *管理 NuGet 包* → 搜索 “Aspose.Words” 并安装最新的稳定版本。 + +为什么这很重要：Aspose.Words 抽象了 Open XML 格式，为你提供了干净的 API 来操作 Word 文档，而无需自行处理底层 XML。它还内置了将 OfficeMath 转换为 LaTeX 的支持，这正是我们 **export equations as LaTeX** 需求的核心。 + +## 步骤 2 – 加载 DOCX（如何转换 docx） + +现在库已经就位，加载你想要转换的文件。将 `YOUR_DIRECTORY` 替换为你的 `.docx` 所在路径： + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **为什么要这样加载？** `Document` 构造函数会将整个文件解析为对象模型，让你立即访问段落、表格以及——最重要的——OfficeMath 对象。如果文件缺失或损坏，Aspose 会抛出描述性的 `FileNotFoundException`，你可以捕获它以实现优雅的错误处理。 + +## 步骤 3 – 配置 MarkdownSaveOptions（将公式导出为 LaTeX） + +魔法发生在 `MarkdownSaveOptions` 对象中。默认情况下 Aspose 会将公式渲染为 PNG 图像，但我们想要 LaTeX。将 `OfficeMathExportMode` 设置为 `LaTeX`： + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +关于可选标志的简要说明：`ExportImagesAsBase64` 告诉 Aspose 不要嵌入二进制数据，从而保持 Markdown 的整洁。`ExportHeadersFooters` 确保不会丢失可能位于这些区域的上下文——当页眉包含标题或作者姓名时非常有用。 + +## 步骤 4 – 保存文档（将 Word 保存为 Markdown） + +最后，将转换后的内容写入 `.md` 文件： + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +运行此行后，你会在源文件旁边找到 `output.md`。用任意文本编辑器打开它，你应该会看到类似下面的 LaTeX 块： + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +这就是 **save word as markdown** 的全部步骤——无需额外的转换步骤。 + +## 步骤 5 – 验证结果（将公式导出为 LaTeX） + +验证常常被忽视，但一次快速的合理性检查可以省去后续的数小时。运行一个简单脚本读取生成的文件并打印第一个 LaTeX 块： + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +如果看到 `First LaTeX block: $$ … $$` 被打印，说明你已经成功 **exported LaTeX** 从 Word。否则，请再次确认源文档确实包含 OfficeMath 对象；普通文本公式不会被转换。 + +## 处理常见的边缘情况 + +| 场景 | 需要注意的点 | 推荐的解决方案 | +|----------|-------------------|-----------------| +| **混合图片和公式** | Aspose 可能仍会为非 OfficeMath 的图形嵌入图片。 | 将 `ExportImagesAsBase64 = false` 并将图片保留为外部文件，然后在 Markdown 中手动引用。 | +| **复杂的嵌套公式** | 深度嵌套可能生成需要手动调整的 LaTeX。 | 使用 LaTeX 格式化工具（如 `latexindent`）后处理块，或调整 `mdOptions` → `ExportMathAsDisplay = true`。 | +| **大型文档** | 加载巨大的 `.docx` 文件时内存使用会激增。 | 使用 `LoadOptions` 并设置 `LoadFormat.Docx`，如可用则启用流式加载 (`LoadOptions.LoadFormat` streaming)。 | +| **缺少许可证** | 免费试用版会在输出中添加水印注释。 | 通过 `License license = new License(); license.SetLicense("Aspose.Words.lic");` 应用有效许可证。 | + +这些技巧可以让你的工作流更加稳健，尤其是在生产流水线中 **convert word to markdown** 时。 + +## 完整工作示例（所有步骤在一个文件中） + +下面是一个自包含的控制台应用程序示例，你可以直接复制粘贴到新的 .NET 项目中并立即运行。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +运行程序，打开 `output.md`，你将看到公式以干净的 LaTeX 形式呈现。这就是 **how to export latex** 从 Word 文档的完整答案。 + +## 结论 + +我们已逐步展示了 **how to export LaTeX** 从 Word 的全过程，演示了如何 **convert Word to markdown**、**save word as markdown**，以及使用 Aspose.Words **export equations as LaTeX**。核心思路很简单：加载 DOCX，调整 `MarkdownSaveOptions`，让库完成繁重的工作。 + +如果你准备自动化文档流水线，尝试将此代码与 Hugo 或 Jekyll 等静态站点生成器串联——只需将生成的 `.md` 文件推送到仓库，站点即可重新构建。进一步阅读可参考 Aspose 的 “Export to LaTeX” 指南，尝试 `HtmlSaveOptions` 进行网页预览，或深入 `DocumentVisitor` API 实现自定义转换。 + +对边缘情况、许可证或 CI/CD 集成有疑问？在下方留言吧，祝编码愉快！ + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/chinese/net/programming-with-pdfsaveoptions/_index.md b/words/chinese/net/programming-with-pdfsaveoptions/_index.md index cc048035e4..10ad4c0553 100644 --- a/words/chinese/net/programming-with-pdfsaveoptions/_index.md +++ b/words/chinese/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ Aspose.Words for .NET 教程“使用 PdfSaveOptions 进行文字处理”将引 | [更新 PDF 文档中的最后打印属性](./update-last-printed-property/) 通过我们的分步指南了解如何使用 Aspose.Words for .NET 更新 PDF 文档中最后打印的属性。| | [在 PDF 文档中渲染 3D DML 3DEffects](./dml-3deffects-rendering/) | 通过本全面的分步指南了解如何使用 Aspose.Words for .NET 在 PDF 文档中呈现令人惊叹的 3D DML 效果。| | [在 PDF 文档中插入图像](./interpolate-images/) 学习如何使用 Aspose.Words for .NET 在 PDF 文档中插入图像，并遵循我们的分步指南。轻松提升 PDF 图像质量。| - +| [使用 Aspose.Words 将 DOCX 保存为 PDF 的分步指南](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) 通过本分步指南了解如何使用 Aspose.Words for .NET 将 DOCX 文档保存为 PDF。| {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/chinese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/chinese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..46d4f8e81a --- /dev/null +++ b/words/chinese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,195 @@ +--- +category: general +date: 2026-03-27 +description: 学习如何使用 Aspose.Words 将 DOCX 文件保存为 PDF。包括将 docx 转换为 pdf、使用选项保存 pdf，以及处理浮动形状。 +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: zh +og_description: 如何使用 Aspose.Words 将 DOCX 文件保存为 PDF。本指南展示了将 docx 转换为 pdf、使用选项保存 pdf，以及处理浮动形状。 +og_title: 如何将 DOCX 保存为 PDF – 完整的 Aspose.Words 教程 +tags: +- Aspose.Words +- C# +- PDF conversion +title: 如何使用 Aspose.Words 将 DOCX 保存为 PDF – 步骤指南 +url: /zh/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何使用 Aspose.Words 将 DOCX 保存为 PDF – 完整教程 + +是否曾想过 **如何在不丢失浮动形状布局的情况下** 将 Word 文档保存为 PDF？你并不是唯一有此需求的人。在许多项目中——发票生成器、报告导出器或简单的文档归档工具——开发者都需要一种可靠的方式将 DOCX 转换为 PDF，并保持在 Word 中的显示效果完全一致。 + +在本教程中，我们将演示使用 **Aspose.Words for .NET** 将 DOCX 文件转换为 PDF 的完整过程，展示 **如何使用自定义保存选项将 docx 转换为 pdf**，并解释 `ExportFloatingShapesAsInlineTag` 标志为何重要。完成后，你将拥有一段可直接运行的代码片段，能够根据你的需求保存带有选项的 PDF。 + +## 你将学到的内容 + +- 使用 Aspose.Words **将 word document pdf** 的完整步骤。 +- 如何配置 `PdfSaveOptions` 将浮动形状视为内联标签。 +- 处理浮动对象时的常见陷阱以及规避方法。 +- 一个完整、可运行的 C# 程序，直接可放入任意 .NET 项目中。 + +> **先决条件：** 你需要一份 Aspose.Words for .NET 许可证（或免费评估版）以及 .NET 开发环境（Visual Studio、Rider 或 `dotnet` CLI）。 + +## 第一步：创建项目并添加 Aspose.Words + +首先，创建一个新的控制台应用（或在已有项目中添加），并引用 Aspose.Words NuGet 包。 + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **小技巧：** 如果你在 CI 服务器上运行，建议固定包版本（`Aspose.Words --version 24.10`），以确保构建可复现。 + +## 第二步：加载包含浮动形状的 DOCX + +浮动图片、文本框或 SmartArt 在转换时可能导致布局偏移。加载文档本身很简单，但我们还会检查文件是否存在，以防止运行时出现 `FileNotFoundException`。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +注意 `Console.WriteLine` 语句——它们可以在终端运行时为你提供快速反馈。 + +## 第三步：配置 PDF 保存选项（Save PDF with Options） + +这一步是关键。默认情况下，Aspose.Words 会尝试保留浮动对象的原始位置，这可能会破坏生成的 PDF 布局。将 `ExportFloatingShapesAsInlineTag` 设置为 `true`，即可让库将这些形状视为内联标签，确保它们锚定在周围文本上。 + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +这有什么意义？想象一下一个悬浮在段落上方的文本框。如果不进行内联标签转换，PDF 可能会把段落向下推，甚至把文本框裁剪掉。该标志保持了视觉关系——这是专业报告中一个细微但关键的细节。 + +## 第四步：将文档保存为 PDF + +现在我们真正写出 PDF 文件。`Save` 方法同时接受输出路径和我们刚才设置的选项。 + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +运行程序后，会在与你的源 DOCX 相同的文件夹中生成 `output.pdf`。使用任意 PDF 阅读器打开，你应该会看到所有浮动形状都准确地出现在它们应该在的位置。 + +## 完整可运行示例 + +下面是一整段程序代码。复制粘贴到 `Program.cs`（或任意 C# 文件）后，按 **F5** 运行。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### 预期结果 + +- **文件已创建：** `output.pdf` 位于目标目录。 +- **布局保真度：** 浮动形状（图片、文本框、SmartArt）与周围文本保持内联。 +- **无异常：** 程序优雅退出，并在控制台打印状态信息。 + +## 常见问题与边缘情况 + +| 问题 | 答案 | +|----------|--------| +| **如果需要更高的图像质量怎么办？** | 设置 `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **能否批量转换多个 DOCX 文件？** | 将加载/保存逻辑包装在 `foreach (var file in Directory.GetFiles(..., "*.docx"))` 循环中。为提升性能，复用同一个 `PdfSaveOptions` 实例。 | +| **这在 .NET Core 上能用吗？** | 完全可以。Aspose.Words 24.x 支持 .NET Standard 2.0+，因此可以在 Windows、Linux 或 macOS 上运行相同代码。 | +| **如何处理受密码保护的 DOCX 文件？** | 使用 `new Document(inputPath, new LoadOptions { Password = "mySecret" })` 加载。保存时同样使用 `PdfSaveOptions`。 | +| **内联标签转换对复杂表格安全么？** | 大多数情况下是安全的，但非常复杂、形状重叠的表格可能仍需手动微调。批量迁移前请先对代表性样本进行测试。 | + +## 实际项目中的技巧 + +- **使用日志而非仅 `Console.WriteLine`** —— 在生产环境中，用日志框架（Serilog、NLog）替代控制台输出，以捕获错误信息。 +- **释放资源** —— `Document` 实现了 `IDisposable`。如果要处理大量文件，请将其放入 `using` 块，以及时释放内存。 +- **验证 PDF** —— 若需归档级别的 PDF，可使用 PDF 验证工具（如 PDF/A 合规检查器）进行校验。 +- **并行处理** —— 对于大批量任务，可考虑使用 `Parallel.ForEach`，并为每个线程克隆一个线程安全的 `PdfSaveOptions`，以加速转换。 + +## 结论 + +我们已经介绍了 **如何使用 Aspose.Words 将 DOCX 保存为 PDF**，演示了 **如何使用自定义选项将 docx 转换为 pdf**，并解释了 `ExportFloatingShapesAsInlineTag` 的影响。完整的可运行示例表明，你只需几行代码即可 **convert word document pdf**，并且能够 **save pdf with options**，满足项目的质量和合规需求。 + +准备好迎接下一个挑战了吗？尝试使用 `document.Save("output.html")` 导出为其他格式（如 HTML、EPUB），或实验 PDF/A 合规以实现长期归档。加载、配置选项、保存——这些原则在所有格式转换中都通用。 + +祝编码愉快，愿你的 PDF 始终如你所愿！ + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/chinese/net/programming-with-shapes/_index.md b/words/chinese/net/programming-with-shapes/_index.md index 002ffc72ad..c6bf090d9c 100644 --- a/words/chinese/net/programming-with-shapes/_index.md +++ b/words/chinese/net/programming-with-shapes/_index.md @@ -34,7 +34,7 @@ Aspose.Words for .NET 教程“使用形状进行文字处理”提供了在 Wor | [检测智能艺术形状](./detect-smart-art-shape/) 这份全面的指南将帮助您了解如何使用 Aspose.Words for .NET 检测 Word 文档中的 SmartArt 形状。非常适合自动化您的文档工作流程。| | [更新智能艺术绘图](./update-smart-art-drawing/) 学习如何使用 Aspose.Words for .NET 更新 Word 文档中的 Smart Art 绘图，并遵循本分步指南。确保您的视觉效果始终准确无误。| | [使用 Aspose.Words 在 Word 中创建矩形形状](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) 通过本分步指南学习如何使用 Aspose.Words for .NET 在 Word 文档中创建矩形形状。| - +| [创建 Word 文档 C# – 添加带阴影的形状](./create-word-document-c-add-shape-with-shadow/) 通过本分步指南学习如何使用 Aspose.Words for .NET 在 Word 文档中添加带阴影的形状。| {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/chinese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/chinese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..10167a2988 --- /dev/null +++ b/words/chinese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-03-27 +description: 使用 C# 创建 Word 文档，学习如何添加形状、为形状应用阴影以及设置阴影距离。Aspose.Words 的分步指南。 +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: zh +og_description: 使用 C# 创建 Word 文档，添加矩形形状和自定义阴影。请按照本完整教程设置阴影距离和样式。 +og_title: 使用 C# 创建 Word 文档 – 添加带阴影的形状 +tags: +- Aspose.Words +- C# +- Document Automation +title: 使用 C# 创建 Word 文档 – 添加带阴影的形状 +url: /zh/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 创建 Word 文档 C# – 添加带阴影的形状 + +是否曾需要 **create word document c#** 包含一个精美的矩形？也许你正在构建报告模板，并希望使用细微的投影阴影来提升布局效果。在本教程中，我们将逐步演示——如何添加形状、为形状应用阴影，甚至使用 Aspose.Words 调整阴影距离。 + +我们将从空白文档开始，放入一个矩形，给它一个预设阴影，最后保存文件。完成后，你将拥有一个可直接在 Word 中打开并立即看到效果的 .docx 文件。无需外部工具，仅使用纯 C# 代码。 + +## 前提条件 + +- .NET 6（或任何近期的 .NET Framework）已安装。 +- Visual Studio 2022 或带有 C# 扩展的 VS Code。 +- Aspose.Words for .NET NuGet 包（`Aspose.Words` 版本 23.12 或更高）。 + 你可以通过包管理控制台添加： + + ```powershell + Install-Package Aspose.Words + ``` + +就这些——不需要额外的 DLL 或 COM 互操作。 + +## 第一步：初始化新文档和 Builder – *create word document c#* 基础 + +首先我们需要一个代表 Word 文件的 `Document` 对象以及用于编辑它的 `DocumentBuilder`。 + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **为什么这一步重要：** `Document` 类是所有 Word 部分（页面、样式、图像）的容器。Builder 是高级 API，抽象掉低层节点操作，使得 **create word document c#** 变得轻松，无需直接处理 XML。 + +## 第二步：插入矩形形状 – *how to create rectangle* + +现在我们将在页面上放置一个矩形。尺寸以点为单位（1 pt ≈ 1/72 in）。 + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **小技巧：** 如果需要不同的形状，只需将 `ShapeType.Rectangle` 替换为 `ShapeType.Ellipse`、`ShapeType.Triangle` 等。相同的代码同样适用于 **how to add shape** 的任何类型。 + +## 第三步：应用预设阴影并微调 – *apply shadow to shape* + +Aspose.Words 附带了多种预设阴影格式。我们将使用 `Preset1`，随后自定义距离、模糊、透明度和颜色。 + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **为什么要自定义阴影？** `Distance` 属性控制阴影相对于矩形的距离——可以把它想象成 3D 渲染中的“升起”。修改 `BlurRadius` 可以软化边缘，而 `Transparency` 则让阴影更为细腻、专业。这满足了 **set shadow distance** 的需求，并展示了如何以灵活的方式 **apply shadow to shape**。 + +## 第四步：保存文档 – *create word document c#* 完成 + +最后，将文档写入磁盘。请将路径调整为你拥有写入权限的文件夹。 + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +在 Microsoft Word 中打开生成的文件，你会看到一个淡蓝色的矩形，带有 5 pt 偏移的柔和灰色阴影。这正是你成功 **create word document c#** 并为形状添加样式的可视化证明。 + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# 示例，显示带阴影的矩形"} + +## 可选变体与边缘情况 + +| 场景 | 更改内容 | 重要原因 | +|----------|----------------|----------------| +| **不同的阴影样式** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | 在不增加额外代码的情况下，提供更具戏剧性的外观。 | +| **无预设 – 自定义阴影** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | 完全控制方向和深度。 | +| **多个形状** | Call `builder.InsertShape` again before saving. | 适用于包含图标、徽标等的复杂模板。 | +| **兼容旧版 Aspose** | Use `ShadowEffect` class (available in v20.x). | 确保代码在旧版项目中运行。 | +| **保存为 PDF** | `document.Save("ShadowShape.pdf");` | 在 PDF 输出中保持相同的阴影渲染。 | + +> **常见问题：** *如果阴影在 Word 中未显示怎么办？* +> 确保使用的是近期版本的 Aspose.Words（≥ 22.9）。旧版本对阴影的支持有限。同时确认文档在较新的 Word 版本（2016+）中打开。 + +## 完整工作示例 + +下面是完整的、可直接复制粘贴的程序。它包含所有 `using` 指令、注释以及错误处理，以确保顺畅体验。 + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +运行程序，导航到 `C:\Temp\ShadowShape.docx`，即可看到我们配置的精确阴影矩形。 + +## 回顾与后续步骤 + +- 现在你已经掌握了如何 **create word document c#**、插入矩形，并使用自定义 **set shadow distance** **apply shadow to shape**。 +- 示例使用 Aspose.Words，抽象掉了 OpenXML 的复杂性，并保证在不同 Word 版本间渲染一致。 +- 想进一步探索？尝试组合多个形状、在矩形内部添加文本，或将同一文档导出为 PDF，观察阴影的表现。 + +### 相关主题您可能感兴趣 + +- **How to add shape** 到页眉/页脚用于品牌标识。 +- 使用 **Aspose.Words** 编程方式插入图表和表格。 +- 为图片而非矢量形状自定义 **shadow effects**。 +- 自动批量生成发票或证书等文档。 + +随意实验、破坏代码，然后重新构建——这是内化概念的最快方式。如果遇到问题，请在下方留言或查阅官方 Aspose.Words 文档获取更深入的 API 见解。 + +祝编码愉快，享受让你的 Word 文件更具精致感的过程！ + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/chinese/net/programming-with-txtsaveoptions/_index.md b/words/chinese/net/programming-with-txtsaveoptions/_index.md index 77cad7f527..578b4400a3 100644 --- a/words/chinese/net/programming-with-txtsaveoptions/_index.md +++ b/words/chinese/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Aspose.Words for .NET 教程将引导您了解该库在处理 Word 文档方面 | [在 Word 文档中添加双向标记](./add-bidi-marks/) 本指南将指导您如何使用 Aspose.Words for .NET 在 Word 文档中添加双向 (Bidi) 标记。确保多语言内容的文本方向正确。| | [每级使用制表符进行列表缩进](./use-tab-character-per-level-for-list-indentation/) 了解如何使用 Aspose.Words for .NET 创建带有制表符缩进的多级列表。请遵循本指南，在文档中设置精确的列表格式。| | [每级使用空格字符进行列表缩进](./use-space-character-per-level-for-list-indentation/) 了解如何在 Aspose.Words for .NET 中创建带有空格字符缩进的多级列表。精确文档格式的分步指南。| - +| [将 docx 保存为 txt – 导出 Word 方程到 LaTeX 的完整指南](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) 本教程展示如何使用 Aspose.Words for .NET 将 Word 文档中的公式导出为 LaTeX 格式的 txt 文件。| {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/chinese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/chinese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..72c26f44de --- /dev/null +++ b/words/chinese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,244 @@ +--- +category: general +date: 2026-03-27 +description: 使用 Aspose.Words 将 docx 保存为 txt 并将 Word 转换为 LaTeX。了解如何导出公式、保留纯文本，并在几分钟内获取 + LaTeX 标记。 +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: zh +og_description: 使用 Aspose.Words 将 docx 保存为 txt。本指南展示了如何将 Word 转换为 LaTeX、导出公式，并保持文档为纯文本。 +og_title: 将 docx 保存为 txt – 导出 Word 方程为 LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: 将 docx 保存为 txt —— 导出 Word 方程到 LaTeX 的完整指南 +url: /zh/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 将 docx 保存为 txt – 导出 Word 方程为 LaTeX + +是否曾经需要 **save docx as txt**，但担心会失去 Word 文件中那些精美的数学公式？你并不孤单。在许多科学工作流中，文档的纯文本版本是必需的，但你仍希望方程以干净的 LaTeX 标记形式保留下来。 + +在本教程中，我们将逐步演示如何使用 Aspose.Words for .NET **convert Word to LaTeX**，以便方程能够正确导出，而文档的其余部分则转换为整洁的纯文本。完成后，你将了解如何 **export equations to LaTeX**，将文件的其余部分保持为简单文本，并避免新手常遇到的陷阱。 + +## 你将学到 + +- 如何加载包含 Office Math 的 *.docx* 文件。 +- 设置正确的 `TxtSaveOptions` 以使 Aspose 为每个公式输出 LaTeX。 +- 将结果保存为 **save word plain text** 文件，以便可以将其输入版本控制、CI 流水线或任何下游工具。 +- 常见的边缘情况——当文档混合图像和公式，或需要保留 Unicode 字符时该怎么办。 +- 完整的、可直接运行的代码示例，可直接放入控制台应用程序中。 + +### 前置条件 + +- .NET 6.0 或更高版本（代码同样适用于 .NET Framework 4.7+）。 +- 拥有 **Aspose.Words for .NET** 的授权副本（免费试用可用于测试）。 +- Visual Studio 2022 或任何能够编译 C# 项目的 IDE。 +- 一个已经包含一些 Office Math 对象的 Word 文档（`input.docx`）。 + +> **Pro tip:** 如果你还没有许可证，可以从 Aspose 网站请求临时密钥——在运行之前，只需将代码中的占位符替换为你的密钥。 + +## 第一步 – 通过 NuGet 安装 Aspose.Words + +首先，你需要在项目中加入该库。打开 **Package Manager Console** 并运行： + +```powershell +Install-Package Aspose.Words +``` + +这行代码会拉取所有必需的内容，包括 `TxtSaveOptions` 所在的 `Saving` 命名空间。无需额外的 DLL，也没有本地依赖——仅仅是纯托管代码。 + +## 第二步 – 加载源 Word 文档 + +现在我们实际读取包含公式的文件。`Document` 类抽象了整个 *.docx* 结构，使你可以将其视为高级对象模型。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Why this matters:** 及早加载文档可以让你检查其节点树。如果跳过检查而文件中没有公式，你仍会得到一个干净的 txt 文件——但你不会知道 LaTeX 输出为何为空。 + +## 第三步 – 为 LaTeX 导出配置 TxtSaveOptions + +Aspose 为你提供了对 Office Math 渲染方式的细粒度控制。将 `OfficeMathExportMode` 设置为 `LaTeX`，每个公式都会转换为其对应的 LaTeX 代码，而不是被剥离或转为图像。 + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Why this matters:** 默认的导出模式会完全丢弃公式。切换为 `LaTeX` 可保留数学意图，这正是当你随后将文件输入 LaTeX 编译器或支持 `$…$` 语法的 markdown 处理器时所需要的。 + +## 第四步 – 将文档保存为纯文本 + +配置好选项后，保存文件只需一行代码。输出将是一个 `.txt` 文件，其中每个公式以 LaTeX 代码形式出现，并被 `$` 分隔符包围（如果你更喜欢 `\[` … `\]` 块，可以稍后更改）。 + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### 预期结果 + +在任意编辑器中打开 `output.txt`，你会看到类似如下内容： + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +请注意，普通文本保持原样，而公式现在是纯 LaTeX 字符串。你可以直接将它们复制粘贴到 LaTeX 文档、Jupyter notebook，或任何能够渲染数学的工具中。 + +## 第五步 – 处理边缘情况 + +### 混合内容（图像 + 公式） + +如果你的 Word 文件还包含图像，使用 `TxtSaveOptions` 时 Aspose 会忽略它们。这对于 **save word plain text** 工作流通常没有问题，但如果你需要将图像作为占位符，可以： + +1. 首先将文档导出为 HTML（`HtmlSaveOptions`），以捕获图像为 `` 标签。 +2. 使用 `TxtSaveOptions` 再次处理，以获取 LaTeX 公式。 +3. 手动或使用小脚本合并这两个结果。 + +### Unicode 符号 + +某些公式使用特殊的 Unicode 字符（例如希腊字母）。在 `TxtSaveOptions` 中设置 `Encoding = Encoding.UTF8`（如第 3 步所示），可确保这些符号在转换后仍然保留。 + +### 大型文档 + +对于大文件（> 100 MB），可以考虑使用流式保存操作： + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +流式处理可以避免将整个输出加载到内存中，这在内存有限的构建代理上尤为重要。 + +## 完整工作示例 + +下面是完整的、可直接复制粘贴的程序，将所有步骤串联起来。只需替换文件路径，并在有许可证时填写许可证行。 + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +运行程序（如果使用控制台项目则执行 `dotnet run`），并检查 `output.txt`。你已经 **saved docx as txt**，同时保留了所有公式的 LaTeX 表示——无需手动复制粘贴。 + +## 常见问题 + +**Q: 我可以将分隔符从 `$…$` 改为 `\(...\)` 吗？** +A: 可以。保存后，对文件进行简单的替换：`output = output.Replace("$", @"\(").Replace("$", @"\)");`——但要注意不要替换原始文本中本身的 `$` 字符。 + +**Q: 这适用于 Word 2007‑2019 文件吗？** +A: 当然。Aspose.Words 支持 `.doc`, `.docx`, `.docm`, 甚至更新的 `.dotx` 系列。相同的代码在所有版本中均可运行。 + +**Q: 如果我需要保留原始段落格式（制表符、多个空格）怎么办？** +A: 设置 `txtSaveOptions.PreserveTableLayout = true;` 和 `txtSaveOptions.PreserveSpace = true;` 以保持空白字符不变。 + +## 结论 + +我们已经介绍了使用 Aspose.Words **save docx as txt** 并 **exporting equations to LaTeX** 所需的全部内容。关键步骤是加载文档、使用 `OfficeMathExportMode.LaTeX` 配置 `TxtSaveOptions`，以及保存结果。通过这三行代码，你可以可靠地 **convert word to latex**，将文档保持为 **save word plain text**，并避免令人头疼的数学符号丢失。 + +准备好接受下一个挑战了吗？尝试将此工作流与 markdown 生成器链式结合，生成包含文本和 LaTeX 的完整 `.md` 文件——非常适合基于 Git 的文档或静态站点生成器。或者探索 Aspose 的 `PdfSaveOptions`，同时获取 PDF 版本和纯文本文件。 + +如果遇到任何问题，请在下方留言。祝编码愉快，尽情享受将 Word 公式转换为干净 LaTeX 的简便吧！ + +![保存 DOCX 为 TXT 并带有 LaTeX 公式的示意图](placeholder-image.png "save docx as txt 示例") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/chinese/net/working-with-fonts/_index.md b/words/chinese/net/working-with-fonts/_index.md index 4edfb64b65..ccf7f809c7 100644 --- a/words/chinese/net/working-with-fonts/_index.md +++ b/words/chinese/net/working-with-fonts/_index.md @@ -48,6 +48,7 @@ | [接收警告通知](./receive-warning-notification/) 了解如何在使用 Aspose.Words for .NET 时接收警告通知并管理文档中的任何问题或警告。| | [资源 Steam 字体源示例](./resource-steam-font-source-example/) 了解如何使用资源流字体源将自定义字体加载到 Aspose.Words for .NET 中。| | [获取不带后缀的替换](./get-substitution-without-suffixes/) 在本教程中，学习如何使用 Aspose.Words for .NET 在 Word 文档中获取无后缀覆盖。| +| [Aspose 字体替换 – 如何在 C# 中配置字体设置](./aspose-font-substitution-how-to-configure-font-settings-in-c/) 了解如何使用 Aspose.Words for .NET 在 C# 中配置字体替换设置，确保文档正确显示所需字体。| {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/chinese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/chinese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..9dc9c1fb41 --- /dev/null +++ b/words/chinese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-03-27 +description: Aspose 字体替换轻松实现：学习如何配置字体设置、捕获警告以及在 .NET 应用程序中处理缺失的字体。 +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: zh +og_description: 通过配置字体设置并使用警告回调处理缺失字体，精通 Aspose 字体替换。完整 C# 指南。 +og_title: Aspose 字体替换 – 在 C# 中配置字体设置 +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose 字体替换 – 如何在 C# 中配置字体设置 +url: /zh/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – 完整配置字体设置指南 + +是否曾遇到文档突然将您自定义的字体替换为通用字体？这就是 **aspose font substitution** 正在发挥作用——用它能找到的最接近的匹配字体替换缺失的字体。它很方便，但如果您需要*准确*知道被替换的字体是哪一个，您必须调用库的警告系统并自行配置字体设置。 + +在本教程中，我们将演示一个真实场景：加载一个引用了您未安装字体的 DOCX，捕获字体替换事件，并在控制台打印友好的信息。完成后，您将熟悉 **configure font settings**、设置 **Aspose.Words warning callback**，以及如何扩展示例以适配任何工作流。 + +> **您需要的条件** +> • .NET 6+（或 .NET Framework 4.7.2+） +> • Aspose.Words for .NET（最新 NuGet 包） +> • 一个引用了缺失字体的 DOCX（我们称之为 `MissingFont.docx`） + +让我们开始吧。 + +--- + +## 第一步：安装 Aspose.Words 并准备项目 + +在编写任何代码之前，请确保已引用 Aspose.Words 包： + +```bash +dotnet add package Aspose.Words +``` + +> **专业提示：** 使用最新的稳定版本；截至 2026 年 3 月，它是 23.11.0。更新的版本改进了字体匹配算法并添加了额外的警告类型。 + +创建一个新的控制台应用程序（或将代码放入现有项目），并添加常用的 `using` 指令： + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +这些命名空间让我们能够访问 `Document`、`LoadOptions` 以及我们需要的与字体相关的类。 + +## 第二步：使用 LoadOptions 配置字体设置 + +**aspose font substitution** 控制的核心位于 `LoadOptions.FontSettings`。通过提供一个空的 `FontSettings` 对象，我们告诉 Aspose 使用默认的搜索路径 *并* 通过警告回调报告任何替换。 + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +为什么不直接使用默认设置？因为只有当 `FontSettings` 属性非空时，才能附加警告回调（下一步）。这行代码为我们提供了一个钩子，以捕获替换过程，而不改变实际的字体搜索行为。 + +## 第三步：附加警告回调以捕获替换 + +Aspose.Words 实现了 `IWarningCallback` 接口。每当出现值得注意的情况——例如缺失字体时——它会调用我们的 `Warning` 方法。我们将实现一个小型处理器，过滤 `WarningType.FontSubstitution` 并打印描述信息。 + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +下面是处理器本身： + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **为什么这很重要** —— 如果没有回调，Aspose 会悄悄替换字体，您永远不知道使用了哪种字体。回调使过程透明化，这对于合规报告或调试布局问题至关重要。 + +## 第四步：使用配置好的选项加载文档 + +现在我们终于加载文档，传入刚才准备好的 `loadOptions`。如果源文件引用了未安装的字体，我们的处理器将被触发。 + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +将 `YOUR_DIRECTORY` 替换为 `MissingFont.docx` 所在的实际路径。运行程序后，您应该会看到类似以下的输出： + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +该行精确指示了缺失的字体以及 Aspose 选择的替代字体。 + +## 第五步：（可选）微调字体搜索路径 + +如果您有包含公司字体的私有文件夹，可以告诉 Aspose 在回退到系统字体之前先搜索该文件夹。这是 **configure font settings** 的高级用法： + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +将 `recursive: true` 设置为递归搜索，使 Aspose 也会扫描子文件夹。现在库会优先尝试您的私有字体，从而降低不必要的替换概率。 + +## 完整工作示例 + +将所有内容组合在一起，下面是完整的、可直接运行的程序： + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**预期输出**（当遇到缺失字体时）： + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +如果所有字体都已存在，程序将静默运行（无警告），并仍然生成 PDF。 + +## 常见问题与边缘情况 + +### 如果我需要*完全阻止*替换怎么办？ + +将 `FontSettings.SubstitutionSettings` 设置为 `null`，或使用 `FontSettings.FontSubstitutionSettings` 来控制行为。例如： + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +现在 Aspose 将抛出异常，而不是悄悄进行替换，您可以捕获并处理该异常。 + +### 这是否适用于其他文件格式（例如 .doc、.rtf）？ + +当然可以。相同的 `LoadOptions` 对象可以传递给任何接受文件路径的 `Document` 构造函数。对于所有依赖字体的格式，警告回调都会触发。 + +### 我能捕获*精确*的替代字体名称吗？ + +可以。`info.Description` 字符串同时包含缺失的字体和替代字体。如果需要以编程方式获取名称，可以解析该字符串或使用 `FontInfo` 对象（在新版本中可用）。 + +### 在多线程环境下它如何表现？ + +`FontSettings` **不**是线程安全的。为每个线程创建单独的 `LoadOptions`（并拥有各自的 `FontSettings`），或使用锁来保护访问。 + +## 结论 + +我们已经覆盖了在 C# 应用程序中掌握 **aspose font substitution** 和 **configure font settings** 所需的全部内容： + +1. 安装 Aspose.Words 并添加必要的 `using` 语句。 +2. 创建一个带有全新 `FontSettings` 的 `LoadOptions` 对象。 +3. 附加自定义的 `IWarningCallback` 以显示替换事件。 +4. 加载文档，让回调报告任何缺失的字体。 +5. （可选）扩展搜索路径或完全禁用替换。 + +有了此模式，您可以记录缺失的字体以满足合规要求，在 UI 中提醒用户，或在发布前自动嵌入备用字体。接下来，您可以探索 **Aspose.Words font substitution policies**，或将工作流集成到更大的文档处理管道中。 + +祝编码愉快，愿您的文档始终使用正确的字体渲染！ + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/czech/net/basic-conversions/_index.md b/words/czech/net/basic-conversions/_index.md index 923bae116a..4e12c81fa7 100644 --- a/words/czech/net/basic-conversions/_index.md +++ b/words/czech/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ Základní konverze vás provede základními konverzemi dokumentů pomocí knih | [Jak exportovat LaTeX z Wordu – krok za krokem](./how-to-export-latex-from-word-step-by-step-guide/) | Naučte se, jak pomocí Aspose.Words pro .NET exportovat obsah Wordu do formátu LaTeX. Praktický průvodce s ukázkovým kódem. | | [Převod Wordu do PDF v C# pomocí Aspose.Words – Průvodce](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Naučte se, jak převést dokument Word do PDF pomocí Aspose.Words v C#. Praktický návod s ukázkovým kódem. | | [Uložit Word jako PDF pomocí Aspose.Words – Kompletní průvodce C#](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Naučte se, jak pomocí Aspose.Words převést dokument Word do PDF v C# s podrobným návodem a ukázkovým kódem. | +| [Převést Word do PDF pomocí Aspose.Words – Kompletní průvodce](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Naučte se, jak pomocí Aspose.Words převést dokument Word do PDF v .NET s podrobným návodem a ukázkovým kódem. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/czech/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/czech/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..49b4f5853a --- /dev/null +++ b/words/czech/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Rychle převádějte Word do PDF pomocí Aspose.Words. Naučte se, jak uložit + Word jako PDF, exportovat DOCX do PDF a generovat přístupné PDF v C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: cs +og_description: Převod Wordu na PDF v C# pomocí Aspose.Words. Tento průvodce ukazuje, + jak uložit Word jako PDF, exportovat DOCX do PDF a vytvořit přístupné PDF. +og_title: Převod Wordu do PDF pomocí Aspose.Words – krok za krokem +tags: +- Aspose.Words +- C# +- PDF conversion +title: Převod Wordu do PDF pomocí Aspose.Words – kompletní průvodce +url: /cs/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Převod Wordu na PDF pomocí Aspose.Words – Kompletní průvodce + +Už jste se někdy zamýšleli, jak **převést Word na PDF** bez používání třetích stran na webu? Možná budujete automatizovaný engine pro reporty a potřebujete spolehlivý způsob, jak *uložit word jako pdf* za běhu. Dobrou zprávou je, že Aspose.Words celý proces zjednodušuje a můžete dokonce vytvořit soubor **PDF/UA‑2** kompatibilní – ideální pro požadavky na přístupnost. + +V tomto tutoriálu projdeme vše, co potřebujete: načtení souboru `.docx`, nastavení možností PDF tak, aby *export docx to pdf* byl v souladu s PDF/UA, a nakonec uložení výsledku jako přístupného PDF. Na konci budete mít samostatný, připravený k nasazení úryvek kódu, který můžete vložit do libovolného .NET projektu. + +![Převod Wordu na PDF pomocí Aspose.Words](convert-word-to-pdf.png) + +## Co se naučíte + +- **Proč je Aspose.Words** solidní volbou pro scénáře *generate accessible pdf*. +- Přesné kroky k *save document as pdf* s kompatibilitou PDF/UA‑2. +- Jak zvládnout běžné okrajové případy, jako jsou chybějící fonty nebo soubory chráněné heslem. +- Rychlé tipy pro ladění výstupu a ověření souladu s přístupností. + +### Požadavky + +- .NET 6 nebo novější (API funguje také na .NET Framework 4.6+). +- Platná licence Aspose.Words pro .NET (zdarma zkušební verze stačí pro hodnocení). +- Základní znalost C# – žádné složité vzory nejsou potřeba. + +Pokud máte tyto podmínky splněny, pojďme na to. + +--- + +## Převod Wordu na PDF – Krok za krokem + +Rozdělíme řešení do pěti jasných kroků. Každý krok má nadpis, krátký úryvek kódu a vysvětlení *proč* je kód důležitý. + +### Krok 1: Načtěte Word dokument, který chcete převést + +Prvním krokem je získat objekt `Document`, který představuje zdrojový soubor. Aspose.Words čte **.docx**, **.doc**, **.rtf** a mnoho dalších formátů, takže můžete *save word as pdf* bez ohledu na to, jak byl soubor původně vytvořen. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Proč je to důležité:** +- Načtení souboru hned na začátku vám umožní zachytit chyby chybějícího souboru dříve, než zbytečně spotřebujete CPU. +- Třída `Document` abstrahuje vnitřní strukturu Word souboru a poskytuje čistý objektový model pro další práci. + +### Krok 2: Nastavte možnosti uložení PDF pro přístupnost + +Pokud potřebujete *generate accessible pdf* soubory, musíte Aspose.Words říct, aby vytvořil dokument kompatibilní s PDF/UA‑2. Třída `PdfSaveOptions` vám dává detailní kontrolu nad výstupem. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Proč je to důležité:** +- `PdfCompliance.PdfUa2` říká knihovně, aby přidala potřebné značky, strukturu a metadata, na které spoléhají čtečky obrazovky. +- Vkládání fontů (`EmbedFullFonts = true`) zabraňuje varování „font not found“ při otevření PDF na jiném OS. +- Nastavení `Title` pomáhá asistenčním technologiím správně oznámit dokument. + +### Krok 3: Uložte dokument jako PDF + +Jakmile je zdroj načten a možnosti nastaveny, samotná konverze je jednorázový řádek. Zde se provádí *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Proč je to důležité:** +- Metoda `Save` respektuje `PdfSaveOptions`, které jsme nakonfigurovali, a zajišťuje, že funkce přístupnosti jsou zahrnuty. +- Zabalení volání do `try/catch` blokuje vám možnost zalogovat nebo zobrazit chyby licence či oprávnění, které často nováčky překvapí. + +### Krok 4: Ověřte kompatibilitu PDF/UA (volitelné, ale doporučené) + +I když Aspose.Words udělá těžkou práci, je dobré výstup dvakrát zkontrolovat, zejména když dodáváte dokumenty vládním úřadům nebo jiným regulovaným subjektům. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Proč je to důležité:** +- `IsTagged` je rychlá kontrola; úplná validace PDF/UA vyžaduje specializovaný validátor, ale většina problémů se projeví chybějícími značkami. +- Pokud vrátí `false`, můžete se vrátit k `PdfSaveOptions` – možná jste zapomněli nastavit `Compliance` nebo zdrojový dokument postrádal správné styly nadpisů. + +### Krok 5: Časté problémy a tipy pro profesionály + +| Problém | Co se stane | Jak opravit | +|---------|--------------|------------| +| **Chybějící fonty** | Text se v PDF zobrazuje jako krabice. | Nastavte `EmbedFullFonts = true` **nebo** nainstalujte chybějící fonty na server. | +| **Nelicencovaná knihovna** | Aspose přidá vodoznak na každou stránku. | Načtěte licenční soubor (`Aspose.Words.lic`) co nejdříve v aplikaci (např. `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Zdroj chráněný heslem** | `InvalidOperationException` při `new Document(path)`. | Použijte přetížení `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Velké dokumenty způsobují OOM** | Výjimka out‑of‑memory u obrovských souborů. | Aktivujte `MemoryOptimization` v `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Chybějící značky přístupnosti** | Validace PDF/UA selže. | Ujistěte se, že zdrojový Word soubor používá správné styly nadpisů (`Heading 1`, `Heading 2` atd.) – Aspose je automaticky mapuje na PDF značky. | + +**Tip pro profesionály:** Pokud převádíte mnoho dokumentů najednou, znovu použijte jedinou instanci `PdfSaveOptions`. Vytvoření jednou snižuje alokační režii a udržuje nízkou paměťovou stopu. + +--- + +## Kompletní funkční příklad (připravený ke zkopírování) + +Níže je kompletní program, který spojuje všechny kroky. Uložte jej jako `Program.cs`, přidejte NuGet balíčky Aspose.Words a Aspose.PDF a spusťte. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Očekávaný výsledek:** +Soubor s názvem `output.pdf` se objeví v `C:\MyFiles`. Po otevření v Adobe Acrobat se v panelu kompatibility zobrazí „PDF/A‑2b, PDF/UA‑1“, což potvrzuje, že jste úspěšně *convert word to pdf*. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/czech/net/programming-with-markdownsaveoptions/_index.md b/words/czech/net/programming-with-markdownsaveoptions/_index.md index 2f80977c12..0d87e060e4 100644 --- a/words/czech/net/programming-with-markdownsaveoptions/_index.md +++ b/words/czech/net/programming-with-markdownsaveoptions/_index.md @@ -32,6 +32,9 @@ Zpracování textu pomocí MarkdownSaveOptions je podrobný návod, který vás | [Exportovat Markdown z Wordu – kompletní průvodce v C#](./how-to-export-markdown-from-word-complete-c-guide/) | Naučte se, jak exportovat Markdown z Wordu pomocí kompletního průvodce v C#. | | [Jak uložit Markdown z DOCX – krok za krokem průvodce](./how-to-save-markdown-from-docx-step-by-step-guide/) | Naučte se krok za krokem ukládat soubory DOCX jako Markdown pomocí Aspose.Words pro .NET. | | [Jak exportovat Markdown z DOCX – Kompletní průvodce](./how-to-export-markdown-from-docx-complete-guide/) | Naučte se, jak exportovat Markdown z DOCX pomocí kompletního průvodce. | +| [Jak exportovat LaTeX z Wordu – převod DOCX do Markdownu](./how-to-export-latex-from-word-convert-docx-to-markdown/) | Naučte se, jak exportovat LaTeX z dokumentů Word do formátu Markdown pomocí Aspose.Words pro .NET. | +| [Jak exportovat LaTeX z DOCX – převod do Markdownu](./how-to-export-latex-from-docx-convert-to-markdown/) | Naučte se, jak exportovat LaTeX z souborů DOCX do formátu Markdown pomocí Aspose.Words pro .NET. | +| [Vytvořte markdown z Wordu – Kompletní průvodce v C#](./create-markdown-from-word-full-c-guide/) | Kompletní průvodce v C# pro vytvoření markdownu z dokumentů Word pomocí Aspose.Words. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/czech/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/czech/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..f658663012 --- /dev/null +++ b/words/czech/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,252 @@ +--- +category: general +date: 2026-03-27 +description: Vytvořte markdown z Wordu pomocí Aspose.Words C#. Naučte se převádět + docx na markdown, extrahovat obrázky z Wordu a jak použít callback v jednom tutoriálu. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: cs +og_description: Vytvořte markdown z Wordu pomocí Aspose.Words. Tento průvodce ukazuje, + jak převést docx na markdown, extrahovat obrázky z Wordu a použít zpětné volání + pro správu zdrojů. +og_title: Vytvořte Markdown z Wordu – Kompletní C# tutoriál +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Vytvořte markdown z Wordu – kompletní průvodce C# +url: /cs/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Vytvořit markdown z Wordu – Kompletní C# tutoriál + +Už jste někdy potřebovali **vytvořit markdown z Wordu**, ale nevedeli jste, kde začít? Nejste v tom sami; mnoho vývojářů narazí na tuto překážku, když se snaží převést obsah ze souboru .docx do generátoru statických stránek nebo repozitáře dokumentace. Dobrá zpráva? S Aspose.Words můžete **převést docx na markdown**, vyjmout všechny obrázky z původního souboru a přesně určit, kam tyto zdroje umístíte — vše pomocí jednoduchého callbacku. + +V tomto průvodci projdeme reálný příklad, který vám ukáže, jak extrahovat obrázky z Wordu, jak použít callback pro jejich uložení a proč je tento přístup nejspolehlivější pro automatizační pipeline. Na konci budete mít připravený spustitelný C# program, který vytvoří čistý soubor `.md` a složku s extrahovanými obrázky. + +> **Tip:** Pokud už máte šablonu Wordu, která obsahuje screenshoty, diagramy nebo loga, tato metoda zachová každý vizuální prvek, aniž byste museli ručně kopírovat a vkládat. + +--- + +## Co budete potřebovat + +- **.NET 6+** (nebo .NET Framework 4.6+). Kód funguje na jakémkoli moderním runtime. +- **Aspose.Words pro .NET** (NuGet balíček `Aspose.Words`). Bezplatná zkušební verze stačí pro většinu scénářů. +- **Word dokument** (`input.docx`) obsahující text a alespoň jeden obrázek. +- Základní znalost C# a Visual Studia (nebo vašeho oblíbeného IDE). + +Žádné další knihovny nejsou potřeba — vše ostatní zajišťuje samotný Aspose.Words. + +--- + +## Krok 1: Vytvořte projekt a nainstalujte Aspose.Words + +Pro přehlednost založte nový konzolový projekt: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Proč je tento krok důležitý:** Instalace NuGet balíčku vám zajistí nejnovější API, které obsahuje třídu `MarkdownSaveOptions` představenu ve verzi 22.9. Bez ní byste museli psát vlastní konvertor. + +--- + +## Krok 2: Načtěte zdrojový Word dokument + +První řádek kódu otevře `.docx`, který chcete převést. Nahraďte `YOUR_DIRECTORY` skutečnou cestou na vašem počítači. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Co se děje?** `Document` načte soubor, vytvoří interní DOM a zpřístupní každý odstavec, tabulku i obrázek. Pokud soubor chybí, Aspose vyhodí jasnou výjimku `FileNotFoundException`, kterou můžete zachytit a zobrazit uživateli přívětivější zprávu. + +--- + +## Krok 3: Nakonfigurujte možnosti uložení Markdownu s callbackem pro ukládání zdrojů + +Zde přichází na řadu magie **jak použít callback**. Callback vám umožní rozhodnout, kam se každý extrahovaný obrázek uloží. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Proč callback?** Ve výchozím nastavení by Aspose vkládal obrázky jako base‑64 řetězce přímo do markdownu — noční můra pro verzování. Callback vám dává plnou kontrolu nad názvy souborů a strukturou složek. + +--- + +## Krok 4: Uložte dokument jako Markdown + +Nyní skutečně vygenerujeme soubor `.md`. Všechny obrázky budou předány callbacku definovanému v dalším kroku. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Pokud vše proběhne v pořádku, najdete `Document.md` v cílové složce a podadresář `Resources` obsahující všechny obrázky vytažené z původního Word souboru. + +--- + +## Krok 5: Implementujte callback, který uloží každý extrahovaný obrázek + +Níže je kompletní implementace třídy `MyResourceSaver`. Vytvoří adresář `Resources` (pokud neexistuje), vygeneruje jedinečný název pro každý obrázek a zapíše stream obrázku na disk. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Vysvětlení argumentů:** +> - `args.Index` – číslování od nuly, které zaručuje jedinečnost. +> - `args.FileName` – původní název souboru, který Aspose navrhne (často něco jako `image001.png`). +> - `args.Stream` – výstupní stream, do kterého jsou bajty obrázku zapisovány. +> - `args.KeepResourceStreamOpen` – nastaveno na `false`, aby Aspose automaticky uvolnil stream a předešel únikům souborových handle. + +--- + +## Kompletní funkční příklad + +Sestavte vše dohromady, zde je jediný soubor, který můžete zkopírovat do `Program.cs`. Nezapomeňte nahradit `YOUR_DIRECTORY` absolutní nebo relativní cestou odpovídající vašemu prostředí. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Očekávaný výstup + +- `YOUR_DIRECTORY/Document.md` – markdown soubor se standardními markdown odkazy na obrázky, např.: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – obsahuje `img_0.png`, `img_1.jpg` a podobně, v pořadí, v jakém se objevily v původním Word dokumentu. + +Spuštění programu vypíše přátelské potvrzení, že proces byl úspěšně dokončen. + +--- + +## Často kladené otázky (FAQ) + +### Jak extrahovat obrázky z Wordu bez ztráty kvality? + +Callback zapisuje surový binární stream přímo do souboru, čímž zachovává původní rozlišení. Žádná konverze ani komprese se neprovádí, pokud si nepřidáte vlastní logiku pro zpracování obrázků uvnitř `ResourceSaving`. + +### Můžu během extrakce změnit formát obrázku (např. PNG → JPEG)? + +Ano. V `ResourceSaving` můžete prověřit `args.FileName` nebo `args.Stream`, načíst obrázek pomocí `System.Drawing` nebo `ImageSharp` a před zápisem jej přeenkódovat. Jen nezapomeňte aktualizovat příponu v markdown odkazu. + +### Co když potřebuji, aby markdown soubory odkazovaly na CDN místo lokální složky? + +Upravte callback tak, aby předponoval základní URL k markdown odkazu. To můžete dosáhnout nastavením `args.FileName` na plně kvalifikovanou URL po nahrání obrázku na CDN. + +### Funguje to s tabulkami, poznámkami pod čarou nebo jinými pokročilými funkcemi Wordu? + +Ano. Aspose.Words převádí většinu Word konstrukcí na ekvivalenty v markdownu. Tabulky se mění na markdown tabulky, poznámky pod čarou na referenční odkazy a i vnořené seznamy jsou zpracovány elegantně. Pokud něco vypadá podivně, podívejte se do posledních poznámek k vydání — Aspose neustále zlepšuje přesnost konverze. + +### Jak převést docx na markdown v CI/CD pipeline? + +Stačí přidat zkompilovaný `.exe` do vašich build kroků, nasměrovat jej na vygenerované `.docx` artefakty a pushnout výsledné `.md` a složku `Resources/` do repozitáře statické stránky. Protože je proces plně deterministický, dobře funguje v automatizovaných prostředích. + +--- + +## Závěr + +Ukázali jsme, jak **vytvořit markdown z Wordu** pomocí Aspose.Words, prošli celý **workflow převodu docx na markdown** a představili praktický způsob **extrakce obrázků z Wordu** s vlastním **callbackem**. Výsledkem je čistý markdown soubor spárovaný se složkou originálních obrázků — ideální pro dokumentační weby, statické blogy nebo jakýkoli workflow, který preferuje čisté textové formáty. + +Další kroky, které můžete zvážit: + +- **Dávkové zpracování** více `.docx` souborů ve složce (smyčka přes `Directory.GetFiles`). +- **Vlastní pojmenovací schémata** pro obrázky (např. pomocí původního textu popisku). +- **Post‑processing** markdownu pro nahrazení odkazů na obrázky CDN URL. +- Prozkoumání **dalších exportních formátů Aspose**, jako HTML, PDF nebo EPUB, pro multikanálové publikování. + +Máte další otázky nebo obtížný Word soubor, který se nechce převést? Zanechte komentář níže a pojďme to společně vyřešit. Šťastné kódování a užívejte si jednoduchost převodu Wordu na markdown! + +--- + +![Diagram ukazující proces konverze Word do Markdown](image.png "Diagram převodu Word na markdown") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/czech/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/czech/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..997c92afea --- /dev/null +++ b/words/czech/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Jak exportovat LaTeX z DOCX pomocí Aspose.Words. Naučte se převádět DOCX + na Markdown, nastavit DPI a povolit obnovu v C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: cs +og_description: Jak exportovat LaTeX z DOCX pomocí Aspose.Words. Tento tutoriál ukazuje + krok za krokem převod do Markdownu, řízení DPI a režim obnovy. +og_title: Jak exportovat LaTeX z DOCX – převést na Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Jak exportovat LaTeX z DOCX – převést na Markdown +url: /cs/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak exportovat LaTeX z DOCX – převod do Markdown + +Už jste se někdy zamysleli **jak exportovat LaTeX** z DOCX souboru, aniž byste ztratili krásu svých rovnic? Nejste v tom sami. Z mé zkušenosti je největší problém získat tyto objekty OfficeMath do čistého, přenositelného formátu pro generátory statických stránek nebo vědecké blogy. + +V tomto průvodci si ukážeme převod DOCX do Markdown pomocí Aspose.Words, přičemž také ukážeme **jak nastavit DPI**, **jak povolit obnovu** a několik užitečných triků pro spolehlivý pipeline. Na konci budete mít jeden program v C#, který vytvoří Markdown soubor s LaTeX rovnicemi, vysoce rozlišenými obrázky a správnou manipulací s hypertextovými odkazy. + +## Co budete potřebovat + +- **.NET 6+** (nebo .NET Framework 4.7.2 – API funguje stejně) +- **Aspose.Words for .NET** (nejnovější stabilní verze k březnu 2026) +- DOCX soubor, který obsahuje rovnice, obrázky a odkazy +- Visual Studio, VS Code nebo jakýkoli editor, který preferujete + +Kromě Aspose.Words nejsou potřeba žádné další balíčky NuGet, ale ujistěte se, že máte platnou licenci, pokud nepoužíváte zkušební verzi. + +## Krok 1 – Načtení DOCX ve strict režimu obnovy + +Než vůbec pomyslíme na export, musíme se ujistit, že zdrojový dokument neukrývá poškození. Zde přichází na řadu **jak povolit obnovu**. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Proč strict recovery?** +Pokud necháte Aspose tiše opravovat problémy, můžete skončit s chybějícími odstavci nebo poškozenými obrázky – něco, co nikdo nechce při exportu LaTeXu. Rychlým selháním můžete problém zachytit brzy a rozhodnout, zda opravit zdrojový DOCX nebo problém zaznamenat na později. + +### Pro tip +Zabalte načítání do try/catch a logujte `DocumentLoadingException`. Tím může váš CI pipeline označit problematické soubory, aniž by zastavil celý build. + +## Krok 2 – Připravte možnosti exportu do Markdown + +Nyní, když je dokument bezpečně v paměti, nakonfigurujeme, jak bude uložen. Toto je jádro **jak exportovat latex** a také zahrnuje **jak nastavit DPI** pro vložené obrázky. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Co každá možnost dělá** + +| Možnost | Důvod | Relevance ke klíčovým slovům | +|--------|--------|-----------------------| +| `OfficeMathExportMode = LaTeX` | Přímo odpovídá na **jak exportovat latex** z rovnic. | Primární klíčové slovo | +| `ImageResolution = 300` | Řídí kvalitu obrázku – odpověď na **jak nastavit dpi**. | Sekundární | +| `ResourceSavingCallback` | Ukládá vložené soubory na disk, běžná potřeba při **convert docx to markdown**. | Sekundární | +| `EmptyParagraphExportMode` | Zajišťuje čistý výstup Markdown, zabraňuje osamělým HTML tagům. | Zlepšuje celkovou kvalitu konverze | +| `LinkExportMode = AsReference` | Umožňuje odkazy snadno číst a upravovat, další výhoda pro **convert docx to markdown**. | | + +## Krok 3 – Implementace vlastního ukladače zdrojů (volitelné, ale užitečné) + +Při převodu DOCX do Markdown potřebují obrázky a další binární zdroje místo v souborovém systému. Aspose vám umožňuje to řídit pomocí `IResourceSavingCallback`. Výše uvedený úryvek již ukazuje minimální implementaci, ale pojďme si ji rozebrat: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Proč se tím zabývat?** +Pokud tento krok přeskočíte, Aspose vloží obrázky jako base‑64 řetězce, což zvětší velikost Markdown souboru a ztíží správu verzí. Ukládáním zdrojů do samostatné složky udržíte Markdown lehký a přátelský pro generátory statických stránek jako Hugo nebo Jekyll. + +## Krok 4 – Uložení dokumentu jako Markdown + +Všechny těžké operace jsou hotové. Jedna řádka nyní zapíše finální soubor. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Otevřete `output.md` a uvidíte: + +- Rovnice vykreslené jako `$…$` LaTeX bloky +- Obrázky odkazované jako `![Alt text](resources/image001.png)` s rozlišením 300 dpi +- Hyperlinky převedené do reference stylu: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +To je celý proces **jak převést docx** v kostce. + +## Časté otázky a okrajové případy + +### 1️⃣ Co když DOCX obsahuje nepodporované objekty? +Aspose.Words vyhodí `FeatureNotSupportedException`. Protože jsme použili **jak povolit obnovu** ve strict režimu, výjimka se objeví okamžitě. Můžete buď: + +- Přepnout `RecoveryMode` na `RecoveryMode.Default` pro konverzi na nejlepší úsilí, **nebo** +- Předzpracovat DOCX (např. odstranit nepodporovaný SmartArt) před spuštěním konvertoru. + +### 2️⃣ Můžu změnit DPI pro jednotlivý obrázek? +Nastavení `ImageResolution` je globální. Pro řízení DPI na úrovni jednotlivých obrázků implementujte vlastní `ImageSavingCallback` podobný `MyResourceSaver` a upravte `args.ImageResolution` na základě `args.ImageFileName` nebo metadat. + +### 3️⃣ Jak vložit vygenerovaný LaTeX do Jekyll stránky? +Vestavěná podpora MathJax v Jekyll funguje ihned. Jen se ujistěte, že vaše šablona zahrnuje skript MathJax a LaTeX bloky jsou obaleny v `$$` pro zobrazovací rovnice nebo `$` pro inline. + +### 4️⃣ Je to kompatibilní s .NET Core na Linuxu? +Rozhodně. Aspose.Words je multiplatformní. Jen se ujistěte, že cesta `YOUR_DIRECTORY` odpovídá konvencím Linuxu (např. `/home/user/docs`). + +## Kompletní funkční příklad + +Níže je připravený program ke zkopírování a vložení. Nahraďte `YOUR_DIRECTORY` skutečnou cestou na vašem počítači. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Očekávaný výstup** – otevřete `output.md` a měli byste vidět něco jako: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Pokud otevřete soubor v náhledu Markdown, který podporuje MathJax, integrál se vykreslí + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/czech/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/czech/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..5a53960f2f --- /dev/null +++ b/words/czech/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Jak exportovat LaTeX z dokumentů Word pomocí Aspose.Words – převést DOCX + na Markdown s rovnicemi ve formátu LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: cs +og_description: Jak exportovat LaTeX z dokumentů Word je vysvětleno v první větě, + která vám ukazuje, jak převést DOCX na Markdown s rovnicemi ve formátu LaTeX. +og_title: Jak exportovat LaTeX z Wordu – kompletní průvodce +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Jak exportovat LaTeX z Wordu – převést DOCX na Markdown +url: /cs/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak exportovat LaTeX z Wordu – převod DOCX na Markdown + +Už jste se někdy zamýšleli **jak exportovat LaTeX** z Word souboru, aniž byste skončili s hromadou PNG obrázků? Nejste v tom sami; vývojáři často narazí na tento problém, když potřebují čisté, editovatelné rovnice pro statické stránky nebo vědecké blogy. Dobrá zpráva? S Aspose.Words můžete **převést Word na Markdown** a zachovat každý objekt OfficeMath jako nativní LaTeX – žádné následné zpracování není potřeba. + +V tomto tutoriálu projdeme celý proces **uložení Word dokumentu jako Markdown** při **exportu rovnic jako LaTeX**. Na konci budete mít funkční úryvek C#, jasné vysvětlení každé možnosti a tipy, jak řešit okrajové případy jako složité vzorce nebo smíšený obsah. Žádné externí nástroje, jen jeden NuGet balíček a pár řádků kódu. + +## Co budete potřebovat + +- .NET 6+ (nebo .NET Framework 4.7.2 a vyšší) – nejnovější runtime funguje nejlépe. +- Visual Studio 2022 nebo jakýkoli editor, který umí kompilovat C# projekty. +- Licence Aspose.Words pro .NET (bezplatná zkušební verze stačí pro experimenty). +- DOCX soubor, který obsahuje alespoň jednu rovnici (OfficeMath). + +Pokud už máte vše připravené, skvěle – pojďme na to. + +## Jak exportovat LaTeX z Wordu – přehled + +Níže je vysokourovňový pohled na jednotlivé kroky: + +1. **Instalovat** NuGet balíček Aspose.Words. +2. **Načíst** zdrojový `.docx`, který obsahuje vaše rovnice. +3. **Nastavit** `MarkdownSaveOptions` tak, aby `OfficeMathExportMode` byl nastaven na `LaTeX`. +4. **Uložit** dokument jako soubor `.md`. +5. **Ověřit**, že vygenerovaný Markdown obsahuje LaTeX bloky (`$$…$$`). + +Každý z těchto kroků je podrobně vysvětlen v následujících sekcích. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="Jak exportovat LaTeX z Word diagramu"} + +## Krok 1 – Instalace Aspose.Words pro .NET (convert word to markdown) + +Nejprve potřebujete knihovnu, která udělá těžkou práci. Otevřete terminál (nebo Package Manager Console) a spusťte: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Tip:** Pokud používáte Visual Studio, klikněte pravým tlačítkem na projekt → *Manage NuGet Packages* → vyhledejte „Aspose.Words“ a nainstalujte nejnovější stabilní verzi. + +Proč je to důležité: Aspose.Words abstrahuje formát Open XML a poskytuje čisté API pro manipulaci s Word dokumenty, aniž byste se museli zabývat nízkoúrovňovým XML. Navíc obsahuje vestavěnou podporu pro převod OfficeMath na LaTeX, což je jádro našeho **export equations as LaTeX** požadavku. + +## Krok 2 – Načtení DOCX (how to convert docx) + +Jakmile je balíček nainstalován, načtěte soubor, který chcete transformovat. Nahraďte `YOUR_DIRECTORY` cestou, kde se váš `.docx` nachází: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Proč načíst takto?** Konstruktor `Document` načte celý soubor do objektového modelu, což vám okamžitě umožní přístup k odstavcům, tabulkám a – co je nejdůležitější – objektům OfficeMath. Pokud soubor chybí nebo je poškozený, Aspose vyhodí popisnou `FileNotFoundException`, kterou můžete zachytit a elegantně ošetřit chybu. + +## Krok 3 – Nastavení MarkdownSaveOptions (export equations as latex) + +Magie se odehrává v objektu `MarkdownSaveOptions`. Ve výchozím nastavení by Aspose renderoval rovnice jako PNG obrázky, ale my chceme LaTeX. Nastavte `OfficeMathExportMode` na `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Krátká poznámka k volitelným příznakům: `ExportImagesAsBase64` říká Aspose, aby neembedoval binární data, což udržuje Markdown čistý. `ExportHeadersFooters` zajistí, že nepřijdete o žádný kontext, který by mohl být v těchto sekcích – užitečné, pokud hlavička obsahuje název nebo jméno autora. + +## Krok 4 – Uložení dokumentu (save word as markdown) + +Nakonec zapište transformovaný obsah do souboru `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Po spuštění tohoto řádku najdete `output.md` vedle vašeho zdrojového souboru. Otevřete ho v libovolném textovém editoru a měli byste vidět LaTeX bloky, které vypadají takto: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Tím je část **save word as markdown** hotová – žádné další konverzní kroky nejsou potřeba. + +## Krok 5 – Ověření výsledku (export equations as latex) + +Je snadné ověřování přehlédnout, ale rychlá kontrola vám ušetří hodiny později. Spusťte jednoduchý skript, který načte vygenerovaný soubor a vypíše první LaTeX blok: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Pokud se zobrazí `First LaTeX block: $$ … $$`, úspěšně jste **exportovali LaTeX** z Wordu. Pokud ne, zkontrolujte, že váš zdrojový dokument skutečně obsahuje objekty OfficeMath; běžné textové rovnice nebudou převedeny. + +## Řešení běžných okrajových případů + +| Scénář | Na co si dát pozor | Doporučené řešení | +|----------|-------------------|-----------------| +| **Smíšené obrázky a rovnice** | Aspose může stále embedovat obrázky pro grafiku, která není OfficeMath. | Nastavte `ExportImagesAsBase64 = false` a nechte obrázky jako externí soubory, poté je ručně odkažte v Markdownu. | +| **Komplexní vnořené rovnice** | Velmi hluboké vnoření může vytvořit LaTeX, který bude vyžadovat ruční úpravy. | Proveďte post‑processing pomocí LaTeX formátovače (např. `latexindent`) nebo upravte `mdOptions` → `ExportMathAsDisplay = true`. | +| **Velké dokumenty** | Spotřeba paměti stoupá při načítání obrovských `.docx` souborů. | Použijte `LoadOptions` s `LoadFormat.Docx` a povolte streamování, pokud je k dispozici. | +| **Chybějící licence** | Bezplatná zkušební verze přidá do výstupu komentář s vodoznakem. | Aplikujte platnou licenci pomocí `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Tyto tipy udrží váš workflow robustní, zejména když **convert word to markdown** v produkčních pipelinech. + +## Kompletní funkční příklad (všechny kroky v jednom souboru) + +Níže je samostatná konzolová aplikace, kterou můžete zkopírovat do nového .NET projektu a okamžitě spustit. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Spusťte program, otevřete `output.md` a uvidíte své rovnice vykreslené jako čistý LaTeX. To je kompletní odpověď na **how to export latex** z Word dokumentu. + +## Závěr + +Prošli jsme **jak exportovat LaTeX** z Wordu krok za krokem, ukázali jsme, jak **convert Word to markdown**, **save word as markdown** a **export equations as LaTeX** pomocí Aspose.Words. Hlavní myšlenka je jednoduchá: načtěte DOCX, upravte `MarkdownSaveOptions` a nechte knihovnu udělat těžkou práci. + +Pokud chcete automatizovat dokumentační pipeline, zkuste tento kód propojit se statickým generátorem stránek jako Hugo nebo Jekyll – stačí vložit vygenerované `.md` soubory do repozitáře a nechat stránku přebudovat. Pro další čtení prozkoumejte Aspose „Export to LaTeX“ průvodce, experimentujte s `HtmlSaveOptions` pro webové náhledy, nebo se ponořte do API `DocumentVisitor` pro vlastní transformace. + +Máte otázky ohledně okrajových případů, licencování nebo integrace do CI/CD? Zanechte komentář níže a šťastné kódování! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/czech/net/programming-with-pdfsaveoptions/_index.md b/words/czech/net/programming-with-pdfsaveoptions/_index.md index d786a68f8c..9db4726d35 100644 --- a/words/czech/net/programming-with-pdfsaveoptions/_index.md +++ b/words/czech/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ Ať už chcete převést dokumenty Wordu do PDF pro online distribuci, archivaci | [Aktualizovat poslední vytištěnou vlastnost v dokumentu PDF](./update-last-printed-property/) | Naučte se, jak aktualizovat poslední vytištěnou vlastnost v dokumentu PDF pomocí Aspose.Words pro .NET s naším podrobným návodem. | | [Renderování 3D DML 3DEfektů v PDF dokumentu](./dml-3deffects-rendering/) | Naučte se, jak vykreslit úžasné 3D DML efekty v PDF dokumentech pomocí Aspose.Words pro .NET s tímto komplexním podrobným návodem. | | [Interpolace obrázků v dokumentu PDF](./interpolate-images/) | Naučte se, jak interpolovat obrázky v PDF dokumentu pomocí Aspose.Words pro .NET s naším podrobným návodem. Snadno vylepšete kvalitu obrázků ve vašem PDF. | - +| [Jak uložit PDF z DOCX s Aspose.Words – průvodce krok za krokem](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Naučte se, jak převést soubor DOCX do PDF pomocí Aspose.Words s podrobným krok za krokem návodem. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/czech/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/czech/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..5e9b34b7e8 --- /dev/null +++ b/words/czech/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-03-27 +description: Naučte se, jak uložit PDF ze souboru DOCX pomocí Aspose.Words. Zahrnuje + převod DOCX na PDF, uložení PDF s volbami a práci s plovoucími tvary. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: cs +og_description: Jak uložit PDF z DOCX souboru pomocí Aspose.Words. Tento průvodce + ukazuje převod DOCX na PDF, uložení PDF s možnostmi a práci s plovoucími tvary. +og_title: Jak uložit PDF z DOCX – Kompletní tutoriál Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Jak uložit PDF z DOCX pomocí Aspose.Words – krok za krokem průvodce +url: /cs/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak uložit PDF z DOCX pomocí Aspose.Words – Kompletní tutoriál + +Už jste se někdy zamýšleli **jak uložit PDF** z dokumentu Word, aniž byste ztratili rozvržení plovoucích tvarů? Nejste v tom sami. V mnoha projektech—generátory faktur, exportéry reportů nebo jednoduché archivátory dokumentů—potřebují vývojáři spolehlivý způsob, jak převést DOCX na PDF a zachovat vše přesně tak, jak to vypadá ve Wordu. + +V tomto tutoriálu vás provedeme převodem souboru DOCX na PDF **pomocí Aspose.Words pro .NET**, ukážeme vám **jak převést docx na pdf** s vlastními možnostmi uložení a vysvětlíme, proč je důležitý příznak `ExportFloatingShapesAsInlineTag`. Na konci budete mít připravený úryvek k okamžitému spuštění, který ukládá PDF s nastavitelnými možnostmi. + +## Co se naučíte + +- Přesné kroky k **převodu word document pdf** pomocí Aspose.Words. +- Jak nakonfigurovat `PdfSaveOptions`, aby plovoucí tvary byly považovány za inline tagy. +- Běžné úskalí při práci s plovoucími objekty a jak se jim vyhnout. +- Kompletní, spustitelný C# program, který můžete vložit do libovolného .NET projektu. + +> **Předpoklad:** Potřebujete licenci Aspose.Words pro .NET (nebo bezplatnou zkušební verzi) a vývojové prostředí .NET (Visual Studio, Rider nebo `dotnet` CLI). + +## Krok 1: Nastavte projekt a přidejte Aspose.Words + +Nejprve vytvořte novou konzolovou aplikaci (nebo ji přidejte do existující) a odkažte na NuGet balíček Aspose.Words. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro tip:** Pokud běžíte na CI serveru, připněte verzi balíčku (`Aspose.Words --version 24.10`), aby byly buildy reprodukovatelné. + +## Krok 2: Načtěte DOCX obsahující plovoucí tvary + +Plovoucí obrázky, textová pole nebo SmartArt mohou při převodu způsobit posuny rozvržení. Načtení dokumentu je jednoduché, ale také ověříme, že soubor existuje, aby se předešlo výjimce `FileNotFoundException` během běhu. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Všimněte si výpisů `Console.WriteLine`—poskytují rychlou zpětnou vazbu při spuštění aplikace z terminálu. + +## Krok 3: Nakonfigurujte možnosti uložení PDF (Uložení PDF s možnostmi) + +Zde se děje kouzlo. Ve výchozím nastavení se Aspose.Words snaží zachovat plovoucí objekty tak, jak jsou, což může rozbít rozvržení v výsledném PDF. Nastavením `ExportFloatingShapesAsInlineTag` na `true` řeknete knihovně, aby tyto tvary považovala za inline tagy, což zajistí, že zůstanou ukotvené k okolnímu textu. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Proč je to důležité? Představte si textové pole, které visí nad odstavcem. Bez konverze na inline‑tag může PDF posunout odstavec dolů nebo celé pole oříznout. Příznak zachovává vizuální vztah – jemný, ale zásadní detail pro profesionální reporty. + +## Krok 4: Uložte dokument jako PDF + +Nyní skutečně zapíšeme soubor PDF. Metoda `Save` přijímá jak výstupní cestu, tak možnosti, které jsme právě nastavili. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Spuštěním programu se vytvoří `output.pdf` ve stejné složce jako váš zdrojový DOCX. Otevřete jej v libovolném prohlížeči PDF a měli byste vidět, že všechny plovoucí tvary jsou vykresleny přesně tam, kde mají být. + +## Kompletní funkční příklad + +Níže je celý program v jednom bloku. Zkopírujte jej do `Program.cs` (nebo libovolného C# souboru) a stiskněte **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Očekávaný výsledek + +- **Soubor vytvořen:** `output.pdf` v cílovém adresáři. +- **Věrnost rozvržení:** Plovoucí tvary (obrázky, textová pole, SmartArt) se zobrazují inline s okolním textem. +- **Žádné výjimky:** Program se ukončí elegantně a vypíše stavové zprávy do konzole. + +## Často kladené otázky a okrajové případy + +| Question | Answer | +|----------|--------| +| **Co když potřebuji vyšší kvalitu obrázku?** | Set `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Mohu převádět více DOCX souborů najednou?** | Wrap the loading/saving logic in a `foreach (var file in Directory.GetFiles(..., "*.docx"))` loop. Remember to reuse a single `PdfSaveOptions` instance for performance. | +| **Funguje to s .NET Core?** | Absolutely. Aspose.Words 24.x supports .NET Standard 2.0+, so you can run the same code on Windows, Linux, or macOS. | +| **Co s DOCX soubory chráněnými heslem?** | Load with `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. The same `PdfSaveOptions` apply when saving. | +| **Je konverze na inline‑tag bezpečná pro složité tabulky?** | Generally yes, but very intricate table layouts with overlapping shapes may still need manual tweaking. Test a representative sample before a bulk migration. | + +## Tipy pro reálné projekty + +- **Logujte, ne jen `Console.WriteLine`** – Ve výrobě nahraďte výstup do konzole logovacím frameworkem (Serilog, NLog) pro zachycení chyb. +- **Uvolňujte zdroje** – `Document` implementuje `IDisposable`. Zabalte jej do bloku `using`, pokud zpracováváte mnoho souborů, aby se paměť rychle uvolnila. +- **Validujte PDF** – Použijte PDF validátor (např. kontrola shody s PDF/A), pokud potřebujete archivní PDF. +- **Paralelní zpracování** – Pro velké objemy zvažte `Parallel.ForEach` s vlákny‑bezpečnými `PdfSaveOptions` (klonujte pro každé vlákno), aby se urychlil převod. + +## Závěr + +Probrali jsme **jak uložit PDF** z DOCX souboru pomocí Aspose.Words, ukázali **jak převést docx na pdf** s vlastními možnostmi a vysvětlili dopad `ExportFloatingShapesAsInlineTag`. Kompletní, spustitelný příklad ukazuje, že můžete **převést word document pdf** během několika řádků, a nyní víte, jak **uložit pdf s možnostmi**, které vyhovují požadavkům na kvalitu a soulad vašeho projektu. + +Jste připraveni na další výzvu? Zkuste exportovat do jiných formátů (např. HTML, EPUB) pomocí `document.Save("output.html")` nebo experimentujte se shodou PDF/A pro dlouhodobé archivování. Stejné principy – načtení, konfigurace možností, uložení – platí všude. + +Šťastné kódování a ať vaše PDF vždy vypadají přesně tak, jak jste zamýšleli! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/czech/net/programming-with-shapes/_index.md b/words/czech/net/programming-with-shapes/_index.md index f2e71dc4a6..ee2727a791 100644 --- a/words/czech/net/programming-with-shapes/_index.md +++ b/words/czech/net/programming-with-shapes/_index.md @@ -34,7 +34,7 @@ Používáním Aspose.Words pro .NET a podle těchto tutoriálů zvládnete mani | [Detekce tvaru inteligentního umění](./detect-smart-art-shape/) | Naučte se, jak detekovat tvary SmartArt v dokumentech Wordu pomocí Aspose.Words pro .NET v tomto komplexním průvodci. Ideální pro automatizaci pracovního postupu s dokumenty. | | [Aktualizace kresby Smart Art](./update-smart-art-drawing/) | Naučte se, jak aktualizovat kresby Smart Art v dokumentech Wordu pomocí Aspose.Words pro .NET s tímto podrobným návodem. Zajistěte, aby vaše vizuální prvky byly vždy přesné. | | [Vytvořit obdélníkový tvar ve Wordu s Aspose.Words – krok za krokem](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Naučte se, jak pomocí Aspose.Words vytvořit obdélníkový tvar ve Wordu krok za krokem. | - +| [Vytvořit Word dokument v C# – Přidat tvar se stínem](./create-word-document-c-add-shape-with-shadow/) | Naučte se, jak pomocí Aspose.Words pro .NET v C# přidat tvar se stínem do Word dokumentu. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/czech/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/czech/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..45d2b9bb53 --- /dev/null +++ b/words/czech/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,203 @@ +--- +category: general +date: 2026-03-27 +description: Vytvořte dokument Word v C# a naučte se, jak přidat tvar, aplikovat na + něj stín a nastavit vzdálenost stínu. Krok za krokem průvodce pro Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: cs +og_description: Vytvořte Word dokument v C# s obdélníkovým tvarem a vlastním stínem. + Postupujte podle tohoto kompletního tutoriálu, abyste nastavili vzdálenost stínu + a jeho styl. +og_title: Vytvořte Word dokument v C# – Přidejte tvar se stínem +tags: +- Aspose.Words +- C# +- Document Automation +title: Vytvořit Word dokument v C# – Přidat tvar se stínem +url: /cs/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Vytvoření Word dokumentu C# – Přidání tvaru se stínem + +Už jste někdy potřebovali **create word document c#**, který obsahuje pěkně stylovaný obdélník? Možná vytváříte šablonu zprávy a chcete jemný drop‑shadow, aby rozložení vyniklo. V tomto tutoriálu vás provedeme přesně tím – jak přidat tvar, aplikovat stín na tvar a dokonce doladit vzdálenost stínu pomocí Aspose.Words. + +Začneme s prázdným dokumentem, vložíme obdélník, přiřadíme mu přednastavený stín a nakonec soubor uložíme. Na konci budete mít připravený .docx, který můžete otevřít ve Wordu a okamžitě vidět efekt. Žádné externí nástroje, jen čistý C# kód. + +## Požadavky + +- .NET 6 (nebo jakýkoli recentní .NET Framework) nainstalován. +- Visual Studio 2022 nebo VS Code s rozšířením C#. +- NuGet balíček Aspose.Words pro .NET (`Aspose.Words` verze 23.12 nebo novější). + Můžete jej přidat pomocí Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +To je vše – žádné další DLL ani COM interop nejsou potřeba. + +## Krok 1: Inicializace nového dokumentu a builderu – *create word document c#* Základy + +Nejprve potřebujeme objekt `Document`, který představuje Word soubor, a `DocumentBuilder` pro jeho úpravu. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Proč je tento krok důležitý:** Třída `Document` je kontejner pro všechny části Wordu (stránky, styly, obrázky). Builder je high‑level API, které abstrahuje nízkoúrovňovou manipulaci s uzly, což usnadňuje **create word document c#** bez přímé práce s XML. + +## Krok 2: Vložení obdélníkového tvaru – *how to create rectangle* + +Nyní umístíme obdélník na stránku. Velikost je vyjádřena v bodech (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro tip:** Pokud potřebujete jiný tvar, stačí zaměnit `ShapeType.Rectangle` za `ShapeType.Ellipse`, `ShapeType.Triangle` atd. Stejný kód funguje pro **how to add shape** libovolného typu. + +## Krok 3: Aplikace přednastaveného stínu a jeho doladění – *apply shadow to shape* + +Aspose.Words obsahuje několik přednastavených formátů stínů. Použijeme `Preset1` a poté přizpůsobíme vzdálenost, rozostření, průhlednost a barvu. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Proč přizpůsobovat stín?** Vlastnost `Distance` určuje, jak daleko je stín od obdélníku – představte si to jako „zvednutí“, které vidíte v 3‑D renderingu. Změna `BlurRadius` změkčuje hrany, zatímco `Transparency` vám umožní vytvořit jemný, profesionální vzhled. Toto splňuje požadavek **set shadow distance** a ukazuje, jak **apply shadow to shape** flexibilně. + +## Krok 4: Uložení dokumentu – *create word document c#* Dokončení + +Nakonec zapíšeme dokument na disk. Přizpůsobte cestu ke složce, do které máte právo zapisovat. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Otevřete výsledný soubor v Microsoft Word a uvidíte světle modrý obdélník s měkkým šedým stínem posunutým o 5 pt. To je vizuální důkaz, že jste úspěšně **create word document c#** s upraveným tvarem. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# příklad ukazující obdélník se stínem"} + +## Volitelné variace a okrajové případy + +| Scénář | Co změnit | Proč je to důležité | +|----------|----------------|----------------| +| **Různý styl stínu** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Poskytuje dramatickejší vzhled bez dalšího kódu. | +| **Žádný preset – vlastní stín** | Vynechejte `Format` a nastavte `OffsetX`, `OffsetY` ručně. | Plná kontrola nad směrem a hloubkou. | +| **Více tvarů** | Zavolejte `builder.InsertShape` znovu před uložením. | Užitečné pro složité šablony s ikonami, logy atd. | +| **Kompatibilita se staršími verzemi Aspose** | Použijte třídu `ShadowEffect` (k dispozici ve verzi v20.x). | Zajišťuje, že váš kód běží na starších projektech. | +| **Ukládání jako PDF** | `document.Save("ShadowShape.pdf");` | Stejný rendering stínu se objeví v PDF výstupu. | + +> **Často kladená otázka:** *Co když se stín ve Wordu neobjeví?* +> Ujistěte se, že používáte recentní verzi Aspose.Words (≥ 22.9). Starší verze měly omezenou podporu stínů. Také ověřte, že dokument je otevřen v recentní verzi Wordu (2016+). + +## Kompletní funkční příklad + +Níže je kompletní program připravený ke zkopírování a vložení. Obsahuje všechny `using` direktivy, komentáře a ošetření chyb pro plynulý zážitek. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Spusťte program, přejděte do `C:\Temp\ShadowShape.docx` a uvidíte obdélník s přesně nastaveným stínem. + +## Shrnutí a další kroky + +- Nyní víte, jak **create word document c#**, vložit obdélník a **apply shadow to shape** s vlastním **set shadow distance**. +- Příklad používá Aspose.Words, který abstrahuje složitosti OpenXML a zaručuje konzistentní vykreslování napříč verzemi Wordu. +- Chcete jít dál? Zkuste kombinovat více tvarů, přidat text uvnitř obdélníku nebo exportovat stejný dokument jako PDF a podívat se, jak se stín přenáší. + +### Související témata, která můžete prozkoumat + +- **How to add shape** do záhlaví/patičky pro branding. +- Použití **Aspose.Words** k programovému vkládání grafů a tabulek. +- Přizpůsobení **shadow effects** na obrázcích místo vektorových tvarů. +- Automatizace hromadného generování dokumentů pro faktury nebo certifikáty. + +Neváhejte experimentovat, rozbít kód a pak ho znovu postavit – to je nejrychlejší způsob, jak si koncepty osvojit. Pokud narazíte na problém, zanechte komentář níže nebo si prohlédněte oficiální dokumentaci Aspose.Words pro podrobnější informace o API. + +Šťastné programování a užívejte si, jak vaše Word soubory vypadají o něco uhlazeněji! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/czech/net/programming-with-txtsaveoptions/_index.md b/words/czech/net/programming-with-txtsaveoptions/_index.md index d7a1b774bf..cacd85a40e 100644 --- a/words/czech/net/programming-with-txtsaveoptions/_index.md +++ b/words/czech/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Díky těmto tutoriálům budete schopni plně využít funkce Aspose.Words pro | [Přidání oboustranných značek v dokumentu Word](./add-bidi-marks/) | Naučte se v tomto průvodci, jak přidávat obousměrné (Bidi) značky do dokumentů Wordu pomocí Aspose.Words pro .NET. Zajistěte správný směr textu pro vícejazyčný obsah. | | [Použít tabulátor na úroveň pro odsazení seznamu](./use-tab-character-per-level-for-list-indentation/) | Naučte se, jak vytvářet víceúrovňové seznamy s odsazením pomocí tabulátorů pomocí Aspose.Words pro .NET. Pro přesné formátování seznamů ve vašich dokumentech postupujte podle tohoto návodu. | | [Použijte mezeru na úroveň pro odsazení seznamu](./use-space-character-per-level-for-list-indentation/) | Naučte se, jak v Aspose.Words pro .NET vytvářet víceúrovňové seznamy s odsazením mezer. Podrobný návod pro přesné formátování dokumentů. | - +| [Uložení docx jako txt – Kompletní průvodce exportem rovnic Word do LaTeXu](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Naučte se, jak převést soubory DOCX na TXT a exportovat rovnice Word do formátu LaTeX pomocí Aspose.Words pro .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/czech/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/czech/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..e1efcfddfc --- /dev/null +++ b/words/czech/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,246 @@ +--- +category: general +date: 2026-03-27 +description: Uložte docx jako txt pomocí Aspose.Words a převádějte Word do LaTeXu. + Naučte se, jak exportovat rovnice, zachovat prostý text a získat LaTeXový značkovací + kód během několika minut. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: cs +og_description: Uložte docx jako txt pomocí Aspose.Words. Tento průvodce ukazuje, + jak převést Word do LaTeXu, exportovat rovnice a zachovat dokument jako prostý text. +og_title: Uložit docx jako txt – Exportovat rovnice Wordu do LaTeXu +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Uložte docx jako txt – Kompletní průvodce exportem rovnic z Wordu do LaTeXu +url: /cs/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Uložte docx jako txt – Exportujte rovnice Wordu do LaTeXu + +Už jste někdy potřebovali **save docx as txt**, ale obávali jste se, že ztratíte složitou matematiku, která je uvnitř vašeho souboru Word? Nejste v tom sami. V mnoha vědeckých pracovních postupech je verze dokumentu v prostém textu nutností, ale stále chcete, aby rovnice přežily jako čistý LaTeX markup. + +V tomto tutoriálu projdeme přesně kroky, jak **convert Word to LaTeX** pomocí Aspose.Words pro .NET, takže vaše rovnice budou exportovány správně, zatímco zbytek dokumentu se stane úhledným prostým textem. Na konci budete vědět, jak **export equations to LaTeX**, udržet zbytek souboru jako jednoduchý text a vyhnout se běžným úskalím, která nováčky často potkávají. + +## Co se naučíte + +- Jak načíst soubor *.docx*, který obsahuje Office Math. +- Nastavení správných `TxtSaveOptions`, aby Aspose výstupem generoval LaTeX pro každou rovnici. +- Uložení výsledku jako **save word plain text** soubor, který můžete vložit do verzovacího systému, CI pipeline nebo jakéhokoli downstream nástroje. +- Běžné okrajové případy — co dělat, když dokument kombinuje obrázky a rovnice, nebo když potřebujete zachovat Unicode znaky. +- Kompletní, připravený k běhu ukázkový kód, který můžete vložit do konzolové aplikace. + +### Předpoklady + +- .NET 6.0 nebo novější (kód funguje také s .NET Framework 4.7+). +- Licencovaná kopie **Aspose.Words for .NET** (zdarma zkušební verze funguje pro testování). +- Visual Studio 2022 nebo jakékoli IDE, které dokáže kompilovat C# projekty. +- Word dokument (`input.docx`), který již obsahuje nějaké Office Math objekty. + +> **Pro tip:** Pokud ještě nemáte licenci, můžete si požádat o dočasný klíč na webu Aspose — stačí nahradit placeholder v kódu vaším klíčem před spuštěním. + +## Krok 1 – Instalace Aspose.Words přes NuGet + +Nejprve potřebujete knihovnu ve svém projektu. Otevřete **Package Manager Console** a spusťte: + +```powershell +Install-Package Aspose.Words +``` + +Tento jediný řádek stáhne vše, co potřebujete, včetně jmenného prostoru `Saving`, kde žije `TxtSaveOptions`. Žádné extra DLL, žádné nativní závislosti — pouze čistý spravovaný kód. + +## Krok 2 – Načtení zdrojového Word dokumentu + +Nyní skutečně načteme soubor, který obsahuje rovnice. Třída `Document` abstrahuje celou strukturu *.docx*, takže s ní můžete pracovat jako s vysoce‑úrovňovým objektovým modelem. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Proč je to důležité:** Načtení dokumentu brzy vám umožní prozkoumat jeho strom uzlů. Pokud přeskočíte kontrolu a soubor neobsahuje rovnice, stále získáte čistý txt soubor — ale nebudete vědět, proč je výstup LaTeXu prázdný. + +## Krok 3 – Konfigurace TxtSaveOptions pro export do LaTeXu + +Aspose vám dává jemnozrnnou kontrolu nad tím, jak je Office Math renderováno. Nastavením `OfficeMathExportMode` na `LaTeX` se každá rovnice převede na svůj LaTeX ekvivalent místo toho, aby byla odstraněna nebo převedena na obrázek. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Proč je to důležité:** Výchozí režim exportu by rovnice úplně vynechal. Přepnutím na `LaTeX` zachováte matematický záměr, což je přesně to, co potřebujete, když později soubor předáte LaTeX kompilátoru nebo markdown procesoru, který rozumí syntaxi `$…$`. + +## Krok 4 – Uložení dokumentu jako prostý text + +S nastavenými možnostmi je uložení souboru jednorázovým příkazem. Výstup bude `.txt` soubor, kde se každá rovnice objeví jako LaTeX kód obklopený `$` oddělovači (později můžete změnit na bloky `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Očekávaný výsledek + +Otevřete `output.txt` v libovolném editoru a uvidíte něco podobného: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Všimněte si, že běžný text zůstává přesně tak, jak byl, zatímco rovnice jsou nyní čisté LaTeX řetězce. Můžete je přímo zkopírovat a vložit do LaTeX dokumentu, Jupyter notebooku nebo jakéhokoli nástroje, který vykresluje matematiku. + +## Krok 5 – Zpracování okrajových případů + +### Smíšený obsah (obrázky + rovnice) + +Pokud váš Word soubor také obsahuje obrázky, Aspose je při použití `TxtSaveOptions` ignoruje. To je obvykle v pořádku pro workflow **save word plain text**, ale pokud potřebujete obrázky jako zástupné symboly, můžete: + +1. Exportovat dokument nejprve do HTML (`HtmlSaveOptions`), aby se obrázky zachytily jako `` tagy. +2. Projít soubor podruhé s `TxtSaveOptions`, abyste získali LaTeX rovnice. +3. Sloučit oba výsledky ručně nebo pomocí malého skriptu. + +### Unicode symboly + +Některé rovnice používají speciální Unicode znaky (např. řecká písmena). Nastavení `Encoding = Encoding.UTF8` v `TxtSaveOptions` (jak je ukázáno v Kroku 3) zajistí, že tyto symboly přežijí konverzi. + +### Velké dokumenty + +Pro masivní soubory (> 100 MB) zvažte streamování operace uložení: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Streamování zabraňuje načtení celého výstupu do paměti, což může být záchrana na build agentech s nízkou pamětí. + +## Kompletní funkční příklad + +Níže je kompletní, připravený k vložení program, který spojuje všechny kroky. Stačí nahradit cesty k souborům a případně řádek s licencí. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Spusťte program (`dotnet run`, pokud používáte konzolový projekt) a zkontrolujte `output.txt`. Právě jste **saved docx as txt** a zachovali každou rovnici jako LaTeX — žádné ruční kopírování není potřeba. + +## Často kladené otázky + +**Q: Mohu změnit oddělovač z `$…$` na `\(...\)`?** +A: Ano. Po uložení spusťte jednoduchou náhradu v souboru: `output = output.Replace("$", @"\(").Replace("$", @"\)");` — buďte jen opatrní, abyste nenahradili inline `$` znaky, které patří k původnímu textu. + +**Q: Funguje to se soubory Word 2007‑2019?** +A: Rozhodně. Aspose.Words podporuje `.doc`, `.docx`, `.docm` i novější rodinu `.dotx`. Stejný kód funguje napříč všemi verzemi. + +**Q: Co když potřebuji zachovat původní formátování odstavců (tabulátory, více mezer)?** +A: Nastavte `txtSaveOptions.PreserveTableLayout = true;` a `txtSaveOptions.PreserveSpace = true;`, aby se bílé znaky zachovaly. + +## Závěr + +Probrali jsme vše, co potřebujete k **save docx as txt** a **exporting equations to LaTeX** pomocí Aspose.Words. Klíčové kroky jsou načtení dokumentu, konfigurace `TxtSaveOptions` s `OfficeMathExportMode.LaTeX` a uložení výsledku. S těmito třemi řádky kódu můžete spolehlivě **convert word to latex**, udržet svůj dokument jako **save word plain text** a vyhnout se ztrátě matematických symbolů. + +Jste připraveni na další výzvu? Zkuste propojit tento workflow s generátorem markdownu a vytvořit kompletní `.md` soubor, který obsahuje jak text, tak LaTeX — ideální pro dokumentaci na Git‑u nebo statické generátory stránek. Nebo prozkoumejte `PdfSaveOptions` od Aspose, abyste získali PDF verzi vedle prostého textového souboru. + +Pokud narazíte na nějaké potíže, zanechte komentář níže. Šťastné kódování a užijte si jednoduchost převodu Word rovnic na čistý LaTeX! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/czech/net/working-with-fonts/_index.md b/words/czech/net/working-with-fonts/_index.md index 906092d16c..b3060a77dd 100644 --- a/words/czech/net/working-with-fonts/_index.md +++ b/words/czech/net/working-with-fonts/_index.md @@ -32,6 +32,7 @@ Ať už chcete formátovat text pomocí různých fontů, nastavit pravidla pro | [Nastavit zvýraznění písma](./set-font-emphasis-mark/) | Naučte se, jak nastavit zvýraznění písma v dokumentech Word pomocí Aspose.Words pro .NET s tímto podrobným návodem krok za krokem. Ideální pro vývojáře .NET. | | [Nastavení složek písem](./set-fonts-folders/) | Naučte se, jak nastavit vlastní složky písem v Aspose.Words pro .NET s tímto komplexním návodem krok za krokem. Ideální pro vývojáře, kteří chtějí vylepšit písma v dokumentech. | | [Povolit Zakázat nahrazování písem](./enable-disable-font-substitution/) | Naučte se, jak povolit nebo zakázat nahrazování písem v dokumentech Word pomocí Aspose.Words pro .NET. Zajistěte, aby vaše dokumenty vypadaly konzistentně na všech platformách. | +| [Aspose substituce písem – Jak nakonfigurovat nastavení písem v C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Naučte se, jak v C# nakonfigurovat nastavení substituce písem v Aspose.Words pro .NET. | | [Nastavení záložního písma](./set-font-fallback-settings/) | Naučte se, jak nastavit nahrazování písem v Aspose.Words pro .NET a přizpůsobit nahrazování písem v dokumentech Word. | | [Načíst záložní nastavení Noto](./load-noto-fallback-settings/) | Naučte se, jak načíst záložní nastavení Noto do dokumentu Word pomocí Aspose.Words pro .NET. Postupujte podle našeho podrobného návodu, abyste zajistili správné zobrazení všech znaků. | | [Nastavení výchozí instance složek písem](./set-fonts-folders-default-instance/) | Naučte se, jak nastavit složky písem pro výchozí instanci v Aspose.Words pro .NET s tímto podrobným návodem. Přizpůsobte si dokumenty Wordu bez námahy. | @@ -40,11 +41,11 @@ Ať už chcete formátovat text pomocí různých fontů, nastavit pravidla pro | [Nastavení složek s písmy s prioritou](./set-fonts-folders-with-priority/) | Naučte se, jak nastavit prioritu složek písem v dokumentech Word pomocí Aspose.Words pro .NET. Náš průvodce zajistí, že se vaše dokumenty pokaždé vykreslí perfektně. | | [Nastavení složky s fonty True Type](./set-true-type-fonts-folder/) | Naučte se, jak nastavit složku s písmy True Type v dokumentech Wordu pomocí Aspose.Words pro .NET. Postupujte podle našeho podrobného návodu krok za krokem, abyste zajistili konzistentní správu písem. | | [Zadání výchozího písma při vykreslování](./specify-default-font-when-rendering/) | Naučte se, jak zadat výchozí písmo při vykreslování dokumentů Word pomocí Aspose.Words pro .NET. Zajistěte konzistentní vzhled dokumentu napříč platformami. | -| [Nastavení písma s možnostmi načtení](./font-settings-with-load-options/) Naučte se, jak spravovat nastavení písma pomocí možností načítání v Aspose.Words pro .NET. Podrobný návod pro vývojáře, jak zajistit konzistentní vzhled písma v dokumentech Wordu. +| [Nastavení písma s možnostmi načtení](./font-settings-with-load-options/) Naučte se, jak spravovat nastavení písma pomocí možností načítání v Aspose.Words pro .NET. Podrobný návod pro vývojáře, jak zajistit konzistentní vzhled písma v dokumentech Wordu. | | [Nastavit složku písem](./set-fonts-folder/) | Naučte se, jak nastavit vlastní složku s fonty v Aspose.Words pro .NET, abyste zajistili správné vykreslování dokumentů Wordu bez chybějících fontů. | | [Výchozí instance nastavení písma](./font-settings-default-instance/) | V tomto tutoriálu se naučíte, jak nakonfigurovat výchozí nastavení písma v dokumentu Word pomocí Aspose.Words pro .NET. | | [Zobrazit seznam dostupných písem](./get-list-of-available-fonts/) | Zjistěte, jak získat seznam dostupných písem pomocí Aspose.Words pro .NET v tomto podrobném návodu krok za krokem. Zlepšete si své dovednosti v oblasti správy písem. | -| [Dostávat oznámení o písmech](./receive-notifications-of-fonts/) | Zjistěte, jak dostávat upozornění na chybějící nebo nahrazená písma při používání Aspose.Words pro .NET. | +| [Dostávat oznámení o písmech](./receive-notifications-of-fonts/) | Zjistěte, jak dostávat upozornění na chybějící nebo nahrazená písmá při používání Aspose.Words pro .NET. | | [Přijímat varovné oznámení](./receive-warning-notification/) Naučte se, jak přijímat varovné upozornění při používání Aspose.Words pro .NET a jak řešit případné problémy nebo varování v dokumentech. | | [Příklad zdroje písma Steam](./resource-steam-font-source-example/) | Naučte se, jak používat zdroj písem Resource Stream k načtení vlastních písem do Aspose.Words pro .NET. | | [Získat substituci bez přípon](./get-substitution-without-suffixes/) | V tomto tutoriálu se naučíte, jak získat přepsání bez přípon v dokumentu Word pomocí Aspose.Words pro .NET. | diff --git a/words/czech/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/czech/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..c57b42efd5 --- /dev/null +++ b/words/czech/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose náhrada fontů usnadněna: naučte se konfigurovat nastavení fontů, + zachytávat varování a řešit chybějící fonty ve vašich .NET aplikacích.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: cs +og_description: Zvládněte nahrazování fontů v Aspose konfigurací nastavení fontů a + zpracováním chybějících fontů pomocí varovného callbacku. Kompletní průvodce v C#. +og_title: Aspose nahrazení fontů – Konfigurace nastavení fontů v C# +tags: +- Aspose.Words +- C# +- Font Management +title: Nahrazení fontů v Aspose – Jak konfigurovat nastavení fontů v C# +url: /cs/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Kompletní průvodce nastavením fontů + +Už jste někdy narazili na dokument, který najednou nahradí vaše vlastní písmo něčím generickým? To je **aspose font substitution**, který dělá svou práci – nahrazuje chybějící písma nejbližšími, které najde. Je to užitečné, ale pokud potřebujete vědět *přesně*, které písmo bylo nahrazeno, musíte využít varovný systém knihovny a nastavit fonty sami. + +V tomto tutoriálu projdeme reálný scénář: načtení DOCX, který odkazuje na písmo, které nemáte, zachycení události nahrazení a vytištění přátelské zprávy do konzole. Na konci budete pohodlně ovládat **configure font settings**, nastavit **Aspose.Words warning callback** a rozšířit ukázku podle libovolného workflow. + +> **Co budete potřebovat** +> • .NET 6+ (nebo .NET Framework 4.7.2+) +> • Aspose.Words pro .NET (nejnovější NuGet) +> • DOCX, který odkazuje na chybějící písmo (nazveme ho `MissingFont.docx`) + +Pojďme na to. + +--- + +## Krok 1: Instalace Aspose.Words a příprava projektu + +Než napíšeme jakýkoli kód, ujistěte se, že je odkaz na balíček Aspose.Words: + +```bash +dotnet add package Aspose.Words +``` + +> **Tip:** Použijte nejnovější stabilní verzi; k březnu 2026 je to 23.11.0. Novější vydání vylepšují algoritmy pro hledání fontů a přidávají další typy varování. + +Vytvořte novou konzolovou aplikaci (nebo vložte kód do existujícího projektu) a přidejte obvyklé `using` direktivy: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Tyto jmenné prostory nám poskytují přístup k třídám `Document`, `LoadOptions` a dalším souvisejícím s fonty. + +--- + +## Krok 2: Nastavení fontů pomocí LoadOptions + +Jádro kontroly **aspose font substitution** spočívá v `LoadOptions.FontSettings`. Poskytnutím prázdného objektu `FontSettings` říkáme Aspose, aby použil výchozí cesty pro hledání *a* aby hlásil jakékoli nahrazení pomocí varovacího callbacku. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Proč se nespoléhat jen na výchozí nastavení? Protože připojení varovacího callbacku (další krok) funguje jen tehdy, když je vlastnost `FontSettings` nenulová. Tento malý řádek nám poskytuje háček do procesu nahrazování, aniž by měnil samotné chování vyhledávání fontů. + +--- + +## Krok 3: Připojení varovacího callbacku pro zachycení nahrazení + +Aspose.Words implementuje rozhraní `IWarningCallback`. Kdykoli se stane něco pozoruhodného – například chybějící písmo – volá naši metodu `Warning`. Implementujeme malý handler, který filtruje `WarningType.FontSubstitution` a vypíše popis. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +A zde je samotný handler: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Proč je to důležité** – Bez callbacku Aspose tiše nahrazuje písma a nikdy nevíte, které bylo použito. Callback proces zpřehlední, což je zásadní pro zprávy o shodě nebo ladění problémů s rozvržením. + +--- + +## Krok 4: Načtení dokumentu s nakonfigurovanými možnostmi + +Nyní konečně načteme dokument a předáme mu `loadOptions`, které jsme právě připravili. Pokud zdrojový soubor odkazuje na písmo, které není nainstalováno, náš handler se spustí. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Nahraďte `YOUR_DIRECTORY` skutečnou cestou, kde se nachází `MissingFont.docx`. Po spuštění programu byste měli vidět výstup podobný tomuto: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Tento řádek vám přesně řekne, které písmo chybělo a jaký náhradní font Aspose vybral. + +--- + +## Krok 5: (Volitelné) Doladění cest pro vyhledávání fontů + +Pokud máte soukromou složku s firemními fonty, můžete Aspose říct, kde má hledat, než přejde na systémové fonty. Jedná se o pokročilé využití **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Nastavení `recursive: true` způsobí, že Aspose prohledá i podadresáře. Nyní knihovna nejprve zkusí vaše soukromé fonty, čímž se sníží šance na nežádoucí nahrazení. + +--- + +## Kompletní funkční příklad + +Sestavením všeho dohromady získáte kompletní, připravený program: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Očekávaný výstup** (když je nalezen chybějící font): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Pokud jsou všechna písma přítomna, program běží tiše (žádná varování) a stále vytvoří PDF. + +--- + +## Často kladené otázky a okrajové případy + +### Co když potřebuji *zabránit* nahrazení úplně? + +Nastavte `FontSettings.SubstitutionSettings` na `null` nebo použijte `FontSettings.FontSubstitutionSettings` k řízení chování. Například: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Nyní Aspose vyhodí výjimku místo tichého nahrazení, kterou můžete zachytit a zpracovat. + +### Funguje to i s jinými formáty souborů (např. .doc, .rtf)? + +Ano. Stejný objekt `LoadOptions` lze předat libovolnému konstruktoru `Document`, který přijímá cestu k souboru. Varovací callback se spustí pro všechny formáty, které používají fonty. + +### Můžu zachytit *přesný* náhradní název fontu? + +Ano. Řetězec `info.Description` obsahuje jak chybějící písmo, tak náhradu. Pokud potřebujete název programově, můžete jej parsovat nebo použít objekt `FontInfo` (k dispozici v novějších verzích). + +### Jak se to chová v prostředí s více vlákny? + +`FontSettings` **není** thread‑safe. Vytvořte samostatný `LoadOptions` (s vlastním `FontSettings`) pro každé vlákno, nebo přístup chráníte pomocí zámku. + +--- + +## Závěr + +Probrali jsme vše, co potřebujete k ovládnutí **aspose font substitution** a **configure font settings** v aplikaci C#: + +1. Nainstalujte Aspose.Words a přidejte potřebné `using` direktivy. +2. Vytvořte objekt `LoadOptions` s novým `FontSettings`. +3. Připojte vlastní `IWarningCallback` pro zobrazení událostí nahrazení. +4. Načtěte dokument a nechte callback hlásit chybějící písma. +5. (Volitelné) Rozšiřte cestu pro vyhledávání nebo úplně zakázat nahrazení. + +S tímto vzorem můžete logovat chybějící písma pro shodu, upozorňovat uživatele v UI nebo automaticky vkládat náhradní fonty před publikací. Dále můžete prozkoumat **Aspose.Words font substitution policies** nebo integrovat workflow do většího pipeline pro zpracování dokumentů. + +Šťastné programování a ať se vaše dokumenty vždy vykreslí s požadovaným typem písma! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/dutch/net/basic-conversions/_index.md b/words/dutch/net/basic-conversions/_index.md index efcb8258a3..9ea08e114d 100644 --- a/words/dutch/net/basic-conversions/_index.md +++ b/words/dutch/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ Basisconversies begeleidt u door basisdocumentconversies met behulp van de Aspos | [PDF opslaan in Word-formaat (Docx)](./pdf-to-docx/) | Leer hoe u een PDF naar een Word-document (Docx) converteert met Aspose.Words voor .NET in deze gedetailleerde, stapsgewijze handleiding. Perfect voor ontwikkelaars. | | [Hoe LaTeX vanuit Word exporteren – Stapsgewijze handleiding](./how-to-export-latex-from-word-step-by-step-guide/) | Leer hoe u LaTeX vanuit Word kunt exporteren met Aspose.Words voor .NET in een stapsgewijze handleiding. | | [Word opslaan als PDF met Aspose.Words – Complete C#-gids](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Leer hoe u Word-documenten naar PDF converteert met Aspose.Words in C# met een volledige stap‑voor‑stap gids. | +| [Word naar PDF converteren met Aspose.Words – Complete gids](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Leer hoe u Word-documenten naar PDF converteert met Aspose.Words in een volledige stap‑voor‑stap gids. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/dutch/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/dutch/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..433e55d7ae --- /dev/null +++ b/words/dutch/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Converteer Word snel naar PDF met Aspose.Words. Leer hoe je Word opslaat + als PDF, docx exporteert naar PDF en een toegankelijke PDF genereert in C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: nl +og_description: Converteer Word naar PDF in C# met Aspose.Words. Deze gids laat zien + hoe je Word opslaat als PDF, docx exporteert naar PDF en een toegankelijke PDF genereert. +og_title: Converteer Word naar PDF met Aspose.Words – Stap voor stap +tags: +- Aspose.Words +- C# +- PDF conversion +title: Word naar PDF converteren met Aspose.Words – Complete gids +url: /nl/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word naar PDF converteren met Aspose.Words – Complete gids + +Heb je je ooit afgevraagd hoe je **Word naar PDF** kunt **converteren** zonder gebruik te maken van externe webtools? Misschien bouw je een geautomatiseerde rapportengine en heb je een betrouwbare manier nodig om *word als pdf op te slaan* on‑the‑fly. Het goede nieuws is dat Aspose.Words het hele proces kinderspel maakt, en je zelfs een **PDF/UA‑2**‑conform bestand kunt genereren – perfect voor toegankelijkheidseisen. + +In deze tutorial lopen we alles door wat je nodig hebt: een `.docx` laden, de PDF‑opties configureren zodat je *docx naar pdf kunt exporteren* met PDF/UA‑conformiteit, en tenslotte het resultaat opslaan als een toegankelijke PDF. Aan het einde heb je een zelfstandige, productie‑klare code‑snippet die je in elk .NET‑project kunt gebruiken. + +![Word naar PDF converteren met Aspose.Words](convert-word-to-pdf.png) + +## Wat je gaat leren + +- **Waarom Aspose.Words** een solide keuze is voor *generate accessible pdf* scenario’s. +- De exacte stappen om *document als pdf op te slaan* met PDF/UA‑2 conformiteit. +- Hoe je omgaat met veelvoorkomende randgevallen zoals ontbrekende lettertypen of met wachtwoord beveiligde bronbestanden. +- Snelle tips voor het debuggen van de output en het verifiëren van toegankelijkheidsconformiteit. + +### Vereisten + +- .NET 6 of later (de API werkt ook op .NET Framework 4.6+). +- Een geldige Aspose.Words for .NET‑licentie (de gratis trial werkt voor evaluatie). +- Basiskennis van C# — geen ingewikkelde patronen nodig. + +Als je deze punten hebt afgevinkt, laten we dan beginnen. + +--- + +## Word naar PDF converteren – Stapsgewijze implementatie + +We splitsen de oplossing op in vijf duidelijke stappen. Elke stap heeft een kop, een kort code‑fragment en een uitleg *waarom* de code belangrijk is. + +### Stap 1: Laad het Word‑document dat je wilt converteren + +Het eerste wat je nodig hebt, is een `Document`‑object dat het bronbestand representeert. Aspose.Words leest **.docx**, **.doc**, **.rtf** en vele andere formaten, zodat je *word als pdf* kunt opslaan ongeacht hoe het bestand oorspronkelijk is aangemaakt. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Waarom dit belangrijk is:** +- Het vroegtijdig laden van het bestand laat je fouten door ontbrekende bestanden opvangen voordat je CPU‑cycli verspilt. +- De `Document`‑klasse verbergt de interne structuur van een Word‑bestand en biedt je een schoon objectmodel om mee te werken. + +### Stap 2: Configureer PDF‑opslaan‑opties voor toegankelijkheid + +Als je *generate accessible pdf* bestanden nodig hebt, moet je Aspose.Words vertellen een PDF/UA‑2‑conform document te produceren. De `PdfSaveOptions`‑klasse geeft je fijne controle over de output. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Waarom dit belangrijk is:** +- `PdfCompliance.PdfUa2` instrueert de bibliotheek om de benodigde tags, structuurinformatie en metadata toe te voegen waar screenreaders op vertrouwen. +- Lettertypen insluiten (`EmbedFullFonts = true`) voorkomt de vervelende “font not found” waarschuwingen wanneer de PDF op een ander OS wordt geopend. +- Het instellen van een `Title` helpt assistieve technologieën het document correct aan te kondigen. + +### Stap 3: Sla het document op als PDF + +Nu het bronbestand is geladen en de opties zijn ingesteld, is de daadwerkelijke conversie één regel code. Hier *exporteer je docx naar pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Waarom dit belangrijk is:** +- De `Save`‑methode respecteert de `PdfSaveOptions` die we hebben geconfigureerd, waardoor de toegankelijkheidsfuncties worden ingebakken. +- Het omhullen van de aanroep met een `try/catch`‑blok geeft je de mogelijkheid om licentie‑ of permissiefouten te loggen of weer te geven, wat vaak nieuwkomers tegenkomt. + +### Stap 4: Controleer de PDF/UA‑conformiteit (optioneel maar aanbevolen) + +Hoewel Aspose.Words het zware werk doet, is het een goede gewoonte om de output dubbel te controleren, vooral wanneer je documenten levert aan overheidsinstanties of andere gereguleerde entiteiten. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Waarom dit belangrijk is:** +- `IsTagged` is een snelle sanity‑check; volledige PDF/UA‑validatie vereist een speciale validator, maar de meeste conformiteitsproblemen komen naar voren als ontbrekende tags. +- Als de vlag `false` teruggeeft, kun je `PdfSaveOptions` opnieuw bekijken — misschien ben je de `Compliance` niet ingesteld of ontbrak de bron­document de juiste kopstijlen. + +### Stap 5: Veelvoorkomende valkuilen & Pro‑tips + +| Valkuil | Wat gebeurt er | Hoe op te lossen | +|---------|----------------|------------------| +| **Ontbrekende lettertypen** | Tekst verschijnt als blokken in de PDF. | Stel `EmbedFullFonts = true` **of** installeer de ontbrekende lettertypen op de server. | +| **Niet‑gelicentieerde bibliotheek** | Aspose voegt een watermerk toe aan elke pagina. | Voeg je licentiebestand (`Aspose.Words.lic`) vroeg in de app toe (bijv. `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Bronbestand beveiligd met wachtwoord** | `InvalidOperationException` bij `new Document(path)`. | Gebruik de overload `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Grote documenten veroorzaken OOM** | Out‑of‑memory‑exception bij enorme bestanden. | Schakel `MemoryOptimization` in bij `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Toegankelijkheidstags ontbreken** | PDF/UA‑validatie faalt. | Zorg dat het bron‑Word‑bestand correcte kopstijlen gebruikt (`Heading 1`, `Heading 2`, enz.) — Aspose mappt die automatisch naar PDF‑tags. | + +**Pro‑tip:** Als je veel documenten in één batch converteert, hergebruik dan één `PdfSaveOptions`‑instantie. Eén keer aanmaken vermindert toewijzings‑overhead en houdt je geheugenverbruik laag. + +--- + +## Volledig werkend voorbeeld (Klaar om te kopiëren) + +Hieronder staat het complete programma dat alles samenbrengt. Sla het op als `Program.cs`, voeg de NuGet‑pakketten Aspose.Words en Aspose.PDF toe, en voer het uit. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Verwacht resultaat:** +Er verschijnt een bestand genaamd `output.pdf` in `C:\MyFiles`. Wanneer je het opent in Adobe Acrobat zie je “PDF/A‑2b, PDF/UA‑1” in het conformiteitspaneel, wat bevestigt dat je succesvol *word naar pdf* hebt **geconverteerd**. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/dutch/net/programming-with-markdownsaveoptions/_index.md b/words/dutch/net/programming-with-markdownsaveoptions/_index.md index 5167a87a1d..c1caa48a54 100644 --- a/words/dutch/net/programming-with-markdownsaveoptions/_index.md +++ b/words/dutch/net/programming-with-markdownsaveoptions/_index.md @@ -27,33 +27,31 @@ Tekstverwerking met MarkdownSaveOptions is een uitgebreide bron die u begeleidt ### [Opslaan van Word als PDF en herstel van beschadigd Word – Converteer Word naar Markdown – Converteer Word naar Markdown in C#](./save-word-as-pdf-and-recover-corrupted-word-convert-word-to/) ### [Maak Toegankelijke PDF en Converteer Word naar Markdown – Volledige C#-gids](./create-accessible-pdf-and-convert-word-to-markdown-full-c-gu/) - Leer hoe u toegankelijke PDF's maakt en Word-documenten naar Markdown converteert met een volledige C#-handleiding. ### [Hoe Markdown te gebruiken: DOCX naar Markdown converteren met LaTeX‑vergelijkingen](./how-to-use-markdown-convert-docx-to-markdown-with-latex-equa/) -Leer hoe u DOCX-bestanden naar Markdown converteert, inclusief LaTeX‑vergelijkingen, met Aspose.Words voor .NET. - ### [Docx naar markdown converteren – Stapsgewijze C#-gids](./convert-docx-to-markdown-step-by-step-c-guide/) -Leer hoe u docx-bestanden naar markdown converteert met een gedetailleerde stap‑voor‑stap C#‑handleiding. - ### [Docx opslaan als markdown – Complete C#-gids met LaTeX‑vergelijkingen](./save-docx-as-markdown-complete-c-guide-with-latex-equations/) -Leer hoe u docx opslaat als markdown met een volledige C#‑gids inclusief LaTeX‑vergelijkingen. +### [Hoe LaTeX exporteren vanuit Word – DOCX naar Markdown converteren](./how-to-export-latex-from-word-convert-docx-to-markdown/) -### [Docx opslaan als markdown – Volledige C#-gids met afbeeldingsextractie](./save-docx-as-markdown-full-c-guide-with-image-extraction/) +### [Hoe LaTeX te exporteren vanuit DOCX – Converteren naar Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) +Leer hoe u LaTeX-inhoud uit een DOCX-bestand exporteert en converteert naar Markdown met Aspose.Words voor .NET. -Leer hoe u docx-bestanden opslaat als markdown en afbeeldingen extraheert met een volledige C#‑handleiding. +### [Docx opslaan als markdown – Volledige C#-gids met afbeeldingsextractie](./save-docx-as-markdown-full-c-guide-with-image-extraction/) ### [Hoe Markdown te exporteren vanuit Word – Complete C#-gids](./how-to-export-markdown-from-word-complete-c-guide/) ### [Hoe Markdown te exporteren vanuit DOCX – Complete gids](./how-to-export-markdown-from-docx-complete-guide/) ### [Hoe Markdown op te slaan vanuit DOCX – Stapsgewijze gids](./how-to-save-markdown-from-docx-step-by-step-guide/) - Leer hoe u DOCX-bestanden naar Markdown converteert met een duidelijke stap‑voor‑stap handleiding. +### [Markdown maken vanuit Word – Volledige C#‑gids](./create-markdown-from-word-full-c-guide/) +Leer hoe u met C# Markdown genereert vanuit Word-documenten met een volledige stap‑voor‑stap handleiding. + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/dutch/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/dutch/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..d0da9ab51b --- /dev/null +++ b/words/dutch/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Maak markdown van Word met Aspose.Words C#. Leer hoe je docx naar markdown + converteert, afbeeldingen uit Word extraheert en hoe je een callback gebruikt in + één tutorial. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: nl +og_description: Maak markdown van Word met Aspose.Words. Deze gids laat zien hoe je + docx naar markdown converteert, afbeeldingen uit Word extraheert en een callback + gebruikt voor resource‑afhandeling. +og_title: Maak markdown van Word – Complete C#‑tutorial +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Markdown maken vanuit Word – Volledige C#‑gids +url: /nl/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Markdown maken vanuit Word – Volledige C#‑handleiding + +Heb je ooit **markdown uit Word moeten maken** maar wist je niet waar je moest beginnen? Je bent niet de enige; veel ontwikkelaars lopen tegen dit obstakel aan wanneer ze inhoud van een .docx‑bestand naar een static‑site generator of een documentatierepository willen verplaatsen. Het goede nieuws? Met Aspose.Words kun je **docx naar markdown converteren**, elke afbeelding uit het oorspronkelijke bestand halen en precies bepalen waar die bronnen terechtkomen — alles met een eenvoudige callback. + +In deze gids lopen we een praktisch voorbeeld door dat laat zien hoe je afbeeldingen uit Word extraheert, hoe je een callback gebruikt om ze op te slaan, en waarom deze aanpak het meest betrouwbaar is voor automatiserings‑pipelines. Aan het einde heb je een kant‑klaar C#‑programma dat een nette `.md`‑file en een map met geëxtraheerde afbeeldingen produceert. + +> **Pro tip:** Als je al een Word‑sjabloon hebt met screenshots, diagrammen of logo’s, behoudt deze methode elk visueel element zonder dat je handmatig hoeft te knippen‑en‑plakken. + +--- + +## Wat je nodig hebt + +- **.NET 6+** (of .NET Framework 4.6+). De code werkt op elke recente runtime. +- **Aspose.Words for .NET** (NuGet‑package `Aspose.Words`). De gratis proefversie voldoet voor de meeste scenario’s. +- Een **Word‑document** (`input.docx`) dat tekst en minstens één afbeelding bevat. +- Een basisbegrip van C# en Visual Studio (of je favoriete IDE). + +Er zijn geen extra libraries nodig — alles wordt afgehandeld door Aspose.Words zelf. + +--- + +## Stap 1: Het project opzetten en Aspose.Words installeren + +Om alles overzichtelijk te houden, start je een nieuw console‑project: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Waarom deze stap belangrijk is:** Het installeren van het NuGet‑package zorgt ervoor dat je de nieuwste API hebt, inclusief de `MarkdownSaveOptions`‑klasse die geïntroduceerd werd in versie 22.9. Zonder deze klasse zou je een eigen converter moeten schrijven. + +--- + +## Stap 2: Het bron‑Word‑document laden + +De eerste regel code opent de `.docx` die je wilt transformeren. Vervang `YOUR_DIRECTORY` door het daadwerkelijke pad op jouw machine. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Wat gebeurt er?** `Document` parseert het bestand, bouwt een interne DOM en maakt elke alinea, tabel en afbeelding toegankelijk. Als het bestand ontbreekt, gooit Aspose een duidelijke `FileNotFoundException`, die je kunt opvangen voor een vriendelijkere UI. + +--- + +## Stap 3: Markdown‑opslaan‑opties configureren met een resource‑opslaan‑callback + +Hier komt de magie van **hoe je een callback gebruikt** in beeld. De callback laat je bepalen waar elke geëxtraheerde afbeelding terechtkomt. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Waarom een callback?** Standaard zou Aspose afbeeldingen embedden als base‑64‑strings in de markdown — een nachtmerrie voor versiebeheer. Met de callback heb je volledige controle over bestandsnamen en mapstructuur. + +--- + +## Stap 4: Het document opslaan als Markdown + +Nu genereren we daadwerkelijk de `.md`‑file. Alle afbeeldingen worden doorgegeven aan de callback die in de volgende stap wordt gedefinieerd. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Als alles goed gaat, vind je `Document.md` in de doelmap en een submap genaamd `Resources` met elke afbeelding die uit het oorspronkelijke Word‑bestand is gehaald. + +--- + +## Stap 5: De callback implementeren die elke geëxtraheerde afbeelding opslaat + +Hieronder staat de volledige implementatie van `MyResourceSaver`. Hij maakt een `Resources`‑directory (indien nodig), bouwt een unieke bestandsnaam voor elke afbeelding en schrijft de afbeeldingsstroom naar schijf. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Uitleg van de argumenten:** +> - `args.Index` – een nul‑gebaseerde teller die uniekheid garandeert. +> - `args.FileName` – de oorspronkelijke bestandsnaam die Aspose voorstelt (vaak iets als `image001.png`). +> - `args.Stream` – de output‑stream waarin de afbeeldingsbytes worden geschreven. +> - `args.KeepResourceStreamOpen` – ingesteld op `false` zodat Aspose de stream automatisch sluit, waardoor bestands‑handle‑lekken worden voorkomen. + +--- + +## Volledig werkend voorbeeld + +Alles bij elkaar, hier is één bestand dat je kunt kopiëren‑en‑plakken in `Program.cs`. Vergeet niet `YOUR_DIRECTORY` te vervangen door een absoluut of relatief pad dat bij jouw omgeving past. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Verwachte output + +- `YOUR_DIRECTORY/Document.md` – een markdown‑bestand met standaard markdown‑afbeeldingslinks, bijvoorbeeld: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – bevat `img_0.png`, `img_1.jpg`, enz., in dezelfde volgorde als ze in het oorspronkelijke Word‑document verschenen. + +Het uitvoeren van het programma geeft een vriendelijke bevestiging weer, zodat je weet dat het proces geslaagd is. + +--- + +## Veelgestelde vragen (FAQ) + +### Hoe afbeeldingen uit Word extraheren zonder kwaliteitsverlies? + +De callback schrijft de ruwe binaire stroom direct naar een bestand, waardoor de oorspronkelijke resolutie behouden blijft. Er vindt geen conversie of compressie plaats tenzij je zelf beeldverwerkingslogica toevoegt binnen `ResourceSaving`. + +### Kan ik het afbeeldingsformaat (bijv. PNG → JPEG) wijzigen tijdens het extraheren? + +Zeker. Binnen `ResourceSaving` kun je `args.FileName` of `args.Stream` inspecteren, de afbeelding laden met `System.Drawing` of `ImageSharp`, en vervolgens opnieuw coderen voordat je schrijft. Vergeet niet de extensie in de markdown‑link overeenkomstig aan te passen. + +### Wat als ik wil dat de markdown‑bestanden naar een CDN verwijzen in plaats van een lokale map? + +Pas de callback aan zodat er een basis‑URL wordt voorgeplaatst bij de markdown‑link. Je kunt dit doen door `args.FileName` te zetten op een volledig gekwalificeerde URL nadat je de afbeelding naar je CDN hebt geüpload. + +### Werkt dit met tabellen, voetnoten of andere geavanceerde Word‑functies? + +Ja. Aspose.Words vertaalt de meeste Word‑constructies naar markdown‑equivalenten. Tabellen worden markdown‑tabellen, voetnoten worden referentielinks, en zelfs geneste lijsten worden netjes afgehandeld. Als er iets vreemd uitziet, controleer dan de laatste release‑notes — Aspose verbetert de conversiekwaliteit continu. + +### Hoe docx naar markdown converteren in een CI/CD‑pipeline? + +Voeg simpelweg de gecompileerde `.exe` toe aan je build‑stappen, wijs deze op de gegenereerde `.docx`‑artefacten, en push de resulterende `.md`‑ en `Resources/`‑map naar je static‑site repository. Omdat het proces volledig deterministisch is, werkt het goed in geautomatiseerde omgevingen. + +--- + +## Afronding + +We hebben zojuist laten zien hoe je **markdown uit Word kunt maken** met Aspose.Words, de volledige **docx naar markdown**‑workflow behandeld, en een praktische manier getoond om **afbeeldingen uit Word te extraheren** met een aangepaste **hoe‑je‑een‑callback‑gebruikt**‑implementatie. Het resultaat is een nette markdown‑file gekoppeld aan een map met originele afbeeldingen — perfect voor documentatiesites, statische blogs of elke workflow die plain‑text‑formaten prefereert. + +Volgende stappen die je kunt overwegen: + +- **Batchverwerking** van meerdere `.docx`‑bestanden in een map (loop over `Directory.GetFiles`). +- **Aangepaste naamgevingsschema’s** voor afbeeldingen (bijv. met de oorspronkelijke bijschrift‑tekst). +- **Post‑processing** van de markdown om afbeeldingslinks te vervangen door CDN‑URL’s. +- Verkennen van **andere Aspose‑exportformaten** zoals HTML, PDF of EPUB voor multi‑channel publicatie. + +Heb je meer vragen of een lastig Word‑bestand dat niet wil converteren? Laat een reactie achter, en laten we samen het probleem oplossen. Veel programmeerplezier, en geniet van de eenvoud van Word naar markdown omzetten! + +--- + +![Diagram dat het conversieproces van Word naar Markdown toont](image.png "Diagram van Word naar Markdown conversie") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/dutch/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/dutch/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..ab3adc9095 --- /dev/null +++ b/words/dutch/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Hoe LaTeX te exporteren vanuit DOCX met Aspose.Words. Leer hoe je DOCX + naar Markdown converteert, DPI instelt en herstel inschakelt in C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: nl +og_description: Hoe LaTeX te exporteren vanuit DOCX met Aspose.Words. Deze tutorial + toont stap‑voor‑stap conversie naar Markdown, DPI‑regeling en herstelmodus. +og_title: Hoe LaTeX exporteren vanuit DOCX – Converteren naar Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Hoe LaTeX exporteren vanuit DOCX – Converteren naar Markdown +url: /nl/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe LaTeX exporteren vanuit DOCX – Converteren naar Markdown + +Heb je je ooit afgevraagd **hoe je LaTeX kunt exporteren** vanuit een DOCX‑bestand zonder de schoonheid van je vergelijkingen te verliezen? Je bent niet de enige. Naar mijn ervaring is het grootste pijnpunt het krijgen van die OfficeMath‑objecten in een schoon, draagbaar formaat voor static‑site generators of wetenschappelijke blogs. + +In deze gids lopen we stap voor stap door het converteren van DOCX naar Markdown met Aspose.Words, terwijl we ook **hoe je DPI instelt**, **hoe je herstel inschakelt**, en een paar handige trucjes voor een robuuste pipeline laten zien. Aan het einde heb je een enkel C#‑programma dat een Markdown‑bestand produceert met LaTeX‑vergelijkingen, hoge‑resolutie‑afbeeldingen en correcte hyperlink‑verwerking. + +## Wat je nodig hebt + +- **.NET 6+** (of .NET Framework 4.7.2 – de API werkt hetzelfde) +- **Aspose.Words for .NET** (de nieuwste stabiele versie vanaf maart 2026) +- Een DOCX‑bestand dat vergelijkingen, afbeeldingen en links bevat +- Visual Studio, VS Code, of elke editor die je verkiest + +Er zijn geen extra NuGet‑pakketten nodig naast Aspose.Words, maar zorg ervoor dat je een geldige licentie hebt als je de proefversie niet gebruikt. + +## Stap 1 – Laad de DOCX met Strikte Herstelmodus + +Voordat we zelfs maar aan exporteren denken, moeten we ervoor zorgen dat het bron‑document geen corruptie verbergt. Daar komt **how to enable recovery** om de hoek kijken. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Waarom strikte herstel?** +Als je Aspose stilletjes problemen laat oplossen, kun je eindigen met ontbrekende alinea's of kapotte afbeeldingen — iets wat niemand wil bij het exporteren van LaTeX. Door snel te falen, kun je het probleem vroeg opsporen en beslissen of je het bron‑DOCX moet repareren of het probleem later logt. + +### Pro‑tip +Wikkel het laden in een try/catch en log `DocumentLoadingException`. Op die manier kan je CI‑pipeline problematische bestanden markeren zonder de volledige build te stoppen. + +## Stap 2 – Bereid de Markdown‑Exportopties voor + +Nu het document veilig in het geheugen staat, configureren we hoe het wordt opgeslagen. Dit is de kern van **how to export latex** en behandelt ook **how to set DPI** voor ingesloten afbeeldingen. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Wat elke optie doet** + +| Option | Reden | Relevantie voor trefwoorden | +|--------|-------|-----------------------------| +| `OfficeMathExportMode = LaTeX` | Beantwoordt direct **how to export latex** vanuit vergelijkingen. | Primair trefwoord | +| `ImageResolution = 300` | Beheert de beeldkwaliteit – het antwoord op **how to set dpi**. | Secundair | +| `ResourceSavingCallback` | Slaat ingesloten bestanden op naar schijf, een veelvoorkomende behoefte bij **convert docx to markdown**. | Secundair | +| `EmptyParagraphExportMode` | Garandeert schone Markdown‑output, voorkomt vreemde HTML‑tags. | Verbeterde algehele conversiekwaliteit | +| `LinkExportMode = AsReference` | Maakt links gemakkelijk leesbaar en bewerkbaar, een extra voordeel voor **convert docx to markdown**. | | + +## Stap 3 – Implementeer een Aangepaste Resource‑Saver (Optioneel maar Handig) + +Wanneer je DOCX naar Markdown converteert, hebben afbeeldingen en andere binaire resources een plek op het bestandssysteem nodig. Aspose laat je dat beheren met `IResourceSavingCallback`. Het fragment hierboven toont al een minimale implementatie, maar laten we het ontleden: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Waarom de moeite waard?** +Als je deze stap overslaat, zal Aspose afbeeldingen insluiten als base‑64‑strings, waardoor de Markdown‑bestandsgrootte enorm toeneemt en versiebeheer pijnlijk wordt. Door resources op te slaan in een aparte map, houd je de Markdown lichtgewicht en maak je het vriendelijk voor static‑site generators zoals Hugo of Jekyll. + +## Stap 4 – Sla het document op als Markdown + +Al het zware werk is gedaan. Eén regel schrijft nu het uiteindelijke bestand. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Open `output.md` en je zult zien: + +- Vergelijkingen weergegeven als `$…$` LaTeX‑blokken +- Afbeeldingen gerefereerd als `![Alt text](resources/image001.png)` met een resolutie van 300 dpi +- Hyperlinks omgezet naar referentiestijl: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Dat is het volledige **how to convert docx**‑proces in één notendop. + +## Veelgestelde vragen & randgevallen + +### 1️⃣ Wat als het DOCX niet‑ondersteunde objecten bevat? +Aspose.Words zal een `FeatureNotSupportedException` werpen. Omdat we **how to enable recovery** in de strikte modus hebben gebruikt, verschijnt de uitzondering meteen. Je kunt: + +- Schakel `RecoveryMode` over naar `RecoveryMode.Default` voor een best‑effort conversie, **of** +- Pre‑process het DOCX (bijv. verwijder niet‑ondersteunde SmartArt) voordat je de converter uitvoert. + +### 2️⃣ Kan ik de DPI per afbeelding aanpassen? +De instelling `ImageResolution` is globaal. Voor per‑afbeelding controle, implementeer een aangepaste `ImageSavingCallback` vergelijkbaar met `MyResourceSaver` en pas `args.ImageResolution` aan op basis van `args.ImageFileName` of metadata. + +### 3️⃣ Hoe embed ik de gegenereerde LaTeX in een Jekyll‑site? +De ingebouwde MathJax‑ondersteuning van Jekyll werkt direct. Zorg er alleen voor dat je layout het MathJax‑script bevat en dat de LaTeX‑blokken zijn omgeven door `$$` voor weergave‑vergelijkingen of `$` voor inline. + +### 4️⃣ Is dit compatibel met .NET Core op Linux? +Absoluut. Aspose.Words is cross‑platform. Zorg er alleen voor dat het pad `YOUR_DIRECTORY` de Linux‑conventies volgt (bijv. `/home/user/docs`). + +## Volledig werkend voorbeeld + +Hieronder staat een kant‑en‑klaar programma. Vervang `YOUR_DIRECTORY` door een daadwerkelijk pad op jouw machine. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Verwachte output** – open `output.md` en je zou iets dergelijks moeten zien: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Als je het bestand opent in een Markdown‑preview die MathJax ondersteunt, wordt de integraal weergegeven + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/dutch/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/dutch/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..cc797e692c --- /dev/null +++ b/words/dutch/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-03-27 +description: Hoe LaTeX te exporteren uit Word‑documenten met Aspose.Words – converteer + DOCX naar Markdown met vergelijkingen als LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: nl +og_description: Hoe je LaTeX exporteert vanuit Word‑documenten wordt uitgelegd in + de eerste zin, waarin wordt getoond hoe je DOCX naar Markdown converteert met vergelijkingen + als LaTeX. +og_title: Hoe LaTeX vanuit Word te exporteren – Complete gids +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Hoe LaTeX exporteren vanuit Word – DOCX naar Markdown converteren +url: /nl/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe LaTeX exporteren vanuit Word – DOCX naar Markdown converteren + +Heb je je ooit afgevraagd **hoe je LaTeX kunt exporteren** vanuit een Word‑bestand zonder dat je eindigt met een hoop PNG‑afbeeldingen? Je bent niet de enige; ontwikkelaars lopen hier voortdurend tegenaan wanneer ze schone, bewerkbare vergelijkingen nodig hebben voor statische sites of wetenschappelijke blogs. Het goede nieuws? Met Aspose.Words kun je **Word naar Markdown converteren** en elk OfficeMath‑object behouden als native LaTeX—geen nabewerking nodig. + +In deze tutorial lopen we stap voor stap het volledige proces door van **een Word‑document opslaan als Markdown** terwijl **vergelijkingen worden geëxporteerd als LaTeX**. Aan het einde heb je een uitvoerbare C#‑snippet, een duidelijke uitleg van elke optie, en tips voor het omgaan met randgevallen zoals complexe formules of gemengde inhoud. Geen externe tools, alleen één NuGet‑pakket en een paar regels code. + +## Wat je nodig hebt + +- .NET 6+ (of .NET Framework 4.7.2 en hoger) – de nieuwste runtime werkt het beste. +- Visual Studio 2022 of een andere editor die C#‑projecten kan compileren. +- Een Aspose.Words for .NET‑licentie (de gratis proefversie is voldoende voor experimenten). +- Een DOCX‑bestand dat minstens één vergelijking bevat (OfficeMath). + +Als je dit al hebt, prima—laten we beginnen. + +## Hoe LaTeX exporteren vanuit Word – Overzicht + +Hieronder zie je een overzicht van de stappen die nodig zijn: + +1. **Installeer** het Aspose.Words‑NuGet‑pakket. +2. **Laad** de bron‑`.docx` die je vergelijkingen bevat. +3. **Configureer** `MarkdownSaveOptions` zodat `OfficeMathExportMode` is ingesteld op `LaTeX`. +4. **Sla** het document op als een `.md`‑bestand. +5. **Controleer** of de gegenereerde Markdown LaTeX‑blokken (`$$…$$`) bevat. + +Elk van deze stappen wordt in detail uitgelegd in de volgende secties. + +![Diagram die de stroom van DOCX naar Markdown met LaTeX‑vergelijkingen toont](how-to-export-latex.png){alt="Diagram hoe LaTeX vanuit Word te exporteren"} + +## Stap 1 – Installeer Aspose.Words for .NET (convert word to markdown) + +Allereerst: je hebt de bibliotheek nodig die het zware werk doet. Open je terminal (of Package Manager Console) en voer uit: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** Als je Visual Studio gebruikt, klik met de rechtermuisknop op het project → *Manage NuGet Packages* → zoek naar “Aspose.Words” en installeer de nieuwste stabiele versie. + +Waarom dit belangrijk is: Aspose.Words abstraheert het Open XML‑formaat, waardoor je een nette API krijgt om Word‑documenten te manipuleren zonder zelf met de low‑level XML te hoeven werken. Het pakket bevat bovendien ingebouwde ondersteuning voor het converteren van OfficeMath naar LaTeX, wat de kern is van onze **export equations as LaTeX**‑vereiste. + +## Stap 2 – Laad de DOCX (how to convert docx) + +Nu het pakket geïnstalleerd is, laad je het bestand dat je wilt transformeren. Vervang `YOUR_DIRECTORY` door het pad waar je `.docx` zich bevindt: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Waarom op deze manier laden?** De `Document`‑constructor parseert het volledige bestand naar een objectmodel, waardoor je direct toegang krijgt tot alinea’s, tabellen en—het belangrijkste—OfficeMath‑objecten. Als het bestand ontbreekt of corrupt is, gooit Aspose een beschrijvende `FileNotFoundException`, die je kunt opvangen voor een nette foutafhandeling. + +## Stap 3 – Configureer MarkdownSaveOptions (export equations as latex) + +De magie gebeurt in het `MarkdownSaveOptions`‑object. Standaard zou Aspose vergelijkingen renderen als PNG‑afbeeldingen, maar wij willen LaTeX. Stel `OfficeMathExportMode` in op `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Een korte toelichting op de optionele vlaggen: `ExportImagesAsBase64` vertelt Aspose geen binaire data in te sluiten, waardoor de Markdown schoon blijft. `ExportHeadersFooters` zorgt ervoor dat je geen context verliest die zich in die secties bevindt—handig wanneer de header een titel of auteursnaam bevat. + +## Stap 4 – Sla het document op (save word as markdown) + +Schrijf tenslotte de getransformeerde inhoud naar een `.md`‑bestand: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Na het uitvoeren van deze regel vind je `output.md` naast je bronbestand. Open het in een teksteditor en je zou LaTeX‑blokken moeten zien die er zo uitzien: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Dat is het **save word as markdown**‑gedeelte afgerond—geen extra conversiestappen nodig. + +## Stap 5 – Controleer het resultaat (export equations as latex) + +Het is makkelijk om verificatie over het hoofd te zien, maar een snelle sanity‑check bespaart later uren. Voer een simpel script uit dat het gegenereerde bestand leest en het eerste LaTeX‑blok afdrukt: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Als je `First LaTeX block: $$ … $$` ziet verschijnen, heb je succesvol **LaTeX geëxporteerd** vanuit Word. Zo niet, controleer dan of je bron‑document daadwerkelijk OfficeMath‑objecten bevat; gewone tekst‑vergelijkingen worden niet omgezet. + +## Veelvoorkomende randgevallen behandelen + +| Scenario | Waar op te letten | Aanbevolen oplossing | +|----------|-------------------|----------------------| +| **Gemengde afbeeldingen & vergelijkingen** | Aspose kan nog steeds afbeeldingen insluiten voor niet‑OfficeMath‑grafieken. | Stel `ExportImagesAsBase64 = false` in en bewaar afbeeldingen als externe bestanden, waarna je ze handmatig in Markdown kunt refereren. | +| **Complexe geneste vergelijkingen** | Zeer diepe nesting kan LaTeX produceren dat handmatig moet worden aangepast. | Verwerk het blok na met een LaTeX‑formatter (bijv. `latexindent`) of pas `mdOptions` → `ExportMathAsDisplay = true` aan. | +| **Grote documenten** | Geheugengebruik piekt bij het laden van enorme `.docx`‑bestanden. | Gebruik `LoadOptions` met `LoadFormat.Docx` en schakel streaming in via `LoadOptions.LoadFormat` indien beschikbaar. | +| **Ontbrekende licentie** | De gratis proefversie voegt een watermerk‑commentaar toe aan de output. | Pas een geldige licentie toe via `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Deze tips houden je workflow robuust, vooral wanneer je **convert word to markdown** in productie‑pipelines gebruikt. + +## Volledig werkend voorbeeld (Alle stappen in één bestand) + +Hieronder vind je een zelfstandige console‑app die je kunt kopiëren‑plakken in een nieuw .NET‑project en direct kunt uitvoeren. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Run het programma, open `output.md`, en je ziet je vergelijkingen weergegeven als nette LaTeX. Dat is het volledige antwoord op **how to export latex** vanuit een Word‑document. + +## Conclusie + +We hebben stap voor stap behandeld **hoe je LaTeX kunt exporteren** vanuit Word, en laten zien hoe je **Word naar Markdown kunt converteren**, **word als markdown kunt opslaan**, en **vergelijkingen als LaTeX kunt exporteren** met Aspose.Words. Het kernidee is simpel: laad de DOCX, pas `MarkdownSaveOptions` aan, en laat de bibliotheek het zware werk doen. + +Als je klaar bent om documentatie‑pipelines te automatiseren, probeer dan deze code te koppelen aan een static‑site‑generator zoals Hugo of Jekyll—plaats simpelweg de gegenereerde `.md`‑bestanden in je repo en laat de site opnieuw bouwen. Voor meer verdieping, bekijk Aspose’s “Export to LaTeX”‑gids, experimenteer met `HtmlSaveOptions` voor web‑previews, of duik in de `DocumentVisitor`‑API voor aangepaste transformaties. + +Heb je vragen over randgevallen, licenties, of integratie in CI/CD? Laat een reactie achter, en happy coding! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/dutch/net/programming-with-pdfsaveoptions/_index.md b/words/dutch/net/programming-with-pdfsaveoptions/_index.md index fd597d9b5e..8fe4c63236 100644 --- a/words/dutch/net/programming-with-pdfsaveoptions/_index.md +++ b/words/dutch/net/programming-with-pdfsaveoptions/_index.md @@ -45,6 +45,7 @@ Of u nu Word-documenten naar PDF wilt converteren voor online distributie, archi | [Laatst afgedrukte eigenschap in PDF-document bijwerken](./update-last-printed-property/) | Leer hoe u de laatst afgedrukte eigenschap in een PDF-document kunt bijwerken met Aspose.Words voor .NET met onze stapsgewijze handleiding. | | [3D DML 3D-effecten renderen in een PDF-document](./dml-3deffects-rendering/) | Leer hoe u verbluffende 3D DML-effecten kunt maken in PDF-documenten met Aspose.Words voor .NET met deze uitgebreide stapsgewijze handleiding. | | [Afbeeldingen in een PDF-document interpoleren](./interpolate-images/) | Leer hoe u afbeeldingen in een PDF-document kunt interpoleren met Aspose.Words voor .NET met onze stapsgewijze handleiding. Verbeter eenvoudig de beeldkwaliteit van uw PDF. | +| [PDF opslaan vanuit DOCX met Aspose.Words – Stapsgewijze handleiding](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Leer hoe u een DOCX-bestand naar PDF converteert met Aspose.Words via een eenvoudige stap‑voor‑stap handleiding. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/dutch/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/dutch/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..55f3750b60 --- /dev/null +++ b/words/dutch/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-03-27 +description: Leer hoe je een PDF kunt opslaan vanuit een DOCX‑bestand met Aspose.Words. + Inclusief het converteren van DOCX naar PDF, PDF opslaan met opties en het omgaan + met zwevende vormen. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: nl +og_description: Hoe PDF opslaan vanuit een DOCX‑bestand met Aspose.Words. Deze gids + laat zien hoe je docx naar pdf converteert, pdf opslaat met opties en zwevende vormen + verwerkt. +og_title: Hoe PDF opslaan vanuit DOCX – Complete Aspose.Words tutorial +tags: +- Aspose.Words +- C# +- PDF conversion +title: Hoe PDF opslaan vanuit DOCX met Aspose.Words – Stapsgewijze handleiding +url: /nl/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe PDF op te slaan vanuit DOCX met Aspose.Words – Complete Tutorial + +Heb je je ooit afgevraagd **hoe je PDF kunt opslaan** vanuit een Word‑document zonder de lay‑out van zwevende vormen te verliezen? Je bent niet de enige. In veel projecten—factuurgeneratoren, rapport‑exporteurs of eenvoudige documentarchiveringssystemen—moeten ontwikkelaars een betrouwbare manier hebben om DOCX naar PDF te converteren terwijl alles er precies uitziet als in Word. + +In deze tutorial lopen we stap voor stap door het converteren van een DOCX‑bestand naar PDF **met Aspose.Words voor .NET**, laten we je **hoe je docx naar pdf converteert** met aangepaste opslaan‑opties zien, en leggen we uit waarom de `ExportFloatingShapesAsInlineTag`‑vlag belangrijk is. Aan het einde heb je een kant‑klaar fragment dat PDF opslaat met opties die jij beheert. + +## Wat je zult leren + +- De exacte stappen om **word document pdf te converteren** met Aspose.Words. +- Hoe je `PdfSaveOptions` configureert om zwevende vormen als inline‑tags te behandelen. +- Veelvoorkomende valkuilen bij zwevende objecten en hoe je ze kunt vermijden. +- Een compleet, uitvoerbaar C#‑programma dat je in elk .NET‑project kunt plaatsen. + +> **Voorwaarde:** Je hebt een Aspose.Words for .NET‑licentie (of een gratis evaluatie) en een .NET‑ontwikkelomgeving (Visual Studio, Rider of de `dotnet`‑CLI). + +## Stap 1: Het project opzetten en Aspose.Words toevoegen + +Maak eerst een nieuwe console‑app (of voeg toe aan een bestaande) en verwijs naar het Aspose.Words‑NuGet‑pakket. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro tip:** Als je op een CI‑server werkt, pin dan de pakketversie (`Aspose.Words --version 24.10`) om reproduceerbare builds te garanderen. + +## Stap 2: Laad de DOCX met zwevende vormen + +Zwevende afbeeldingen, tekstvakken of SmartArt kunnen lay‑outverschuivingen veroorzaken bij conversie. Het document laden is eenvoudig, maar we controleren ook of het bestand bestaat om een runtime `FileNotFoundException` te voorkomen. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Let op de `Console.WriteLine`‑statements—ze geven je snelle feedback wanneer je de app vanuit een terminal uitvoert. + +## Stap 3: PDF‑opslaan‑opties configureren (Save PDF with Options) + +Hier gebeurt de magie. Standaard probeert Aspose.Words zwevende objecten te behouden zoals ze verschijnen, wat de lay‑out in de resulterende PDF kan breken. Door `ExportFloatingShapesAsInlineTag` op `true` te zetten, vertel je de bibliotheek die vormen als inline‑tags te behandelen, zodat ze verankerd blijven aan de omringende tekst. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Waarom is dit belangrijk? Stel je een tekstvak voor dat boven een alinea zweeft. Zonder de inline‑tag‑conversie kan de PDF de alinea naar beneden duwen of het vak volledig afsnijden. De vlag behoudt de visuele relatie—een subtiel maar cruciaal detail voor professionele rapporten. + +## Stap 4: Sla het document op als PDF + +Nu schrijven we daadwerkelijk het PDF‑bestand weg. De `Save`‑methode krijgt zowel het uitvoerpad als de opties die we zojuist hebben ingesteld. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Het uitvoeren van het programma levert `output.pdf` op in dezelfde map als je bron‑DOCX. Open het in een PDF‑viewer en je zult zien dat alle zwevende vormen precies daar worden weergegeven waar ze horen. + +## Volledig werkend voorbeeld + +Hieronder staat het volledige programma in één blok. Kopieer‑plak het in `Program.cs` (of een ander C#‑bestand) en druk op **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Verwacht resultaat + +- **Bestand aangemaakt:** `output.pdf` in de doelmap. +- **Lay‑out getrouwheid:** Zwevende vormen (afbeeldingen, tekstvakken, SmartArt) verschijnen inline met de omringende tekst. +- **Geen uitzonderingen:** Het programma sluit netjes af en print statusmeldingen naar de console. + +## Veelgestelde vragen & randgevallen + +| Vraag | Antwoord | +|----------|--------| +| **Wat als ik een hogere beeldkwaliteit nodig heb?** | Stel `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Kan ik meerdere DOCX‑bestanden in één batch converteren?** | Plaats de laad‑/opslaan‑logica in een `foreach (var file in Directory.GetFiles(..., "*.docx"))`‑lus. Hergebruik één `PdfSaveOptions`‑instantie voor betere prestaties. | +| **Werkt dit met .NET Core?** | Absoluut. Aspose.Words 24.x ondersteunt .NET Standard 2.0+, dus je kunt dezelfde code draaien op Windows, Linux of macOS. | +| **Hoe zit het met met wachtwoord‑beveiligde DOCX‑bestanden?** | Laad met `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. Dezelfde `PdfSaveOptions` gelden bij het opslaan. | +| **Is de inline‑tag‑conversie veilig voor complexe tabellen?** | Over het algemeen wel, maar zeer ingewikkelde tabelindelingen met overlappende vormen kunnen nog handmatige aanpassingen vereisen. Test een representatieve steekproef vóór een bulk‑migratie. | + +## Tips voor real‑world projecten + +- **Log, niet alleen `Console.WriteLine`** – Vervang in productie console‑output door een logging‑framework (Serilog, NLog) om fouten vast te leggen. +- **Resources vrijgeven** – `Document` implementeert `IDisposable`. Plaats het in een `using`‑blok als je veel bestanden verwerkt om geheugen tijdig vrij te maken. +- **Valideer de PDF** – Gebruik een PDF‑validator (bijv. PDF/A‑compliance‑checker) als je archiverings‑grade PDF’s nodig hebt. +- **Parallel verwerken** – Voor enorme workloads kun je `Parallel.ForEach` gebruiken met thread‑veilige `PdfSaveOptions` (clone per thread) om de conversie te versnellen. + +## Conclusie + +We hebben behandeld **hoe je PDF opslaat** vanuit een DOCX‑bestand met Aspose.Words, laten zien **hoe je docx naar pdf converteert** met aangepaste opties, en de impact van `ExportFloatingShapesAsInlineTag` uitgelegd. Het complete, uitvoerbare voorbeeld toont dat je **word document pdf** kunt converteren in slechts een handvol regels, en je weet nu hoe je **pdf met opties kunt opslaan** die passen bij de kwaliteit‑ en compliance‑eisen van je project. + +Klaar voor de volgende uitdaging? Probeer te exporteren naar andere formaten (bijv. HTML, EPUB) met `document.Save("output.html")`, of experimenteer met PDF/A‑compliance voor langdurige archivering. Dezelfde principes—laden, opties configureren, opslaan—gelden overal. + +Happy coding, en moge je PDF’s altijd precies zo eruitzien als jij ze bedoeld hebt! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/dutch/net/programming-with-shapes/_index.md b/words/dutch/net/programming-with-shapes/_index.md index 909f1f2340..4d06dd2536 100644 --- a/words/dutch/net/programming-with-shapes/_index.md +++ b/words/dutch/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Door Aspose.Words voor .NET te gebruiken en deze tutorials te volgen, krijgt u d | [Detecteer slimme kunstvorm](./detect-smart-art-shape/) | Leer hoe u SmartArt-vormen in Word-documenten kunt detecteren met Aspose.Words voor .NET met deze uitgebreide handleiding. Perfect voor het automatiseren van uw documentworkflow. | | [Smart Art-tekening bijwerken](./update-smart-art-drawing/) | Leer hoe u Smart Art-tekeningen in Word-documenten kunt bijwerken met Aspose.Words voor .NET met de stapsgewijze handleiding. Zorg ervoor dat uw afbeeldingen altijd accuraat zijn. | | [Rechthoekvorm maken in Word met Aspose.Words – Stapsgewijze handleiding](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Leer hoe u een rechthoekvorm toevoegt en aanpast in een Word‑document met Aspose.Words voor .NET. | +| [Word-document maken C# – Vorm met schaduw toevoegen](./create-word-document-c-add-shape-with-shadow/) | Leer hoe u een vorm met schaduw toevoegt aan een Word‑document met Aspose.Words voor .NET in C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/dutch/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/dutch/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..a7128452e8 --- /dev/null +++ b/words/dutch/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: Maak een Word‑document in C# en leer hoe je een vorm toevoegt, een schaduw + op de vorm toepast en de schaduwafstand instelt. Stapsgewijze handleiding voor Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: nl +og_description: Maak een Word-document in C# met een rechthoekvorm en aangepaste schaduw. + Volg deze volledige tutorial om de schaduwafstand en stijl in te stellen. +og_title: Word-document maken C# – Vorm met schaduw toevoegen +tags: +- Aspose.Words +- C# +- Document Automation +title: Word-document maken C# – Vorm met schaduw toevoegen +url: /nl/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word-document maken met C# – Vorm toevoegen met schaduw + +Heb je ooit een **create word document c#** nodig gehad die een mooi gestileerde rechthoek bevat? Misschien bouw je een rapporttemplate en wil je een subtiele slagschaduw om de lay-out meer te laten opvallen. In deze tutorial lopen we precies dat stap voor stap door – hoe je een vorm toevoegt, een schaduw op de vorm toepast en zelfs de schaduwdistance aanpast met Aspose.Words. + +We beginnen met een leeg document, voegen een rechthoek toe, geven het een voorgedefinieerde schaduw en slaan het bestand op. Aan het einde heb je een kant‑klaar .docx dat je in Word kunt openen en direct het effect ziet. Geen externe tools, alleen pure C#‑code. + +## Vereisten + +- .NET 6 (of een recente .NET Framework) geïnstalleerd. +- Visual Studio 2022 of VS Code met C#‑extensie. +- Aspose.Words for .NET NuGet‑pakket (`Aspose.Words` versie 23.12 of later). + Je kunt het toevoegen via de Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +Dat is alles – geen extra DLL’s of COM‑interop nodig. + +## Stap 1: Een nieuw document en builder initialiseren – *create word document c#* basisprincipes + +Eerst hebben we een `Document`‑object nodig dat het Word‑bestand vertegenwoordigt en een `DocumentBuilder` om het te bewerken. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Waarom deze stap belangrijk is:** De `Document`‑klasse is de container voor alle Word‑onderdelen (pagina’s, stijlen, afbeeldingen). De builder is de high‑level API die low‑level knooppuntmanipulatie abstraheert, waardoor het eenvoudig is om **create word document c#** uit te voeren zonder direct met XML te werken. + +## Stap 2: Een rechthoekvorm invoegen – *how to create rectangle* + +Nu plaatsen we een rechthoek op de pagina. De grootte wordt uitgedrukt in punten (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro tip:** Als je een andere vorm nodig hebt, vervang dan simpelweg `ShapeType.Rectangle` door `ShapeType.Ellipse`, `ShapeType.Triangle`, enz. Dezelfde code werkt voor **how to add shape** van elk type. + +## Stap 3: Een voorgedefinieerde schaduw toepassen en verfijnen – *apply shadow to shape* + +Aspose.Words wordt geleverd met verschillende voorgedefinieerde schaduwformaten. We gebruiken `Preset1` en passen vervolgens afstand, vervaging, transparantie en kleur aan. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Waarom de schaduw aanpassen?** De `Distance`‑eigenschap bepaalt hoe ver de schaduw van de rechthoek af staat – zie het als de “lift” die je in een 3‑D‑rendering zou zien. Het wijzigen van `BlurRadius` verzacht de randen, terwijl `Transparency` je een subtiele, professionele uitstraling geeft. Dit dekt de **set shadow distance**‑vereiste en laat zien hoe je **apply shadow to shape** op een flexibele manier kunt toepassen. + +## Stap 4: Het document opslaan – *create word document c#* voltooiing + +Tot slot schrijf je het document naar schijf. Pas het pad aan naar een map waar je schrijfrechten voor hebt. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Open het resulterende bestand in Microsoft Word, en je ziet een lichtblauwe rechthoek met een zachte grijze schaduw die 5 pt is verschoven. Dat is het visuele bewijs dat je succesvol **create word document c#** hebt gemaakt met een gestylede vorm. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# voorbeeld dat een rechthoek met schaduw toont"} + +## Optionele variaties & randgevallen + +| Scenario | Wat te wijzigen | Waarom het belangrijk is | +|----------|----------------|--------------------------| +| **Andere schaduwstijl** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Geeft je een dramatischer uiterlijk zonder extra code. | +| **Geen preset – aangepaste schaduw** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Volledige controle over richting en diepte. | +| **Meerdere vormen** | Call `builder.InsertShape` again before saving. | Handig voor complexe sjablonen met iconen, logo’s, enz. | +| **Compatibiliteit met oudere Aspose‑versies** | Use `ShadowEffect` class (available in v20.x). | Zorgt ervoor dat je code werkt in legacy‑projecten. | +| **Opslaan als PDF** | `document.Save("ShadowShape.pdf");` | Dezelfde schaduwweergave verschijnt in de PDF‑output. | + +> **Veelgestelde vraag:** *Wat als de schaduw niet verschijnt in Word?* +> Zorg ervoor dat je een recente versie van Aspose.Words gebruikt (≥ 22.9). Oudere releases hadden beperkte schaduwondersteuning. Controleer ook dat het document wordt geopend in een recente versie van Word (2016+). + +## Volledig werkend voorbeeld + +Hieronder staat het volledige, kant‑klaar te kopiëren programma. Het bevat alle `using`‑directieven, commentaren en foutafhandeling voor een soepele ervaring. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Voer het programma uit, ga naar `C:\Temp\ShadowShape.docx`, en je ziet de rechthoek met de exacte schaduw die we hebben geconfigureerd. + +## Samenvatting & volgende stappen + +- Je weet nu hoe je **create word document c#** maakt, een rechthoek invoegt, en **apply shadow to shape** toepast met een aangepaste **set shadow distance**. +- Het voorbeeld gebruikt Aspose.Words, dat de OpenXML‑complexiteit abstraheert en consistente weergave garandeert over verschillende Word‑versies. +- Wil je verder gaan? Probeer meerdere vormen te combineren, tekst binnen de rechthoek toe te voegen, of hetzelfde document als PDF te exporteren om te zien hoe de schaduw wordt overgezet. + +### Gerelateerde onderwerpen die je kunt verkennen + +- **How to add shape** aan een header/footer voor branding. +- Gebruik van **Aspose.Words** om grafieken en tabellen programmatisch in te voegen. +- **shadow effects** aanpassen op afbeeldingen in plaats van vectorvormen. +- Bulk‑documentgeneratie automatiseren voor facturen of certificaten. + +Voel je vrij om te experimenteren, de code te breken en vervolgens opnieuw op te bouwen – dat is de snelste manier om de concepten te internaliseren. Als je tegen een probleem aanloopt, laat dan een reactie achter of raadpleeg de officiële Aspose.Words‑documentatie voor diepere API‑inzichten. + +Veel plezier met coderen, en geniet ervan om je Word‑bestanden er net iets netter uit te laten zien! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/dutch/net/programming-with-txtsaveoptions/_index.md b/words/dutch/net/programming-with-txtsaveoptions/_index.md index 531ca961c8..c694f827a7 100644 --- a/words/dutch/net/programming-with-txtsaveoptions/_index.md +++ b/words/dutch/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Dankzij deze tutorials kunt u de functionaliteiten van Aspose.Words voor .NET op | [Bidi-markeringen toevoegen aan een Word-document](./add-bidi-marks/) | Leer hoe u bidirectionele (Bidi) markeringen toevoegt aan Word-documenten met Aspose.Words voor .NET met deze handleiding. Zorg voor de juiste tekstrichting voor meertalige content. | | [Gebruik tabteken per niveau voor lijstinspringing](./use-tab-character-per-level-for-list-indentation/) | Leer hoe u lijsten met meerdere niveaus en tab-inspringing maakt met Aspose.Words voor .NET. Volg deze handleiding voor nauwkeurige lijstopmaak in uw documenten. | | [Gebruik spatieteken per niveau voor lijstinspringing](./use-space-character-per-level-for-list-indentation/) | Leer hoe u lijsten met meerdere niveaus met spatie-inspringing maakt in Aspose.Words voor .NET. Stapsgewijze handleiding voor nauwkeurige documentopmaak. | - +| [Docx opslaan als txt – Complete gids voor het exporteren van Word‑vergelijkingen naar LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Leer hoe u een DOCX‑bestand als TXT exporteert en Word‑vergelijkingen omzet naar LaTeX met Aspose.Words voor .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/dutch/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/dutch/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..0a30eff2f5 --- /dev/null +++ b/words/dutch/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-03-27 +description: Sla docx op als txt met Aspose.Words en converteer Word naar LaTeX. Leer + hoe je vergelijkingen exporteert, platte tekst behoudt en binnen enkele minuten + LaTeX-markup krijgt. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: nl +og_description: Sla docx op als txt met Aspose.Words. Deze gids laat zien hoe je Word + naar LaTeX converteert, vergelijkingen exporteert en je document als platte tekst + behoudt. +og_title: Docx opslaan als txt – Export Word‑vergelijkingen naar LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Docx opslaan als txt – Complete gids voor het exporteren van Word‑vergelijkingen + naar LaTeX +url: /nl/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# DOCX opslaan als txt – Word‑vergelijkingen exporteren naar LaTeX + +Heb je ooit **docx als txt moeten opslaan** maar was je bang dat je de mooie wiskunde die in je Word‑bestand zit zou verliezen? Je bent niet de enige. In veel wetenschappelijke workflows is de platte‑tekstversie van een document een must, maar je wilt toch dat de vergelijkingen behouden blijven als nette LaTeX‑markup. + +In deze tutorial lopen we de exacte stappen door om **Word naar LaTeX te converteren** met Aspose.Words voor .NET, zodat je vergelijkingen correct worden geëxporteerd terwijl de rest van het document nette platte tekst wordt. Aan het einde weet je hoe je **vergelijkingen naar LaTeX kunt exporteren**, de rest van het bestand als eenvoudige tekst kunt behouden, en de gebruikelijke valkuilen kunt vermijden die nieuwkomers tegenkomen. + +## Wat je zult leren + +- Hoe je een *.docx*-bestand laadt dat Office Math bevat. +- De juiste `TxtSaveOptions` instellen zodat Aspose LaTeX voor elke vergelijking uitvoert. +- Het resultaat opslaan als een **save word plain text**‑bestand dat je kunt gebruiken in versiebeheer, CI‑pipelines of een ander downstream‑tool. +- Veelvoorkomende randgevallen—wat te doen wanneer een document afbeeldingen en vergelijkingen mixt, of wanneer je Unicode‑tekens moet behouden. +- Een volledige, kant‑klaar‑te‑runnen code‑voorbeeld dat je in een console‑app kunt plaatsen. + +### Vereisten + +- .NET 6.0 of later (de code werkt ook met .NET Framework 4.7+). +- Een gelicentieerde kopie van **Aspose.Words for .NET** (de gratis proefversie werkt voor testen). +- Visual Studio 2022 of een IDE die C#‑projecten kan compileren. +- Een Word‑document (`input.docx`) dat al enkele Office Math‑objecten bevat. + +> **Pro tip:** Als je nog geen licentie hebt, kun je een tijdelijke sleutel aanvragen op de website van Aspose—vervang gewoon de placeholder in de code door je sleutel voordat je het uitvoert. + +## Stap 1 – Installeer Aspose.Words via NuGet + +Allereerst: je hebt de bibliotheek nodig in je project. Open de **Package Manager Console** en voer uit: + +```powershell +Install-Package Aspose.Words +``` + +Die ene regel haalt alles op wat je nodig hebt, inclusief de `Saving`‑namespace waar `TxtSaveOptions` zich bevindt. Geen extra DLL’s, geen native afhankelijkheden—alleen pure managed code. + +## Stap 2 – Laad het bron‑Word‑document + +Nu lezen we daadwerkelijk het bestand dat de vergelijkingen bevat. De `Document`‑klasse abstraheert de volledige *.docx*‑structuur, zodat je het kunt behandelen als een high‑level objectmodel. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Waarom dit belangrijk is:** Het document vroeg laden stelt je in staat de knooppuntstructuur te inspecteren. Als je de controle overslaat en het bestand geen vergelijkingen bevat, krijg je nog steeds een schoon txt‑bestand—maar je weet niet waarom de LaTeX‑output leeg is. + +## Stap 3 – Configureer TxtSaveOptions voor LaTeX‑export + +Aspose geeft je fijnmazige controle over hoe Office Math wordt gerenderd. Door `OfficeMathExportMode` in te stellen op `LaTeX`, wordt elke vergelijking omgezet naar het LaTeX‑equivalent in plaats van verwijderd of omgezet naar een afbeelding. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Waarom dit belangrijk is:** De standaard exportmodus zou de vergelijkingen volledig weglaten. Overschakelen naar `LaTeX` behoudt de wiskundige intentie, wat precies is wat je nodig hebt wanneer je het bestand later in een LaTeX‑compiler of een markdown‑processor die `$…$`‑syntaxis begrijpt, stopt. + +## Stap 4 – Sla het document op als platte tekst + +Met de opties geconfigureerd is het opslaan van het bestand een één‑regel‑opdracht. De output wordt een `.txt`‑bestand waarin elke vergelijking verschijnt als LaTeX‑code omgeven door `$`‑delimiters (je kunt dat later wijzigen als je `\[` … `\]`‑blokken verkiest). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Verwacht resultaat + +Open `output.txt` in een editor en je ziet iets als: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Let op hoe de gewone tekst precies blijft zoals hij was, terwijl de vergelijkingen nu pure LaTeX‑strings zijn. Je kunt deze direct kopiëren‑en‑plakken in een LaTeX‑document, een Jupyter‑notebook, of elk hulpmiddel dat wiskunde rendert. + +## Stap 5 – Randgevallen afhandelen + +### Gemengde inhoud (Afbeeldingen + Vergelijkingen) + +Als je Word‑bestand ook afbeeldingen bevat, zal Aspose ze negeren wanneer je `TxtSaveOptions` gebruikt. Dat is meestal prima voor een **save word plain text**‑workflow, maar als je de afbeeldingen als placeholders nodig hebt kun je: + +1. Het document eerst exporteren naar HTML (`HtmlSaveOptions`) om afbeeldingen vast te leggen als ``‑tags. +2. Een tweede doorloop uitvoeren met `TxtSaveOptions` om de LaTeX‑vergelijkingen te krijgen. +3. De twee resultaten handmatig of met een klein script samenvoegen. + +### Unicode‑symbolen + +Sommige vergelijkingen gebruiken speciale Unicode‑tekens (bijv. Griekse letters). Het instellen van `Encoding = Encoding.UTF8` in `TxtSaveOptions` (zoals getoond in Stap 3) zorgt ervoor dat die tekens de conversie overleven. + +### Grote documenten + +Voor enorme bestanden (> 100 MB) kun je overwegen de opslaan‑operatie te streamen: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Streaming voorkomt dat de volledige output in het geheugen wordt geladen, wat een redder kan zijn op build‑agents met weinig geheugen. + +## Volledig werkend voorbeeld + +Hieronder staat het volledige, kant‑klaar‑te‑kopiëren programma dat alles samenbrengt. Vervang gewoon de bestands‑paden en, indien je die hebt, de licentielijn. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Voer het programma uit (`dotnet run` als je een console‑project gebruikt) en controleer `output.txt`. Je hebt zojuist **docx als txt opgeslagen** terwijl je elke vergelijking als LaTeX behoudt—geen handmatig kopiëren‑en‑plakken nodig. + +## Veelgestelde vragen + +**Q: Kan ik de delimiter wijzigen van `$…$` naar `\(...\)`?** +A: Ja. Na het opslaan voer je een eenvoudige vervanging uit op het bestand: `output = output.Replace("$", @"\(").Replace("$", @"\)");`—let er wel op dat je geen inline `$`‑tekens vervangt die tot de oorspronkelijke tekst behoren. + +**Q: Werkt dit met Word‑bestanden van 2007‑2019?** +A: Absoluut. Aspose.Words ondersteunt `.doc`, `.docx`, `.docm` en zelfs de nieuwere `.dotx`‑familie. dezelfde code werkt in alle versies. + +**Q: Wat als ik de oorspronkelijke alinea‑opmaak (tabs, meerdere spaties) wil behouden?** +A: Stel `txtSaveOptions.PreserveTableLayout = true;` en `txtSaveOptions.PreserveSpace = true;` in om witruimte intact te houden. + +## Conclusie + +We hebben alles behandeld wat je nodig hebt om **docx als txt op te slaan** terwijl je **vergelijkingen exporteert naar LaTeX** met Aspose.Words. De belangrijkste stappen zijn het laden van het document, het configureren van `TxtSaveOptions` met `OfficeMathExportMode.LaTeX`, en het opslaan van het resultaat. Met deze drie regels code kun je betrouwbaar **word naar latex converteren**, je document behouden als **save word plain text**, en de gevreesde verlies van wiskundige symbolen vermijden. + +Klaar voor de volgende uitdaging? Probeer deze workflow te combineren met een markdown‑generator om een volledig `.md`‑bestand te produceren dat zowel tekst als LaTeX bevat—perfect voor Git‑gebaseerde documentatie of static‑site generators. Of verken Aspose’s `PdfSaveOptions` om een PDF‑versie naast het platte‑tekstbestand te krijgen. + +Als je ergens tegenaan loopt, laat dan een reactie achter. Veel plezier met coderen, en geniet van de eenvoud om Word‑vergelijkingen om te zetten in nette LaTeX! + +![Illustratie van het opslaan van een DOCX als TXT met LaTeX‑vergelijkingen](placeholder-image.png "voorbeeld van docx opslaan als txt") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/dutch/net/working-with-fonts/_index.md b/words/dutch/net/working-with-fonts/_index.md index 4195f5f070..758a834da4 100644 --- a/words/dutch/net/working-with-fonts/_index.md +++ b/words/dutch/net/working-with-fonts/_index.md @@ -48,7 +48,7 @@ Of u nu tekst wilt opmaken met verschillende lettertypen, regels voor lettertype | [Waarschuwingsmelding ontvangen](./receive-warning-notification/) Leer hoe u een waarschuwingsmelding ontvangt wanneer u Aspose.Words voor .NET gebruikt en hoe u problemen of waarschuwingen in uw documenten beheert. | | [Bron van Steam-lettertypebronvoorbeeld](./resource-steam-font-source-example/) | Leer hoe u de Resource Stream Font Source gebruikt om aangepaste lettertypen in Aspose.Words voor .NET te laden. | | [Substitutie verkrijgen zonder achtervoegsels](./get-substitution-without-suffixes/) | In deze tutorial leert u hoe u achtervoegselloze overschrijvingen in een Word-document kunt gebruiken met Aspose.Words voor .NET. | - +| [Aspose Lettertypevervanging – Hoe Fontinstellingen in C# te Configureren](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Leer hoe u lettertypevervanging en fontinstellingen configureert in C# met Aspose.Words voor .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/dutch/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/dutch/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..c53702314b --- /dev/null +++ b/words/dutch/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,237 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose Lettertypevervanging eenvoudig gemaakt: leer hoe u lettertype‑instellingen + configureert, waarschuwingen vastlegt en ontbrekende lettertypen afhandelt in uw + .NET‑applicaties.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: nl +og_description: Beheers Aspose-lettertypevervanging door het configureren van lettertype‑instellingen + en het afhandelen van ontbrekende lettertypen met een waarschuwingscallback. Complete + C#‑gids. +og_title: Aspose Lettertypevervanging – Configureer lettertype-instellingen in C# +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose Lettertypevervanging – Hoe lettertype‑instellingen in C# te configureren +url: /nl/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Complete Gids voor het Configureren van Font-instellingen + +Kom je ooit een document tegen dat plotseling je aangepaste lettertype vervangt door iets generieks? Dat is **aspose font substitution** die zijn werk doet—ontbrekende lettertypen vervangt door de dichtstbijzijnde match die het kan vinden. Het is handig, maar als je *exact* wilt weten welk lettertype is vervangen, moet je gebruikmaken van het waarschuwingssysteem van de bibliotheek en de font‑instellingen zelf configureren. + +In deze tutorial lopen we door een real‑world scenario: het laden van een DOCX die een lettertype referereert dat je niet hebt, het vastleggen van het substitutie‑event, en het afdrukken van een vriendelijke boodschap naar de console. Aan het einde ben je vertrouwd met **configure font settings**, het opzetten van een **Aspose.Words warning callback**, en het uitbreiden van het voorbeeld om in elke workflow te passen. + +> **Wat je nodig hebt** +> • .NET 6+ (of .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • Een DOCX die een ontbrekend lettertype referereert (we noemen het `MissingFont.docx`) + +Laten we beginnen. + +--- + +## Stap 1: Installeer Aspose.Words en bereid het project voor + +Voordat we code schrijven, zorg ervoor dat het Aspose.Words‑pakket is gerefereerd: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro tip:** Gebruik de nieuwste stabiele versie; vanaf maart 2026 is dat 23.11.0. Nieuwere releases verbeteren de algoritmen voor font‑matching en voegen extra waarschuwings‑types toe. + +Maak een nieuwe console‑app (of plaats de code in een bestaand project) en voeg de gebruikelijke `using`‑directieven toe: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Deze namespaces geven ons toegang tot de `Document`, `LoadOptions` en de font‑gerelateerde klassen die we nodig hebben. + +## Stap 2: Configureer Font‑instellingen met LoadOptions + +Het hart van de **aspose font substitution**‑controle zit in `LoadOptions.FontSettings`. Door een leeg `FontSettings`‑object te leveren, vertellen we Aspose om zijn standaard zoekpaden te gebruiken *en* om elke substitutie te rapporteren via een waarschuwings‑callback. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Waarom niet gewoon op de standaardinstellingen vertrouwen? Omdat het koppelen van een waarschuwings‑callback (volgende stap) alleen werkt wanneer de `FontSettings`‑eigenschap niet null is. Deze kleine regel geeft ons een haak in het substitutieproces zonder het daadwerkelijke font‑zoekgedrag te wijzigen. + +## Stap 3: Koppel een Waarschuwings‑callback om Substituties Vast te Leggen + +Aspose.Words implementeert de `IWarningCallback`‑interface. Telkens wanneer er iets noemenswaardigs gebeurt—zoals een ontbrekend lettertype—roept het onze `Warning`‑methode aan. We implementeren een kleine handler die filtert op `WarningType.FontSubstitution` en de beschrijving afdrukt. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +En hier is de handler zelf: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Waarom dit belangrijk is** – Zonder de callback verwisselt Aspose stilletjes lettertypen, en je weet nooit welk lettertype is gebruikt. De callback maakt het proces transparant, wat essentieel is voor compliance‑rapportage of voor het debuggen van lay‑outproblemen. + +## Stap 4: Laad het Document met de Geconfigureerde Opties + +Nu laden we eindelijk het document, waarbij we de `loadOptions` doorgeven die we zojuist hebben voorbereid. Als het bronbestand een lettertype referereert dat niet geïnstalleerd is, wordt onze handler geactiveerd. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Vervang `YOUR_DIRECTORY` door het daadwerkelijke pad waar `MissingFont.docx` zich bevindt. Wanneer je het programma uitvoert, zou je output moeten zien die lijkt op: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Die regel vertelt je precies welk lettertype ontbrak en welke fallback Aspose heeft gekozen. + +## Stap 5: (Optioneel) Fijn‑afstellen van Font‑Zoekpaden + +Als je een privémap met bedrijfs‑fonts hebt, kun je Aspose vertellen waar te zoeken voordat het terugvalt op systeem‑fonts. Dit is een geavanceerd gebruik van **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Het instellen van `recursive: true` zorgt ervoor dat Aspose ook submappen scant. Nu zal de bibliotheek eerst je privé‑fonts proberen, waardoor de kans op ongewenste substitutie wordt verkleind. + +## Volledig Werkend Voorbeeld + +Alles samenvoegend, hier is het volledige, kant‑klaar programma: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Verwachte output** (wanneer een ontbrekend lettertype wordt aangetroffen): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Als alle lettertypen aanwezig zijn, draait het programma stil (geen waarschuwingen) en produceert nog steeds de PDF. + +## Veelgestelde Vragen & Randgevallen + +### Wat als ik substitutie volledig wil *voorkomen*? + +Set the `FontSettings.SubstitutionSettings` to `null` or use `FontSettings.FontSubstitutionSettings` to control the behavior. For example: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Nu zal Aspose een uitzondering gooien in plaats van stilletjes te substitueren, die kan worden opgevangen en afgehandeld. + +### Werkt dit met andere bestandsformaten (bijv. .doc, .rtf)? + +Absoluut. Hetzelfde `LoadOptions`‑object kan worden doorgegeven aan elke `Document`‑constructor die een bestandspad accepteert. De waarschuwings‑callback wordt geactiveerd voor alle formaten die afhankelijk zijn van fonts. + +### Kan ik de *exacte* fallback‑fontnaam vastleggen? + +Ja. De `info.Description`‑string bevat zowel het ontbrekende lettertype als de vervanging. Als je de naam programmatically nodig hebt, kun je deze parseren of het `FontInfo`‑object gebruiken (beschikbaar in nieuwere versies). + +### Hoe gedraagt dit zich in een multi‑threaded omgeving? + +`FontSettings` is **niet** thread‑veilig. Maak per thread een aparte `LoadOptions` (met zijn eigen `FontSettings`) aan, of bescherm de toegang met een lock. + +## Conclusie + +We hebben alles behandeld wat je nodig hebt om **aspose font substitution** en **configure font settings** onder de knie te krijgen in een C#‑applicatie: + +1. Installeer Aspose.Words en voeg de benodigde `using`‑statements toe. +2. Maak een `LoadOptions`‑object met een nieuwe `FontSettings`. +3. Koppel een aangepaste `IWarningCallback` om substitutie‑events zichtbaar te maken. +4. Laad het document, waarbij de callback eventuele ontbrekende fonts rapporteert. +5. (Optioneel) Breid het zoekpad uit of schakel substitutie volledig uit. + +Gewapend met dit patroon kun je ontbrekende lettertypen loggen voor compliance, gebruikers waarschuwen in een UI, of automatisch fallback‑fonts insluiten vóór publicatie. Vervolgens kun je **Aspose.Words font substitution policies** verkennen of de workflow integreren in een grotere document‑verwerkings‑pipeline. + +Veel programmeerplezier, en moge je documenten altijd weergeven met het juiste lettertype! + +--- + +![Diagram dat Aspose.Words een document laadt, FontSettings aanroept, een waarschuwings‑callback triggert en substitutie‑informatie output geeft](image-placeholder.png "aspose font substitutie workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/basic-conversions/_index.md b/words/english/net/basic-conversions/_index.md index 0ae161b7d7..f1faa2a3d7 100644 --- a/words/english/net/basic-conversions/_index.md +++ b/words/english/net/basic-conversions/_index.md @@ -36,6 +36,7 @@ Basic Conversions walks you through basic document conversions using the Aspose. | [How to Export LaTeX from Word – Step‑by‑Step Guide](./how-to-export-latex-from-word-step-by-step-guide/) | Learn how to export LaTeX from Word using Aspose.Words for .NET. Step‑by‑step guide with code examples for developers. | | [convert word to pdf in C# using Aspose.Words – Guide](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Learn how to convert Word documents to PDF in C# using Aspose.Words. Step‑by‑step guide with code examples for developers. | | [Save Word as PDF with Aspose.Words – Complete C# Guide](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Learn how to save Word documents as PDF using Aspose.Words in C#. Detailed step‑by‑step guide with code examples. | +| [Convert Word to PDF with Aspose.Words – Complete Guide](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Learn how to convert Word documents to PDF using Aspose.Words – Complete Guide. Step‑by‑step with code examples for developers. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/english/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/english/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..fc14b161ff --- /dev/null +++ b/words/english/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Convert Word to PDF quickly using Aspose.Words. Learn how to save word + as pdf, export docx to pdf, and generate accessible pdf in C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: en +og_description: Convert Word to PDF in C# using Aspose.Words. This guide shows how + to save word as pdf, export docx to pdf, and generate accessible pdf. +og_title: Convert Word to PDF with Aspose.Words – Step-by-Step +tags: +- Aspose.Words +- C# +- PDF conversion +title: Convert Word to PDF with Aspose.Words – Complete Guide +url: /net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convert Word to PDF with Aspose.Words – Complete Guide + +Ever wondered how to **convert Word to PDF** without fiddling with third‑party web tools? Maybe you’re building an automated report engine and need a reliable way to *save word as pdf* on the fly. The good news is that Aspose.Words makes the whole process a piece of cake, and you can even crank out a **PDF/UA‑2** compliant file—perfect for accessibility requirements. + +In this tutorial we’ll walk through everything you need: loading a `.docx`, configuring the PDF options so you can *export docx to pdf* with PDF/UA compliance, and finally saving the result as an accessible PDF. By the end you’ll have a self‑contained, production‑ready snippet you can drop into any .NET project. + +![Convert Word to PDF using Aspose.Words](convert-word-to-pdf.png) + +## What You’ll Learn + +- **Why Aspose.Words** is a solid choice for *generate accessible pdf* scenarios. +- The exact steps to *save document as pdf* with PDF/UA‑2 compliance. +- How to handle common edge cases like missing fonts or password‑protected source files. +- Quick tips for debugging the output and verifying accessibility compliance. + +### Prerequisites + +- .NET 6 or later (the API works on .NET Framework 4.6+ as well). +- A valid Aspose.Words for .NET license (the free trial works for evaluation). +- Basic C# knowledge—no fancy patterns required. + +If you’ve got those boxes checked, let’s dive in. + +--- + +## Convert Word to PDF – Step‑by‑Step Implementation + +We'll break the solution into five clear steps. Each step has a headline, a short code excerpt, and an explanation of *why* the code matters. + +### Step 1: Load the Word Document You Want to Convert + +The first thing you need is a `Document` object that represents the source file. Aspose.Words reads **.docx**, **.doc**, **.rtf**, and many other formats, so you can *save word as pdf* no matter how the file was originally created. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Why this matters:** +- Loading the file early lets you catch missing‑file errors before you waste CPU cycles. +- The `Document` class abstracts away the internal structure of a Word file, giving you a clean object model to work with. + +### Step 2: Configure PDF Save Options for Accessibility + +If you need to *generate accessible pdf* files, you must tell Aspose.Words to produce a PDF/UA‑2 compliant document. The `PdfSaveOptions` class gives you fine‑grained control over the output. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Why this matters:** +- `PdfCompliance.PdfUa2` tells the library to add the necessary tags, structure information, and metadata that screen‑readers rely on. +- Embedding fonts (`EmbedFullFonts = true`) prevents the dreaded “font not found” warnings when the PDF is opened on a different OS. +- Setting a `Title` helps assistive technologies announce the document correctly. + +### Step 3: Save the Document as a PDF + +Now that the source is loaded and the options are set, the actual conversion is a one‑liner. This is where you *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Why this matters:** +- The `Save` method respects the `PdfSaveOptions` we configured, guaranteeing the accessibility features are baked in. +- Wrapping the call in a `try/catch` block gives you a chance to log or surface any licensing or permission errors that often trip up newcomers. + +### Step 4: Verify the PDF/UA Compliance (Optional but Recommended) + +Even though Aspose.Words does the heavy lifting, it’s good practice to double‑check the output, especially when you’re delivering documents to government agencies or other regulated entities. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Why this matters:** +- `IsTagged` is a quick sanity check; full PDF/UA validation requires a dedicated validator, but most compliance issues surface as missing tags. +- If the flag returns `false`, you can revisit `PdfSaveOptions`—perhaps you forgot to set `Compliance` or the source document lacked proper heading styles. + +### Step 5: Common Pitfalls & Pro Tips + +| Pitfall | What Happens | How to Fix | +|---------|--------------|------------| +| **Missing fonts** | Text appears as boxes in the PDF. | Set `EmbedFullFonts = true` **or** install the missing fonts on the server. | +| **Unlicensed library** | Aspose adds a watermark to every page. | Add your license file (`Aspose.Words.lic`) early in the app (e.g., `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Password‑protected source** | `InvalidOperationException` on `new Document(path)`. | Use the overload `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Large documents cause OOM** | Out‑of‑memory exception on huge files. | Enable `MemoryOptimization` in `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Accessibility tags missing** | PDF/UA validation fails. | Ensure source Word file uses proper heading styles (`Heading 1`, `Heading 2`, etc.)—Aspose maps those to PDF tags automatically. | + +**Pro tip:** If you’re converting many documents in a batch, reuse a single `PdfSaveOptions` instance. Creating it once reduces allocation overhead and keeps your memory footprint low. + +--- + +## Full Working Example (Copy‑Paste Ready) + +Below is the complete program that puts everything together. Save it as `Program.cs`, add the Aspose.Words and Aspose.PDF NuGet packages, and run. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Expected result:** +A file called `output.pdf` appears in `C:\MyFiles`. Opening it in Adobe Acrobat will show “PDF/A‑2b, PDF/UA‑1” in the compliance panel, confirming that you have successfully *convert word to pdf* + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/programming-with-markdownsaveoptions/_index.md b/words/english/net/programming-with-markdownsaveoptions/_index.md index 530ef54fd0..26baad4c59 100644 --- a/words/english/net/programming-with-markdownsaveoptions/_index.md +++ b/words/english/net/programming-with-markdownsaveoptions/_index.md @@ -33,6 +33,9 @@ Words Processing with MarkdownSaveOptions is an in-depth resource that walks you | [How to Export Markdown from Word – Complete C# Guide](./how-to-export-markdown-from-word-complete-c-guide/) | | | [How to Export Markdown from DOCX – Complete Guide](./how-to-export-markdown-from-docx-complete-guide/) | | | [How to Save Markdown from DOCX – Step‑by‑Step Guide](./how-to-save-markdown-from-docx-step-by-step-guide/) | Learn how to save DOCX as Markdown with a detailed step‑by‑step guide using Aspose.Words for .NET. | +| [How to Export LaTeX from Word – Convert DOCX to Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) | | +| [How to Export LaTeX from DOCX – Convert to Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) | Learn how to export LaTeX from DOCX and convert it to Markdown using Aspose.Words for .NET. | +| [Create markdown from Word – Full C# Guide](./create-markdown-from-word-full-c-guide/) | Learn how to create markdown from Word documents using Aspose.Words for .NET in a comprehensive C# guide. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/english/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/english/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..94a46e9233 --- /dev/null +++ b/words/english/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,252 @@ +--- +category: general +date: 2026-03-27 +description: Create markdown from Word with Aspose.Words C#. Learn to convert docx + to markdown, extract images from Word, and how to use callback in a single tutorial. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: en +og_description: Create markdown from Word using Aspose.Words. This guide shows how + to convert docx to markdown, extract images from Word, and use a callback for resource + handling. +og_title: Create markdown from Word – Complete C# Tutorial +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Create markdown from Word – Full C# Guide +url: /net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Create markdown from Word – Complete C# Tutorial + +Ever needed to **create markdown from Word** but weren’t sure where to start? You’re not alone; many developers hit this wall when they try to move content from a .docx file into a static‑site generator or a documentation repo. The good news? With Aspose.Words you can **convert docx to markdown**, pull every image out of the original file, and control exactly where those resources land—all with a simple callback. + +In this guide we’ll walk through a real‑world example that shows you how to extract images from Word, how to use callback to store them, and why this approach is the most reliable for automation pipelines. By the end you’ll have a ready‑to‑run C# program that produces a clean `.md` file and a folder of extracted images. + +> **Pro tip:** If you already have a Word template that includes screenshots, diagrams, or logos, this method will preserve every visual element without you having to copy‑paste manually. + +--- + +## What You’ll Need + +- **.NET 6+** (or .NET Framework 4.6+). The code works on any recent runtime. +- **Aspose.Words for .NET** (NuGet package `Aspose.Words`). The free trial works for most scenarios. +- A **Word document** (`input.docx`) that contains text and at least one image. +- A basic understanding of C# and Visual Studio (or your favourite IDE). + +No extra libraries are required—everything else is handled by Aspose.Words itself. + +--- + +## Step 1: Set Up the Project and Install Aspose.Words + +To keep things tidy, start a new console project: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Why this step matters:** Installing the NuGet package ensures you have the latest API, which includes the `MarkdownSaveOptions` class introduced in version 22.9. Without it you’d have to write a custom converter. + +--- + +## Step 2: Load the Source Word Document + +The first line of code opens the `.docx` you want to transform. Replace `YOUR_DIRECTORY` with the actual path on your machine. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **What’s happening?** `Document` parses the file, builds an internal DOM, and makes every paragraph, table, and image accessible. If the file is missing, Aspose throws a clear `FileNotFoundException`, which you can catch for a more graceful UI. + +--- + +## Step 3: Configure Markdown Save Options with a Resource‑Saving Callback + +Here’s where the magic of **how to use callback** comes into play. The callback lets you decide where each extracted image goes. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Why a callback?** By default Aspose would embed images as base‑64 strings inside the markdown—a nightmare for version control. The callback gives you full control over file names and folder structure. + +--- + +## Step 4: Save the Document as Markdown + +Now we actually generate the `.md` file. All images will be handed off to the callback defined in the next step. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +If everything goes well, you’ll find `Document.md` in the target folder and a sub‑folder called `Resources` containing every picture extracted from the original Word file. + +--- + +## Step 5: Implement the Callback that Stores Each Extracted Image + +Below is the full implementation of `MyResourceSaver`. It creates a `Resources` directory (if it doesn’t exist), builds a unique filename for each image, and writes the image stream to disk. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Explanation of the arguments:** +> - `args.Index` – a zero‑based counter that guarantees uniqueness. +> - `args.FileName` – the original filename Aspose suggests (often something like `image001.png`). +> - `args.Stream` – the output stream where the image bytes are written. +> - `args.KeepResourceStreamOpen` – set to `false` so Aspose disposes the stream automatically, preventing file‑handle leaks. + +--- + +## Full Working Example + +Putting everything together, here’s a single file you can copy‑paste into `Program.cs`. Remember to replace `YOUR_DIRECTORY` with an absolute or relative path that fits your environment. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Expected Output + +- `YOUR_DIRECTORY/Document.md` – a markdown file with standard markdown image links, e.g.: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – contains `img_0.png`, `img_1.jpg`, etc., matching the order they appeared in the original Word document. + +Running the program prints a friendly confirmation, letting you know the process succeeded. + +--- + +## Frequently Asked Questions (FAQ) + +### How to extract images from Word without losing quality? + +The callback writes the raw binary stream directly to a file, preserving the original resolution. No conversion or compression occurs unless you add your own image‑processing logic inside `ResourceSaving`. + +### Can I change the image format (e.g., PNG → JPEG) during extraction? + +Absolutely. Inside `ResourceSaving` you can inspect `args.FileName` or `args.Stream`, load the image with `System.Drawing` or `ImageSharp`, then re‑encode it before writing. Just remember to update the markdown link extension accordingly. + +### What if I need the markdown files to reference a CDN instead of a local folder? + +Modify the callback to prepend a base URL to the markdown link. You can achieve this by setting `args.FileName` to a fully‑qualified URL after you upload the image to your CDN. + +### Does this work with tables, footnotes, or other advanced Word features? + +Yes. Aspose.Words translates most Word constructs to markdown equivalents. Tables become markdown tables, footnotes become reference links, and even nested lists are handled gracefully. If something looks odd, check the latest release notes—Aspose continuously improves the conversion fidelity. + +### How to convert docx to markdown in a CI/CD pipeline? + +Just add the compiled `.exe` to your build steps, point it at the generated `.docx` artifacts, and push the resulting `.md` and `Resources/` folder to your static site repository. Because the process is fully deterministic, it works well in automated environments. + +--- + +## Wrapping Up + +We’ve just demonstrated how to **create markdown from Word** using Aspose.Words, covered the entire **convert docx to markdown** workflow, and showed a practical way to **extract images from Word** with a custom **how to use callback** implementation. The result is a clean markdown file paired with a folder of original images—perfect for documentation sites, static blogs, or any workflow that prefers plain‑text formats. + +Next steps you might consider: + +- **Batch processing** multiple `.docx` files in a folder (loop over `Directory.GetFiles`). +- **Custom naming schemes** for images (e.g., using the original caption text). +- **Post‑processing** the markdown to replace image links with CDN URLs. +- Exploring **other Aspose export formats** like HTML, PDF, or EPUB for multi‑channel publishing. + +Got more questions or a tricky Word file that refuses to convert? Drop a comment below, and let’s troubleshoot together. Happy coding, and enjoy the simplicity of turning Word into markdown! + +--- + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/english/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..bf85efa108 --- /dev/null +++ b/words/english/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: How to export LaTeX from DOCX using Aspose.Words. Learn to convert DOCX + to Markdown, set DPI, and enable recovery in C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: en +og_description: How to export LaTeX from DOCX using Aspose.Words. This tutorial shows + step‑by‑step conversion to Markdown, DPI control, and recovery mode. +og_title: How to Export LaTeX from DOCX – Convert to Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: How to Export LaTeX from DOCX – Convert to Markdown +url: /net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to Export LaTeX from DOCX – Convert to Markdown + +Ever wondered **how to export LaTeX** from a DOCX file without losing the beauty of your equations? You’re not alone. In my experience, the biggest pain point is getting those OfficeMath objects into a clean, portable format for static‑site generators or scientific blogs. + +In this guide we’ll walk through converting DOCX to Markdown with Aspose.Words, while also showing **how to set DPI**, **how to enable recovery**, and a few handy tricks for a rock‑solid pipeline. By the end you’ll have a single C# program that produces a Markdown file with LaTeX equations, high‑resolution images, and proper hyperlink handling. + +## What You’ll Need + +- **.NET 6+** (or .NET Framework 4.7.2 – the API works the same) +- **Aspose.Words for .NET** (the latest stable version as of March 2026) +- A DOCX file that contains equations, images, and links +- Visual Studio, VS Code, or any editor you prefer + +No extra NuGet packages are required beyond Aspose.Words, but make sure you have a valid license if you’re not using the trial. + +## Step 1 – Load the DOCX with Strict Recovery Mode + +Before we even think about exporting, we need to make sure the source document isn’t hiding corruption. That’s where **how to enable recovery** comes into play. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Why strict recovery?** +If you let Aspose silently fix problems, you might end up with missing paragraphs or broken images—something no one wants when exporting LaTeX. By failing fast, you can catch the issue early and decide whether to fix the source DOCX or log the problem for later. + +### Pro tip +Wrap the load in a try/catch and log `DocumentLoadingException`. That way your CI pipeline can flag problematic files without halting the entire build. + +## Step 2 – Prepare the Markdown Export Options + +Now that the document is safely in memory, we configure how it will be saved. This is the heart of **how to export latex** and also covers **how to set DPI** for embedded images. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**What each option does** + +| Option | Reason | Relevance to Keywords | +|--------|--------|-----------------------| +| `OfficeMathExportMode = LaTeX` | Directly answers **how to export latex** from equations. | Primary keyword | +| `ImageResolution = 300` | Controls image quality – the answer to **how to set dpi**. | Secondary | +| `ResourceSavingCallback` | Saves embedded files to disk, a common need when **convert docx to markdown**. | Secondary | +| `EmptyParagraphExportMode` | Guarantees clean Markdown output, preventing stray HTML tags. | Improves overall conversion quality | +| `LinkExportMode = AsReference` | Makes links easy to read and edit, another plus for **convert docx to markdown**. | + +## Step 3 – Implement a Custom Resource Saver (Optional but Handy) + +When you convert DOCX to Markdown, images and other binary resources need a place on the filesystem. Aspose lets you control that with `IResourceSavingCallback`. The snippet above already shows a minimal implementation, but let’s break it down: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Why bother?** +If you skip this step, Aspose will embed images as base‑64 strings, which blows up the Markdown file size and makes version control painful. By saving resources to a separate folder, you keep the Markdown lightweight and make it friendly for static site generators like Hugo or Jekyll. + +## Step 4 – Save the Document as Markdown + +All the heavy lifting is done. One line now writes the final file. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Open `output.md` and you’ll see: + +- Equations rendered as `$…$` LaTeX blocks +- Images referenced as `![Alt text](resources/image001.png)` with 300 dpi resolution +- Hyperlinks turned into reference style: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +That’s the whole **how to convert docx** process in a nutshell. + +## Common Questions & Edge Cases + +### 1️⃣ What if the DOCX contains unsupported objects? +Aspose.Words will throw a `FeatureNotSupportedException`. Because we used **how to enable recovery** in strict mode, the exception surfaces immediately. You can either: + +- Switch `RecoveryMode` to `RecoveryMode.Default` for a best‑effort conversion, **or** +- Pre‑process the DOCX (e.g., remove unsupported SmartArt) before running the converter. + +### 2️⃣ Can I change the DPI per image? +The `ImageResolution` setting is global. For per‑image control, implement a custom `ImageSavingCallback` similar to `MyResourceSaver` and adjust `args.ImageResolution` based on `args.ImageFileName` or metadata. + +### 3️⃣ How do I embed the generated LaTeX in a Jekyll site? +Jekyll’s built‑in MathJax support works out of the box. Just make sure your layout includes the MathJax script and the LaTeX blocks are wrapped in `$$` for display equations or `$` for inline. + +### 4️⃣ Is this compatible with .NET Core on Linux? +Absolutely. Aspose.Words is cross‑platform. Just ensure the `YOUR_DIRECTORY` path follows Linux conventions (e.g., `/home/user/docs`). + +## Full Working Example + +Below is a copy‑paste‑ready program. Replace `YOUR_DIRECTORY` with an actual path on your machine. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Expected output** – open `output.md` and you should see something like: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +If you open the file in a Markdown preview that supports MathJax, the integral renders + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/english/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..7d89e0d02a --- /dev/null +++ b/words/english/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: How to export LaTeX from Word documents using Aspose.Words – convert + DOCX to Markdown with equations as LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: en +og_description: How to export LaTeX from Word documents is explained in the first + sentence, showing you how to convert DOCX to Markdown with equations as LaTeX. +og_title: How to Export LaTeX from Word – Complete Guide +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: How to Export LaTeX from Word – Convert DOCX to Markdown +url: /net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to Export LaTeX from Word – Convert DOCX to Markdown + +Ever wondered **how to export LaTeX** from a Word file without ending up with a bunch of PNGs? You're not the only one; developers constantly hit this wall when they need clean, editable equations for static sites or scientific blogs. The good news? With Aspose.Words you can **convert Word to Markdown** and keep every OfficeMath object as native LaTeX—no post‑processing required. + +In this tutorial we’ll walk through the entire process of **saving a Word document as Markdown** while **exporting equations as LaTeX**. By the end you’ll have a runnable C# snippet, a clear explanation of each option, and tips for handling edge cases like complex formulas or mixed content. No external tools, just a single NuGet package and a few lines of code. + +## What You’ll Need + +- .NET 6+ (or .NET Framework 4.7.2 and higher) – the latest runtime works best. +- Visual Studio 2022 or any editor that can compile C# projects. +- An Aspose.Words for .NET license (the free trial works for experimentation). +- A DOCX file that contains at least one equation (OfficeMath). + +If you already have those, great—let’s dive in. + +## How to Export LaTeX from Word – Overview + +Below is a high‑level view of the steps involved: + +1. **Install** the Aspose.Words NuGet package. +2. **Load** the source `.docx` that holds your equations. +3. **Configure** `MarkdownSaveOptions` so that `OfficeMathExportMode` is set to `LaTeX`. +4. **Save** the document as a `.md` file. +5. **Verify** that the generated Markdown contains LaTeX blocks (`$$…$$`). + +Each of these steps is explained in detail in the sections that follow. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="How to export latex from Word diagram"} + +## Step 1 – Install Aspose.Words for .NET (convert word to markdown) + +First things first: you need the library that actually does the heavy lifting. Open your terminal (or Package Manager Console) and run: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** If you’re using Visual Studio, right‑click the project → *Manage NuGet Packages* → search for “Aspose.Words” and install the latest stable version. + +Why this matters: Aspose.Words abstracts the Open XML format, giving you a clean API to manipulate Word documents without dealing with the low‑level XML yourself. It also ships with built‑in support for converting OfficeMath to LaTeX, which is the core of our **export equations as LaTeX** requirement. + +## Step 2 – Load the DOCX (how to convert docx) + +Now that the package is in place, load the file you want to transform. Replace `YOUR_DIRECTORY` with the path where your `.docx` lives: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Why load it this way?** The `Document` constructor parses the entire file into an object model, giving you instant access to paragraphs, tables, and—most importantly—OfficeMath objects. If the file is missing or corrupted, Aspose throws a descriptive `FileNotFoundException`, which you can catch for graceful error handling. + +## Step 3 – Configure MarkdownSaveOptions (export equations as latex) + +The magic happens in the `MarkdownSaveOptions` object. By default Aspose would render equations as PNG images, but we want LaTeX. Set the `OfficeMathExportMode` to `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +A quick note on the optional flags: `ExportImagesAsBase64` tells Aspose not to embed binary data, which keeps the Markdown clean. `ExportHeadersFooters` ensures you don’t lose any context that might sit in those sections—useful when the header contains a title or author name. + +## Step 4 – Save the Document (save word as markdown) + +Finally, write the transformed content to a `.md` file: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +After this line runs, you’ll find `output.md` next to your source file. Open it in any text editor and you should see LaTeX blocks that look like this: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +That’s the **save word as markdown** part done—no extra conversion steps required. + +## Step 5 – Verify the Result (export equations as latex) + +It’s easy to overlook verification, but a quick sanity check saves hours later. Run a simple script that reads the generated file and prints the first LaTeX block: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +If you see `First LaTeX block: $$ … $$` printed, you’ve successfully **exported LaTeX** from Word. If not, double‑check that your source document actually contains OfficeMath objects; regular text equations won’t be converted. + +## Handling Common Edge Cases + +| Scenario | What to Watch For | Recommended Fix | +|----------|-------------------|-----------------| +| **Mixed images & equations** | Aspose may still embed images for non‑OfficeMath graphics. | Set `ExportImagesAsBase64 = false` and keep images as external files, then reference them manually in Markdown. | +| **Complex nested equations** | Very deep nesting can produce LaTeX that needs manual tweaking. | Post‑process the block with a LaTeX formatter (e.g., `latexindent`) or adjust `mdOptions` → `ExportMathAsDisplay = true`. | +| **Large documents** | Memory usage spikes when loading huge `.docx` files. | Use `LoadOptions` with `LoadFormat.Docx` and enable `LoadOptions.LoadFormat` streaming if available. | +| **Missing license** | The free trial adds a watermark comment to the output. | Apply a valid license via `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +These tips keep your workflow robust, especially when you **convert word to markdown** in production pipelines. + +## Full Working Example (All Steps in One File) + +Below is a self‑contained console app that you can copy‑paste into a new .NET project and run immediately. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Run the program, open `output.md`, and you’ll see your equations rendered as clean LaTeX. That’s the complete answer to **how to export latex** from a Word document. + +## Conclusion + +We’ve covered **how to export LaTeX** from Word step by step, showing you how to **convert Word to markdown**, **save word as markdown**, and **export equations as LaTeX** using Aspose.Words. The core idea is simple: load the DOCX, tweak `MarkdownSaveOptions`, and let the library do the heavy lifting. + +If you’re ready to automate documentation pipelines, try chaining this code with a static‑site generator like Hugo or Jekyll—just push the generated `.md` files into your repo and let the site rebuild. For further reading, explore Aspose’s “Export to LaTeX” guide, experiment with `HtmlSaveOptions` for web previews, or dive into the `DocumentVisitor` API for custom transformations. + +Got questions about edge cases, licensing, or integrating this into CI/CD? Drop a comment below, and happy coding! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/programming-with-pdfsaveoptions/_index.md b/words/english/net/programming-with-pdfsaveoptions/_index.md index 24cc1c990d..88f3f0c5e1 100644 --- a/words/english/net/programming-with-pdfsaveoptions/_index.md +++ b/words/english/net/programming-with-pdfsaveoptions/_index.md @@ -38,6 +38,7 @@ Whether you want to convert Word documents to PDF for online distribution, archi | [Reduce PDF Size with Scale Wmf Fonts To Metafile Size](./scale-wmf-fonts-to-metafile-size/) | Step-by-step guide to reduce pdf size with scale wmf fonts to metafile size size when converting to PDF with Aspose.Words for .NET. | | [Imporove PDF Text Postioning with Additional Text Positioning](./additional-text-positioning/) | Learn how to improve PDF text positioning with Aspose.Words for .NET in a few easy steps. Enhance your document's appearance. | | [Convert Word Document To PDF 1.7](./conversion-to-pdf-17/) | Effortlessly convert Word documents to PDF 1.7 using Aspose.Words for .NET. Follow this guide to ensure your documents are universally accessible and professionally formatted. | +| [How to Save PDF from DOCX with Aspose.Words – Step‑by‑Step Guide](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Learn how to convert a DOCX file to PDF using Aspose.Words for .NET with a detailed step‑by‑step guide. | | [Reduce PDF Document Size with Downsampling Images](./downsampling-images/) | Reduce PDF document size by downsampling images using Aspose.Words for .NET. Optimize your PDFs for faster upload and download times. | | [Set Outline Options in a PDF Document](./set-outline-options/) | Learn how to set outline options in a PDF document using Aspose.Words for .NET. Enhance PDF navigation by configuring heading levels and expanded outlines. | | [Export Custom Properties in a PDF Document](./custom-properties-export/) | Learn how to export custom properties in a PDF document using Aspose.Words for .NET with our detailed, step-by-step guide. | @@ -56,4 +57,4 @@ Whether you want to convert Word documents to PDF for online distribution, archi {{< /blocks/products/pf/main-wrap-class >}} -{{< blocks/products/products-backtop-button >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/english/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..dad93fbb5b --- /dev/null +++ b/words/english/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-03-27 +description: Learn how to save PDF from a DOCX file using Aspose.Words. Includes convert + docx to pdf, save pdf with options, and handling floating shapes. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: en +og_description: How to save PDF from a DOCX file using Aspose.Words. This guide shows + convert docx to pdf, save pdf with options, and handling floating shapes. +og_title: How to Save PDF from DOCX – Complete Aspose.Words Tutorial +tags: +- Aspose.Words +- C# +- PDF conversion +title: How to Save PDF from DOCX with Aspose.Words – Step‑by‑Step Guide +url: /net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to Save PDF from DOCX with Aspose.Words – Complete Tutorial + +Ever wondered **how to save PDF** from a Word document without losing the layout of floating shapes? You're not the only one. In many projects—invoice generators, report exporters, or simple document archivers—developers need a reliable way to convert DOCX to PDF while keeping everything looking exactly as it does in Word. + +In this tutorial we’ll walk through converting a DOCX file to PDF **using Aspose.Words for .NET**, show you **how to convert docx to pdf** with custom save options, and explain why the `ExportFloatingShapesAsInlineTag` flag matters. By the end you’ll have a ready‑to‑run snippet that saves PDF with options you control. + +## What You’ll Learn + +- The exact steps to **convert word document pdf** with Aspose.Words. +- How to configure `PdfSaveOptions` to treat floating shapes as inline tags. +- Common pitfalls when dealing with floating objects and how to avoid them. +- A complete, runnable C# program you can drop into any .NET project. + +> **Prerequisite:** You need an Aspose.Words for .NET license (or a free evaluation) and a .NET development environment (Visual Studio, Rider, or the `dotnet` CLI). + +## Step 1: Set Up the Project and Add Aspose.Words + +First, create a new console app (or add to an existing one) and reference the Aspose.Words NuGet package. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro tip:** If you’re on a CI server, pin the package version (`Aspose.Words --version 24.10`) to guarantee reproducible builds. + +## Step 2: Load the DOCX Containing Floating Shapes + +Floating pictures, text boxes, or SmartArt can cause layout shifts when converted. Loading the document is straightforward, but we’ll also verify that the file exists to prevent a runtime `FileNotFoundException`. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Notice the `Console.WriteLine` statements—they give you quick feedback when you run the app from a terminal. + +## Step 3: Configure PDF Save Options (Save PDF with Options) + +Here’s where the magic happens. By default Aspose.Words tries to preserve floating objects as they appear, which can break the layout in the resulting PDF. Setting `ExportFloatingShapesAsInlineTag` to `true` tells the library to treat those shapes as inline tags, ensuring they stay anchored to the surrounding text. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Why does this matter? Imagine a text box that hovers over a paragraph. Without the inline‑tag conversion, the PDF might push the paragraph down or clip the box entirely. The flag keeps the visual relationship intact—a subtle yet crucial detail for professional reports. + +## Step 4: Save the Document as PDF + +Now we actually write the PDF file. The `Save` method receives both the output path and the options we just set. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Running the program will produce `output.pdf` in the same folder as your source DOCX. Open it in any PDF viewer and you should see that all floating shapes are rendered exactly where they belong. + +## Full Working Example + +Below is the entire program in one block. Copy‑paste it into `Program.cs` (or any C# file) and hit **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Expected Result + +- **File created:** `output.pdf` in the target directory. +- **Layout fidelity:** Floating shapes (pictures, text boxes, SmartArt) appear inline with the surrounding text. +- **No exceptions:** The program exits gracefully, printing status messages to the console. + +## Frequently Asked Questions & Edge Cases + +| Question | Answer | +|----------|--------| +| **What if I need higher image quality?** | Set `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Can I convert multiple DOCX files in a batch?** | Wrap the loading/saving logic in a `foreach (var file in Directory.GetFiles(..., "*.docx"))` loop. Remember to reuse a single `PdfSaveOptions` instance for performance. | +| **Does this work with .NET Core?** | Absolutely. Aspose.Words 24.x supports .NET Standard 2.0+, so you can run the same code on Windows, Linux, or macOS. | +| **What about password‑protected DOCX files?** | Load with `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. The same `PdfSaveOptions` apply when saving. | +| **Is the inline‑tag conversion safe for complex tables?** | Generally yes, but very intricate table layouts with overlapping shapes may still need manual tweaking. Test a representative sample before a bulk migration. | + +## Tips for Real‑World Projects + +- **Log, don’t just `Console.WriteLine`** – In production, replace console output with a logging framework (Serilog, NLog) to capture errors. +- **Dispose of resources** – `Document` implements `IDisposable`. Wrap it in a `using` block if you’re processing many files to free memory promptly. +- **Validate the PDF** – Use a PDF validator (e.g., PDF/A compliance checker) if you need archival‑grade PDFs. +- **Parallel processing** – For massive workloads, consider `Parallel.ForEach` with thread‑safe `PdfSaveOptions` (clone per thread) to speed up conversion. + +## Conclusion + +We’ve covered **how to save PDF** from a DOCX file using Aspose.Words, demonstrated **how to convert docx to pdf** with custom options, and explained the impact of `ExportFloatingShapesAsInlineTag`. The complete, runnable example shows you can **convert word document pdf** in just a handful of lines, and you now know how to **save pdf with options** that suit your project’s quality and compliance needs. + +Ready for the next challenge? Try exporting to other formats (e.g., HTML, EPUB) with `document.Save("output.html")`, or experiment with PDF/A compliance for long‑term archiving. The same principles—load, configure options, save—apply across the board. + +Happy coding, and may your PDFs always look exactly as you intended! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/programming-with-shapes/_index.md b/words/english/net/programming-with-shapes/_index.md index 6bda74978f..9045a9a911 100644 --- a/words/english/net/programming-with-shapes/_index.md +++ b/words/english/net/programming-with-shapes/_index.md @@ -35,6 +35,7 @@ By using Aspose.Words for .NET and following these tutorials, you will be able t | [Detect Smart Art Shape](./detect-smart-art-shape/) | Learn how to detect SmartArt shapes in Word documents using Aspose.Words for .NET with this comprehensive, guide. Perfect for automating your document workflow. | | [Update Smart Art Drawing](./update-smart-art-drawing/) | Learn how to update Smart Art drawings in Word documents using Aspose.Words for .NET with this step-by-step guide. Ensure your visuals are always accurate. | | [Create rectangle shape in Word with Aspose.Words – Step‑by‑step guide](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Learn how to create rectangle shapes in Word documents using Aspose.Words for .NET with this step‑by‑step guide. | +| [Create Word Document C# – Add Shape with Shadow](./create-word-document-c-add-shape-with-shadow/) | Learn how to add a shape with shadow to a Word document using Aspose.Words for .NET in C# with this step‑by‑step guide. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/english/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/english/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..7e3e09c718 --- /dev/null +++ b/words/english/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: Create word document c# and learn how to add shape, apply shadow to shape, + and set shadow distance. Step‑by‑step guide for Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: en +og_description: Create word document c# with a rectangle shape and custom shadow. + Follow this complete tutorial to set shadow distance and style. +og_title: Create Word Document C# – Add Shape with Shadow +tags: +- Aspose.Words +- C# +- Document Automation +title: Create Word Document C# – Add Shape with Shadow +url: /net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Create Word Document C# – Add Shape with Shadow + +Ever needed to **create word document c#** that contains a nicely styled rectangle? Maybe you’re building a report template and want a subtle drop‑shadow to make the layout pop. In this tutorial we’ll walk through exactly that – how to add shape, apply shadow to shape, and even tweak the shadow distance using Aspose.Words. + +We’ll start with a blank document, drop in a rectangle, give it a preset shadow, and finish by saving the file. By the end you’ll have a ready‑to‑use .docx that you can open in Word and see the effect instantly. No external tools, just pure C# code. + +## Prerequisites + +- .NET 6 (or any recent .NET Framework) installed. +- Visual Studio 2022 or VS Code with C# extension. +- Aspose.Words for .NET NuGet package (`Aspose.Words` version 23.12 or later). + You can add it via the Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +That’s it – no extra DLLs or COM interop required. + +## Step 1: Initialize a New Document and Builder – *create word document c#* Basics + +First we need a `Document` object that represents the Word file and a `DocumentBuilder` to edit it. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Why this step matters:** The `Document` class is the container for all Word parts (pages, styles, images). The builder is the high‑level API that abstracts away low‑level node manipulation, making it easy to **create word document c#** without dealing with XML directly. + +## Step 2: Insert a Rectangle Shape – *how to create rectangle* + +Now we’ll place a rectangle on the page. The size is expressed in points (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro tip:** If you need a different shape, just swap `ShapeType.Rectangle` for `ShapeType.Ellipse`, `ShapeType.Triangle`, etc. The same code works for **how to add shape** of any type. + +## Step 3: Apply a Preset Shadow and Fine‑Tune It – *apply shadow to shape* + +Aspose.Words ships with several preset shadow formats. We’ll use `Preset1` and then customize distance, blur, transparency, and color. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Why customize the shadow?** The `Distance` property controls how far the shadow sits from the rectangle – think of it as the “lift” you’d see in a 3‑D rendering. Changing `BlurRadius` softens the edges, while `Transparency` lets you create a subtle, professional look. This covers the **set shadow distance** requirement and shows you how to **apply shadow to shape** in a flexible way. + +## Step 4: Save the Document – *create word document c#* Completion + +Finally, write the document to disk. Adjust the path to a folder you have write access to. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Open the resulting file in Microsoft Word, and you’ll see a light‑blue rectangle with a soft gray shadow offset by 5 pt. That’s the visual proof that you successfully **create word document c#** with a styled shape. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# example showing rectangle with shadow"} + +## Optional Variations & Edge Cases + +| Scenario | What to Change | Why it Matters | +|----------|----------------|----------------| +| **Different shadow style** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Gives you a more dramatic look without extra code. | +| **No preset – custom shadow** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Full control over direction and depth. | +| **Multiple shapes** | Call `builder.InsertShape` again before saving. | Useful for complex templates with icons, logos, etc. | +| **Compatibility with older Aspose versions** | Use `ShadowEffect` class (available in v20.x). | Ensures your code runs on legacy projects. | +| **Saving as PDF** | `document.Save("ShadowShape.pdf");` | Same shadow rendering appears in PDF output. | + +> **Common question:** *What if the shadow doesn’t appear in Word?* +> Make sure you’re using a recent version of Aspose.Words (≥ 22.9). Older releases had limited shadow support. Also verify that the document is opened in a recent version of Word (2016+). + +## Full Working Example + +Below is the complete, copy‑paste‑ready program. It includes all `using` directives, comments, and error handling for a smooth experience. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Run the program, navigate to `C:\Temp\ShadowShape.docx`, and you’ll see the rectangle with the exact shadow we configured. + +## Recap & Next Steps + +- You now know how to **create word document c#**, insert a rectangle, and **apply shadow to shape** with a custom **set shadow distance**. +- The example uses Aspose.Words, which abstracts away the OpenXML complexities and guarantees consistent rendering across Word versions. +- Want to go further? Try combining multiple shapes, adding text inside the rectangle, or exporting the same document as PDF to see how the shadow translates. + +### Related Topics You Might Explore + +- **How to add shape** to a header/footer for branding. +- Using **Aspose.Words** to insert charts and tables programmatically. +- Customizing **shadow effects** on pictures instead of vector shapes. +- Automating bulk document generation for invoices or certificates. + +Feel free to experiment, break the code, and then rebuild it – that’s the fastest way to internalize the concepts. If you hit a snag, drop a comment below or check the official Aspose.Words documentation for deeper API insights. + +Happy coding, and enjoy making your Word files look a little more polished! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/programming-with-txtsaveoptions/_index.md b/words/english/net/programming-with-txtsaveoptions/_index.md index 4c280c244a..8ded0ca3ab 100644 --- a/words/english/net/programming-with-txtsaveoptions/_index.md +++ b/words/english/net/programming-with-txtsaveoptions/_index.md @@ -28,7 +28,7 @@ Thanks to these tutorials, you will be able to fully exploit the functionalities | [Add Bidi Marks in Word Document](./add-bidi-marks/) | Learn how to add bidirectional (Bidi) marks in Word documents using Aspose.Words for .NET with this guide. Ensure proper text direction for multi-language content. | | [Use Tab Character Per Level For List Indentation](./use-tab-character-per-level-for-list-indentation/) | Learn how to create multi-level lists with tabbed indentation using Aspose.Words for .NET. Follow this guide for precise list formatting in your documents. | | [Use Space Character Per Level For List Indentation](./use-space-character-per-level-for-list-indentation/) | Learn how to create multi-level lists with space character indentation in Aspose.Words for .NET. Step-by-step guide for precise document formatting. | - +| [Save docx as txt – Complete Guide to Exporting Word Equations to LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Learn how to save DOCX as TXT while exporting Word equations to LaTeX using Aspose.Words for .NET. | {{< /blocks/products/pf/tutorial-page-section >}} @@ -38,4 +38,4 @@ Thanks to these tutorials, you will be able to fully exploit the functionalities {{< /blocks/products/pf/main-wrap-class >}} -{{< blocks/products/products-backtop-button >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/english/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..dfb08c1e7a --- /dev/null +++ b/words/english/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,245 @@ +--- +category: general +date: 2026-03-27 +description: Save docx as txt with Aspose.Words and convert Word to LaTeX. Learn how + to export equations, keep plain text, and get LaTeX markup in minutes. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: en +og_description: Save docx as txt using Aspose.Words. This guide shows how to convert + Word to LaTeX, export equations, and keep your document plain text. +og_title: Save docx as txt – Export Word Equations to LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Save docx as txt – Complete Guide to Exporting Word Equations to LaTeX +url: /net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Save docx as txt – Export Word Equations to LaTeX + +Ever needed to **save docx as txt** but worried you’d lose the fancy math that lives inside your Word file? You’re not alone. In many scientific workflows the plain‑text version of a document is a must, yet you still want the equations to survive as clean LaTeX markup. + +In this tutorial we’ll walk through the exact steps to **convert Word to LaTeX** using Aspose.Words for .NET, so your equations are exported correctly while the rest of the document becomes tidy plain text. By the end you’ll know how to **export equations to LaTeX**, keep the rest of the file as simple text, and avoid the usual pitfalls that trip up newcomers. + +## What You’ll Learn + +- How to load a *.docx* file that contains Office Math. +- Setting the right `TxtSaveOptions` to make Aspose output LaTeX for every equation. +- Saving the result as a **save word plain text** file that you can feed into version control, CI pipelines, or any downstream tool. +- Common edge cases—what to do when a document mixes images and equations, or when you need Unicode characters preserved. +- A complete, ready‑to‑run code sample you can drop into a console app. + +### Prerequisites + +- .NET 6.0 or later (the code works with .NET Framework 4.7+ as well). +- A licensed copy of **Aspose.Words for .NET** (the free trial works for testing). +- Visual Studio 2022 or any IDE that can compile C# projects. +- A Word document (`input.docx`) that already contains some Office Math objects. + +> **Pro tip:** If you don’t have a license yet, you can request a temporary key from Aspose’s website—just replace the placeholder in the code with your key before running. + +## Step 1 – Install Aspose.Words via NuGet + +First thing’s first: you need the library in your project. Open the **Package Manager Console** and run: + +```powershell +Install-Package Aspose.Words +``` + +That single line pulls in everything you need, including the `Saving` namespace where `TxtSaveOptions` lives. No extra DLLs, no native dependencies—just pure managed code. + +## Step 2 – Load the Source Word Document + +Now we actually read the file that holds the equations. The `Document` class abstracts the entire *.docx* structure, so you can treat it like a high‑level object model. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Why this matters:** Loading the document early lets you inspect its node tree. If you skip the check and the file has no equations, you’ll still get a clean txt file—but you won’t know why the LaTeX output is empty. + +## Step 3 – Configure TxtSaveOptions for LaTeX Export + +Aspose gives you fine‑grained control over how Office Math is rendered. By setting `OfficeMathExportMode` to `LaTeX`, every equation is turned into its LaTeX equivalent instead of being stripped out or turned into an image. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Why this matters:** The default export mode would drop the equations entirely. Switching to `LaTeX` keeps the mathematical intent, which is exactly what you need when you later feed the file into a LaTeX compiler or a markdown processor that understands `$…$` syntax. + +## Step 4 – Save the Document as Plain Text + +With the options configured, persisting the file is a one‑liner. The output will be a `.txt` file where every equation appears as LaTeX code surrounded by `$` delimiters (you can change that later if you prefer `\[` … `\]` blocks). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Expected Result + +Open `output.txt` in any editor and you’ll see something like: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Notice how the regular text stays exactly as it was, while the equations are now pure LaTeX strings. You can copy‑paste these directly into a LaTeX document, a Jupyter notebook, or any tool that renders math. + +## Step 5 – Handling Edge Cases + +### Mixed Content (Images + Equations) + +If your Word file also contains images, Aspose will ignore them when you use `TxtSaveOptions`. That’s usually fine for a **save word plain text** workflow, but if you need the images as placeholders you can: + +1. Export the document to HTML first (`HtmlSaveOptions`) to capture images as `` tags. +2. Run a second pass with `TxtSaveOptions` to get the LaTeX equations. +3. Merge the two results manually or with a small script. + +### Unicode Symbols + +Some equations use special Unicode characters (e.g., Greek letters). Setting `Encoding = Encoding.UTF8` in `TxtSaveOptions` (as shown in Step 3) ensures those symbols survive the conversion. + +### Large Documents + +For massive files (> 100 MB), consider streaming the save operation: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Streaming avoids loading the entire output into memory, which can be a lifesaver on low‑memory build agents. + +## Full Working Example + +Below is the complete, copy‑paste‑ready program that ties everything together. Just replace the file paths and, if you have one, the license line. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Run the program (`dotnet run` if you’re using a console project) and check `output.txt`. You’ve just **saved docx as txt** while preserving every equation as LaTeX—no manual copy‑pasting required. + +## Frequently Asked Questions + +**Q: Can I change the delimiter from `$…$` to `\(...\)`?** +A: Yes. After saving, run a simple replace on the file: `output = output.Replace("$", @"\(").Replace("$", @"\)");`—just be careful not to replace inline `$` characters that belong to the original text. + +**Q: Does this work with Word 2007‑2019 files?** +A: Absolutely. Aspose.Words supports `.doc`, `.docx`, `.docm`, and even the newer `.dotx` family. The same code works across all versions. + +**Q: What if I need to keep the original paragraph formatting (tabs, multiple spaces)?** +A: Set `txtSaveOptions.PreserveTableLayout = true;` and `txtSaveOptions.PreserveSpace = true;` to keep whitespace intact. + +## Conclusion + +We’ve covered everything you need to **save docx as txt** while **exporting equations to LaTeX** using Aspose.Words. The key steps are loading the document, configuring `TxtSaveOptions` with `OfficeMathExportMode.LaTeX`, and saving the result. With these three lines of code you can reliably **convert word to latex**, keep your document as **save word plain text**, and avoid the dreaded loss of math symbols. + +Ready for the next challenge? Try chaining this workflow with a markdown generator to produce a full `.md` file that includes both text and LaTeX—perfect for Git‑backed documentation or static‑site generators. Or explore Aspose’s `PdfSaveOptions` to get a PDF version alongside the plain‑text file. + +If you hit any snags, drop a comment below. Happy coding, and enjoy the simplicity of turning Word equations into clean LaTeX! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/working-with-fonts/_index.md b/words/english/net/working-with-fonts/_index.md index 96816bbca5..6f22112e4c 100644 --- a/words/english/net/working-with-fonts/_index.md +++ b/words/english/net/working-with-fonts/_index.md @@ -33,6 +33,7 @@ Whether you want to format text with different fonts, set font substitution rule | [Set Font Emphasis Mark](./set-font-emphasis-mark/) | Learn how to set font emphasis marks in Word documents using Aspose.Words for .NET with this detailed, step-by-step guide. Perfect for .NET developers. | | [Set Fonts Folders](./set-fonts-folders/) | Learn how to set custom font folders in Aspose.Words for .NET with this comprehensive, step-by-step guide. Perfect for developers looking to enhance document fonts. | | [Enable Disable Font Substitution](./enable-disable-font-substitution/) | Learn how to enable or disable font substitution in Word documents using Aspose.Words for .NET. Ensure your documents look consistent across all platforms. | +| [Aspose Font Substitution – How to Configure Font Settings in C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Learn how to configure font substitution settings in Aspose.Words for .NET using C# in this step-by-step tutorial. | | [Set Font Fallback Settings](./set-font-fallback-settings/) | Learn how to set font substitution settings in Aspose.Words for .NET and customize font substitution in your Word documents. | | [Load Noto Fallback Settings](./load-noto-fallback-settings/) | Learn how to load Noto fallback settings in a Word document using Aspose.Words for .NET. Follow our step-by-step guide to ensure all characters display correctly. | | [Set Fonts Folders Default Instance](./set-fonts-folders-default-instance/) | Learn how to set fonts folders for the default instance in Aspose.Words for .NET with this step-by-step tutorial. Customize your Word documents effortlessly. | @@ -59,4 +60,4 @@ Whether you want to format text with different fonts, set font substitution rule {{< /blocks/products/pf/main-wrap-class >}} -{{< blocks/products/products-backtop-button >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/english/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..098fb445be --- /dev/null +++ b/words/english/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose Font Substitution made easy: learn to configure font settings, + capture warnings, and handle missing fonts in your .NET apps.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: en +og_description: Master Aspose Font Substitution by configuring font settings and handling + missing fonts with a warning callback. Complete C# guide. +og_title: Aspose Font Substitution – Configure Font Settings in C# +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose Font Substitution – How to Configure Font Settings in C# +url: /net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Complete Guide to Configure Font Settings + +Ever run into a document that suddenly swaps your custom typeface for something generic? That’s **aspose font substitution** doing its job—replacing missing fonts with the closest match it can find. It’s handy, but if you need to know *exactly* which font got swapped, you have to tap into the library’s warning system and configure the font settings yourself. + +In this tutorial we’ll walk through a real‑world scenario: loading a DOCX that references a font you don’t have, capturing the substitution event, and printing a friendly message to the console. By the end you’ll be comfortable with **configure font settings**, wiring up a **Aspose.Words warning callback**, and extending the sample to fit any workflow. + +> **What you’ll need** +> • .NET 6+ (or .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • A DOCX that references a missing font (we’ll call it `MissingFont.docx`) + +Let’s dive in. + +--- + +## Step 1: Install Aspose.Words and Prepare the Project + +Before we write any code, make sure the Aspose.Words package is referenced: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro tip:** Use the latest stable version; as of March 2026 it’s 23.11.0. Newer releases improve font‑matching algorithms and add extra warning types. + +Create a new console app (or drop the code into an existing project) and add the usual `using` directives: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +These namespaces give us access to the `Document`, `LoadOptions`, and the font‑related classes we’ll need. + +--- + +## Step 2: Configure Font Settings with LoadOptions + +The heart of **aspose font substitution** control lives in `LoadOptions.FontSettings`. By supplying an empty `FontSettings` object we tell Aspose to use its default search paths *and* to report any substitution via a warning callback. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Why not just rely on the defaults? Because attaching a warning callback (next step) only works when the `FontSettings` property is non‑null. This tiny line gives us a hook into the substitution process without changing the actual font search behavior. + +--- + +## Step 3: Attach a Warning Callback to Capture Substitutions + +Aspose.Words implements the `IWarningCallback` interface. Whenever something noteworthy happens—like a missing font—it calls our `Warning` method. We’ll implement a tiny handler that filters for `WarningType.FontSubstitution` and prints the description. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +And here’s the handler itself: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Why this matters** – Without the callback, Aspose silently swaps fonts, and you never know which one was used. The callback makes the process transparent, which is essential for compliance reporting or for debugging layout issues. + +--- + +## Step 4: Load the Document Using the Configured Options + +Now we finally load the document, passing the `loadOptions` we just prepared. If the source file references a font that isn’t installed, our handler will fire. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Replace `YOUR_DIRECTORY` with the actual path where `MissingFont.docx` lives. When you run the program, you should see output similar to: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +That line tells you exactly which font was missing and which fallback Aspose chose. + +--- + +## Step 5: (Optional) Fine‑Tune Font Search Paths + +If you have a private folder with corporate fonts, you can tell Aspose where to look before it falls back to system fonts. This is an advanced use of **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Setting `recursive: true` makes Aspose scan subfolders as well. Now the library will try your private fonts first, reducing the chance of unwanted substitution. + +--- + +## Full Working Example + +Putting everything together, here’s the complete, ready‑to‑run program: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Expected output** (when a missing font is encountered): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +If all fonts are present, the program runs silently (no warnings) and still produces the PDF. + +--- + +## Common Questions & Edge Cases + +### What if I need to *prevent* substitution altogether? + +Set the `FontSettings.SubstitutionSettings` to `null` or use `FontSettings.FontSubstitutionSettings` to control the behavior. For example: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Now Aspose will throw an exception instead of silently substituting, which can be caught and handled. + +### Does this work with other file formats (e.g., .doc, .rtf)? + +Absolutely. The same `LoadOptions` object can be passed to any `Document` constructor that accepts a file path. The warning callback will fire for all formats that rely on fonts. + +### Can I capture the *exact* fallback font name? + +Yes. The `info.Description` string contains both the missing font and the replacement. If you need the name programmatically, you can parse it or use the `FontInfo` object (available in newer versions). + +### How does this behave in a multi‑threaded environment? + +`FontSettings` is **not** thread‑safe. Create a separate `LoadOptions` (with its own `FontSettings`) per thread, or protect access with a lock. + +--- + +## Conclusion + +We’ve covered everything you need to master **aspose font substitution** and **configure font settings** in a C# application: + +1. Install Aspose.Words and add the necessary `using` statements. +2. Create a `LoadOptions` object with a fresh `FontSettings`. +3. Attach a custom `IWarningCallback` to surface substitution events. +4. Load the document, letting the callback report any missing fonts. +5. (Optional) Extend the search path or disable substitution entirely. + +Armed with this pattern you can log missing fonts for compliance, alert users in a UI, or automatically embed fallback fonts before publishing. Next, you might explore **Aspose.Words font substitution policies** or integrate the workflow into a larger document‑processing pipeline. + +Happy coding, and may your documents always render with the right typeface! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/net/basic-conversions/_index.md b/words/french/net/basic-conversions/_index.md index b7640635ad..94857c1783 100644 --- a/words/french/net/basic-conversions/_index.md +++ b/words/french/net/basic-conversions/_index.md @@ -34,6 +34,7 @@ Conversions de base vous guide dans les conversions de documents de base avec la | [Enregistrer un PDF au format Jpeg](./pdf-to-jpeg/) | Convertissez facilement des PDF en JPEG avec Aspose.Words pour .NET. Suivez notre guide détaillé avec exemples et FAQ. Idéal pour les développeurs et les passionnés. | | [Enregistrer un PDF au format Word (Docx)](./pdf-to-docx/) | Découvrez comment convertir un PDF en document Word (Docx) avec Aspose.Words pour .NET grâce à ce guide détaillé, étape par étape. Idéal pour les développeurs. | | [Convertir Word en PDF en C# avec Aspose.Words – Guide](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Apprenez à convertir un document Word en PDF en C# avec Aspose.Words grâce à ce guide étape par étape. | +| [Convertir Word en PDF avec Aspose.Words – Guide complet](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Apprenez à convertir un document Word en PDF avec Aspose.Words en suivant notre guide complet étape par étape. | | [Comment exporter LaTeX depuis Word – Guide étape par étape](./how-to-export-latex-from-word-step-by-step-guide/) | Apprenez à exporter le contenu d'un document Word au format LaTeX avec Aspose.Words pour .NET grâce à ce guide détaillé étape par étape. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/french/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/french/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..94d64b9b81 --- /dev/null +++ b/words/french/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-03-27 +description: Convertir Word en PDF rapidement avec Aspose.Words. Découvrez comment + enregistrer un fichier Word en PDF, exporter un docx en PDF et générer un PDF accessible + en C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: fr +og_description: Convertir Word en PDF en C# avec Aspose.Words. Ce guide montre comment + enregistrer un document Word en PDF, exporter un DOCX en PDF et générer un PDF accessible. +og_title: Convertir Word en PDF avec Aspose.Words – Étape par étape +tags: +- Aspose.Words +- C# +- PDF conversion +title: Convertir Word en PDF avec Aspose.Words – Guide complet +url: /fr/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convertir Word en PDF avec Aspose.Words – Guide complet + +Vous vous êtes déjà demandé comment **convertir Word en PDF** sans vous embrouiller avec des outils web tiers ? Peut‑être que vous construisez un moteur de rapports automatisé et avez besoin d’une méthode fiable pour *enregistrer word en pdf* à la volée. Bonne nouvelle : Aspose.Words rend tout cela très simple, et vous pouvez même générer un fichier conforme **PDF/UA‑2**—parfait pour les exigences d’accessibilité. + +Dans ce tutoriel, nous passerons en revue tout ce dont vous avez besoin : charger un `.docx`, configurer les options PDF afin de *exporter docx en pdf* avec conformité PDF/UA, puis enregistrer le résultat en PDF accessible. À la fin, vous disposerez d’un extrait autonome, prêt pour la production, que vous pourrez intégrer à n’importe quel projet .NET. + +![Convertir Word en PDF avec Aspose.Words](convert-word-to-pdf.png) + +## Ce que vous allez apprendre + +- **Pourquoi Aspose.Words** est un excellent choix pour les scénarios de *générer pdf accessible*. +- Les étapes exactes pour *enregistrer le document en pdf* avec conformité PDF/UA‑2. +- Comment gérer les cas limites courants comme les polices manquantes ou les fichiers source protégés par mot de passe. +- Astuces rapides pour déboguer la sortie et vérifier la conformité d’accessibilité. + +### Prérequis + +- .NET 6 ou supérieur (l’API fonctionne également avec .NET Framework 4.6+). +- Une licence valide d’Aspose.Words for .NET (l’essai gratuit suffit pour l’évaluation). +- Connaissances de base en C#—pas de motifs sophistiqués requis. + +Si vous avez coché ces cases, plongeons‑y. + +--- + +## Convertir Word en PDF – Implémentation étape par étape + +Nous allons diviser la solution en cinq étapes claires. Chaque étape possède un titre, un court extrait de code, et une explication du *pourquoi* du code. + +### Étape 1 : Charger le document Word à convertir + +La première chose dont vous avez besoin est un objet `Document` qui représente le fichier source. Aspose.Words lit **.docx**, **.doc**, **.rtf**, et bien d’autres formats, vous permettant de *save word as pdf* quel que soit le format d’origine. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Pourquoi c’est important :** +- Charger le fichier dès le départ vous permet de détecter les erreurs de fichier manquant avant de gaspiller des cycles CPU. +- La classe `Document` masque la structure interne d’un fichier Word, vous offrant un modèle d’objet propre avec lequel travailler. + +### Étape 2 : Configurer les options d’enregistrement PDF pour l’accessibilité + +Si vous devez *generate accessible pdf*, il faut indiquer à Aspose.Words de produire un document conforme PDF/UA‑2. La classe `PdfSaveOptions` vous donne un contrôle granulaire sur la sortie. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Pourquoi c’est important :** +- `PdfCompliance.PdfUa2` indique à la bibliothèque d’ajouter les balises, les informations de structure et les métadonnées nécessaires aux lecteurs d’écran. +- L’incorporation des polices (`EmbedFullFonts = true`) évite les avertissements « font not found » lorsque le PDF est ouvert sur un autre système d’exploitation. +- Définir un `Title` aide les technologies d’assistance à annoncer correctement le document. + +### Étape 3 : Enregistrer le document au format PDF + +Une fois la source chargée et les options définies, la conversion réelle se résume à une seule ligne. C’est ici que vous *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Pourquoi c’est important :** +- La méthode `Save` respecte les `PdfSaveOptions` que nous avons configurées, garantissant que les fonctionnalités d’accessibilité sont intégrées. +- Envelopper l’appel dans un bloc `try/catch` vous permet de consigner ou de signaler les éventuelles erreurs de licence ou de permissions qui bloquent souvent les débutants. + +### Étape 4 : Vérifier la conformité PDF/UA (Optionnel mais recommandé) + +Même si Aspose.Words effectue le gros du travail, il est judicieux de revérifier la sortie, surtout lorsque vous livrez des documents à des administrations ou à d’autres entités réglementées. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Pourquoi c’est important :** +- `IsTagged` est une vérification rapide ; une validation complète PDF/UA nécessite un validateur dédié, mais la plupart des problèmes de conformité apparaissent sous forme de balises manquantes. +- Si le drapeau renvoie `false`, vous pouvez revenir aux `PdfSaveOptions`—peut‑être avez‑vous oublié de définir `Compliance` ou le document source manquait de styles de titres appropriés. + +### Étape 5 : Pièges courants & Astuces pro + +| Piège | Ce qui se passe | Comment corriger | +|---------|--------------|------------| +| **Polices manquantes** | Le texte apparaît sous forme de carrés dans le PDF. | Définissez `EmbedFullFonts = true` **ou** installez les polices manquantes sur le serveur. | +| **Bibliothèque non licenciée** | Aspose ajoute un filigrane sur chaque page. | Ajoutez votre fichier de licence (`Aspose.Words.lic`) tôt dans l’application (par ex., `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Source protégée par mot de passe** | `InvalidOperationException` sur `new Document(path)`. | Utilisez la surcharge `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Documents volumineux provoquant OOM** | Exception out‑of‑memory sur de gros fichiers. | Activez `MemoryOptimization` dans `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Balises d’accessibilité manquantes** | La validation PDF/UA échoue. | Assurez‑vous que le fichier Word source utilise les styles de titres appropriés (`Heading 1`, `Heading 2`, etc.)—Aspose les mappe automatiquement en balises PDF. | + +**Astuce pro :** Si vous convertissez de nombreux documents en lot, réutilisez une seule instance de `PdfSaveOptions`. La créer une fois réduit les allocations et maintient votre empreinte mémoire faible. + +--- + +## Exemple complet (prêt à copier‑coller) + +Voici le programme complet qui assemble tous les éléments. Enregistrez‑le sous `Program.cs`, ajoutez les packages NuGet Aspose.Words et Aspose.PDF, puis exécutez. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Résultat attendu :** +Un fichier nommé `output.pdf` apparaît dans `C:\MyFiles`. L’ouvrir avec Adobe Acrobat affichera « PDF/A‑2b, PDF/UA‑1 » dans le panneau de conformité, confirmant que vous avez bien *convert word to pdf*. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/net/programming-with-markdownsaveoptions/_index.md b/words/french/net/programming-with-markdownsaveoptions/_index.md index 0439984b15..f4c31935ac 100644 --- a/words/french/net/programming-with-markdownsaveoptions/_index.md +++ b/words/french/net/programming-with-markdownsaveoptions/_index.md @@ -44,10 +44,16 @@ Apprenez à enregistrer des fichiers DOCX en Markdown tout en conservant les éq ### [Comment exporter Markdown depuis Word – Guide complet C#](./how-to-export-markdown-from-word-complete-c-guide/) +### [Créer du markdown depuis Word – Guide complet C#](./create-markdown-from-word-full-c-guide/) + ### [Comment enregistrer le Markdown depuis DOCX – Guide étape par étape](./how-to-save-markdown-from-docx-step-by-step-guide/) ### [Comment exporter Markdown depuis DOCX – Guide complet](./how-to-export-markdown-from-docx-complete-guide/) +### [Comment exporter LaTeX depuis Word – Convertir DOCX en Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) + +### [Comment exporter LaTeX depuis DOCX – Convertir en Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/french/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/french/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..645e8a38a8 --- /dev/null +++ b/words/french/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Créer du markdown à partir de Word avec Aspose.Words C#. Apprenez à convertir + des fichiers docx en markdown, à extraire les images de Word et à utiliser les callbacks + dans un seul tutoriel. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: fr +og_description: Créer du markdown à partir de Word avec Aspose.Words. Ce guide montre + comment convertir un docx en markdown, extraire les images de Word et utiliser un + rappel pour la gestion des ressources. +og_title: Créer du markdown à partir de Word – Tutoriel complet C# +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Créer du markdown à partir de Word – Guide complet C# +url: /fr/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Créer du markdown à partir de Word – Tutoriel complet C# + +Vous avez déjà eu besoin de **créer du markdown à partir de Word** mais vous ne saviez pas par où commencer ? Vous n'êtes pas seul ; de nombreux développeurs rencontrent ce problème lorsqu'ils essaient de déplacer du contenu d'un fichier .docx vers un générateur de site statique ou un dépôt de documentation. La bonne nouvelle ? Avec Aspose.Words, vous pouvez **convertir docx en markdown**, extraire chaque image du fichier original et contrôler exactement où ces ressources sont placées — le tout avec un simple callback. + +Dans ce guide, nous parcourrons un exemple réel qui montre comment extraire les images de Word, comment utiliser le callback pour les stocker, et pourquoi cette approche est la plus fiable pour les pipelines d'automatisation. À la fin, vous disposerez d’un programme C# prêt à l’emploi qui produit un fichier `.md` propre et un dossier d’images extraites. + +> **Astuce :** Si vous avez déjà un modèle Word contenant des captures d’écran, des diagrammes ou des logos, cette méthode préservera chaque élément visuel sans que vous ayez à copier‑coller manuellement. + +--- + +## Ce dont vous aurez besoin + +- **.NET 6+** (ou .NET Framework 4.6+). Le code fonctionne avec n’importe quel runtime récent. +- **Aspose.Words for .NET** (package NuGet `Aspose.Words`). L’essai gratuit suffit pour la plupart des scénarios. +- Un **document Word** (`input.docx`) contenant du texte et au moins une image. +- Une compréhension de base du C# et de Visual Studio (ou votre IDE préféré). + +Aucune bibliothèque supplémentaire n’est requise — tout le reste est géré par Aspose.Words lui‑même. + +--- + +## Étape 1 : Configurer le projet et installer Aspose.Words + +Pour garder les choses ordonnées, démarrez un nouveau projet console : + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Pourquoi cette étape est importante :** L’installation du package NuGet vous garantit d’avoir la dernière API, qui inclut la classe `MarkdownSaveOptions` introduite dans la version 22.9. Sans cela, vous devriez écrire un convertisseur personnalisé. + +--- + +## Étape 2 : Charger le document Word source + +La première ligne de code ouvre le `.docx` que vous souhaitez transformer. Remplacez `YOUR_DIRECTORY` par le chemin réel sur votre machine. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Que se passe‑t‑il ?** `Document` analyse le fichier, construit un DOM interne et rend chaque paragraphe, tableau et image accessibles. Si le fichier est absent, Aspose lève une `FileNotFoundException` claire, que vous pouvez intercepter pour une interface plus conviviale. + +--- + +## Étape 3 : Configurer les options d’enregistrement Markdown avec un callback d’enregistrement des ressources + +Voici où la magie du **how to use callback** entre en jeu. Le callback vous permet de décider où chaque image extraite doit être placée. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Pourquoi un callback ?** Par défaut, Aspose intégrerait les images sous forme de chaînes base‑64 dans le markdown — un cauchemar pour le contrôle de version. Le callback vous donne un contrôle total sur les noms de fichiers et la structure des dossiers. + +--- + +## Étape 4 : Enregistrer le document au format Markdown + +Nous générons maintenant réellement le fichier `.md`. Toutes les images seront transmises au callback défini à l’étape suivante. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Si tout se passe bien, vous trouverez `Document.md` dans le dossier cible ainsi qu’un sous‑dossier nommé `Resources` contenant chaque image extraite du fichier Word original. + +--- + +## Étape 5 : Implémenter le callback qui stocke chaque image extraite + +Voici l’implémentation complète de `MyResourceSaver`. Elle crée un répertoire `Resources` (s’il n’existe pas), génère un nom de fichier unique pour chaque image et écrit le flux d’image sur le disque. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Explication des arguments :** +> - `args.Index` – un compteur zéro‑based qui garantit l’unicité. +> - `args.FileName` – le nom de fichier original suggéré par Aspose (souvent quelque chose comme `image001.png`). +> - `args.Stream` – le flux de sortie où les octets de l’image sont écrits. +> - `args.KeepResourceStreamOpen` – défini à `false` afin qu’Aspose libère automatiquement le flux, évitant les fuites de descripteurs de fichiers. + +--- + +## Exemple complet fonctionnel + +En rassemblant le tout, voici un fichier unique que vous pouvez copier‑coller dans `Program.cs`. N’oubliez pas de remplacer `YOUR_DIRECTORY` par un chemin absolu ou relatif adapté à votre environnement. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Résultat attendu + +- `YOUR_DIRECTORY/Document.md` – un fichier markdown avec des liens d’image markdown standards, par ex. : + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – contient `img_0.png`, `img_1.jpg`, etc., correspondant à l’ordre d’apparition dans le document Word original. + +L’exécution du programme affiche une confirmation conviviale, indiquant que le processus a réussi. + +--- + +## FAQ (Foire aux questions) + +### Comment extraire les images de Word sans perdre en qualité ? + +Le callback écrit le flux binaire brut directement dans un fichier, préservant la résolution originale. Aucune conversion ou compression n’est effectuée sauf si vous ajoutez votre propre logique de traitement d’image dans `ResourceSaving`. + +### Puis‑je changer le format de l’image (p. ex. PNG → JPEG) lors de l’extraction ? + +Absolument. Dans `ResourceSaving`, vous pouvez inspecter `args.FileName` ou `args.Stream`, charger l’image avec `System.Drawing` ou `ImageSharp`, puis la ré‑encoder avant l’écriture. N’oubliez pas de mettre à jour l’extension du lien markdown en conséquence. + +### Et si je veux que les fichiers markdown référencent un CDN plutôt qu’un dossier local ? + +Modifiez le callback pour préfixer le lien markdown avec une URL de base. Vous pouvez le faire en affectant à `args.FileName` une URL pleinement qualifiée après avoir téléchargé l’image sur votre CDN. + +### Cette méthode fonctionne‑t‑elle avec les tableaux, notes de bas de page ou d’autres fonctionnalités avancées de Word ? + +Oui. Aspose.Words traduit la plupart des constructions Word en équivalents markdown. Les tableaux deviennent des tableaux markdown, les notes de bas de page se transforment en liens de référence, et même les listes imbriquées sont gérées correctement. Si quelque chose semble étrange, consultez les notes de version les plus récentes — Aspose améliore continuellement la fidélité de la conversion. + +### Comment convertir docx en markdown dans une pipeline CI/CD ? + +Il suffit d’ajouter l’exécutable `.exe` compilé à vos étapes de build, de le pointer vers les artefacts `.docx` générés, puis de pousser le `.md` et le dossier `Resources/` résultants vers votre dépôt de site statique. Comme le processus est entièrement déterministe, il fonctionne bien dans les environnements automatisés. + +--- + +## Conclusion + +Nous venons de démontrer comment **créer du markdown à partir de Word** avec Aspose.Words, couvrir l’ensemble du flux **convert docx to markdown**, et montrer une façon pratique d’**extraire les images de Word** grâce à une implémentation personnalisée du **how to use callback**. Le résultat est un fichier markdown propre accompagné d’un dossier d’images originales — idéal pour les sites de documentation, les blogs statiques ou tout workflow privilégiant les formats texte brut. + +Prochaines étapes possibles : + +- **Traitement par lots** de plusieurs fichiers `.docx` dans un dossier (boucle sur `Directory.GetFiles`). +- **Schémas de nommage personnalisés** pour les images (par ex. en utilisant le texte de la légende originale). +- **Post‑traitement** du markdown pour remplacer les liens d’image par des URLs CDN. +- Explorer les **autres formats d’exportation Aspose** comme HTML, PDF ou EPUB pour une publication multicanale. + +Vous avez d’autres questions ou un fichier Word récalcitrant qui refuse de se convertir ? Laissez un commentaire ci‑dessous, et résolvons le problème ensemble. Bon codage, et profitez de la simplicité de transformer Word en markdown ! + +--- + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/french/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..66c765562c --- /dev/null +++ b/words/french/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,269 @@ +--- +category: general +date: 2026-03-27 +description: Comment exporter du LaTeX depuis DOCX avec Aspose.Words. Apprenez à convertir + DOCX en Markdown, définir le DPI et activer la récupération en C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: fr +og_description: Comment exporter du LaTeX depuis un DOCX avec Aspose.Words. Ce tutoriel + montre la conversion pas à pas en Markdown, le contrôle du DPI et le mode de récupération. +og_title: Comment exporter LaTeX depuis DOCX – Convertir en Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Comment exporter LaTeX depuis DOCX – Convertir en Markdown +url: /fr/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment exporter du LaTeX depuis un DOCX – Convertir en Markdown + +Vous vous êtes déjà demandé **comment exporter du LaTeX** depuis un fichier DOCX sans perdre la beauté de vos équations ? Vous n'êtes pas seul. D'après mon expérience, le principal problème est de récupérer ces objets OfficeMath dans un format propre et portable pour les générateurs de sites statiques ou les blogs scientifiques. + +Dans ce guide, nous parcourrons la conversion de DOCX en Markdown avec Aspose.Words, tout en montrant **comment définir le DPI**, **comment activer la récupération**, et quelques astuces pratiques pour un pipeline robuste. À la fin, vous disposerez d'un programme C# unique qui génère un fichier Markdown avec des équations LaTeX, des images haute résolution et une gestion correcte des hyperliens. + +## Ce dont vous avez besoin + +- **.NET 6+** (ou .NET Framework 4.7.2 – l'API fonctionne de la même façon) +- **Aspose.Words for .NET** (la dernière version stable à partir de mars 2026) +- Un fichier DOCX contenant des équations, des images et des liens +- Visual Studio, VS Code, ou tout éditeur de votre choix + +Aucun package NuGet supplémentaire n'est requis au-delà d'Aspose.Words, mais assurez‑vous de disposer d'une licence valide si vous n'utilisez pas la version d'essai. + +## Étape 1 – Charger le DOCX en mode de récupération stricte + +Avant même de penser à l'exportation, nous devons nous assurer que le document source ne cache pas de corruption. C'est là que **comment activer la récupération** entre en jeu. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Pourquoi une récupération stricte ?** +Si vous laissez Aspose corriger silencieusement les problèmes, vous pourriez vous retrouver avec des paragraphes manquants ou des images cassées—ce que personne ne veut lors de l'exportation du LaTeX. En échouant rapidement, vous pouvez détecter le problème tôt et décider de corriger le DOCX source ou d'enregistrer le problème pour plus tard. + +### Astuce pro +Enveloppez le chargement dans un try/catch et consignez `DocumentLoadingException`. Ainsi, votre pipeline CI peut signaler les fichiers problématiques sans interrompre l'ensemble du build. + +## Étape 2 – Préparer les options d'exportation Markdown + +Maintenant que le document est en mémoire en toute sécurité, nous configurons la façon dont il sera enregistré. C’est le cœur de **comment exporter du latex** et couvre également **comment définir le DPI** pour les images intégrées. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Ce que fait chaque option** + +| Option | Raison | Pertinence par rapport aux mots‑clés | +|--------|--------|--------------------------------------| +| `OfficeMathExportMode = LaTeX` | Répond directement à **how to export latex** depuis les équations. | Mot‑clé principal | +| `ImageResolution = 300` | Contrôle la qualité de l'image – la réponse à **how to set dpi**. | Secondaire | +| `ResourceSavingCallback` | Enregistre les fichiers intégrés sur le disque, un besoin fréquent lors de **convert docx to markdown**. | Secondaire | +| `EmptyParagraphExportMode` | Garantit une sortie Markdown propre, évitant les balises HTML parasites. | Améliore la qualité globale de la conversion | +| `LinkExportMode = AsReference` | Rend les liens faciles à lire et à éditer, un autre avantage pour **convert docx to markdown**. | | + +## Étape 3 – Implémenter un enregistreur de ressources personnalisé (Optionnel mais pratique) + +Lorsque vous convertissez un DOCX en Markdown, les images et autres ressources binaires ont besoin d'un emplacement sur le système de fichiers. Aspose vous permet de contrôler cela avec `IResourceSavingCallback`. L'extrait ci‑dessus montre déjà une implémentation minimale, mais décomposons‑le : + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Pourquoi s'en soucier ?** +Si vous sautez cette étape, Aspose intégrera les images sous forme de chaînes base‑64, ce qui gonfle la taille du fichier Markdown et rend le contrôle de version pénible. En enregistrant les ressources dans un dossier séparé, vous gardez le Markdown léger et le rendez compatible avec les générateurs de sites statiques comme Hugo ou Jekyll. + +## Étape 4 – Enregistrer le document en Markdown + +Tout le travail lourd est terminé. Une seule ligne écrit maintenant le fichier final. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Ouvrez `output.md` et vous verrez : + +- Des équations rendues sous forme de blocs LaTeX `$…$` +- Des images référencées comme `![Alt text](resources/image001.png)` avec une résolution de 300 dpi +- Des hyperliens convertis en style de référence : + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +C’est tout le processus **how to convert docx** en bref. + +## Questions fréquentes & cas limites + +### 1️⃣ Que faire si le DOCX contient des objets non pris en charge ? + +Aspose.Words lèvera une `FeatureNotSupportedException`. Comme nous avons utilisé **how to enable recovery** en mode strict, l'exception apparaît immédiatement. Vous pouvez soit : + +- Passer `RecoveryMode` à `RecoveryMode.Default` pour une conversion au meilleur effort, **ou** +- Pré‑traiter le DOCX (par ex., supprimer le SmartArt non pris en charge) avant d'exécuter le convertisseur. + +### 2️⃣ Puis‑je changer le DPI par image ? + +Le paramètre `ImageResolution` est global. Pour un contrôle par image, implémentez un `ImageSavingCallback` personnalisé similaire à `MyResourceSaver` et ajustez `args.ImageResolution` en fonction de `args.ImageFileName` ou des métadonnées. + +### 3️⃣ Comment intégrer le LaTeX généré dans un site Jekyll ? + +Le support MathJax intégré de Jekyll fonctionne immédiatement. Assurez‑vous simplement que votre mise en page inclut le script MathJax et que les blocs LaTeX sont entourés de `$$` pour les équations affichées ou de `$` pour les inline. + +### 4️⃣ Cette solution est‑elle compatible avec .NET Core sous Linux ? + +Absolument. Aspose.Words est multiplateforme. Assurez‑vous simplement que le chemin `YOUR_DIRECTORY` suit les conventions Linux (par ex., `/home/user/docs`). + +## Exemple complet fonctionnel + +Voici un programme prêt à copier‑coller. Remplacez `YOUR_DIRECTORY` par un chemin réel sur votre machine. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Sortie attendue** – ouvrez `output.md` et vous devriez voir quelque chose comme : + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Si vous ouvrez le fichier dans un aperçu Markdown qui supporte MathJax, l'intégrale s'affiche + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/french/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..9fbce2076f --- /dev/null +++ b/words/french/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-03-27 +description: Comment exporter du LaTeX à partir de documents Word en utilisant Aspose.Words + – convertir DOCX en Markdown avec les équations en LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: fr +og_description: Comment exporter du LaTeX depuis des documents Word est expliqué dans + la première phrase, vous montrant comment convertir un DOCX en Markdown avec des + équations en LaTeX. +og_title: Comment exporter LaTeX depuis Word – Guide complet +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Comment exporter LaTeX depuis Word – Convertir DOCX en Markdown +url: /fr/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment exporter du LaTeX depuis Word – Convertir DOCX en Markdown + +Vous vous êtes déjà demandé **comment exporter du LaTeX** depuis un fichier Word sans vous retrouver avec une foule de PNG ? Vous n'êtes pas le seul ; les développeurs rencontrent constamment ce problème lorsqu'ils ont besoin d'équations propres et éditables pour des sites statiques ou des blogs scientifiques. La bonne nouvelle ? Avec Aspose.Words, vous pouvez **convertir Word en Markdown** et conserver chaque objet OfficeMath en LaTeX natif—aucun post‑processing requis. + +Dans ce tutoriel, nous parcourrons l’ensemble du processus de **sauvegarde d’un document Word au format Markdown** tout en **exportant les équations en LaTeX**. À la fin, vous disposerez d’un extrait C# exécutable, d’une explication claire de chaque option, et de conseils pour gérer les cas limites comme les formules complexes ou le contenu mixte. Aucun outil externe, juste un seul package NuGet et quelques lignes de code. + +## Ce dont vous avez besoin + +- .NET 6+ (ou .NET Framework 4.7.2 et supérieur) – la dernière version du runtime fonctionne le mieux. +- Visual Studio 2022 ou tout éditeur capable de compiler des projets C#. +- Une licence Aspose.Words for .NET (l’essai gratuit suffit pour l’expérimentation). +- Un fichier DOCX contenant au moins une équation (OfficeMath). + +Si vous avez déjà tout cela, super—plongeons‑y. + +## Comment exporter du LaTeX depuis Word – Vue d'ensemble + +Voici une vue d’ensemble des étapes impliquées : + +1. **Installer** le package NuGet Aspose.Words. +2. **Charger** le `.docx` source qui contient vos équations. +3. **Configurer** `MarkdownSaveOptions` afin que `OfficeMathExportMode` soit réglé sur `LaTeX`. +4. **Enregistrer** le document sous forme de fichier `.md`. +5. **Vérifier** que le Markdown généré contient des blocs LaTeX (`$$…$$`). + +Chaque étape est détaillée dans les sections suivantes. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="Diagramme montrant le flux du DOCX vers Markdown avec des équations LaTeX"} + +## Étape 1 – Installer Aspose.Words pour .NET (convertir word en markdown) + +Tout d’abord : vous avez besoin de la bibliothèque qui effectue réellement le travail lourd. Ouvrez votre terminal (ou la console du gestionnaire de packages) et exécutez : + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Astuce :** Si vous utilisez Visual Studio, faites un clic droit sur le projet → *Manage NuGet Packages* → recherchez “Aspose.Words” et installez la dernière version stable. + +Pourquoi c’est important : Aspose.Words abstrait le format Open XML, vous offrant une API propre pour manipuler les documents Word sans gérer le XML de bas niveau. Elle inclut également un support natif pour convertir OfficeMath en LaTeX, ce qui constitue le cœur de notre exigence **exporter les équations en LaTeX**. + +## Étape 2 – Charger le DOCX (comment convertir docx) + +Maintenant que le package est en place, chargez le fichier que vous souhaitez transformer. Remplacez `YOUR_DIRECTORY` par le chemin où se trouve votre `.docx` : + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Pourquoi le charger ainsi ?** Le constructeur `Document` analyse le fichier complet en un modèle d’objet, vous donnant un accès instantané aux paragraphes, tableaux et—le plus important—aux objets OfficeMath. Si le fichier est manquant ou corrompu, Aspose lève une `FileNotFoundException` descriptive, que vous pouvez intercepter pour une gestion d’erreur élégante. + +## Étape 3 – Configurer MarkdownSaveOptions (exporter les équations en latex) + +La magie se produit dans l’objet `MarkdownSaveOptions`. Par défaut, Aspose rendrait les équations sous forme d’images PNG, mais nous voulons du LaTeX. Réglez `OfficeMathExportMode` sur `LaTeX` : + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Une petite note sur les indicateurs optionnels : `ExportImagesAsBase64` indique à Aspose de ne pas intégrer de données binaires, ce qui garde le Markdown propre. `ExportHeadersFooters` garantit que vous ne perdez aucun contexte pouvant se trouver dans ces sections—utile lorsque l’en‑tête contient un titre ou le nom de l’auteur. + +## Étape 4 – Enregistrer le document (enregistrer word en markdown) + +Enfin, écrivez le contenu transformé dans un fichier `.md` : + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Après l’exécution de cette ligne, vous trouverez `output.md` à côté de votre fichier source. Ouvrez‑le dans n’importe quel éditeur de texte et vous devriez voir des blocs LaTeX ressemblant à ceci : + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +C’est la partie **enregistrer word en markdown** terminée—aucune étape de conversion supplémentaire requise. + +## Étape 5 – Vérifier le résultat (exporter les équations en latex) + +Il est facile d’oublier la vérification, mais un rapide contrôle de cohérence vous fait gagner des heures plus tard. Exécutez un petit script qui lit le fichier généré et affiche le premier bloc LaTeX : + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Si vous voyez `First LaTeX block: $$ … $$` affiché, vous avez **exporté du LaTeX** depuis Word avec succès. Sinon, revérifiez que votre document source contient réellement des objets OfficeMath ; les équations en texte ordinaire ne seront pas converties. + +## Gestion des cas limites courants + +| Scénario | À surveiller | Correction recommandée | +|----------|--------------|------------------------| +| **Images mixtes & équations** | Aspose peut encore intégrer des images pour les graphiques qui ne sont pas OfficeMath. | Réglez `ExportImagesAsBase64 = false` et conservez les images comme fichiers externes, puis référencez‑les manuellement dans le Markdown. | +| **Équations imbriquées complexes** | Un imbriquement très profond peut produire du LaTeX nécessitant un ajustement manuel. | Post‑traitez le bloc avec un formateur LaTeX (par ex., `latexindent`) ou ajustez `mdOptions` → `ExportMathAsDisplay = true`. | +| **Documents volumineux** | L’utilisation de la mémoire augmente fortement lors du chargement de gros fichiers `.docx`. | Utilisez `LoadOptions` avec `LoadFormat.Docx` et activez le streaming `LoadOptions.LoadFormat` si disponible. | +| **Licence manquante** | L’essai gratuit ajoute un commentaire filigrane à la sortie. | Appliquez une licence valide via `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Ces astuces rendent votre flux de travail robuste, surtout lorsque vous **convertissez word en markdown** dans des pipelines de production. + +## Exemple complet (Toutes les étapes dans un seul fichier) + +Voici une application console autonome que vous pouvez copier‑coller dans un nouveau projet .NET et exécuter immédiatement. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Exécutez le programme, ouvrez `output.md`, et vous verrez vos équations rendues en LaTeX propre. C’est la réponse complète à **comment exporter du latex** depuis un document Word. + +## Conclusion + +Nous avons couvert **comment exporter du LaTeX** depuis Word étape par étape, en vous montrant comment **convertir Word en markdown**, **enregistrer word en markdown**, et **exporter les équations en LaTeX** à l’aide d’Aspose.Words. L’idée centrale est simple : charger le DOCX, ajuster `MarkdownSaveOptions`, et laisser la bibliothèque faire le travail lourd. + +Si vous êtes prêt à automatiser vos pipelines de documentation, essayez d’enchaîner ce code avec un générateur de site statique comme Hugo ou Jekyll—il suffit de pousser les fichiers `.md` générés dans votre dépôt et de laisser le site se reconstruire. Pour aller plus loin, explorez le guide Aspose “Export to LaTeX”, expérimentez `HtmlSaveOptions` pour des aperçus web, ou plongez dans l’API `DocumentVisitor` pour des transformations personnalisées. + +Des questions sur les cas limites, la licence, ou l’intégration dans CI/CD ? Laissez un commentaire ci‑dessous, et bon codage ! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/net/programming-with-pdfsaveoptions/_index.md b/words/french/net/programming-with-pdfsaveoptions/_index.md index 8b3260f861..56cc36228e 100644 --- a/words/french/net/programming-with-pdfsaveoptions/_index.md +++ b/words/french/net/programming-with-pdfsaveoptions/_index.md @@ -29,23 +29,23 @@ Que vous souhaitiez convertir des documents Word en PDF pour une distribution en | [Ajouter une signature numérique au PDF à l'aide du titulaire du certificat](./digitally-signed-pdf-using-certificate-holder/) |Sécurisez vos fichiers PDF avec une signature numérique grâce à Aspose.Words pour .NET. Suivez ce guide étape par étape pour ajouter facilement une signature numérique à vos PDF. | | [Incorporer des polices dans un document PDF](./embedded-all-fonts/) Intégrez facilement des polices dans vos documents PDF grâce à Aspose.Words pour .NET grâce à ce guide détaillé, étape par étape. Assurez une apparence cohérente sur tous les appareils. | [Intégrer des sous-ensembles de polices dans un document PDF](./embedded-subset-fonts/) Réduisez la taille de vos fichiers PDF en intégrant uniquement les sous-ensembles de polices nécessaires grâce à Aspose.Words pour .NET. Suivez notre guide étape par étape pour optimiser efficacement vos PDF. | -| [Réduire la taille du PDF en désactivant les polices intégrées](./disable-embed-windows-fonts/) Réduisez la taille de vos PDF en désactivant les polices intégrées avec Aspose.Words pour .NET. Suivez notre guide étape par étape pour optimiser vos documents et les stocker et les partager efficacement. -| [Optimisez la taille de votre PDF en ignorant les polices Arial et Times Roman intégrées](./skip-embedded-arial-and-times-roman-fonts/) Optimisez la taille de vos PDF en ignorant les polices Arial et Times Roman intégrées grâce à Aspose.Words pour .NET. Suivez ce guide étape par étape pour optimiser vos fichiers PDF. +| [Réduire la taille du PDF en désactivant les polices intégrées](./disable-embed-windows-fonts/) Réduisez la taille de vos PDF en désactivant les polices intégrées avec Aspose.Words pour .NET. Suivez notre guide étape par étape pour optimiser vos documents et les stocker et les partager efficacement. | +| [Optimisez la taille de votre PDF en ignorant les polices Arial et Times Roman intégrées](./skip-embedded-arial-and-times-roman-fonts/) Optimisez la taille de vos PDF en ignorant les polices Arial et Times Roman intégrées grâce à Aspose.Words pour .NET. Suivez ce guide étape par étape pour optimiser vos fichiers PDF. | | [Réduire la taille du fichier PDF en n'incorporant pas les polices principales](./avoid-embedding-core-fonts/) | Découvrez comment réduire la taille de vos fichiers PDF en n'incorporant pas les polices principales avec Aspose.Words pour .NET. Suivez notre guide étape par étape pour optimiser vos PDF. | | [Échapper à l'URI dans un document PDF](./escape-uri/) Apprenez à échapper les URI dans les PDF avec Aspose.Words pour .NET. Ce guide détaillé vous guide pas à pas. | | [Exporter les signets d'en-tête, de pied de page et de document Word vers un document PDF](./export-header-footer-bookmarks/) | Apprenez à exporter les signets d'en-tête et de pied de page d'un document Word vers PDF à l'aide d'Aspose.Words pour .NET avec notre guide étape par étape. | | [Réduire la taille du PDF en adaptant les polices WMF à la taille du métafichier](./scale-wmf-fonts-to-metafile-size/) | Guide étape par étape pour réduire la taille du PDF en mettant à l'échelle les polices WMF à la taille du métafichier lors de la conversion au format PDF avec Aspose.Words pour .NET. | | [Améliorez le positionnement du texte PDF grâce à un positionnement de texte supplémentaire](./additional-text-positioning/) | Apprenez à améliorer le positionnement du texte de vos PDF avec Aspose.Words pour .NET en quelques étapes simples. Améliorez l'apparence de votre document. | | [Convertir un document Word en PDF 1.7](./conversion-to-pdf-17/) | Convertissez facilement vos documents Word en PDF 1.7 grâce à Aspose.Words pour .NET. Suivez ce guide pour garantir l'accessibilité universelle et la mise en forme professionnelle de vos documents. | -| [Réduisez la taille des documents PDF grâce au sous-échantillonnage des images](./downsampling-images/) Réduisez la taille de vos documents PDF en sous-échantillonnant les images avec Aspose.Words pour .NET. Optimisez vos PDF pour des temps de téléchargement plus rapides. +| [Réduisez la taille des documents PDF grâce au sous-échantillonnage des images](./downsampling-images/) Réduisez la taille de vos documents PDF en sous-échantillonnant les images avec Aspose.Words pour .NET. Optimisez vos PDF pour des temps de téléchargement plus rapides. | | [Définir les options de plan dans un document PDF](./set-outline-options/) | Apprenez à définir les options de plan dans un document PDF avec Aspose.Words pour .NET. Améliorez la navigation PDF en configurant les niveaux de titre et les plans étendus. | | [Exporter les propriétés personnalisées dans un document PDF](./custom-properties-export/) | Apprenez à exporter des propriétés personnalisées dans un document PDF à l'aide d'Aspose.Words pour .NET avec notre guide détaillé étape par étape. | -| [Exporter la structure d'un document Word vers un document PDF](./export-document-structure/) Exportez la structure d'un document Word au format PDF avec Aspose.Words pour .NET. Suivez notre guide étape par étape pour préserver la mise en page du document et améliorer la navigation dans les PDF. +| [Exporter la structure d'un document Word vers un document PDF](./export-document-structure/) Exportez la structure d'un document Word au format PDF avec Aspose.Words pour .NET. Suivez notre guide étape par étape pour préserver la mise en page du document et améliorer la navigation dans les PDF. | | [Compression d'image dans un document PDF](./image-compression/) Apprenez à compresser des images dans des documents PDF avec Aspose.Words pour .NET. Suivez ce guide pour optimiser la taille et la qualité de vos fichiers. | | [Mettre à jour la dernière propriété imprimée dans le document PDF](./update-last-printed-property/) | Apprenez à mettre à jour la dernière propriété imprimée dans un document PDF à l'aide d'Aspose.Words pour .NET avec notre guide étape par étape. | | [Rendu 3D DML 3DEffects dans un document PDF](./dml-3deffects-rendering/) | Apprenez à restituer de superbes effets DML 3D dans des documents PDF à l'aide d'Aspose.Words pour .NET avec ce guide complet étape par étape. | | [Interpoler des images dans un document PDF](./interpolate-images/) | Découvrez comment interpoler des images dans un document PDF avec Aspose.Words pour .NET grâce à notre guide étape par étape. Améliorez facilement la qualité d'image de votre PDF. | - +| [Comment enregistrer un PDF à partir d'un DOCX avec Aspose.Words – Guide étape par étape](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Apprenez à convertir un fichier DOCX en PDF avec Aspose.Words en suivant ce guide détaillé étape par étape. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/french/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/french/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..e0be7b9fdb --- /dev/null +++ b/words/french/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-03-27 +description: Apprenez à enregistrer un PDF à partir d'un fichier DOCX en utilisant + Aspose.Words. Comprend la conversion de DOCX en PDF, l'enregistrement du PDF avec + des options et la gestion des formes flottantes. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: fr +og_description: Comment enregistrer un PDF à partir d’un fichier DOCX avec Aspose.Words. + Ce guide montre comment convertir un DOCX en PDF, enregistrer le PDF avec des options + et gérer les formes flottantes. +og_title: Comment enregistrer un PDF depuis un DOCX – Tutoriel complet Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Comment enregistrer un PDF à partir d’un DOCX avec Aspose.Words – Guide étape + par étape +url: /fr/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment enregistrer un PDF à partir d'un DOCX avec Aspose.Words – Tutoriel complet + +Vous vous êtes déjà demandé **comment enregistrer un PDF** à partir d'un document Word sans perdre la mise en page des formes flottantes ? Vous n'êtes pas seul. Dans de nombreux projets—générateurs de factures, exportateurs de rapports ou simples archivistes de documents—les développeurs ont besoin d’une méthode fiable pour convertir DOCX en PDF tout en conservant exactement l’apparence dans Word. + +Dans ce tutoriel, nous parcourrons la conversion d’un fichier DOCX en PDF **en utilisant Aspose.Words pour .NET**, vous montrerons **comment convertir docx en pdf** avec des options d’enregistrement personnalisées, et expliquerons pourquoi le drapeau `ExportFloatingShapesAsInlineTag` est important. À la fin, vous disposerez d’un extrait prêt à l’emploi qui enregistre le PDF avec les options que vous contrôlez. + +## Ce que vous allez apprendre + +- Les étapes exactes pour **convertir word document pdf** avec Aspose.Words. +- Comment configurer `PdfSaveOptions` pour traiter les formes flottantes comme des balises en ligne. +- Les pièges courants liés aux objets flottants et comment les éviter. +- Un programme C# complet et exécutable que vous pouvez intégrer à n’importe quel projet .NET. + +> **Prérequis :** Vous avez besoin d’une licence Aspose.Words pour .NET (ou d’une évaluation gratuite) et d’un environnement de développement .NET (Visual Studio, Rider ou le CLI `dotnet`). + +## Étape 1 : Configurer le projet et ajouter Aspose.Words + +Tout d’abord, créez une nouvelle application console (ou ajoutez‑la à une existante) et référencez le package NuGet Aspose.Words. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Astuce :** Si vous êtes sur un serveur CI, épinglez la version du package (`Aspose.Words --version 24.10`) pour garantir des builds reproductibles. + +## Étape 2 : Charger le DOCX contenant des formes flottantes + +Les images flottantes, les zones de texte ou les SmartArt peuvent provoquer des décalages de mise en page lors de la conversion. Charger le document est simple, mais nous vérifierons également que le fichier existe afin d’éviter une `FileNotFoundException` à l’exécution. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Remarquez les instructions `Console.WriteLine` — elles vous donnent un retour rapide lorsque vous exécutez l’application depuis un terminal. + +## Étape 3 : Configurer les options d’enregistrement PDF (Save PDF with Options) + +C’est ici que la magie opère. Par défaut, Aspose.Words tente de préserver les objets flottants tels qu’ils apparaissent, ce qui peut casser la mise en page du PDF résultant. Définir `ExportFloatingShapesAsInlineTag` à `true` indique à la bibliothèque de traiter ces formes comme des balises en ligne, garantissant qu’elles restent ancrées au texte environnant. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Pourquoi cela importe‑t‑il ? Imaginez une zone de texte qui surplombe un paragraphe. Sans la conversion en balise en ligne, le PDF pourrait pousser le paragraphe vers le bas ou couper complètement la zone. Le drapeau maintient la relation visuelle intacte — un détail subtil mais crucial pour des rapports professionnels. + +## Étape 4 : Enregistrer le document au format PDF + +Nous écrivons maintenant le fichier PDF. La méthode `Save` reçoit à la fois le chemin de sortie et les options que nous venons de définir. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +L’exécution du programme produira `output.pdf` dans le même dossier que votre DOCX source. Ouvrez‑le avec n’importe quel lecteur PDF et vous verrez que toutes les formes flottantes sont rendues exactement à l’endroit où elles doivent être. + +## Exemple complet fonctionnel + +Voici le programme complet en un seul bloc. Copiez‑collez‑le dans `Program.cs` (ou tout fichier C#) et appuyez sur **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Résultat attendu + +- **Fichier créé :** `output.pdf` dans le répertoire cible. +- **Fidélité de la mise en page :** Les formes flottantes (images, zones de texte, SmartArt) apparaissent en ligne avec le texte environnant. +- **Aucune exception :** Le programme se termine proprement, affichant des messages d’état dans la console. + +## Questions fréquentes & cas particuliers + +| Question | Réponse | +|----------|---------| +| **Et si j’ai besoin d’une qualité d’image supérieure ?** | Définissez `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Puis‑je convertir plusieurs fichiers DOCX en lot ?** | Enveloppez la logique de chargement/enregistrement dans une boucle `foreach (var file in Directory.GetFiles(..., "*.docx"))`. Pensez à réutiliser une même instance de `PdfSaveOptions` pour les performances. | +| **Cela fonctionne‑t‑il avec .NET Core ?** | Absolument. Aspose.Words 24.x prend en charge .NET Standard 2.0+, vous pouvez donc exécuter le même code sous Windows, Linux ou macOS. | +| **Comment gérer les fichiers DOCX protégés par mot de passe ?** | Chargez avec `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. Les mêmes `PdfSaveOptions` s’appliquent lors de l’enregistrement. | +| **La conversion en balise en ligne est‑elle sûre pour les tableaux complexes ?** | En général oui, mais les mises en page de tableau très complexes avec des formes qui se chevauchent peuvent encore nécessiter des ajustements manuels. Testez un échantillon représentatif avant une migration massive. | + +## Conseils pour les projets réels + +- **Loguez, ne vous contentez pas de `Console.WriteLine`** – En production, remplacez la sortie console par un framework de journalisation (Serilog, NLog) pour capturer les erreurs. +- **Libérez les ressources** – `Document` implémente `IDisposable`. Enveloppez‑le dans un bloc `using` si vous traitez de nombreux fichiers afin de libérer la mémoire rapidement. +- **Validez le PDF** – Utilisez un validateur PDF (par ex. vérificateur de conformité PDF/A) si vous avez besoin de PDF d’archivage de niveau professionnel. +- **Traitement parallèle** – Pour des charges de travail massives, envisagez `Parallel.ForEach` avec des instances de `PdfSaveOptions` thread‑safe (clonées par thread) afin d’accélérer la conversion. + +## Conclusion + +Nous avons couvert **comment enregistrer un PDF** à partir d’un fichier DOCX avec Aspose.Words, démontré **comment convertir docx en pdf** avec des options personnalisées, et expliqué l’impact de `ExportFloatingShapesAsInlineTag`. L’exemple complet et exécutable montre que vous pouvez **convertir word document pdf** en quelques lignes seulement, et vous savez maintenant comment **enregistrer pdf avec des options** adaptées aux exigences de qualité et de conformité de votre projet. + +Prêt pour le prochain défi ? Essayez d’exporter vers d’autres formats (par ex. HTML, EPUB) avec `document.Save("output.html")`, ou expérimentez la conformité PDF/A pour l’archivage à long terme. Les mêmes principes—charger, configurer les options, enregistrer—s’appliquent partout. + +Bon codage, et que vos PDFs ressemblent toujours exactement à ce que vous avez prévu ! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/net/programming-with-shapes/_index.md b/words/french/net/programming-with-shapes/_index.md index 89930944b7..c55dfedf07 100644 --- a/words/french/net/programming-with-shapes/_index.md +++ b/words/french/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ En utilisant Aspose.Words pour .NET et en suivant ces tutoriels, vous maîtriser | [Détecter la forme d'une œuvre d'art intelligente](./detect-smart-art-shape/) | Découvrez comment détecter les formes SmartArt dans vos documents Word avec Aspose.Words pour .NET grâce à ce guide complet. Idéal pour automatiser votre flux de travail documentaire. | | [Mettre à jour Smart Art Drawing](./update-smart-art-drawing/) | Apprenez à mettre à jour vos dessins Smart Art dans des documents Word avec Aspose.Words pour .NET grâce à ce guide étape par étape. Assurez-vous que vos visuels sont toujours précis. | | [Créer une forme rectangulaire dans Word avec Aspose.Words – Guide étape par étape](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Apprenez à créer une forme rectangulaire dans un document Word avec Aspose.Words grâce à ce guide détaillé étape par étape. | +| [Créer un document Word C# – Ajouter une forme avec ombre](./create-word-document-c-add-shape-with-shadow/) | Apprenez à ajouter une forme avec ombre à un document Word en C# à l'aide d'Aspose.Words pour .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/french/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/french/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..60b13f8f55 --- /dev/null +++ b/words/french/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,204 @@ +--- +category: general +date: 2026-03-27 +description: Créer un document Word en C# et apprendre comment ajouter une forme, + appliquer une ombre à la forme et définir la distance de l'ombre. Guide étape par + étape pour Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: fr +og_description: Créez un document Word en C# avec une forme rectangle et une ombre + personnalisée. Suivez ce tutoriel complet pour définir la distance et le style de + l'ombre. +og_title: Créer un document Word C# – Ajouter une forme avec ombre +tags: +- Aspose.Words +- C# +- Document Automation +title: Créer un document Word en C# – Ajouter une forme avec ombre +url: /fr/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Créer un document Word C# – Ajouter une forme avec ombre + +Vous avez déjà eu besoin de **create word document c#** qui contient un rectangle joliment stylisé ? Peut‑être que vous créez un modèle de rapport et souhaitez une ombre portée subtile pour faire ressortir la mise en page. Dans ce tutoriel, nous allons passer en revue exactement cela – comment ajouter une forme, appliquer une ombre à la forme, et même ajuster la distance de l’ombre en utilisant Aspose.Words. + +Nous commencerons avec un document vierge, insérerons un rectangle, lui appliquerons une ombre prédéfinie, puis enregistrerons le fichier. À la fin, vous disposerez d’un .docx prêt à l’emploi que vous pourrez ouvrir dans Word et voir l’effet immédiatement. Aucun outil externe, juste du code C# pur. + +## Prérequis + +- .NET 6 (ou tout framework .NET récent) installé. +- Visual Studio 2022 ou VS Code avec l’extension C#. +- Package NuGet Aspose.Words pour .NET (`Aspose.Words` version 23.12 ou ultérieure). + Vous pouvez l’ajouter via la console du gestionnaire de packages : + + ```powershell + Install-Package Aspose.Words + ``` + +C’est tout – aucune DLL supplémentaire ou interop COM requise. + +## Étape 1 : Initialiser un nouveau document et un builder – *create word document c#* bases + +Tout d’abord, nous avons besoin d’un objet `Document` qui représente le fichier Word et d’un `DocumentBuilder` pour le modifier. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Pourquoi cette étape est importante :** La classe `Document` est le conteneur de toutes les parties du document Word (pages, styles, images). Le builder est l’API de haut niveau qui abstrait la manipulation des nœuds de bas niveau, facilitant la **create word document c#** sans avoir à gérer le XML directement. + +## Étape 2 : Insérer une forme rectangle – *how to create rectangle* + +Nous allons maintenant placer un rectangle sur la page. La taille est exprimée en points (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Astuce :** Si vous avez besoin d’une forme différente, remplacez simplement `ShapeType.Rectangle` par `ShapeType.Ellipse`, `ShapeType.Triangle`, etc. Le même code fonctionne pour **how to add shape** de n’importe quel type. + +## Étape 3 : Appliquer une ombre prédéfinie et l’ajuster – *apply shadow to shape* + +Aspose.Words propose plusieurs formats d’ombre prédéfinis. Nous utiliserons `Preset1` puis personnaliserons la distance, le flou, la transparence et la couleur. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Pourquoi personnaliser l’ombre ?** La propriété `Distance` contrôle la distance entre l’ombre et le rectangle – pensez‑y comme au « relief » que l’on voit dans un rendu 3D. Modifier `BlurRadius` adoucit les bords, tandis que `Transparency` vous permet de créer un aspect subtil et professionnel. Cela répond à l’exigence **set shadow distance** et vous montre comment **apply shadow to shape** de manière flexible. + +## Étape 4 : Enregistrer le document – *create word document c#* finalisation + +Enfin, écrivez le document sur le disque. Ajustez le chemin vers un dossier où vous avez les droits d’écriture. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Ouvrez le fichier résultant dans Microsoft Word, et vous verrez un rectangle bleu clair avec une ombre grisâtre douce décalée de 5 pt. C’est la preuve visuelle que vous avez réussi à **create word document c#** avec une forme stylisée. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="exemple de create word document c# montrant un rectangle avec ombre"} + +## Variations optionnelles & cas limites + +| Scénario | Ce qu’il faut changer | Pourquoi c’est important | +|----------|-----------------------|---------------------------| +| **Style d’ombre différent** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Vous donne un rendu plus dramatique sans code supplémentaire. | +| **Pas de preset – ombre personnalisée** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Contrôle total sur la direction et la profondeur. | +| **Formes multiples** | Call `builder.InsertShape` again before saving. | Utile pour des modèles complexes avec icônes, logos, etc. | +| **Compatibilité avec les versions plus anciennes d’Aspose** | Use `ShadowEffect` class (available in v20.x). | Assure que votre code fonctionne sur des projets hérités. | +| **Enregistrement en PDF** | `document.Save("ShadowShape.pdf");` | Le même rendu d’ombre apparaît dans la sortie PDF. | + +> **Question fréquente :** *Et si l’ombre n’apparaît pas dans Word ?* +> Assurez‑vous d’utiliser une version récente d’Aspose.Words (≥ 22.9). Les versions antérieures avaient un support d’ombre limité. Vérifiez également que le document est ouvert avec une version récente de Word (2016+). + +## Exemple complet fonctionnel + +Voici le programme complet, prêt à copier‑coller. Il inclut toutes les directives `using`, les commentaires et la gestion des erreurs pour une expérience fluide. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Exécutez le programme, accédez à `C:\Temp\ShadowShape.docx`, et vous verrez le rectangle avec l’ombre exacte que nous avons configurée. + +## Récapitulatif & prochaines étapes + +- Vous savez maintenant comment **create word document c#**, insérer un rectangle, et **apply shadow to shape** avec une **set shadow distance** personnalisée. +- L’exemple utilise Aspose.Words, qui abstrait les complexités d’OpenXML et garantit un rendu cohérent sur toutes les versions de Word. +- Vous voulez aller plus loin ? Essayez de combiner plusieurs formes, d’ajouter du texte à l’intérieur du rectangle, ou d’exporter le même document en PDF pour voir comment l’ombre se traduit. + +### Sujets connexes que vous pourriez explorer + +- **How to add shape** à un en‑tête/pied de page pour le branding. +- Utiliser **Aspose.Words** pour insérer des graphiques et des tableaux programmatique. +- Personnaliser les **shadow effects** sur des images au lieu de formes vectorielles. +- Automatiser la génération massive de documents pour factures ou certificats. + +N’hésitez pas à expérimenter, casser le code, puis le reconstruire – c’est la façon la plus rapide d’assimiler les concepts. Si vous rencontrez un problème, laissez un commentaire ci‑dessous ou consultez la documentation officielle d’Aspose.Words pour des informations API plus approfondies. + +Bon codage, et profitez de rendre vos fichiers Word un peu plus soignés ! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/net/programming-with-txtsaveoptions/_index.md b/words/french/net/programming-with-txtsaveoptions/_index.md index d904155850..fc3e964451 100644 --- a/words/french/net/programming-with-txtsaveoptions/_index.md +++ b/words/french/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Grâce à ces tutoriels, vous pourrez exploiter pleinement les fonctionnalités | [Ajouter des marques Bidi dans un document Word](./add-bidi-marks/) | Découvrez comment ajouter des marques bidirectionnelles (Bidi) dans vos documents Word avec Aspose.Words pour .NET grâce à ce guide. Assurez un sens de texte correct pour les contenus multilingues. | | [Utiliser le caractère de tabulation par niveau pour l'indentation de la liste](./use-tab-character-per-level-for-list-indentation/) | Apprenez à créer des listes à plusieurs niveaux avec indentation tabulée avec Aspose.Words pour .NET. Suivez ce guide pour une mise en forme précise des listes dans vos documents. | | [Utiliser un caractère d'espace par niveau pour l'indentation de la liste](./use-space-character-per-level-for-list-indentation/) | Apprenez à créer des listes à plusieurs niveaux avec indentation par espace dans Aspose.Words pour .NET. Guide étape par étape pour une mise en forme précise des documents. | - +| [Enregistrer docx en txt – Guide complet pour exporter les équations Word vers LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Apprenez à convertir des documents DOCX en fichiers TXT tout en exportant les équations Word au format LaTeX avec Aspose.Words pour .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/french/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/french/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..8f234887f4 --- /dev/null +++ b/words/french/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-03-27 +description: Enregistrez le docx en txt avec Aspose.Words et convertissez Word en + LaTeX. Découvrez comment exporter les équations, conserver le texte brut et obtenir + le balisage LaTeX en quelques minutes. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: fr +og_description: Enregistrez le docx en txt avec Aspose.Words. Ce guide montre comment + convertir Word en LaTeX, exporter les équations et conserver votre document en texte + brut. +og_title: Enregistrer le docx en txt – Exporter les équations Word vers LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Enregistrer le docx au format txt – Guide complet pour exporter les équations + Word vers LaTeX +url: /fr/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Enregistrer docx en txt – Exporter les équations Word vers LaTeX + +Vous avez déjà eu besoin de **sauvegarder un docx en txt** mais vous craigniez de perdre les belles formules qui se trouvent dans votre fichier Word ? Vous n'êtes pas seul. Dans de nombreux flux de travail scientifiques, la version texte brut d’un document est indispensable, tout en souhaitant que les équations restent sous forme de balisage LaTeX propre. + +Dans ce tutoriel, nous passerons en revue les étapes exactes pour **convertir Word en LaTeX** à l’aide d’Aspose.Words pour .NET, afin que vos équations soient exportées correctement tandis que le reste du document devient du texte brut bien ordonné. À la fin, vous saurez comment **exporter les équations vers LaTeX**, garder le reste du fichier en texte simple, et éviter les pièges habituels qui bloquent les débutants. + +## Ce que vous apprendrez + +- Comment charger un fichier *.docx* contenant des Office Math. +- Configurer correctement les `TxtSaveOptions` pour que Aspose génère du LaTeX pour chaque équation. +- Enregistrer le résultat sous forme de fichier **save word plain text** que vous pouvez intégrer à un contrôle de version, des pipelines CI, ou tout autre outil en aval. +- Cas limites courants — que faire lorsqu’un document mélange images et équations, ou lorsque vous devez préserver des caractères Unicode. +- Un exemple de code complet, prêt à être exécuté, que vous pouvez coller dans une application console. + +### Prérequis + +- .NET 6.0 ou supérieur (le code fonctionne également avec .NET Framework 4.7+). +- Une copie sous licence de **Aspose.Words for .NET** (l’essai gratuit suffit pour les tests). +- Visual Studio 2022 ou tout IDE capable de compiler des projets C#. +- Un document Word (`input.docx`) contenant déjà des objets Office Math. + +> **Astuce :** Si vous n’avez pas encore de licence, vous pouvez demander une clé temporaire sur le site d’Aspose — remplacez simplement le texte de remplacement dans le code par votre clé avant d’exécuter. + +## Étape 1 – Installer Aspose.Words via NuGet + +Première chose à faire : ajouter la bibliothèque à votre projet. Ouvrez la **Console du Gestionnaire de Packages** et exécutez : + +```powershell +Install-Package Aspose.Words +``` + +Cette unique ligne récupère tout ce dont vous avez besoin, y compris l’espace de noms `Saving` où se trouve `TxtSaveOptions`. Aucun DLL supplémentaire, aucune dépendance native — juste du code managé pur. + +## Étape 2 – Charger le document Word source + +Nous lisons maintenant le fichier qui contient les équations. La classe `Document` abstrait toute la structure *.docx*, vous permettant de la manipuler comme un modèle d’objet de haut niveau. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Pourquoi c’est important :** Charger le document dès le départ vous permet d’inspecter son arbre de nœuds. Si vous sautez cette vérification et que le fichier ne contient aucune équation, vous obtiendrez quand même un fichier txt propre—mais vous ne comprendrez pas pourquoi la sortie LaTeX est vide. + +## Étape 3 – Configurer TxtSaveOptions pour l’export LaTeX + +Aspose vous offre un contrôle fin sur la façon dont les Office Math sont rendus. En définissant `OfficeMathExportMode` sur `LaTeX`, chaque équation est transformée en son équivalent LaTeX au lieu d’être supprimée ou convertie en image. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Pourquoi c’est important :** Le mode d’exportation par défaut supprimerait complètement les équations. Passer à `LaTeX` conserve l’intention mathématique, exactement ce dont vous avez besoin lorsque vous alimentez ensuite le fichier dans un compilateur LaTeX ou un processeur markdown qui comprend la syntaxe `$…$`. + +## Étape 4 – Enregistrer le document en texte brut + +Avec les options configurées, la persistance du fichier ne tient qu’à une ligne. La sortie sera un fichier `.txt` où chaque équation apparaît sous forme de code LaTeX entouré de délimiteurs `$` (vous pourrez changer cela plus tard si vous préférez les blocs `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Résultat attendu + +Ouvrez `output.txt` dans n’importe quel éditeur et vous verrez quelque chose comme : + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Remarquez que le texte ordinaire reste exactement tel qu’il était, tandis que les équations sont maintenant de simples chaînes LaTeX. Vous pouvez copier‑coller ces chaînes directement dans un document LaTeX, un notebook Jupyter, ou tout outil qui rend les mathématiques. + +## Étape 5 – Gestion des cas limites + +### Contenu mixte (Images + Équations) + +Si votre fichier Word contient également des images, Aspose les ignorera lorsque vous utilisez `TxtSaveOptions`. C’est généralement acceptable pour un flux **save word plain text**, mais si vous avez besoin des images comme espaces réservés, vous pouvez : + +1. Exporter le document en HTML d’abord (`HtmlSaveOptions`) pour capturer les images sous forme de balises ``. +2. Effectuer une seconde passe avec `TxtSaveOptions` afin d’obtenir les équations LaTeX. +3. Fusionner les deux résultats manuellement ou avec un petit script. + +### Symboles Unicode + +Certaines équations utilisent des caractères Unicode spéciaux (par ex., des lettres grecques). Définir `Encoding = Encoding.UTF8` dans `TxtSaveOptions` (comme montré à l’Étape 3) garantit que ces symboles survivent à la conversion. + +### Documents volumineux + +Pour des fichiers très lourds (> 100 Mo), envisagez de diffuser l’opération d’enregistrement : + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Le streaming évite de charger toute la sortie en mémoire, ce qui peut sauver la mise en place sur des agents de construction à faible mémoire. + +## Exemple complet fonctionnel + +Voici le programme complet, prêt à copier‑coller, qui assemble toutes les étapes. Remplacez simplement les chemins de fichiers et, le cas échéant, la ligne de licence. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Exécutez le programme (`dotnet run` si vous utilisez un projet console) et vérifiez `output.txt`. Vous avez ainsi **enregistré un docx en txt** tout en préservant chaque équation sous forme de LaTeX—sans aucune copie manuelle. + +## Foire aux questions + +**Q : Puis‑je changer le délimiteur `$…$` en `\(...\)` ?** +R : Oui. Après l’enregistrement, effectuez un simple remplacement dans le fichier : `output = output.Replace("$", @"\(").Replace("$", @"\)");`—faites juste attention à ne pas remplacer les caractères `$` qui appartiennent déjà au texte original. + +**Q : Cette méthode fonctionne‑t‑elle avec les fichiers Word 2007‑2019 ?** +R : Absolument. Aspose.Words prend en charge `.doc`, `.docx`, `.docm` et même la famille plus récente `.dotx`. Le même code fonctionne sur toutes les versions. + +**Q : Et si je dois conserver la mise en forme originale des paragraphes (tabulations, espaces multiples) ?** +R : Définissez `txtSaveOptions.PreserveTableLayout = true;` et `txtSaveOptions.PreserveSpace = true;` pour garder les espaces blancs intacts. + +## Conclusion + +Nous avons couvert tout ce qu’il faut pour **enregistrer un docx en txt** tout en **exportant les équations vers LaTeX** avec Aspose.Words. Les étapes clés sont : charger le document, configurer `TxtSaveOptions` avec `OfficeMathExportMode.LaTeX`, puis enregistrer le résultat. Avec ces trois lignes de code, vous pouvez convertir de façon fiable **word to latex**, garder votre document en **save word plain text**, et éviter la perte redoutée des symboles mathématiques. + +Prêt pour le prochain défi ? Essayez d’enchaîner ce flux avec un générateur markdown pour produire un fichier `.md` complet incluant texte et LaTeX—parfait pour une documentation versionnée sur Git ou des générateurs de sites statiques. Vous pouvez également explorer les `PdfSaveOptions` d’Aspose pour obtenir une version PDF en parallèle du fichier texte brut. + +Si vous rencontrez le moindre problème, laissez un commentaire ci‑dessous. Bon codage, et profitez de la simplicité de transformer les équations Word en LaTeX propre ! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/net/working-with-fonts/_index.md b/words/french/net/working-with-fonts/_index.md index 84a3f00a8a..5fc6947a8c 100644 --- a/words/french/net/working-with-fonts/_index.md +++ b/words/french/net/working-with-fonts/_index.md @@ -40,15 +40,15 @@ Que vous souhaitiez formater du texte avec différentes polices, définir des r | [Définir les dossiers de polices avec priorité](./set-fonts-folders-with-priority/) | Apprenez à définir des dossiers de polices prioritaires dans vos documents Word avec Aspose.Words pour .NET. Notre guide garantit un rendu parfait de vos documents à chaque fois. | | [Définir le dossier des polices True Type](./set-true-type-fonts-folder/) | Apprenez à définir un dossier de polices True Type dans vos documents Word avec Aspose.Words pour .NET. Suivez notre guide détaillé étape par étape pour une gestion cohérente des polices. | | [Spécifier la police par défaut lors du rendu](./specify-default-font-when-rendering/) | Apprenez à spécifier une police par défaut lors du rendu de documents Word avec Aspose.Words pour .NET. Assurez une apparence cohérente des documents sur toutes les plateformes. | -| [Paramètres de police avec options de chargement](./font-settings-with-load-options/) Apprenez à gérer les paramètres de police avec les options de chargement dans Aspose.Words pour .NET. Guide étape par étape pour les développeurs afin de garantir une apparence cohérente des polices dans les documents Word. +| [Paramètres de police avec options de chargement](./font-settings-with-load-options/) Apprenez à gérer les paramètres de police avec les options de chargement dans Aspose.Words pour .NET. Guide étape par étape pour les développeurs afin de garantir une apparence cohérente des polices dans les documents Word. | | [Définir le dossier des polices](./set-fonts-folder/) | Apprenez à définir un dossier de polices personnalisé dans Aspose.Words pour .NET pour garantir que vos documents Word sont rendus correctement sans polices manquantes. | | [Paramètres de police Instance par défaut](./font-settings-default-instance/) | Dans ce didacticiel, découvrez comment configurer les paramètres de police par défaut dans un document Word avec Aspose.Words pour .NET. | -| [Obtenir la liste des polices disponibles](./get-list-of-available-fonts/) Découvrez comment obtenir la liste des polices disponibles avec Aspose.Words pour .NET grâce à ce tutoriel détaillé, étape par étape. Améliorez vos compétences en gestion des polices. +| [Obtenir la liste des polices disponibles](./get-list-of-available-fonts/) Découvrez comment obtenir la liste des polices disponibles avec Aspose.Words pour .NET grâce à ce tutoriel détaillé, étape par étape. Améliorez vos compétences en gestion des polices. | | [Recevoir des notifications de polices](./receive-notifications-of-fonts/) | Découvrez comment recevoir des notifications de polices manquantes ou remplacées lors de l'utilisation d'Aspose.Words pour .NET. | | [Recevoir une notification d'avertissement](./receive-warning-notification/) Apprenez à recevoir une notification d'avertissement lors de l'utilisation d'Aspose.Words pour .NET et à gérer les problèmes ou les avertissements dans vos documents. | | [Exemple de source de police Steam](./resource-steam-font-source-example/) | Apprenez à utiliser la source de polices Resource Stream pour charger des polices personnalisées dans Aspose.Words pour .NET. | | [Obtenir une substitution sans suffixes](./get-substitution-without-suffixes/) | Dans ce didacticiel, découvrez comment obtenir des remplacements sans suffixe dans un document Word avec Aspose.Words pour .NET. | - +| [Substitution de police Aspose – Comment configurer les paramètres de police en C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Apprenez à configurer les paramètres de police avec Aspose.Words pour .NET en C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/french/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/french/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..880f186cd7 --- /dev/null +++ b/words/french/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,239 @@ +--- +category: general +date: 2026-03-27 +description: 'Substitution de polices Aspose simplifiée : apprenez à configurer les + paramètres de police, à capturer les avertissements et à gérer les polices manquantes + dans vos applications .NET.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: fr +og_description: Maîtrisez la substitution de polices Aspose en configurant les paramètres + de police et en gérant les polices manquantes avec un rappel d’avertissement. Guide + complet C#. +og_title: Substitution de polices Aspose – Configurer les paramètres de police en + C# +tags: +- Aspose.Words +- C# +- Font Management +title: Substitution de polices Aspose – Comment configurer les paramètres de police + en C# +url: /fr/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Guide complet pour configurer les paramètres de police + +Vous êtes déjà tombé sur un document qui remplace soudainement votre police personnalisée par quelque chose de générique ? C’est **aspose font substitution** qui fait son travail — en remplaçant les polices manquantes par la correspondance la plus proche qu’il peut trouver. C’est pratique, mais si vous devez savoir *exactement* quelle police a été remplacée, vous devez exploiter le système d’avertissement de la bibliothèque et configurer vous‑même les paramètres de police. + +Dans ce tutoriel, nous parcourrons un scénario réel : charger un DOCX qui référence une police que vous n’avez pas, capturer l’événement de substitution et afficher un message convivial dans la console. À la fin, vous serez à l’aise avec **configure font settings**, la mise en place d’un **Aspose.Words warning callback**, et l’extension de l’exemple pour s’adapter à n’importe quel flux de travail. + +> **Ce dont vous aurez besoin** +> • .NET 6+ (or .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • Un DOCX qui référence une police manquante (nous l’appellerons `MissingFont.docx`) + +Plongeons‑y. + +--- + +## Étape 1 : Installer Aspose.Words et préparer le projet + +Avant d’écrire du code, assurez‑vous que le package Aspose.Words est référencé : + +```bash +dotnet add package Aspose.Words +``` + +> **Conseil pro :** utilisez la dernière version stable ; en mars 2026, il s’agit de la 23.11.0. Les versions plus récentes améliorent les algorithmes de correspondance des polices et ajoutent des types d’avertissement supplémentaires. + +Créez une nouvelle application console (ou ajoutez le code dans un projet existant) et ajoutez les directives `using` habituelles : + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Ces espaces de noms nous donnent accès aux classes `Document`, `LoadOptions` et aux classes liées aux polices dont nous aurons besoin. + +## Étape 2 : Configurer les paramètres de police avec LoadOptions + +Le cœur du contrôle de **aspose font substitution** se trouve dans `LoadOptions.FontSettings`. En fournissant un objet `FontSettings` vide, nous indiquons à Aspose d’utiliser ses chemins de recherche par défaut *et* de signaler toute substitution via un rappel d’avertissement. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Pourquoi ne pas simplement se fier aux valeurs par défaut ? Parce que l’attachement d’un rappel d’avertissement (étape suivante) ne fonctionne que lorsque la propriété `FontSettings` n’est pas nulle. Cette petite ligne nous fournit un point d’ancrage dans le processus de substitution sans modifier le comportement réel de recherche des polices. + +## Étape 3 : Attacher un rappel d’avertissement pour capturer les substitutions + +Aspose.Words implémente l’interface `IWarningCallback`. Chaque fois qu’un événement notable se produit — comme une police manquante — il appelle notre méthode `Warning`. Nous implémenterons un petit gestionnaire qui filtre les `WarningType.FontSubstitution` et affiche la description. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +Et voici le gestionnaire lui‑même : + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Pourquoi c’est important** – Sans le rappel, Aspose remplace silencieusement les polices, et vous ne savez jamais laquelle a été utilisée. Le rappel rend le processus transparent, ce qui est essentiel pour les rapports de conformité ou le débogage des problèmes de mise en page. + +## Étape 4 : Charger le document en utilisant les options configurées + +Nous chargeons enfin le document, en passant le `loadOptions` que nous venons de préparer. Si le fichier source référence une police qui n’est pas installée, notre gestionnaire sera déclenché. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Remplacez `YOUR_DIRECTORY` par le chemin réel où se trouve `MissingFont.docx`. Lorsque vous exécutez le programme, vous devriez voir une sortie similaire à : + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Cette ligne indique exactement quelle police était manquante et quel substitut Aspose a choisi. + +## Étape 5 : (Optionnel) Affiner les chemins de recherche des polices + +Si vous avez un dossier privé contenant des polices d’entreprise, vous pouvez indiquer à Aspose où chercher avant qu’il ne se rabattre sur les polices système. C’est une utilisation avancée de **configure font settings** : + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Définir `recursive: true` fait qu’Aspose parcourt également les sous‑dossiers. La bibliothèque essaiera d’abord vos polices privées, réduisant ainsi le risque de substitution indésirable. + +## Exemple complet fonctionnel + +En rassemblant tous les éléments, voici le programme complet, prêt à être exécuté : + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Sortie attendue** (lorsqu’une police manquante est rencontrée) : + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Si toutes les polices sont présentes, le programme s’exécute silencieusement (aucun avertissement) et produit toujours le PDF. + +## Questions fréquentes & cas particuliers + +### Que faire si je dois *empêcher* toute substitution ? + +Définissez `FontSettings.SubstitutionSettings` à `null` ou utilisez `FontSettings.FontSubstitutionSettings` pour contrôler le comportement. Par exemple : + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Aspose lèvera maintenant une exception au lieu de substituer silencieusement, ce qui peut être intercepté et géré. + +### Cela fonctionne‑t‑il avec d’autres formats de fichier (par ex., .doc, .rtf) ? + +Absolument. Le même objet `LoadOptions` peut être passé à n’importe quel constructeur `Document` qui accepte un chemin de fichier. Le rappel d’avertissement sera déclenché pour tous les formats qui utilisent des polices. + +### Puis‑je capturer le nom exact de la police de substitution ? + +Oui. La chaîne `info.Description` contient à la fois la police manquante et le substitut. Si vous avez besoin du nom programmatiquement, vous pouvez l’analyser ou utiliser l’objet `FontInfo` (disponible dans les versions récentes). + +### Comment cela se comporte‑t‑il dans un environnement multithread ? + +`FontSettings` n’est **pas** thread‑safe. Créez un `LoadOptions` distinct (avec son propre `FontSettings`) par thread, ou protégez l’accès avec un verrou. + +## Conclusion + +Nous avons couvert tout ce dont vous avez besoin pour maîtriser **aspose font substitution** et **configure font settings** dans une application C# : + +1. Installez Aspose.Words et ajoutez les directives `using` nécessaires. +2. Créez un objet `LoadOptions` avec un nouveau `FontSettings`. +3. Attachez un `IWarningCallback` personnalisé pour exposer les événements de substitution. +4. Chargez le document, en laissant le rappel signaler toute police manquante. +5. (Optionnel) Étendez le chemin de recherche ou désactivez complètement la substitution. + +Grâce à ce modèle, vous pouvez consigner les polices manquantes pour la conformité, alerter les utilisateurs dans une interface, ou intégrer automatiquement des polices de secours avant la publication. Ensuite, vous pourriez explorer les **politiques de substitution de police Aspose.Words** ou intégrer le flux de travail dans une chaîne de traitement de documents plus vaste. + +Bon codage, et que vos documents s’affichent toujours avec la bonne police ! + +--- + +![Diagramme montrant Aspose.Words chargeant un document, invoquant FontSettings, déclenchant un rappel d’avertissement et affichant les informations de substitution](image-placeholder.png "flux de travail de substitution de police aspose") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/german/net/basic-conversions/_index.md b/words/german/net/basic-conversions/_index.md index de0998541a..e80f3ebbf5 100644 --- a/words/german/net/basic-conversions/_index.md +++ b/words/german/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ | [PDF im Word-Format (Docx) speichern](./pdf-to-docx/) | Erfahren Sie in dieser detaillierten Schritt-für-Schritt-Anleitung, wie Sie mit Aspose.Words für .NET ein PDF in ein Word-Dokument (Docx) konvertieren. Perfekt für Entwickler. | | [Wie man LaTeX aus Word exportiert – Schritt‑für‑Schritt‑Anleitung](./how-to-export-latex-from-word-step-by-step-guide/) | Erfahren Sie, wie Sie mit Aspose.Words für .NET LaTeX aus Word-Dokumenten exportieren – detaillierte Anleitung mit Codebeispielen. | | [Word als PDF speichern mit Aspose.Words – Vollständige C#‑Anleitung](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Erfahren Sie, wie Sie Word-Dokumente mit Aspose.Words in C# einfach als PDF speichern – Schritt‑für‑Schritt‑Anleitung. | +| [Word in PDF konvertieren mit Aspose.Words – Vollständige Anleitung](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Erfahren Sie, wie Sie Word-Dokumente mit Aspose.Words vollständig in PDF konvertieren – Schritt‑für‑Schritt‑Anleitung mit Codebeispielen. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/german/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/german/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..48eb60fc05 --- /dev/null +++ b/words/german/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-03-27 +description: Konvertieren Sie Word schnell in PDF mit Aspose.Words. Erfahren Sie, + wie Sie Word als PDF speichern, DOCX nach PDF exportieren und ein barrierefreies + PDF in C# erzeugen. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: de +og_description: Word in PDF mit C# und Aspose.Words konvertieren. Dieser Leitfaden + zeigt, wie man Word als PDF speichert, DOCX nach PDF exportiert und barrierefreie + PDFs erstellt. +og_title: Word in PDF konvertieren mit Aspose.Words – Schritt für Schritt +tags: +- Aspose.Words +- C# +- PDF conversion +title: Word in PDF mit Aspose.Words konvertieren – Komplettanleitung +url: /de/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word in PDF konvertieren mit Aspose.Words – Komplettanleitung + +Haben Sie sich schon einmal gefragt, wie man **Word in PDF** konvertiert, ohne auf Drittanbieter‑Webtools zurückzugreifen? Vielleicht bauen Sie eine automatisierte Bericht‑Engine und benötigen eine zuverlässige Möglichkeit, *Word als PDF* on‑the‑fly zu speichern. Die gute Nachricht: Aspose.Words macht den gesamten Prozess kinderleicht, und Sie können sogar eine **PDF/UA‑2**‑konforme Datei erzeugen – perfekt für Barrierefreiheits‑Anforderungen. + +In diesem Tutorial gehen wir Schritt für Schritt durch alles, was Sie benötigen: Laden einer `.docx`, Konfigurieren der PDF‑Optionen, sodass Sie *docx nach pdf* mit PDF/UA‑Konformität exportieren können, und schließlich das Speichern des Ergebnisses als barrierefreies PDF. Am Ende haben Sie ein eigenständiges, produktionsreifes Snippet, das Sie in jedes .NET‑Projekt einbinden können. + +![Word in PDF konvertieren mit Aspose.Words](convert-word-to-pdf.png) + +## Was Sie lernen werden + +- **Warum Aspose.Words** eine solide Wahl für *generate accessible pdf*‑Szenarien ist. +- Die genauen Schritte, um *document as pdf* mit PDF/UA‑2‑Konformität zu speichern. +- Wie man gängige Randfälle wie fehlende Schriften oder passwortgeschützte Quelldateien behandelt. +- Schnelle Tipps zum Debuggen der Ausgabe und zur Überprüfung der Barrierefreiheits‑Konformität. + +### Voraussetzungen + +- .NET 6 oder höher (die API funktioniert auch mit .NET Framework 4.6+). +- Eine gültige Aspose.Words for .NET‑Lizenz (die kostenlose Testversion funktioniert für Evaluierungen). +- Grundkenntnisse in C# – keine ausgefallenen Muster erforderlich. + +Wenn Sie diese Punkte erfüllt haben, legen wir los. + +--- + +## Word in PDF konvertieren – Schritt‑für‑Schritt‑Implementierung + +Wir teilen die Lösung in fünf klare Schritte. Jeder Schritt hat eine Überschrift, einen kurzen Code‑Auszug und eine Erklärung, *warum* der Code wichtig ist. + +### Schritt 1: Das Word‑Dokument laden, das Sie konvertieren möchten + +Zuerst benötigen Sie ein `Document`‑Objekt, das die Quelldatei repräsentiert. Aspose.Words liest **.docx**, **.doc**, **.rtf** und viele weitere Formate, sodass Sie *word as pdf* speichern können, egal wie die Datei ursprünglich erstellt wurde. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Warum das wichtig ist:** +- Das frühe Laden der Datei lässt Sie fehlende‑Datei‑Fehler abfangen, bevor Sie CPU‑Zyklen verschwenden. +- Die `Document`‑Klasse abstrahiert die interne Struktur einer Word‑Datei und bietet Ihnen ein sauberes Objektmodell zur Weiterverarbeitung. + +### Schritt 2: PDF‑Speicheroptionen für Barrierefreiheit konfigurieren + +Wenn Sie *generate accessible pdf*‑Dateien benötigen, müssen Sie Aspose.Words anweisen, ein PDF/UA‑2‑konformes Dokument zu erzeugen. Die Klasse `PdfSaveOptions` gibt Ihnen feinkörnige Kontrolle über die Ausgabe. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Warum das wichtig ist:** +- `PdfCompliance.PdfUa2` weist die Bibliothek an, die notwendigen Tags, Strukturinformationen und Metadaten hinzuzufügen, die Screen‑Reader benötigen. +- Das Einbetten von Schriften (`EmbedFullFonts = true`) verhindert die gefürchteten „font not found“‑Warnungen, wenn das PDF auf einem anderen Betriebssystem geöffnet wird. +- Das Setzen eines `Title` hilft assistiven Technologien, das Dokument korrekt anzukündigen. + +### Schritt 3: Das Dokument als PDF speichern + +Jetzt, wo die Quelle geladen und die Optionen gesetzt sind, ist die eigentliche Konvertierung ein Einzeiler. Hier führen Sie *export docx to pdf* aus. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Warum das wichtig ist:** +- Die `Save`‑Methode respektiert die konfigurierten `PdfSaveOptions` und stellt sicher, dass die Barrierefreiheits‑Features eingebettet werden. +- Das Einbetten des Aufrufs in einen `try/catch`‑Block gibt Ihnen die Möglichkeit, Lizenz‑ oder Berechtigungsfehler zu protokollieren oder auszugeben, die häufig Neulinge überraschen. + +### Schritt 4: PDF/UA‑Konformität überprüfen (optional, aber empfohlen) + +Obwohl Aspose.Words die schwere Arbeit übernimmt, ist es gute Praxis, die Ausgabe zu prüfen, besonders wenn Sie Dokumente an Regierungsbehörden oder andere regulierte Stellen liefern. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Warum das wichtig ist:** +- `IsTagged` ist ein schneller Plausibilitäts‑Check; eine vollständige PDF/UA‑Validierung erfordert einen dedizierten Validator, aber die meisten Konformitäts‑Probleme zeigen sich als fehlende Tags. +- Gibt die Flagge `false` zurück, können Sie `PdfSaveOptions` erneut prüfen – vielleicht haben Sie `Compliance` nicht gesetzt oder das Quell‑Dokument enthielt keine korrekten Überschriften‑Stile. + +### Schritt 5: Häufige Stolperfallen & Pro‑Tipps + +| Stolperfalle | Was passiert | Wie man es behebt | +|--------------|--------------|-------------------| +| **Fehlende Schriften** | Text erscheint als Kästchen im PDF. | Setzen Sie `EmbedFullFonts = true` **oder** installieren Sie die fehlenden Schriften auf dem Server. | +| **Unlizenzierte Bibliothek** | Aspose fügt jedem Blatt ein Wasserzeichen hinzu. | Laden Sie Ihre Lizenzdatei (`Aspose.Words.lic`) früh im Programm (z. B. `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Passwortgeschützte Quelle** | `InvalidOperationException` bei `new Document(path)`. | Verwenden Sie die Überladung `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Große Dokumente verursachen OOM** | Out‑of‑memory‑Ausnahme bei riesigen Dateien. | Aktivieren Sie `MemoryOptimization` in `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Barrierefreiheits‑Tags fehlen** | PDF/UA‑Validierung schlägt fehl. | Stellen Sie sicher, dass das Quell‑Word‑Dokument korrekte Überschriften‑Stile verwendet (`Heading 1`, `Heading 2` usw.) – Aspose mappt diese automatisch zu PDF‑Tags. | + +**Pro‑Tipp:** Wenn Sie viele Dokumente stapelweise konvertieren, verwenden Sie eine einzige Instanz von `PdfSaveOptions`. Das einmalige Erstellen reduziert den Allokations‑Overhead und hält den Speicherverbrauch niedrig. + +--- + +## Vollständiges, lauffähiges Beispiel (Copy‑Paste‑bereit) + +Unten finden Sie das komplette Programm, das alles zusammenführt. Speichern Sie es als `Program.cs`, fügen Sie die NuGet‑Pakete Aspose.Words und Aspose.PDF hinzu und führen Sie es aus. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Erwartetes Ergebnis:** +Eine Datei namens `output.pdf` erscheint in `C:\MyFiles`. Öffnen Sie sie in Adobe Acrobat, dort wird im Konformitäts‑Panel “PDF/A‑2b, PDF/UA‑1” angezeigt, was bestätigt, dass Sie erfolgreich *convert word to pdf* durchgeführt haben. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/german/net/programming-with-markdownsaveoptions/_index.md b/words/german/net/programming-with-markdownsaveoptions/_index.md index 13224e8603..29fa994a79 100644 --- a/words/german/net/programming-with-markdownsaveoptions/_index.md +++ b/words/german/net/programming-with-markdownsaveoptions/_index.md @@ -49,6 +49,15 @@ Erfahren Sie, wie Sie DOCX‑Dateien in Markdown speichern – vollständige Sch ### [Wie man Markdown aus DOCX exportiert – Vollständige Anleitung](./how-to-export-markdown-from-docx-complete-guide/) Erfahren Sie, wie Sie DOCX‑Dateien vollständig in Markdown exportieren – Schritt‑für‑Schritt‑Anleitung in C#. +### [Wie man LaTeX aus Word exportiert – DOCX in Markdown konvertieren](./how-to-export-latex-from-word-convert-docx-to-markdown/) +Erfahren Sie, wie Sie LaTeX‑Formeln aus Word‑Dokumenten extrahieren und in Markdown konvertieren. + +### [Wie man LaTeX aus DOCX exportiert – Konvertieren zu Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) +Erfahren Sie, wie Sie LaTeX‑Formeln aus DOCX‑Dateien exportieren und in Markdown konvertieren. + +### [Markdown aus Word erstellen – Vollständige C#‑Anleitung](./create-markdown-from-word-full-c-guide/) +Erfahren Sie, wie Sie mit Aspose.Words für .NET Markdown aus Word‑Dokumenten generieren – komplette Schritt‑für‑Schritt‑Anleitung in C#. + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/german/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/german/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..8b1870b943 --- /dev/null +++ b/words/german/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-03-27 +description: Erstellen Sie Markdown aus Word mit Aspose.Words C#. Lernen Sie, wie + Sie docx in Markdown konvertieren, Bilder aus Word extrahieren und wie Sie einen + Callback in einem einzigen Tutorial verwenden. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: de +og_description: Erstellen Sie Markdown aus Word mit Aspose.Words. Dieser Leitfaden + zeigt, wie Sie docx in Markdown konvertieren, Bilder aus Word extrahieren und einen + Callback für die Ressourcenverwaltung verwenden. +og_title: Markdown aus Word erstellen – Vollständiges C#‑Tutorial +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Markdown aus Word erstellen – Vollständiger C#‑Leitfaden +url: /de/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Markdown aus Word erstellen – Vollständiges C#‑Tutorial + +Haben Sie jemals **Markdown aus Word erstellen** müssen, wussten aber nicht, wo Sie anfangen sollen? Sie sind nicht allein; viele Entwickler stoßen auf dieses Problem, wenn sie Inhalte aus einer .docx‑Datei in einen Static‑Site‑Generator oder ein Dokumentations‑Repository verschieben wollen. Die gute Nachricht? Mit Aspose.Words können Sie **docx in Markdown konvertieren**, jedes Bild aus der Originaldatei extrahieren und genau steuern, wo diese Ressourcen abgelegt werden – alles mit einem einfachen Callback. + +In diesem Leitfaden führen wir Sie durch ein praxisnahes Beispiel, das zeigt, wie Sie Bilder aus Word extrahieren, wie Sie einen Callback zum Speichern verwenden und warum dieser Ansatz für Automatisierungspipelines am zuverlässigsten ist. Am Ende haben Sie ein einsatzbereites C#‑Programm, das eine saubere `.md`‑Datei und einen Ordner mit extrahierten Bildern erzeugt. + +> **Pro‑Tipp:** Wenn Sie bereits eine Word‑Vorlage haben, die Screenshots, Diagramme oder Logos enthält, bewahrt diese Methode jedes visuelle Element, ohne dass Sie manuell kopieren‑einfügen müssen. + +## Was Sie benötigen + +- **.NET 6+** (oder .NET Framework 4.6+). Der Code funktioniert auf jeder aktuellen Runtime. +- **Aspose.Words for .NET** (NuGet‑Paket `Aspose.Words`). Die kostenlose Testversion funktioniert für die meisten Szenarien. +- Ein **Word‑Dokument** (`input.docx`), das Text und mindestens ein Bild enthält. +- Grundlegende Kenntnisse in C# und Visual Studio (oder Ihrer bevorzugten IDE). + +Es werden keine zusätzlichen Bibliotheken benötigt – alles andere wird von Aspose.Words selbst erledigt. + +## Schritt 1: Projekt einrichten und Aspose.Words installieren + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Warum dieser Schritt wichtig ist:** Durch die Installation des NuGet‑Pakets stellen Sie sicher, dass Sie die neueste API haben, die die in Version 22.9 eingeführte Klasse `MarkdownSaveOptions` enthält. Ohne sie müssten Sie einen eigenen Konverter schreiben. + +## Schritt 2: Quell‑Word‑Dokument laden + +Die erste Codezeile öffnet die `.docx`, die Sie transformieren möchten. Ersetzen Sie `YOUR_DIRECTORY` durch den tatsächlichen Pfad auf Ihrem Rechner. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Was passiert?** `Document` analysiert die Datei, baut ein internes DOM auf und macht jeden Absatz, jede Tabelle und jedes Bild zugänglich. Wenn die Datei fehlt, wirft Aspose eine klare `FileNotFoundException`, die Sie abfangen können, um eine benutzerfreundlichere UI zu erhalten. + +## Schritt 3: Markdown‑Speicheroptionen mit einem Ressourcen‑Speicher‑Callback konfigurieren + +Hier kommt die Magie von **how to use callback** ins Spiel. Der Callback ermöglicht es Ihnen zu entscheiden, wohin jedes extrahierte Bild gespeichert wird. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Warum ein Callback?** Standardmäßig würde Aspose Bilder als Base‑64‑Strings in das Markdown einbetten – ein Albtraum für die Versionskontrolle. Der Callback gibt Ihnen die volle Kontrolle über Dateinamen und Ordnerstruktur. + +## Schritt 4: Dokument als Markdown speichern + +Jetzt erzeugen wir tatsächlich die `.md`‑Datei. Alle Bilder werden an den im nächsten Schritt definierten Callback übergeben. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Wenn alles gut geht, finden Sie `Document.md` im Zielordner und einen Unterordner namens `Resources`, der jedes aus der ursprünglichen Word‑Datei extrahierte Bild enthält. + +## Schritt 5: Callback implementieren, der jedes extrahierte Bild speichert + +Unten finden Sie die vollständige Implementierung von `MyResourceSaver`. Sie erstellt ein Verzeichnis `Resources` (falls es nicht existiert), erzeugt für jedes Bild einen eindeutigen Dateinamen und schreibt den Bild‑Stream auf die Festplatte. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Erklärung der Argumente:** +> - `args.Index` – ein nullbasierter Zähler, der Eindeutigkeit garantiert. +> - `args.FileName` – der von Aspose vorgeschlagene ursprüngliche Dateiname (oft etwas wie `image001.png`). +> - `args.Stream` – der Ausgabestream, in den die Bildbytes geschrieben werden. +> - `args.KeepResourceStreamOpen` – auf `false` gesetzt, damit Aspose den Stream automatisch freigibt und Dateihandles‑Lecks verhindert. + +## Vollständiges funktionierendes Beispiel + +Wenn wir alles zusammenfügen, erhalten Sie eine einzelne Datei, die Sie in `Program.cs` kopieren‑und‑einfügen können. Denken Sie daran, `YOUR_DIRECTORY` durch einen absoluten oder relativen Pfad zu ersetzen, der zu Ihrer Umgebung passt. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Erwartete Ausgabe + +- `YOUR_DIRECTORY/Document.md` – eine Markdown‑Datei mit Standard‑Markdown‑Bildlinks, z. B.: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – enthält `img_0.png`, `img_1.jpg` usw., entsprechend der Reihenfolge, in der sie im ursprünglichen Word‑Dokument erschienen sind. + +Beim Ausführen des Programms wird eine freundliche Bestätigung ausgegeben, die Ihnen mitteilt, dass der Vorgang erfolgreich war. + +## Häufig gestellte Fragen (FAQ) + +### Wie extrahiere ich Bilder aus Word, ohne Qualitätsverlust? + +Der Callback schreibt den rohen Binär‑Stream direkt in eine Datei und bewahrt die ursprüngliche Auflösung. Es findet keine Konvertierung oder Kompression statt, es sei denn, Sie fügen eigene Bildverarbeitungslogik in `ResourceSaving` ein. + +### Kann ich das Bildformat (z. B. PNG → JPEG) während der Extraktion ändern? + +Ja. Innerhalb von `ResourceSaving` können Sie `args.FileName` oder `args.Stream` prüfen, das Bild mit `System.Drawing` oder `ImageSharp` laden und dann vor dem Schreiben neu kodieren. Denken Sie nur daran, die Dateierweiterung im Markdown‑Link entsprechend anzupassen. + +### Was, wenn die Markdown‑Dateien auf ein CDN statt auf einen lokalen Ordner verweisen sollen? + +Passen Sie den Callback an, um dem Markdown‑Link eine Basis‑URL voranzustellen. Das erreichen Sie, indem Sie `args.FileName` nach dem Hochladen des Bildes in Ihr CDN auf eine vollständig qualifizierte URL setzen. + +### Funktioniert das mit Tabellen, Fußnoten oder anderen erweiterten Word‑Funktionen? + +Ja. Aspose.Words übersetzt die meisten Word‑Konstrukte in entsprechende Markdown‑Entsprechungen. Tabellen werden zu Markdown‑Tabellen, Fußnoten zu Referenz‑Links und sogar verschachtelte Listen werden sauber verarbeitet. Wenn etwas seltsam aussieht, prüfen Sie die neuesten Release‑Notes – Aspose verbessert kontinuierlich die Konvertierungsgenauigkeit. + +### Wie konvertiere ich docx zu markdown in einer CI/CD‑Pipeline? + +Fügen Sie einfach die kompilierte `.exe` zu Ihren Build‑Schritten hinzu, verweisen Sie auf die erzeugten `.docx`‑Artefakte und pushen Sie die resultierende `.md`‑Datei sowie den `Resources/`‑Ordner in Ihr Repository für die statische Website. Da der Prozess vollständig deterministisch ist, funktioniert er gut in automatisierten Umgebungen. + +## Abschluss + +Wir haben gerade gezeigt, wie man **Markdown aus Word** mit Aspose.Words erstellt, den gesamten **convert docx to markdown**‑Workflow abgedeckt und eine praktische Methode zum **extract images from Word** mit einer benutzerdefinierten **how to use callback**‑Implementierung demonstriert. Das Ergebnis ist eine saubere Markdown‑Datei zusammen mit einem Ordner der Originalbilder – ideal für Dokumentationsseiten, statische Blogs oder jeden Workflow, der reine Textformate bevorzugt. + +Nächste Schritte, die Sie in Betracht ziehen könnten: + +- **Batch‑Verarbeitung** mehrerer `.docx`‑Dateien in einem Ordner (Schleife über `Directory.GetFiles`). +- **Benutzerdefinierte Benennungsschemata** für Bilder (z. B. unter Verwendung des ursprünglichen Beschriftungstextes). +- **Nachbearbeitung** des Markdown, um Bildlinks durch CDN‑URLs zu ersetzen. +- Untersuchung **weiterer Aspose‑Exportformate** wie HTML, PDF oder EPUB für Multi‑Channel‑Publishing. + +Haben Sie weitere Fragen oder eine knifflige Word‑Datei, die sich nicht konvertieren lässt? Hinterlassen Sie unten einen Kommentar, und wir lösen das Problem gemeinsam. Viel Spaß beim Coden und genießen Sie die Einfachheit, Word in Markdown zu verwandeln! + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/german/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/german/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..edd9ba8bec --- /dev/null +++ b/words/german/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,266 @@ +--- +category: general +date: 2026-03-27 +description: Wie man LaTeX aus DOCX mit Aspose.Words exportiert. Erfahren Sie, wie + Sie DOCX in Markdown konvertieren, DPI festlegen und die Wiederherstellung in C# + aktivieren. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: de +og_description: Wie man LaTeX aus DOCX mit Aspose.Words exportiert. Dieses Tutorial + zeigt die Schritt‑für‑Schritt‑Konvertierung zu Markdown, DPI‑Steuerung und den Wiederherstellungsmodus. +og_title: Wie man LaTeX aus DOCX exportiert – in Markdown umwandeln +tags: +- Aspose.Words +- C# +- Document Conversion +title: Wie man LaTeX aus DOCX exportiert – nach Markdown konvertieren +url: /de/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Wie man LaTeX aus DOCX exportiert – Konvertieren zu Markdown + +Haben Sie sich jemals gefragt, **wie man LaTeX** aus einer DOCX‑Datei exportiert, ohne die Schönheit Ihrer Gleichungen zu verlieren? Sie sind nicht allein. Nach meiner Erfahrung ist das größte Problem, diese OfficeMath‑Objekte in ein sauberes, portables Format für Static‑Site‑Generatoren oder wissenschaftliche Blogs zu bringen. + +In diesem Leitfaden gehen wir Schritt für Schritt die Konvertierung von DOCX zu Markdown mit Aspose.Words durch, zeigen dabei **wie man DPI setzt**, **wie man die Wiederherstellung aktiviert** und ein paar nützliche Tricks für eine robuste Pipeline. Am Ende haben Sie ein einzelnes C#‑Programm, das eine Markdown‑Datei mit LaTeX‑Gleichungen, hochauflösenden Bildern und korrekter Hyperlink‑Verarbeitung erzeugt. + +## Was Sie benötigen + +- **.NET 6+** (oder .NET Framework 4.7.2 – die API funktioniert genauso) +- **Aspose.Words for .NET** (die neueste stabile Version ab März 2026) +- Eine DOCX‑Datei, die Gleichungen, Bilder und Links enthält +- Visual Studio, VS Code oder einen beliebigen Editor Ihrer Wahl + +Keine zusätzlichen NuGet‑Pakete sind über Aspose.Words hinaus erforderlich, aber stellen Sie sicher, dass Sie eine gültige Lizenz besitzen, wenn Sie nicht die Testversion verwenden. + +## Schritt 1 – Laden des DOCX mit Strict‑Recovery‑Modus + +Bevor wir überhaupt an den Export denken, müssen wir sicherstellen, dass das Quelldokument keine Beschädigungen verbirgt. Hier kommt **wie man die Wiederherstellung aktiviert** ins Spiel. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Warum Strict‑Recovery?** +Wenn Sie Aspose stillschweigend Probleme beheben lassen, kann es zu fehlenden Absätzen oder defekten Bildern kommen – etwas, das beim Export von LaTeX niemand möchte. Durch ein schnelles Scheitern können Sie das Problem frühzeitig erkennen und entscheiden, ob Sie das Quell‑DOCX korrigieren oder das Problem später protokollieren. + +### Profi‑Tipp +Umwickeln Sie das Laden mit einem try/catch und protokollieren Sie `DocumentLoadingException`. So kann Ihre CI‑Pipeline problematische Dateien kennzeichnen, ohne den gesamten Build zu stoppen. + +## Schritt 2 – Vorbereitung der Markdown‑Export‑Optionen + +Jetzt, wo das Dokument sicher im Speicher ist, konfigurieren wir, wie es gespeichert wird. Das ist das Kernstück von **wie man LaTeX exportiert** und behandelt zudem **wie man DPI setzt** für eingebettete Bilder. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Was jede Option bewirkt** + +| Option | Grund | Bezug zu Schlüsselwörtern | +|--------|-------|---------------------------| +| `OfficeMathExportMode = LaTeX` | Answeret direkt **how to export latex** aus Gleichungen. | Primäres Schlüsselwort | +| `ImageResolution = 300` | Steuert die Bildqualität – die Antwort auf **how to set dpi**. | Sekundär | +| `ResourceSavingCallback` | Speichert eingebettete Dateien auf die Festplatte, ein häufiger Bedarf beim **convert docx to markdown**. | Sekundär | +| `EmptyParagraphExportMode` | Garantiert sauberen Markdown‑Output und verhindert lose HTML‑Tags. | Verbessert die Gesamtqualität der Konvertierung | +| `LinkExportMode = AsReference` | Macht Links leicht lesbar und editierbar, ein weiterer Pluspunkt für **convert docx to markdown**. | | + +## Schritt 3 – Implementierung eines benutzerdefinierten Resource‑Savers (optional aber praktisch) + +Wenn Sie DOCX zu Markdown konvertieren, benötigen Bilder und andere Binärressourcen einen Ort im Dateisystem. Aspose ermöglicht dies mit `IResourceSavingCallback`. Das obige Snippet zeigt bereits eine minimale Implementierung, aber wir zerlegen es: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Warum das Ganze?** +Wenn Sie diesen Schritt überspringen, bettet Aspose Bilder als Base‑64‑Strings ein, was die Markdown‑Dateigröße stark erhöht und die Versionskontrolle erschwert. Durch das Speichern der Ressourcen in einem separaten Ordner bleibt das Markdown leichtgewichtig und ist freundlich für Static‑Site‑Generatoren wie Hugo oder Jekyll. + +## Schritt 4 – Dokument als Markdown speichern + +Alle aufwändigen Arbeiten sind erledigt. Eine Zeile schreibt jetzt die endgültige Datei. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Open `output.md` and you’ll see: + +- Gleichungen werden als `$…$` LaTeX‑Blöcke gerendert +- Bilder werden referenziert als `![Alt text](resources/image001.png)` mit 300 dpi Auflösung +- Hyperlinks werden in Referenz‑Stil umgewandelt: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Das ist der gesamte **how to convert docx** Prozess in Kürze. + +## Häufige Fragen & Sonderfälle + +### 1️⃣ Was, wenn das DOCX nicht unterstützte Objekte enthält? +Aspose.Words wirft eine `FeatureNotSupportedException`. Da wir **how to enable recovery** im Strict‑Modus verwendet haben, erscheint die Ausnahme sofort. Sie können entweder: + +- `RecoveryMode` zu `RecoveryMode.Default` wechseln für eine best‑effort‑Konvertierung, **oder** +- Das DOCX vorverarbeiten (z. B. nicht unterstützte SmartArt entfernen), bevor Sie den Konverter ausführen. + +### 2️⃣ Kann ich die DPI pro Bild ändern? +Die Einstellung `ImageResolution` ist global. Für eine Bild‑für‑Bild‑Steuerung implementieren Sie einen benutzerdefinierten `ImageSavingCallback` ähnlich wie `MyResourceSaver` und passen `args.ImageResolution` basierend auf `args.ImageFileName` oder Metadaten an. + +### 3️⃣ Wie bette ich das erzeugte LaTeX in einer Jekyll‑Seite ein? +Der eingebaute MathJax‑Support von Jekyll funktioniert sofort. Stellen Sie lediglich sicher, dass Ihr Layout das MathJax‑Script enthält und die LaTeX‑Blöcke in `$$` für Anzeige‑Gleichungen oder `$` für Inline‑Gleichungen eingeschlossen sind. + +### 4️⃣ Ist das mit .NET Core unter Linux kompatibel? +Absolut. Aspose.Words ist plattformübergreifend. Achten Sie nur darauf, dass der Pfad `YOUR_DIRECTORY` den Linux‑Konventionen folgt (z. B. `/home/user/docs`). + +## Vollständiges funktionierendes Beispiel + +Unten finden Sie ein sofort kopier‑fertiges Programm. Ersetzen Sie `YOUR_DIRECTORY` durch einen tatsächlichen Pfad auf Ihrem Rechner. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Erwartete Ausgabe** – öffnen Sie `output.md` und Sie sollten etwas Ähnliches sehen: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Wenn Sie die Datei in einer Markdown‑Vorschau öffnen, die MathJax unterstützt, wird das Integral gerendert + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/german/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/german/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..2b3c0c83c2 --- /dev/null +++ b/words/german/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-03-27 +description: Wie man LaTeX aus Word‑Dokumenten mit Aspose.Words exportiert – DOCX + in Markdown mit Gleichungen als LaTeX konvertiert. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: de +og_description: Wie man LaTeX aus Word‑Dokumenten exportiert, wird im ersten Satz + erklärt, wobei gezeigt wird, wie man DOCX mit Gleichungen als LaTeX in Markdown + konvertiert. +og_title: Wie man LaTeX aus Word exportiert – Vollständige Anleitung +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Wie man LaTeX aus Word exportiert – DOCX in Markdown konvertieren +url: /de/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Wie man LaTeX aus Word exportiert – DOCX in Markdown konvertieren + +Haben Sie sich jemals gefragt, **wie man LaTeX** aus einer Word-Datei exportiert, ohne am Ende eine Menge PNGs zu erhalten? Sie sind nicht allein; Entwickler stoßen ständig auf dieses Problem, wenn sie saubere, editierbare Gleichungen für statische Websites oder wissenschaftliche Blogs benötigen. Die gute Nachricht? Mit Aspose.Words können Sie **Word in Markdown konvertieren** und jedes OfficeMath-Objekt als nativen LaTeX behalten – keine Nachbearbeitung erforderlich. + +In diesem Tutorial führen wir Sie durch den gesamten Prozess, ein **Word-Dokument als Markdown zu speichern**, während **Gleichungen als LaTeX exportiert** werden. Am Ende haben Sie ein ausführbares C#‑Snippet, eine klare Erklärung jeder Option und Tipps zum Umgang mit Sonderfällen wie komplexen Formeln oder gemischtem Inhalt. Keine externen Werkzeuge, nur ein einziges NuGet‑Paket und ein paar Code‑Zeilen. + +## Was Sie benötigen + +- .NET 6+ (oder .NET Framework 4.7.2 und höher) – die neueste Runtime funktioniert am besten. +- Visual Studio 2022 oder ein beliebiger Editor, der C#‑Projekte kompilieren kann. +- Eine Aspose.Words für .NET‑Lizenz (die kostenlose Testversion eignet sich zum Experimentieren). +- Eine DOCX‑Datei, die mindestens eine Gleichung (OfficeMath) enthält. + +Wenn Sie das bereits haben, großartig – lassen Sie uns loslegen. + +## Wie man LaTeX aus Word exportiert – Überblick + +Im Folgenden finden Sie eine Übersicht der einzelnen Schritte: + +1. **Install** das Aspose.Words NuGet‑Paket. +2. **Load** die Quell‑`.docx`, die Ihre Gleichungen enthält. +3. **Configure** `MarkdownSaveOptions`, sodass `OfficeMathExportMode` auf `LaTeX` gesetzt ist. +4. **Save** das Dokument als `.md`‑Datei. +5. **Verify**, dass das erzeugte Markdown LaTeX‑Blöcke (`$$…$$`) enthält. + +Jeder dieser Schritte wird in den folgenden Abschnitten ausführlich erklärt. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="Diagramm zum Export von LaTeX aus Word"} + +## Schritt 1 – Aspose.Words für .NET installieren (Word in Markdown konvertieren) + +Zuerst benötigen Sie die Bibliothek, die die eigentliche Arbeit erledigt. Öffnen Sie Ihr Terminal (oder die Package Manager Console) und führen Sie aus: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Profi‑Tipp:** Wenn Sie Visual Studio verwenden, klicken Sie mit der rechten Maustaste auf das Projekt → *NuGet‑Pakete verwalten* → suchen Sie nach „Aspose.Words“ und installieren Sie die neueste stabile Version. + +Warum das wichtig ist: Aspose.Words abstrahiert das Open‑XML‑Format und bietet Ihnen eine saubere API, um Word‑Dokumente zu manipulieren, ohne sich mit dem Low‑Level‑XML auseinandersetzen zu müssen. Es enthält außerdem integrierte Unterstützung für die Konvertierung von OfficeMath zu LaTeX, was der Kern unserer Anforderung **Gleichungen als LaTeX exportieren** ist. + +## Schritt 2 – Das DOCX laden (wie man docx konvertiert) + +Jetzt, wo das Paket vorhanden ist, laden Sie die Datei, die Sie transformieren möchten. Ersetzen Sie `YOUR_DIRECTORY` durch den Pfad, in dem Ihre `.docx` liegt: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Warum so laden?** Der `Document`‑Konstruktor parsed die gesamte Datei in ein Objektmodell, sodass Sie sofort Zugriff auf Absätze, Tabellen und – am wichtigsten – OfficeMath‑Objekte haben. Wenn die Datei fehlt oder beschädigt ist, wirft Aspose eine beschreibende `FileNotFoundException`, die Sie abfangen können, um eine elegante Fehlerbehandlung zu ermöglichen. + +## Schritt 3 – MarkdownSaveOptions konfigurieren (Gleichungen als LaTeX exportieren) + +Die Magie passiert im `MarkdownSaveOptions`‑Objekt. Standardmäßig würde Aspose Gleichungen als PNG‑Bilder rendern, aber wir wollen LaTeX. Setzen Sie `OfficeMathExportMode` auf `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Eine kurze Anmerkung zu den optionalen Flags: `ExportImagesAsBase64` weist Aspose an, keine Binärdaten einzubetten, was das Markdown sauber hält. `ExportHeadersFooters` sorgt dafür, dass Sie keinen Kontext verlieren, der in diesen Bereichen liegen könnte – nützlich, wenn die Kopfzeile einen Titel oder Autorennamen enthält. + +## Schritt 4 – Dokument speichern (Word als Markdown speichern) + +Schließlich schreiben Sie den transformierten Inhalt in eine `.md`‑Datei: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Nachdem diese Zeile ausgeführt wurde, finden Sie `output.md` neben Ihrer Quelldatei. Öffnen Sie sie in einem beliebigen Texteditor und Sie sollten LaTeX‑Blöcke sehen, die etwa so aussehen: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Das ist der **save word as markdown**‑Teil erledigt – keine zusätzlichen Konvertierungsschritte nötig. + +## Schritt 5 – Ergebnis überprüfen (Gleichungen als LaTeX exportieren) + +Es ist leicht, die Überprüfung zu übersehen, aber ein kurzer Plausibilitäts‑Check spart später Stunden. Führen Sie ein einfaches Skript aus, das die erzeugte Datei liest und den ersten LaTeX‑Block ausgibt: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Wenn Sie `First LaTeX block: $$ … $$` ausgegeben sehen, haben Sie erfolgreich **LaTeX aus Word exportiert**. Wenn nicht, prüfen Sie erneut, ob Ihr Quelldokument tatsächlich OfficeMath‑Objekte enthält; reguläre Text‑Gleichungen werden nicht konvertiert. + +## Umgang mit gängigen Sonderfällen + +| Scenario | What to Watch For | Recommended Fix | +|----------|-------------------|-----------------| +| **Gemischte Bilder & Gleichungen** | Aspose kann immer noch Bilder für Nicht‑OfficeMath‑Grafiken einbetten. | Setzen Sie `ExportImagesAsBase64 = false` und behalten Sie Bilder als externe Dateien, dann referenzieren Sie sie manuell im Markdown. | +| **Komplexe verschachtelte Gleichungen** | Sehr tiefe Verschachtelungen können LaTeX erzeugen, das manuell nachbearbeitet werden muss. | Verarbeiten Sie den Block nach mit einem LaTeX‑Formatter (z. B. `latexindent`) oder passen Sie `mdOptions` → `ExportMathAsDisplay = true` an. | +| **Große Dokumente** | Der Speicherverbrauch steigt beim Laden riesiger `.docx`‑Dateien stark an. | Verwenden Sie `LoadOptions` mit `LoadFormat.Docx` und aktivieren Sie das Streaming von `LoadOptions.LoadFormat`, falls verfügbar. | +| **Fehlende Lizenz** | Die kostenlose Testversion fügt dem Ergebnis einen Wasserzeichen‑Kommentar hinzu. | Wenden Sie eine gültige Lizenz an via `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Diese Tipps halten Ihren Workflow robust, besonders wenn Sie **Word in Markdown konvertieren** in Produktionspipelines. + +## Vollständiges funktionierendes Beispiel (Alle Schritte in einer Datei) + +Im Folgenden finden Sie eine eigenständige Konsolen‑App, die Sie in ein neues .NET‑Projekt kopieren und sofort ausführen können. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Führen Sie das Programm aus, öffnen Sie `output.md`, und Sie sehen Ihre Gleichungen als sauberen LaTeX gerendert. Das ist die vollständige Antwort auf **wie man LaTeX** aus einem Word‑Dokument exportiert. + +## Fazit + +Wir haben **wie man LaTeX** aus Word Schritt für Schritt behandelt und gezeigt, wie man **Word in Markdown konvertiert**, **Word als Markdown speichert** und **Gleichungen als LaTeX exportiert** mit Aspose.Words. Die Kernidee ist einfach: Laden Sie das DOCX, passen Sie `MarkdownSaveOptions` an und lassen Sie die Bibliothek die schwere Arbeit erledigen. + +Wenn Sie bereit sind, Dokumentations‑Pipelines zu automatisieren, versuchen Sie, diesen Code mit einem Static‑Site‑Generator wie Hugo oder Jekyll zu verketten – schieben Sie einfach die erzeugten `.md`‑Dateien in Ihr Repository und lassen Sie die Seite neu bauen. Für weiterführende Lektüre, erkunden Sie Asposes „Export to LaTeX“-Leitfaden, experimentieren Sie mit `HtmlSaveOptions` für Web‑Vorschauen oder tauchen Sie in die `DocumentVisitor`‑API für benutzerdefinierte Transformationen ein. + +Haben Sie Fragen zu Sonderfällen, Lizenzen oder der Integration in CI/CD? Hinterlassen Sie unten einen Kommentar, und happy coding! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/german/net/programming-with-pdfsaveoptions/_index.md b/words/german/net/programming-with-pdfsaveoptions/_index.md index 0dd6def95f..ebc7017715 100644 --- a/words/german/net/programming-with-pdfsaveoptions/_index.md +++ b/words/german/net/programming-with-pdfsaveoptions/_index.md @@ -26,7 +26,7 @@ Egal, ob Sie Word-Dokumente für die Online-Verteilung, Archivierung oder den Dr | --- | --- | | [Dokumenttitel in der Fenstertitelleiste anzeigen](./display-doc-title-in-window-titlebar/) | Erfahren Sie in dieser Schritt-für-Schritt-Anleitung, wie Sie mit Aspose.Words für .NET den Dokumenttitel in der Fenstertitelleiste Ihrer PDFs anzeigen. | | [PDF-Renderwarnungen](./pdf-render-warnings/) | Schritt-für-Schritt-Anleitung zum Umgang mit PDF-Rendering-Warnungen mit Aspose.Words für .NET. | -| [Fügen Sie mithilfe des Zertifikatsinhabers eine digitale Signatur zu PDF hinzu](./digitally-signed-pdf-using-certificate-holder/) | Sichern Sie Ihre PDF-Dateien mit einer digitalen Signatur mit Aspose.Words für .NET. Folgen Sie dieser Schritt-für-Schritt-Anleitung, um Ihren PDFs mühelos eine digitale Signatur hinzuzufügen. | +| [Fügen Sie mithilfe des Zertifikatsinhabers eine digitale Signatur zu PDF hinzufügen](./digitally-signed-pdf-using-certificate-holder/) | Sichern Sie Ihre PDF-Dateien mit einer digitalen Signatur mit Aspose.Words für .NET. Folgen Sie dieser Schritt-für-Schritt-Anleitung, um Ihren PDFs mühelos eine digitale Signatur hinzuzufügen. | | [Schriftarten in PDF-Dokumente einbetten](./embedded-all-fonts/) | Betten Sie Schriftarten mühelos in PDF-Dokumente ein – mit Aspose.Words für .NET und dieser detaillierten Schritt-für-Schritt-Anleitung. Sorgen Sie für ein einheitliches Erscheinungsbild auf allen Geräten. | | [Einbetten von Teilmengen von Schriftarten in PDF-Dokumente](./embedded-subset-fonts/) Reduzieren Sie die PDF-Dateigröße, indem Sie mit Aspose.Words für .NET nur die benötigten Schriftarten einbetten. Folgen Sie unserer Schritt-für-Schritt-Anleitung, um Ihre PDFs effizient zu optimieren. | | [Reduzieren Sie die PDF-Größe, indem Sie eingebettete Schriftarten deaktivieren](./disable-embed-windows-fonts/) | Reduzieren Sie die PDF-Größe, indem Sie eingebettete Schriftarten mit Aspose.Words für .NET deaktivieren. Folgen Sie unserer Schritt-für-Schritt-Anleitung, um Ihre Dokumente für effizientes Speichern und Teilen zu optimieren. | @@ -45,7 +45,7 @@ Egal, ob Sie Word-Dokumente für die Online-Verteilung, Archivierung oder den Dr | [Zuletzt gedruckte Eigenschaft im PDF-Dokument aktualisieren](./update-last-printed-property/) | Erfahren Sie in unserer Schritt-für-Schritt-Anleitung, wie Sie die zuletzt gedruckte Eigenschaft in einem PDF-Dokument mit Aspose.Words für .NET aktualisieren. | | [Rendern Sie 3D-DML-3DEffects in einem PDF-Dokument](./dml-3deffects-rendering/) | Erfahren Sie in dieser umfassenden Schritt-für-Schritt-Anleitung, wie Sie mit Aspose.Words für .NET beeindruckende 3D-DML-Effekte in PDF-Dokumenten rendern. | | [Interpolieren von Bildern in einem PDF-Dokument](./interpolate-images/) | Erfahren Sie in unserer Schritt-für-Schritt-Anleitung, wie Sie mit Aspose.Words für .NET Bilder in einem PDF-Dokument interpolieren. Verbessern Sie ganz einfach die Bildqualität Ihres PDFs. | - +| [Wie man PDF aus DOCX mit Aspose.Words speichert – Schritt‑für‑Schritt‑Anleitung](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Erfahren Sie, wie Sie mit Aspose.Words für .NET ein DOCX‑Dokument in ein PDF konvertieren und speichern – detaillierte Schritt‑für‑Schritt‑Anleitung. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/german/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/german/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..dbad96b50f --- /dev/null +++ b/words/german/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-03-27 +description: Erfahren Sie, wie Sie PDF aus einer DOCX-Datei mit Aspose.Words speichern. + Enthält das Konvertieren von DOCX zu PDF, das Speichern von PDF mit Optionen und + die Behandlung schwebender Formen. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: de +og_description: Wie man PDF aus einer DOCX-Datei mit Aspose.Words speichert. Dieser + Leitfaden zeigt die Konvertierung von DOCX zu PDF, das Speichern von PDF mit Optionen + und die Verarbeitung schwebender Formen. +og_title: Wie man ein PDF aus DOCX speichert – Komplettes Aspose.Words‑Tutorial +tags: +- Aspose.Words +- C# +- PDF conversion +title: Wie man PDF aus DOCX mit Aspose.Words speichert – Schritt‑für‑Schritt‑Anleitung +url: /de/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Wie man PDF aus DOCX mit Aspose.Words speichert – Vollständiges Tutorial + +Haben Sie sich jemals gefragt, **wie man PDF** aus einem Word‑Dokument speichert, ohne das Layout schwebender Formen zu verlieren? Sie sind nicht allein. In vielen Projekten – Rechnungs‑Generatoren, Berichtsexportern oder einfachen Dokumentenarchiven – benötigen Entwickler eine zuverlässige Methode, DOCX in PDF zu konvertieren und dabei alles exakt so aussehen zu lassen, wie es in Word dargestellt wird. + +In diesem Tutorial führen wir Sie durch die Konvertierung einer DOCX‑Datei in PDF **mit Aspose.Words für .NET**, zeigen Ihnen **wie man docx zu pdf konvertiert** mit benutzerdefinierten Speicheroptionen und erklären, warum das Flag `ExportFloatingShapesAsInlineTag` wichtig ist. Am Ende haben Sie ein sofort ausführbares Snippet, das PDF mit von Ihnen gesteuerten Optionen speichert. + +## Was Sie lernen werden + +- Die genauen Schritte, um **word document pdf zu konvertieren** mit Aspose.Words. +- Wie man `PdfSaveOptions` konfiguriert, damit schwebende Formen als Inline‑Tags behandelt werden. +- Häufige Fallstricke beim Umgang mit schwebenden Objekten und wie man sie vermeidet. +- Ein vollständiges, ausführbares C#‑Programm, das Sie in jedes .NET‑Projekt einbinden können. + +> **Voraussetzung:** Sie benötigen eine Aspose.Words für .NET‑Lizenz (oder eine kostenlose Evaluierung) und eine .NET‑Entwicklungsumgebung (Visual Studio, Rider oder die `dotnet`‑CLI). + +## Schritt 1: Projekt einrichten und Aspose.Words hinzufügen + +Zuerst erstellen Sie eine neue Konsolen‑App (oder fügen sie zu einer bestehenden hinzu) und binden das Aspose.Words‑NuGet‑Paket ein. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro‑Tipp:** Wenn Sie auf einem CI‑Server arbeiten, fixieren Sie die Paketversion (`Aspose.Words --version 24.10`), um reproduzierbare Builds zu gewährleisten. + +## Schritt 2: Laden Sie das DOCX mit schwebenden Formen + +Schwebende Bilder, Textfelder oder SmartArt können bei der Konvertierung Layoutverschiebungen verursachen. Das Laden des Dokuments ist unkompliziert, aber wir prüfen außerdem, ob die Datei existiert, um eine Laufzeit‑`FileNotFoundException` zu verhindern. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Beachten Sie die `Console.WriteLine`‑Anweisungen – sie geben Ihnen schnelles Feedback, wenn Sie die App im Terminal ausführen. + +## Schritt 3: PDF‑Speicheroptionen konfigurieren (PDF mit Optionen speichern) + +Hier passiert die Magie. Standardmäßig versucht Aspose.Words, schwebende Objekte so zu erhalten, wie sie erscheinen, was das Layout im resultierenden PDF zerstören kann. Das Setzen von `ExportFloatingShapesAsInlineTag` auf `true` weist die Bibliothek an, diese Formen als Inline‑Tags zu behandeln, sodass sie am umgebenden Text verankert bleiben. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Warum ist das wichtig? Stellen Sie sich ein Textfeld vor, das über einem Absatz schwebt. Ohne die Inline‑Tag‑Konvertierung könnte das PDF den Absatz nach unten schieben oder das Feld vollständig abschneiden. Das Flag bewahrt die visuelle Beziehung – ein feines, aber entscheidendes Detail für professionelle Berichte. + +## Schritt 4: Dokument als PDF speichern + +Jetzt schreiben wir tatsächlich die PDF‑Datei. Die `Save`‑Methode erhält sowohl den Ausgabepfad als auch die gerade gesetzten Optionen. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Beim Ausführen des Programms wird `output.pdf` im selben Ordner wie Ihr Quell‑DOCX erzeugt. Öffnen Sie es in einem beliebigen PDF‑Betrachter und Sie sollten sehen, dass alle schwebenden Formen genau dort gerendert werden, wo sie hingehören. + +## Vollständiges funktionierendes Beispiel + +Unten finden Sie das gesamte Programm in einem Block. Kopieren Sie es in `Program.cs` (oder eine beliebige C#‑Datei) und drücken Sie **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Erwartetes Ergebnis + +- **Datei erstellt:** `output.pdf` im Zielverzeichnis. +- **Layout‑Treue:** Schwebende Formen (Bilder, Textfelder, SmartArt) erscheinen inline mit dem umgebenden Text. +- **Keine Ausnahmen:** Das Programm beendet sich sauber und gibt Statusmeldungen in die Konsole aus. + +## Häufig gestellte Fragen & Sonderfälle + +| Frage | Antwort | +|----------|--------| +| **Was, wenn ich höhere Bildqualität benötige?** | Set `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Kann ich mehrere DOCX‑Dateien stapelweise konvertieren?** | Wrap the loading/saving logic in a `foreach (var file in Directory.GetFiles(..., "*.docx"))` loop. Remember to reuse a single `PdfSaveOptions` instance for performance. | +| **Funktioniert das mit .NET Core?** | Absolutely. Aspose.Words 24.x supports .NET Standard 2.0+, so you can run the same code on Windows, Linux, or macOS. | +| **Wie geht man mit passwortgeschützten DOCX‑Dateien um?** | Load with `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. The same `PdfSaveOptions` apply when saving. | +| **Ist die Inline‑Tag‑Konvertierung für komplexe Tabellen sicher?** | Generally yes, but very intricate table layouts with overlapping shapes may still need manual tweaking. Test a representative sample before a bulk migration. | + +## Tipps für reale Projekte + +- **Loggen, nicht nur `Console.WriteLine`** – In der Produktion ersetzen Sie die Konsolenausgabe durch ein Logging‑Framework (Serilog, NLog), um Fehler zu erfassen. +- **Ressourcen freigeben** – `Document` implementiert `IDisposable`. Packen Sie es in einen `using`‑Block, wenn Sie viele Dateien verarbeiten, um den Speicher zeitnah freizugeben. +- **PDF validieren** – Verwenden Sie einen PDF‑Validator (z. B. PDF/A‑Konformitätsprüfer), wenn Sie archivierungsfähige PDFs benötigen. +- **Parallelverarbeitung** – Bei großen Workloads sollten Sie `Parallel.ForEach` mit thread‑sicheren `PdfSaveOptions` (pro Thread klonen) in Betracht ziehen, um die Konvertierung zu beschleunigen. + +## Fazit + +Wir haben **wie man PDF** aus einer DOCX‑Datei mit Aspose.Words speichert, **wie man docx zu pdf** mit benutzerdefinierten Optionen konvertiert, und die Auswirkungen von `ExportFloatingShapesAsInlineTag` erklärt. Das vollständige, ausführbare Beispiel zeigt, dass Sie **word document pdf** mit nur wenigen Zeilen konvertieren können, und Sie wissen jetzt, wie Sie **pdf mit Optionen** speichern, die den Qualitäts‑ und Konformitätsanforderungen Ihres Projekts entsprechen. + +Bereit für die nächste Herausforderung? Versuchen Sie, in andere Formate zu exportieren (z. B. HTML, EPUB) mit `document.Save("output.html")` oder experimentieren Sie mit PDF/A‑Konformität für die Langzeitarchivierung. Die gleichen Prinzipien – Laden, Optionen konfigurieren, speichern – gelten überall. + +Viel Spaß beim Coden, und möge Ihr PDF stets exakt so aussehen, wie Sie es beabsichtigt haben! + +![Diagramm, das zeigt, wie eine DOCX‑Datei geladen, Optionen angewendet und ein PDF erzeugt wird – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "Diagramm zum Speichern von PDF") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/german/net/programming-with-shapes/_index.md b/words/german/net/programming-with-shapes/_index.md index 4779b99fc8..648047703a 100644 --- a/words/german/net/programming-with-shapes/_index.md +++ b/words/german/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Mit Aspose.Words für .NET und diesen Tutorials meistern Sie die Bearbeitung von | [Smart Art-Form erkennen](./detect-smart-art-shape/) | Erfahren Sie in diesem umfassenden Leitfaden, wie Sie mit Aspose.Words für .NET SmartArt-Formen in Word-Dokumenten erkennen. Perfekt für die Automatisierung Ihres Dokumenten-Workflows. | | [Smart Art-Zeichnung aktualisieren](./update-smart-art-drawing/) | Erfahren Sie in dieser Schritt-für-Schritt-Anleitung, wie Sie Smart Art-Zeichnungen in Word-Dokumenten mit Aspose.Words für .NET aktualisieren. Stellen Sie sicher, dass Ihre Visualisierungen stets präzise sind. | | [Rechteckform in Word mit Aspose.Words – Schritt-für-Schritt-Anleitung](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Erfahren Sie in diesem Schritt-für-Schritt-Tutorial, wie Sie mit Aspose.Words für .NET ein Rechteck in ein Word-Dokument einfügen und anpassen. | +| [Word-Dokument mit C# erstellen – Form mit Schatten hinzufügen](./create-word-document-c-add-shape-with-shadow/) | Erfahren Sie, wie Sie mit Aspose.Words für .NET in C# einer Word-Datei eine Form mit Schatten hinzufügen. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/german/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/german/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..7b74babb53 --- /dev/null +++ b/words/german/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,204 @@ +--- +category: general +date: 2026-03-27 +description: Erstellen Sie ein Word‑Dokument in C# und lernen Sie, wie Sie eine Form + hinzufügen, einen Schatten auf die Form anwenden und den Schattenabstand festlegen. + Schritt‑für‑Schritt‑Anleitung für Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: de +og_description: Erstelle ein Word‑Dokument in C# mit einer Rechteckform und einem + benutzerdefinierten Schatten. Folge diesem umfassenden Tutorial, um den Schattenabstand + und -stil festzulegen. +og_title: Word-Dokument in C# erstellen – Form mit Schatten hinzufügen +tags: +- Aspose.Words +- C# +- Document Automation +title: Word-Dokument erstellen C# – Form mit Schatten hinzufügen +url: /de/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word-Dokument mit C# erstellen – Form mit Schatten hinzufügen + +Haben Sie schon einmal ein **Word-Dokument mit C# erstellen** müssen, das ein hübsch gestaltetes Rechteck enthält? Vielleicht bauen Sie eine Berichtsvorlage und möchten einen dezenten Drop‑Shadow, um das Layout hervorzuheben. In diesem Tutorial zeigen wir genau das – wie man eine Form hinzufügt, ihr einen Schatten zuweist und sogar den Schattenabstand mit Aspose.Words anpasst. + +Wir beginnen mit einem leeren Dokument, fügen ein Rechteck ein, geben ihm einen voreingestellten Schatten und speichern schließlich die Datei. Am Ende haben Sie ein einsatzbereites .docx, das Sie in Word öffnen und den Effekt sofort sehen können. Keine externen Tools, nur reiner C#‑Code. + +## Voraussetzungen + +- .NET 6 (oder ein aktuelles .NET Framework) installiert. +- Visual Studio 2022 oder VS Code mit C#‑Erweiterung. +- Aspose.Words für .NET NuGet‑Paket (`Aspose.Words` Version 23.12 oder neuer). + Sie können es über die Package Manager Console hinzufügen: + + ```powershell + Install-Package Aspose.Words + ``` + +Das war’s – keine zusätzlichen DLLs oder COM‑Interop erforderlich. + +## Schritt 1: Neues Dokument und Builder initialisieren – Grundlagen zum **Word-Dokument mit C# erstellen** + +Zuerst benötigen wir ein `Document`‑Objekt, das die Word‑Datei repräsentiert, und einen `DocumentBuilder`, um sie zu bearbeiten. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Warum dieser Schritt wichtig ist:** Die `Document`‑Klasse ist der Container für alle Word‑Teile (Seiten, Stile, Bilder). Der Builder ist die High‑Level‑API, die die low‑level Node‑Manipulation abstrahiert und es einfach macht, **Word-Dokument mit C# zu erstellen**, ohne sich direkt mit XML zu befassen. + +## Schritt 2: Rechteck‑Form einfügen – **wie man ein Rechteck erstellt** + +Jetzt platzieren wir ein Rechteck auf der Seite. Die Größe wird in Punkten angegeben (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro‑Tipp:** Wenn Sie eine andere Form benötigen, ersetzen Sie einfach `ShapeType.Rectangle` durch `ShapeType.Ellipse`, `ShapeType.Triangle` usw. Der gleiche Code funktioniert für **wie man eine Form hinzufügt** jeder Art. + +## Schritt 3: Voreingestellten Schatten anwenden und feinjustieren – **Schatten auf Form anwenden** + +Aspose.Words liefert mehrere voreingestellte Schattenformate. Wir verwenden `Preset1` und passen anschließend Abstand, Weichzeichnung, Transparenz und Farbe an. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Warum den Schatten anpassen?** Die Eigenschaft `Distance` steuert, wie weit der Schatten vom Rechteck entfernt liegt – denken Sie an das „Anheben“, das Sie in einer 3‑D‑Darstellung sehen würden. Das Ändern von `BlurRadius` macht die Kanten weicher, während `Transparency` Ihnen ein dezentes, professionelles Aussehen ermöglicht. Damit wird die Anforderung **Schattenabstand festlegen** erfüllt und gezeigt, wie man **Schatten auf Form anwenden** flexibel umsetzt. + +## Schritt 4: Dokument speichern – **Word-Dokument mit C# erstellen** abschließen + +Zum Schluss schreiben wir das Dokument auf die Festplatte. Passen Sie den Pfad an einen Ordner an, in den Sie Schreibrechte haben. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Öffnen Sie die resultierende Datei in Microsoft Word, und Sie sehen ein hellblaues Rechteck mit einem weichen grauen Schatten, der um 5 pt versetzt ist. Das ist der visuelle Beweis, dass Sie erfolgreich **Word-Dokument mit C# erstellt** haben, inklusive einer gestalteten Form. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="Beispiel für Word-Dokument mit C# – Rechteck mit Schatten"} + +## Optionale Varianten & Sonderfälle + +| Szenario | Was zu ändern ist | Warum es wichtig ist | +|----------|-------------------|----------------------| +| **Anderer Schattenstil** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Verleiht ein dramatischeres Aussehen ohne zusätzlichen Code. | +| **Kein Preset – benutzerdefinierter Schatten** | `Format` weglassen und `OffsetX`, `OffsetY` manuell setzen. | Vollständige Kontrolle über Richtung und Tiefe. | +| **Mehrere Formen** | `builder.InsertShape` erneut aufrufen, bevor gespeichert wird. | Nützlich für komplexe Vorlagen mit Icons, Logos usw. | +| **Kompatibilität mit älteren Aspose‑Versionen** | `ShadowEffect`‑Klasse verwenden (verfügbar in v20.x). | Stellt sicher, dass Ihr Code in Legacy‑Projekten läuft. | +| **Als PDF speichern** | `document.Save("ShadowShape.pdf");` | Der gleiche Schatten wird im PDF‑Export dargestellt. | + +> **Häufige Frage:** *Was tun, wenn der Schatten in Word nicht erscheint?* +> Stellen Sie sicher, dass Sie eine aktuelle Version von Aspose.Words (≥ 22.9) verwenden. Ältere Releases hatten nur eingeschränkte Schattenunterstützung. Prüfen Sie außerdem, dass das Dokument in einer aktuellen Word‑Version (2016 +) geöffnet wird. + +## Vollständiges funktionierendes Beispiel + +Unten finden Sie das komplette, sofort einsetzbare Programm. Es enthält alle `using`‑Direktiven, Kommentare und Fehlerbehandlung für ein reibungsloses Erlebnis. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Führen Sie das Programm aus, navigieren Sie zu `C:\Temp\ShadowShape.docx`, und Sie sehen das Rechteck mit dem exakt konfigurierten Schatten. + +## Zusammenfassung & nächste Schritte + +- Sie wissen jetzt, wie man **Word-Dokument mit C# erstellt**, ein Rechteck einfügt und **Schatten auf Form anwendet** mit einem benutzerdefinierten **Schattenabstand festlegt**. +- Das Beispiel nutzt Aspose.Words, das die OpenXML‑Komplexität abstrahiert und ein konsistentes Rendering über verschiedene Word‑Versionen hinweg garantiert. +- Möchten Sie weitergehen? Kombinieren Sie mehrere Formen, fügen Sie Text in das Rechteck ein oder exportieren Sie dasselbe Dokument als PDF, um zu sehen, wie der Schatten übertragen wird. + +### Verwandte Themen, die Sie erkunden könnten + +- **Wie man eine Form** in Kopf‑/Fußzeilen für Branding hinzufügt. +- Verwendung von **Aspose.Words**, um Diagramme und Tabellen programmgesteuert einzufügen. +- Anpassung von **Schatteneinstellungen** bei Bildern statt Vektorformen. +- Automatisierung der Massenerstellung von Dokumenten für Rechnungen oder Zertifikate. + +Experimentieren Sie, brechen Sie den Code und bauen Sie ihn dann wieder zusammen – das ist der schnellste Weg, die Konzepte zu verinnerlichen. Wenn Sie auf ein Problem stoßen, hinterlassen Sie einen Kommentar unten oder schauen Sie in die offizielle Aspose.Words‑Dokumentation für tiefere API‑Einblicke. + +Viel Spaß beim Coden und beim Veredeln Ihrer Word‑Dateien! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/german/net/programming-with-txtsaveoptions/_index.md b/words/german/net/programming-with-txtsaveoptions/_index.md index ff26c12810..8b456f8d81 100644 --- a/words/german/net/programming-with-txtsaveoptions/_index.md +++ b/words/german/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Dank dieser Tutorials können Sie die Funktionalitäten von Aspose.Words für .N | [Bidi-Markierungen in Word-Dokumente einfügen](./add-bidi-marks/) | Erfahren Sie in dieser Anleitung, wie Sie mit Aspose.Words für .NET bidirektionale (Bidi) Markierungen in Word-Dokumenten hinzufügen. Stellen Sie die korrekte Textrichtung für mehrsprachige Inhalte sicher. | | [Tabulatorzeichen pro Ebene für Listeneinrückung verwenden](./use-tab-character-per-level-for-list-indentation/) | Erfahren Sie, wie Sie mit Aspose.Words für .NET mehrstufige Listen mit Tabulatoreinrückung erstellen. Folgen Sie dieser Anleitung für eine präzise Listenformatierung in Ihren Dokumenten. | | [Leerzeichen pro Ebene für Listeneinrückung verwenden](./use-space-character-per-level-for-list-indentation/) | Erfahren Sie, wie Sie in Aspose.Words für .NET mehrstufige Listen mit Leerzeicheneinrückung erstellen. Schritt-für-Schritt-Anleitung zur präzisen Dokumentformatierung. | - +| [DOCX als TXT speichern – Vollständige Anleitung zum Exportieren von Word-Gleichungen nach LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Erfahren Sie, wie Sie DOCX-Dateien als TXT exportieren und dabei Word-Gleichungen in LaTeX-Formeln umwandeln. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/german/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/german/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..947588b51a --- /dev/null +++ b/words/german/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-03-27 +description: Speichern Sie docx als txt mit Aspose.Words und konvertieren Sie Word + zu LaTeX. Erfahren Sie, wie Sie Gleichungen exportieren, reinen Text beibehalten + und in wenigen Minuten LaTeX‑Markup erhalten. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: de +og_description: Speichern Sie docx als txt mit Aspose.Words. Dieser Leitfaden zeigt, + wie Sie Word in LaTeX konvertieren, Gleichungen exportieren und Ihr Dokument im + Klartext behalten. +og_title: docx als txt speichern – Word‑Formeln nach LaTeX exportieren +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: DOCX als TXT speichern – Vollständige Anleitung zum Exportieren von Word‑Gleichungen + nach LaTeX +url: /de/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# DOCX als TXT speichern – Word‑Gleichungen nach LaTeX exportieren + +Haben Sie schon einmal **docx als txt** speichern wollen, aber befürchtet, dass die schicken Formeln im Word‑Dokument verloren gehen? Sie sind nicht allein. In vielen wissenschaftlichen Workflows ist die Nur‑Text‑Version eines Dokuments ein Muss, doch die Gleichungen sollen als sauberes LaTeX‑Markup erhalten bleiben. + +In diesem Tutorial führen wir Sie Schritt für Schritt durch die genauen Vorgänge, um **Word nach LaTeX** mit Aspose.Words für .NET zu **konvertieren**, sodass Ihre Gleichungen korrekt exportiert werden, während der Rest des Dokuments zu ordentlichem Nur‑Text wird. Am Ende wissen Sie, wie Sie **Gleichungen nach LaTeX exportieren**, den Rest der Datei als einfachen Text behalten und die üblichen Stolperfallen vermeiden, in die Neulinge geraten. + +## Was Sie lernen werden + +- Wie man eine *.docx*-Datei lädt, die Office‑Math enthält. +- Wie man die richtigen `TxtSaveOptions` einstellt, damit Aspose für jede Gleichung LaTeX ausgibt. +- Wie man das Ergebnis als **save word plain text**‑Datei speichert, die Sie in Versions‑Control, CI‑Pipelines oder jedes nachgelagerte Tool einbinden können. +- Typische Randfälle – was zu tun ist, wenn ein Dokument Bilder und Gleichungen mischt oder wenn Unicode‑Zeichen erhalten bleiben müssen. +- Ein vollständiges, sofort ausführbares Code‑Beispiel, das Sie in eine Konsolen‑App einfügen können. + +### Voraussetzungen + +- .NET 6.0 oder höher (der Code funktioniert auch mit .NET Framework 4.7+). +- Eine lizenzierte Kopie von **Aspose.Words für .NET** (die kostenlose Testversion reicht für Tests). +- Visual Studio 2022 oder jede IDE, die C#‑Projekte kompilieren kann. +- Ein Word‑Dokument (`input.docx`), das bereits einige Office‑Math‑Objekte enthält. + +> **Pro‑Tipp:** Wenn Sie noch keine Lizenz haben, können Sie einen temporären Schlüssel von Asposes Website anfordern – ersetzen Sie einfach den Platzhalter im Code durch Ihren Schlüssel, bevor Sie das Programm starten. + +## Schritt 1 – Aspose.Words via NuGet installieren + +Erstmal: Sie benötigen die Bibliothek in Ihrem Projekt. Öffnen Sie die **Package Manager Console** und führen Sie aus: + +```powershell +Install-Package Aspose.Words +``` + +Diese eine Zeile holt alles, was Sie brauchen, inklusive des `Saving`‑Namespaces, in dem `TxtSaveOptions` lebt. Keine zusätzlichen DLLs, keine nativen Abhängigkeiten – nur reiner Managed‑Code. + +## Schritt 2 – Das Quell‑Word‑Dokument laden + +Jetzt lesen wir tatsächlich die Datei, die die Gleichungen enthält. Die Klasse `Document` abstrahiert die gesamte *.docx*-Struktur, sodass Sie sie wie ein hoch‑level Objektmodell behandeln können. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Warum das wichtig ist:** Das frühe Laden des Dokuments erlaubt Ihnen, den Knoten‑Baum zu inspizieren. Wenn Sie die Prüfung überspringen und die Datei keine Gleichungen enthält, erhalten Sie trotzdem eine saubere txt‑Datei – Sie wissen jedoch nicht, warum die LaTeX‑Ausgabe leer ist. + +## Schritt 3 – TxtSaveOptions für den LaTeX‑Export konfigurieren + +Aspose gibt Ihnen feinkörnige Kontrolle darüber, wie Office‑Math gerendert wird. Durch Setzen von `OfficeMathExportMode` auf `LaTeX` wird jede Gleichung in das LaTeX‑Äquivalent umgewandelt, anstatt entfernt oder in ein Bild umgewandelt zu werden. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Warum das wichtig ist:** Der Standard‑Exportmodus würde die Gleichungen komplett weglassen. Das Umschalten auf `LaTeX` bewahrt die mathematische Intention – genau das, was Sie benötigen, wenn Sie die Datei später in einen LaTeX‑Compiler oder einen Markdown‑Prozessor mit `$…$`‑Syntax einspeisen. + +## Schritt 4 – Das Dokument als Nur‑Text speichern + +Mit den konfigurierten Optionen ist das Persistieren der Datei ein Einzeiler. Die Ausgabe ist eine `.txt`‑Datei, in der jede Gleichung als LaTeX‑Code von `$`‑Delimiter umschlossen erscheint (Sie können das später ändern, falls Sie lieber `\[` … `\]`‑Blöcke bevorzugen). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Erwartetes Ergebnis + +Öffnen Sie `output.txt` in einem beliebigen Editor – Sie sehen etwa Folgendes: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Beachten Sie, dass der normale Text exakt unverändert bleibt, während die Gleichungen nun reine LaTeX‑Strings sind. Sie können diese direkt in ein LaTeX‑Dokument, ein Jupyter‑Notebook oder jedes Tool, das Mathematik rendert, einfügen. + +## Schritt 5 – Randfälle behandeln + +### Gemischter Inhalt (Bilder + Gleichungen) + +Enthält Ihre Word‑Datei auch Bilder, ignoriert Aspose diese, wenn Sie `TxtSaveOptions` verwenden. Das ist für einen **save word plain text**‑Workflow meist in Ordnung, aber falls Sie die Bilder als Platzhalter benötigen, können Sie: + +1. Das Dokument zuerst nach HTML exportieren (`HtmlSaveOptions`), um Bilder als ``‑Tags zu erhalten. +2. Einen zweiten Durchlauf mit `TxtSaveOptions` ausführen, um die LaTeX‑Gleichungen zu bekommen. +3. Die beiden Ergebnisse manuell oder mit einem kleinen Skript zusammenführen. + +### Unicode‑Symbole + +Einige Gleichungen benutzen spezielle Unicode‑Zeichen (z. B. griechische Buchstaben). Das Setzen von `Encoding = Encoding.UTF8` in `TxtSaveOptions` (wie in Schritt 3 gezeigt) stellt sicher, dass diese Symbole die Konvertierung überleben. + +### Große Dokumente + +Bei massiven Dateien (> 100 MB) sollten Sie das Speichern streamen: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Streaming verhindert, dass die gesamte Ausgabe gleichzeitig im Speicher liegt – ein echter Lebensretter auf Build‑Agents mit wenig RAM. + +## Vollständiges Beispiel + +Unten finden Sie das komplette, copy‑paste‑bereite Programm, das alles zusammenführt. Ersetzen Sie lediglich die Dateipfade und, falls vorhanden, die Lizenz‑Zeile. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Führen Sie das Programm aus (`dotnet run`, wenn Sie ein Konsolen‑Projekt nutzen) und prüfen Sie `output.txt`. Sie haben gerade **docx als txt** gespeichert und dabei jede Gleichung als LaTeX erhalten – ohne manuelles Kopieren und Einfügen. + +## Häufig gestellte Fragen + +**F: Kann ich den Delimiter von `$…$` zu `\(...\)` ändern?** +A: Ja. Nach dem Speichern führen Sie einen einfachen Ersetz‑Vorgang aus: `output = output.Replace("$", @"\(").Replace("$", @"\)");` – achten Sie nur darauf, nicht die ursprünglichen `$`‑Zeichen im Text zu ersetzen. + +**F: Funktioniert das mit Word‑Dateien von 2007‑2019?** +A: Absolut. Aspose.Words unterstützt `.doc`, `.docx`, `.docm` und sogar die neueren `.dotx`‑Familien. Der gleiche Code funktioniert über alle Versionen hinweg. + +**F: Was, wenn ich die ursprüngliche Absatz‑Formatierung (Tabs, mehrere Leerzeichen) erhalten möchte?** +A: Setzen Sie `txtSaveOptions.PreserveTableLayout = true;` und `txtSaveOptions.PreserveSpace = true;`, um Whitespace unverändert zu lassen. + +## Fazit + +Wir haben alles behandelt, was Sie benötigen, um **docx als txt** zu speichern und gleichzeitig **Gleichungen nach LaTeX** zu exportieren – mit Aspose.Words. Die entscheidenden Schritte sind: Dokument laden, `TxtSaveOptions` mit `OfficeMathExportMode.LaTeX` konfigurieren und das Ergebnis speichern. Mit diesen drei Code‑Zeilen können Sie zuverlässig **word to latex** konvertieren, Ihr Dokument als **save word plain text** behalten und den gefürchteten Verlust von mathematischen Symbolen vermeiden. + +Bereit für die nächste Herausforderung? Kombinieren Sie diesen Workflow mit einem Markdown‑Generator, um eine vollständige `.md`‑Datei zu erzeugen, die sowohl Text als auch LaTeX enthält – perfekt für Git‑basierte Dokumentation oder Static‑Site‑Generatoren. Oder erkunden Sie Asposes `PdfSaveOptions`, um parallel eine PDF‑Version zu erhalten. + +Wenn Sie auf Probleme stoßen, hinterlassen Sie einen Kommentar unten. Viel Spaß beim Coden und genießen Sie die Einfachheit, Word‑Gleichungen in sauberes LaTeX zu verwandeln! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/german/net/working-with-fonts/_index.md b/words/german/net/working-with-fonts/_index.md index f87fa7a1b5..b64cfc03de 100644 --- a/words/german/net/working-with-fonts/_index.md +++ b/words/german/net/working-with-fonts/_index.md @@ -32,6 +32,7 @@ Egal, ob Sie Text mit unterschiedlichen Schriftarten formatieren, Regeln für di | [Hervorhebungszeichen für die Schriftart festlegen](./set-font-emphasis-mark/) | Erfahren Sie in dieser detaillierten Schritt-für-Schritt-Anleitung, wie Sie mit Aspose.Words für .NET Hervorhebungen in Word-Dokumenten setzen. Perfekt für .NET-Entwickler. | | [Schriftartenordner festlegen](./set-fonts-folders/) | Erfahren Sie in dieser umfassenden Schritt-für-Schritt-Anleitung, wie Sie benutzerdefinierte Schriftartenordner in Aspose.Words für .NET einrichten. Ideal für Entwickler, die Dokumentschriftarten verbessern möchten. | | [Aktivieren/Deaktivieren der Schriftartenersetzung](./enable-disable-font-substitution/) | Erfahren Sie, wie Sie die Schriftartenersetzung in Word-Dokumenten mit Aspose.Words für .NET aktivieren oder deaktivieren. Stellen Sie sicher, dass Ihre Dokumente auf allen Plattformen einheitlich aussehen. | +| [Aspose-Schriftartenersetzung – So konfigurieren Sie Schriftarteinstellungen in C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Erfahren Sie, wie Sie mit Aspose.Words für .NET die Schriftartenersetzung konfigurieren und Schriftarteinstellungen in C# festlegen. | | [Festlegen der Fallback-Einstellungen für Schriftarten](./set-font-fallback-settings/) | Erfahren Sie, wie Sie Schriftartenersetzungseinstellungen in Aspose.Words für .NET festlegen und die Schriftartenersetzung in Ihren Word-Dokumenten anpassen. | | [Noto-Fallback-Einstellungen laden](./load-noto-fallback-settings/) | Erfahren Sie, wie Sie Noto-Fallback-Einstellungen mit Aspose.Words für .NET in ein Word-Dokument laden. Folgen Sie unserer Schritt-für-Schritt-Anleitung, um sicherzustellen, dass alle Zeichen korrekt angezeigt werden. | | [Standardinstanz für Schriftartenordner festlegen](./set-fonts-folders-default-instance/) | Erfahren Sie in diesem Schritt-für-Schritt-Tutorial, wie Sie Schriftartenordner für die Standardinstanz in Aspose.Words für .NET festlegen. Passen Sie Ihre Word-Dokumente mühelos an. | diff --git a/words/german/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/german/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..cd5b5399c1 --- /dev/null +++ b/words/german/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,252 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose-Schriftartenersetzung leicht gemacht: Erfahren Sie, wie Sie Schriftarteinstellungen + konfigurieren, Warnungen erfassen und fehlende Schriftarten in Ihren .NET-Anwendungen + behandeln.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: de +og_description: Meistern Sie die Aspose-Schriftart-Substitution, indem Sie die Schriftarteinstellungen + konfigurieren und fehlende Schriftarten mit einem Warn‑Callback behandeln. Vollständige + C#‑Anleitung. +og_title: Aspose-Schriftart-Substitution – Schriftarteinstellungen in C# konfigurieren +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose-Schriftartenersetzung – So konfigurieren Sie Schriftarteinstellungen + in C# +url: /de/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Vollständige Anleitung zum Konfigurieren von Schriftarteinstellungen + +Haben Sie schon einmal ein Dokument gehabt, das plötzlich Ihre benutzerdefinierte Schriftart durch etwas Generisches ersetzt? Das ist **aspose font substitution**, das seine Arbeit tut — fehlende Schriftarten durch die am besten passende ersetzt. Das ist praktisch, aber wenn Sie *genau* wissen müssen, welche Schriftart ausgetauscht wurde, müssen Sie das Warnsystem der Bibliothek nutzen und die Schriftarteinstellungen selbst konfigurieren. + +In diesem Tutorial führen wir Sie durch ein praxisnahes Szenario: Laden einer DOCX‑Datei, die eine Schriftart referenziert, die Sie nicht besitzen, das Erfassung des Substitutions‑Ereignisses und das Ausgeben einer freundlichen Meldung in der Konsole. Am Ende sind Sie sicher im **configure font settings**, beim Einrichten eines **Aspose.Words warning callback** und beim Anpassen des Beispiels an jeden Workflow. + +> **Was Sie benötigen** +> • .NET 6+ (oder .NET Framework 4.7.2+) +> • Aspose.Words für .NET (neueste NuGet) +> • Eine DOCX, die eine fehlende Schriftart referenziert (wir nennen sie `MissingFont.docx`) + +Lassen Sie uns loslegen. + +--- + +## Schritt 1: Aspose.Words installieren und das Projekt vorbereiten + +Bevor wir Code schreiben, stellen Sie sicher, dass das Aspose.Words‑Paket referenziert wird: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro‑Tipp:** Verwenden Sie die neueste stabile Version; Stand März 2026 ist das 23.11.0. Neuere Releases verbessern die Schriftart‑Matching‑Algorithmen und fügen zusätzliche Warnungsarten hinzu. + +Erstellen Sie eine neue Konsolen‑App (oder fügen Sie den Code in ein bestehendes Projekt ein) und fügen Sie die üblichen `using`‑Direktiven hinzu: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Diese Namespaces geben uns Zugriff auf `Document`, `LoadOptions` und die font‑bezogenen Klassen, die wir benötigen. + +--- + +## Schritt 2: Schriftarteinstellungen mit LoadOptions konfigurieren + +Das Herz der **aspose font substitution**‑Steuerung befindet sich in `LoadOptions.FontSettings`. Indem wir ein leeres `FontSettings`‑Objekt übergeben, sagen wir Aspose, dass es seine Standardsuchpfade verwenden und jede Substitution über einen Warn‑Callback melden soll. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Warum nicht einfach die Vorgaben nutzen? Weil das Anbinden eines Warn‑Callbacks (nächster Schritt) nur funktioniert, wenn die Eigenschaft `FontSettings` nicht null ist. Diese kleine Zeile gibt uns einen Hook in den Substitutions‑Prozess, ohne das eigentliche Suchverhalten zu ändern. + +--- + +## Schritt 3: Einen Warn‑Callback anhängen, um Substitutionen zu erfassen + +Aspose.Words implementiert das Interface `IWarningCallback`. Immer wenn etwas Bemerkenswertes passiert — wie eine fehlende Schriftart — ruft es unsere `Warning`‑Methode auf. Wir implementieren einen kleinen Handler, der nach `WarningType.FontSubstitution` filtert und die Beschreibung ausgibt. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +Und hier ist der eigentliche Handler: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Warum das wichtig ist** – Ohne den Callback tauscht Aspose Schriftarten stillschweigend aus, und Sie wissen nie, welche verwendet wurde. Der Callback macht den Prozess transparent, was für Compliance‑Berichte oder das Debuggen von Layout‑Problemen unerlässlich ist. + +--- + +## Schritt 4: Das Dokument mit den konfigurierten Optionen laden + +Jetzt laden wir das Dokument und übergeben die zuvor vorbereiteten `loadOptions`. Wenn die Quelldatei eine Schriftart referenziert, die nicht installiert ist, wird unser Handler ausgelöst. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Ersetzen Sie `YOUR_DIRECTORY` durch den tatsächlichen Pfad, in dem `MissingFont.docx` liegt. Beim Ausführen des Programms sollten Sie eine Ausgabe ähnlich der folgenden sehen: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Diese Zeile sagt Ihnen exakt, welche Schriftart fehlte und welche Ersatzschrift Aspose gewählt hat. + +--- + +## Schritt 5: (Optional) Schriftsuchpfade feinabstimmen + +Falls Sie einen privaten Ordner mit Unternehmensschriftarten haben, können Sie Aspose mitteilen, dort zuerst zu suchen, bevor auf Systemschriftarten zurückgegriffen wird. Das ist eine erweiterte Anwendung von **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Durch `recursive: true` wird Aspose auch Unterordner durchsuchen. Jetzt versucht die Bibliothek zuerst Ihre privaten Schriftarten, wodurch die Wahrscheinlichkeit unerwünschter Substitutionen sinkt. + +--- + +## Vollständiges funktionsfähiges Beispiel + +Alles zusammengeführt, hier das komplette, sofort ausführbare Programm: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Erwartete Ausgabe** (wenn eine fehlende Schriftart gefunden wird): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Sind alle Schriftarten vorhanden, läuft das Programm still (keine Warnungen) und erzeugt dennoch das PDF. + +--- + +## Häufige Fragen & Sonderfälle + +### Was tun, wenn ich die Substitution komplett *verhindern* möchte? + +Setzen Sie `FontSettings.SubstitutionSettings` auf `null` oder verwenden Sie `FontSettings.FontSubstitutionSettings`, um das Verhalten zu steuern. Beispiel: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Jetzt wirft Aspose eine Ausnahme, anstatt stillschweigend zu substituieren, die Sie abfangen und behandeln können. + +### Funktioniert das mit anderen Dateiformaten (z. B. .doc, .rtf)? + +Absolut. Das gleiche `LoadOptions`‑Objekt kann an jeden `Document`‑Konstruktor übergeben werden, der einen Dateipfad akzeptiert. Der Warn‑Callback wird für alle Formate ausgelöst, die Schriftarten verwenden. + +### Kann ich den *genauen* Namen der Ersatzschrift erfassen? + +Ja. Der String `info.Description` enthält sowohl die fehlende Schriftart als auch die Ersatzschrift. Wenn Sie den Namen programmgesteuert benötigen, können Sie ihn parsen oder das `FontInfo`‑Objekt verwenden (verfügbar in neueren Versionen). + +### Wie verhält sich das in einer Multi‑Thread‑Umgebung? + +`FontSettings` ist **nicht** thread‑sicher. Erzeugen Sie pro Thread ein separates `LoadOptions` (mit eigenem `FontSettings`) oder schützen Sie den Zugriff mit einem Lock. + +--- + +## Fazit + +Wir haben alles behandelt, was Sie benötigen, um **aspose font substitution** und **configure font settings** in einer C#‑Anwendung zu meistern: + +1. Aspose.Words installieren und die notwendigen `using`‑Anweisungen hinzufügen. +2. Ein `LoadOptions`‑Objekt mit einem frischen `FontSettings` erstellen. +3. Einen benutzerdefinierten `IWarningCallback` anhängen, um Substitutions‑Ereignisse sichtbar zu machen. +4. Das Dokument laden und den Callback fehlende Schriftarten melden lassen. +5. (Optional) Den Suchpfad erweitern oder die Substitution komplett deaktivieren. + +Mit diesem Muster können Sie fehlende Schriftarten für Compliance protokollieren, Benutzer in einer UI benachrichtigen oder automatisch Ersatzschriftarten einbetten, bevor Sie veröffentlichen. Als nächstes könnten Sie **Aspose.Words font substitution policies** erkunden oder den Workflow in eine größere Dokumenten‑Verarbeitungspipeline integrieren. + +Viel Spaß beim Coden und mögen Ihre Dokumente stets mit der richtigen Schriftart gerendert werden! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/greek/net/basic-conversions/_index.md b/words/greek/net/basic-conversions/_index.md index b8bb182fcb..93bd2000a5 100644 --- a/words/greek/net/basic-conversions/_index.md +++ b/words/greek/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ | [Πώς να εξάγετε LaTeX από το Word – Οδηγός βήμα‑βήμα](./how-to-export-latex-from-word-step-by-step-guide/) | Μάθετε πώς να εξάγετε έγγραφα Word σε μορφή LaTeX χρησιμοποιώντας το Aspose.Words για .NET με βήμα‑βήμα οδηγίες. | | [Μετατροπή Word σε PDF σε C# χρησιμοποιώντας το Aspose.Words – Οδηγός](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Μάθετε πώς να μετατρέπετε αρχεία Word σε PDF χρησιμοποιώντας το Aspose.Words για .NET σε C# με οδηγίες βήμα‑βήμα. | | [Αποθήκευση Word ως PDF με Aspose.Words – Πλήρης Οδηγός C#](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Μάθετε πώς να αποθηκεύετε έγγραφα Word ως PDF χρησιμοποιώντας το Aspose.Words σε C# με πλήρη οδηγό βήμα‑βήμα. | +| [Μετατροπή Word σε PDF με Aspose.Words – Πλήρης Οδηγός](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Μάθετε πώς να μετατρέψετε έγγραφα Word σε PDF με το Aspose.Words σε πλήρη βήμα‑βήμα οδηγό. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/greek/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/greek/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..8a17dcd0b8 --- /dev/null +++ b/words/greek/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,245 @@ +--- +category: general +date: 2026-03-27 +description: Μετατρέψτε το Word σε PDF γρήγορα με το Aspose.Words. Μάθετε πώς να αποθηκεύετε + το Word ως PDF, να εξάγετε το docx σε PDF και να δημιουργείτε προσβάσιμο PDF σε + C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: el +og_description: Μετατρέψτε το Word σε PDF σε C# χρησιμοποιώντας το Aspose.Words. Αυτός + ο οδηγός δείχνει πώς να αποθηκεύσετε το Word ως PDF, να εξάγετε το docx σε PDF και + να δημιουργήσετε προσβάσιμο PDF. +og_title: Μετατροπή Word σε PDF με το Aspose.Words – Βήμα προς βήμα +tags: +- Aspose.Words +- C# +- PDF conversion +title: Μετατροπή Word σε PDF με το Aspose.Words – Πλήρης Οδηγός +url: /el/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Μετατροπή Word σε PDF με Aspose.Words – Πλήρης Οδηγός + +Έχετε αναρωτηθεί ποτέ πώς να **convert Word to PDF** χωρίς να παίζετε με εργαλεία τρίτων στο διαδίκτυο; Ίσως να δημιουργείτε μια αυτοματοποιημένη μηχανή αναφορών και χρειάζεστε έναν αξιόπιστο τρόπο να *save word as pdf* άμεσα. Τα καλά νέα είναι ότι το Aspose.Words κάνει όλη τη διαδικασία παιχνιδάκι, και μπορείτε ακόμη να δημιουργήσετε ένα αρχείο συμβατό με **PDF/UA‑2** — ιδανικό για απαιτήσεις προσβασιμότητας. + +Σε αυτό το tutorial θα περάσουμε από όλα όσα χρειάζεστε: τη φόρτωση ενός `.docx`, τη ρύθμιση των επιλογών PDF ώστε να μπορείτε να *export docx to pdf* με συμμόρφωση PDF/UA, και τέλος την αποθήκευση του αποτελέσματος ως προσβάσιμο PDF. Στο τέλος θα έχετε ένα αυτόνομο, έτοιμο για παραγωγή snippet που μπορείτε να ενσωματώσετε σε οποιοδήποτε .NET project. + +![Μετατροπή Word σε PDF χρησιμοποιώντας Aspose.Words](convert-word-to-pdf.png) + +## Τι θα μάθετε + +- **Why Aspose.Words** είναι μια αξιόπιστη επιλογή για σενάρια *generate accessible pdf*. +- Τα ακριβή βήματα για *save document as pdf* με συμμόρφωση PDF/UA‑2. +- Πώς να αντιμετωπίσετε κοινές περιπτώσεις όπως ελλιπείς γραμματοσειρές ή αρχεία πηγής προστατευμένα με κωδικό. +- Γρήγορες συμβουλές για εντοπισμό σφαλμάτων στην έξοδο και επαλήθευση της συμμόρφωσης προσβασιμότητας. + +### Προαπαιτούμενα + +- .NET 6 ή νεότερο (το API λειτουργεί επίσης σε .NET Framework 4.6+). +- Ένα έγκυρο license Aspose.Words for .NET (η δωρεάν δοκιμή λειτουργεί για αξιολόγηση). +- Βασικές γνώσεις C# — δεν απαιτούνται περίπλοκα patterns. + +Αν έχετε τσεκάρει αυτά τα κουτάκια, ας βουτήξουμε. + +## Μετατροπή Word σε PDF – Υλοποίηση βήμα‑βήμα + +Θα χωρίσουμε τη λύση σε πέντε σαφή βήματα. Κάθε βήμα έχει έναν τίτλο, ένα σύντομο απόσπασμα κώδικα και μια εξήγηση του *why* του κώδικα. + +### Βήμα 1: Φορτώστε το Word έγγραφο που θέλετε να μετατρέψετε + +Το πρώτο πράγμα που χρειάζεστε είναι ένα αντικείμενο `Document` που αντιπροσωπεύει το αρχείο προέλευσης. Το Aspose.Words διαβάζει **.docx**, **.doc**, **.rtf**, και πολλές άλλες μορφές, ώστε να μπορείτε να *save word as pdf* ανεξάρτητα από το πώς δημιουργήθηκε αρχικά το αρχείο. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Γιατί αυτό είναι σημαντικό:** +- Η προημεροληπτική φόρτωση του αρχείου σας επιτρέπει να εντοπίσετε σφάλματα έλλειψης αρχείου πριν σπαταλήσετε κύκλους CPU. +- Η κλάση `Document` αφαιρεί την εσωτερική δομή ενός αρχείου Word, παρέχοντάς σας ένα καθαρό μοντέλο αντικειμένων για εργασία. + +### Βήμα 2: Ρυθμίστε τις επιλογές αποθήκευσης PDF για προσβασιμότητα + +Αν χρειάζεστε αρχεία *generate accessible pdf*, πρέπει να πείτε στο Aspose.Words να δημιουργήσει ένα έγγραφο συμβατό με PDF/UA‑2. Η κλάση `PdfSaveOptions` σας δίνει λεπτομερή έλεγχο της εξόδου. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Γιατί αυτό είναι σημαντικό:** +- `PdfCompliance.PdfUa2` ενημερώνει τη βιβλιοθήκη να προσθέσει τις απαραίτητες ετικέτες, πληροφορίες δομής και μεταδεδομένα που εξαρτώνται από τα screen‑readers. +- Η ενσωμάτωση γραμματοσειρών (`EmbedFullFonts = true`) αποτρέπει τις ενοχλητικές προειδοποιήσεις “font not found” όταν το PDF ανοίγει σε διαφορετικό λειτουργικό σύστημα. +- Ο ορισμός ενός `Title` βοηθά τις βοηθητικές τεχνολογίες να αναγγέλλουν σωστά το έγγραφο. + +### Βήμα 3: Αποθηκεύστε το έγγραφο ως PDF + +Τώρα που το αρχείο προέλευσης είναι φορτωμένο και οι επιλογές έχουν οριστεί, η πραγματική μετατροπή είναι μια εντολή μίας γραμμής. Εδώ είναι που *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Γιατί αυτό είναι σημαντικό:** +- Η μέθοδος `Save` σέβεται τις `PdfSaveOptions` που διαμορφώσαμε, εξασφαλίζοντας ότι τα χαρακτηριστικά προσβασιμότητας είναι ενσωματωμένα. +- Η περιτύλιξη της κλήσης σε μπλοκ `try/catch` σας δίνει την ευκαιρία να καταγράψετε ή να εμφανίσετε τυχόν σφάλματα αδειοδότησης ή δικαιωμάτων που συχνά αποθαρρύνουν τους νέους χρήστες. + +### Βήμα 4: Επαληθεύστε τη συμμόρφωση PDF/UA (Προαιρετικό αλλά Συνιστώμενο) + +Ακόμη και αν το Aspose.Words κάνει το σκληρό έργο, είναι καλή πρακτική να ελέγχετε ξανά την έξοδο, ειδικά όταν παραδίδετε έγγραφα σε κυβερνητικούς οργανισμούς ή άλλους ρυθμιζόμενους φορείς. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Γιατί αυτό είναι σημαντικό:** +- `IsTagged` είναι ένας γρήγορος έλεγχος λογικής· η πλήρης επικύρωση PDF/UA απαιτεί ειδικό validator, αλλά τα περισσότερα προβλήματα συμμόρφωσης εμφανίζονται ως ελλιπείς ετικέτες. +- Αν η σημαία επιστρέψει `false`, μπορείτε να επανεξετάσετε τις `PdfSaveOptions` — ίσως ξεχάσατε να ορίσετε το `Compliance` ή το έγγραφο προέλευσης δεν είχε σωστές μορφές επικεφαλίδων. + +### Βήμα 5: Συνηθισμένα προβλήματα & Pro Tips + +| Πρόβλημα | Τι Συμβαίνει | Πώς να Διορθώσετε | +|----------|--------------|-------------------| +| **Missing fonts** | Το κείμενο εμφανίζεται ως κουτιά στο PDF. | Ορίστε `EmbedFullFonts = true` **ή** εγκαταστήστε τις ελλιπείς γραμματοσειρές στον διακομιστή. | +| **Unlicensed library** | Το Aspose προσθέτει υδατογράφημα σε κάθε σελίδα. | Προσθέστε το αρχείο άδειας (`Aspose.Words.lic`) νωρίς στην εφαρμογή (π.χ., `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Password‑protected source** | `InvalidOperationException` στο `new Document(path)`. | Χρησιμοποιήστε την υπερφόρτωση `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Large documents cause OOM** | Εξαίρεση Out‑of‑memory σε τεράστια αρχεία. | Ενεργοποιήστε το `MemoryOptimization` στις `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Accessibility tags missing** | Η επικύρωση PDF/UA αποτυγχάνει. | Βεβαιωθείτε ότι το αρχείο Word προέλευσης χρησιμοποιεί σωστές μορφές επικεφαλίδων (`Heading 1`, `Heading 2`, κλπ.) — το Aspose τις αντιστοιχίζει αυτόματα σε ετικέτες PDF. | + +**Pro tip:** Αν μετατρέπετε πολλά έγγραφα σε batch, επαναχρησιμοποιήστε ένα μόνο αντικείμενο `PdfSaveOptions`. Η δημιουργία του μία φορά μειώνει το κόστος κατανομής και διατηρεί το αποτύπωμα μνήμης χαμηλό. + +## Πλήρες Παράδειγμα Εργασίας (Έτοιμο για Αντιγραφή‑Επικόλληση) + +Παρακάτω είναι το πλήρες πρόγραμμα που συνδυάζει όλα. Αποθηκεύστε το ως `Program.cs`, προσθέστε τα πακέτα NuGet Aspose.Words και Aspose.PDF, και εκτελέστε. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Αναμενόμενο αποτέλεσμα:** +Ένα αρχείο με όνομα `output.pdf` εμφανίζεται στο `C:\MyFiles`. Ανοίγοντάς το στο Adobe Acrobat θα δείτε “PDF/A‑2b, PDF/UA‑1” στον πίνακα συμμόρφωσης, επιβεβαιώνοντας ότι έχετε μετατρέψει επιτυχώς *convert word to pdf* + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/greek/net/programming-with-markdownsaveoptions/_index.md b/words/greek/net/programming-with-markdownsaveoptions/_index.md index 4d29db5c00..e607d42fda 100644 --- a/words/greek/net/programming-with-markdownsaveoptions/_index.md +++ b/words/greek/net/programming-with-markdownsaveoptions/_index.md @@ -34,6 +34,9 @@ | [Πώς να αποθηκεύσετε Markdown από DOCX – Οδηγός βήμα‑βήμα](./how-to-save-markdown-from-docx-step-by-step-guide/) | Μάθετε πώς να αποθηκεύσετε αρχεία DOCX ως Markdown με οδηγίες βήμα‑βήμα χρησιμοποιώντας Aspose.Words για .NET. | | [Πώς να εξάγετε Markdown από το Word – Πλήρης οδηγός C#](./how-to-export-markdown-from-word-complete-c-guide/) | Μάθετε πώς να εξάγετε έγγραφα Word σε μορφή Markdown με πλήρη οδηγό C# χρησιμοποιώντας Aspose.Words. | | [Πώς να αποθηκεύσετε Markdown από DOCX – Οδηγός βήμα‑βήμα](./how-to-save-markdown-from-docx-step-by-step-guide/) | Μάθετε πώς να αποθηκεύσετε αρχεία DOCX ως Markdown με οδηγίες βήμα‑βήμα χρησιμοποιώντας Aspose.Words για .NET. | +| [Πώς να εξάγετε LaTeX από το Word – Μετατροπή DOCX σε Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) | Μάθετε πώς να εξάγετε εξισώσεις LaTeX από έγγραφα Word και να τις μετατρέψετε σε Markdown χρησιμοποιώντας Aspose.Words για .NET. | +| [Πώς να εξάγετε LaTeX από DOCX – Μετατροπή σε Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) | Μάθετε πώς να εξάγετε εξισώσεις LaTeX από αρχεία DOCX και να τις μετατρέψετε σε Markdown με Aspose.Words για .NET. | +| [Δημιουργία markdown από Word – Πλήρης οδηγός C#](./create-markdown-from-word-full-c-guide/) | Μάθετε πώς να δημιουργήσετε markdown από έγγραφα Word με πλήρη οδηγό C# χρησιμοποιώντας Aspose.Words. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/greek/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/greek/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..7506164c04 --- /dev/null +++ b/words/greek/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Δημιουργήστε markdown από το Word με το Aspose.Words C#. Μάθετε πώς να + μετατρέπετε docx σε markdown, να εξάγετε εικόνες από το Word και πώς να χρησιμοποιείτε + callback σε ένα ενιαίο σεμινάριο. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: el +og_description: Δημιουργήστε markdown από το Word χρησιμοποιώντας το Aspose.Words. + Αυτός ο οδηγός δείχνει πώς να μετατρέψετε docx σε markdown, να εξάγετε εικόνες από + το Word και να χρησιμοποιήσετε μια κλήση επιστροφής για τη διαχείριση πόρων. +og_title: Δημιουργία markdown από το Word – Πλήρης οδηγός C# +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Δημιουργία markdown από το Word – Πλήρης οδηγός C# +url: /el/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Δημιουργία markdown από Word – Πλήρης C# Tutorial + +Κάποτε χρειάστηκε να **δημιουργήσετε markdown από Word** αλλά δεν ήξερατε από πού να ξεκινήσετε; Δεν είστε μόνοι· πολλοί προγραμματιστές αντιμετωπίζουν αυτό το εμπόδιο όταν προσπαθούν να μεταφέρουν περιεχόμενο από ένα αρχείο .docx σε έναν static‑site generator ή σε ένα αποθετήριο τεκμηρίωσης. Τα καλά νέα; Με το Aspose.Words μπορείτε να **μετατρέψετε docx σε markdown**, να εξάγετε κάθε εικόνα από το αρχικό αρχείο και να ελέγξετε ακριβώς πού θα τοποθετηθούν οι πόροι—όλα με ένα απλό callback. + +Σε αυτόν τον οδηγό θα περάσουμε από ένα πραγματικό παράδειγμα που δείχνει πώς να εξάγετε εικόνες από το Word, πώς να χρησιμοποιήσετε το callback για την αποθήκευσή τους, και γιατί αυτή η προσέγγιση είναι η πιο αξιόπιστη για pipelines αυτοματοποίησης. Στο τέλος θα έχετε ένα έτοιμο πρόγραμμα C# που παράγει ένα καθαρό αρχείο `.md` και έναν φάκελο με τις εξαγόμενες εικόνες. + +> **Pro tip:** Αν έχετε ήδη ένα πρότυπο Word που περιλαμβάνει screenshots, διαγράμματα ή λογότυπα, αυτή η μέθοδος θα διατηρήσει κάθε οπτικό στοιχείο χωρίς να χρειάζεται να κάνετε αντιγραφή‑επικόλληση χειροκίνητα. + +--- + +## Τι Θα Χρειαστείτε + +- **.NET 6+** (ή .NET Framework 4.6+). Ο κώδικας λειτουργεί σε οποιοδήποτε πρόσφατο runtime. +- **Aspose.Words for .NET** (πακέτο NuGet `Aspose.Words`). Η δωρεάν δοκιμή καλύπτει τις περισσότερες περιπτώσεις. +- Ένα **έγγραφο Word** (`input.docx`) που περιέχει κείμενο και τουλάχιστον μία εικόνα. +- Βασική κατανόηση του C# και του Visual Studio (ή του αγαπημένου σας IDE). + +Δεν απαιτούνται επιπλέον βιβλιοθήκες—όλα τα υπόλοιπα διαχειρίζονται από το ίδιο το Aspose.Words. + +--- + +## Βήμα 1: Ρύθμιση του Project και Εγκατάσταση του Aspose.Words + +Για να διατηρήσετε τα πράγματα οργανωμένα, δημιουργήστε ένα νέο console project: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Γιατί είναι σημαντικό αυτό το βήμα:** Η εγκατάσταση του πακέτου NuGet εξασφαλίζει ότι έχετε το πιο πρόσφατο API, το οποίο περιλαμβάνει την κλάση `MarkdownSaveOptions` που εισήχθη στην έκδοση 22.9. Χωρίς αυτήν θα έπρεπε να γράψετε έναν προσαρμοσμένο μετατροπέα. + +--- + +## Βήμα 2: Φόρτωση του Πηγαίου Εγγράφου Word + +Η πρώτη γραμμή κώδικα ανοίγει το `.docx` που θέλετε να μετατρέψετε. Αντικαταστήστε το `YOUR_DIRECTORY` με την πραγματική διαδρομή στο σύστημά σας. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Τι συμβαίνει;** Η κλάση `Document` αναλύει το αρχείο, δημιουργεί ένα εσωτερικό DOM και κάνει κάθε παράγραφο, πίνακα και εικόνα προσβάσιμη. Αν το αρχείο λείπει, το Aspose ρίχνει ένα σαφές `FileNotFoundException`, το οποίο μπορείτε να πιάσετε για πιο φιλικό UI. + +--- + +## Βήμα 3: Διαμόρφωση των Markdown Save Options με Callback Αποθήκευσης Πόρων + +Εδώ μπαίνει η μαγεία του **πώς να χρησιμοποιήσετε callback**. Το callback σας επιτρέπει να αποφασίσετε πού θα τοποθετηθεί κάθε εξαγόμενη εικόνα. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Γιατί ένα callback;** Από προεπιλογή το Aspose θα ενσωμάτωνε τις εικόνες ως αλφαριθμητικά base‑64 μέσα στο markdown—ένας εφιάλτης για τον έλεγχο εκδόσεων. Το callback σας δίνει πλήρη έλεγχο πάνω στα ονόματα αρχείων και στη δομή των φακέλων. + +--- + +## Βήμα 4: Αποθήκευση του Εγγράφου ως Markdown + +Τώρα δημιουργούμε πραγματικά το αρχείο `.md`. Όλες οι εικόνες θα παραδοθούν στο callback που ορίζεται στο επόμενο βήμα. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Αν όλα πάνε καλά, θα βρείτε το `Document.md` στον προορισμό και έναν υπο‑φάκελο `Resources` που περιέχει κάθε εικόνα που εξήχθη από το αρχικό αρχείο Word. + +--- + +## Βήμα 5: Υλοποίηση του Callback που Αποθηκεύει Κάθε Εξαγόμενη Εικόνα + +Παρακάτω είναι η πλήρης υλοποίηση του `MyResourceSaver`. Δημιουργεί έναν φάκελο `Resources` (αν δεν υπάρχει), δημιουργεί ένα μοναδικό όνομα αρχείου για κάθε εικόνα και γράφει το stream της εικόνας στο δίσκο. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Επεξήγηση των παραμέτρων:** +> - `args.Index` – μετρητής μηδενικής βάσης που εγγυάται μοναδικότητα. +> - `args.FileName` – το αρχικό όνομα αρχείου που προτείνει το Aspose (συχνά κάτι όπως `image001.png`). +> - `args.Stream` – το output stream όπου γράφονται τα bytes της εικόνας. +> - `args.KeepResourceStreamOpen` – ορίζεται σε `false` ώστε το Aspose να κλείνει αυτόματα το stream, αποτρέποντας διαρροές file‑handle. + +--- + +## Πλήρες Παράδειγμα Εργασίας + +Συνδυάζοντας τα παραπάνω, εδώ είναι ένα μοναδικό αρχείο που μπορείτε να αντιγράψετε‑επικολλήσετε στο `Program.cs`. Θυμηθείτε να αντικαταστήσετε το `YOUR_DIRECTORY` με μια απόλυτη ή σχετική διαδρομή που ταιριάζει στο περιβάλλον σας. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Αναμενόμενη Έξοδος + +- `YOUR_DIRECTORY/Document.md` – ένα αρχείο markdown με τυπικούς συνδέσμους εικόνων, π.χ.: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – περιέχει `img_0.png`, `img_1.jpg`, κ.λπ., σύμφωνα με τη σειρά που εμφανίστηκαν στο αρχικό έγγραφο Word. + +Η εκτέλεση του προγράμματος εμφανίζει ένα φιλικό μήνυμα επιβεβαίωσης, ενημερώνοντάς σας ότι η διαδικασία ολοκληρώθηκε επιτυχώς. + +--- + +## Συχνές Ερωτήσεις (FAQ) + +### Πώς να εξάγω εικόνες από το Word χωρίς να χάσω ποιότητα; + +Το callback γράφει το ακατέργαστο δυαδικό stream απευθείας σε αρχείο, διατηρώντας την αρχική ανάλυση. Δεν γίνεται καμία μετατροπή ή συμπίεση εκτός αν προσθέσετε τη δική σας λογική επεξεργασίας εικόνας μέσα στο `ResourceSaving`. + +### Μπορώ να αλλάξω τη μορφή της εικόνας (π.χ. PNG → JPEG) κατά την εξαγωγή; + +Απολύτως. Μέσα στο `ResourceSaving` μπορείτε να εξετάσετε το `args.FileName` ή το `args.Stream`, να φορτώσετε την εικόνα με `System.Drawing` ή `ImageSharp`, και να την επανακωδικοποιήσετε πριν την αποθηκεύσετε. Μην ξεχάσετε να ενημερώσετε την επέκταση του markdown link αναλόγως. + +### Τι αν θέλω τα markdown αρχεία να αναφέρονται σε CDN αντί για τοπικό φάκελο; + +Τροποποιήστε το callback ώστε να προσθέτει μια βασική URL στο markdown link. Μπορείτε να το πετύχετε ορίζοντας το `args.FileName` σε ένα πλήρως προσδιορισμένο URL μετά το ανέβασμα της εικόνας στο CDN σας. + +### Λειτουργεί αυτό με πίνακες, υποσημειώσεις ή άλλες προχωρημένες δυνατότητες του Word; + +Ναι. Το Aspose.Words μετατρέπει τις περισσότερες δομές του Word σε ισοδύναμα markdown. Οι πίνακες γίνονται markdown tables, οι υποσημειώσεις γίνονται reference links, και ακόμη και οι ένθετοι κατάλογοι διαχειρίζονται ομαλά. Αν κάτι φαίνεται περίεργο, ελέγξτε τις τελευταίες σημειώσεις έκδοσης—το Aspose βελτιώνει συνεχώς την πιστότητα της μετατροπής. + +### Πώς να μετατρέψω docx σε markdown σε pipeline CI/CD; + +Απλώς προσθέστε το compiled `.exe` στα βήματα build, δείξτε το στα παραγόμενα `.docx` artifacts, και σπρώξτε τα παραγόμενα `.md` και το φάκελο `Resources/` στο αποθετήριο static site. Επειδή η διαδικασία είναι πλήρως deterministic, λειτουργεί άψογα σε αυτοματοποιημένα περιβάλλοντα. + +--- + +## Συμπεράσματα + +Δείξαμε πώς να **δημιουργήσετε markdown από Word** χρησιμοποιώντας το Aspose.Words, καλύψαμε όλο το workflow **convert docx to markdown**, και παρουσιάσαμε έναν πρακτικό τρόπο **extract images from Word** με μια προσαρμοσμένη **how to use callback** υλοποίηση. Το αποτέλεσμα είναι ένα καθαρό αρχείο markdown συνδυασμένο με έναν φάκελο με τις αρχικές εικόνες—ιδανικό για ιστοσελίδες τεκμηρίωσης, static blogs, ή οποιαδήποτε ροή εργασίας που προτιμά μορφές plain‑text. + +Επόμενα βήματα που μπορείτε να εξετάσετε: + +- **Batch processing** πολλαπλών αρχείων `.docx` σε έναν φάκελο (βρόχος πάνω από `Directory.GetFiles`). +- **Custom naming schemes** για εικόνες (π.χ. χρησιμοποιώντας το κείμενο της αρχικής λεζάντας). +- **Post‑processing** του markdown για αντικατάσταση των συνδέσμων εικόνων με URLs CDN. +- Εξερεύνηση **άλλων μορφών εξαγωγής Aspose** όπως HTML, PDF ή EPUB για πολυκαναλική δημοσίευση. + +Έχετε περισσότερες ερωτήσεις ή ένα δύσκολο αρχείο Word που δεν θέλει να μετατραπεί; Αφήστε ένα σχόλιο παρακάτω και ας το λύσουμε μαζί. Καλή προγραμματιστική, και απολαύστε την απλότητα της μετατροπής Word σε markdown! + +--- + +![Διάγραμμα που δείχνει τη διαδικασία μετατροπής Word σε Markdown](image.png "Διάγραμμα δημιουργίας markdown από Word") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/greek/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/greek/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..2b75d8444b --- /dev/null +++ b/words/greek/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,267 @@ +--- +category: general +date: 2026-03-27 +description: Πώς να εξάγετε LaTeX από DOCX χρησιμοποιώντας το Aspose.Words. Μάθετε + πώς να μετατρέψετε DOCX σε Markdown, να ορίσετε DPI και να ενεργοποιήσετε την ανάκτηση + σε C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: el +og_description: Πώς να εξάγετε LaTeX από DOCX χρησιμοποιώντας το Aspose.Words. Αυτό + το σεμινάριο δείχνει βήμα‑βήμα τη μετατροπή σε Markdown, τον έλεγχο DPI και τη λειτουργία + ανάκτησης. +og_title: Πώς να εξάγετε LaTeX από DOCX – Μετατροπή σε Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Πώς να εξάγετε LaTeX από DOCX – Μετατροπή σε Markdown +url: /el/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να Εξάγετε LaTeX από DOCX – Μετατροπή σε Markdown + +Έχετε ποτέ αναρωτηθεί **πώς να εξάγετε LaTeX** από ένα αρχείο DOCX χωρίς να χάσετε την ομορφιά των εξισώσεών σας; Δεν είστε μόνοι. Από την εμπειρία μου, το μεγαλύτερο πρόβλημα είναι η μεταφορά των αντικειμένων OfficeMath σε μια καθαρή, φορητή μορφή για γεννήτριες στατικών ιστοσελίδων ή επιστημονικά blogs. + +Σε αυτόν τον οδηγό θα περάσουμε από τη μετατροπή DOCX σε Markdown με το Aspose.Words, ενώ θα δείξουμε επίσης **πώς να ορίσετε DPI**, **πώς να ενεργοποιήσετε την ανάκτηση**, και μερικά χρήσιμα κόλπα για μια αξιόπιστη αλυσίδα εργαλείων. Στο τέλος θα έχετε ένα ενιαίο πρόγραμμα C# που παράγει ένα αρχείο Markdown με εξισώσεις LaTeX, εικόνες υψηλής ανάλυσης και σωστή διαχείριση υπερσυνδέσμων. + +## Τι Θα Χρειαστεί + +- **.NET 6+** (ή .NET Framework 4.7.2 – το API λειτουργεί το ίδιο) +- **Aspose.Words for .NET** (η πιο πρόσφατη σταθερή έκδοση μέχρι Μάρτιο 2026) +- Ένα αρχείο DOCX που περιέχει εξισώσεις, εικόνες και συνδέσμους +- Visual Studio, VS Code ή οποιονδήποτε επεξεργαστή προτιμάτε + +Δεν απαιτούνται επιπλέον πακέτα NuGet εκτός από το Aspose.Words, αλλά βεβαιωθείτε ότι έχετε μια έγκυρη άδεια εάν δεν χρησιμοποιείτε τη δοκιμαστική έκδοση. + +## Βήμα 1 – Φόρτωση του DOCX με Κατάσταση Σκληρής Ανάκτησης + +Πριν σκεφτούμε τη διαδικασία εξαγωγής, πρέπει να βεβαιωθούμε ότι το πηγαίο έγγραφο δεν κρύβει κατεστραμμένα δεδομένα. Εδώ έρχεται στο προσκήνιο **πώς να ενεργοποιήσετε την ανάκτηση**. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Γιατί σκληρή ανάκτηση;** +Αν αφήσετε το Aspose να διορθώνει σιωπηλά προβλήματα, μπορεί να καταλήξετε με ελλιπή παραγράφους ή σπασμένες εικόνες—κάτι που κανείς δεν θέλει όταν εξάγει LaTeX. Αποτυγχάνοντας γρήγορα, μπορείτε να εντοπίσετε το πρόβλημα νωρίς και να αποφασίσετε αν θα διορθώσετε το πηγαίο DOCX ή θα καταγράψετε το ζήτημα για αργότερα. + +### Συμβουλή Pro +Τυλίξτε τη φόρτωση σε ένα try/catch και καταγράψτε το `DocumentLoadingException`. Με αυτόν τον τρόπο η CI αλυσίδα εργαλείων σας μπορεί να επισημάνει προβληματικά αρχεία χωρίς να διακόψει ολόκληρη τη διαδικασία κατασκευής. + +## Βήμα 2 – Προετοιμασία των Επιλογών Εξαγωγής Markdown + +Τώρα που το έγγραφο είναι ασφαλώς στη μνήμη, ρυθμίζουμε πώς θα αποθηκευτεί. Αυτό είναι η καρδιά του **πώς να εξάγετε latex** και επίσης καλύπτει **πώς να ορίσετε DPI** για ενσωματωμένες εικόνες. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Τι κάνει κάθε επιλογή** + +| Επιλογή | Αιτία | Σχετικότητα με Λέξεις-Κλειδιά | +|--------|--------|-----------------------| +| `OfficeMathExportMode = LaTeX` | Απαντά άμεσα **πώς να εξάγετε latex** από εξισώσεις. | Κύρια λέξη-κλειδί | +| `ImageResolution = 300` | Ελέγχει την ποιότητα της εικόνας – η απάντηση στο **πώς να ορίσετε dpi**. | Δευτερεύουσα | +| `ResourceSavingCallback` | Αποθηκεύει ενσωματωμένα αρχεία στο δίσκο, μια κοινή ανάγκη όταν **μετατρέπουμε docx σε markdown**. | Δευτερεύουσα | +| `EmptyParagraphExportMode` | Εγγυάται καθαρή έξοδο Markdown, αποτρέποντας τυχαίες ετικέτες HTML. | Βελτιώνει τη συνολική ποιότητα μετατροπής | +| `LinkExportMode = AsReference` | Κάνει τους συνδέσμους εύκολο στην ανάγνωση και επεξεργασία, ένα ακόμη πλεονέκτημα για **μετατρέπουμε docx σε markdown**. | | + +## Βήμα 3 – Υλοποίηση Προσαρμοσμένου Αποθηκευτή Πόρων (Προαιρετικό αλλά Χρήσιμο) + +Όταν μετατρέπετε DOCX σε Markdown, οι εικόνες και άλλοι δυαδικοί πόροι χρειάζονται μια θέση στο σύστημα αρχείων. Το Aspose σας επιτρέπει να το ελέγξετε με το `IResourceSavingCallback`. Το παραπάνω απόσπασμα δείχνει ήδη μια ελάχιστη υλοποίηση, αλλά ας το αναλύσουμε: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Γιατί να ασχοληθείτε;** +Αν παραλείψετε αυτό το βήμα, το Aspose θα ενσωματώσει τις εικόνες ως αλφαριθμητικά base‑64, κάτι που αυξάνει δραματικά το μέγεθος του αρχείου Markdown και κάνει τον έλεγχο εκδόσεων δύσκολο. Αποθηκεύοντας τους πόρους σε ξεχωριστό φάκελο, διατηρείτε το Markdown ελαφρύ και φιλικό για γεννήτριες στατικών ιστοσελίδων όπως Hugo ή Jekyll. + +## Βήμα 4 – Αποθήκευση του Εγγράφου ως Markdown + +Όλη η βαριά δουλειά έχει ολοκληρωθεί. Μία γραμμή τώρα γράφει το τελικό αρχείο. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Ανοίξτε το `output.md` και θα δείτε: + +- Εξισώσεις που αποδίδονται ως μπλοκ LaTeX `$…$` +- Εικόνες που αναφέρονται ως `![Alt text](resources/image001.png)` με ανάλυση 300 dpi +- Υπερσύνδεσμοι μετατρεπόμενοι σε στυλ αναφοράς: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Αυτή είναι συνοπτικά η διαδικασία **πώς να μετατρέψετε docx**. + +## Συχνές Ερωτήσεις & Ακραίες Περιπτώσεις + +### 1️⃣ Τι γίνεται αν το DOCX περιέχει μη υποστηριζόμενα αντικείμενα; +Το Aspose.Words θα ρίξει ένα `FeatureNotSupportedException`. Επειδή χρησιμοποιήσαμε **πώς να ενεργοποιήσετε την ανάκτηση** σε σκληρή λειτουργία, η εξαίρεση εμφανίζεται αμέσως. Μπορείτε είτε: + +- Να αλλάξετε το `RecoveryMode` σε `RecoveryMode.Default` για μια μετατροπή με τη μέγιστη δυνατή προσπάθεια, **ή** +- Να προεπεξεργαστείτε το DOCX (π.χ., να αφαιρέσετε μη υποστηριζόμενο SmartArt) πριν τρέξετε τον μετατροπέα. + +### 2️⃣ Μπορώ να αλλάξω το DPI ανά εικόνα; +Η ρύθμιση `ImageResolution` είναι καθολική. Για έλεγχο ανά εικόνα, υλοποιήστε ένα προσαρμοσμένο `ImageSavingCallback` παρόμοιο με το `MyResourceSaver` και προσαρμόστε το `args.ImageResolution` βάσει του `args.ImageFileName` ή των μεταδεδομένων. + +### 3️⃣ Πώς ενσωματώνω το παραγόμενο LaTeX σε ιστότοπο Jekyll; +Η ενσωματωμένη υποστήριξη MathJax του Jekyll λειτουργεί αμέσως. Απλώς βεβαιωθείτε ότι το layout σας περιλαμβάνει το script MathJax και τα μπλοκ LaTeX είναι τυλιγμένα σε `$$` για εξισώσεις εμφάνισης ή `$` για ενσωματωμένες. + +### 4️⃣ Είναι συμβατό με .NET Core σε Linux; +Απολύτως. Το Aspose.Words είναι cross‑platform. Απλώς βεβαιωθείτε ότι η διαδρομή `YOUR_DIRECTORY` ακολουθεί τις συμβάσεις του Linux (π.χ., `/home/user/docs`). + +## Πλήρες Παράδειγμα Εργασίας + +Παρακάτω υπάρχει ένα πρόγραμμα έτοιμο για αντιγραφή‑επικόλληση. Αντικαταστήστε το `YOUR_DIRECTORY` με μια πραγματική διαδρομή στο μηχάνημά σας. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Αναμενόμενη έξοδος** – ανοίξτε το `output.md` και θα πρέπει να δείτε κάτι σαν: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Αν ανοίξετε το αρχείο σε προεπισκόπηση Markdown που υποστηρίζει MathJax, το ολοκλήρωμα αποδίδεται + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/greek/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/greek/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..6bf25fd723 --- /dev/null +++ b/words/greek/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Πώς να εξάγετε LaTeX από έγγραφα Word χρησιμοποιώντας το Aspose.Words + – μετατρέψτε DOCX σε Markdown με εξισώσεις ως LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: el +og_description: Ο τρόπος εξαγωγής LaTeX από έγγραφα Word εξηγείται στην πρώτη πρόταση, + δείχνοντάς σας πώς να μετατρέψετε DOCX σε Markdown με εξισώσεις σε μορφή LaTeX. +og_title: Πώς να εξάγετε LaTeX από το Word – Πλήρης οδηγός +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Πώς να εξάγετε LaTeX από το Word – Μετατροπή DOCX σε Markdown +url: /el/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να Εξάγετε LaTeX από το Word – Μετατροπή DOCX σε Markdown + +Έχετε αναρωτηθεί ποτέ **πώς να εξάγετε LaTeX** από ένα αρχείο Word χωρίς να καταλήξετε με μια σειρά PNG; Δεν είστε οι μόνοι· οι προγραμματιστές συχνά αντιμετωπίζουν αυτό το πρόβλημα όταν χρειάζονται καθαρούς, επεξεργάσιμους τύπους για στατικούς ιστότοπους ή επιστημονικά blogs. Τα καλά νέα; Με το Aspose.Words μπορείτε **να μετατρέψετε Word σε Markdown** και να διατηρήσετε κάθε αντικείμενο OfficeMath ως εγγενές LaTeX—χωρίς καμία μετα-επεξεργασία. + +Σε αυτό το tutorial θα περάσουμε βήμα‑βήμα όλη τη διαδικασία **αποθήκευσης ενός εγγράφου Word ως Markdown** ενώ **εξάγουμε τους τύπους ως LaTeX**. Στο τέλος θα έχετε ένα λειτουργικό snippet C#, μια σαφή εξήγηση κάθε επιλογής, και συμβουλές για την αντιμετώπιση ειδικών περιπτώσεων όπως σύνθετοι τύποι ή μεικτό περιεχόμενο. Χωρίς εξωτερικά εργαλεία, μόνο ένα πακέτο NuGet και μερικές γραμμές κώδικα. + +## Τι Θα Χρειαστείτε + +- .NET 6+ (ή .NET Framework 4.7.2 και νεότερο) – η πιο πρόσφατη έκδοση λειτουργεί καλύτερα. +- Visual Studio 2022 ή οποιονδήποτε επεξεργαστή που μπορεί να μεταγλωττίσει έργα C#. +- Άδεια Aspose.Words for .NET (η δωρεάν δοκιμή λειτουργεί για πειραματισμό). +- Ένα αρχείο DOCX που περιέχει τουλάχιστον έναν τύπο (OfficeMath). + +Αν έχετε ήδη όλα αυτά, τέλεια—ας ξεκινήσουμε. + +## Πώς να Εξάγετε LaTeX από το Word – Επισκόπηση + +Παρακάτω φαίνεται μια υψηλού επιπέδου εικόνα των βημάτων: + +1. **Εγκατάσταση** του πακέτου Aspose.Words NuGet. +2. **Φόρτωση** του πηγαίου `.docx` που περιέχει τους τύπους σας. +3. **Διαμόρφωση** του `MarkdownSaveOptions` ώστε το `OfficeMathExportMode` να είναι `LaTeX`. +4. **Αποθήκευση** του εγγράφου ως αρχείο `.md`. +5. **Επαλήθευση** ότι το παραγόμενο Markdown περιέχει μπλοκ LaTeX (`$$…$$`). + +Κάθε ένα από αυτά τα βήματα εξηγείται λεπτομερώς στις επόμενες ενότητες. + +![Διάγραμμα που δείχνει τη ροή από DOCX σε Markdown με τύπους LaTeX](how-to-export-latex.png){alt="Διάγραμμα εξαγωγής latex από Word"} + +## Βήμα 1 – Εγκατάσταση Aspose.Words for .NET (μετατροπή word σε markdown) + +Πρώτα απ’ όλα: χρειάζεστε τη βιβλιοθήκη που κάνει το πραγματικό βάρος. Ανοίξτε το τερματικό σας (ή το Package Manager Console) και τρέξτε: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** Αν χρησιμοποιείτε Visual Studio, κάντε δεξί‑κλικ στο έργο → *Manage NuGet Packages* → ψάξτε για “Aspose.Words” και εγκαταστήστε την πιο πρόσφατη σταθερή έκδοση. + +Γιατί είναι σημαντικό: Το Aspose.Words αφαιρεί την πολυπλοκότητα του Open XML, παρέχοντάς σας ένα καθαρό API για τη διαχείριση εγγράφων Word χωρίς να ασχολείστε με το χαμηλού επιπέδου XML. Επιπλέον, περιλαμβάνει ενσωματωμένη υποστήριξη για μετατροπή OfficeMath σε LaTeX, που είναι η καρδιά της **εξαγωγής τύπων ως LaTeX**. + +## Βήμα 2 – Φόρτωση του DOCX (πώς να μετατρέψετε docx) + +Τώρα που το πακέτο είναι έτοιμο, φορτώστε το αρχείο που θέλετε να μετατρέψετε. Αντικαταστήστε το `YOUR_DIRECTORY` με τη διαδρομή όπου βρίσκεται το `.docx` σας: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Γιατί να το φορτώσετε έτσι;** Ο κατασκευαστής `Document` αναλύει ολόκληρο το αρχείο σε ένα αντικειμενοστραφές μοντέλο, δίνοντάς σας άμεση πρόσβαση σε παραγράφους, πίνακες και—το πιο σημαντικό—αντικείμενα OfficeMath. Αν το αρχείο λείπει ή είναι κατεστραμμένο, το Aspose ρίχνει μια περιγραφική `FileNotFoundException`, την οποία μπορείτε να πιάσετε για ευγενική διαχείριση σφαλμάτων. + +## Βήμα 3 – Διαμόρφωση MarkdownSaveOptions (εξαγωγή τύπων ως latex) + +Η μαγεία συμβαίνει στο αντικείμενο `MarkdownSaveOptions`. Από προεπιλογή, το Aspose θα αποδίδει τους τύπους ως εικόνες PNG, αλλά εμείς θέλουμε LaTeX. Ορίστε το `OfficeMathExportMode` σε `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Μια σύντομη σημείωση για τις προαιρετικές σημαίες: `ExportImagesAsBase64` λέει στο Aspose να μην ενσωματώνει δυαδικά δεδομένα, κρατώντας το Markdown καθαρό. `ExportHeadersFooters` εξασφαλίζει ότι δεν θα χάσετε κανένα περιεχόμενο που μπορεί να βρίσκεται σε αυτές τις ενότητες—χρήσιμο όταν το κεφαλίδα περιέχει τίτλο ή όνομα συγγραφέα. + +## Βήμα 4 – Αποθήκευση του Εγγράφου (αποθήκευση word ως markdown) + +Τέλος, γράψτε το μετασχηματισμένο περιεχόμενο σε αρχείο `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Μετά την εκτέλεση αυτής της γραμμής, θα βρείτε το `output.md` δίπλα στο αρχείο πηγής. Ανοίξτε το σε οποιονδήποτε επεξεργαστή κειμένου και θα δείτε μπλοκ LaTeX που μοιάζουν με αυτό: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Αυτό ήταν το **save word as markdown**—χωρίς επιπλέον βήματα μετατροπής. + +## Βήμα 5 – Επαλήθευση του Αποτελέσματος (εξαγωγή τύπων ως latex) + +Είναι εύκολο να παραβλεφθεί η επαλήθευση, αλλά ένας γρήγορος έλεγχος μπορεί να σας εξοικονομήσει ώρες. Εκτελέστε ένα απλό script που διαβάζει το παραγόμενο αρχείο και εκτυπώνει το πρώτο μπλοκ LaTeX: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Αν δείτε `First LaTeX block: $$ … $$` στην έξοδο, έχετε **εξάγει LaTeX** από το Word με επιτυχία. Αν όχι, ελέγξτε ξανά ότι το πηγαίο έγγραφο περιέχει πραγματικά αντικείμενα OfficeMath· οι κανονικοί τύποι κειμένου δεν μετατρέπονται. + +## Αντιμετώπιση Συνηθισμένων Edge Cases + +| Σενάριο | Σε τι να προσέξετε | Προτεινόμενη Διόρθωση | +|----------|-------------------|-----------------| +| **Μεικτές εικόνες & τύποι** | Το Aspose μπορεί ακόμη να ενσωματώνει εικόνες για γραφικά που δεν είναι OfficeMath. | Ορίστε `ExportImagesAsBase64 = false` και διατηρήστε τις εικόνες ως εξωτερικά αρχεία, έπειτα αναφέρετέ τες χειροκίνητα στο Markdown. | +| **Σύνθετοι ένθετοι τύποι** | Πολύ βαθιά ένθεση μπορεί να δημιουργήσει LaTeX που χρειάζεται χειροκίνητη προσαρμογή. | Μετα-επεξεργαστείτε το μπλοκ με έναν μορφοποιητή LaTeX (π.χ. `latexindent`) ή ρυθμίστε `mdOptions` → `ExportMathAsDisplay = true`. | +| **Μεγάλα έγγραφα** | Η χρήση μνήμης αυξάνεται όταν φορτώνετε τεράστια `.docx`. | Χρησιμοποιήστε `LoadOptions` με `LoadFormat.Docx` και ενεργοποιήστε streaming στο `LoadOptions.LoadFormat` αν είναι διαθέσιμο. | +| **Απουσία άδειας** | Η δωρεάν δοκιμή προσθέτει ένα σχόλιο υδατογράμματος στην έξοδο. | Εφαρμόστε έγκυρη άδεια μέσω `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Αυτές οι συμβουλές κρατούν τη ροή εργασίας σας αξιόπιστη, ειδικά όταν **μετατρέπετε word σε markdown** σε παραγωγικές γραμμές. + +## Πλήρες Παράδειγμα (Όλα τα Βήματα σε Ένα Αρχείο) + +Παρακάτω υπάρχει μια αυτόνομη εφαρμογή console που μπορείτε να αντιγράψετε‑επικολλήσετε σε ένα νέο .NET project και να τρέξετε αμέσως. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Τρέξτε το πρόγραμμα, ανοίξτε το `output.md`, και θα δείτε τους τύπους σας να εμφανίζονται ως καθαρό LaTeX. Αυτή είναι η πλήρης απάντηση στο **πώς να εξάγετε latex** από ένα έγγραφο Word. + +## Συμπέρασμα + +Καλύψαμε **πώς να εξάγετε LaTeX** από το Word βήμα‑βήμα, δείχνοντας πώς να **μετατρέψετε Word σε markdown**, **αποθηκεύσετε word ως markdown**, και **εξάγετε τύπους ως LaTeX** χρησιμοποιώντας το Aspose.Words. Η βασική ιδέα είναι απλή: φορτώστε το DOCX, προσαρμόστε το `MarkdownSaveOptions`, και αφήστε τη βιβλιοθήκη να κάνει τη δουλειά. + +Αν θέλετε να αυτοματοποιήσετε τις γραμμές τεκμηρίωσης, δοκιμάστε να συνδέσετε αυτόν τον κώδικα με έναν static‑site generator όπως Hugo ή Jekyll—απλώς σπρώξτε τα παραγόμενα `.md` αρχεία στο αποθετήριο και αφήστε τον ιστότοπο να ξαναχτίσει. Για περαιτέρω ανάγνωση, εξερευνήστε τον οδηγό “Export to LaTeX” του Aspose, πειραματιστείτε με `HtmlSaveOptions` για προεπισκοπήσεις στο web, ή εμβαθύνετε στο API `DocumentVisitor` για προσαρμοσμένες μετατροπές. + +Έχετε ερωτήσεις για edge cases, άδειες, ή ενσωμάτωση σε CI/CD; Αφήστε ένα σχόλιο παρακάτω, και καλή προγραμματιστική! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/greek/net/programming-with-pdfsaveoptions/_index.md b/words/greek/net/programming-with-pdfsaveoptions/_index.md index fe1830fb80..bfe5180b1a 100644 --- a/words/greek/net/programming-with-pdfsaveoptions/_index.md +++ b/words/greek/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ | [Ενημέρωση τελευταίας εκτυπωμένης ιδιότητας σε έγγραφο PDF](./update-last-printed-property/) | Μάθετε πώς να ενημερώσετε την τελευταία εκτυπωμένη ιδιότητα σε ένα έγγραφο PDF χρησιμοποιώντας το Aspose.Words για .NET με τον αναλυτικό μας οδηγό. | | [Απόδοση 3D DML 3DEfects σε έγγραφο PDF](./dml-3deffects-rendering/) | Μάθετε πώς να αποδίδετε εκπληκτικά εφέ 3D DML σε έγγραφα PDF χρησιμοποιώντας το Aspose.Words για .NET με αυτόν τον ολοκληρωμένο οδηγό βήμα προς βήμα. | | [Παρεμβολή εικόνων σε ένα έγγραφο PDF](./interpolate-images/) | Μάθετε πώς να παρεμβάλλετε εικόνες σε ένα έγγραφο PDF χρησιμοποιώντας το Aspose.Words για .NET με τον αναλυτικό μας οδηγό. Βελτιώστε εύκολα την ποιότητα εικόνας του PDF σας. | - +| [Πώς να αποθηκεύσετε PDF από DOCX με Aspose.Words – Οδηγός βήμα‑βήμα](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Μάθετε πώς να μετατρέψετε αρχεία DOCX σε PDF χρησιμοποιώντας το Aspose.Words για .NET με αναλυτικές οδηγίες βήμα‑βήμα. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/greek/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/greek/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..fd92413dbd --- /dev/null +++ b/words/greek/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-03-27 +description: Μάθετε πώς να αποθηκεύετε PDF από αρχείο DOCX χρησιμοποιώντας το Aspose.Words. + Περιλαμβάνει τη μετατροπή docx σε pdf, την αποθήκευση pdf με επιλογές και τη διαχείριση + των αιωρούμενων σχημάτων. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: el +og_description: Πώς να αποθηκεύσετε PDF από αρχείο DOCX χρησιμοποιώντας το Aspose.Words. + Αυτός ο οδηγός δείχνει πώς να μετατρέψετε docx σε pdf, να αποθηκεύσετε το pdf με + επιλογές και να διαχειριστείτε τα αιωρούμενα σχήματα. +og_title: Πώς να αποθηκεύσετε PDF από DOCX – Πλήρης οδηγός Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Πώς να αποθηκεύσετε PDF από DOCX με το Aspose.Words – Οδηγός βήμα‑προς‑βήμα +url: /el/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να αποθηκεύσετε PDF από DOCX με Aspose.Words – Πλήρης Εκπαιδευτικό Σεμινάριο + +Έχετε αναρωτηθεί ποτέ **πώς να αποθηκεύσετε PDF** από ένα έγγραφο Word χωρίς να χάσετε τη διάταξη των αιωρούμενων σχημάτων; Δεν είστε ο μόνος. Σε πολλά έργα—γεννήτριες τιμολογίων, εξαγωγείς αναφορών ή απλοί αρχειοθέτες εγγράφων—οι προγραμματιστές χρειάζονται έναν αξιόπιστο τρόπο να μετατρέπουν DOCX σε PDF διατηρώντας όλα ακριβώς όπως εμφανίζονται στο Word. + +Σε αυτό το εκπαιδευτικό σεμινάριο θα περάσουμε από τη μετατροπή ενός αρχείου DOCX σε PDF **χρησιμοποιώντας Aspose.Words for .NET**, θα σας δείξουμε **πώς να μετατρέψετε docx σε pdf** με προσαρμοσμένες επιλογές αποθήκευσης, και θα εξηγήσουμε γιατί η σημαία `ExportFloatingShapesAsInlineTag` είναι σημαντική. Στο τέλος θα έχετε ένα έτοιμο‑για‑εκτέλεση απόσπασμα κώδικα που αποθηκεύει PDF με τις επιλογές που ελέγχετε. + +## Τι Θα Μάθετε + +- Τα ακριβή βήματα για **μετατροπή word document pdf** με Aspose.Words. +- Πώς να ρυθμίσετε το `PdfSaveOptions` ώστε να αντιμετωπίζει τα αιωρούμενα σχήματα ως ετικέτες inline. +- Συνηθισμένα προβλήματα όταν δουλεύετε με αιωρούμενα αντικείμενα και πώς να τα αποφύγετε. +- Ένα πλήρες, εκτελέσιμο πρόγραμμα C# που μπορείτε να ενσωματώσετε σε οποιοδήποτε έργο .NET. + +> **Απαίτηση:** Χρειάζεστε άδεια Aspose.Words for .NET (ή δωρεάν αξιολόγηση) και περιβάλλον ανάπτυξης .NET (Visual Studio, Rider ή το `dotnet` CLI). + +## Step 1: Set Up the Project and Add Aspose.Words + +Πρώτα, δημιουργήστε μια νέα εφαρμογή κονσόλας (ή προσθέστε σε μια υπάρχουσα) και αναφέρετε το πακέτο NuGet Aspose.Words. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro tip:** Αν εργάζεστε σε διακομιστή CI, κλειδώστε την έκδοση του πακέτου (`Aspose.Words --version 24.10`) για να εγγυηθείτε επαναλήψιμες κατασκευές. + +## Step 2: Load the DOCX Containing Floating Shapes + +Οι αιωρούμενες εικόνες, τα πλαίσια κειμένου ή το SmartArt μπορούν να προκαλέσουν μετατοπίσεις διάταξης κατά τη μετατροπή. Η φόρτωση του εγγράφου είναι απλή, αλλά θα ελέγξουμε επίσης ότι το αρχείο υπάρχει για να αποτρέψουμε μια `FileNotFoundException` κατά την εκτέλεση. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Παρατηρήστε τις δηλώσεις `Console.WriteLine`—σας παρέχουν άμεση ανάδραση όταν εκτελείτε την εφαρμογή από τερματικό. + +## Step 3: Configure PDF Save Options (Save PDF with Options) + +Εδώ συμβαίνει η μαγεία. Από προεπιλογή, το Aspose.Words προσπαθεί να διατηρήσει τα αιωρούμενα αντικείμενα όπως εμφανίζονται, κάτι που μπορεί να σπάσει τη διάταξη στο τελικό PDF. Ορίζοντας το `ExportFloatingShapesAsInlineTag` σε `true` λέτε στη βιβλιοθήκη να αντιμετωπίζει αυτά τα σχήματα ως ετικέτες inline, εξασφαλίζοντας ότι παραμένουν αγκυροβολημένα στο γύρω κείμενο. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Γιατί είναι σημαντικό αυτό; Σκεφτείτε ένα πλαίσιο κειμένου που αιωρείται πάνω από μια παράγραφο. Χωρίς τη μετατροπή σε inline‑tag, το PDF μπορεί να ωθήσει την παράγραφο προς τα κάτω ή να κόψει εντελώς το πλαίσιο. Η σημαία διατηρεί τη οπτική σχέση—μια λεπτή αλλά κρίσιμη λεπτομέρεια για επαγγελματικές αναφορές. + +## Step 4: Save the Document as PDF + +Τώρα γράφουμε πραγματικά το αρχείο PDF. Η μέθοδος `Save` λαμβάνει τόσο τη διαδρομή εξόδου όσο και τις επιλογές που μόλις ορίσαμε. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Η εκτέλεση του προγράμματος θα δημιουργήσει το `output.pdf` στον ίδιο φάκελο με το πηγαίο DOCX. Ανοίξτε το σε οποιονδήποτε προβολέα PDF και θα δείτε ότι όλα τα αιωρούμενα σχήματα αποδίδονται ακριβώς στη θέση τους. + +## Full Working Example + +Παρακάτω βρίσκεται ολόκληρο το πρόγραμμα σε ένα μπλοκ. Αντιγράψτε‑και‑επικολλήστε το στο `Program.cs` (ή σε οποιοδήποτε αρχείο C#) και πατήστε **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Αναμενόμενο Αποτέλεσμα + +- **Δημιουργήθηκε αρχείο:** `output.pdf` στον προορισμό. +- **Ακρίβεια διάταξης:** Τα αιωρούμενα σχήματα (εικόνες, πλαίσια κειμένου, SmartArt) εμφανίζονται inline με το γύρω κείμενο. +- **Χωρίς εξαιρέσεις:** Το πρόγραμμα τερματίζει ομαλά, εκτυπώνοντας μηνύματα κατάστασης στην κονσόλα. + +## Frequently Asked Questions & Edge Cases + +| Question | Answer | +|----------|--------| +| **Τι γίνεται αν χρειάζομαι υψηλότερη ποιότητα εικόνας;** | Ορίστε `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Μπορώ να μετατρέψω πολλά αρχεία DOCX σε batch;** | Τυλίξτε τη λογική φόρτωσης/αποθήκευσης σε έναν βρόχο `foreach (var file in Directory.GetFiles(..., "*.docx"))`. Θυμηθείτε να επαναχρησιμοποιήσετε ένα μόνο αντικείμενο `PdfSaveOptions` για απόδοση. | +| **Λειτουργεί αυτό με .NET Core;** | Απόλυτα. Το Aspose.Words 24.x υποστηρίζει .NET Standard 2.0+, ώστε να τρέχετε τον ίδιο κώδικα σε Windows, Linux ή macOS. | +| **Τι γίνεται με αρχεία DOCX προστατευμένα με κωδικό;** | Φορτώστε με `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. Οι ίδιες `PdfSaveOptions` εφαρμόζονται κατά την αποθήκευση. | +| **Είναι ασφαλής η μετατροπή σε inline‑tag για πολύπλονους πίνακες;** | Γενικά ναι, αλλά πολύ περίπλοκες διατάξεις πινάκων με επικαλυπτόμενα σχήματα μπορεί να απαιτούν χειροκίνητη προσαρμογή. Δοκιμάστε ένα αντιπροσωπευτικό δείγμα πριν από μαζική μεταφορά. | + +## Tips for Real‑World Projects + +- **Καταγραφή, όχι μόνο `Console.WriteLine`** – Σε παραγωγή, αντικαταστήστε την έξοδο κονσόλας με ένα πλαίσιο καταγραφής (Serilog, NLog) για να συλλαμβάνετε σφάλματα. +- **Αποδέσμευση πόρων** – Το `Document` υλοποιεί `IDisposable`. Τυλίξτε το σε `using` εάν επεξεργάζεστε πολλά αρχεία για άμεση απελευθέρωση μνήμης. +- **Επικύρωση του PDF** – Χρησιμοποιήστε έναν ελεγκτή PDF (π.χ. ελεγκτής συμμόρφωσης PDF/A) εάν χρειάζεστε αρχεία PDF αρχειοθέτησης. +- **Παράλληλη επεξεργασία** – Για τεράστιες εργασίες, σκεφτείτε `Parallel.ForEach` με thread‑safe `PdfSaveOptions` (κλώνος ανά νήμα) για ταχύτερη μετατροπή. + +## Conclusion + +Καλύψαμε **πώς να αποθηκεύσετε PDF** από αρχείο DOCX χρησιμοποιώντας Aspose.Words, δείξαμε **πώς να μετατρέψετε docx σε pdf** με προσαρμοσμένες επιλογές, και εξηγήσαμε την επίδραση του `ExportFloatingShapesAsInlineTag`. Το πλήρες, εκτελέσιμο παράδειγμα δείχνει ότι μπορείτε να **μετατρέψετε word document pdf** με λίγες μόνο γραμμές κώδικα, και τώρα ξέρετε πώς να **αποθηκεύσετε pdf με options** που ταιριάζουν στην ποιότητα και τις απαιτήσεις συμμόρφωσης του έργου σας. + +Έτοιμοι για την επόμενη πρόκληση; Δοκιμάστε εξαγωγή σε άλλες μορφές (π.χ. HTML, EPUB) με `document.Save("output.html")`, ή πειραματιστείτε με συμμόρφωση PDF/A για μακροπρόθεσμη αρχειοθέτηση. Οι ίδιες αρχές—φόρτωση, ρύθμιση επιλογών, αποθήκευση—εφαρμόζονται παντού. + +Καλή προγραμματιστική, και τα PDF σας να φαίνονται πάντα ακριβώς όπως τα φανταζόσασταν! + +![Διάγραμμα που απεικονίζει πώς ένα αρχείο DOCX φορτώνεται, εφαρμόζονται επιλογές και παράγεται PDF – πώς να αποθηκεύσετε pdf](https://example.com/images/how-to-save-pdf-diagram.png "διάγραμμα αποθήκευσης pdf") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/greek/net/programming-with-shapes/_index.md b/words/greek/net/programming-with-shapes/_index.md index 321a3e566b..526cb59792 100644 --- a/words/greek/net/programming-with-shapes/_index.md +++ b/words/greek/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ | [Εντοπισμός Έξυπνου Σχήματος Τέχνης](./detect-smart-art-shape/) | Μάθετε πώς να εντοπίζετε σχήματα SmartArt σε έγγραφα του Word χρησιμοποιώντας το Aspose.Words για .NET με αυτόν τον ολοκληρωμένο οδηγό. Ιδανικό για την αυτοματοποίηση της ροής εργασίας των εγγράφων σας. | | [Ενημέρωση Σχεδίου Smart Art](./update-smart-art-drawing/) | Μάθετε πώς να ενημερώνετε σχέδια Smart Art σε έγγραφα Word χρησιμοποιώντας το Aspose.Words για .NET με αυτόν τον οδηγό βήμα προς βήμα. Βεβαιωθείτε ότι τα γραφικά σας είναι πάντα ακριβή. | | [Δημιουργία σχήματος ορθογωνίου στο Word με Aspose.Words – Οδηγός βήμα προς βήμα](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Μάθετε πώς να δημιουργήσετε σχήμα ορθογωνίου σε έγγραφο Word χρησιμοποιώντας το Aspose.Words με αναλυτικές οδηγίες. | +| [Δημιουργία Εγγράφου Word C# – Προσθήκη Σχήματος με Σκιά](./create-word-document-c-add-shape-with-shadow/) | Μάθετε πώς να προσθέσετε σχήμα με σκιά σε έγγραφο Word χρησιμοποιώντας το Aspose.Words για .NET με C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/greek/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/greek/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..0e3968e789 --- /dev/null +++ b/words/greek/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,204 @@ +--- +category: general +date: 2026-03-27 +description: Δημιουργήστε έγγραφο Word με C# και μάθετε πώς να προσθέσετε σχήμα, να + εφαρμόσετε σκιά στο σχήμα και να ορίσετε την απόσταση της σκιάς. Οδηγός βήμα‑βήμα + για το Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: el +og_description: Δημιουργήστε έγγραφο Word με C# με σχήμα ορθογωνίου και προσαρμοσμένη + σκιά. Ακολουθήστε αυτό το πλήρες σεμινάριο για να ορίσετε την απόσταση και το στυλ + της σκιάς. +og_title: Δημιουργία εγγράφου Word C# – Προσθήκη σχήματος με σκιά +tags: +- Aspose.Words +- C# +- Document Automation +title: Δημιουργία εγγράφου Word C# – Προσθήκη σχήματος με σκιά +url: /el/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Δημιουργία Word Document C# – Προσθήκη Σχήματος με Σκιά + +Έχετε ποτέ χρειαστεί να **create word document c#** που περιέχει ένα ωραία μορφοποιημένο ορθογώνιο; Ίσως δημιουργείτε ένα πρότυπο αναφοράς και θέλετε μια διακριτική σκιά πτώσης για να αναδείξετε τη διάταξη. Σε αυτό το tutorial θα περάσουμε βήμα‑βήμα από αυτό – πώς να προσθέσετε σχήμα, να εφαρμόσετε σκιά στο σχήμα και ακόμη να ρυθμίσετε την απόσταση της σκιάς χρησιμοποιώντας το Aspose.Words. + +Θα ξεκινήσουμε με ένα κενό έγγραφο, θα προσθέσουμε ένα ορθογώνιο, θα του δώσουμε μια προεπιλεγμένη σκιά και θα ολοκληρώσουμε αποθηκεύοντας το αρχείο. Στο τέλος θα έχετε ένα έτοιμο .docx που μπορείτε να ανοίξετε στο Word και να δείτε το αποτέλεσμα αμέσως. Χωρίς εξωτερικά εργαλεία, μόνο καθαρός κώδικας C#. + +## Προαπαιτούμενα + +- .NET 6 (ή οποιοδήποτε πρόσφατο .NET Framework) εγκατεστημένο. +- Visual Studio 2022 ή VS Code με επέκταση C#. +- Πακέτο NuGet Aspose.Words για .NET (`Aspose.Words` έκδοση 23.12 ή νεότερη). + Μπορείτε να το προσθέσετε μέσω του Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +Αυτό είναι όλο – δεν απαιτούνται επιπλέον DLL ή COM interop. + +## Βήμα 1: Αρχικοποίηση Νέου Εγγράφου και Builder – *create word document c#* Βασικά + +Αρχικά χρειαζόμαστε ένα αντικείμενο `Document` που αντιπροσωπεύει το αρχείο Word και ένα `DocumentBuilder` για την επεξεργασία του. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Γιατί είναι σημαντικό αυτό το βήμα:** Η κλάση `Document` είναι ο κοντέινερ για όλα τα μέρη του Word (σελίδες, στυλ, εικόνες). Ο builder είναι το υψηλού επιπέδου API που αφαιρεί την ανάγκη για χαμηλού επιπέδου χειρισμό κόμβων, κάνοντας εύκολο το **create word document c#** χωρίς να ασχοληθείτε άμεσα με XML. + +## Βήμα 2: Εισαγωγή Σχήματος Ορθογωνίου – *how to create rectangle* + +Τώρα θα τοποθετήσουμε ένα ορθογώνιο στη σελίδα. Το μέγεθος εκφράζεται σε points (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Συμβουλή:** Αν χρειάζεστε διαφορετικό σχήμα, απλώς αντικαταστήστε το `ShapeType.Rectangle` με `ShapeType.Ellipse`, `ShapeType.Triangle`, κ.λπ. Ο ίδιος κώδικας λειτουργεί για **how to add shape** οποιουδήποτε τύπου. + +## Βήμα 3: Εφαρμογή Προεπιλεγμένης Σκιάς και Λεπτομερής Ρύθμιση – *apply shadow to shape* + +Το Aspose.Words περιλαμβάνει αρκετές προεπιλεγμένες μορφές σκιάς. Θα χρησιμοποιήσουμε το `Preset1` και στη συνέχεια θα προσαρμόσουμε την απόσταση, το θολό, τη διαφάνεια και το χρώμα. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Γιατί να προσαρμόσετε τη σκιά;** Η ιδιότητα `Distance` ελέγχει πόσο μακριά βρίσκεται η σκιά από το ορθογώνιο – σκεφτείτε το ως το «υψόμετρο» που βλέπετε σε μια 3‑Δ απόδοση. Η αλλαγή του `BlurRadius` μαλακώνει τις άκρες, ενώ η `Transparency` σας επιτρέπει να δημιουργήσετε ένα διακριτικό, επαγγελματικό αποτέλεσμα. Αυτό καλύπτει την απαίτηση **set shadow distance** και σας δείχνει πώς να **apply shadow to shape** με ευέλικτο τρόπο. + +## Βήμα 4: Αποθήκευση Εγγράφου – *create word document c#* Ολοκλήρωση + +Τέλος, γράψτε το έγγραφο στο δίσκο. Προσαρμόστε τη διαδρομή σε έναν φάκελο στον οποίο έχετε δικαιώματα εγγραφής. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Ανοίξτε το παραγόμενο αρχείο στο Microsoft Word και θα δείτε ένα ανοιχτό‑μπλε ορθογώνιο με μια απαλή γκρι σκιά μετατοπισμένη κατά 5 pt. Αυτό είναι η οπτική απόδειξη ότι δημιουργήσατε επιτυχώς **create word document c#** με ένα μορφοποιημένο σχήμα. + +![Δημιουργία Word Document C# με Σχήμα με Σκιά](shadow-example.png){: .img alt="παράδειγμα δημιουργίας word document c# με ορθογώνιο και σκιά"} + +## Προαιρετικές Παραλλαγές & Περιπτώσεις Ορίων + +| Scenario | What to Change | Why it Matters | +|----------|----------------|----------------| +| **Διαφορετικό στυλ σκιάς** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Σας δίνει πιο δραματική εμφάνιση χωρίς επιπλέον κώδικα. | +| **Χωρίς προεπιλογή – προσαρμοσμένη σκιά** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Πλήρης έλεγχος πάνω στην κατεύθυνση και το βάθος. | +| **Πολλαπλά σχήματα** | Call `builder.InsertShape` again before saving. | Χρήσιμο για σύνθετα πρότυπα με εικονίδια, λογότυπα κ.λπ. | +| **Συμβατότητα με παλαιότερες εκδόσεις Aspose** | Use `ShadowEffect` class (available in v20.x). | Εξασφαλίζει ότι ο κώδικάς σας λειτουργεί σε παλαιά έργα. | +| **Αποθήκευση ως PDF** | `document.Save("ShadowShape.pdf");` | Η ίδια απόδοση σκιάς εμφανίζεται στην έξοδο PDF. | + +> **Συχνή ερώτηση:** *Τι γίνεται αν η σκιά δεν εμφανίζεται στο Word;* +> Βεβαιωθείτε ότι χρησιμοποιείτε μια πρόσφατη έκδοση του Aspose.Words (≥ 22.9). Οι παλαιότερες εκδόσεις είχαν περιορισμένη υποστήριξη σκιάς. Επίσης, ελέγξτε ότι το έγγραφο ανοίγει σε μια πρόσφατη έκδοση του Word (2016+). + +## Πλήρες Παράδειγμα Λειτουργίας + +Παρακάτω βρίσκεται το πλήρες πρόγραμμα, έτοιμο για αντιγραφή‑επικόλληση. Περιλαμβάνει όλες τις οδηγίες `using`, σχόλια και διαχείριση σφαλμάτων για μια ομαλή εμπειρία. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Εκτελέστε το πρόγραμμα, μεταβείτε στο `C:\Temp\ShadowShape.docx` και θα δείτε το ορθογώνιο με την ακριβή σκιά που διαμορφώσαμε. + +## Ανακεφαλαίωση & Επόμενα Βήματα + +- Τώρα ξέρετε πώς να **create word document c#**, να εισάγετε ένα ορθογώνιο και να **apply shadow to shape** με μια προσαρμοσμένη **set shadow distance**. +- Το παράδειγμα χρησιμοποιεί το Aspose.Words, το οποίο αφαιρεί τις πολυπλοκότητες του OpenXML και εγγυάται συνεπή απόδοση σε όλες τις εκδόσεις του Word. +- Θέλετε να προχωρήσετε παραπέρα; Δοκιμάστε να συνδυάσετε πολλαπλά σχήματα, να προσθέσετε κείμενο μέσα στο ορθογώνιο ή να εξάγετε το ίδιο έγγραφο ως PDF για να δείτε πώς μεταφράζεται η σκιά. + +### Σχετικά Θέματα που Μπορείτε Να Εξερευνήσετε + +- **How to add shape** σε μια κεφαλίδα/υποσέλιδο για branding. +- Χρήση του **Aspose.Words** για εισαγωγή διαγραμμάτων και πινάκων προγραμματιστικά. +- Προσαρμογή **shadow effects** σε εικόνες αντί για διανυσματικά σχήματα. +- Αυτοματοποίηση μαζικής δημιουργίας εγγράφων για τιμολόγια ή πιστοποιητικά. + +Μη διστάσετε να πειραματιστείτε, να σπάσετε τον κώδικα και μετά να τον ξαναχτίσετε – αυτός είναι ο πιο γρήγορος τρόπος να εδραιώσετε τις έννοιες. Αν αντιμετωπίσετε πρόβλημα, αφήστε ένα σχόλιο παρακάτω ή ελέγξτε την επίσημη τεκμηρίωση του Aspose.Words για πιο λεπτομερείς πληροφορίες API. + +Καλό κώδικα και απολαύστε το να κάνετε τα Word αρχεία σας να φαίνονται λίγο πιο επαγγελματικά! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/greek/net/programming-with-txtsaveoptions/_index.md b/words/greek/net/programming-with-txtsaveoptions/_index.md index cc4534b8cf..084b61415d 100644 --- a/words/greek/net/programming-with-txtsaveoptions/_index.md +++ b/words/greek/net/programming-with-txtsaveoptions/_index.md @@ -26,8 +26,8 @@ | --- | --- | | [Προσθήκη σημαδιών Bidi σε έγγραφο Word](./add-bidi-marks/) | Μάθετε πώς να προσθέτετε αμφίδρομα (Bidi) σημάδια σε έγγραφα Word χρησιμοποιώντας το Aspose.Words για .NET με αυτόν τον οδηγό. Εξασφαλίστε τη σωστή κατεύθυνση κειμένου για περιεχόμενο σε πολλές γλώσσες. | | [Χρήση χαρακτήρα Tab ανά επίπεδο για εσοχή λίστας](./use-tab-character-per-level-for-list-indentation/) | Μάθετε πώς να δημιουργείτε λίστες πολλαπλών επιπέδων με εσοχή με στηλοθέτες χρησιμοποιώντας το Aspose.Words για .NET. Ακολουθήστε αυτόν τον οδηγό για ακριβή μορφοποίηση λιστών στα έγγραφά σας. | -| [Χρήση κενού διαστήματος ανά επίπεδο για εσοχή λίστας](./use-space-character-per-level-for-list-indentation/) | Μάθετε πώς να δημιουργείτε λίστες πολλαπλών επιπέδων με εσοχή διαστήματος στο Aspose.Words για .NET. Οδηγός βήμα προς βήμα για ακριβή μορφοποίηση εγγράφων. | - +| [Χρήση κενού διαστήματος ανά επίπεδο για εσοχή λίστας](./use-space-character-per-level-for-list-indentation/) | Μάθετε πώς να δημιουργείτε λίστες πολλαπλών επιπέδων με εσοχή διαστήματος στο Asp Aspose.Words για .NET. Οδηγός βήμα προς βήμα για ακριβή μορφοποίηση εγγράφων. | +| [Αποθήκευση docx ως txt – Πλήρης οδηγός εξαγωγής εξισώσεων Word σε LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Μάθετε πώς να μετατρέπετε αρχεία docx σε txt και να εξάγετε εξισώσεις Word σε μορφή LaTeX με το Aspose.Words για .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/greek/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/greek/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..542e4ffeba --- /dev/null +++ b/words/greek/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Αποθηκεύστε το docx ως txt με το Aspose.Words και μετατρέψτε το Word + σε LaTeX. Μάθετε πώς να εξάγετε εξισώσεις, να διατηρείτε απλό κείμενο και να λαμβάνετε + σήμανση LaTeX σε λίγα λεπτά. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: el +og_description: Αποθηκεύστε το docx ως txt χρησιμοποιώντας το Aspose.Words. Αυτός + ο οδηγός δείχνει πώς να μετατρέψετε το Word σε LaTeX, να εξάγετε εξισώσεις και να + διατηρήσετε το έγγραφό σας σε απλό κείμενο. +og_title: Αποθήκευση docx ως txt – Εξαγωγή εξισώσεων Word σε LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Αποθήκευση docx ως txt – Πλήρης οδηγός για την εξαγωγή εξισώσεων Word σε LaTeX +url: /el/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Αποθήκευση docx ως txt – Εξαγωγή Εξισώσεων Word σε LaTeX + +Κάποτε χρειάστηκε να **αποθηκεύσετε docx ως txt** αλλά ανησυχείτε ότι θα χάσετε τα εκλεπτυσμένα μαθηματικά που κρύβονται μέσα στο αρχείο Word; Δεν είστε μόνοι. Σε πολλές επιστημονικές ροές εργασίας η έκδοση απλού κειμένου ενός εγγράφου είναι απαραίτητη, όμως θέλετε οι εξισώσεις να παραμείνουν ως καθαρό markup LaTeX. + +Σε αυτό το tutorial θα περάσουμε βήμα‑βήμα τις ακριβείς διαδικασίες για **μετατροπή Word σε LaTeX** χρησιμοποιώντας το Aspose.Words for .NET, ώστε οι εξισώσεις σας να εξαχθούν σωστά ενώ το υπόλοιπο του εγγράφου να γίνει τακτικό απλό κείμενο. Στο τέλος θα ξέρετε πώς να **εξάγετε εξισώσεις σε LaTeX**, να διατηρήσετε το υπόλοιπο αρχείο ως απλό κείμενο, και να αποφύγετε τις συνήθεις παγίδες που συναντούν οι αρχάριοι. + +## Τι Θα Μάθετε + +- Πώς να φορτώσετε ένα αρχείο *.docx* που περιέχει Office Math. +- Πώς να ορίσετε τις σωστές `TxtSaveOptions` ώστε το Aspose να εξάγει LaTeX για κάθε εξίσωση. +- Πώς να αποθηκεύσετε το αποτέλεσμα ως **απλό κείμενο Word** αρχείο που μπορείτε να τροφοδοτήσετε σε σύστημα ελέγχου εκδόσεων, CI pipelines ή οποιοδήποτε downstream εργαλείο. +- Κοινές ακραίες περιπτώσεις — τι να κάνετε όταν ένα έγγραφο συνδυάζει εικόνες και εξισώσεις, ή όταν χρειάζεστε διατήρηση χαρακτήρων Unicode. +- Ένα πλήρες, έτοιμο‑για‑εκτέλεση δείγμα κώδικα που μπορείτε να ενσωματώσετε σε μια console εφαρμογή. + +### Προαπαιτούμενα + +- .NET 6.0 ή νεότερο (ο κώδικας λειτουργεί επίσης με .NET Framework 4.7+). +- Ένα αδειοδοτημένο αντίγραφο του **Aspose.Words for .NET** (η δωρεάν δοκιμή λειτουργεί για δοκιμές). +- Visual Studio 2022 ή οποιοδήποτε IDE που μπορεί να μεταγλωττίσει έργα C#. +- Ένα έγγραφο Word (`input.docx`) που ήδη περιέχει κάποια αντικείμενα Office Math. + +> **Pro tip:** Αν δεν έχετε ακόμη άδεια, μπορείτε να ζητήσετε ένα προσωρινό κλειδί από την ιστοσελίδα της Aspose — απλώς αντικαταστήστε το placeholder στον κώδικα με το κλειδί σας πριν το τρέξετε. + +## Βήμα 1 – Εγκατάσταση Aspose.Words μέσω NuGet + +Πρώτο πράγμα: χρειάζεστε τη βιβλιοθήκη στο έργο σας. Ανοίξτε το **Package Manager Console** και εκτελέστε: + +```powershell +Install-Package Aspose.Words +``` + +Αυτή η μοναδική γραμμή φέρνει όλα όσα χρειάζεστε, συμπεριλαμβανομένου του namespace `Saving` όπου βρίσκεται η `TxtSaveOptions`. Χωρίς επιπλέον DLLs, χωρίς εγγενείς εξαρτήσεις — απλώς καθαρός managed κώδικας. + +## Βήμα 2 – Φόρτωση του Πηγαίου Εγγράφου Word + +Τώρα διαβάζουμε το αρχείο που περιέχει τις εξισώσεις. Η κλάση `Document` αφαιρεί την πλήρη δομή *.docx*, ώστε να το αντιμετωπίζετε σαν ένα υψηλού επιπέδου αντικείμενο μοντέλου. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Γιατί είναι σημαντικό:** Η φόρτωση του εγγράφου νωρίς σας επιτρέπει να ελέγξετε το δέντρο κόμβων του. Αν παραλείψετε τον έλεγχο και το αρχείο δεν έχει εξισώσεις, θα πάρετε ένα καθαρό txt αρχείο — αλλά δεν θα ξέρετε γιατί η έξοδος LaTeX είναι κενή. + +## Βήμα 3 – Διαμόρφωση TxtSaveOptions για Εξαγωγή LaTeX + +Το Aspose σας δίνει λεπτομερή έλεγχο του τρόπου απόδοσης του Office Math. Ορίζοντας το `OfficeMathExportMode` σε `LaTeX`, κάθε εξίσωση μετατρέπεται στην ισοδύναμη LaTeX αντί να αφαιρεθεί ή να μετατραπεί σε εικόνα. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Γιατί είναι σημαντικό:** Η προεπιλεγμένη λειτουργία εξαγωγής θα έριχνε τις εξισώσεις εντελώς. Η αλλαγή σε `LaTeX` διατηρεί την μαθηματική πρόθεση, κάτι που χρειάζεστε όταν αργότερα τροφοδοτείτε το αρχείο σε έναν LaTeX compiler ή σε έναν markdown επεξεργαστή που καταλαβαίνει τη σύνταξη `$…$`. + +## Βήμα 4 – Αποθήκευση του Εγγράφου ως Απλό Κείμενο + +Με τις επιλογές ρυθμισμένες, η αποθήκευση του αρχείου γίνεται με μια γραμμή κώδικα. Η έξοδος θα είναι ένα αρχείο `.txt` όπου κάθε εξίσωση εμφανίζεται ως κώδικας LaTeX περικλεισμένος σε οριοθέτες `$` (μπορείτε να το αλλάξετε αργότερα αν προτιμάτε μπλοκ `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Αναμενόμενο Αποτέλεσμα + +Ανοίξτε το `output.txt` σε οποιονδήποτε επεξεργαστή και θα δείτε κάτι σαν: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Παρατηρήστε πώς το κανονικό κείμενο παραμένει ακριβώς όπως ήταν, ενώ οι εξισώσεις έχουν μετατραπεί σε καθαρές συμβολοσειρές LaTeX. Μπορείτε να τις αντιγράψετε‑και‑επικολλήσετε απευθείας σε ένα LaTeX έγγραφο, σε ένα Jupyter notebook ή σε οποιοδήποτε εργαλείο που αποδίδει μαθηματικά. + +## Βήμα 5 – Διαχείριση Ακραίων Περιπτώσεων + +### Μικτό Περιεχόμενο (Εικόνες + Εξισώσεις) + +Αν το αρχείο Word περιέχει επίσης εικόνες, το Aspose θα τις αγνοήσει όταν χρησιμοποιείτε `TxtSaveOptions`. Αυτό είναι συνήθως αποδεκτό για μια ροή **απλού κειμένου Word**, αλλά αν χρειάζεστε τις εικόνες ως placeholders μπορείτε: + +1. Εξάγετε το έγγραφο πρώτα σε HTML (`HtmlSaveOptions`) για να συλλάβετε τις εικόνες ως ετικέτες ``. +2. Εκτελέστε δεύτερο πέρασμα με `TxtSaveOptions` για να πάρετε τις εξισώσεις σε LaTeX. +3. Συγχωνεύστε τα δύο αποτελέσματα χειροκίνητα ή με ένα μικρό script. + +### Σύμβολα Unicode + +Κάποιες εξισώσεις χρησιμοποιούν ειδικούς χαρακτήρες Unicode (π.χ. ελληνικά γράμματα). Ορίζοντας `Encoding = Encoding.UTF8` στις `TxtSaveOptions` (όπως φαίνεται στο Βήμα 3) διασφαλίζει ότι αυτά τα σύμβολα παραμένουν μετά τη μετατροπή. + +### Μεγάλα Έγγραφα + +Για τεράστια αρχεία (> 100 MB), σκεφτείτε τη ροή αποθήκευσης: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Η ροή αποφεύγει τη φόρτωση ολόκληρης της εξόδου στη μνήμη, κάτι που μπορεί να σώσει τη ζωή σας σε agents με περιορισμένη μνήμη. + +## Πλήρες Παράδειγμα Λειτουργίας + +Παρακάτω είναι το πλήρες, έτοιμο‑για‑αντιγραφή πρόγραμμα που ενώνει όλα τα παραπάνω. Απλώς αντικαταστήστε τις διαδρομές αρχείων και, αν έχετε, τη γραμμή άδειας. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Τρέξτε το πρόγραμμα (`dotnet run` αν χρησιμοποιείτε console project) και ελέγξτε το `output.txt`. Μόλις **αποθηκεύσατε docx ως txt** διατηρώντας κάθε εξίσωση ως LaTeX — χωρίς χειροκίνητη αντιγραφή‑επικόλληση. + +## Συχνές Ερωτήσεις + +**Ε: Μπορώ να αλλάξω τον οριοθέτη από `$…$` σε `\(...\)`;** +Α: Ναι. Μετά την αποθήκευση, εκτελέστε μια απλή αντικατάσταση στο αρχείο: `output = output.Replace("$", @"\(").Replace("$", @"\)");` — προσοχή όμως να μην αντικαταστήσετε τα ενσωματωμένα `$` που ανήκουν στο αρχικό κείμενο. + +**Ε: Λειτουργεί αυτό με αρχεία Word 2007‑2019;** +Α: Απόλυτα. Το Aspose.Words υποστηρίζει `.doc`, `.docx`, `.docm` και ακόμη και την πιο πρόσφατη οικογένεια `.dotx`. Ο ίδιος κώδικας λειτουργεί σε όλες τις εκδόσεις. + +**Ε: Τι κάνω αν θέλω να διατηρήσω την αρχική μορφοποίηση παραγράφων (tabs, πολλαπλά κενά);** +Α: Ορίστε `txtSaveOptions.PreserveTableLayout = true;` και `txtSaveOptions.PreserveSpace = true;` για να διατηρηθούν τα κενά. + +## Συμπέρασμα + +Καλύψαμε όλα όσα χρειάζεστε για να **αποθηκεύσετε docx ως txt** ενώ **εξάγετε εξισώσεις σε LaTeX** χρησιμοποιώντας το Aspose.Words. Τα βασικά βήματα είναι η φόρτωση του εγγράφου, η διαμόρφωση των `TxtSaveOptions` με `OfficeMathExportMode.LaTeX`, και η αποθήκευση του αποτελέσματος. Με αυτές τις τρεις γραμμές κώδικα μπορείτε αξιόπιστα να **μετατρέψετε word σε latex**, να διατηρήσετε το έγγραφό σας ως **απλό κείμενο Word**, και να αποφύγετε την απώλεια μαθηματικών συμβόλων. + +Έτοιμοι για την επόμενη πρόκληση; Δοκιμάστε να συνδυάσετε αυτή τη ροή με έναν markdown generator για να παραγάγετε ένα πλήρες αρχείο `.md` που περιλαμβάνει τόσο κείμενο όσο και LaTeX — τέλεια για τεκμηρίωση με Git ή static‑site generators. Ή εξερευνήστε τα `PdfSaveOptions` του Aspose για να αποκτήσετε μια έκδοση PDF παράλληλα με το απλό κείμενο. + +Αν αντιμετωπίσετε δυσκολίες, αφήστε ένα σχόλιο παρακάτω. Καλό coding, και απολαύστε την απλότητα της μετατροπής εξισώσεων Word σε καθαρό LaTeX! + +![Εικονογράφηση αποθήκευσης DOCX ως TXT με εξισώσεις LaTeX](placeholder-image.png "παράδειγμα αποθήκευσης docx ως txt") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/greek/net/working-with-fonts/_index.md b/words/greek/net/working-with-fonts/_index.md index ede9a6e5a7..681954c6c8 100644 --- a/words/greek/net/working-with-fonts/_index.md +++ b/words/greek/net/working-with-fonts/_index.md @@ -29,7 +29,7 @@ | [Λήψη απόστασης γραμματοσειράς](./get-font-line-spacing/) | Μάθετε πώς να βρείτε απόσταση μεταξύ γραμματοσειρών χρησιμοποιώντας το Aspose.Words για .NET με αυτό το βήμα προς βήμα σεμινάριο. Ιδανικό για προγραμματιστές. | | [Έλεγχος εφέ κειμένου DrawingML](./check-drawingml-text-effect/) Μάθετε πώς να ελέγχετε τα εφέ κειμένου DrawingML σε έγγραφα Word χρησιμοποιώντας το Aspose.Words για .NET με τον λεπτομερή, βήμα προς βήμα οδηγό μας. Βελτιώστε τα έγγραφά σας με ευκολία. | | [Ορισμός μορφοποίησης γραμματοσειράς](./set-font-formatting/) | Μάθετε πώς να ορίζετε τη μορφοποίηση γραμματοσειρών σε έγγραφα Word χρησιμοποιώντας το Aspose.Words για .NET. Ακολουθήστε τον λεπτομερή οδηγό μας βήμα προς βήμα για να βελτιώσετε την αυτοματοποίηση των εγγράφων σας. | -| [Ορισμός σημαδιού έμφασης γραμματοσειράς](./set-font-emphasis-mark/) | Μάθετε πώς να ορίζετε σημάδια έμφασης γραμματοσειράς σε έγγραφα Word χρησιμοποιώντας το Aspose.Words για .NET με αυτόν τον λεπτομερή οδηγό βήμα προς βήμα. Ιδανικό για προγραμματιστές .NET. | +| [Ορισμός σημαδιού έμφασης γραμματοσειράς](./set-font-emphasis-mark/) | Μάθετε πώς να ορίζετε σημάδια έμφασης γραμματοσειράς σε έγγραφα Word χρησιμοποιώντας το Aspose.Words για .NET με αυτόν τον λεπτομερής οδηγό βήμα προς βήμα. Ιδανικό για προγραμματιστές .NET. | | [Ορισμός φακέλων γραμματοσειρών](./set-fonts-folders/) | Μάθετε πώς να ορίζετε προσαρμοσμένους φακέλους γραμματοσειρών στο Aspose.Words για .NET με αυτόν τον ολοκληρωμένο οδηγό βήμα προς βήμα. Ιδανικό για προγραμματιστές που θέλουν να βελτιώσουν τις γραμματοσειρές εγγράφων. | | [Ενεργοποίηση Απενεργοποίηση Υποκατάστασης Γραμματοσειράς](./enable-disable-font-substitution/) | Μάθετε πώς να ενεργοποιείτε ή να απενεργοποιείτε την αντικατάσταση γραμματοσειρών σε έγγραφα του Word χρησιμοποιώντας το Aspose.Words για .NET. Βεβαιωθείτε ότι τα έγγραφά σας φαίνονται ομοιόμορφα σε όλες τις πλατφόρμες. | | [Ορισμός ρυθμίσεων εφεδρικής γραμματοσειράς](./set-font-fallback-settings/) | Μάθετε πώς να ορίζετε ρυθμίσεις αντικατάστασης γραμματοσειρών στο Aspose.Words για .NET και να προσαρμόζετε την αντικατάσταση γραμματοσειρών στα έγγραφά σας στο Word. | @@ -48,8 +48,7 @@ | [Λήψη ειδοποίησης προειδοποίησης](./receive-warning-notification/) Μάθετε πώς να λαμβάνετε μια ειδοποίηση προειδοποίησης όταν χρησιμοποιείτε το Aspose.Words για .NET και να διαχειρίζεστε τυχόν προβλήματα ή προειδοποιήσεις στα έγγραφά σας. | | [Παράδειγμα Πηγής Γραμματοσειράς Πόρων Steam](./resource-steam-font-source-example/) | Μάθετε πώς να χρησιμοποιείτε το Resource Stream Font Source για να φορτώνετε προσαρμοσμένες γραμματοσειρές στο Aspose.Words για .NET. | | [Λήψη αντικατάστασης χωρίς επιθήματα](./get-substitution-without-suffixes/) | Σε αυτό το σεμινάριο, μάθετε πώς να λαμβάνετε παρακάμψεις χωρίς επιθήματα σε ένα έγγραφο του Word με το Aspose.Words για .NET. | - - +| [Αντικατάσταση Γραμματοσειράς Aspose – Πώς να Διαμορφώσετε Ρυθμίσεις Γραμματοσειράς σε C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Μάθετε πώς να ρυθμίσετε την αντικατάσταση γραμματοσειρών και τις ρυθμίσεις γραμματοσειράς στο Aspose.Words για .NET με C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/greek/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/greek/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..909200648b --- /dev/null +++ b/words/greek/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: 'Η αντικατάσταση γραμματοσειρών Aspose έγινε εύκολη: μάθετε πώς να ρυθμίζετε + τις ρυθμίσεις γραμματοσειρών, να καταγράφετε προειδοποιήσεις και να διαχειρίζεστε + τις ελλείπουσες γραμματοσειρές στις .NET εφαρμογές σας.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: el +og_description: Κατακτήστε την αντικατάσταση γραμματοσειρών Aspose διαμορφώνοντας + τις ρυθμίσεις γραμματοσειρών και διαχειριζόμενοι τις ελλειπούσες γραμματοσειρές + με κλήση προειδοποίησης. Πλήρης οδηγός C#. +og_title: Αντικατάσταση γραμματοσειρών Aspose – Διαμόρφωση ρυθμίσεων γραμματοσειράς + σε C# +tags: +- Aspose.Words +- C# +- Font Management +title: Αντικατάσταση Γραμματοσειρών Aspose – Πώς να Διαμορφώσετε τις Ρυθμίσεις Γραμματοσειράς + σε C# +url: /el/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Πλήρης Οδηγός για τη Διαμόρφωση Ρυθμίσεων Γραμματοσειρών + +Έχετε συναντήσει ποτέ ένα έγγραφο που ξαφνικά αντικαθιστά την προσαρμοσμένη γραμματοσειρά σας με κάτι γενικό; Αυτό είναι η **aspose font substitution** που κάνει τη δουλειά της—αντικαθιστώντας τις ελλείπουσες γραμματοσειρές με το πιο κοντινό αντίστοιχο που μπορεί να βρει. Είναι χρήσιμη, αλλά αν χρειάζεστε να γνωρίζετε *ακριβώς* ποια γραμματοσειρά αντικαταστάθηκε, πρέπει να αξιοποιήσετε το σύστημα προειδοποιήσεων της βιβλιοθήκης και να διαμορφώσετε τις ρυθμίσεις γραμματοσειρών μόνοι σας. + +Σε αυτό το tutorial θα περάσουμε από ένα πραγματικό σενάριο: φόρτωση ενός DOCX που αναφέρεται σε γραμματοσειρά που δεν έχετε, καταγραφή του γεγονότος αντικατάστασης και εκτύπωση ενός φιλικού μηνύματος στην κονσόλα. Στο τέλος θα είστε άνετοι με **configure font settings**, τη σύνδεση ενός **Aspose.Words warning callback**, και την επέκταση του παραδείγματος για οποιαδήποτε ροή εργασίας. + +> **Τι θα χρειαστείτε** +> • .NET 6+ (ή .NET Framework 4.7.2+) +> • Aspose.Words for .NET (τελευταίο NuGet) +> • Ένα DOCX που αναφέρει μια ελλείπουσα γραμματοσειρά (θα το ονομάσουμε `MissingFont.docx`) + +Ας βουτήξουμε. + +--- + +## Step 1: Install Aspose.Words and Prepare the Project + +Πριν γράψουμε κώδικα, βεβαιωθείτε ότι το πακέτο Aspose.Words είναι αναφορά: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro tip:** Χρησιμοποιήστε την πιο πρόσφατη σταθερή έκδοση· από τον Μάρτιο 2026 είναι η 23.11.0. Οι νεότερες εκδόσεις βελτιώνουν τους αλγόριθμους αντιστοίχισης γραμματοσειρών και προσθέτουν επιπλέον τύπους προειδοποιήσεων. + +Δημιουργήστε μια νέα εφαρμογή console (ή ενσωματώστε τον κώδικα σε υπάρχον έργο) και προσθέστε τις συνηθισμένες οδηγίες `using`: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Αυτοί οι χώροι ονομάτων μας δίνουν πρόσβαση στα `Document`, `LoadOptions` και στις κλάσεις σχετικές με τις γραμματοσειρές που θα χρειαστούμε. + +--- + +## Step 2: Configure Font Settings with LoadOptions + +Η καρδιά του ελέγχου **aspose font substitution** βρίσκεται στο `LoadOptions.FontSettings`. Παρέχοντας ένα κενό αντικείμενο `FontSettings` λέμε στην Aspose να χρησιμοποιήσει τις προεπιλεγμένες διαδρομές αναζήτησης *και* να αναφέρει οποιαδήποτε αντικατάσταση μέσω μιας προειδοποίησης. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Γιατί να μην βασιστούμε μόνο στις προεπιλογές; Επειδή η προσθήκη μιας προειδοποίησης (βήμα επόμενο) λειτουργεί μόνο όταν η ιδιότητα `FontSettings` δεν είναι `null`. Αυτή η μικρή γραμμή μας δίνει ένα σημείο πρόσβασης στη διαδικασία αντικατάστασης χωρίς να αλλάζει τη συμπεριφορά αναζήτησης γραμματοσειρών. + +--- + +## Step 3: Attach a Warning Callback to Capture Substitutions + +Η Aspose.Words υλοποιεί τη διεπαφή `IWarningCallback`. Όποτε συμβαίνει κάτι αξιοσημείωτο—όπως μια ελλείπουσα γραμματοσειρά—καλεί τη μέθοδο `Warning`. Θα υλοποιήσουμε έναν μικρό χειριστή που φιλτράρει για `WarningType.FontSubstitution` και εκτυπώνει την περιγραφή. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +Και ο ίδιος ο χειριστής: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Γιατί είναι σημαντικό** – Χωρίς την προειδοποίηση, η Aspose αντικαθιστά σιωπηλά τις γραμματοσειρές και δεν ξέρετε ποια χρησιμοποιήθηκε. Η προειδοποίηση κάνει τη διαδικασία διαφανή, κάτι που είναι απαραίτητο για αναφορές συμμόρφωσης ή για εντοπισμό προβλημάτων διάταξης. + +--- + +## Step 4: Load the Document Using the Configured Options + +Τώρα φορτώνουμε το έγγραφο, περνώντας το `loadOptions` που μόλις προετοιμάσαμε. Αν το αρχείο πηγής αναφέρει μια γραμματοσειρά που δεν είναι εγκατεστημένη, ο χειριστής μας θα ενεργοποιηθεί. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Αντικαταστήστε το `YOUR_DIRECTORY` με την πραγματική διαδρομή όπου βρίσκεται το `MissingFont.docx`. Όταν εκτελέσετε το πρόγραμμα, θα δείτε έξοδο παρόμοια με: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Αυτή η γραμμή σας λέει ακριβώς ποια γραμματοσειρά έλειπε και ποια εναλλακτική επέλεξε η Aspose. + +--- + +## Step 5: (Optional) Fine‑Tune Font Search Paths + +Αν έχετε έναν ιδιωτικό φάκελο με εταιρικές γραμματοσειρές, μπορείτε να πείτε στην Aspose πού να ψάξει πριν επιστρέψει στις συστημικές γραμματοσειρές. Αυτό είναι μια προχωρημένη χρήση του **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Ορίζοντας `recursive: true` η Aspose θα σαρώσει και τους υποφακέλους. Τώρα η βιβλιοθήκη θα δοκιμάσει πρώτα τις ιδιωτικές σας γραμματοσειρές, μειώνοντας την πιθανότητα ανεπιθύμητης αντικατάστασης. + +--- + +## Full Working Example + +Συνδυάζοντας όλα τα παραπάνω, εδώ είναι το πλήρες, έτοιμο‑για‑εκτέλεση πρόγραμμα: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Αναμενόμενη έξοδος** (όταν εντοπιστεί ελλείπουσα γραμματοσειρά): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Αν όλες οι γραμματοσειρές υπάρχουν, το πρόγραμμα εκτελείται σιωπηλά (χωρίς προειδοποιήσεις) και παράγει το PDF. + +--- + +## Common Questions & Edge Cases + +### What if I need to *prevent* substitution altogether? + +Ορίστε το `FontSettings.SubstitutionSettings` σε `null` ή χρησιμοποιήστε το `FontSettings.FontSubstitutionSettings` για να ελέγξετε τη συμπεριφορά. Για παράδειγμα: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Τώρα η Aspose θα ρίξει εξαίρεση αντί να αντικαθιστά σιωπηλά, η οποία μπορεί να πιαστεί και να διαχειριστεί. + +### Does this work with other file formats (e.g., .doc, .rtf)? + +Απόλυτα. Το ίδιο αντικείμενο `LoadOptions` μπορεί να περάσει σε οποιονδήποτε κατασκευαστή `Document` που δέχεται διαδρομή αρχείου. Η προειδοποίηση θα ενεργοποιηθεί για όλες τις μορφές που εξαρτώνται από γραμματοσειρές. + +### Can I capture the *exact* fallback font name? + +Ναι. Η συμβολοσειρά `info.Description` περιέχει τόσο τη λείπουσα γραμματοσειρά όσο και την αντικατάσταση. Αν χρειάζεστε το όνομα προγραμματιστικά, μπορείτε να το αναλύσετε ή να χρησιμοποιήσετε το αντικείμενο `FontInfo` (διαθέσιμο σε νεότερες εκδόσεις). + +### How does this behave in a multi‑threaded environment? + +Το `FontSettings` **δεν** είναι thread‑safe. Δημιουργήστε ξεχωριστό `LoadOptions` (με το δικό του `FontSettings`) ανά νήμα, ή προστατεύστε την πρόσβαση με κλείδωμα. + +--- + +## Conclusion + +Καλύψαμε όλα όσα χρειάζεστε για να κυριαρχήσετε στην **aspose font substitution** και στη **configure font settings** σε εφαρμογή C#: + +1. Εγκαταστήστε το Aspose.Words και προσθέστε τις απαραίτητες δηλώσεις `using`. +2. Δημιουργήστε ένα αντικείμενο `LoadOptions` με νέο `FontSettings`. +3. Συνδέστε ένα προσαρμοσμένο `IWarningCallback` για να εμφανίζετε γεγονότα αντικατάστασης. +4. Φορτώστε το έγγραφο, αφήνοντας τον χειριστή να αναφέρει τυχόν ελλείπουσες γραμματοσειρές. +5. (Προαιρετικά) Επεκτείνετε τη διαδρομή αναζήτησης ή απενεργοποιήστε εντελώς την αντικατάσταση. + +Με αυτό το μοτίβο μπορείτε να καταγράψετε ελλείπουσες γραμματοσειρές για συμμόρφωση, να ειδοποιήσετε χρήστες σε UI, ή να ενσωματώσετε αυτόματα εναλλακτικές γραμματοσειρές πριν τη δημοσίευση. Στο επόμενο βήμα, εξερευνήστε τις **Aspose.Words font substitution policies** ή ενσωματώστε τη ροή εργασίας σε ένα μεγαλύτερο pipeline επεξεργασίας εγγράφων. + +Καλή προγραμματιστική δουλειά, και ας εμφανίζονται πάντα τα έγγραφά σας με τη σωστή γραμματοσειρά! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hindi/net/basic-conversions/_index.md b/words/hindi/net/basic-conversions/_index.md index 70ed6aec19..11887f4e93 100644 --- a/words/hindi/net/basic-conversions/_index.md +++ b/words/hindi/net/basic-conversions/_index.md @@ -32,9 +32,10 @@ | [टेक्स्ट फ़ाइल को वर्ड डॉक्यूमेंट में बदलें](./txt-to-docx/) | .NET के लिए Aspose.Words का उपयोग करके टेक्स्ट फ़ाइलों को Word दस्तावेज़ों में परिवर्तित करना सीखें। हमारे व्यापक गाइड के साथ दस्तावेज़ रूपांतरणों को कुशलतापूर्वक प्रबंधित करें। | | [पीडीएफ को जेपीईजी के रूप में सहेजें](./pdf-to-jpeg/) | .NET के लिए Aspose.Words का उपयोग करके PDF को JPEG में आसानी से बदलें। उदाहरणों और FAQ के साथ हमारी विस्तृत मार्गदर्शिका का पालन करें। डेवलपर्स और उत्साही लोगों के लिए बिल्कुल सही। | | [पीडीएफ को वर्ड फॉर्मेट में सहेजें (Docx)](./pdf-to-docx/) | इस विस्तृत, चरण-दर-चरण मार्गदर्शिका में जानें कि .NET के लिए Aspose.Words का उपयोग करके PDF को Word दस्तावेज़ (Docx) में कैसे परिवर्तित किया जाए। डेवलपर्स के लिए बिल्कुल सही। | -| [Word से LaTeX निर्यात कैसे करें – चरण‑दर‑चरण मार्गदर्शिका](./how-to-export-latex-from-word-step-by-step-guide/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ से LaTeX फ़ॉर्मेट में निर्यात करने का चरण‑दर‑चरण मार्गदर्शन। | +| [Word से LaTeX निर्यात कैसे करें – चरण‑दर‑चरण मार्गदर्शिका](./how-to-export-latex-from-word-step-by-step-guide/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ से LaTeX फ़ॉर्मेट में निर्यात करने का चरण‑दर‑स्टेप मार्गदर्शन। | | [C# में Aspose.Words का उपयोग करके वर्ड को PDF में बदलें – गाइड](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | C# में Aspose.Words से Word फ़ाइल को PDF में बदलने की चरण‑दर‑स्टेप गाइड। | | [Aspose.Words के साथ Word को PDF के रूप में सहेजें – पूर्ण C# गाइड](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Aspose.Words का उपयोग करके C# में Word फ़ाइल को PDF में सहेजने की पूरी गाइड। | +| [Aspose.Words के साथ Word को PDF में बदलें – पूर्ण गाइड](./convert-word-to-pdf-with-aspose-words-complete-guide/) | .NET के लिए Aspose.Words का उपयोग करके Word फ़ाइल को PDF में बदलने की पूरी गाइड। चरण‑दर‑स्टेप विवरण। | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hindi/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/hindi/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..a661b813b4 --- /dev/null +++ b/words/hindi/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words का उपयोग करके Word को PDF में तेज़ी से बदलें। जानें कैसे + Word को PDF के रूप में सहेजें, docx को PDF में निर्यात करें, और C# में सुलभ PDF + बनाएं। +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: hi +og_description: Aspose.Words का उपयोग करके C# में Word को PDF में बदलें। यह गाइड दिखाता + है कि Word को PDF के रूप में कैसे सहेजें, docx को PDF में निर्यात करें, और सुलभ + PDF बनाएं। +og_title: Aspose.Words के साथ Word को PDF में परिवर्तित करें – चरण-दर-चरण +tags: +- Aspose.Words +- C# +- PDF conversion +title: Aspose.Words के साथ Word को PDF में बदलें – पूर्ण गाइड +url: /hi/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose.Words के साथ Word को PDF में बदलें – पूर्ण गाइड + +क्या आपने कभी सोचा है कि **Word को PDF में कैसे बदलें** बिना थर्ड‑पार्टी वेब टूल्स के झंझट के? शायद आप एक ऑटोमेटेड रिपोर्ट इंजन बना रहे हैं और तुरंत *save word as pdf* करने का भरोसेमंद तरीका चाहिए। अच्छी खबर यह है कि Aspose.Words इस पूरी प्रक्रिया को आसान बनाता है, और आप **PDF/UA‑2** अनुरूप फ़ाइल भी बना सकते हैं—एक्सेसिबिलिटी आवश्यकताओं के लिए एकदम उपयुक्त। + +इस ट्यूटोरियल में हम सब कुछ कवर करेंगे: `.docx` लोड करना, PDF विकल्पों को कॉन्फ़िगर करना ताकि आप *export docx to pdf* PDF/UA अनुरूपता के साथ कर सकें, और अंत में परिणाम को एक एक्सेसिबल PDF के रूप में सहेजना। अंत तक आपके पास एक स्व-समाहित, प्रोडक्शन‑रेडी स्निपेट होगा जिसे आप किसी भी .NET प्रोजेक्ट में डाल सकते हैं। + +![Aspose.Words का उपयोग करके Word को PDF में बदलें](convert-word-to-pdf.png) + +## आप क्या सीखेंगे + +- **Aspose.Words** क्यों *generate accessible pdf* परिदृश्यों के लिए एक ठोस विकल्प है। +- PDF/UA‑2 अनुरूपता के साथ *save document as pdf* करने के सटीक चरण। +- सामान्य किनारे के मामलों को कैसे संभालें जैसे कि गायब फ़ॉन्ट या पासवर्ड‑सुरक्षित स्रोत फ़ाइलें। +- आउटपुट को डिबग करने और एक्सेसिबिलिटी अनुपालन की जाँच करने के त्वरित टिप्स। + +### आवश्यकताएँ + +- .NET 6 या बाद का (API .NET Framework 4.6+ पर भी काम करता है)। +- एक वैध Aspose.Words for .NET लाइसेंस (मुफ़्त ट्रायल मूल्यांकन के लिए काम करता है)। +- बेसिक C# ज्ञान—कोई जटिल पैटर्न आवश्यक नहीं। + +यदि आपके पास ये सब है, तो चलिए शुरू करते हैं। + +--- + +## Word को PDF में बदलें – चरण‑दर‑चरण कार्यान्वयन + +हम समाधान को पाँच स्पष्ट चरणों में विभाजित करेंगे। प्रत्येक चरण में एक शीर्षक, एक छोटा कोड अंश, और *कोड क्यों महत्वपूर्ण है* की व्याख्या होगी। + +### चरण 1: वह Word दस्तावेज़ लोड करें जिसे आप बदलना चाहते हैं + +सबसे पहले आपको एक `Document` ऑब्जेक्ट चाहिए जो स्रोत फ़ाइल का प्रतिनिधित्व करता है। Aspose.Words **.docx**, **.doc**, **.rtf**, और कई अन्य फ़ॉर्मेट पढ़ता है, इसलिए आप *save word as pdf* किसी भी मूल फ़ॉर्मेट से कर सकते हैं। + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**यह क्यों महत्वपूर्ण है:** +- फ़ाइल को जल्दी लोड करने से आप गायब‑फ़ाइल त्रुटियों को CPU चक्र बर्बाद करने से पहले पकड़ सकते हैं। +- `Document` क्लास Word फ़ाइल की आंतरिक संरचना को एब्स्ट्रैक्ट करती है, जिससे आपको एक साफ़ ऑब्जेक्ट मॉडल मिलता है। + +### चरण 2: एक्सेसिबिलिटी के लिए PDF सेव ऑप्शन कॉन्फ़िगर करें + +यदि आपको *generate accessible pdf* फ़ाइलें चाहिए, तो आपको Aspose.Words को PDF/UA‑2 अनुरूप दस्तावेज़ बनाने के लिए कहना होगा। `PdfSaveOptions` क्लास आउटपुट पर सूक्ष्म नियंत्रण देती है। + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**यह क्यों महत्वपूर्ण है:** +- `PdfCompliance.PdfUa2` लाइब्रेरी को आवश्यक टैग, संरचना जानकारी, और मेटाडेटा जोड़ने के लिए कहता है, जिस पर स्क्रीन‑रीडर्स निर्भर करते हैं। +- फ़ॉन्ट एम्बेड करना (`EmbedFullFonts = true`) विभिन्न OS पर PDF खोलने पर “फ़ॉन्ट नहीं मिला” चेतावनियों से बचाता है। +- `Title` सेट करने से सहायक तकनीकों को दस्तावेज़ सही ढंग से घोषित करने में मदद मिलती है। + +### चरण 3: दस्तावेज़ को PDF के रूप में सहेजें + +अब स्रोत लोड हो चुका है और विकल्प सेट हो चुके हैं, वास्तविक परिवर्तन एक‑लाइनर है। यही वह जगह है जहाँ आप *export docx to pdf* करते हैं। + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**यह क्यों महत्वपूर्ण है:** +- `Save` मेथड हमारे द्वारा कॉन्फ़िगर किए गए `PdfSaveOptions` को सम्मानित करता है, जिससे एक्सेसिबिलिटी फीचर अंत में सम्मिलित हो जाते हैं। +- `try/catch` ब्लॉक में कॉल को रैप करने से आप लाइसेंस या अनुमति त्रुटियों को लॉग या प्रदर्शित कर सकते हैं, जो अक्सर नए उपयोगकर्ताओं को अटकाते हैं। + +### चरण 4: PDF/UA अनुरूपता की जाँच करें (वैकल्पिक लेकिन अनुशंसित) + +भले ही Aspose.Words भारी काम कर देता है, आउटपुट को दोबारा जांचना अच्छा अभ्यास है, विशेषकर जब आप दस्तावेज़ सरकारी एजेंसियों या अन्य नियामक संस्थाओं को दे रहे हों। + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**यह क्यों महत्वपूर्ण है:** +- `IsTagged` एक त्वरित sanity check है; पूर्ण PDF/UA वैलिडेशन के लिए समर्पित वैलिडेटर चाहिए, लेकिन अधिकांश अनुपालन समस्याएँ टैग की कमी के रूप में सामने आती हैं। +- यदि फ़्लैग `false` लौटाता है, तो आप `PdfSaveOptions` को फिर से देख सकते हैं—शायद आपने `Compliance` सेट करना भूल गए या स्रोत दस्तावेज़ में उचित हेडिंग स्टाइल नहीं थे। + +### चरण 5: सामान्य समस्याएँ एवं प्रो टिप्स + +| समस्या | क्या होता है | समाधान | +|---------|--------------|------------| +| **Missing fonts** | PDF में टेक्स्ट बॉक्स की तरह दिखता है। | `EmbedFullFonts = true` सेट करें **या** सर्वर पर गायब फ़ॉन्ट इंस्टॉल करें। | +| **Unlicensed library** | Aspose हर पेज पर वॉटरमार्क जोड़ता है। | लाइसेंस फ़ाइल (`Aspose.Words.lic`) को एप्लिकेशन की शुरुआत में जोड़ें (जैसे `License license = new License(); license.SetLicense("Aspose.Words.lic");`)। | +| **Password‑protected source** | `new Document(path)` पर `InvalidOperationException` आता है। | ओवरलोड `new Document(path, new LoadOptions { Password = "secret" })` का उपयोग करें। | +| **Large documents cause OOM** | बड़े फ़ाइलों पर Out‑of‑memory एक्सेप्शन। | `PdfSaveOptions` में `MemoryOptimization` सक्षम करें (`saveOptions.MemoryOptimization = true`)। | +| **Accessibility tags missing** | PDF/UA वैलिडेशन फेल हो जाता है। | सुनिश्चित करें कि स्रोत Word फ़ाइल उचित हेडिंग स्टाइल (`Heading 1`, `Heading 2`, आदि) उपयोग करती है—Aspose इन्हें स्वचालित रूप से PDF टैग में मैप करता है। | + +**प्रो टिप:** यदि आप कई दस्तावेज़ों को बैच में बदल रहे हैं, तो एक ही `PdfSaveOptions` इंस्टेंस को पुन: उपयोग करें। इसे एक बार बनाना अलोकेशन ओवरहेड को कम करता है और मेमोरी फुटप्रिंट को न्यूनतम रखता है। + +--- + +## पूर्ण कार्यशील उदाहरण (कॉपी‑पेस्ट तैयार) + +नीचे पूरा प्रोग्राम दिया गया है जो सभी भागों को जोड़ता है। इसे `Program.cs` के रूप में सहेजें, Aspose.Words और Aspose.PDF NuGet पैकेज जोड़ें, और चलाएँ। + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**अपेक्षित परिणाम:** +`C:\MyFiles` में `output.pdf` नाम की फ़ाइल बनती है। इसे Adobe Acrobat में खोलने पर कंप्लायंस पैनल में “PDF/A‑2b, PDF/UA‑1” दिखेगा, यह पुष्टि करते हुए कि आपने सफलतापूर्वक *convert word to pdf* किया है। + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hindi/net/programming-with-markdownsaveoptions/_index.md b/words/hindi/net/programming-with-markdownsaveoptions/_index.md index a4246ab390..8e2ef743c9 100644 --- a/words/hindi/net/programming-with-markdownsaveoptions/_index.md +++ b/words/hindi/net/programming-with-markdownsaveoptions/_index.md @@ -30,8 +30,11 @@ MarkdownSaveOptions के साथ वर्ड प्रोसेसिंग | [DOCX को मार्कडाउन में सहेजें – LaTeX समीकरणों के साथ पूर्ण C# गाइड](./save-docx-as-markdown-complete-c-guide-with-latex-equations/) | C# में LaTeX समीकरणों के साथ DOCX को मार्कडाउन में बदलने की पूरी गाइड। | | [DOCX को मार्कडाउन के रूप में सहेजें – इमेज एक्सट्रैक्शन के साथ पूर्ण C# गाइड](./save-docx-as-markdown-full-c-guide-with-image-extraction/) | इमेज एक्सट्रैक्शन के साथ DOCX को मार्कडाउन में बदलने की पूरी गाइड। C# में चरण‑दर‑चरण प्रक्रिया। | | [Word से Markdown निर्यात कैसे करें – पूर्ण C# गाइड](./how-to-export-markdown-from-word-complete-c-guide/) | Word दस्तावेज़ को Markdown में निर्यात करने की पूरी C# गाइड | +| [Word से मार्कडाउन बनाएं – पूर्ण C# गाइड](./create-markdown-from-word-full-c-guide/) | Word दस्तावेज़ को मार्कडाउन में बदलने की पूरी C# गाइड | | [DOCX को मार्कडाउन में बदलें – चरण‑दर‑चरण गाइड](./how-to-save-markdown-from-docx-step-by-step-guide/) | DOCX फ़ाइल को मार्कडाउन में बदलने की चरण‑दर‑चरण प्रक्रिया सीखें। | | [DOCX से Markdown निर्यात कैसे करें – पूरी गाइड](./how-to-export-markdown-from-docx-complete-guide/) | DOCX फ़ाइल को Markdown में निर्यात करने की विस्तृत चरण‑दर‑चरण गाइड। | +| [Word से LaTeX निर्यात कैसे करें – DOCX को Markdown में बदलें](./how-to-export-latex-from-word-convert-docx-to-markdown/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ से LaTeX निर्यात करके DOCX को Markdown में बदलना सीखें। | +| [DOCX से LaTeX निर्यात – Markdown में बदलें](./how-to-export-latex-from-docx-convert-to-markdown/) | .NET के लिए Aspose.Words का उपयोग करके DOCX से LaTeX निर्यात करके उसे Markdown में बदलना सीखें। | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hindi/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/hindi/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..7a11dfb8ae --- /dev/null +++ b/words/hindi/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words C# के साथ Word से मार्कडाउन बनाएं। एक ही ट्यूटोरियल में + docx को मार्कडाउन में बदलना, Word से इमेज निकालना, और कॉलबैक का उपयोग कैसे करें, + सीखें। +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: hi +og_description: Aspose.Words का उपयोग करके Word से markdown बनाएं। यह गाइड दिखाता + है कि docx को markdown में कैसे बदलें, Word से छवियों को कैसे निकालें, और संसाधन + प्रबंधन के लिए कॉलबैक का उपयोग कैसे करें। +og_title: Word से मार्कडाउन बनाएं – पूर्ण C# ट्यूटोरियल +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: वर्ड से मार्कडाउन बनाएं – पूर्ण C# गाइड +url: /hi/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word से markdown बनाएं – पूर्ण C# ट्यूटोरियल + +क्या आपको **Word से markdown बनाना** पड़ा है लेकिन शुरू करने का तरीका नहीं पता था? आप अकेले नहीं हैं; कई डेवलपर्स को .docx फ़ाइल की सामग्री को static‑site generator या दस्तावेज़ रिपॉज़िटरी में ले जाने पर यही समस्या आती है। अच्छी खबर? Aspose.Words के साथ आप **docx को markdown में बदल सकते** हैं, मूल फ़ाइल से हर इमेज निकाल सकते हैं, और यह तय कर सकते हैं कि ये संसाधन कहाँ रखे जाएँ—सब कुछ एक सरल callback के साथ। + +इस गाइड में हम एक वास्तविक उदाहरण के माध्यम से दिखाएंगे कि Word से इमेज कैसे निकालें, callback का उपयोग करके उन्हें कहाँ सहेजें, और क्यों यह तरीका ऑटोमेशन पाइपलाइन के लिए सबसे भरोसेमंद है। अंत तक आपके पास एक तैयार‑चलाने‑योग्य C# प्रोग्राम होगा जो एक साफ़ `.md` फ़ाइल और निकाली गई इमेजों का फ़ोल्डर बनाता है। + +> **Pro tip:** यदि आपके पास पहले से ही एक Word टेम्पलेट है जिसमें स्क्रीनशॉट, डायग्राम या लोगो शामिल हैं, तो यह विधि हर दृश्य तत्व को बिना मैन्युअल कॉपी‑पेस्ट के संरक्षित रखेगी। + +--- + +## आपको क्या चाहिए + +- **.NET 6+** (या .NET Framework 4.6+). कोड किसी भी हालिया रनटाइम पर काम करता है। +- **Aspose.Words for .NET** (NuGet पैकेज `Aspose.Words`). अधिकांश परिदृश्यों के लिए मुफ्त ट्रायल पर्याप्त है। +- एक **Word दस्तावेज़** (`input.docx`) जिसमें टेक्स्ट और कम से कम एक इमेज हो। +- C# और Visual Studio (या आपका पसंदीदा IDE) की बुनियादी समझ। + +कोई अतिरिक्त लाइब्रेरी आवश्यक नहीं—बाकी सब कुछ Aspose.Words स्वयं संभालता है। + +--- + +## चरण 1: प्रोजेक्ट सेट अप करें और Aspose.Words इंस्टॉल करें + +साफ़-सुथरा रखने के लिए, एक नया कंसोल प्रोजेक्ट शुरू करें: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **यह चरण क्यों महत्वपूर्ण है:** NuGet पैकेज इंस्टॉल करने से आपको नवीनतम API मिलती है, जिसमें संस्करण 22.9 में पेश किया गया `MarkdownSaveOptions` क्लास शामिल है। इसके बिना आपको एक कस्टम कन्वर्टर लिखना पड़ता। + +--- + +## चरण 2: स्रोत Word दस्तावेज़ लोड करें + +कोड की पहली पंक्ति वह `.docx` खोलती है जिसे आप बदलना चाहते हैं। `YOUR_DIRECTORY` को अपने मशीन पर वास्तविक पथ से बदलें। + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **क्या हो रहा है?** `Document` फ़ाइल को पार्स करता है, एक आंतरिक DOM बनाता है, और हर पैराग्राफ, टेबल और इमेज को एक्सेस करने योग्य बनाता है। यदि फ़ाइल नहीं मिलती, तो Aspose एक स्पष्ट `FileNotFoundException` फेंकेगा, जिसे आप अधिक सुगम UI के लिए पकड़ सकते हैं। + +--- + +## चरण 3: रिसोर्स‑सेविंग Callback के साथ Markdown Save Options कॉन्फ़िगर करें + +यहीं पर **callback** का जादू आता है। Callback आपको यह तय करने देता है कि प्रत्येक निकाली गई इमेज कहाँ रखी जाए। + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Callback क्यों?** डिफ़ॉल्ट रूप से Aspose इमेज को markdown के अंदर base‑64 स्ट्रिंग के रूप में एम्बेड करता है—जो संस्करण नियंत्रण के लिए दुःस्वप्न है। Callback आपको फ़ाइल नाम और फ़ोल्डर संरचना पर पूर्ण नियंत्रण देता है। + +--- + +## चरण 4: दस्तावेज़ को Markdown के रूप में सहेजें + +अब हम वास्तविक `.md` फ़ाइल जेनरेट करते हैं। सभी इमेजें अगले चरण में परिभाषित callback को सौंप दी जाएँगी। + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +यदि सब ठीक रहा, तो आपको लक्ष्य फ़ोल्डर में `Document.md` और `Resources` नामक एक सब‑फ़ोल्डर मिलेगा जिसमें मूल Word फ़ाइल से निकाली गई सभी तस्वीरें होंगी। + +--- + +## चरण 5: प्रत्येक निकाली गई इमेज को सहेजने वाला Callback लागू करें + +नीचे `MyResourceSaver` की पूरी इम्प्लीमेंटेशन दी गई है। यह `Resources` डायरेक्टरी बनाता है (यदि मौजूद नहीं है), प्रत्येक इमेज के लिए एक अनोखा फ़ाइलनाम बनाता है, और इमेज स्ट्रीम को डिस्क पर लिखता है। + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **आर्ग्यूमेंट्स की व्याख्या:** +> - `args.Index` – शून्य‑आधारित काउंटर जो अनोखापन सुनिश्चित करता है। +> - `args.FileName` – Aspose द्वारा सुझाया गया मूल फ़ाइलनाम (अक्सर `image001.png` जैसा कुछ)। +> - `args.Stream` – आउटपुट स्ट्रीम जहाँ इमेज बाइट्स लिखे जाते हैं। +> - `args.KeepResourceStreamOpen` – `false` सेट करने से Aspose स्वचालित रूप से स्ट्रीम को डिस्पोज़ कर देता है, जिससे फ़ाइल‑हैंडल लीक नहीं होते। + +--- + +## पूर्ण कार्यशील उदाहरण + +सब कुछ मिलाकर, यहाँ एक एकल फ़ाइल है जिसे आप `Program.cs` में कॉपी‑पेस्ट कर सकते हैं। याद रखें `YOUR_DIRECTORY` को अपने पर्यावरण के अनुसार एक पूर्ण या सापेक्ष पथ से बदलें। + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### अपेक्षित आउटपुट + +- `YOUR_DIRECTORY/Document.md` – एक markdown फ़ाइल जिसमें मानक markdown इमेज लिंक होते हैं, उदाहरण के लिए: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – इसमें `img_0.png`, `img_1.jpg` आदि होते हैं, जो मूल Word दस्तावेज़ में दिखाई देने के क्रम से मेल खाते हैं। + +प्रोग्राम चलाने पर एक मित्रवत पुष्टि संदेश प्रदर्शित होगा, जिससे आपको पता चलेगा कि प्रक्रिया सफल रही। + +--- + +## अक्सर पूछे जाने वाले प्रश्न (FAQ) + +### Word से इमेज निकालते समय गुणवत्ता नहीं खोनी चाहिए, कैसे करें? + +Callback बाइनरी स्ट्रीम को सीधे फ़ाइल में लिखता है, जिससे मूल रिज़ॉल्यूशन बरकरार रहता है। जब तक आप स्वयं `ResourceSaving` में इमेज‑प्रोसेसिंग नहीं जोड़ते, कोई रूपांतरण या संपीड़न नहीं होता। + +### क्या निकाली गई इमेज का फॉर्मेट बदल सकते हैं (जैसे PNG → JPEG)? + +बिल्कुल। `ResourceSaving` के भीतर आप `args.FileName` या `args.Stream` को देख सकते हैं, `System.Drawing` या `ImageSharp` से इमेज लोड कर सकते हैं, फिर लिखने से पहले उसे पुनः‑एन्कोड कर सकते हैं। साथ ही markdown लिंक के एक्सटेंशन को उसी अनुसार अपडेट करना न भूलें। + +### यदि markdown फ़ाइलें CDN को रेफ़र करनी हों तो क्या करें? + +Callback को संशोधित करके markdown लिंक में बेस URL जोड़ें। इमेज को CDN पर अपलोड करने के बाद `args.FileName` को पूर्ण‑योग्य URL सेट कर दें। + +### क्या यह टेबल, फुटनोट या अन्य उन्नत Word फीचर्स को संभालता है? + +हां। Aspose.Words अधिकांश Word संरचनाओं को markdown समकक्ष में बदलता है। टेबल markdown टेबल बनते हैं, फुटनोट रेफ़रेंस लिंक बनते हैं, और नेस्टेड लिस्ट भी सुगमता से संभाली जाती हैं। यदि कुछ अजीब दिखे, तो नवीनतम रिलीज़ नोट्स देखें—Aspose निरंतर रूपांतरण की सटीकता को सुधार रहा है। + +### CI/CD पाइपलाइन में docx को markdown में कैसे बदलें? + +सिर्फ कंपाइल्ड `.exe` को अपने बिल्ड स्टेप्स में जोड़ें, इसे उत्पन्न `.docx` आर्टिफैक्ट्स की ओर इंगित करें, और परिणामस्वरूप `.md` और `Resources/` फ़ोल्डर को अपने static site रिपॉज़िटरी में पुश करें। प्रक्रिया पूरी तरह से निर्धारक (deterministic) है, इसलिए ऑटोमेटेड वातावरण में अच्छी तरह काम करती है। + +--- + +## निष्कर्ष + +हमने दिखाया कि **Word से markdown बनाना** Aspose.Words की मदद से कैसे किया जाता है, पूरे **docx को markdown में बदलने** के वर्कफ़्लो को कवर किया, और एक कस्टम **callback** इम्प्लीमेंटेशन के साथ **Word से इमेज निकालने** का व्यावहारिक तरीका प्रस्तुत किया। परिणाम एक साफ़ markdown फ़ाइल और मूल इमेजों का फ़ोल्डर है—जो दस्तावेज़ साइट, static ब्लॉग, या किसी भी वर्कफ़्लो के लिए आदर्श है जो plain‑text फ़ॉर्मेट पसंद करता है। + +आगे आप विचार कर सकते हैं: + +- **बैच प्रोसेसिंग** कई `.docx` फ़ाइलों के लिए (फ़ोल्डर पर `Directory.GetFiles` लूप)। +- **इमेज के लिए कस्टम नामकरण योजना** (जैसे मूल कैप्शन टेक्स्ट का उपयोग)। +- **पोस्ट‑प्रोसेसिंग** markdown में इमेज लिंक को CDN URL से बदलना। +- **अन्य Aspose एक्सपोर्ट फ़ॉर्मेट** जैसे HTML, PDF, या EPUB का अन्वेषण, मल्टी‑चैनल पब्लिशिंग के लिए। + +और सवाल या कोई जटिल Word फ़ाइल जो बदलने से इनकार करती हो? नीचे टिप्पणी करें, हम मिलकर ट्रबलशूट करेंगे। Happy coding, और Word को markdown में बदलने की सरलता का आनंद लें! + +--- + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hindi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/hindi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..91d486c26b --- /dev/null +++ b/words/hindi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words का उपयोग करके DOCX से LaTeX निर्यात कैसे करें। DOCX को Markdown + में परिवर्तित करना, DPI सेट करना, और C# में रिकवरी सक्षम करना सीखें। +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: hi +og_description: Aspose.Words का उपयोग करके DOCX से LaTeX कैसे निर्यात करें। यह ट्यूटोरियल + चरण‑दर‑चरण मार्कडाउन में रूपांतरण, DPI नियंत्रण, और रिकवरी मोड दिखाता है। +og_title: DOCX से LaTeX निर्यात कैसे करें – Markdown में परिवर्तित करें +tags: +- Aspose.Words +- C# +- Document Conversion +title: DOCX से LaTeX निर्यात कैसे करें – Markdown में परिवर्तित करें +url: /hi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# DOCX से LaTeX निर्यात कैसे करें – Markdown में परिवर्तित करें + +क्या आपने कभी **how to export LaTeX** को एक DOCX फ़ाइल से बिना अपनी समीकरणों की सुंदरता खोए निर्यात करने के बारे में सोचा है? आप अकेले नहीं हैं। मेरे अनुभव में, सबसे बड़ी समस्या यह है कि उन OfficeMath ऑब्जेक्ट्स को एक साफ़, पोर्टेबल फ़ॉर्मेट में लाना, जो static‑site generators या वैज्ञानिक ब्लॉग्स के लिए उपयुक्त हो। + +इस गाइड में हम Aspose.Words के साथ DOCX को Markdown में परिवर्तित करने की प्रक्रिया को चरणबद्ध रूप से देखेंगे, साथ ही **how to set DPI**, **how to enable recovery** दिखाएंगे, और एक मजबूत पाइपलाइन के लिए कुछ उपयोगी ट्रिक्स प्रदान करेंगे। अंत तक आपके पास एक एकल C# प्रोग्राम होगा जो LaTeX समीकरणों, उच्च‑रिज़ॉल्यूशन छवियों और उचित हाइपरलिंक हैंडलिंग के साथ एक Markdown फ़ाइल उत्पन्न करता है। + +## आप को क्या चाहिए + +- **.NET 6+** (या .NET Framework 4.7.2 – API समान रूप से काम करता है) +- **Aspose.Words for .NET** (मार्च 2026 तक का नवीनतम स्थिर संस्करण) +- एक DOCX फ़ाइल जिसमें समीकरण, छवियां और लिंक हों +- Visual Studio, VS Code, या कोई भी पसंदीदा एडिटर + +Aspose.Words के अलावा कोई अतिरिक्त NuGet पैकेज आवश्यक नहीं है, लेकिन यदि आप ट्रायल का उपयोग नहीं कर रहे हैं तो सुनिश्चित करें कि आपके पास वैध लाइसेंस हो। + +## चरण 1 – Strict Recovery Mode के साथ DOCX लोड करें + +निर्यात के बारे में सोचने से पहले, हमें यह सुनिश्चित करना चाहिए कि स्रोत दस्तावेज़ में कोई भ्रष्टाचार छुपा न हो। यहीं पर **how to enable recovery** काम आता है। + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**क्यों स्ट्रिक्ट रिकवरी?** +यदि आप Aspose को समस्याओं को चुपचाप ठीक करने देते हैं, तो आपको पैराग्राफ गायब या छवियां टूटी हुई मिल सकती हैं—जो LaTeX निर्यात करते समय कोई नहीं चाहता। तेज़ी से विफल होकर, आप समस्या को जल्दी पकड़ सकते हैं और तय कर सकते हैं कि स्रोत DOCX को ठीक करना है या बाद में समस्या को लॉग करना है। + +### प्रो टिप +लोड को try/catch ब्लॉक में रखें और `DocumentLoadingException` को लॉग करें। इस तरह आपका CI पाइपलाइन समस्याग्रस्त फ़ाइलों को फ़्लैग कर सकेगा बिना पूरी बिल्ड को रोकें। + +## चरण 2 – Markdown निर्यात विकल्प तैयार करें + +अब जब दस्तावेज़ मेमोरी में सुरक्षित रूप से लोड हो गया है, हम इसे कैसे सहेजा जाएगा, इसे कॉन्फ़िगर करते हैं। यह **how to export latex** का मूल है और साथ ही एम्बेडेड छवियों के लिए **how to set DPI** को भी कवर करता है। + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**प्रत्येक विकल्प क्या करता है** + +| विकल्प | कारण | कीवर्ड्स से प्रासंगिकता | +|--------|--------|-----------------------| +| `OfficeMathExportMode = LaTeX` | समीकरणों से सीधे **how to export latex** का उत्तर देता है। | मुख्य कीवर्ड | +| `ImageResolution = 300` | छवि गुणवत्ता नियंत्रित करता है – **how to set dpi** का उत्तर। | द्वितीयक | +| `ResourceSavingCallback` | एम्बेडेड फ़ाइलों को डिस्क पर सहेजता है, जो **convert docx to markdown** के दौरान सामान्य आवश्यकता है। | द्वितीयक | +| `EmptyParagraphExportMode` | साफ़ Markdown आउटपुट सुनिश्चित करता है, अनावश्यक HTML टैग्स को रोकता है। | कुल मिलाकर रूपांतरण गुणवत्ता में सुधार | +| `LinkExportMode = AsReference` | लिंक को पढ़ने और संपादित करने में आसान बनाता है, जो **convert docx to markdown** के लिए एक और लाभ है। | | + +## चरण 3 – एक कस्टम रिसोर्स सेवर लागू करें (वैकल्पिक लेकिन उपयोगी) + +जब आप DOCX को Markdown में परिवर्तित करते हैं, तो छवियों और अन्य बाइनरी रिसोर्सेज़ को फ़ाइल सिस्टम पर एक स्थान चाहिए। Aspose आपको `IResourceSavingCallback` के साथ इसे नियंत्रित करने देता है। ऊपर का स्निपेट पहले से ही एक न्यूनतम कार्यान्वयन दिखाता है, लेकिन चलिए इसे विस्तार से समझते हैं: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**यह क्यों जरूरी है?** +यदि आप इस चरण को छोड़ देते हैं, तो Aspose छवियों को base‑64 स्ट्रिंग्स के रूप में एम्बेड करेगा, जिससे Markdown फ़ाइल का आकार बहुत बढ़ जाएगा और संस्करण नियंत्रण कठिन हो जाएगा। रिसोर्सेज़ को एक अलग फ़ोल्डर में सहेजकर, आप Markdown को हल्का रखते हैं और इसे Hugo या Jekyll जैसे static site generators के लिए अनुकूल बनाते हैं। + +## चरण 4 – दस्तावेज़ को Markdown के रूप में सहेजें + +सभी जटिल कार्य समाप्त हो गए हैं। अब एक पंक्ति अंतिम फ़ाइल लिखती है। + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +`output.md` खोलें और आपको दिखेगा: + +- समीकरण `$…$` LaTeX ब्लॉक्स के रूप में रेंडर होते हैं +- छवियां `![Alt text](resources/image001.png)` के रूप में संदर्भित होती हैं, 300 dpi रिज़ॉल्यूशन के साथ +- हाइपरलिंक रेफ़रेंस शैली में बदल दिए गए हैं: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +यह पूरी **how to convert docx** प्रक्रिया का सार है। + +## आम प्रश्न और किनारे के मामलों + +### 1️⃣ यदि DOCX में असमर्थित ऑब्जेक्ट्स हों तो क्या होगा? +Aspose.Words एक `FeatureNotSupportedException` फेंकेगा। क्योंकि हमने स्ट्रिक्ट मोड में **how to enable recovery** का उपयोग किया है, अपवाद तुरंत सामने आता है। आप या तो: + +- `RecoveryMode` को `RecoveryMode.Default` में बदल सकते हैं ताकि सर्वश्रेष्ठ‑प्रयास रूपांतरण हो, **या** +- कन्वर्टर चलाने से पहले DOCX को पूर्व‑प्रसंस्करण करें (जैसे, असमर्थित SmartArt को हटाएँ)। + +### 2️⃣ क्या मैं प्रत्येक छवि के लिए DPI बदल सकता हूँ? +`ImageResolution` सेटिंग ग्लोबल है। प्रति‑छवि नियंत्रण के लिए, `MyResourceSaver` के समान एक कस्टम `ImageSavingCallback` लागू करें और `args.ImageResolution` को `args.ImageFileName` या मेटाडेटा के आधार पर समायोजित करें। + +### 3️⃣ जेनरेटेड LaTeX को Jekyll साइट में कैसे एम्बेड करूँ? +Jekyll का अंतर्निहित MathJax समर्थन बॉक्स से बाहर काम करता है। बस सुनिश्चित करें कि आपका लेआउट MathJax स्क्रिप्ट शामिल करता है और LaTeX ब्लॉक्स `$$` में डिस्प्ले समीकरणों के लिए या `$` में इनलाइन के लिए लिपटे हों। + +### 4️⃣ क्या यह Linux पर .NET Core के साथ संगत है? +बिल्कुल। Aspose.Words क्रॉस‑प्लेटफ़ॉर्म है। बस यह सुनिश्चित करें कि `YOUR_DIRECTORY` पाथ Linux परम्पराओं का पालन करता हो (जैसे, `/home/user/docs`)। + +## पूर्ण कार्यशील उदाहरण + +नीचे एक कॉपी‑पेस्ट‑तैयार प्रोग्राम दिया गया है। `YOUR_DIRECTORY` को अपने मशीन पर वास्तविक पाथ से बदलें। + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**अपेक्षित आउटपुट** – `output.md` खोलें और आपको कुछ इस तरह दिखना चाहिए: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +यदि आप फ़ाइल को MathJax सपोर्ट करने वाले Markdown प्रीव्यू में खोलते हैं, तो इंटीग्रल रेंडर होगा + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hindi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/hindi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..4b14334ae4 --- /dev/null +++ b/words/hindi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words का उपयोग करके Word दस्तावेज़ों से LaTeX निर्यात कैसे करें + – DOCX को Markdown में परिवर्तित करें, समीकरणों को LaTeX के रूप में रखें। +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: hi +og_description: Word दस्तावेज़ों से LaTeX निर्यात करने का तरीका पहले वाक्य में समझाया + गया है, जो आपको समीकरणों के साथ DOCX को Markdown में LaTeX के रूप में बदलने का तरीका + दिखाता है। +og_title: वर्ड से LaTeX निर्यात कैसे करें – पूर्ण गाइड +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: वर्ड से LaTeX निर्यात कैसे करें – DOCX को Markdown में बदलें +url: /hi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word से LaTeX निर्यात कैसे करें – DOCX को Markdown में बदलें + +क्या आपने कभी **Word फ़ाइल से LaTeX निर्यात** करने के बारे में सोचा है बिना कई PNG फ़ाइलों के? आप अकेले नहीं हैं; डेवलपर्स अक्सर इस समस्या का सामना करते हैं जब उन्हें स्थैतिक साइटों या वैज्ञानिक ब्लॉगों के लिए साफ़, संपादन योग्य समीकरण चाहिए होते हैं। अच्छी खबर? Aspose.Words के साथ आप **Word को Markdown में बदल** सकते हैं और हर OfficeMath ऑब्जेक्ट को मूल LaTeX के रूप में रख सकते हैं—कोई पोस्ट‑प्रोसेसिंग की ज़रूरत नहीं। + +इस ट्यूटोरियल में हम **Word दस्तावेज़ को Markdown के रूप में सहेजने** के साथ **समीकरणों को LaTeX के रूप में निर्यात करने** की पूरी प्रक्रिया को देखेंगे। अंत तक आपके पास एक चलाने योग्य C# स्निपेट, प्रत्येक विकल्प की स्पष्ट व्याख्या, और जटिल फ़ॉर्मूले या मिश्रित सामग्री जैसे किनारे के मामलों को संभालने के टिप्स होंगे। कोई बाहरी टूल नहीं, सिर्फ एक NuGet पैकेज और कुछ पंक्तियों का कोड। + +## What You’ll Need + +- .NET 6+ (या .NET Framework 4.7.2 और उससे ऊपर) – नवीनतम रनटाइम सबसे अच्छा काम करता है। +- Visual Studio 2022 या कोई भी एडिटर जो C# प्रोजेक्ट्स को कंपाइल कर सके। +- Aspose.Words for .NET लाइसेंस (फ़्री ट्रायल प्रयोग के लिए पर्याप्त है)। +- एक DOCX फ़ाइल जिसमें कम से कम एक समीकरण (OfficeMath) हो। + +यदि आपके पास ये सब है, तो चलिए शुरू करते हैं। + +## How to Export LaTeX from Word – Overview + +नीचे चरणों का एक उच्च‑स्तरीय दृश्य दिया गया है: + +1. **Install** the Aspose.Words NuGet package. +2. **Load** the source `.docx` that holds your equations. +3. **Configure** `MarkdownSaveOptions` so that `OfficeMathExportMode` is set to `LaTeX`. +4. **Save** the document as a `.md` file. +5. **Verify** that the generated Markdown contains LaTeX blocks (`$$…$$`). + +इन प्रत्येक चरणों की विस्तृत व्याख्या आगे के सेक्शन में दी गई है। + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="Word से LaTeX निर्यात करने का आरेख"} + +## Step 1 – Install Aspose.Words for .NET (convert word to markdown) + +सबसे पहले: आपको वह लाइब्रेरी चाहिए जो असली काम करे। अपना टर्मिनल (या Package Manager Console) खोलें और चलाएँ: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** यदि आप Visual Studio उपयोग कर रहे हैं, तो प्रोजेक्ट पर राइट‑क्लिक → *Manage NuGet Packages* → “Aspose.Words” खोजें और नवीनतम स्थिर संस्करण स्थापित करें। + +क्यों महत्वपूर्ण है: Aspose.Words Open XML फ़ॉर्मेट को एब्स्ट्रैक्ट करता है, जिससे आपको Word दस्तावेज़ को मैनीपुलेट करने के लिए एक साफ़ API मिलती है, बिना लो‑लेवल XML से जूझे। यह OfficeMath को LaTeX में बदलने के बिल्ट‑इन सपोर्ट के साथ आता है, जो हमारे **export equations as LaTeX** लक्ष्य का मूल है। + +## Step 2 – Load the DOCX (how to convert docx) + +अब पैकेज स्थापित हो गया, उस फ़ाइल को लोड करें जिसे आप ट्रांसफ़ॉर्म करना चाहते हैं। `YOUR_DIRECTORY` को उस पथ से बदलें जहाँ आपकी `.docx` फ़ाइल स्थित है: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Why load it this way?** `Document` कंस्ट्रक्टर पूरे फ़ाइल को एक ऑब्जेक्ट मॉडल में पार्स करता है, जिससे आपको पैराग्राफ, टेबल और—सबसे महत्वपूर्ण—OfficeMath ऑब्जेक्ट्स तक तुरंत पहुंच मिलती है। यदि फ़ाइल गायब या करप्ट है, तो Aspose एक वर्णनात्मक `FileNotFoundException` फेंकेगा, जिसे आप ग्रेसफ़ुल एरर हैंडलिंग के लिए कैच कर सकते हैं। + +## Step 3 – Configure MarkdownSaveOptions (export equations as latex) + +जादू `MarkdownSaveOptions` ऑब्जेक्ट में होता है। डिफ़ॉल्ट रूप से Aspose समीकरणों को PNG इमेज के रूप में रेंडर करता है, लेकिन हम LaTeX चाहते हैं। `OfficeMathExportMode` को `LaTeX` सेट करें: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +वैकल्पिक फ़्लैग्स पर एक त्वरित नोट: `ExportImagesAsBase64` Aspose को बाइनरी डेटा एम्बेड न करने के लिए कहता है, जिससे Markdown साफ़ रहता है। `ExportHeadersFooters` सुनिश्चित करता है कि आप उन सेक्शन में मौजूद कोई भी संदर्भ न खोएँ—उपयोगी जब हेडर में शीर्षक या लेखक का नाम हो। + +## Step 4 – Save the Document (save word as markdown) + +अंत में, ट्रांसफ़ॉर्म्ड कंटेंट को एक `.md` फ़ाइल में लिखें: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +इस लाइन के चलने के बाद, आप `output.md` को अपने स्रोत फ़ाइल के बगल में पाएँगे। इसे किसी भी टेक्स्ट एडिटर में खोलें और आपको LaTeX ब्लॉक्स इस प्रकार दिखेंगे: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +यही **save word as markdown** भाग पूरा हुआ—कोई अतिरिक्त कन्वर्ज़न स्टेप्स नहीं। + +## Step 5 – Verify the Result (export equations as latex) + +सत्यापन को अक्सर नजरअंदाज़ किया जाता है, लेकिन एक त्वरित चेक बाद में घंटों बचा सकता है। एक साधारण स्क्रिप्ट चलाएँ जो जेनरेटेड फ़ाइल को पढ़े और पहला LaTeX ब्लॉक प्रिंट करे: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +यदि आपको `First LaTeX block: $$ … $$` प्रिंट होते दिखे, तो आपने सफलतापूर्वक **Word से LaTeX निर्यात** कर लिया है। यदि नहीं, तो दोबारा जांचें कि आपके स्रोत दस्तावेज़ में वास्तव में OfficeMath ऑब्जेक्ट्स हैं; सामान्य टेक्स्ट समीकरण परिवर्तित नहीं होंगे। + +## Handling Common Edge Cases + +| Scenario | What to Watch For | Recommended Fix | +|----------|-------------------|-----------------| +| **Mixed images & equations** | Aspose अभी भी गैर‑OfficeMath ग्राफ़िक्स के लिए इमेज एम्बेड कर सकता है। | `ExportImagesAsBase64 = false` सेट करें और इमेज को बाहरी फ़ाइलों के रूप में रखें, फिर उन्हें मैन्युअली Markdown में रेफ़रेंसेज़ करें। | +| **Complex nested equations** | बहुत गहरी नेस्टिंग से LaTeX को मैन्युअल ट्यूनिंग की ज़रूरत पड़ सकती है। | ब्लॉक को LaTeX फ़ॉर्मैटर (जैसे `latexindent`) से पोस्ट‑प्रोसेस करें या `mdOptions` → `ExportMathAsDisplay = true` सेट करें। | +| **Large documents** | बड़े `.docx` फ़ाइलों को लोड करने पर मेमोरी उपयोग में स्पाइक आ सकता है। | `LoadOptions` के साथ `LoadFormat.Docx` उपयोग करें और यदि उपलब्ध हो तो स्ट्रीमिंग सक्षम करें। | +| **Missing license** | फ़्री ट्रायल आउटपुट में वॉटरमार्क टिप्पणी जोड़ता है। | वैध लाइसेंस लागू करें: `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +इन टिप्स से आपका वर्कफ़्लो मजबूत रहेगा, विशेषकर जब आप **convert word to markdown** को प्रोडक्शन पाइपलाइन में उपयोग कर रहे हों। + +## Full Working Example (All Steps in One File) + +नीचे एक स्व-निहित कंसोल ऐप दिया गया है जिसे आप नई .NET प्रोजेक्ट में कॉपी‑पेस्ट करके तुरंत चला सकते हैं। + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +प्रोग्राम चलाएँ, `output.md` खोलें, और आपके समीकरण साफ़ LaTeX में रेंडर हुए दिखेंगे। यही **how to export latex** from a Word document का पूरा उत्तर है। + +## Conclusion + +हमने **Word से LaTeX निर्यात** करने के चरण‑दर‑चरण प्रक्रिया को कवर किया, दिखाया कि कैसे **Word को markdown में बदलें**, **save word as markdown** करें, और Aspose.Words का उपयोग करके **export equations as LaTeX** करें। मुख्य विचार सरल है: DOCX लोड करें, `MarkdownSaveOptions` को ट्यून करें, और लाइब्रेरी को बाकी काम करने दें। + +यदि आप डॉक्यूमेंटेशन पाइपलाइन को ऑटोमेट करना चाहते हैं, तो इस कोड को Hugo या Jekyll जैसे स्टैटिक‑साइट जेनरेटर के साथ चेन करें—बस जेनरेटेड `.md` फ़ाइलों को अपने रेपो में पुश करें और साइट रीबिल्ड हो जाएगी। आगे पढ़ने के लिए Aspose की “Export to LaTeX” गाइड देखें, `HtmlSaveOptions` के साथ वेब प्रीव्यूज़ एक्सप्लोर करें, या कस्टम ट्रांसफ़ॉर्मेशन के लिए `DocumentVisitor` API में डुबकी लगाएँ। + +यदि आपके पास किनारे के मामलों, लाइसेंसिंग, या CI/CD इंटीग्रेशन के बारे में प्रश्न हैं, तो नीचे टिप्पणी करें, और हैप्पी कोडिंग! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hindi/net/programming-with-pdfsaveoptions/_index.md b/words/hindi/net/programming-with-pdfsaveoptions/_index.md index 2862fc64f1..f924829500 100644 --- a/words/hindi/net/programming-with-pdfsaveoptions/_index.md +++ b/words/hindi/net/programming-with-pdfsaveoptions/_index.md @@ -32,20 +32,20 @@ PdfSaveOptions के साथ Words Processing पर Aspose.Words for .NET | [एम्बेडेड फ़ॉन्ट्स को अक्षम करके PDF का आकार कम करें](./disable-embed-windows-fonts/) | .NET के लिए Aspose.Words का उपयोग करके एम्बेडेड फ़ॉन्ट को अक्षम करके PDF का आकार कम करें। कुशल भंडारण और साझाकरण के लिए अपने दस्तावेज़ों को अनुकूलित करने के लिए हमारे चरण-दर-चरण मार्गदर्शिका का पालन करें। | | [एरियल और टाइम्स रोमन फ़ॉन्ट्स को छोड़कर पीडीएफ आकार को अनुकूलित करें](./skip-embedded-arial-and-times-roman-fonts/) | .NET के लिए Aspose.Words का उपयोग करके एम्बेडेड एरियल और टाइम्स रोमन फ़ॉन्ट को छोड़कर PDF आकार को अनुकूलित करें। अपनी PDF फ़ाइलों को सुव्यवस्थित करने के लिए इस चरण-दर-चरण मार्गदर्शिका का पालन करें। | | [कोर फ़ॉन्ट्स को एम्बेड न करके PDF फ़ाइल का आकार कम करें](./avoid-embedding-core-fonts/) | जानें कि .NET के लिए Aspose.Words का उपयोग करके कोर फ़ॉन्ट एम्बेड न करके PDF फ़ाइल का आकार कैसे कम करें। अपने PDF को अनुकूलित करने के लिए हमारे चरण-दर-चरण मार्गदर्शिका का पालन करें। | -| [पीडीएफ दस्तावेज़ में एस्केप यूआरआई](./escape-uri/) .NET के लिए Aspose.Words का उपयोग करके PDF में URI से बचने का तरीका जानें। यह विस्तृत गाइड आपको चरण-दर-चरण प्रक्रिया से परिचित कराती है। | +| [पीडीएफ दस्तावेज़ में एस्केप यूआरआई](./escape-uri/) .NET के लिए Aspose.Words का उपयोग करके PDF में URI से बचने का तरीका जानें। यह विस्तृत गाइड आपको चरण‑दर‑चरण प्रक्रिया से परिचित कराती है। | | [Word दस्तावेज़ हेडर फ़ुटर बुकमार्क को PDF दस्तावेज़ में निर्यात करें](./export-header-footer-bookmarks/) | हमारे चरण-दर-चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ से हेडर और फ़ुटर बुकमार्क्स को PDF में निर्यात करना सीखें। | -| [मेटाफ़ाइल आकार के लिए स्केल Wmf फ़ॉन्ट्स के साथ पीडीएफ आकार को कम करें](./scale-wmf-fonts-to-metafile-size/) | .NET के लिए Aspose.Words के साथ पीडीएफ में परिवर्तित करते समय मेटाफ़ाइल आकार के लिए स्केल wmf फ़ॉन्ट्स के साथ पीडीएफ आकार को कम करने के लिए चरण-दर-चरण गाइड। | +| [मेटाफ़ाइल आकार के लिए स्केल Wmf फ़ॉन्ट्स के साथ पीडीएफ आकार को कम करें](./scale-wmf-fonts-to-metafile-size/) | .NET के लिए Aspose.Words के साथ पीडीएफ में परिवर्तित करते समय मेटाफ़ाइल आकार के लिए स्केल wmf फ़ॉन्ट्स के साथ पीडीएफ आकार को कम करने के लिए चरण‑दर‑चरण गाइड। | | [अतिरिक्त टेक्स्ट पोजिशनिंग के साथ पीडीएफ टेक्स्ट पोजिशनिंग में सुधार करें](./additional-text-positioning/) | कुछ आसान चरणों में .NET के लिए Aspose.Words के साथ PDF टेक्स्ट पोजिशनिंग को बेहतर बनाने का तरीका जानें। अपने दस्तावेज़ की दिखावट को बेहतर बनाएँ। | | [वर्ड डॉक्यूमेंट को पीडीएफ में बदलें 1.7](./conversion-to-pdf-17/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों को आसानी से PDF 1.7 में बदलें। यह सुनिश्चित करने के लिए कि आपके दस्तावेज़ सार्वभौमिक रूप से सुलभ और पेशेवर रूप से स्वरूपित हैं, इस गाइड का पालन करें। | | [डाउनसैंपलिंग छवियों के साथ पीडीएफ दस्तावेज़ का आकार कम करें](./downsampling-images/) | .NET के लिए Aspose.Words का उपयोग करके छवियों को डाउनसैंपलिंग करके PDF दस्तावेज़ का आकार कम करें। तेज़ अपलोड और डाउनलोड समय के लिए अपने PDF को अनुकूलित करें। | | [PDF दस्तावेज़ में आउटलाइन विकल्प सेट करें](./set-outline-options/) | .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ में आउटलाइन विकल्प सेट करना सीखें। शीर्षक स्तर और विस्तारित आउटलाइन कॉन्फ़िगर करके PDF नेविगेशन को बेहतर बनाएँ। | -| [कस्टम गुणधर्मों को PDF दस्तावेज़ में निर्यात करें](./custom-properties-export/) | हमारे विस्तृत, चरण-दर-चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ में कस्टम गुणों को निर्यात करना सीखें। | -| [Word दस्तावेज़ संरचना को PDF दस्तावेज़ में निर्यात करें](./export-document-structure/) | .NET के लिए Aspose.Words के साथ Word दस्तावेज़ की संरचना को PDF में निर्यात करें। दस्तावेज़ लेआउट को संरक्षित करने और PDF नेविगेशन को बेहतर बनाने के लिए हमारे चरण-दर-चरण मार्गदर्शिका का पालन करें। | +| [कस्टम गुणधर्मों को PDF दस्तावेज़ में निर्यात करें](./custom-properties-export/) | हमारे विस्तृत, चरण‑दर‑चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ में कस्टम गुणों को निर्यात करना सीखें। | +| [Word दस्तावेज़ संरचना को PDF दस्तावेज़ में निर्यात करें](./export-document-structure/) | .NET के लिए Aspose.Words के साथ Word दस्तावेज़ की संरचना को PDF में निर्यात करें। दस्तावेज़ लेआउट को संरक्षित करने और PDF नेविगेशन को बेहतर बनाने के लिए हमारे चरण‑दर‑चरण मार्गदर्शिका का पालन करें। | | [पीडीएफ दस्तावेज़ में छवि संपीड़न](./image-compression/) .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ों में छवियों को संपीड़ित करना सीखें। अनुकूलित फ़ाइल आकार और गुणवत्ता के लिए इस गाइड का पालन करें। | -| [पीडीएफ दस्तावेज़ में अंतिम मुद्रित संपत्ति अपडेट करें](./update-last-printed-property/) | हमारे चरण-दर-चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ में अंतिम मुद्रित संपत्ति को अपडेट करना सीखें। | -| [3D DML 3DEffects को PDF दस्तावेज़ में प्रस्तुत करें](./dml-3deffects-rendering/) | इस व्यापक चरण-दर-चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ों में आश्चर्यजनक 3D DML प्रभाव प्रस्तुत करना सीखें। | -| [पीडीएफ दस्तावेज़ में छवियों को प्रक्षेपित करें](./interpolate-images/) | हमारे चरण-दर-चरण गाइड के साथ .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ में छवियों को इंटरपोल करना सीखें। आसानी से अपने PDF की छवि गुणवत्ता में सुधार करें। | - +| [पीडीएफ दस्तावेज़ में अंतिम मुद्रित संपत्ति अपडेट करें](./update-last-printed-property/) | हमारे चरण‑दर‑चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ में अंतिम मुद्रित संपत्ति को अपडेट करना सीखें। | +| [3D DML 3DEffects को PDF दस्तावेज़ में प्रस्तुत करें](./dml-3deffects-rendering/) | इस व्यापक चरण‑दर‑चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ों में आश्चर्यजनक 3D DML प्रभाव प्रस्तुत करना सीखें। | +| [पीडीएफ दस्तावेज़ में छवियों को प्रक्षेपित करें](./interpolate-images/) | हमारे चरण‑दर‑चरण गाइड के साथ .NET के लिए Aspose.Words का उपयोग करके PDF दस्तावेज़ में छवियों को इंटरपोल करना सीखें। आसानी से अपने PDF की छवि गुणवत्ता में सुधार करें। | +| [Aspose.Words के साथ DOCX से PDF कैसे सहेजें – चरण‑दर‑चरण गाइड](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Aspose.Words का उपयोग करके DOCX फ़ाइल को PDF में बदलने की प्रक्रिया को चरण‑दर‑चरण सीखें। | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hindi/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/hindi/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..5f1b791b58 --- /dev/null +++ b/words/hindi/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words का उपयोग करके DOCX फ़ाइल से PDF कैसे सहेजें, सीखें। इसमें + DOCX को PDF में बदलना, विकल्पों के साथ PDF सहेजना, और फ़्लोटिंग शैप्स को संभालना + शामिल है। +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: hi +og_description: Aspose.Words का उपयोग करके DOCX फ़ाइल से PDF कैसे सहेजें। यह गाइड + दिखाता है कि docx को pdf में कैसे बदलें, विकल्पों के साथ pdf सहेजें, और फ्लोटिंग + शैप्स को कैसे संभालें। +og_title: DOCX से PDF कैसे सहेजें – पूर्ण Aspose.Words ट्यूटोरियल +tags: +- Aspose.Words +- C# +- PDF conversion +title: Aspose.Words के साथ DOCX से PDF कैसे सहेजें – चरण‑दर‑चरण गाइड +url: /hi/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to Save PDF from DOCX with Aspose.Words – Complete Tutorial + +क्या आपने कभी सोचा है **कैसे PDF को Word दस्तावेज़ से** बिना फ़्लोटिंग शैप्स के लेआउट खोए बचाया जाए? आप अकेले नहीं हैं। कई प्रोजेक्ट्स—इनवॉइस जेनरेटर, रिपोर्ट एक्सपोर्टर, या साधारण दस्तावेज़ आर्काइवर—में डेवलपर्स को DOCX को PDF में बदलने का भरोसेमंद तरीका चाहिए, जबकि Word में जैसा दिखता है वैसा ही रहे। + +इस ट्यूटोरियल में हम **Aspose.Words for .NET** का उपयोग करके DOCX फ़ाइल को PDF में बदलने की प्रक्रिया दिखाएंगे, **docx to pdf** को कस्टम सेव ऑप्शन्स के साथ कैसे बदलें, और `ExportFloatingShapesAsInlineTag` फ़्लैग क्यों महत्वपूर्ण है, यह समझाएंगे। अंत तक आपके पास एक तैयार‑चलाने योग्य स्निपेट होगा जो विकल्पों के साथ PDF सेव करता है। + +## What You’ll Learn + +- Aspose.Words के साथ **convert word document pdf** करने के सटीक कदम। +- `PdfSaveOptions` को इस तरह कॉन्फ़िगर करना कि फ़्लोटिंग शैप्स को इनलाइन टैग माना जाए। +- फ़्लोटिंग ऑब्जेक्ट्स से जुड़ी सामान्य समस्याएँ और उन्हें कैसे टाला जाए। +- एक पूर्ण, चलाने योग्य C# प्रोग्राम जिसे आप किसी भी .NET प्रोजेक्ट में डाल सकते हैं। + +> **Prerequisite:** आपको Aspose.Words for .NET लाइसेंस (या फ्री इवैल्यूएशन) और एक .NET डेवलपमेंट एनवायरनमेंट (Visual Studio, Rider, या `dotnet` CLI) चाहिए। + +## Step 1: Set Up the Project and Add Aspose.Words + +पहले, एक नया कंसोल ऐप बनाएं (या मौजूदा में जोड़ें) और Aspose.Words NuGet पैकेज को रेफ़रेंस करें। + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro tip:** यदि आप CI सर्वर पर हैं, तो पैकेज संस्करण को पिन करें (`Aspose.Words --version 24.10`) ताकि बिल्ड्स पुनरुत्पादनीय रहें। + +## Step 2: Load the DOCX Containing Floating Shapes + +फ़्लोटिंग तस्वीरें, टेक्स्ट बॉक्स, या SmartArt कन्वर्ज़न के दौरान लेआउट शिफ्ट का कारण बन सकते हैं। डॉक्यूमेंट लोड करना सीधा है, लेकिन हम फ़ाइल मौजूद है या नहीं, यह भी चेक करेंगे ताकि रन‑टाइम `FileNotFoundException` न आए। + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +ध्यान दें `Console.WriteLine` स्टेटमेंट्स—ये आपको टर्मिनल से ऐप चलाते समय त्वरित फ़ीडबैक देते हैं। + +## Step 3: Configure PDF Save Options (Save PDF with Options) + +यहीं पर जादू होता है। डिफ़ॉल्ट रूप से Aspose.Words फ़्लोटिंग ऑब्जेक्ट्स को वैसा ही रखने की कोशिश करता है, जिससे आउटपुट PDF में लेआउट टूट सकता है। `ExportFloatingShapesAsInlineTag` को `true` सेट करने से लाइब्रेरी उन शैप्स को इनलाइन टैग मानती है, जिससे वे आस‑पास के टेक्स्ट से जुड़ी रहती हैं। + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +यह क्यों महत्वपूर्ण है? कल्पना करें एक टेक्स्ट बॉक्स जो पैराग्राफ के ऊपर तैर रहा है। इनलाइन‑टैग कन्वर्ज़न के बिना, PDF पैराग्राफ को नीचे धकेल सकता है या बॉक्स को पूरी तरह क्लिप कर सकता है। यह फ़्लैग विज़ुअल रिलेशनशिप को बरकरार रखता है—एक सूक्ष्म लेकिन पेशेवर रिपोर्ट्स के लिए आवश्यक विवरण। + +## Step 4: Save the Document as PDF + +अब हम वास्तव में PDF फ़ाइल लिखते हैं। `Save` मेथड को आउटपुट पाथ और हमने अभी सेट किए हुए ऑप्शन्स दोनों मिलते हैं। + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +प्रोग्राम चलाने पर `output.pdf` उसी फ़ोल्डर में बन जाएगा जहाँ आपका स्रोत DOCX है। इसे किसी भी PDF व्यूअर में खोलें और आपको सभी फ़्लोटिंग शैप्स ठीक उसी जगह पर रेंडर होते दिखेंगे जहाँ वे Word में थे। + +## Full Working Example + +नीचे पूरा प्रोग्राम एक ब्लॉक में दिया गया है। इसे `Program.cs` (या किसी भी C# फ़ाइल) में कॉपी‑पेस्ट करें और **F5** दबाएँ। + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Expected Result + +- **फ़ाइल बनाई गई:** लक्ष्य डायरेक्टरी में `output.pdf`। +- **लेआउट फ़िडेलिटी:** फ़्लोटिंग शैप्स (तस्वीरें, टेक्स्ट बॉक्स, SmartArt) आसपास के टेक्स्ट के साथ इनलाइन दिखते हैं। +- **कोई एक्सेप्शन नहीं:** प्रोग्राम सुगमता से समाप्त होता है, कंसोल में स्टेटस मैसेज प्रिंट करता है। + +## Frequently Asked Questions & Edge Cases + +| Question | Answer | +|----------|--------| +| **अगर मुझे इमेज क्वालिटी अधिक चाहिए तो?** | `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` सेट करें | +| **क्या मैं कई DOCX फ़ाइलों को बैच में कन्वर्ट कर सकता हूँ?** | लोड/सेव लॉजिक को `foreach (var file in Directory.GetFiles(..., "*.docx"))` लूप में रखें। प्रदर्शन के लिए एक ही `PdfSaveOptions` इंस्टेंस को री‑यूज़ करें | +| **क्या यह .NET Core के साथ काम करता है?** | बिल्कुल। Aspose.Words 24.x .NET Standard 2.0+ को सपोर्ट करता है, इसलिए आप Windows, Linux या macOS पर वही कोड चला सकते हैं | +| **पासवर्ड‑प्रोटेक्टेड DOCX फ़ाइलों के बारे में?** | `new Document(inputPath, new LoadOptions { Password = "mySecret" })` से लोड करें। सेव करते समय वही `PdfSaveOptions` लागू होते हैं | +| **क्या इनलाइन‑टैग कन्वर्ज़न जटिल टेबल्स के लिए सुरक्षित है?** | आम तौर पर हाँ, लेकिन बहुत जटिल टेबल लेआउट्स जिनमें ओवरलैपिंग शैप्स हों, उन्हें अभी भी मैन्युअल ट्यूनिंग की ज़रूरत पड़ सकती है। बड़े माइग्रेशन से पहले एक प्रतिनिधि सैंपल टेस्ट करें | + +## Tips for Real‑World Projects + +- **Log, don’t just `Console.WriteLine`** – प्रोडक्शन में कंसोल आउटपुट को Serilog, NLog जैसे लॉगिंग फ्रेमवर्क से बदलें ताकि एरर्स कैप्चर हो सकें। +- **Resources को Dispose करें** – `Document` `IDisposable` इम्प्लीमेंट करता है। कई फ़ाइलें प्रोसेस करते समय `using` ब्लॉक में रखें ताकि मेमोरी जल्दी फ्री हो। +- **PDF को Validate करें** – अगर आपको आर्काइवल‑ग्रेड PDF चाहिए तो PDF वैलिडेटर (जैसे PDF/A compliance checker) इस्तेमाल करें। +- **Parallel processing** – बड़े वर्कलोड के लिए `Parallel.ForEach` के साथ थ्रेड‑सेफ़ `PdfSaveOptions` (प्रति थ्रेड क्लोन) उपयोग करें ताकि कन्वर्ज़न तेज़ हो। + +## Conclusion + +हमने **how to save PDF** from a DOCX file को Aspose.Words के साथ कवर किया, **how to convert docx to pdf** को कस्टम ऑप्शन्स के साथ दिखाया, और `ExportFloatingShapesAsInlineTag` के प्रभाव को समझाया। पूरा, चलाने योग्य उदाहरण दर्शाता है कि आप कुछ ही लाइनों में **convert word document pdf** कर सकते हैं, और अब आप जानते हैं कि **save pdf with options** को अपने प्रोजेक्ट की क्वालिटी और कॉम्प्लायंस ज़रूरतों के अनुसार कैसे सेट करें। + +अगली चुनौती के लिए तैयार हैं? `document.Save("output.html")` के साथ अन्य फ़ॉर्मैट्स (जैसे HTML, EPUB) में एक्सपोर्ट करने की कोशिश करें, या लॉन्ग‑टर्म आर्काइविंग के लिए PDF/A कॉम्प्लायंस पर प्रयोग करें। वही सिद्धांत—लोड, ऑप्शन कॉन्फ़िगर, सेव—सभी फ़ॉर्मैट्स पर लागू होते हैं। + +Happy coding, and may your PDFs always look exactly as you intended! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hindi/net/programming-with-shapes/_index.md b/words/hindi/net/programming-with-shapes/_index.md index a25eea2230..04bd7c35ff 100644 --- a/words/hindi/net/programming-with-shapes/_index.md +++ b/words/hindi/net/programming-with-shapes/_index.md @@ -26,13 +26,14 @@ | --- | --- | | [समूह आकार जोड़ें](./add-group-shape/) | इस व्यापक, चरण-दर-चरण ट्यूटोरियल के साथ .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में समूह आकृतियों को जोड़ना सीखें। | | [आकृति डालें](./insert-shape/) | हमारे चरण-दर-चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में आकृतियों को सम्मिलित करना और उनमें हेरफेर करना सीखें। | +| [Word दस्तावेज़ C# – शैडो के साथ आकृति जोड़ें](./create-word-document-c-add-shape-with-shadow/) | Aspose.Words for .NET का उपयोग करके Word दस्तावेज़ में शैडो के साथ आकृति जोड़ने का चरण‑दर‑चरण मार्गदर्शन। | | [पहलू अनुपात लॉक किया गया](./aspect-ratio-locked/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में आकृतियों के पहलू अनुपात को लॉक करना सीखें। अपनी छवियों और आकृतियों को आनुपातिक बनाए रखने के लिए इस चरण-दर-चरण मार्गदर्शिका का पालन करें। | -| [सेल में लेआउट](./layout-in-cell/) | इस विस्तृत गाइड के साथ .NET के लिए Aspose.Words का उपयोग करके सेल में लेआउट सेट करना सीखें। Word दस्तावेज़ों को कस्टमाइज़ करने के इच्छुक डेवलपर्स के लिए बिल्कुल सही। | -| [कटे हुए कोने जोड़ें](./add-corners-snipped/) | जानें कि Aspose.Words for .NET का उपयोग करके अपने Word दस्तावेज़ों में कोनों को काटकर आकार कैसे जोड़ें। यह चरण-दर-चरण मार्गदर्शिका सुनिश्चित करती है कि आप अपने दस्तावेज़ों को आसानी से बेहतर बना सकते हैं। | +| [सेल में लेआउट](./layout-in-cell/) | इस विस्तृत गाइड के साथ .NET के लिए Aspose.Words का उपयोग करके सेल में लेआउट सेट करना सीखें। Word दस्तावेज़ों को कस्टमाइज़ करने की इच्छुक डेवलपर्स के लिए बिल्कुल सही। | +| [कटे हुए कोने जोड़ें](./add-corners-snipped/) | जानें कि Aspose.Words for .NET का उपयोग करके अपने Word दस्तावेज़ों में कोनों को काटकर आकार कैसे जोड़ें। यह चरण‑दर‑चरण मार्गदर्शिका सुनिश्चित करती है कि आप अपने दस्तावेज़ों को आसानी से बेहतर बना सकते हैं। | | [वास्तविक आकार सीमा अंक प्राप्त करें](./get-actual-shape-bounds-points/) | जानें कि .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में वास्तविक आकार सीमा बिंदु कैसे प्राप्त करें। इस विस्तृत गाइड के साथ सटीक आकार हेरफेर सीखें। | -| [वर्टिकल एंकर](./vertical-anchor/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में टेक्स्टबॉक्स के लिए वर्टिकल एंकर पोजिशन सेट करना सीखें। आसान चरण-दर-चरण मार्गदर्शिका शामिल है।| +| [वर्टिकल एंकर](./vertical-anchor/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में टेक्स्टबॉक्स के लिए वर्टिकल एंकर पोजिशन सेट करना सीखें। आसान चरण‑दर‑चरण मार्गदर्शिका शामिल है।| | [स्मार्ट आर्ट आकार का पता लगाएं](./detect-smart-art-shape/) | इस व्यापक गाइड के साथ .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में SmartArt आकृतियों का पता लगाना सीखें। आपके दस्तावेज़ वर्कफ़्लो को स्वचालित करने के लिए बिल्कुल सही। | -| [स्मार्ट आर्ट ड्राइंग अपडेट करें](./update-smart-art-drawing/) | इस चरण-दर-चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में स्मार्ट आर्ट ड्रॉइंग को अपडेट करना सीखें। सुनिश्चित करें कि आपके दृश्य हमेशा सटीक हों। | +| [स्मार्ट आर्ट ड्राइंग अपडेट करें](./update-smart-art-drawing/) | इस चरण‑दर‑चरण मार्गदर्शिका के साथ .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में स्मार्ट आर्ट ड्रॉइंग को अपडेट करना सीखें। सुनिश्चित करें कि आपके दृश्य हमेशा सटीक हों। | | [Aspose.Words के साथ Word में आयत आकार बनाएं – चरण‑दर‑चरण गाइड](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Aspose.Words का उपयोग करके Word दस्तावेज़ में आयत आकार बनाने और अनुकूलित करने के चरण‑दर‑चरण निर्देश। | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hindi/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/hindi/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..44432ab12b --- /dev/null +++ b/words/hindi/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: C# में Word दस्तावेज़ बनाएं और सीखें कि कैसे आकार जोड़ें, आकार पर छाया + लागू करें, और छाया की दूरी सेट करें। Aspose.Words के लिए चरण‑दर‑चरण मार्गदर्शिका। +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: hi +og_description: C# में एक आयताकार आकार और कस्टम शैडो के साथ वर्ड दस्तावेज़ बनाएं। + शैडो की दूरी और शैली सेट करने के लिए इस पूर्ण ट्यूटोरियल का पालन करें। +og_title: Word दस्तावेज़ बनाएं C# – छाया के साथ आकार जोड़ें +tags: +- Aspose.Words +- C# +- Document Automation +title: C# में वर्ड दस्तावेज़ बनाएं – शैडो के साथ आकार जोड़ें +url: /hi/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word Document C# बनाएं – Shape में Shadow जोड़ें + +क्या आपको कभी **create word document c#** बनाना पड़ा है जिसमें एक सुंदर स्टाइल्ड आयत हो? शायद आप एक रिपोर्ट टेम्प्लेट बना रहे हैं और लेआउट को पॉप करने के लिए एक सूक्ष्म ड्रॉप‑शैडो चाहते हैं। इस ट्यूटोरियल में हम ठीक वही करेंगे – कैसे shape जोड़ें, shape पर shadow लागू करें, और Aspose.Words का उपयोग करके shadow की दूरी को भी ट्यून करें। + +हम एक खाली दस्तावेज़ से शुरू करेंगे, उसमें एक आयत डालेंगे, उसे एक प्रीसेट शैडो देंगे, और फ़ाइल को सेव करके समाप्त करेंगे। अंत तक आपके पास एक तैयार‑to‑use .docx होगा जिसे आप Word में खोल कर तुरंत प्रभाव देख सकते हैं। कोई बाहरी टूल नहीं, सिर्फ शुद्ध C# कोड। + +## Prerequisites + +- .NET 6 (या कोई भी नवीनतम .NET Framework) स्थापित हो। +- Visual Studio 2022 या VS Code के साथ C# एक्सटेंशन। +- Aspose.Words for .NET NuGet पैकेज (`Aspose.Words` संस्करण 23.12 या बाद का)। + आप इसे पैकेज मैनेजर कंसोल के माध्यम से जोड़ सकते हैं: + + ```powershell + Install-Package Aspose.Words + ``` + +बस इतना ही – कोई अतिरिक्त DLLs या COM इंटरऑप की आवश्यकता नहीं। + +## चरण 1: नया Document और Builder प्रारंभ करें – *create word document c#* मूल बातें + +सबसे पहले हमें एक `Document` ऑब्जेक्ट चाहिए जो Word फ़ाइल का प्रतिनिधित्व करता है और एक `DocumentBuilder` जिससे हम इसे संपादित कर सकें। + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Why this step matters:** `Document` क्लास सभी Word भागों (पेज, स्टाइल, इमेज) का कंटेनर है। Builder एक हाई‑लेवल API है जो लो‑लेवल नोड मैनिपुलेशन को एब्स्ट्रैक्ट करता है, जिससे **create word document c#** XML से सीधे निपटे बिना आसान हो जाता है। + +## चरण 2: Rectangle Shape डालें – *how to create rectangle* + +अब हम पृष्ठ पर एक आयत रखेंगे। आकार पॉइंट्स में व्यक्त किया जाता है (1 pt ≈ 1/72 इंच)। + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro tip:** यदि आपको कोई अलग shape चाहिए, तो बस `ShapeType.Rectangle` को `ShapeType.Ellipse`, `ShapeType.Triangle` आदि से बदल दें। वही कोड **how to add shape** के किसी भी प्रकार के लिए काम करता है। + +## चरण 3: Preset Shadow लागू करें और फाइन‑ट्यून करें – *apply shadow to shape* + +Aspose.Words कई प्रीसेट शैडो फॉर्मेट्स के साथ आता है। हम `Preset1` का उपयोग करेंगे और फिर दूरी, ब्लर, ट्रांसपेरेंसी, और रंग को कस्टमाइज़ करेंगे। + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Why customize the shadow?** `Distance` प्रॉपर्टी नियंत्रित करती है कि शैडो आयत से कितनी दूर बैठती है – इसे आप 3‑D रेंडरिंग में “लिफ्ट” की तरह समझ सकते हैं। `BlurRadius` किनारों को नरम करता है, जबकि `Transparency` आपको एक सूक्ष्म, प्रोफेशनल लुक देता है। यह **set shadow distance** की आवश्यकता को पूरा करता है और दिखाता है कि आप **apply shadow to shape** को लचीले तरीके से कैसे कर सकते हैं। + +## चरण 4: Document को Save करें – *create word document c#* Completion + +अंत में, दस्तावेज़ को डिस्क पर लिखें। पथ को उस फ़ोल्डर में बदलें जहाँ आपके पास लिखने की अनुमति हो। + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +परिणामस्वरूप फ़ाइल को Microsoft Word में खोलें, और आपको एक हल्के‑नीले रंग की आयत के साथ एक नरम ग्रे शैडो 5 pt द्वारा ऑफ़सेटेड दिखेगा। यह दृश्य प्रमाण है कि आपने सफलतापूर्वक **create word document c#** एक स्टाइल्ड shape के साथ किया है। + +![Shadowed Shape के साथ Word Document C# बनाएं](shadow-example.png){: .img alt="create word document c# उदाहरण जिसमें आयत और छाया दिखती है"} + +## Optional Variations & Edge Cases + +| परिदृश्य | क्या बदलें | क्यों महत्वपूर्ण है | +|----------|------------|--------------------| +| **विभिन्न shadow शैली** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | अतिरिक्त कोड के बिना आपको अधिक नाटकीय लुक देता है। | +| **कोई preset नहीं – कस्टम shadow** | `Format` को हटाएँ और `OffsetX`, `OffsetY` को मैन्युअल रूप से सेट करें। | दिशा और गहराई पर पूर्ण नियंत्रण। | +| **Multiple shapes** | सेव करने से पहले `builder.InsertShape` को फिर से कॉल करें। | आइकॉन, लोगो आदि के साथ जटिल टेम्प्लेट्स के लिए उपयोगी। | +| **पुरानी Aspose संस्करणों के साथ संगतता** | `ShadowEffect` क्लास का उपयोग करें (v20.x में उपलब्ध)। | सुनिश्चित करता है कि आपका कोड लेगेसी प्रोजेक्ट्स पर चले। | +| **Saving as PDF** | `document.Save("ShadowShape.pdf");` | PDF आउटपुट में भी समान shadow रेंडरिंग दिखती है। | + +> **Common question:** *What if the shadow doesn’t appear in Word?* +> सुनिश्चित करें कि आप Aspose.Words का नवीनतम संस्करण (≥ 22.9) उपयोग कर रहे हैं। पुराने रिलीज़ में शैडो सपोर्ट सीमित था। साथ ही यह भी जाँचें कि दस्तावेज़ नवीनतम Word संस्करण (2016+) में खुला है। + +## Full Working Example + +नीचे पूरा, कॉपी‑पेस्ट‑रेडी प्रोग्राम दिया गया है। इसमें सभी `using` निर्देश, टिप्पणी, और त्रुटि संभालना शामिल है ताकि अनुभव सुगम रहे। + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +प्रोग्राम चलाएँ, `C:\Temp\ShadowShape.docx` पर जाएँ, और आपको वही आयत दिखेगी जिसमें हमने ठीक वही शैडो कॉन्फ़िगर किया था। + +## Recap & Next Steps + +- अब आप जानते हैं कि **create word document c#** कैसे करें, आयत डालें, और कस्टम **set shadow distance** के साथ **apply shadow to shape** कैसे करें। +- यह उदाहरण Aspose.Words का उपयोग करता है, जो OpenXML जटिलताओं को छुपाता है और Word संस्करणों में सुसंगत रेंडरिंग की गारंटी देता है। +- आगे बढ़ना चाहते हैं? कई shapes को मिलाएँ, आयत के अंदर टेक्स्ट जोड़ें, या वही दस्तावेज़ PDF के रूप में एक्सपोर्ट करें ताकि आप देख सकें कि shadow कैसे ट्रांसलेट होता है। + +### Related Topics You Might Explore + +- **How to add shape** को हेडर/फूटर में ब्रांडिंग के लिए जोड़ें। +- प्रोग्रामेटिकली चार्ट और टेबल डालने के लिए **Aspose.Words** का उपयोग। +- वेक्टर shapes के बजाय चित्रों पर **shadow effects** को कस्टमाइज़ करना। +- इनवॉइस या प्रमाणपत्रों के लिए बड़े पैमाने पर दस्तावेज़ जनरेशन को ऑटोमेट करना। + +बिना झिझक प्रयोग करें, कोड को तोड़ें, फिर फिर से बनाएं – यही अवधारणाओं को जल्दी से अंदरूनी बनाने का सबसे तेज़ तरीका है। अगर कोई समस्या आती है, तो नीचे टिप्पणी छोड़ें या आधिकारिक Aspose.Words दस्तावेज़ में गहरी API जानकारी देखें। + +Happy coding, and enjoy making your Word files look a little more polished! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hindi/net/programming-with-txtsaveoptions/_index.md b/words/hindi/net/programming-with-txtsaveoptions/_index.md index 802013d813..ee6cc98a7d 100644 --- a/words/hindi/net/programming-with-txtsaveoptions/_index.md +++ b/words/hindi/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Aspose.Words for .NET ट्यूटोरियल आपको Word दस् | [वर्ड डॉक्यूमेंट में बीड़ी मार्क जोड़ें](./add-bidi-marks/) | इस गाइड के साथ .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में द्विदिशात्मक (बीड़ी) चिह्न जोड़ना सीखें। बहुभाषी सामग्री के लिए उचित पाठ दिशा सुनिश्चित करें। | | [सूची इंडेंटेशन के लिए प्रति स्तर टैब वर्ण का उपयोग करें](./use-tab-character-per-level-for-list-indentation/) | .NET के लिए Aspose.Words का उपयोग करके टैब्ड इंडेंटेशन के साथ बहु-स्तरीय सूचियाँ बनाना सीखें। अपने दस्तावेज़ों में सटीक सूची स्वरूपण के लिए इस गाइड का पालन करें। | | [सूची इंडेंटेशन के लिए प्रति स्तर स्पेस वर्ण का उपयोग करें](./use-space-character-per-level-for-list-indentation/) | Aspose.Words for .NET में स्पेस कैरेक्टर इंडेंटेशन के साथ मल्टी-लेवल सूचियाँ बनाने का तरीका जानें। सटीक दस्तावेज़ फ़ॉर्मेटिंग के लिए चरण-दर-चरण मार्गदर्शिका। | - +| [docx को txt के रूप में सहेजें – Word समीकरणों को LaTeX में निर्यात करने के लिए पूर्ण गाइड](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Word दस्तावेज़ को txt में बदलें और समीकरणों को LaTeX फ़ॉर्मेट में निर्यात करने की पूरी प्रक्रिया सीखें। | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hindi/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/hindi/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..c7fde43c03 --- /dev/null +++ b/words/hindi/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words के साथ docx को txt में सहेजें और Word को LaTeX में बदलें। + जानें कैसे समीकरणों को निर्यात करें, साधारण पाठ को रखें, और मिनटों में LaTeX मार्कअप + प्राप्त करें। +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: hi +og_description: Aspose.Words का उपयोग करके docx को txt के रूप में सहेजें। यह गाइड + दिखाता है कि Word को LaTeX में कैसे परिवर्तित करें, समीकरणों को निर्यात करें, और + अपने दस्तावेज़ को साधारण टेक्स्ट में रखें। +og_title: docx को txt के रूप में सहेजें – Word समीकरणों को LaTeX में निर्यात करें +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: docx को txt के रूप में सहेजें – Word समीकरणों को LaTeX में निर्यात करने की + पूरी गाइड +url: /hi/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# docx को txt के रूप में सहेजें – Word समीकरणों को LaTeX में निर्यात करें + +क्या आपको कभी **save docx as txt** करने की ज़रूरत पड़ी है लेकिन आप चिंतित थे कि आपके Word फ़ाइल में मौजूद जटिल गणित खो जाएगा? आप अकेले नहीं हैं। कई वैज्ञानिक कार्यप्रवाहों में दस्तावेज़ का plain‑text संस्करण अनिवार्य है, फिर भी आप चाहते हैं कि समीकरण साफ़ LaTeX मार्कअप के रूप में बने रहें। + +इस ट्यूटोरियल में हम **convert Word to LaTeX** करने के सटीक चरणों को Aspose.Words for .NET का उपयोग करके दिखाएंगे, ताकि आपके समीकरण सही तरीके से निर्यात हों और दस्तावेज़ का बाकी हिस्सा व्यवस्थित plain text बन जाए। अंत तक आप जानेंगे कैसे **export equations to LaTeX** किया जाता है, फ़ाइल के बाकी हिस्से को सरल टेक्स्ट में रखा जाता है, और आम समस्याओं से बचा जाता है जो नए उपयोगकर्ताओं को फँसाती हैं। + +## आप क्या सीखेंगे + +- कैसे *.docx* फ़ाइल को लोड करें जिसमें Office Math हो। +- सही `TxtSaveOptions` सेट करके Aspose को हर समीकरण के लिए LaTeX आउटपुट देने के लिए कॉन्फ़िगर करें। +- परिणाम को **save word plain text** फ़ाइल के रूप में सहेजें जिसे आप संस्करण नियंत्रण, CI पाइपलाइन, या किसी भी डाउनस्ट्रीम टूल में फीड कर सकते हैं। +- सामान्य किनारे के मामले—जब दस्तावेज़ में छवियाँ और समीकरण दोनों हों, या जब आपको Unicode अक्षर संरक्षित रखने हों तो क्या करें। +- एक पूर्ण, तैयार‑to‑run कोड नमूना जिसे आप सीधे एक कंसोल ऐप में डाल सकते हैं। + +### आवश्यकताएँ + +- .NET 6.0 या बाद का (कोड .NET Framework 4.7+ के साथ भी काम करता है)। +- **Aspose.Words for .NET** की लाइसेंस प्राप्त कॉपी (टेस्टिंग के लिए फ्री ट्रायल काम करता है)। +- Visual Studio 2022 या कोई भी IDE जो C# प्रोजेक्ट को कंपाइल कर सके। +- एक Word दस्तावेज़ (`input.docx`) जिसमें पहले से कुछ Office Math ऑब्जेक्ट्स हों। + +> **Pro tip:** यदि आपके पास अभी तक लाइसेंस नहीं है, तो आप Aspose की वेबसाइट से एक अस्थायी कुंजी का अनुरोध कर सकते हैं—कोड में प्लेसहोल्डर को अपनी कुंजी से बदलें और फिर चलाएँ। + +## चरण 1 – NuGet के माध्यम से Aspose.Words स्थापित करें + +सबसे पहले: आपको अपने प्रोजेक्ट में लाइब्रेरी चाहिए। **Package Manager Console** खोलें और चलाएँ: + +```powershell +Install-Package Aspose.Words +``` + +यह एक ही लाइन सभी आवश्यक चीज़ें लाता है, जिसमें `Saving` नेमस्पेस भी शामिल है जहाँ `TxtSaveOptions` रहता है। कोई अतिरिक्त DLLs नहीं, कोई नेटिव डिपेंडेंसी नहीं—सिर्फ शुद्ध मैनेज्ड कोड। + +## चरण 2 – स्रोत Word दस्तावेज़ लोड करें + +अब हम वास्तव में उस फ़ाइल को पढ़ते हैं जिसमें समीकरण होते हैं। `Document` क्लास पूरे *.docx* स्ट्रक्चर को एब्स्ट्रैक्ट करती है, इसलिए आप इसे एक हाई‑लेवल ऑब्जेक्ट मॉडल की तरह उपयोग कर सकते हैं। + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Why this matters:** दस्तावेज़ को जल्दी लोड करने से आप उसके नोड ट्री की जाँच कर सकते हैं। यदि आप यह जाँच छोड़ देते हैं और फ़ाइल में कोई समीकरण नहीं है, तो भी आपको एक साफ़ txt फ़ाइल मिल जाएगी—पर आपको नहीं पता चलेगा कि LaTeX आउटपुट खाली क्यों है। + +## चरण 3 – LaTeX निर्यात के लिए TxtSaveOptions कॉन्फ़िगर करें + +Aspose आपको Office Math के रेंडरिंग पर सूक्ष्म नियंत्रण देता है। `OfficeMathExportMode` को `LaTeX` सेट करने से हर समीकरण को उसकी LaTeX समकक्ष में बदल दिया जाता है, न कि हटाया जाए या इमेज में बदल दिया जाए। + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Why this matters:** डिफ़ॉल्ट एक्सपोर्ट मोड समीकरणों को पूरी तरह से हटा देता। `LaTeX` में स्विच करने से गणितीय इरादा बना रहता है, जो बिल्कुल वही है जिसकी आपको बाद में फ़ाइल को LaTeX कंपाइलर या ऐसे markdown प्रोसेसर में फीड करने के लिए ज़रूरत होती है जो `$…$` सिंटैक्स समझता है। + +## चरण 4 – दस्तावेज़ को plain text के रूप में सहेजें + +विकल्प कॉन्फ़िगर होने के बाद, फ़ाइल को सहेजना एक‑लाइनर है। आउटपुट एक `.txt` फ़ाइल होगी जहाँ हर समीकरण LaTeX कोड के रूप में `$` डिलिमिटर से घिरा होगा (यदि आप `\[` … `\]` ब्लॉक्स पसंद करते हैं तो बाद में बदल सकते हैं)। + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### अपेक्षित परिणाम + +`output.txt` को किसी भी एडिटर में खोलें और आपको कुछ इस तरह दिखेगा: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +ध्यान दें कि सामान्य टेक्स्ट बिल्कुल वैसा ही रहता है जैसा था, जबकि समीकरण अब शुद्ध LaTeX स्ट्रिंग्स बन गए हैं। आप इन्हें सीधे एक LaTeX दस्तावेज़, Jupyter नोटबुक, या किसी भी टूल में कॉपी‑पेस्ट कर सकते हैं जो गणित को रेंडर करता है। + +## चरण 5 – किनारे के मामलों को संभालना + +### मिश्रित सामग्री (छवियाँ + समीकरण) + +यदि आपके Word फ़ाइल में छवियाँ भी हैं, तो `TxtSaveOptions` उपयोग करने पर Aspose उन्हें अनदेखा कर देगा। यह आमतौर पर **save word plain text** वर्कफ़्लो के लिए ठीक है, लेकिन यदि आपको छवियों को प्लेसहोल्डर के रूप में चाहिए तो आप कर सकते हैं: + +1. दस्तावेज़ को पहले HTML में निर्यात करें (`HtmlSaveOptions`) ताकि छवियाँ `` टैग के रूप में कैप्चर हों। +2. `TxtSaveOptions` के साथ दूसरा पास चलाएँ ताकि LaTeX समीकरण मिलें। +3. दो परिणामों को मैन्युअली या छोटे स्क्रिप्ट से मर्ज करें। + +### Unicode प्रतीक + +कुछ समीकरण विशेष Unicode अक्षर (जैसे ग्रीक अक्षर) उपयोग करते हैं। `TxtSaveOptions` में `Encoding = Encoding.UTF8` सेट करने से (जैसा कि चरण 3 में दिखाया गया है) ये प्रतीक रूपांतरण के दौरान बरकरार रहते हैं। + +### बड़े दस्तावेज़ + +बड़े फ़ाइलों (> 100 MB) के लिए, सहेजने की प्रक्रिया को स्ट्रीम करने पर विचार करें: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +स्ट्रीमिंग पूरे आउटपुट को मेमोरी में लोड करने से बचाती है, जो कम‑मेमोरी बिल्ड एजेंट्स पर जीवनरक्षक हो सकता है। + +## पूर्ण कार्यशील उदाहरण + +नीचे पूरा, कॉपी‑पेस्ट‑रेडी प्रोग्राम है जो सब कुछ जोड़ता है। केवल फ़ाइल पाथ बदलें और यदि आपके पास लाइसेंस है तो लाइसेंस लाइन जोड़ें। + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +प्रोग्राम चलाएँ (`dotnet run` यदि आप कंसोल प्रोजेक्ट उपयोग कर रहे हैं) और `output.txt` देखें। आपने अभी **saved docx as txt** किया है जबकि हर समीकरण को LaTeX के रूप में संरक्षित रखा—कोई मैनुअल कॉपी‑पेस्ट नहीं। + +## अक्सर पूछे जाने वाले प्रश्न + +**Q: क्या मैं डिलिमिटर को `$…$` से `\(...\)` में बदल सकता हूँ?** +A: हाँ। सहेजने के बाद, फ़ाइल पर एक सरल रिप्लेस चलाएँ: `output = output.Replace("$", @"\(").Replace("$", @"\)");`—ध्यान रखें कि मूल टेक्स्ट में मौजूद इनलाइन `$` अक्षरों को न बदलें। + +**Q: क्या यह Word 2007‑2019 फ़ाइलों के साथ काम करता है?** +A: बिल्कुल। Aspose.Words `.doc`, `.docx`, `.docm`, और यहाँ तक कि नए `.dotx` परिवार को भी सपोर्ट करता है। वही कोड सभी संस्करणों पर काम करता है। + +**Q: यदि मुझे मूल पैराग्राफ फ़ॉर्मेटिंग (टैब, कई स्पेस) बनाए रखने की ज़रूरत हो तो क्या करें?** +A: `txtSaveOptions.PreserveTableLayout = true;` और `txtSaveOptions.PreserveSpace = true;` सेट करें ताकि व्हाइटस्पेस बरकरार रहे। + +## निष्कर्ष + +हमने वह सब कवर किया जो आपको **save docx as txt** करते समय **exporting equations to LaTeX** करने के लिए चाहिए, Aspose.Words का उपयोग करके। मुख्य चरण हैं दस्तावेज़ लोड करना, `TxtSaveOptions` को `OfficeMathExportMode.LaTeX` के साथ कॉन्फ़िगर करना, और परिणाम सहेजना। इन तीन लाइनों के कोड से आप भरोसेमंद रूप से **convert word to latex** कर सकते हैं, अपने दस्तावेज़ को **save word plain text** रख सकते हैं, और गणितीय प्रतीकों के खोने से बच सकते हैं। + +अगली चुनौती के लिए तैयार हैं? इस वर्कफ़्लो को एक markdown जेनरेटर के साथ जोड़ें ताकि एक पूर्ण `.md` फ़ाइल बन सके जिसमें टेक्स्ट और LaTeX दोनों हों—Git‑बैक्ड डॉक्यूमेंटेशन या स्टैटिक‑साइट जेनरेटर के लिए परफेक्ट। या Aspose के `PdfSaveOptions` को एक्सप्लोर करें ताकि plain‑text फ़ाइल के साथ एक PDF संस्करण भी मिल सके। + +यदि आपको कोई समस्या आती है, तो नीचे टिप्पणी छोड़ें। Happy coding, और Word समीकरणों को साफ़ LaTeX में बदलने की सरलता का आनंद लें! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hindi/net/working-with-fonts/_index.md b/words/hindi/net/working-with-fonts/_index.md index 7b5c73e90a..227573f3b4 100644 --- a/words/hindi/net/working-with-fonts/_index.md +++ b/words/hindi/net/working-with-fonts/_index.md @@ -35,7 +35,7 @@ | [फ़ॉन्ट फ़ॉलबैक सेटिंग सेट करें](./set-font-fallback-settings/) | जानें कि .NET के लिए Aspose.Words में फ़ॉन्ट प्रतिस्थापन सेटिंग्स कैसे सेट करें और अपने Word दस्तावेज़ों में फ़ॉन्ट प्रतिस्थापन को अनुकूलित करें। | | [नोटो फ़ॉलबैक सेटिंग्स लोड करें](./load-noto-fallback-settings/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ में Noto फ़ॉलबैक सेटिंग लोड करना सीखें। सभी वर्णों को सही ढंग से प्रदर्शित करने के लिए हमारे चरण-दर-चरण मार्गदर्शिका का पालन करें। | | [फ़ॉन्ट फ़ोल्डर डिफ़ॉल्ट इंस्टेंस सेट करें](./set-fonts-folders-default-instance/) | इस चरण-दर-चरण ट्यूटोरियल के साथ .NET के लिए Aspose.Words में डिफ़ॉल्ट इंस्टेंस के लिए फ़ॉन्ट फ़ोल्डर सेट करना सीखें। अपने Word दस्तावेज़ों को आसानी से कस्टमाइज़ करें। | -| [फ़ॉन्ट फ़ोल्डर्स एकाधिक फ़ोल्डर्स सेट करें](./set-fonts-folders-multiple-folders/) | .NET के लिए Aspose.Words का उपयोग करके अपने Word दस्तावेज़ों में एकाधिक फ़ॉन्ट फ़ोल्डर सेट करना सीखें। यह चरण-दर-चरण मार्गदर्शिका सुनिश्चित करती है कि आपके दस्तावेज़ों में वही फ़ॉन्ट उपयोग किए जाएँ जिनकी आपको आवश्यकता है। | +| [फ़ॉन्ट फ़ोल्डर्स एकाधिक फ़ोल्डर्स सेट करें](./set-fonts-folders-multiple-folders/) | .NET के लिए Aspose.Words का उपयोग करके अपने Word दस्तावेज़ में एकाधिक फ़ॉन्ट फ़ोल्डर सेट करना सीखें। यह चरण-दर-चरण मार्गदर्शिका सुनिश्चित करती है कि आपके दस्तावेज़ों में वही फ़ॉन्ट उपयोग किए जाएँ जिनकी आपको आवश्यकता है। | | [फ़ॉन्ट फ़ोल्डर सिस्टम और कस्टम फ़ोल्डर सेट करें](./set-fonts-folders-system-and-custom-folder/) जानें कि .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में सिस्टम और कस्टम फ़ॉन्ट फ़ोल्डर कैसे सेट करें, जिससे यह सुनिश्चित हो सके कि आपके दस्तावेज़ विभिन्न वातावरणों में सही ढंग से प्रदर्शित हों। | | [प्राथमिकता के साथ फ़ॉन्ट फ़ोल्डर सेट करें](./set-fonts-folders-with-priority/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में प्राथमिकता के साथ फ़ॉन्ट फ़ोल्डर सेट करना सीखें। हमारा गाइड सुनिश्चित करता है कि आपके दस्तावेज़ हर बार पूरी तरह से रेंडर हों। | | [ट्रू टाइप फ़ॉन्ट्स फ़ोल्डर सेट करें](./set-true-type-fonts-folder/) | .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ों में ट्रू टाइप फ़ॉन्ट फ़ोल्डर सेट करना सीखें। सुसंगत फ़ॉन्ट प्रबंधन सुनिश्चित करने के लिए हमारे विस्तृत, चरण-दर-चरण मार्गदर्शिका का पालन करें। | @@ -48,7 +48,7 @@ | [चेतावनी अधिसूचना प्राप्त करें](./receive-warning-notification/) जानें कि .NET के लिए Aspose.Words का उपयोग करते समय चेतावनी अधिसूचना कैसे प्राप्त करें और अपने दस्तावेज़ों में किसी भी समस्या या चेतावनी का प्रबंधन कैसे करें। | | [संसाधन स्टीम फ़ॉन्ट स्रोत उदाहरण](./resource-steam-font-source-example/) | .NET के लिए Aspose.Words में कस्टम फ़ॉन्ट लोड करने के लिए संसाधन स्ट्रीम फ़ॉन्ट स्रोत का उपयोग करना सीखें। | | [प्रत्यय के बिना प्रतिस्थापन प्राप्त करें](./get-substitution-without-suffixes/) | इस ट्यूटोरियल में, Aspose.Words for .NET के साथ Word दस्तावेज़ में प्रत्यय रहित ओवरराइड प्राप्त करना सीखें। | - +| [Aspose फ़ॉन्ट प्रतिस्थापन – C# में फ़ॉन्ट सेटिंग्स कैसे कॉन्फ़िगर करें](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | .NET के लिए Aspose.Words में फ़ॉन्ट प्रतिस्थापन सेटिंग्स को कॉन्फ़िगर करने की चरण-दर-चरण गाइड। | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hindi/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/hindi/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..15c69f4606 --- /dev/null +++ b/words/hindi/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose फ़ॉन्ट प्रतिस्थापन को आसान बनाएं: फ़ॉन्ट सेटिंग्स को कॉन्फ़िगर + करना सीखें, चेतावनियों को पकड़ें, और अपने .NET एप्लिकेशन में गायब फ़ॉन्ट्स को संभालें।' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: hi +og_description: फ़ॉन्ट सेटिंग्स को कॉन्फ़िगर करके और एक चेतावनी कॉलबैक के साथ लापता + फ़ॉन्ट्स को संभालकर Aspose फ़ॉन्ट प्रतिस्थापन में निपुण बनें। पूर्ण C# गाइड। +og_title: Aspose फ़ॉन्ट प्रतिस्थापन – C# में फ़ॉन्ट सेटिंग्स कॉन्फ़िगर करें +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose फ़ॉन्ट प्रतिस्थापन – C# में फ़ॉन्ट सेटिंग्स कैसे कॉन्फ़िगर करें +url: /hi/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose फ़ॉन्ट प्रतिस्थापन – फ़ॉन्ट सेटिंग्स को कॉन्फ़िगर करने के लिए पूर्ण गाइड + +क्या आप कभी ऐसे दस्तावेज़ से मिले हैं जो अचानक आपके कस्टम टाइपफ़ेस को किसी सामान्य फ़ॉन्ट से बदल देता है? यही **aspose font substitution** अपना काम कर रहा है—ग़ायब फ़ॉन्ट को सबसे नज़दीकी मिलते‑जुलते फ़ॉन्ट से बदलना। यह सुविधाजनक है, लेकिन यदि आपको *सटीक* रूप से पता करना है कि कौन सा फ़ॉन्ट बदला गया, तो आपको लाइब्रेरी की warning सिस्टम को उपयोग करना होगा और फ़ॉन्ट सेटिंग्स को स्वयं कॉन्फ़िगर करना होगा। + +इस ट्यूटोरियल में हम एक वास्तविक परिदृश्य को देखेंगे: एक DOCX लोड करना जो ऐसी फ़ॉन्ट का संदर्भ देता है जो आपके पास नहीं है, प्रतिस्थापन इवेंट को कैप्चर करना, और कंसोल में एक मित्रवत संदेश प्रिंट करना। अंत तक आप **configure font settings** में सहज हो जाएंगे, **Aspose.Words warning callback** को वायर करेंगे, और इस सैंपल को किसी भी वर्कफ़्लो में विस्तारित कर सकेंगे। + +> **What you’ll need** +> • .NET 6+ (or .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • A DOCX that references a missing font (we’ll call it `MissingFont.docx`) + +चलिए शुरू करते हैं। + +--- + +## चरण 1: Aspose.Words स्थापित करें और प्रोजेक्ट तैयार करें + +कोड लिखने से पहले सुनिश्चित करें कि Aspose.Words पैकेज रेफ़रेंस किया गया है: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro tip:** नवीनतम स्थिर संस्करण का उपयोग करें; मार्च 2026 तक यह 23.11.0 है। नए रिलीज़ फ़ॉन्ट‑मैचिंग एल्गोरिदम को सुधारते हैं और अतिरिक्त warning प्रकार जोड़ते हैं। + +एक नया कंसोल ऐप बनाएं (या कोड को मौजूदा प्रोजेक्ट में डालें) और सामान्य `using` निर्देश जोड़ें: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +इन नेमस्पेसेज़ से हमें `Document`, `LoadOptions`, और फ़ॉन्ट‑संबंधी क्लासेज़ तक पहुँच मिलती है जो हमें चाहिए। + +--- + +## चरण 2: LoadOptions के साथ फ़ॉन्ट सेटिंग्स कॉन्फ़िगर करें + +**aspose font substitution** नियंत्रण का दिल `LoadOptions.FontSettings` में रहता है। एक खाली `FontSettings` ऑब्जेक्ट प्रदान करके हम Aspose को उसके डिफ़ॉल्ट सर्च पाथ्स *और* किसी भी प्रतिस्थापन को warning callback के माध्यम से रिपोर्ट करने को कहते हैं। + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +डिफ़ॉल्ट पर भरोसा क्यों नहीं किया जाए? क्योंकि warning callback (अगला चरण) केवल तब काम करता है जब `FontSettings` प्रॉपर्टी non‑null हो। यह छोटी सी लाइन हमें प्रतिस्थापन प्रक्रिया में हुक देती है बिना वास्तविक फ़ॉन्ट सर्च व्यवहार को बदले। + +--- + +## चरण 3: प्रतिस्थापन को कैप्चर करने के लिए Warning Callback संलग्न करें + +Aspose.Words `IWarningCallback` इंटरफ़ेस को इम्प्लीमेंट करता है। जब भी कुछ उल्लेखनीय होता है—जैसे ग़ायब फ़ॉन्ट—तो यह हमारे `Warning` मेथड को कॉल करता है। हम एक छोटा हैंडलर इम्प्लीमेंट करेंगे जो `WarningType.FontSubstitution` को फ़िल्टर करता है और विवरण प्रिंट करता है। + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +और यहाँ हैंडलर स्वयं है: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Why this matters** – बिना callback के, Aspose चुपचाप फ़ॉन्ट बदल देता है, और आपको कभी नहीं पता चलता कि कौन सा उपयोग हुआ। callback प्रक्रिया को पारदर्शी बनाता है, जो compliance रिपोर्टिंग या लेआउट समस्याओं को डीबग करने के लिए आवश्यक है। + +--- + +## चरण 4: कॉन्फ़िगर किए गए विकल्पों का उपयोग करके दस्तावेज़ लोड करें + +अब हम अंततः दस्तावेज़ लोड करते हैं, वह `loadOptions` पास करते हुए जो हमने अभी तैयार किया है। यदि स्रोत फ़ाइल में ऐसा फ़ॉन्ट संदर्भित है जो स्थापित नहीं है, तो हमारा हैंडलर फायर होगा। + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +`YOUR_DIRECTORY` को उस वास्तविक पाथ से बदलें जहाँ `MissingFont.docx` स्थित है। जब आप प्रोग्राम चलाएँगे, तो आपको इस प्रकार का आउटपुट दिखना चाहिए: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +यह लाइन आपको बिल्कुल बताती है कि कौन सा फ़ॉन्ट ग़ायब था और Aspose ने कौन सा फ़ॉलबैक चुना। + +--- + +## चरण 5: (वैकल्पिक) फ़ॉन्ट सर्च पाथ को फाइन‑ट्यून करें + +यदि आपके पास कॉर्पोरेट फ़ॉन्ट्स वाला निजी फ़ोल्डर है, तो आप Aspose को सिस्टम फ़ॉन्ट्स पर वापस जाने से पहले वहाँ देखना बता सकते हैं। यह **configure font settings** का एक उन्नत उपयोग है: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +`recursive: true` सेट करने से Aspose सबफ़ोल्डर्स को भी स्कैन करेगा। अब लाइब्रेरी पहले आपके निजी फ़ॉन्ट्स को देखेगी, जिससे अनचाहे प्रतिस्थापन की संभावना कम होगी। + +--- + +## पूर्ण कार्यशील उदाहरण + +सब कुछ एक साथ रखते हुए, यहाँ पूरा, तैयार‑चलाने‑योग्य प्रोग्राम है: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Expected output** (when a missing font is encountered): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +यदि सभी फ़ॉन्ट्स मौजूद हैं, तो प्रोग्राम चुपचाप चलता है (कोई warning नहीं) और फिर भी PDF उत्पन्न करता है। + +--- + +## सामान्य प्रश्न और किनारे के मामलों + +### यदि मुझे पूरी तरह से प्रतिस्थापन रोकना हो तो क्या करें? + +`FontSettings.SubstitutionSettings` को `null` सेट करें या `FontSettings.FontSubstitutionSettings` का उपयोग करके व्यवहार को नियंत्रित करें। उदाहरण के लिए: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +अब Aspose चुपचाप प्रतिस्थापन करने के बजाय एक exception थ्रो करेगा, जिसे आप पकड़ कर हैंडल कर सकते हैं। + +### क्या यह अन्य फ़ाइल फ़ॉर्मेट्स (जैसे .doc, .rtf) के साथ काम करता है? + +बिल्कुल। वही `LoadOptions` ऑब्जेक्ट किसी भी `Document` कंस्ट्रक्टर को पास किया जा सकता है जो फ़ाइल पाथ स्वीकार करता है। warning callback सभी उन फ़ॉर्मेट्स के लिए फायर होगा जो फ़ॉन्ट्स पर निर्भर होते हैं। + +### क्या मैं सटीक फॉलबैक फ़ॉन्ट नाम कैप्चर कर सकता हूँ? + +हाँ। `info.Description` स्ट्रिंग में ग़ायब फ़ॉन्ट और प्रतिस्थापन दोनों शामिल होते हैं। यदि आपको नाम प्रोग्रामेटिक रूप से चाहिए, तो आप इसे पार्स कर सकते हैं या `FontInfo` ऑब्जेक्ट (नए संस्करणों में उपलब्ध) का उपयोग कर सकते हैं। + +### बहु‑थ्रेडेड वातावरण में यह कैसे व्यवहार करता है? + +`FontSettings` **थ्रेड‑सेफ़** नहीं है। प्रत्येक थ्रेड के लिए एक अलग `LoadOptions` (अपनी `FontSettings` के साथ) बनाएं, या एक्सेस को लॉक के साथ सुरक्षित रखें। + +--- + +## निष्कर्ष + +हमने वह सब कवर किया जो आपको **aspose font substitution** और **configure font settings** को C# एप्लिकेशन में महारत हासिल करने के लिए चाहिए: + +1. Aspose.Words स्थापित करें और आवश्यक `using` स्टेटमेंट जोड़ें। +2. एक नया `LoadOptions` ऑब्जेक्ट एक ताज़ा `FontSettings` के साथ बनाएं। +3. कस्टम `IWarningCallback` संलग्न करें ताकि प्रतिस्थापन इवेंट्स दिख सकें। +4. दस्तावेज़ लोड करें, जिससे callback किसी भी ग़ायब फ़ॉन्ट की रिपोर्ट करे। +5. (वैकल्पिक) सर्च पाथ विस्तारित करें या पूरी तरह से प्रतिस्थापन अक्षम करें। + +इस पैटर्न से आप compliance के लिए ग़ायब फ़ॉन्ट्स को लॉग कर सकते हैं, UI में उपयोगकर्ताओं को अलर्ट कर सकते हैं, या प्रकाशन से पहले स्वचालित रूप से फ़ॉलबैक फ़ॉन्ट एम्बेड कर सकते हैं। अगला कदम आप **Aspose.Words font substitution policies** का अन्वेषण कर सकते हैं या इस वर्कफ़्लो को बड़े दस्तावेज़‑प्रोसेसिंग पाइपलाइन में एकीकृत कर सकते हैं। + +कोडिंग का आनंद लें, और आपके दस्तावेज़ हमेशा सही टाइपफ़ेस के साथ रेंडर हों! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hongkong/net/basic-conversions/_index.md b/words/hongkong/net/basic-conversions/_index.md index 4b06abe748..cbd1d00774 100644 --- a/words/hongkong/net/basic-conversions/_index.md +++ b/words/hongkong/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ | [將 PDF 儲存為 Jpeg](./pdf-to-jpeg/) |使用 Aspose.Words for .NET 輕鬆將 PDF 轉換為 JPEG。請遵循我們的詳細指南，其中包含範例和常見問題。非常適合開發人員和愛好者。 | | [將 PDF 儲存為 Word 格式 (Docx)](./pdf-to-docx/) |透過本詳細的逐步指南了解如何使用 Aspose.Words for .NET 將 PDF 轉換為 Word 文件 (Docx)。非常適合開發人員。 | | [使用 Aspose.Words 將 Word 儲存為 PDF – 完整 C# 教學](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | 完整指南教您在 C# 中使用 Aspose.Words 將 Word 檔案儲存為 PDF，提供程式碼範例與最佳實踐。 | +| [使用 Aspose.Words 將 Word 轉換為 PDF – 完整指南](./convert-word-to-pdf-with-aspose-words-complete-guide/) | 了解如何使用 Aspose.Words for .NET 在 C# 中將 Word 文件完整轉換為 PDF，提供詳細步驟與程式碼範例。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hongkong/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/hongkong/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..2e89fbdf79 --- /dev/null +++ b/words/hongkong/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: 使用 Aspose.Words 快速將 Word 轉換為 PDF。了解如何將 Word 儲存為 PDF、將 docx 匯出為 PDF，以及在 + C# 中產生可存取的 PDF。 +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: zh-hant +og_description: 使用 Aspose.Words 在 C# 中將 Word 轉換為 PDF。本指南展示如何將 Word 儲存為 PDF、將 docx + 匯出為 PDF，以及產生可存取的 PDF。 +og_title: 使用 Aspose.Words 將 Word 轉換為 PDF – 步驟說明 +tags: +- Aspose.Words +- C# +- PDF conversion +title: 使用 Aspose.Words 將 Word 轉換為 PDF – 完整指南 +url: /zh-hant/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 使用 Aspose.Words 轉換 Word 為 PDF – 完整指南 + +有沒有想過如何在不使用第三方網上工具的情況下 **convert Word to PDF**？也許你正在構建自動化報告引擎，需要一個可靠的方式即時 *save word as pdf*。好消息是 Aspose.Words 讓整個過程變得輕而易舉，甚至可以產生符合 **PDF/UA‑2** 標準的檔案——非常適合無障礙需求。 + +在本教學中，我們將逐步說明你需要的所有內容：載入 `.docx`、設定 PDF 選項以便能夠 *export docx to pdf* 並符合 PDF/UA 標準，最後將結果儲存為可存取的 PDF。完成後，你將擁有一段自包含、可直接投入任何 .NET 專案的生產就緒程式碼片段。 + +![Convert Word to PDF using Aspose.Words](convert-word-to-pdf.png) + +## 你將學到的內容 + +- **Why Aspose.Words** 是在 *generate accessible pdf* 情境下的可靠選擇。 +- 使用 PDF/UA‑2 合規性的 *save document as pdf* 的完整步驟。 +- 如何處理常見的例外情況，例如缺少字型或受密碼保護的來源檔案。 +- 快速技巧：除錯輸出並驗證無障礙合規性。 + +### 前置條件 + +- .NET 6 或更高版本（此 API 亦支援 .NET Framework 4.6+）。 +- 有效的 Aspose.Words for .NET 授權（免費試用版可用於評估）。 +- 基本的 C# 知識——不需要複雜的設計模式。 + +如果你已滿足以上條件，讓我們開始吧。 + +--- + +## 轉換 Word 為 PDF – 步驟實作 + +我們將把解決方案分為五個清晰的步驟。每個步驟都有標題、簡短的程式碼片段，以及說明 *why* 這段程式碼重要的解說。 + +### 步驟 1：載入要轉換的 Word 文件 + +你首先需要的是一個代表來源檔案的 `Document` 物件。Aspose.Words 能讀取 **.docx**、**.doc**、**.rtf** 以及許多其他格式，讓你無論檔案最初如何建立，都能 *save word as pdf*。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**此為何重要：** +- 提前載入檔案可在浪費 CPU 資源前捕捉到檔案遺失錯誤。 +- `Document` 類別抽象化了 Word 檔案的內部結構，提供一個乾淨的物件模型供你使用。 + +### 步驟 2：設定 PDF 儲存選項以符合無障礙需求 + +如果你需要 *generate accessible pdf* 檔案，必須告訴 Aspose.Words 產生符合 PDF/UA‑2 標準的文件。`PdfSaveOptions` 類別讓你對輸出進行精細的控制。 + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**此為何重要：** +- `PdfCompliance.PdfUa2` 告訴函式庫加入螢幕閱讀器所依賴的必要標籤、結構資訊與中繼資料。 +- 嵌入字型（`EmbedFullFonts = true`）可避免在不同作業系統開啟 PDF 時出現「找不到字型」的警告。 +- 設定 `Title` 有助於輔助技術正確宣告文件名稱。 + +### 步驟 3：將文件儲存為 PDF + +現在來源已載入且選項已設定，實際的轉換只需要一行程式碼。這就是 *export docx to pdf* 的地方。 + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**此為何重要：** +- `Save` 方法會遵循我們先前設定的 `PdfSaveOptions`，確保無障礙功能已內建。 +- 將呼叫包在 `try/catch` 區塊中，可讓你記錄或顯示常見的授權或權限錯誤，這些錯誤常讓新手卡關。 + +### 步驟 4：驗證 PDF/UA 合規性（可選但建議執行） + +即使 Aspose.Words 已完成大部分工作，仍建議再次檢查輸出，特別是當你向政府機關或其他受規範的單位交付文件時。 + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**此為何重要：** +- `IsTagged` 是快速的基本檢查；完整的 PDF/UA 驗證需要專門的驗證器，但大多數合規問題會以缺少標籤的形式出現。 +- 如果此旗標回傳 `false`，你可以重新檢查 `PdfSaveOptions`——可能忘記設定 `Compliance`，或是來源文件缺乏正確的標題樣式。 + +### 步驟 5：常見陷阱與專業提示 + +| 陷阱 | 發生情況 | 解決方法 | +|---------|--------------|------------| +| **Missing fonts** | PDF 中的文字顯示為方框。 | 設定 `EmbedFullFonts = true` **或** 在伺服器上安裝缺少的字型。 | +| **Unlicensed library** | Aspose 會在每一頁加上浮水印。 | 在應用程式啟動時盡早加入授權檔案 (`Aspose.Words.lic`)，例如 `License license = new License(); license.SetLicense("Aspose.Words.lic");`。 | +| **Password‑protected source** | 在 `new Document(path)` 時拋出 `InvalidOperationException`。 | 使用重載 `new Document(path, new LoadOptions { Password = "secret" })`。 | +| **Large documents cause OOM** | 處理大型檔案時發生記憶體不足例外。 | 在 `PdfSaveOptions` 中啟用 `MemoryOptimization`（`saveOptions.MemoryOptimization = true`）。 | +| **Accessibility tags missing** | PDF/UA 驗證失敗。 | 確保來源 Word 檔使用正確的標題樣式（`Heading 1`、`Heading 2` 等）—Aspose 會自動將它們映射為 PDF 標籤。 | + +**Pro tip:** 如果你一次批次轉換多個文件，請重複使用同一個 `PdfSaveOptions` 實例。只建立一次可減少配置開銷，並保持記憶體佔用低。 + +--- + +## 完整可執行範例（直接複製貼上） + +以下是將所有步驟整合的完整程式。將其儲存為 `Program.cs`，加入 Aspose.Words 與 Aspose.PDF 的 NuGet 套件，然後執行。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**預期結果：** +會在 `C:\MyFiles` 產生名為 `output.pdf` 的檔案。使用 Adobe Acrobat 開啟時，合規性面板會顯示 “PDF/A‑2b, PDF/UA‑1”，證明你已成功 *convert word to pdf* + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hongkong/net/programming-with-markdownsaveoptions/_index.md b/words/hongkong/net/programming-with-markdownsaveoptions/_index.md index 683c822db1..ccfa76105d 100644 --- a/words/hongkong/net/programming-with-markdownsaveoptions/_index.md +++ b/words/hongkong/net/programming-with-markdownsaveoptions/_index.md @@ -31,7 +31,10 @@ | [將 docx 儲存為 markdown – 完整 C# 指南（含 LaTeX 方程式）](./save-docx-as-markdown-complete-c-guide-with-latex-equations/) |示範如何使用 Aspose.Words for .NET 在 C# 中將 DOCX 轉換為包含 LaTeX 方程式的 Markdown，提供完整步驟與範例程式碼。 | | [將 docx 儲存為 markdown – 完整 C# 指南（含圖像提取）](./save-docx-as-markdown-full-c-guide-with-image-extraction/) |示範如何使用 Aspose.Words for .NET 在 C# 中將 DOCX 轉換為 Markdown，並提取圖像。 | | [如何將 Word 匯出為 Markdown – 完整 C# 指南](./how-to-export-markdown-from-word-complete-c-guide/) |示範如何使用 Aspose.Words for .NET 在 C# 中將 Word 文件匯出為 Markdown，提供完整步驟與範例程式碼。 | +| [將 Word 轉換為 Markdown – 完整 C# 指南](./create-markdown-from-word-full-c-guide/) |示範如何使用 Aspose.Words for .NET 在 C# 中將 Word 文件完整轉換為 Markdown，提供完整範例程式碼。 | | [如何將 DOCX 匯出為 Markdown – 完整 C# 指南](./how-to-export-markdown-from-docx-complete-guide/) |示範如何使用 Aspose.Words for .NET 在 C# 中將 DOCX 匯出為 Markdown，提供完整步驟與範例程式碼。 | +| [如何從 Word 匯出 LaTeX – 將 DOCX 轉換為 Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) |示範如何使用 Aspose.Words for .NET 從 Word 匯出 LaTeX，將 DOCX 轉換為 Markdown。 | +| [如何從 DOCX 匯出 LaTeX – 轉換為 Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) |示範如何使用 Aspose.Words for .NET 從 DOCX 匯出 LaTeX，並轉換為 Markdown。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hongkong/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/hongkong/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..eba31e05c2 --- /dev/null +++ b/words/hongkong/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,251 @@ +--- +category: general +date: 2026-03-27 +description: 使用 Aspose.Words C# 從 Word 建立 Markdown。學習如何將 docx 轉換為 markdown、從 Word + 中擷取圖片，以及在單一教學中如何使用回呼。 +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: zh-hant +og_description: 使用 Aspose.Words 從 Word 產生 Markdown。本指南說明如何將 docx 轉換為 markdown、從 Word + 中提取圖片，以及使用回呼函式處理資源。 +og_title: 從 Word 產生 Markdown – 完整 C# 教程 +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: 從 Word 產生 Markdown – 完整 C# 指南 +url: /zh-hant/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 從 Word 建立 Markdown – 完整 C# 教程 + +有沒有曾經需要**從 Word 建立 markdown**卻不知從何下手？你並不孤單；許多開發者在嘗試將 .docx 檔案內容搬移到靜態網站產生器或文件倉庫時，都會碰到這個問題。好消息是？使用 Aspose.Words 你可以**將 docx 轉換為 markdown**，將原始檔案中的所有圖片抽取出來，並且精確控制這些資源的存放位置——只需一個簡單的回呼(callback)。 + +在本指南中，我們將示範一個真實案例，說明如何從 Word 抽取圖片、如何使用回呼儲存圖片，以及為什麼此方法是自動化流程中最可靠的方案。完成後，你將擁有一個可直接執行的 C# 程式，產出乾淨的 `.md` 檔案以及一個圖片匯出資料夾。 + +> **專業小技巧：** 若你已有包含螢幕截圖、圖表或商標的 Word 範本，此方法會完整保留每個視覺元素，無需手動複製貼上。 + +--- + +## 需要的環境 + +- **.NET 6+**（或 .NET Framework 4.6+）。程式碼在任何近期的執行環境皆可運作。 +- **Aspose.Words for .NET**（NuGet 套件 `Aspose.Words`）。免費試用版已足以應付大多數情境。 +- 一個 **Word 文件**（`input.docx`），內含文字與至少一張圖片。 +- 基本的 C# 與 Visual Studio（或你慣用的 IDE）知識。 + +不需要額外的函式庫——其餘全部由 Aspose.Words 內建處理。 + +--- + +## Step 1: 設定專案並安裝 Aspose.Words + +為了保持整潔，先建立一個新的 Console 專案： + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **為什麼這一步重要：** 安裝 NuGet 套件可確保取得最新的 API，其中包含自 22.9 版起加入的 `MarkdownSaveOptions` 類別。若沒有它，你必須自行撰寫轉換程式。 + +--- + +## Step 2: 載入來源 Word 文件 + +以下程式碼的第一行會開啟你想要轉換的 `.docx`。請將 `YOUR_DIRECTORY` 替換成你機器上的實際路徑。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **發生了什麼事？** `Document` 會解析檔案、建立內部的 DOM，讓每個段落、表格與圖片都可被存取。若檔案不存在，Aspose 會拋出清晰的 `FileNotFoundException`，你可以捕捉它以提供更友善的 UI。 + +--- + +## Step 3: 設定 Markdown 儲存選項與資源儲存回呼 + +這裡就是 **如何使用回呼** 發揮魔力的地方。回呼讓你自行決定每張抽取出的圖片要存放在哪裡。 + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **為什麼需要回呼？** 預設情況下 Aspose 會把圖片以 base‑64 字串嵌入 markdown，對於版本控制而言是災難。使用回呼即可完全掌控檔名與資料夾結構。 + +--- + +## Step 4: 將文件儲存為 Markdown + +現在正式產生 `.md` 檔案。所有圖片都會交由前一步所定義的回呼處理。 + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +如果一切順利，你會在目標資料夾看到 `Document.md`，以及名為 `Resources` 的子資料夾，裡面放著從原始 Word 檔抽出的所有圖片。 + +--- + +## Step 5: 實作儲存每張抽取圖片的回呼 + +以下是 `MyResourceSaver` 的完整實作。它會建立 `Resources` 目錄（若不存在），為每張圖片產生唯一檔名，並將圖片串流寫入磁碟。 + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **參數說明：** +> - `args.Index` – 從 0 起算的計數器，保證檔名唯一。 +> - `args.FileName` – Aspose 建議的原始檔名（通常類似 `image001.png`）。 +> - `args.Stream` – 用來寫入圖片位元組的輸出串流。 +> - `args.KeepResourceStreamOpen` – 設為 `false`，讓 Aspose 自動釋放串流，避免檔案句柄洩漏。 + +--- + +## Full Working Example + +把所有程式碼整合起來，以下是一個可以直接貼到 `Program.cs` 的單一檔案。別忘了將 `YOUR_DIRECTORY` 改成符合你環境的絕對或相對路徑。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### 預期輸出 + +- `YOUR_DIRECTORY/Document.md` – 包含標準 markdown 圖片連結的 markdown 檔，例如： + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – 內含 `img_0.png`、`img_1.jpg` 等檔案，順序與原始 Word 文件中出現的順序相同。 + +執行程式時會印出友善的確認訊息，告訴你處理已成功完成。 + +--- + +## Frequently Asked Questions (FAQ) + +### 如何在抽取圖片時保持原始畫質？ + +回呼會直接將原始二進位串流寫入檔案，保留原始解析度。除非你在 `ResourceSaving` 內自行加入影像處理邏輯，否則不會進行任何轉換或壓縮。 + +### 能否在抽取過程中變更圖片格式（例如 PNG → JPEG）？ + +絕對可以。於 `ResourceSaving` 中檢查 `args.FileName` 或 `args.Stream`，使用 `System.Drawing`、`ImageSharp` 等套件載入影像後重新編碼，再寫入檔案。別忘了同步更新 markdown 連結的副檔名。 + +### 若要讓 markdown 連結指向 CDN 而非本機資料夾，該怎麼做？ + +在回呼裡把 `args.FileName` 設為完整的 URL（在上傳圖片至 CDN 後取得），即可讓 markdown 產生指向 CDN 的連結。 + +### 這個方法能處理表格、註腳或其他進階的 Word 功能嗎？ + +可以。Aspose.Words 會把大多數 Word 結構轉換為相對應的 markdown。表格會變成 markdown 表格，註腳會變成參考連結，甚至巢狀清單也會被妥善處理。若有異常，請參考最新的發行說明——Aspose 持續改進轉換精度。 + +### 如何在 CI/CD 流程中使用 docx 轉 markdown？ + +只要把編譯好的 `.exe` 加入建置步驟，指向產生的 `.docx` 成果，然後將產出的 `.md` 與 `Resources/` 資料夾推送至靜態網站倉庫。因為整個流程是完全決定性的，非常適合自動化環境。 + +--- + +## 結語 + +我們已示範如何使用 Aspose.Words **從 Word 建立 markdown**，完整說明 **docx 轉 markdown** 的工作流程，並展示如何透過自訂 **回呼** **抽取圖片**。最終得到的是一個乾淨的 markdown 檔案，搭配原始圖片的資料夾——非常適合文件站、靜態部落格，或任何偏好純文字格式的工作流程。 + +接下來你可以考慮： + +- **批次處理** 資料夾內多個 `.docx`（使用 `Directory.GetFiles` 迴圈）。 +- **自訂圖片命名規則**（例如使用原始圖說文字）。 +- **後處理** markdown，將圖片連結替換為 CDN URL。 +- 探索 **其他 Aspose 輸出格式** 如 HTML、PDF、EPUB，以支援多渠道出版。 + +有更多問題或遇到無法轉換的 Word 檔案嗎？在下方留言，我們一起排除困難。祝開發順利，享受將 Word 轉成 markdown 的簡潔體驗！ + +--- + +![Word 轉 Markdown 轉換流程圖](image.png "從 Word 產生 markdown 圖示") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hongkong/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/hongkong/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..6fdcb28b1c --- /dev/null +++ b/words/hongkong/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,264 @@ +--- +category: general +date: 2026-03-27 +description: 如何使用 Aspose.Words 從 DOCX 匯出 LaTeX。學習將 DOCX 轉換為 Markdown、設定 DPI，並在 C# + 中啟用復原功能。 +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: zh-hant +og_description: 如何使用 Aspose.Words 從 DOCX 匯出 LaTeX。本教學展示逐步轉換為 Markdown、DPI 控制以及復原模式。 +og_title: 如何從 DOCX 匯出 LaTeX – 轉換成 Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: 如何從 DOCX 匯出 LaTeX – 轉換為 Markdown +url: /zh-hant/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何從 DOCX 匯出 LaTeX – 轉換為 Markdown + +有沒有想過 **如何從 DOCX 檔案匯出 LaTeX** 而不失去方程式的美觀？你並不孤單。依我的經驗，最大痛點是將 OfficeMath 物件轉成乾淨、可攜帶的格式，以供靜態網站產生器或科學部落格使用。 + +在本指南中，我們將示範如何使用 Aspose.Words 將 DOCX 轉換為 Markdown，同時說明 **如何設定 DPI**、**如何啟用復原**，以及一些實用技巧，打造堅固的工作流程。完成後，你將擁有一個 C# 程式，能產生包含 LaTeX 方程式、高解析度影像與正確超連結處理的 Markdown 檔案。 + +## 需要的環境 + +- **.NET 6+**（或 .NET Framework 4.7.2 – API 使用方式相同） +- **Aspose.Words for .NET**（截至 2026 年 3 月的最新穩定版） +- 含有方程式、影像與連結的 DOCX 檔案 +- Visual Studio、VS Code 或任何你慣用的編輯器 + +除 Aspose.Words 外不需額外的 NuGet 套件，但若未使用試用版，請確保已取得有效授權。 + +## Step 1 – 使用嚴格復原模式載入 DOCX + +在考慮匯出之前，我們必須確保來源文件沒有隱藏的損毀。這就是 **如何啟用復原** 發揮作用的地方。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**為什麼使用嚴格復原？** +如果讓 Aspose 靜默修復問題，可能會導致段落遺失或影像損壞——在匯出 LaTeX 時沒有人願意看到這種情況。透過快速失敗，你可以及早發現問題，決定是修正原始 DOCX，還是記錄問題以供日後處理。 + +### 小技巧 +將載入動作包在 try/catch 中，並記錄 `DocumentLoadingException`。如此一來，CI pipeline 就能在不阻斷整個建置的情況下標記出有問題的檔案。 + +## Step 2 – 設定 Markdown 匯出選項 + +現在文件已安全載入記憶體，我們開始配置匯出方式。這是 **如何匯出 latex** 的核心，同時也涵蓋 **如何設定 DPI** 以處理內嵌影像。 + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**各選項功能說明** + +| 選項 | 說明 | 與關鍵字的關聯 | +|------|------|----------------| +| `OfficeMathExportMode = LaTeX` | 直接回應 **如何匯出 latex** 從方程式。 | 主要關鍵字 | +| `ImageResolution = 300` | 控制影像品質 – 回答 **如何設定 dpi**。 | 次要關鍵字 | +| `ResourceSavingCallback` | 將嵌入檔案儲存至磁碟，這是在 **convert docx to markdown** 時常見的需求。 | 次要關鍵字 | +| `EmptyParagraphExportMode` | 確保 Markdown 輸出乾淨，避免遺留 HTML 標籤。 | 提升整體轉換品質 | +| `LinkExportMode = AsReference` | 讓連結易於閱讀與編輯，對 **convert docx to markdown** 也是加分。 | 次要關鍵字 | + +## Step 3 – 實作自訂資源儲存器（可選但實用） + +在將 DOCX 轉換為 Markdown 時，影像與其他二進位資源需要寫入檔案系統。Aspose 允許透過 `IResourceSavingCallback` 進行控制。上面的程式碼已示範最小實作，以下進一步說明： + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**為什麼要這麼做？** +若省略此步驟，Aspose 會將影像以 base‑64 字串嵌入 Markdown，導致檔案體積暴增，且版本控制變得困難。將資源儲存至獨立資料夾，可讓 Markdown 保持輕量，亦方便 Hugo、Jekyll 等靜態網站產生器使用。 + +## Step 4 – 將文件儲存為 Markdown + +所有繁重的工作已完成。只要一行程式碼即可寫出最終檔案。 + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +開啟 `output.md` 後，你會看到： + +- 方程式以 `$…$` LaTeX 區塊呈現 +- 影像以 `![Alt text](resources/image001.png)` 方式引用，解析度為 300 dpi +- 超連結轉為參考樣式： + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +這就是完整的 **how to convert docx** 流程概述。 + +## 常見問題與邊緣案例 + +### 1️⃣ 如果 DOCX 含有不支援的物件會怎樣？ +Aspose.Words 會拋出 `FeatureNotSupportedException`。因為我們在嚴格模式下使用 **how to enable recovery**，例外會立即顯現。你可以： + +- 將 `RecoveryMode` 改為 `RecoveryMode.Default` 以進行盡力轉換，**或** +- 在執行轉換器前先前處理 DOCX（例如移除不支援的 SmartArt）。 + +### 2️⃣ 可以針對單一影像調整 DPI 嗎？ +`ImageResolution` 為全域設定。若需依圖調整，可實作自訂的 `ImageSavingCallback`（類似 `MyResourceSaver`），依 `args.ImageFileName` 或其 metadata 變更 `args.ImageResolution`。 + +### 3️⃣ 如何在 Jekyll 網站中嵌入產生的 LaTeX？ +Jekyll 內建的 MathJax 支援即可直接使用。只要在版型中加入 MathJax script，且將 LaTeX 區塊以 `$$` 包住（顯示式）或 `$` 包住（行內式），即可正常渲染。 + +### 4️⃣ 這在 Linux 上的 .NET Core 可用嗎？ +絕對可以。Aspose.Words 為跨平台套件。只要確保 `YOUR_DIRECTORY` 路徑符合 Linux 規範（例如 `/home/user/docs`）即可。 + +## 完整範例程式 + +以下提供可直接貼上執行的程式碼。將 `YOUR_DIRECTORY` 替換為你機器上的實際路徑。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**預期輸出** – 開啟 `output.md` 後，你應該會看到類似以下內容： + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +如果在支援 MathJax 的 Markdown 預覽中開啟此檔，積分符號即可正確渲染 + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hongkong/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/hongkong/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..4a6385587f --- /dev/null +++ b/words/hongkong/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,209 @@ +--- +category: general +date: 2026-03-27 +description: 如何使用 Aspose.Words 從 Word 文件匯出 LaTeX ─ 將 DOCX 轉換為包含 LaTeX 公式的 Markdown。 +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: zh-hant +og_description: 在第一句中說明了如何從 Word 文件匯出 LaTeX，示範如何將 DOCX 轉換為含有 LaTeX 方程式的 Markdown。 +og_title: 如何從 Word 匯出 LaTeX — 完整指南 +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: 如何從 Word 匯出 LaTeX – 將 DOCX 轉換為 Markdown +url: /zh-hant/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何從 Word 匯出 LaTeX – 將 DOCX 轉換為 Markdown + +有沒有想過 **如何從 Word 檔案匯出 LaTeX**，卻不會得到一堆 PNG 圖片？你並不是唯一遇到這個問題的人；開發者在需要乾淨、可編輯的公式於靜態網站或科學部落格時，常常卡在這裡。好消息是？使用 Aspose.Words，你可以 **將 Word 轉換為 Markdown**，並將每個 OfficeMath 物件保留為原生 LaTeX——不需要後處理。 + +在本教學中，我們將逐步說明 **將 Word 文件儲存為 Markdown** 同時 **將公式匯出為 LaTeX** 的完整流程。完成後，你將擁有可執行的 C# 程式碼片段、每個選項的清晰說明，以及處理複雜公式或混合內容等邊緣情況的技巧。無需外部工具，只需一個 NuGet 套件與幾行程式碼。 + +## 您需要的環境 + +- .NET 6+（或 .NET Framework 4.7.2 以上）– 最新執行環境效果最佳。 +- Visual Studio 2022 或任何能編譯 C# 專案的編輯器。 +- Aspose.Words for .NET 授權（免費試用版可用於實驗）。 +- 含有至少一個公式（OfficeMath）的 DOCX 檔案。 + +如果你已經具備上述條件，太好了——讓我們開始吧。 + +## 如何從 Word 匯出 LaTeX – 概覽 + +以下是此流程的高階概觀： + +1. **Install** the Aspose.Words NuGet package. +2. **Load** the source `.docx` that holds your equations. +3. **Configure** `MarkdownSaveOptions` so that `OfficeMathExportMode` is set to `LaTeX`. +4. **Save** the document as a `.md` file. +5. **Verify** that the generated Markdown contains LaTeX blocks (`$$…$$`). + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="從 Word 匯出 LaTeX 流程圖"} + +## 步驟 1 – 安裝 Aspose.Words for .NET（將 Word 轉換為 Markdown） + +首先，你需要這個負責核心工作的函式庫。打開終端機（或套件管理員主控台）並執行： + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** 如果你使用 Visual Studio，右鍵點擊專案 → *Manage NuGet Packages* → 搜尋 “Aspose.Words” 並安裝最新的穩定版。 + +為什麼這很重要：Aspose.Words 抽象化了 Open XML 格式，提供乾淨的 API 讓你在不必自行處理低階 XML 的情況下操作 Word 文件。它同時內建支援將 OfficeMath 轉換為 LaTeX，這正是我們 **export equations as LaTeX** 需求的核心。 + +## 步驟 2 – 載入 DOCX（如何轉換 docx） + +套件安裝完成後，載入你想要轉換的檔案。將 `YOUR_DIRECTORY` 替換成你的 `.docx` 所在路徑： + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Why load it this way?** `Document` 建構子會將整個檔案解析成物件模型，讓你即時存取段落、表格，以及最重要的 OfficeMath 物件。若檔案遺失或損毀，Aspose 會拋出具描述性的 `FileNotFoundException`，你可以捕捉它以實作優雅的錯誤處理。 + +## 步驟 3 – 設定 MarkdownSaveOptions（將公式匯出為 LaTeX） + +魔法發生在 `MarkdownSaveOptions` 物件中。預設情況下 Aspose 會把公式渲染成 PNG 圖片，但我們想要 LaTeX。將 `OfficeMathExportMode` 設為 `LaTeX`： + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +關於可選旗標的說明：`ExportImagesAsBase64` 告訴 Aspose 不要嵌入二進位資料，保持 Markdown 乾淨。`ExportHeadersFooters` 確保不會遺失可能位於頁首或頁腳的上下文——例如標題或作者名稱。 + +## 步驟 4 – 儲存文件（將 Word 儲存為 Markdown） + +最後，將轉換後的內容寫入 `.md` 檔案： + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +執行此行程式後，你會在來源檔案旁看到 `output.md`。用任何文字編輯器開啟，它應該會顯示類似以下的 LaTeX 區塊： + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +這就是 **save word as markdown** 的部分完成——不需要額外的轉換步驟。 + +## 步驟 5 – 驗證結果（將公式匯出為 LaTeX） + +驗證常被忽略，但快速的健全性檢查能省下大量時間。執行以下簡易腳本，讀取產生的檔案並印出第一個 LaTeX 區塊： + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +如果看到 `First LaTeX block: $$ … $$` 被印出，代表你已成功 **exported LaTeX** 從 Word。若沒有，請再次確認來源文件確實包含 OfficeMath 物件；純文字公式不會被轉換。 + +## 處理常見的邊緣情況 + +| Scenario | What to Watch For | Recommended Fix | +|----------|-------------------|-----------------| +| **混合圖片與公式** | Aspose 仍可能為非 OfficeMath 圖形嵌入圖片。 | 將 `ExportImagesAsBase64 = false`，並將圖片保留為外部檔案，然後在 Markdown 中手動引用它們。 | +| **複雜的巢狀公式** | 過深的巢狀可能產生需要手動調整的 LaTeX。 | 使用 LaTeX 格式化工具（例如 `latexindent`）後處理區塊，或調整 `mdOptions` → `ExportMathAsDisplay = true`。 | +| **大型文件** | 載入巨大的 `.docx` 檔案時記憶體使用量會急升。 | 使用 `LoadOptions` 搭配 `LoadFormat.Docx`，若支援則啟用 `LoadOptions.LoadFormat` 串流。 | +| **缺少授權** | 免費試用版會在輸出中加入浮水印註解。 | 透過 `License license = new License(); license.SetLicense("Aspose.Words.lic");` 套用有效授權。 | + +這些技巧能讓你的工作流程更穩健，尤其在 **convert word to markdown** 的生產環境中。 + +## 完整範例（所有步驟於單一檔案） + +以下是一個自包含的 Console 應用程式，你可以直接複製貼上到新建的 .NET 專案並立即執行。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +執行程式後，開啟 `output.md`，你會看到公式以乾淨的 LaTeX 呈現。這就是 **how to export latex** 從 Word 文件的完整解答。 + +## 結論 + +我們已逐步說明 **how to export LaTeX** 從 Word 的方法，展示了如何 **convert Word to markdown**、**save word as markdown**，以及使用 Aspose.Words **export equations as LaTeX**。核心概念很簡單：載入 DOCX、調整 `MarkdownSaveOptions`，讓函式庫負責繁重的轉換工作。 + +如果你已準備好自動化文件管線，試著將此程式碼與 Hugo、Jekyll 等靜態網站產生器串接——只要把產生的 `.md` 檔案推送到倉庫，網站就會自動重建。想深入了解，可參考 Aspose 的「Export to LaTeX」指南、嘗試 `HtmlSaveOptions` 以取得網頁預覽，或探索 `DocumentVisitor` API 進行自訂轉換。 + +對於邊緣情況、授權或 CI/CD 整合有任何疑問，歡迎在下方留言，祝開發順利！ + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hongkong/net/programming-with-pdfsaveoptions/_index.md b/words/hongkong/net/programming-with-pdfsaveoptions/_index.md index 4296691ae3..f02f307dbe 100644 --- a/words/hongkong/net/programming-with-pdfsaveoptions/_index.md +++ b/words/hongkong/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ Aspose.Words for .NET 教學中有關使用 PdfSaveOptions 進行文字處理的 | [更新 PDF 文件中的最後列印屬性](./update-last-printed-property/) |透過我們的逐步指南了解如何使用 Aspose.Words for .NET 更新 PDF 文件中的最後列印屬性。 | | [在 PDF 文件中渲染 3D DML 3DEffects](./dml-3deffects-rendering/) |透過本全面的逐步指南了解如何使用 Aspose.Words for .NET 在 PDF 文件中呈現令人驚嘆的 3D DML 效果。 | | [在 PDF 文件中插入影像](./interpolate-images/) |透過我們的逐步指南了解如何使用 Aspose.Words for .NET 在 PDF 文件中插入影像。輕鬆提升 PDF 的影像品質。 | - +| [如何使用 Aspose.Words 從 DOCX 儲存 PDF – 步驟指南](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) |透過本逐步指南了解如何使用 Aspose.Words for .NET 將 DOCX 檔案儲存為 PDF。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hongkong/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/hongkong/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..fb2bbd64a6 --- /dev/null +++ b/words/hongkong/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,195 @@ +--- +category: general +date: 2026-03-27 +description: 學習如何使用 Aspose.Words 從 DOCX 檔案儲存為 PDF。內容包括將 DOCX 轉換為 PDF、使用選項儲存 PDF，以及處理浮動圖形。 +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: zh-hant +og_description: 如何使用 Aspose.Words 從 DOCX 檔案儲存 PDF。本指南示範將 DOCX 轉換為 PDF、使用選項儲存 PDF，以及處理浮動圖形。 +og_title: 如何從 DOCX 另存為 PDF – 完整的 Aspose.Words 教學 +tags: +- Aspose.Words +- C# +- PDF conversion +title: 使用 Aspose.Words 從 DOCX 另存 PDF – 步驟指南 +url: /zh-hant/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何使用 Aspose.Words 從 DOCX 儲存 PDF – 完整教學 + +有沒有想過 **如何從 Word 文件儲存 PDF** 而不失去浮動形狀的版面配置？你並不是唯一有此疑問的人。在許多專案中——發票產生器、報表匯出工具或簡單的文件歸檔系統——開發人員都需要一種可靠的方式將 DOCX 轉換為 PDF，且保持所有內容在 Word 中的呈現完全相同。 + +在本教學中，我們將一步步說明如何 **使用 Aspose.Words for .NET** 將 DOCX 檔案轉換為 PDF，展示 **如何將 docx 轉換為 pdf** 並使用自訂儲存選項，並說明 `ExportFloatingShapesAsInlineTag` 旗標的重要性。完成後，你將擁有一段可直接執行的程式碼片段，能以你自行控制的選項儲存 PDF。 + +## 你將學會 + +- 使用 Aspose.Words 進行 **convert word document pdf** 的完整步驟。 +- 如何設定 `PdfSaveOptions` 以將浮動形狀視為內嵌標籤。 +- 處理浮動物件時常見的陷阱以及避免方法。 +- 一個完整且可執行的 C# 程式，你可以直接放入任何 .NET 專案中。 + +> **先決條件：** 你需要一個 Aspose.Words for .NET 授權（或免費評估版）以及 .NET 開發環境（Visual Studio、Rider，或 `dotnet` CLI）。 + +## 步驟 1：設定專案並加入 Aspose.Words + +首先，建立一個新的 Console 應用程式（或在現有專案中加入），並引用 Aspose.Words 的 NuGet 套件。 + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **專業提示：** 若你在 CI 伺服器上執行，請鎖定套件版本（`Aspose.Words --version 24.10`），以確保可重現的建置。 + +## 步驟 2：載入包含浮動形狀的 DOCX + +浮動圖片、文字方塊或 SmartArt 在轉換時可能導致版面移位。載入文件的動作相當簡單，但我們也會檢查檔案是否存在，以避免執行時拋出 `FileNotFoundException`。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +請留意 `Console.WriteLine` 陳述式——它們會在你從終端機執行應用程式時提供即時回饋。 + +## 步驟 3：設定 PDF 儲存選項（以選項儲存 PDF） + +這裡就是魔法發生的地方。預設情況下，Aspose.Words 會嘗試保留浮動物件的原始外觀，這可能會破壞最終 PDF 的版面配置。將 `ExportFloatingShapesAsInlineTag` 設為 `true`，即可指示函式庫將這些形狀視為內嵌標籤，確保它們固定於周圍文字上。 + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +為什麼這很重要？想像一個浮在段落上方的文字方塊。如果不進行內嵌標籤轉換，PDF 可能會把段落往下推，或是將方塊完整裁切。此旗標能保持視覺關係不變——對於專業報告而言，這是一個微妙卻關鍵的細節。 + +## 步驟 4：將文件儲存為 PDF + +現在我們實際寫入 PDF 檔案。`Save` 方法同時接受輸出路徑與剛才設定的選項。 + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +執行程式後會在與來源 DOCX 相同的資料夾產生 `output.pdf`。使用任何 PDF 檢視器開啟，你應該會看到所有浮動形狀都正確呈現在應有的位置。 + +## 完整可執行範例 + +以下是一整段程式碼。將它複製貼上至 `Program.cs`（或任何 C# 檔案），然後按 **F5** 執行。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### 預期結果 + +- **檔案已建立：** 目標目錄下的 `output.pdf`。 +- **版面忠實度：** 浮動形狀（圖片、文字方塊、SmartArt）會與周圍文字內嵌顯示。 +- **無例外拋出：** 程式順利結束，並在主控台印出狀態訊息。 + +## 常見問題與邊緣案例 + +| Question | Answer | +|----------|--------| +| **如果需要更高的影像品質該怎麼辦？** | 設定 `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **我可以一次批次轉換多個 DOCX 檔案嗎？** | 將載入/儲存的邏輯包在 `foreach (var file in Directory.GetFiles(..., "*.docx"))` 迴圈中。記得重複使用同一個 `PdfSaveOptions` 實例以提升效能。 | +| **這在 .NET Core 上能使用嗎？** | 當然可以。Aspose.Words 24.x 支援 .NET Standard 2.0+，因此可在 Windows、Linux 或 macOS 上執行相同程式碼。 | +| **密碼保護的 DOCX 檔案該怎麼處理？** | 使用 `new Document(inputPath, new LoadOptions { Password = "mySecret" })` 載入。儲存時同樣套用相同的 `PdfSaveOptions`。 | +| **內嵌標籤轉換對於複雜表格安全嗎？** | 一般而言是安全的，但非常複雜且形狀重疊的表格佈局仍可能需要手動微調。於大量遷移前先測試具代表性的樣本。 | + +## 真實專案的實用技巧 + +- **記錄日誌，而非僅使用 `Console.WriteLine`** – 在正式環境中，請以日誌框架（Serilog、NLog）取代主控台輸出，以捕捉錯誤。 +- **釋放資源** – `Document` 實作 `IDisposable`。若大量處理檔案，請將其包在 `using` 區塊中，以即時釋放記憶體。 +- **驗證 PDF** – 若需符合保存等級的 PDF，請使用 PDF 驗證工具（例如 PDF/A 合規檢查器）。 +- **平行處理** – 面對龐大工作負載時，可考慮使用 `Parallel.ForEach` 搭配執行緒安全的 `PdfSaveOptions`（每個執行緒複製一份）以加速轉換。 + +## 結論 + +我們已說明如何使用 Aspose.Words 從 DOCX 檔案 **儲存 PDF**，示範了使用自訂選項 **將 docx 轉換為 pdf**，並解釋了 `ExportFloatingShapesAsInlineTag` 的影響。完整且可執行的範例展示了只需幾行程式碼即可 **convert word document pdf**，且你現在了解如何 **save pdf with options** 以符合專案的品質與合規需求。 + +準備好接受下一個挑戰了嗎？可嘗試使用 `document.Save("output.html")` 匯出至其他格式（例如 HTML、EPUB），或實驗 PDF/A 合規以進行長期保存。相同的原則——載入、設定選項、儲存——適用於所有情況。 + +祝開發順利，願你的 PDF 永遠如你所預期的那樣完美呈現！ + +![說明 DOCX 檔案載入、套用選項並產生 PDF 的流程圖 – 如何儲存 PDF](https://example.com/images/how-to-save-pdf-diagram.png "如何儲存 PDF 圖示") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hongkong/net/programming-with-shapes/_index.md b/words/hongkong/net/programming-with-shapes/_index.md index 3f4f5686aa..4df6cef41c 100644 --- a/words/hongkong/net/programming-with-shapes/_index.md +++ b/words/hongkong/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Aspose.Words for .NET 教學中關於使用形狀進行文字處理的教學提 | [偵測智能藝術形狀](./detect-smart-art-shape/) |透過本綜合指南了解如何使用 Aspose.Words for .NET 偵測 Word 文件中的 SmartArt 形狀。非常適合自動化您的文件工作流程。 | | [更新智慧藝術繪圖](./update-smart-art-drawing/) |透過本逐步指南了解如何使用 Aspose.Words for .NET 更新 Word 文件中的 Smart Art 繪圖。確保您的視覺效果始終準確。 | | [在 Word 中使用 Aspose.Words 建立矩形形狀](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) |透過本逐步教學了解如何使用 Aspose.Words for .NET 在 Word 文件中插入矩形形狀。 | +| [建立 Word 文件 C# – 新增帶陰影的形狀](./create-word-document-c-add-shape-with-shadow/) |透過本逐步教學了解如何使用 Aspose.Words for .NET 在 Word 文件中新增帶陰影的形狀。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hongkong/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/hongkong/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..df086f537e --- /dev/null +++ b/words/hongkong/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-03-27 +description: 使用 C# 建立 Word 文件，學習如何新增形狀、為形狀套用陰影，以及設定陰影距離。Aspose.Words 步驟教學指南。 +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: zh-hant +og_description: 使用 C# 建立 Word 文件，加入矩形形狀與自訂陰影。請參考本完整教學，設定陰影距離與樣式。 +og_title: 使用 C# 建立 Word 文件 – 加入帶陰影的圖形 +tags: +- Aspose.Words +- C# +- Document Automation +title: 使用 C# 建立 Word 文件 – 為圖形添加陰影 +url: /zh-hant/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 建立 Word 文件 C# – 新增帶陰影的圖形 + +有沒有需要 **create word document c#** 且包含一個精美樣式的矩形？也許你正在製作報告範本，想要加入細緻的投影陰影讓版面更突出。在本教學中，我們將一步步說明如何新增圖形、對圖形套用陰影，甚至使用 Aspose.Words 調整陰影距離。 + +我們會從空白文件開始，插入一個矩形，套用預設陰影，最後儲存檔案。完成後，你將得到一個可直接在 Word 開啟並立即看到效果的 .docx 檔案。無需外部工具，純粹使用 C# 程式碼。 + +## 前置條件 + +- 已安裝 .NET 6（或任何較新的 .NET Framework）。 +- Visual Studio 2022 或搭配 C# 擴充功能的 VS Code。 +- Aspose.Words for .NET NuGet 套件（`Aspose.Words` 版本 23.12 或更新）。 + 你可以透過套件管理員主控台加入： + + ```powershell + Install-Package Aspose.Words + ``` + +就這樣 — 不需要額外的 DLL 或 COM interop。 + +## 第一步：初始化新文件與 Builder – *create word document c#* 基礎 + +首先，我們需要一個代表 Word 檔案的 `Document` 物件，以及用來編輯它的 `DocumentBuilder`。 + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **為什麼這一步很重要：** `Document` 類別是所有 Word 部件（頁面、樣式、圖片）的容器。Builder 是高階 API，抽象化低階節點操作，讓你能輕鬆 **create word document c#** 而不必直接處理 XML。 + +## 第二步：插入矩形圖形 – *how to create rectangle* + +現在我們要在頁面上放置一個矩形。尺寸以點 (pt) 為單位（1 pt ≈ 1/72 英吋）。 + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **小技巧：** 若需要其他形狀，只要將 `ShapeType.Rectangle` 換成 `ShapeType.Ellipse`、`ShapeType.Triangle` 等等。相同程式碼同樣適用於任何類型的 **how to add shape**。 + +## 第三步：套用預設陰影並微調 – *apply shadow to shape* + +Aspose.Words 內建多種預設陰影格式。我們將使用 `Preset1`，然後自訂距離、模糊、透明度與顏色。 + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **為什麼要自訂陰影？** `Distance` 屬性控制陰影與矩形之間的距離——可視為 3D 渲染中的「提升」效果。調整 `BlurRadius` 會使邊緣變得柔和，而 `Transparency` 則能營造細緻、專業的外觀。此步驟滿足 **set shadow distance** 的需求，並示範如何以彈性方式 **apply shadow to shape**。 + +## 第四步：儲存文件 – *create word document c#* 完成 + +最後，將文件寫入磁碟。請將路徑調整為你有寫入權限的資料夾。 + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +在 Microsoft Word 中開啟產生的檔案，你會看到一個淡藍色的矩形，帶有向右下偏移 5 pt 的柔和灰色陰影。這就是你成功 **create word document c#** 並加入樣式圖形的視覺證明。 + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# 範例，顯示帶陰影的矩形"} + +## 可選變化與邊緣情況 + +| Scenario | What to Change | Why it Matters | +|----------|----------------|----------------| +| **不同的陰影樣式** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | 提供更具戲劇性的外觀，且不需額外程式碼。 | +| **無預設 – 自訂陰影** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | 完整掌控方向與深度。 | +| **多個圖形** | Call `builder.InsertShape` again before saving. | 適用於包含圖示、標誌等的複雜範本。 | +| **與舊版 Aspose 相容性** | Use `ShadowEffect` class (available in v20.x). | 確保程式碼在舊版專案中仍能執行。 | +| **儲存為 PDF** | `document.Save("ShadowShape.pdf");` | PDF 輸出中會呈現相同的陰影效果。 | + +> **常見問題：** *如果陰影在 Word 中未顯示，該怎麼辦？* +> 請確認你使用的是較新版的 Aspose.Words（≥ 22.9）。舊版對陰影的支援有限。亦請確認文件是在較新版的 Word（2016 以上）開啟。 + +## 完整範例程式 + +以下是完整、可直接複製貼上的程式。它包含所有 `using` 指令、註解與錯誤處理，確保執行順暢。 + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +執行程式後，前往 `C:\Temp\ShadowShape.docx`，即可看到我們設定的矩形與精確陰影。 + +## 重點回顧與後續步驟 + +- 你現在已了解如何 **create word document c#**、插入矩形，並以自訂 **set shadow distance** 方式 **apply shadow to shape**。 +- 此範例使用 Aspose.Words，抽象化 OpenXML 的複雜性，並保證在不同 Word 版本間呈現一致。 +- 想更進一步嗎？試著結合多個圖形、在矩形內加入文字，或將同一文件匯出為 PDF，觀察陰影的轉換效果。 + +### 相關主題你可能會感興趣 + +- **How to add shape** 用於頁首/頁尾的品牌標示。 +- 使用 **Aspose.Words** 程式化插入圖表與表格。 +- 自訂圖片的 **shadow effects**（而非向量圖形）。 +- 自動化大量文件產生，如發票或證書。 + +盡情試驗、破壞程式碼再重新建構——這是內化概念的最快方式。若遇到問題，請在下方留言或查閱官方 Aspose.Words 文件，以獲得更深入的 API 資訊。 + +祝程式開發愉快，讓你的 Word 檔案更顯精緻！ + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hongkong/net/programming-with-txtsaveoptions/_index.md b/words/hongkong/net/programming-with-txtsaveoptions/_index.md index f16a5a9f45..f9eaf45da4 100644 --- a/words/hongkong/net/programming-with-txtsaveoptions/_index.md +++ b/words/hongkong/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Aspose.Words for .NET 教學課程將引導您了解在操作 Word 文件的過 | [在 Word 文件中新增雙向標記](./add-bidi-marks/) |透過本指南了解如何使用 Aspose.Words for .NET 在 Word 文件中新增雙向 (Bidi) 標記。確保多語言內容的文字方向正確。 | | [每級使用製表符進行列表縮排](./use-tab-character-per-level-for-list-indentation/) |了解如何使用 Aspose.Words for .NET 建立帶有製表符縮排的多層清單。請遵循本指南在您的文件中進行精確的清單格式。 | | [每級使用空格字元進行列表縮排](./use-space-character-per-level-for-list-indentation/) |了解如何在 Aspose.Words for .NET 中建立帶有空格字元縮排的多層清單。精確文檔格式的逐步指南。 | - +| [將 docx 另存為 txt – 匯出 Word 方程式至 LaTeX 完整指南](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) |本指南說明如何將 Word 文件（含方程式）另存為 txt，並將方程式匯出為 LaTeX 格式。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hongkong/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/hongkong/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..efe37f6744 --- /dev/null +++ b/words/hongkong/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,244 @@ +--- +category: general +date: 2026-03-27 +description: 使用 Aspose.Words 將 docx 另存為 txt，並將 Word 轉換為 LaTeX。了解如何匯出公式、保留純文字，並在幾分鐘內取得 + LaTeX 標記。 +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: zh-hant +og_description: 使用 Aspose.Words 將 docx 另存為 txt。本指南說明如何將 Word 轉換為 LaTeX、匯出方程式，並保持文件為純文字。 +og_title: 將 docx 另存為 txt – 匯出 Word 方程式至 LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: 將 docx 另存為 txt – 完整指南：將 Word 方程式匯出為 LaTeX +url: /zh-hant/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 將 docx 另存為 txt – 匯出 Word 方程式至 LaTeX + +有沒有曾經需要 **save docx as txt**，但又擔心會失去 Word 檔案中那華麗的數學公式？你並不孤單。在許多科學工作流程中，文件的純文字版本是必須的，但你仍希望方程式能以乾淨的 LaTeX 標記保留下來。 + +在本教學中，我們將逐步說明如何使用 Aspose.Words for .NET **convert Word to LaTeX**，讓你的方程式正確匯出，同時文件的其餘部分變成整潔的純文字。完成後，你將了解如何 **export equations to LaTeX**，將檔案的其餘部分保留為簡單文字，並避免新手常遇到的陷阱。 + +## 你將學到什麼 + +- 如何載入包含 Office Math 的 *.docx* 檔案。 +- 設定正確的 `TxtSaveOptions`，讓 Aspose 為每個方程式輸出 LaTeX。 +- 將結果儲存為 **save word plain text** 檔案，您可以將其投入版本控制、CI 管道或任何下游工具。 +- 常見的邊緣情況——當文件同時包含圖片與方程式，或需要保留 Unicode 字元時該怎麼做。 +- 完整、可直接執行的程式碼範例，您可以直接放入 console 應用程式中。 + +### 前置條件 + +- .NET 6.0 或更新版本（此程式碼亦支援 .NET Framework 4.7 以上）。 +- 取得 **Aspose.Words for .NET** 的授權版（免費試用版可用於測試）。 +- Visual Studio 2022 或任何能編譯 C# 專案的 IDE。 +- 一個已包含 Office Math 物件的 Word 文件（`input.docx`）。 + +> **專業提示：** 如果您尚未取得授權，您可以向 Aspose 官網申請臨時金鑰——只需在執行前將程式碼中的佔位符替換為您的金鑰。 + +## 步驟 1 – 透過 NuGet 安裝 Aspose.Words + +首先，你需要在專案中加入此函式庫。開啟 **Package Manager Console** 並執行以下指令： + +```powershell +Install-Package Aspose.Words +``` + +這一行指令會下載所有必要的套件，包括 `TxtSaveOptions` 所屬的 `Saving` 命名空間。無需額外的 DLL，亦無本機相依性——純粹的受管理程式碼。 + +## 步驟 2 – 載入來源 Word 文件 + +現在我們實際讀取包含方程式的檔案。`Document` 類別抽象化整個 *.docx* 結構，讓您可以將其視為高階物件模型。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**為什麼這很重要：** 先載入文件可讓您檢查其節點樹。如果跳過此檢查且檔案中沒有方程式，您仍會得到一個乾淨的 txt 檔案——但不會知道 LaTeX 輸出為何為空。 + +## 步驟 3 – 為 LaTeX 匯出設定 TxtSaveOptions + +Aspose 為您提供精細的控制，決定 Office Math 的呈現方式。將 `OfficeMathExportMode` 設為 `LaTeX` 後，所有方程式皆會轉換為其 LaTeX 等價形式，而不會被剝除或轉為影像。 + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**為什麼這很重要：** 預設的匯出模式會完全刪除方程式。切換為 `LaTeX` 後，保留了數學意圖，這正是您之後將檔案送入支援 `$…$` 語法的 LaTeX 編譯器或 markdown 處理器時所需要的。 + +## 步驟 4 – 將文件儲存為純文字 + +設定好選項後，保存檔案只需一行程式碼。輸出將是 `.txt` 檔案，所有方程式皆以 `$` 界定符包圍的 LaTeX 代碼呈現（若您偏好 `\[` … `\]` 區塊，可稍後自行調整）。 + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### 預期結果 + +在任意編輯器中開啟 `output.txt`，您會看到類似以下內容： + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +請注意，普通文字保持原樣，而方程式則變成純 LaTeX 字串。您可以直接將它們複製貼上至 LaTeX 文件、Jupyter notebook，或任何能渲染數學的工具中。 + +## 步驟 5 – 處理邊緣情況 + +### 混合內容（圖片 + 方程式） + +如果您的 Word 檔案同時包含圖片，使用 `TxtSaveOptions` 時 Aspose 會忽略它們。對於 **save word plain text** 工作流程而言這通常沒問題，但若您需要將圖片作為佔位符，可採取以下方式： + +1. 先將文件匯出為 HTML（使用 `HtmlSaveOptions`），以捕捉圖片為 `` 標籤。 +2. 再以 `TxtSaveOptions` 進行第二次處理，取得 LaTeX 方程式。 +3. 手動或使用小腳本合併兩個結果。 + +### Unicode 符號 + +某些方程式使用特殊的 Unicode 字元（例如希臘字母）。在 `TxtSaveOptions` 中設定 `Encoding = Encoding.UTF8`（如步驟 3 所示），即可確保這些符號在轉換過程中得以保留。 + +### 大型文件 + +對於超大型檔案（> 100 MB），建議使用串流方式儲存： + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +串流可避免將整個輸出載入記憶體，對於記憶體有限的建置代理而言是救命稻草。 + +## 完整範例 + +以下是完整、可直接複製貼上的程式，將所有步驟串接起來。只需替換檔案路徑，若有授權也請替換授權行。 + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +執行程式（若使用 console 專案則執行 `dotnet run`），並檢查 `output.txt`。您已成功 **save docx as txt**，同時將每個方程式保留為 LaTeX——無需手動複製貼上。 + +## 常見問題 + +**Q: 我可以將分隔符從 `$…$` 改成 `\(...\)` 嗎？** +A: 可以。儲存後，對檔案執行簡單的取代：`output = output.Replace("$", @"\(").Replace("$", @"\)");`——但請注意不要取代原始文字中本身的 `$` 符號。 + +**Q: 這能適用於 Word 2007‑2019 檔案嗎？** +A: 完全可以。Aspose.Words 支援 `.doc`, `.docx`, `.docm`，甚至較新的 `.dotx` 系列。相同程式碼在所有版本皆可運作。 + +**Q: 如果我需要保留原始段落格式（製表符、連續空格）該怎麼辦？** +A: 設定 `txtSaveOptions.PreserveTableLayout = true;` 以及 `txtSaveOptions.PreserveSpace = true;` 即可保留空白字元。 + +## 結論 + +我們已說明如何使用 Aspose.Words **save docx as txt** 同時 **export equations to LaTeX**。關鍵步驟包括載入文件、以 `OfficeMathExportMode.LaTeX` 設定 `TxtSaveOptions`，以及儲存結果。只要這三行程式碼，即可可靠地 **convert word to latex**，將文件保留為 **save word plain text**，並避免數學符號遺失的困擾。 + +準備好接受下一個挑戰了嗎？試著將此工作流程與 markdown 產生器串接，產生包含文字與 LaTeX 的完整 `.md` 檔案——非常適合以 Git 為後端的文件或靜態網站產生器。或是探索 Aspose 的 `PdfSaveOptions`，同時取得 PDF 版本與純文字檔案。 + +如果遇到任何問題，請在下方留言。祝開發愉快，盡情體驗將 Word 方程式轉換為乾淨 LaTeX 的簡便！ + +![示意圖：將 DOCX 儲存為 TXT 並包含 LaTeX 方程式](placeholder-image.png "save docx as txt 範例") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hongkong/net/working-with-fonts/_index.md b/words/hongkong/net/working-with-fonts/_index.md index 8984baa9aa..88bdc8d6ce 100644 --- a/words/hongkong/net/working-with-fonts/_index.md +++ b/words/hongkong/net/working-with-fonts/_index.md @@ -48,6 +48,7 @@ | [接收警告通知](./receive-warning-notification/) |了解如何在使用 Aspose.Words for .NET 時接收警告通知並管理文件中的任何問題或警告。 | | [資源 Steam 字體來源範例](./resource-steam-font-source-example/) |了解如何使用資源流字體來源將自訂字體載入到 Aspose.Words for .NET 中。 | | [取得不含後綴的替換](./get-substitution-without-suffixes/) |在本教學中，學習如何使用 Aspose.Words for .NET 在 Word 文件中取得無後綴覆蓋。 | +| [Aspose 字體替換 – 如何在 C# 中配置字體設定](./aspose-font-substitution-how-to-configure-font-settings-in-c/) |了解如何在 C# 中使用 Aspose.Words for .NET 配置字體替換設定，確保文件正確呈現。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hongkong/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/hongkong/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..5d24af6529 --- /dev/null +++ b/words/hongkong/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Aspose 字體替換變得簡單：學習如何設定字體、捕捉警告，以及在 .NET 應用程式中處理缺失的字體。 +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: zh-hant +og_description: 透過配置字型設定與使用警告回呼處理缺失字型，精通 Aspose 字型取代。完整 C# 指南。 +og_title: Aspose 字體置換 – 在 C# 中配置字體設定 +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose 字型取代 – 如何在 C# 中設定字型 +url: /zh-hant/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – 完整指南：設定字體設定 + +有沒有遇過文件突然把自訂字體換成通用字體？那就是 **aspose font substitution** 在發揮作用——將缺少的字體替換為最接近的匹配字體。這很方便，但如果你需要*精確*知道被換掉的是哪一個字體，就必須使用函式庫的警告機制，並自行設定字體設定。 + +在本教學中，我們將示範一個真實情境：載入一個引用了你未安裝字體的 DOCX，捕捉字體替換事件，並在主控台印出友善訊息。完成後，你將能熟練 **configure font settings**、設定 **Aspose.Words warning callback**，以及將範例延伸至任何工作流程。 + +> **你需要的環境** +> • .NET 6+（或 .NET Framework 4.7.2+） +> • Aspose.Words for .NET（最新 NuGet） +> • 一個引用了缺少字體的 DOCX（此處稱為 `MissingFont.docx`） + +讓我們開始吧。 + +--- + +## Step 1: 安裝 Aspose.Words 並準備專案 + +在撰寫任何程式碼之前，先確定已參考 Aspose.Words 套件： + +```bash +dotnet add package Aspose.Words +``` + +> **專業提示**：使用最新的穩定版；截至 2026 年 3 月，版本為 23.11.0。較新版本會改進字體匹配演算法，並加入更多警告類型。 + +建立一個新的 Console 應用程式（或將程式碼放入現有專案），並加入一般的 `using` 指示詞： + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +這些命名空間讓我們可以存取 `Document`、`LoadOptions` 以及相關的字體類別。 + +--- + +## Step 2: 使用 LoadOptions 設定 Font Settings + +**aspose font substitution** 控制的核心在 `LoadOptions.FontSettings`。只要提供一個空的 `FontSettings` 物件，即可讓 Aspose 使用預設搜尋路徑，並透過警告回呼報告任何替換。 + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +為什麼不直接使用預設？因為只有在 `FontSettings` 屬性非 null 時，才能掛接警告回呼（下一步）。這一行程式碼為我們提供了介入替換流程的切入點，同時不會改變實際的字體搜尋行為。 + +--- + +## Step 3: 附加 Warning Callback 以捕捉替換 + +Aspose.Words 實作了 `IWarningCallback` 介面。每當發生值得注意的事件（例如缺少字體）時，系統會呼叫我們的 `Warning` 方法。我們將實作一個簡易處理器，過濾 `WarningType.FontSubstitution`，並將說明印出。 + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +以下是處理器本身： + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **為什麼這很重要** – 若未設定回呼，Aspose 會悄悄替換字體，你永遠不會知道實際使用了哪一個。回呼讓整個過程透明化，對於合規報告或除錯排版問題都相當關鍵。 + +--- + +## Step 4: 使用已設定的 Options 載入文件 + +現在終於可以載入文件，並傳入先前準備好的 `loadOptions`。如果來源檔案引用了未安裝的字體，我們的處理器就會被觸發。 + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +將 `YOUR_DIRECTORY` 替換為 `MissingFont.docx` 所在的實際路徑。執行程式後，你應該會看到類似以下的輸出： + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +這行訊息會精確告訴你缺少哪個字體，以及 Aspose 選擇的備用字體。 + +--- + +## Step 5: （可選）微調字體搜尋路徑 + +如果公司有私有字體資料夾，可以在回退至系統字體之前，先告訴 Aspose 去哪裡找。這是 **configure font settings** 的進階用法： + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +將 `recursive: true` 設為 true，表示 Aspose 也會掃描子資料夾。如此一來，程式會優先使用你的私有字體，降低不必要的替換機會。 + +--- + +## Full Working Example + +把所有步驟整合起來，以下是一個完整、可直接執行的範例程式： + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**預期輸出**（當遇到缺少字體時）： + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +若所有字體皆已安裝，程式將靜默執行（不會有警告），仍會產生 PDF。 + +--- + +## Common Questions & Edge Cases + +### 如果我要徹底*阻止*字體替換，該怎麼做？ + +將 `FontSettings.SubstitutionSettings` 設為 `null`，或使用 `FontSettings.FontSubstitutionSettings` 來控制行為。例如： + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +如此一來，Aspose 會拋出例外而非悄悄替換，你可以自行捕捉並處理。 + +### 這個機制能用在其他檔案格式嗎（例如 .doc、.rtf）？ + +當然可以。相同的 `LoadOptions` 物件可傳給任何接受檔案路徑的 `Document` 建構子。警告回呼會對所有依賴字體的格式觸發。 + +### 我能取得*精確*的備用字體名稱嗎？ + +可以。`info.Description` 文字同時包含缺少的字體與替代字體。若需要程式化取得名稱，可自行解析字串，或在較新版本中直接使用 `FontInfo` 物件。 + +### 在多執行緒環境下會怎樣？ + +`FontSettings` **不是**執行緒安全的。每個執行緒應建立自己的 `LoadOptions`（以及各自的 `FontSettings`），或以 lock 保護存取。 + +--- + +## Conclusion + +我們已完整說明如何在 C# 應用程式中掌握 **aspose font substitution** 與 **configure font settings**： + +1. 安裝 Aspose.Words 並加入必要的 `using` 陳述式。 +2. 建立帶有全新 `FontSettings` 的 `LoadOptions`。 +3. 附加自訂的 `IWarningCallback` 以顯示替換事件。 +4. 載入文件，讓回呼報告任何缺少的字體。 +5. （可選）擴充搜尋路徑或完全停用替換。 + +有了這套模式，你可以為合規需求記錄缺字體、在 UI 中提醒使用者，或在發佈前自動嵌入備用字體。接下來，你或許想探索 **Aspose.Words font substitution policies**，或將此工作流程整合至更大的文件處理管線。 + +祝程式開發順利，願你的文件永遠以正確的字體呈現！ + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hungarian/net/basic-conversions/_index.md b/words/hungarian/net/basic-conversions/_index.md index e6951319a2..ba7ed69e7b 100644 --- a/words/hungarian/net/basic-conversions/_index.md +++ b/words/hungarian/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ Az Alapvető konverziók című útmutató végigvezeti Önt az Aspose.Words for | [LaTeX exportálása Wordből – Lépésről‑lépésre útmutató](./how-to-export-latex-from-word-step-by-step-guide/) | Tanulja meg, hogyan exportálhat LaTeX-et Word dokumentumokból az Aspose.Words for .NET segítségével, részletes lépésekkel. | | [Word konvertálása PDF-be C#-ban az Aspose.Words – Útmutató](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Tanulja meg, hogyan konvertálhat Word dokumentumokat PDF-be C#-ban az Aspose.Words használatával. | | [Word mentése PDF-be az Aspose.Words segítségével – Teljes C# útmutató](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Tanulja meg, hogyan menthet Word dokumentumokat PDF-be C#-ban az Aspose.Words használatával, részletes lépésekkel. | +| [Word konvertálása PDF-be az Aspose.Words – Teljes útmutató](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Tanulja meg, hogyan konvertálhat Word dokumentumokat PDF-be az Aspose.Words használatával, részletes lépésekkel. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hungarian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/hungarian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..b014dcbc2b --- /dev/null +++ b/words/hungarian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Konvertálja a Word dokumentumot PDF-re gyorsan az Aspose.Words használatával. + Tanulja meg, hogyan menthet Word-et PDF-ként, exportálhatja a docx-et PDF-be, és + hozhat létre hozzáférhető PDF-et C#-ban. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: hu +og_description: Konvertálja a Word dokumentumot PDF-re C#-ban az Aspose.Words segítségével. + Ez az útmutató bemutatja, hogyan menthet Word-et PDF-ként, hogyan exportálhat docx-et + PDF-be, és hogyan generálhat hozzáférhető PDF-et. +og_title: Word konvertálása PDF-re az Aspose.Words segítségével – Lépésről lépésre +tags: +- Aspose.Words +- C# +- PDF conversion +title: Word konvertálása PDF‑be az Aspose.Words segítségével – Teljes útmutató +url: /hu/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word PDF-re konvertálása Aspose.Words segítségével – Teljes útmutató + +Gondolkodtál már azon, hogyan **konvertálhatod a Word dokumentumot PDF‑re** anélkül, hogy harmadik fél webes eszközeivel kellene bajlódni? Lehet, hogy egy automatizált jelentéskészítő motoron dolgozol, és megbízható módra van szükséged a *save word as pdf* feladatra menet közben. A jó hír, hogy az Aspose.Words a teljes folyamatot gyerekjátékká teszi, s még **PDF/UA‑2** kompatibilis fájlt is előállíthatsz – tökéletes a hozzáférhetőségi követelményekhez. + +Ebben az útmutatóban végigvezetünk minden szükséges lépésen: egy `.docx` betöltése, a PDF beállítások konfigurálása, hogy *export docx to pdf* PDF/UA kompatibilitással, és végül az eredmény mentése hozzáférhető PDF‑ként. A végére egy önálló, éles környezetben is használható kódrészletet kapsz, amelyet bármely .NET projektbe beilleszthetsz. + +![Convert Word to PDF using Aspose.Words](convert-word-to-pdf.png) + +## Amit megtanulsz + +- **Why Aspose.Words** egy stabil választás a *generate accessible pdf* szcenáriókhoz. +- A pontos lépések a *save document as pdf* PDF/UA‑2 kompatibilitással. +- Hogyan kezeljük a gyakori edge case‑eket, mint a hiányzó betűtípusok vagy a jelszóval védett forrásfájlok. +- Gyors tippek a kimenet hibakereséséhez és a hozzáférhetőségi megfelelőség ellenőrzéséhez. + +### Előfeltételek + +- .NET 6 vagy újabb (az API .NET Framework 4.6+‑on is működik). +- Érvényes Aspose.Words for .NET licenc (az ingyenes próba verzió értékelésre használható). +- Alap C# ismeretek – nincs szükség bonyolult mintákra. + +Ha ezek a feltételek teljesülnek, merüljünk el a részletekben. + +--- + +## Word PDF-re konvertálása – Lépésről‑lépésre megvalósítás + +A megoldást öt egyértelmű lépésre bontjuk. Minden lépésnek van egy címe, egy rövid kódrészlete, és egy magyarázat arra, hogy *miért* fontos a kód. + +### 1. lépés: A konvertálni kívánt Word dokumentum betöltése + +Az első dolog, amire szükséged van, egy `Document` objektum, amely a forrásfájlt képviseli. Az Aspose.Words képes olvasni **.docx**, **.doc**, **.rtf** és számos más formátumot, így *save word as pdf* bármilyen eredeti formátumból. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Miért fontos ez:** +- A fájl korai betöltése lehetővé teszi, hogy a hiányzó fájl hibákat már a CPU‑ciklusok elpazarolása előtt elkapd. +- `Document` osztály elrejti a Word fájl belső struktúráját, tiszta objektummodellt biztosítva a munkához. + +### 2. lépés: PDF mentési beállítások konfigurálása a hozzáférhetőséghez + +Ha *generate accessible pdf* fájlokra van szükséged, meg kell mondanod az Aspose.Words‑nek, hogy PDF/UA‑2 kompatibilis dokumentumot állítson elő. A `PdfSaveOptions` osztály finomhangolt vezérlést biztosít a kimenet felett. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Miért fontos ez:** +- `PdfCompliance.PdfUa2` megmondja a könyvtárnak, hogy adja hozzá a szükséges címkéket, struktúrainformációkat és metaadatokat, amelyekre a képernyőolvasók támaszkodnak. +- A betűtípusok beágyazása (`EmbedFullFonts = true`) megakadályozza a rettegett „font not found” figyelmeztetéseket, amikor a PDF-et más operációs rendszeren nyitják meg. +- `Title` beállítása segíti a segítő technológiákat, hogy helyesen bejelentsék a dokumentumot. + +### 3. lépés: Dokumentum mentése PDF‑ként + +Miután a forrás betöltődött és a beállítások megvannak, a tényleges konvertálás egyetlen soros hívás. Itt történik a *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Miért fontos ez:** +- A `Save` metódus figyelembe veszi a konfigurált `PdfSaveOptions`‑t, biztosítva, hogy a hozzáférhetőségi funkciók be legyenek építve. +- A hívás `try/catch` blokkba helyezése lehetőséget ad a licencelési vagy jogosultsági hibák naplózására vagy megjelenítésére, amelyek gyakran akadályozzák az újoncokat. + +### 4. lépés: PDF/UA kompatibilitás ellenőrzése (opcionális, de ajánlott) + +Bár az Aspose.Words elvégzi a nehéz munkát, jó gyakorlat a kimenet kétszer ellenőrizni, különösen, ha kormányzati szerveknek vagy más szabályozott szervezeteknek szállítod a dokumentumokat. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Miért fontos ez:** +- `IsTagged` egy gyors ellenőrzés; a teljes PDF/UA validáláshoz dedikált validátorra van szükség, de a legtöbb megfelelőségi probléma hiányzó címkék formájában jelentkezik. +- Ha a jelző `false` értéket ad vissza, érdemes újra átnézni a `PdfSaveOptions`‑t – lehet, hogy elfelejtetted beállítani a `Compliance`‑t, vagy a forrásdokumentumban hiányoztak a megfelelő címsor stílusok. + +### 5. lépés: Gyakori buktatók és profi tippek + +| Pitfall | What Happens | How to Fix | +|---------|--------------|------------| +| **Hiányzó betűtípusok** | A szöveg dobozokként jelenik meg a PDF-ben. | `EmbedFullFonts = true` beállítása **vagy** a hiányzó betűtípusok telepítése a szerveren. | +| **Licenc nélküli könyvtár** | Az Aspose minden oldalra vízjelet helyez. | Add hozzá a licencfájlt (`Aspose.Words.lic`) a program elején (pl. `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Jelszóval védett forrás** | `InvalidOperationException` a `new Document(path)` hívásnál. | Használd a `new Document(path, new LoadOptions { Password = "secret" })` túlterhelést. | +| **Nagy dokumentumok OOM‑ot okoznak** | Memóriahiány (Out‑of‑memory) kivétel hatalmas fájlok esetén. | `MemoryOptimization` engedélyezése a `PdfSaveOptions`‑ban (`saveOptions.MemoryOptimization = true`). | +| **Hiányzó hozzáférhetőségi címkék** | A PDF/UA validálás sikertelen. | Győződj meg arról, hogy a forrás Word fájl megfelelő címsor stílusokat használ (`Heading 1`, `Heading 2`, stb.) – az Aspose ezeket automatikusan PDF címkékké alakítja. | + +**Pro tip:** Ha sok dokumentumot konvertálsz kötegben, használd újra ugyanazt a `PdfSaveOptions` példányt. Egyszeri létrehozása csökkenti az allokációs terhet és alacsonyan tartja a memóriahasználatot. + +## Teljes működő példa (másolás‑beillesztés kész) + +Az alábbiakban a teljes program látható, amely mindent összevon. Mentsd `Program.cs`‑ként, add hozzá az Aspose.Words és Aspose.PDF NuGet csomagokat, majd futtasd. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Várható eredmény:** +A `output.pdf` nevű fájl megjelenik a `C:\MyFiles` könyvtárban. Adobe Acrobat‑ban megnyitva a megfelelőségi panelen a „PDF/A‑2b, PDF/UA‑1” feliratot láthatod, ami megerősíti, hogy sikeresen *convert word to pdf* + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hungarian/net/programming-with-markdownsaveoptions/_index.md b/words/hungarian/net/programming-with-markdownsaveoptions/_index.md index a6a760349e..2e65553e84 100644 --- a/words/hungarian/net/programming-with-markdownsaveoptions/_index.md +++ b/words/hungarian/net/programming-with-markdownsaveoptions/_index.md @@ -30,6 +30,9 @@ Ismerje meg, hogyan hozhat létre akadálymentes PDF-et, és konvertálhat Word ### [DOCX konvertálása Markdownba – Lépésről‑lépésre C# útmutató](./convert-docx-to-markdown-step-by-step-c-guide/) Ismerje meg, hogyan konvertálhat DOCX fájlokat Markdownba lépésről‑lépésre C#‑ban az Aspose.Words for .NET segítségével. ### [DOCX mentése Markdownba – Teljes C# útmutató LaTeX egyenletekkel](./save-docx-as-markdown-complete-c-guide-with-latex-equations/) +### [Hogyan exportáljunk LaTeX‑et Word‑ből – DOCX konvertálása Markdownba](./how-to-export-latex-from-word-convert-docx-to-markdown/) +### [Hogyan exportáljunk LaTeX‑et DOCX‑ből – Konvertálás Markdownba](./how-to-export-latex-from-docx-convert-to-markdown/) +Ismerje meg, hogyan exportálhat LaTeX‑et DOCX fájlokból és konvertálhatja őket Markdown formátumba az Aspose.Words for .NET segítségével. ### [DOCX mentése Markdownba – Teljes C# útmutató képek kinyerésével](./save-docx-as-markdown-full-c-guide-with-image-extraction/) ### [Hogyan mentse el a Markdown‑t a DOCX‑ből – Lépésről‑lépésre útmutató](./how-to-save-markdown-from-docx-step-by-step-guide/) Ismerje meg, hogyan mentheti el a DOCX fájlokat Markdown formátumba lépésről‑lépésre C#‑ban az Aspose.Words for .NET segítségével. @@ -37,6 +40,8 @@ Ismerje meg, hogyan mentheti el a DOCX fájlokat Markdown formátumba lépésrő Ismerje meg, hogyan exportálhatja a Word dokumentumokat Markdown formátumba egy teljes C# útmutatóval. ### [Hogyan exportáljunk Markdownot DOCX‑ből – Teljes útmutató](./how-to-export-markdown-from-docx-complete-guide/) Ismerje meg, hogyan exportálhatja a DOCX fájlokat Markdown formátumba egy teljes útmutatóval. +### [Markdown létrehozása Word‑ből – Teljes C# útmutató](./create-markdown-from-word-full-c-guide/) +Lépésről‑lépésre bemutatjuk, hogyan hozhat létre Markdown fájlokat Word dokumentumokból C#‑ban. {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hungarian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/hungarian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..74074268cf --- /dev/null +++ b/words/hungarian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Készítsen markdownot Wordből az Aspose.Words C#-vel. Tanulja meg, hogyan + konvertáljon docx-et markdownra, hogyan extraháljon képeket a Wordből, és hogyan + használjon visszahívást egyetlen oktatóanyagban. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: hu +og_description: Készítsen markdown fájlt Word-ből az Aspose.Words segítségével. Ez + az útmutató bemutatja, hogyan konvertáljon docx-et markdownra, hogyan extraháljon + képeket a Wordből, és hogyan használjon visszahívást az erőforrások kezeléséhez. +og_title: Markdown készítése Wordből – Teljes C# oktató +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Markdown létrehozása Wordből – Teljes C# útmutató +url: /hu/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Markdown létrehozása Wordből – Teljes C# útmutató + +Valaha is szükséged volt **markdown létrehozására Wordből**, de nem tudtad, hol kezdjed? Nem vagy egyedül; sok fejlesztő ütközik ebbe a falba, amikor egy .docx fájlt szeretne áthelyezni egy statikus‑oldal generátorba vagy egy dokumentációs repóba. A jó hír? Az Aspose.Words segítségével **docx‑t markdown‑dá konvertálhatsz**, kinyerheted az összes képet az eredeti fájlból, és pontosan meghatározhatod, hova kerülnek azok – mindezt egy egyszerű callback‑kel. + +Ebben az útmutatóban egy valós példán keresztül mutatjuk be, hogyan lehet képeket kinyerni a Wordből, hogyan használjuk a callback‑et a tárolásukhoz, és miért ez a legmegbízhatóbb megközelítés az automatizálási csővezetékekben. A végére egy futtatható C# programmal leszel felvértezve, amely tiszta `.md` fájlt és egy kinyert képekből álló mappát hoz létre. + +> **Pro tipp:** Ha már van egy Word sablonod, amely képernyőképeket, diagramokat vagy logókat tartalmaz, ez a módszer megőrzi minden vizuális elemet anélkül, hogy kézzel kellene másolnod‑beillesztened. + +--- + +## Amire szükséged lesz + +- **.NET 6+** (vagy .NET Framework 4.6+). A kód bármely friss runtime‑on működik. +- **Aspose.Words for .NET** (NuGet csomag `Aspose.Words`). Az ingyenes próba a legtöbb forgatókönyvhöz elegendő. +- Egy **Word dokumentum** (`input.docx`), amely szöveget és legalább egy képet tartalmaz. +- Alapvető C# és Visual Studio (vagy kedvenc IDE) ismeretek. + +Külön könyvtárak nem szükségesek – minden mást az Aspose.Words maga kezel. + +--- + +## 1. lépés: Projekt létrehozása és az Aspose.Words telepítése + +A rendezettség kedvéért indíts egy új konzolos projektet: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Miért fontos ez a lépés:** A NuGet csomag telepítése biztosítja, hogy a legújabb API‑t használod, amely tartalmazza a `MarkdownSaveOptions` osztályt a 22.9‑es verzióban bevezetve. Enélkül saját konvertert kellene írnod. + +--- + +## 2. lépés: A forrás Word dokumentum betöltése + +Az első sor kinyitja a konvertálni kívánt `.docx`‑et. Cseréld le a `YOUR_DIRECTORY`‑t a géped tényleges útvonalára. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Mi történik?** A `Document` beolvassa a fájlt, belső DOM‑ot épít, és minden bekezdést, táblázatot és képet elérhetővé tesz. Ha a fájl hiányzik, az Aspose egy egyértelmű `FileNotFoundException`‑t dob, amelyet elkapva felhasználóbarátabb UI‑t biztosíthatsz. + +--- + +## 3. lépés: Markdown mentési beállítások konfigurálása erőforrás‑mentő callback‑kel + +Itt jön a **callback használatának** varázsa. A callback segítségével eldöntheted, hova kerül minden kinyert kép. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Miért callback?** Alapértelmezés szerint az Aspose a képeket base‑64 stringként ágyazza be a markdownba – ez rémálom a verziókezelésben. A callback teljes kontrollt ad a fájlnevek és a mappaszerkezet felett. + +--- + +## 4. lépés: Dokumentum mentése markdownként + +Most generáljuk a `.md` fájlt. Minden kép a következő lépésben definiált callback‑nek lesz átadva. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Ha minden rendben megy, a célmappában megtalálod a `Document.md` fájlt, valamint egy `Resources` almappát, amely az eredeti Word fájlból kinyert összes képet tartalmazza. + +--- + +## 5. lépés: A callback megvalósítása, amely minden kinyert képet elment + +Az alábbiakban a `MyResourceSaver` teljes implementációja látható. Létrehozza a `Resources` könyvtárat (ha még nem létezik), egyedi fájlnevet generál minden képhez, és a képadatfolyamot lemezre írja. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Az argumentumok magyarázata:** +> - `args.Index` – nullától induló számláló, amely garantálja az egyediséget. +> - `args.FileName` – az Aspose által javasolt eredeti fájlnév (gyakran valami ilyesmi: `image001.png`). +> - `args.Stream` – a kimeneti adatfolyam, ahová a képbiteket írja. +> - `args.KeepResourceStreamOpen` – `false` értékre állítva, így az Aspose automatikusan lezárja a streamet, elkerülve a fájl‑kezelő szivárgásokat. + +--- + +## Teljes működő példa + +Mindent összevonva, itt egy egyetlen fájl, amelyet beilleszthetsz a `Program.cs`‑be. Ne felejtsd el a `YOUR_DIRECTORY`‑t egy abszolút vagy relatív útvonalra cserélni, amely a környezetedhez illeszkedik. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Várt kimenet + +- `YOUR_DIRECTORY/Document.md` – egy markdown fájl szabványos markdown kép hivatkozásokkal, például: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – tartalmazza az `img_0.png`, `img_1.jpg` stb. fájlokat, a Word dokumentumban megjelenő sorrendnek megfelelően. + +A program futtatása barátságos megerősítést ír ki, jelezve, hogy a folyamat sikeresen befejeződött. + +--- + +## Gyakran Ismételt Kérdések (GYIK) + +### Hogyan nyerhetők ki a képek a Wordből minőségromlás nélkül? + +A callback a nyers bináris adatfolyamot közvetlenül fájlba írja, megőrizve az eredeti felbontást. Semmilyen átalakítás vagy tömörítés nem történik, hacsak saját képfeldolgozó logikát nem adsz hozzá a `ResourceSaving`‑hez. + +### Át tudom-e alakítani a képformátumot (pl. PNG → JPEG) a kinyerés során? + +Természetesen. A `ResourceSaving`‑ben ellenőrizheted a `args.FileName`‑t vagy a `args.Stream`‑t, betöltheted a képet a `System.Drawing` vagy `ImageSharp` segítségével, majd újrakódolhatod, mielőtt leírnád. Ne felejtsd el a markdown hivatkozás kiterjesztését is ennek megfelelően frissíteni. + +### Mit tehetek, ha a markdown fájlok CDN‑re kell, hogy hivatkozzanak a helyi mappa helyett? + +Módosítsd a callback‑et úgy, hogy a markdown hivatkozáshoz egy alap‑URL‑t előtagként adsz. Ezt úgy érheted el, hogy a `args.FileName`‑t egy teljesen kvalifikált URL‑re állítod, miután feltöltötted a képet a CDN‑re. + +### Működik ez táblázatokkal, lábjegyzetekkel vagy más fejlett Word‑funkciókkal? + +Igen. Az Aspose.Words a legtöbb Word‑konstrukciót markdown ekvivalensekre fordítja. A táblázatok markdown táblázatokká, a lábjegyzetek referencia‑linkekké, a beágyazott listák pedig megfelelően kezelődnek. Ha valami furcsán néz ki, nézd meg a legújabb kiadási megjegyzéseket – az Aspose folyamatosan javítja a konverzió pontosságát. + +### Hogyan konvertáljam a docx‑et markdownra CI/CD csővezetékben? + +Csak add hozzá a lefordított `.exe`‑t a build lépéseidhez, irányítsd a generált `.docx` artefaktumokra, majd push-olj a keletkezett `.md` és `Resources/` mappát a statikus webhely repódba. Mivel a folyamat teljesen determinisztikus, jól működik automatizált környezetekben. + +--- + +## Összegzés + +Most bemutattuk, hogyan **hozhatsz létre markdown‑t Wordből** az Aspose.Words segítségével, végigvettük a teljes **docx‑t markdown‑dá konvertálás** munkafolyamatot, és gyakorlati módon megmutattuk, hogyan **nyerhetők ki képek a Wordből** egy egyedi **callback** implementációval. Az eredmény egy tiszta markdown fájl, amelyhez egy eredeti képeket tartalmazó mappa társul – tökéletes dokumentációs oldalakhoz, statikus blogokhoz vagy bármilyen munkafolyamathoz, amely a plain‑text formátumot részesíti előnyben. + +Következő lépések, amelyeket érdemes megfontolni: + +- **Kötegelt feldolgozás** több `.docx` fájlra egy mappában (ciklus a `Directory.GetFiles`‑szal). +- **Egyedi elnevezési sémák** a képekhez (pl. az eredeti felirat szövegének felhasználásával). +- **Utófeldolgozás** a markdownban, hogy a kép hivatkozásokat CDN‑URL‑re cseréld. +- **Egyéb Aspose export formátumok** felfedezése, mint HTML, PDF vagy EPUB, a többcsatornás kiadásért. + +Van még kérdésed, vagy egy makacs Word fájl, amely nem konvertálódik? Írj kommentet alább, és közösen megoldjuk. Boldog kódolást, és élvezd a Word‑ből markdown‑ra való átalakítás egyszerűségét! + +--- + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hungarian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/hungarian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..048ebea1cb --- /dev/null +++ b/words/hungarian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,267 @@ +--- +category: general +date: 2026-03-27 +description: Hogyan exportáljunk LaTeX-et DOCX‑ből az Aspose.Words segítségével. Tanulja + meg, hogyan konvertáljon DOCX‑et Markdownra, állítson be DPI‑t, és engedélyezze + a helyreállítást C#‑ban. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: hu +og_description: Hogyan exportáljunk LaTeX-et DOCX-ből az Aspose.Words használatával. + Ez az útmutató lépésről lépésre bemutatja a Markdown konverziót, a DPI szabályozást + és a helyreállítási módot. +og_title: Hogyan exportáljunk LaTeX-et DOCX-ből – konvertálás Markdownba +tags: +- Aspose.Words +- C# +- Document Conversion +title: Hogyan exportáljunk LaTeX-et DOCX‑ből – konvertálás Markdownra +url: /hu/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hogyan exportáljunk LaTeX-et DOCX‑ből – Konvertálás Markdown‑ba + +Gondolkodtál már azon, **hogyan exportáljunk LaTeX‑et** egy DOCX fájlból anélkül, hogy elveszítenénk egyenletek szépségét? Nem vagy egyedül. Tapasztalatom szerint a legnagyobb nehézség az OfficeMath objektumok tiszta, hordozható formátumba való átalakítása statikus‑weboldal‑generátorok vagy tudományos blogok számára. + +Ebben az útmutatóban végigvezetünk a DOCX‑ről Markdown‑ra történő konvertáláson az Aspose.Words segítségével, miközben bemutatjuk **hogyan állítsuk be a DPI‑t**, **hogyan engedélyezzük a helyreállítást**, és néhány hasznos trükköt egy szilárd pipeline‑hoz. A végére egyetlen C# programod lesz, amely Markdown‑fájlt generál LaTeX‑egyenletekkel, nagy felbontású képekkel és megfelelő hiperhivatkozás‑kezeléssel. + +## Amire szükséged lesz + +- **.NET 6+** (vagy .NET Framework 4.7.2 – az API ugyanúgy működik) +- **Aspose.Words for .NET** (a legújabb stabil verzió 2026‑ márciusától) +- Egy DOCX fájl, amely egyenleteket, képeket és hivatkozásokat tartalmaz +- Visual Studio, VS Code vagy bármely kedvenc szerkesztőd + +Nem szükséges további NuGet csomag az Aspose.Words‑en kívül, de győződj meg róla, hogy érvényes licencet használsz, ha nem a próbaverziót. + +## 1. lépés – A DOCX betöltése szigorú helyreállítási móddal + +Mielőtt még a exportálásra gondolnánk, meg kell győződnünk arról, hogy a forrásdokumentum nem rejt hibákat. Itt jön képbe **hogyan engedélyezzük a helyreállítást**. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Miért szigorú helyreállítás?** +Ha az Aspose csendben javítja a problémákat, hiányzó bekezdésekkel vagy törött képekkel találkozhatsz – ami senki sem akar, amikor LaTeX‑et exportál. A gyors hibajelzés lehetővé teszi, hogy korán észleld a problémát, és eldöntsd, javítod-e a forrás DOCX‑et, vagy később naplózod a hibát. + +### Profi tipp +Tedd a betöltést try/catch‑be, és naplózd a `DocumentLoadingException`‑t. Így a CI pipeline‑od jelzi a problémás fájlokat anélkül, hogy leállítaná az egész buildet. + +## 2. lépés – A Markdown exportálási beállítások előkészítése + +Most, hogy a dokumentum biztonságosan a memóriában van, konfiguráljuk, hogyan legyen mentve. Ez a **hogyan exportáljunk latex‑et** lényege, és tartalmazza a **hogyan állítsuk be a DPI‑t** a beágyazott képekhez. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Az egyes beállítások jelentése** + +| Opció | Indoklás | Kapcsolat a kulcsszavakhoz | +|--------|----------|----------------------------| +| `OfficeMathExportMode = LaTeX` | Közvetlenül válaszol a **hogyan exportáljunk latex‑et** egyenletekből. | Elsődleges kulcsszó | +| `ImageResolution = 300` | Szabályozza a képminőséget – a **hogyan állítsuk be a dpi‑t** válasza. | Másodlagos | +| `ResourceSavingCallback` | Beágyazott fájlok mentése lemezre, gyakori igény a **convert docx to markdown** esetén. | Másodlagos | +| `EmptyParagraphExportMode` | Tiszta Markdown‑kimenetet garantál, elkerülve a felesleges HTML‑címkéket. | Javítja az általános konverzió minőségét | +| `LinkExportMode = AsReference` | A hivatkozásokat könnyen olvashatóvá és szerkeszthetővé teszi, további előny a **convert docx to markdown** számára. | + +## 3. lépés – Egyedi erőforrás‑mentő megvalósítása (opcionális, de hasznos) + +Amikor DOCX‑t konvertálsz Markdown‑ra, a képek és egyéb bináris erőforrásoknak helyre van szükségük a fájlrendszeren. Az Aspose ezt az `IResourceSavingCallback`‑el szabályozza. A fenti kódrészlet már mutat egy minimális implementációt, de bontsuk le: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Miért érdemes?** +Ha kihagyod ezt a lépést, az Aspose a képeket base‑64 stringként ágyazza be, ami felrobbanja a Markdown fájl méretét és nehézzé teszi a verziókezelést. Az erőforrások külön mappába mentésével a Markdown könnyű marad, és barátságos a Hugo vagy Jekyll‑hez hasonló statikus weboldal‑generátorok számára. + +## 4. lépés – A dokumentum mentése Markdown‑ként + +Minden nehéz munka elkészült. Egy sor már kiírja a végleges fájlt. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Nyisd meg a `output.md`‑t, és a következőket fogod látni: + +- Egyenletek `$…$` LaTeX blokkokként renderelve +- Képek `![Alt text](resources/image001.png)` hivatkozással, 300 dpi felbontással +- Hiperhivatkozások referencia‑stílusban: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Ez a teljes **hogyan konvertáljunk docx‑et** folyamat egyetlen átfogó leírása. + +## Gyakori kérdések és speciális esetek + +### 1️⃣ Mi a teendő, ha a DOCX nem támogatott objektumokat tartalmaz? +Az Aspose.Words `FeatureNotSupportedException`‑t dob. Mivel **hogyan engedélyezzük a helyreállítást** szigorú módban használtuk, a kivétel azonnal felszínre kerül. Két lehetőség: + +- Állítsd a `RecoveryMode`‑t `RecoveryMode.Default`‑ra a legjobb erőfeszítéssel történő konverzióhoz, **vagy** +- Előfeldolgozd a DOCX‑et (pl. távolítsd el a nem támogatott SmartArt‑ot) a konverter futtatása előtt. + +### 2️⃣ Módosítható-e a DPI képenként? +Az `ImageResolution` beállítás globális. Képenkénti vezérléshez valósíts meg egy egyedi `ImageSavingCallback`‑et, amely hasonló a `MyResourceSaver`‑hez, és a `args.ImageResolution`‑t a `args.ImageFileName` vagy metaadat alapján állítja be. + +### 3️⃣ Hogyan ágyazzam be a generált LaTeX‑et egy Jekyll oldalba? +A Jekyll beépített MathJax támogatása alapértelmezés szerint működik. Csak győződj meg róla, hogy a layout tartalmazza a MathJax szkriptet, és a LaTeX blokkok `$$`‑ben (display) vagy `$`‑ban (inline) vannak. + +### 4️⃣ Kompatibilis-e .NET Core‑ral Linuxon? +Teljesen. Az Aspose.Words platformfüggetlen. Csak ügyelj arra, hogy a `YOUR_DIRECTORY` útvonal a Linux szabályainak megfelelő legyen (pl. `/home/user/docs`). + +## Teljes működő példa + +Az alábbi program másolás‑beillesztés után azonnal futtatható. Cseréld ki a `YOUR_DIRECTORY`‑t a saját elérési útvonaladra. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Várt kimenet** – nyisd meg a `output.md`‑t, és valami ilyesmit kell látnod: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Ha a fájlt egy MathJax‑ot támogató Markdown‑előnézetben nyitod meg, a integrál megjelenik + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hungarian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/hungarian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..2a57d60c24 --- /dev/null +++ b/words/hungarian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Hogyan exportáljunk LaTeX-et Word dokumentumokból az Aspose.Words segítségével + – DOCX konvertálása Markdownra, a képletek LaTeX formátumban. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: hu +og_description: A LaTeX exportálása Word-dokumentumokból az első mondatban van elmagyarázva, + bemutatva, hogyan konvertálhatod a DOCX-et Markdown formátumba egyenletekkel LaTeX-ként. +og_title: Hogyan exportáljunk LaTeX-et Wordből – Teljes útmutató +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Hogyan exportáljunk LaTeX-et a Wordből – DOCX konvertálása Markdownra +url: /hu/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hogyan exportáljunk LaTeX-et Word-ből – DOCX konvertálása Markdownra + +Gondoltad már **hogyan exportáljunk LaTeX-et** egy Word-fájlból anélkül, hogy egy csomó PNG-vel végződne? Nem vagy egyedül; a fejlesztők gyakran ütköznek ebbe a falba, amikor tiszta, szerkeszthető egyenletekre van szükségük statikus oldalakhoz vagy tudományos blogokhoz. A jó hír? Az Aspose.Words segítségével **Word‑ot konvertálhatunk Markdownra**, és minden OfficeMath objektumot natív LaTeX‑ként megőrizhetünk – utófeldolgozás nélkül. + +Ebben az útmutatóban végigvezetünk a **Word‑dokumentum Markdownként mentésének** teljes folyamatán, miközben **az egyenleteket LaTeX‑ként exportáljuk**. A végére egy futtatható C# kódrészletet, egyértelmű magyarázatot minden opcióra, valamint tippeket kapunk a speciális esetek kezelésére, mint a bonyolult képletek vagy vegyes tartalom. Nincs külső eszköz, csak egy NuGet csomag és néhány kódsor. + +## Amire szükséged lesz + +- .NET 6+ (vagy .NET Framework 4.7.2 és újabb) – a legfrissebb futtatókörnyezet a legjobb. +- Visual Studio 2022 vagy bármely szerkesztő, amely képes C# projektek fordítására. +- Aspose.Words for .NET licenc (az ingyenes próba verzió elegendő a kísérletezéshez). +- Egy DOCX fájl, amely legalább egy egyenletet (OfficeMath) tartalmaz. + +Ha már megvan mindez, nagyszerű – vágjunk bele. + +## Hogyan exportáljunk LaTeX-et Word‑ből – Áttekintés + +Az alábbi magas szintű ábra mutatja a lépéseket: + +1. **Telepítsd** az Aspose.Words NuGet csomagot. +2. **Töltsd be** a forrás `.docx`‑et, amely a képleteket tartalmazza. +3. **Állítsd be** a `MarkdownSaveOptions`‑t úgy, hogy az `OfficeMathExportMode` `LaTeX` legyen. +4. **Mentsd** a dokumentumot `.md` fájlként. +5. **Ellenőrizd**, hogy a generált Markdown tartalmaz‑e LaTeX blokkokat (`$$…$$`). + +Ezeket a lépéseket részletesen kifejtjük az alábbi szakaszokban. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="How to export latex from Word diagram"} + +## 1. lépés – Aspose.Words for .NET telepítése (convert word to markdown) + +Először is szükséged van arra a könyvtárra, amely ténylegesen elvégzi a nehéz munkát. Nyisd meg a terminált (vagy a Package Manager Console‑t), és futtasd: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tipp:** Ha Visual Studio‑t használsz, jobb‑kattints a projektre → *Manage NuGet Packages* → keresd meg a “Aspose.Words”‑et, és telepítsd a legújabb stabil verziót. + +Miért fontos ez: az Aspose.Words absztrahálja az Open XML formátumot, tiszta API‑t biztosítva a Word‑dokumentumok manipulálásához anélkül, hogy alacsony szintű XML‑et kellene kezelned. Emellett beépített támogatást nyújt az OfficeMath LaTeX‑re konvertálásához, ami a **export equations as LaTeX** követelményünk központja. + +## 2. lépés – A DOCX betöltése (how to convert docx) + +Miután a csomag a helyén van, töltsd be a fájlt, amelyet átalakítani szeretnél. Cseréld le a `YOUR_DIRECTORY`‑t arra az útvonalra, ahol a `.docx` található: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Miért így töltsük be?** A `Document` konstruktor az egész fájlt egy objektummodellbe parszi, azonnali hozzáférést biztosítva a bekezdésekhez, táblázatokhoz és – ami a legfontosabb – az OfficeMath objektumokhoz. Ha a fájl hiányzik vagy sérült, az Aspose egy leíró `FileNotFoundException`‑t dob, amelyet elkapva szép hibakezelést valósíthatsz meg. + +## 3. lépés – MarkdownSaveOptions beállítása (export equations as latex) + +A varázslat a `MarkdownSaveOptions` objektumban történik. Alapértelmezés szerint az Aspose a képleteket PNG képekként renderelné, de mi LaTeX‑et akarunk. Állítsd be az `OfficeMathExportMode`‑t `LaTeX`‑re: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Egy gyors megjegyzés a választható flag‑ekről: az `ExportImagesAsBase64` megakadályozza, hogy az Aspose bináris adatot ágyazzon be, így a Markdown tiszta marad. Az `ExportHeadersFooters` biztosítja, hogy ne veszíts el semmilyen kontextust, ami a fejlécben vagy láblécben lehet – például egy cím vagy szerző neve. + +## 4. lépés – Dokumentum mentése (save word as markdown) + +Végül írd a transzformált tartalmat egy `.md` fájlba: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Miután ez a sor lefut, a `output.md` a forrásfájlod mellett fog megjelenni. Nyisd meg bármely szövegszerkesztőben, és látnod kell a LaTeX blokkokat, amelyek így néznek ki: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Ez a **save word as markdown** rész befejeződött – nincs szükség további konverziós lépésekre. + +## 5. lépés – Az eredmény ellenőrzése (export equations as latex) + +Könnyű elhanyagolni az ellenőrzést, de egy gyors sanity check rengeteg időt spórol később. Futtass egy egyszerű szkriptet, amely beolvassa a generált fájlt, és kiírja az első LaTeX blokkot: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Ha a kimenet `First LaTeX block: $$ … $$` formátumban jelenik meg, sikeresen **exportáltad a LaTeX‑et** a Word‑ből. Ha nem, ellenőrizd, hogy a forrásdokumentum valóban tartalmaz‑e OfficeMath objektumokat; a normál szöveges egyenletek nem lesznek konvertálva. + +## Gyakori edge case‑ek kezelése + +| Szenárió | Mire figyelj | Javasolt megoldás | +|----------|--------------|-------------------| +| **Vegyes képek és egyenletek** | Az Aspose még mindig beágyazhat képeket a nem‑OfficeMath grafikákhoz. | Állítsd `ExportImagesAsBase64 = false`‑ra, és tartsd a képeket külső fájlokként, majd hivatkozz rájuk manuálisan a Markdownban. | +| **Bonyolult, egymásba ágyazott egyenletek** | Nagyon mély ágyazás LaTeX‑et eredményezhet, amelyet manuálisan kell finomítani. | Utófeldolgozás egy LaTeX formázóval (pl. `latexindent`) vagy állítsd be a `mdOptions`‑t → `ExportMathAsDisplay = true`. | +| **Nagy dokumentumok** | Memóriahasználat ugrik, ha hatalmas `.docx` fájlokat töltesz be. | Használd a `LoadOptions`‑t `LoadFormat.Docx`‑szel, és engedélyezd a streaminget, ha elérhető. | +| **Hiányzó licenc** | Az ingyenes próba vízjelet (kommentet) ad a kimenethez. | Érvényes licenc alkalmazása: `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Ezek a tippek segítenek a munkafolyamatod stabilan tartásában, különösen, ha **convert word to markdown**-t használsz termelési környezetben. + +## Teljes működő példa (Minden lépés egy fájlban) + +Az alábbi önálló konzolalkalmazás másolható egy új .NET projektbe, és azonnal futtatható. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Futtasd a programot, nyisd meg a `output.md`‑t, és láthatod, hogy az egyenletek tiszta LaTeX‑ként jelennek meg. Ez a teljes válasz a **how to export latex** kérdésre egy Word‑dokumentumból. + +## Összegzés + +Lépésről‑lépésre bemutattuk, **hogyan exportáljunk LaTeX-et** Word‑ből, megmutatva, hogyan **konvertáljunk Word‑ot markdownra**, hogyan **save word as markdown**, és hogyan **export equations as LaTeX** az Aspose.Words segítségével. A lényeg egyszerű: töltsd be a DOCX‑et, állítsd be a `MarkdownSaveOptions`‑t, és hagyd, hogy a könyvtár végezze a nehéz munkát. + +Ha automatizálni szeretnéd a dokumentációs pipeline‑jaidat, próbáld meg összekapcsolni ezt a kódot egy statikus weboldalkészítővel, mint a Hugo vagy a Jekyll – egyszerűen push-olj a repóba a generált `.md` fájlokat, és hagyd, hogy az oldal újraépüljön. További olvasnivalóként nézd meg az Aspose “Export to LaTeX” útmutatóját, kísérletezz a `HtmlSaveOptions`‑szal webes előnézetekhez, vagy merülj el a `DocumentVisitor` API‑ban egyedi transzformációkhoz. + +Van kérdésed edge case‑ekkel, licenceléssel vagy CI/CD integrációval kapcsolatban? Írj kommentet alább, és jó kódolást kívánunk! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hungarian/net/programming-with-pdfsaveoptions/_index.md b/words/hungarian/net/programming-with-pdfsaveoptions/_index.md index 887a593657..a0eb979c99 100644 --- a/words/hungarian/net/programming-with-pdfsaveoptions/_index.md +++ b/words/hungarian/net/programming-with-pdfsaveoptions/_index.md @@ -34,18 +34,18 @@ Akár Word dokumentumokat szeretne PDF formátumba konvertálni online terjeszt | [Csökkentse a PDF fájl méretét az alapvető betűtípusok beágyazásának elhagyásával](./avoid-embedding-core-fonts/) | Ismerje meg, hogyan csökkentheti a PDF-fájlok méretét az alapvető betűtípusok beágyazásának elhagyásával az Aspose.Words for .NET használatával. Kövesse lépésről lépésre szóló útmutatónkat PDF-fájljai optimalizálásához. | | [Escape URI PDF dokumentumban](./escape-uri/) Ismerje meg, hogyan lehet URI-kat elfedni a PDF-ekben az Aspose.Words for .NET használatával. Ez a részletes útmutató lépésről lépésre végigvezeti a folyamaton. | | [Word dokumentum fejlécének, láblécének könyvjelzőinek exportálása PDF dokumentumba](./export-header-footer-bookmarks/) | Tanulja meg, hogyan exportálhat fejléc- és lábléckönyvjelzőket Word-dokumentumból PDF-be az Aspose.Words for .NET használatával lépésről lépésre bemutató útmutatónkkal. | -| [PDF méretének csökkentése a WMF betűtípusok metafájl méretre skálázásával](./scale-wmf-fonts-to-metafile-size/) | Lépésről lépésre útmutató a PDF méretének csökkentéséhez a wmf betűtípusok metafájl méretre skálázásával, amikor az Aspose.Words for .NET segítségével PDF-be konvertál. +| [PDF méretének csökkentése a WMF betűtípusok metafájl méretre skálázásával](./scale-wmf-fonts-to-metafile-size/) | Lépésről lépésre útmutató a PDF méretének csökkentéséhez a wmf betűtípusok metafájl méretre skálázásával, amikor az Aspose.Words for .NET segítségével PDF-be konvertál. | | [PDF szövegpozicionálás javítása kiegészítő szövegpozicionálással](./additional-text-positioning/) | Tanulja meg, hogyan javíthatja a PDF szövegének elhelyezését az Aspose.Words for .NET segítségével néhány egyszerű lépésben. Javítsa dokumentuma megjelenését. | | [Word dokumentum konvertálása PDF-be 1.7](./conversion-to-pdf-17/) | Könnyedén konvertálhat Word dokumentumokat PDF 1.7 formátumba az Aspose.Words for .NET segítségével. Kövesse ezt az útmutatót, hogy dokumentumai univerzálisan hozzáférhetőek és professzionálisan formázottak legyenek. | | [PDF dokumentum méretének csökkentése képek kicsinyítésével](./downsampling-images/) | Csökkentse a PDF dokumentum méretét képek felbontásának csökkentésével az Aspose.Words for .NET segítségével. Optimalizálja PDF-jeit a gyorsabb feltöltési és letöltési idő érdekében. | -| [Vázlatbeállítások megadása PDF dokumentumban](./set-outline-options/) | Ismerje meg, hogyan adhat meg vázlatbeállításokat egy PDF dokumentumban az Aspose.Words for .NET használatával. Javítsa a PDF navigációt a címsorszintek és a kibővített vázlatok konfigurálásával. +| [Vázlatbeállítások megadása PDF dokumentumban](./set-outline-options/) | Ismerje meg, hogyan adhat meg vázlatbeállításokat egy PDF dokumentumban az Aspose.Words for .NET használatával. Javítsa a PDF navigációt a címsorszintek és a kibővített vázlatok konfigurálásával. | | [Egyéni tulajdonságok exportálása PDF dokumentumban](./custom-properties-export/) | Tanulja meg, hogyan exportálhat egyéni tulajdonságokat PDF dokumentumban az Aspose.Words for .NET használatával részletes, lépésről lépésre szóló útmutatónkkal. | | [Word dokumentum szerkezetének exportálása PDF dokumentumba](./export-document-structure/) | Exportáljon egy Word-dokumentum szerkezetét PDF-be az Aspose.Words for .NET segítségével. Kövesse lépésről lépésre szóló útmutatónkat a dokumentum elrendezésének megőrzéséhez és a PDF-navigáció javításához. | | [Képtömörítés PDF dokumentumban](./image-compression/) Ismerje meg, hogyan tömörítheti a képeket PDF dokumentumokban az Aspose.Words for .NET segítségével. Kövesse ezt az útmutatót az optimalizált fájlméret és minőség érdekében. | | [PDF dokumentum utolsó nyomtatott tulajdonságának frissítése](./update-last-printed-property/) | Tanulja meg, hogyan frissítheti a PDF dokumentum utolsó nyomtatott tulajdonságát az Aspose.Words for .NET használatával lépésről lépésre bemutató útmutatónkkal. | | [3D DML 3DEffektusok renderelése PDF dokumentumban](./dml-3deffects-rendering/) | Tanulja meg, hogyan jeleníthet meg lenyűgöző 3D DML-effektusokat PDF dokumentumokban az Aspose.Words for .NET használatával ezzel az átfogó, lépésről lépésre szóló útmutatóval. | | [Képek interpolálása egy PDF dokumentumban](./interpolate-images/) | Tanulja meg, hogyan interpolálhat képeket egy PDF dokumentumban az Aspose.Words for .NET használatával lépésről lépésre bemutató útmutatónkkal. Javítsa PDF-je képminőségét könnyedén. | - +| [Hogyan mentse el a PDF-et DOCX-ből az Aspose.Words segítségével – Lépésről lépésre útmutató](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Ismerje meg, hogyan konvertálhat DOCX dokumentumot PDF-be az Aspose.Words használatával ebben a részletes lépésről lépésre útmutatóban. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hungarian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/hungarian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..c18a8715bc --- /dev/null +++ b/words/hungarian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-03-27 +description: Tanulja meg, hogyan menthet PDF-et egy DOCX fájlból az Aspose.Words használatával. + Tartalmazza a DOCX PDF-re konvertálását, a PDF mentését beállításokkal, valamint + a lebegő alakzatok kezelését. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: hu +og_description: Hogyan menthetünk PDF-et egy DOCX fájlból az Aspose.Words segítségével. + Ez az útmutató bemutatja a docx PDF-re konvertálását, a PDF mentését beállításokkal, + valamint a lebegő alakzatok kezelését. +og_title: Hogyan menthet PDF-et DOCX-ből – Teljes Aspose.Words útmutató +tags: +- Aspose.Words +- C# +- PDF conversion +title: PDF mentése DOCX-ből az Aspose.Words segítségével – Lépésről lépésre útmutató +url: /hu/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hogyan mentse a PDF-et DOCX-ből az Aspose.Words használatával – Teljes útmutató + +Gondolkodott már azon, **hogyan mentse a PDF-et** egy Word dokumentumból anélkül, hogy elveszítené a lebegő alakzatok elrendezését? Ön sem egyedül van. Sok projektben—számlagenerátorokban, jelentésexportálókban vagy egyszerű dokumentumarchiválókban—a fejlesztőknek megbízható módra van szükségük a DOCX PDF‑re konvertálásához, miközben minden pontosan úgy néz ki, ahogy a Word‑ben. + +Ebben az útmutatóban végigvezetjük a DOCX fájl PDF‑re konvertálásának folyamatát **Az Aspose.Words for .NET használatával**, megmutatjuk, **hogyan konvertálja a docx‑t pdf‑re** egyéni mentési beállításokkal, és elmagyarázzuk, miért fontos a `ExportFloatingShapesAsInlineTag` jelző. A végére egy kész‑használatra készen álló kódrészletet kap, amely a kívánt beállításokkal ment PDF‑et. + +## Mit fog megtanulni + +- A pontos lépéseket a **word document pdf konvertálásához** az Aspose.Words segítségével. +- Hogyan konfigurálja a `PdfSaveOptions`‑t, hogy a lebegő alakzatokat inline címkékként kezelje. +- Gyakori buktatók a lebegő objektumok kezelésekor és azok elkerülése. +- Egy teljes, futtatható C# program, amelyet bármely .NET projektbe beilleszthet. + +> **Előfeltétel:** Szüksége van egy Aspose.Words for .NET licencre (vagy egy ingyenes értékelésre) és egy .NET fejlesztői környezetre (Visual Studio, Rider vagy a `dotnet` CLI). + +## 1. lépés: A projekt beállítása és az Aspose.Words hozzáadása + +Először hozzon létre egy új konzolos alkalmazást (vagy adjon hozzá egy meglévőhöz), és hivatkozzon az Aspose.Words NuGet csomagra. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro tipp:** Ha CI szerveren dolgozik, rögzítse a csomag verzióját (`Aspose.Words --version 24.10`), hogy garantálja az újraépíthető buildeket. + +## 2. lépés: A lebegő alakzatokat tartalmazó DOCX betöltése + +A lebegő képek, szövegdobozok vagy SmartArt átalakításkor elrendezési eltolódásokat okozhatnak. A dokumentum betöltése egyszerű, de ellenőrizni fogjuk is, hogy a fájl létezik-e, hogy elkerüljük a futásidejű `FileNotFoundException`‑t. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Figyelje a `Console.WriteLine` utasításokat—gyors visszajelzést adnak, amikor a terminálból futtatja az alkalmazást. + +## 3. lépés: PDF mentési beállítások konfigurálása (PDF mentése beállításokkal) + +Itt történik a varázslat. Alapértelmezés szerint az Aspose.Words megpróbálja megőrizni a lebegő objektumokat úgy, ahogy megjelennek, ami a létrejövő PDF elrendezését felboríthatja. Az `ExportFloatingShapesAsInlineTag` `true`‑ra állítása azt mondja a könyvtárnak, hogy ezeket az alakzatokat inline címkékként kezelje, biztosítva, hogy a környező szöveghez rögzítve maradjanak. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Miért fontos ez? Képzeljen el egy szövegdobozt, amely egy bekezdés fölött lebeg. Az inline‑tag konverzió nélkül a PDF le tudja tolni a bekezdést vagy teljesen levághatja a dobozt. A jelző megőrzi a vizuális kapcsolatot—egy finom, de létfontosságú részlet a professzionális jelentésekhez. + +## 4. lépés: Dokumentum mentése PDF‑ként + +Most ténylegesen kiírjuk a PDF fájlt. A `Save` metódus megkapja a kimeneti útvonalat és a most beállított opciókat. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +A program futtatása `output.pdf`‑t hoz létre ugyanabban a mappában, mint a forrás DOCX. Nyissa meg bármely PDF‑nézőben, és látnia kell, hogy minden lebegő alakzat pontosan ott jelenik meg, ahol lennie kell. + +## Teljes működő példa + +Az alábbiakban a teljes program egy blokkban látható. Másolja be a `Program.cs`‑be (vagy bármely C# fájlba), és nyomja meg az **F5**‑öt. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Várható eredmény + +- **Fájl létrehozva:** `output.pdf` a célkönyvtárban. +- **Elrendezés pontossága:** A lebegő alakzatok (képek, szövegdobozok, SmartArt) inline jelennek meg a környező szöveggel. +- **Nincs kivétel:** A program zökkenőmentesen kilép, állapotüzeneteket ír a konzolra. + +## Gyakran Ismételt Kérdések és Szélsőséges Esetek + +| Kérdés | Válasz | +|----------|--------| +| **Mi van, ha magasabb képminőségre van szükségem?** | Set `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Több DOCX fájlt konvertálhatok egyszerre?** | Wrap the loading/saving logic in a `foreach (var file in Directory.GetFiles(..., "*.docx"))` loop. Remember to reuse a single `PdfSaveOptions` instance for performance. | +| **Működik ez .NET Core‑ral?** | Absolutely. Aspose.Words 24.x supports .NET Standard 2.0+, so you can run the same code on Windows, Linux, or macOS. | +| **Mi van a jelszóval védett DOCX fájlokkal?** | Load with `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. The same `PdfSaveOptions` apply when saving. | +| **Biztonságos az inline‑tag konverzió összetett táblázatoknál?** | Generally yes, but very intricate table layouts with overlapping shapes may still need manual tweaking. Test a representative sample before a bulk migration. | + +## Tippek valós projektekhez + +- **Naplózzon, ne csak `Console.WriteLine`‑t** – Éles környezetben cserélje le a konzolkimenetet egy naplózási keretrendszerre (Serilog, NLog), hogy rögzítse a hibákat. +- **Erőforrások felszabadítása** – A `Document` implementálja az `IDisposable`‑t. Tegye `using` blokkba, ha sok fájlt dolgoz fel, hogy gyorsan felszabadítsa a memóriát. +- **PDF ellenőrzése** – Használjon PDF validátort (pl. PDF/A megfelelőség ellenőrző), ha archiválási szintű PDF‑re van szükség. +- **Párhuzamos feldolgozás** – Nagy mennyiségű feladat esetén fontolja meg a `Parallel.ForEach` használatát szálbiztos `PdfSaveOptions`‑szal (klón minden szálnak), hogy felgyorsítsa a konvertálást. + +## Összegzés + +Áttekintettük, **hogyan mentse a PDF-et** egy DOCX fájlból az Aspose.Words használatával, bemutattuk, **hogyan konvertálja a docx‑t pdf‑re** egyéni beállításokkal, és elmagyaráztuk az `ExportFloatingShapesAsInlineTag` hatását. A teljes, futtatható példa azt mutatja, hogy **word document pdf‑t** csak néhány sorban konvertálhat, és most már tudja, **hogyan mentse a pdf‑et beállításokkal**, amelyek megfelelnek projektje minőségi és megfelelőségi igényeinek. + +Készen áll a következő kihívásra? Próbálja meg exportálni más formátumokba (pl. HTML, EPUB) a `document.Save("output.html")`‑val, vagy kísérletezzen a PDF/A megfelelőséggel a hosszú távú archiváláshoz. Ugyanazok az elvek—betöltés, beállítások konfigurálása, mentés—alkalmazhatók minden esetben. + +Boldog kódolást, és legyenek a PDF‑jei mindig pontosan úgy, ahogy elképzelte! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hungarian/net/programming-with-shapes/_index.md b/words/hungarian/net/programming-with-shapes/_index.md index 34b541acca..76483c68a9 100644 --- a/words/hungarian/net/programming-with-shapes/_index.md +++ b/words/hungarian/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Az Aspose.Words for .NET használatával és az alábbi oktatóanyagok követés | [Smart Art alakzat észlelése](./detect-smart-art-shape/) | Tanulja meg, hogyan észlelheti a SmartArt alakzatokat Word-dokumentumokban az Aspose.Words for .NET segítségével ebből az átfogó útmutatóból. Tökéletes a dokumentum-munkafolyamatok automatizálásához. | | [Smart Art rajz frissítése](./update-smart-art-drawing/) | Tanulja meg, hogyan frissítheti a Smart Art rajzokat Word dokumentumokban az Aspose.Words for .NET használatával ezzel a lépésről lépésre szóló útmutatóval. Gondoskodjon arról, hogy a vizuális elemek mindig pontosak legyenek. | | [Téglalap alakzat létrehozása Wordben az Aspose.Words segítségével – Lépésről lépésre útmutató](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Tanulja meg, hogyan hozhat létre téglalap alakzatot Word dokumentumokban az Aspose.Words for .NET segítségével lépésről lépésre. | +| [Word dokumentum létrehozása C# – Alakzat hozzáadása árnyékkal](./create-word-document-c-add-shape-with-shadow/) | Tanulja meg, hogyan adhat hozzá árnyékos alakzatot egy Word dokumentumhoz C#-ban az Aspose.Words for .NET segítségével. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hungarian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/hungarian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..b8f2a93142 --- /dev/null +++ b/words/hungarian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,203 @@ +--- +category: general +date: 2026-03-27 +description: Word dokumentum létrehozása C#-ban, és megtanulni, hogyan adjon hozzá + alakzatot, hogyan alkalmazzon árnyékot az alakzatra, és hogyan állítsa be az árnyék + távolságát. Lépésről‑lépésre útmutató az Aspose.Words-hez. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: hu +og_description: Hozzon létre Word-dokumentumot C#-ban egy téglalap alakzattal és egyedi + árnyékkal. Kövesse ezt a teljes útmutatót az árnyék távolságának és stílusának beállításához. +og_title: Word-dokumentum létrehozása C#‑ban – Alakzat hozzáadása árnyékkal +tags: +- Aspose.Words +- C# +- Document Automation +title: Word dokumentum létrehozása C#‑ban – Alakzat hozzáadása árnyékkal +url: /hu/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word dokumentum létrehozása C#‑ban – Alakzat hozzáadása árnyékkal + +Szükséged volt már **create word document c#**‑ra, amely egy szép stílusú téglalapot tartalmaz? Talán egy jelentés sablont építesz, és egy finom vetett árnyékot szeretnél, hogy a megjelenés kitűnjön. Ebben az útmutatóban pontosan ezt mutatjuk be – hogyan adjunk hozzá alakzatot, alkalmazzunk árnyékot az alakzatra, és még a árnyék távolságát is finomhangoljuk az Aspose.Words segítségével. + +Egy üres dokumentummal kezdünk, beillesztünk egy téglalapot, egy előre beállított árnyékot adunk neki, majd elmentjük a fájlt. A végére egy használatra kész .docx fájlod lesz, amelyet Word‑ben azonnal megnyithatsz, és láthatod a hatást. Nincs szükség külső eszközökre, csak tiszta C# kód. + +## Előfeltételek + +- .NET 6 (vagy bármely friss .NET Framework) telepítve. +- Visual Studio 2022 vagy VS Code C# kiegészítővel. +- Aspose.Words for .NET NuGet csomag (`Aspose.Words` 23.12 vagy újabb verzió). + A Package Manager Console‑ból így adhatod hozzá: + + ```powershell + Install-Package Aspose.Words + ``` + +Ennyi – nincs szükség extra DLL‑re vagy COM interopra. + +## 1. lépés: Új dokumentum és builder inicializálása – *create word document c#* alapok + +Először egy `Document` objektumra van szükség, amely a Word fájlt képviseli, és egy `DocumentBuilder`‑re, amellyel szerkeszthetjük. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Miért fontos ez a lépés:** A `Document` osztály a Word összes részét (oldalak, stílusok, képek) tárolja. A builder egy magas szintű API, amely elrejti az alacsony szintű csomópontkezelést, így könnyen **create word document c#**‑t készíthetsz XML‑kel való közvetlen foglalkozás nélkül. + +## 2. lépés: Téglalap alakzat beszúrása – *how to create rectangle* + +Most egy téglalapot helyezünk el az oldalon. A méret pontban van megadva (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro tipp:** Ha másik alakzatra van szükséged, egyszerűen cseréld le a `ShapeType.Rectangle`‑t `ShapeType.Ellipse`, `ShapeType.Triangle` stb. a kód ugyanúgy működik **how to add shape** bármely típusra. + +## 3. lépés: Előre beállított árnyék alkalmazása és finomhangolása – *apply shadow to shape* + +Az Aspose.Words több előre beállított árnyékformátummal érkezik. A `Preset1`‑et használjuk, majd testre szabjuk a távolságot, elmosódást, átlátszóságot és a színt. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Miért testre szabjuk az árnyékot?** A `Distance` tulajdonság határozza meg, milyen messze helyezkedik el az árnyék a téglalaptól – ez olyan, mint a “magasság”, amit egy 3‑D renderelésben látsz. A `BlurRadius` lágyítja a széleket, míg a `Transparency` lehetővé teszi egy finom, professzionális megjelenés létrehozását. Ez lefedi a **set shadow distance** követelményt, és megmutatja, hogyan **apply shadow to shape**‑t rugalmasan végezheted. + +## 4. lépés: Dokumentum mentése – *create word document c#* befejezés + +Végül írjuk a dokumentumot a lemezre. Állítsd be a útvonalat egy olyan mappára, amelyhez írási jogosultságod van. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Nyisd meg a keletkezett fájlt a Microsoft Wordben, és egy világoskék téglalapot látsz majd egy lágy szürke árnyékkal, amely 5 pt‑vel van eltolva. Ez a vizuális bizonyíték arra, hogy sikeresen **create word document c#**‑t készítettél egy stílusos alakzattal. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# példája, amely téglalapot mutat árnyékkal"} + +## Opcionális variációk és szélhelyzetek + +| Szenárió | Mit kell módosítani | Miért fontos | +|----------|--------------------|--------------| +| **Másik árnyékstílus** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Drámaibb megjelenést ad extra kód nélkül. | +| **Nincs preset – egyedi árnyék** | Hagyd el a `Format` beállítást, és állítsd be kézzel az `OffsetX`, `OffsetY` értékeket. | Teljes irány- és mélység‑vezérlés. | +| **Több alakzat** | Hívj meg újra `builder.InsertShape`‑t a mentés előtt. | Hasznos összetett sablonokhoz ikonokkal, logókkal stb. | +| **Kompatibilitás régebbi Aspose verziókkal** | Használd a `ShadowEffect` osztályt (elérhető v20.x‑ben). | Biztosítja, hogy a kód régi projektekben is fusson. | +| **Mentés PDF‑ként** | `document.Save("ShadowShape.pdf");` | Az árnyék ugyanúgy jelenik meg a PDF kimenetben. | + +> **Gyakori kérdés:** *Mi van, ha az árnyék nem jelenik meg Wordben?* +> Győződj meg róla, hogy a legújabb Aspose.Words verziót (≥ 22.9) használod. A régebbi kiadások korlátozott árnyék‑támogatással rendelkeztek. Emellett ellenőrizd, hogy a dokumentumot egy friss Word‑verzióban (2016+) nyitod meg. + +## Teljes működő példa + +Az alábbi program teljes, másolás‑beillesztés‑kész kódot tartalmaz. Minden `using` direktívát, megjegyzést és hibakezelést is, hogy zökkenőmentes legyen a futtatás. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Futtasd a programot, navigálj a `C:\Temp\ShadowShape.docx` helyre, és láthatod a pontosan beállított árnyékkal rendelkező téglalapot. + +## Összefoglalás és következő lépések + +- Most már tudod, hogyan **create word document c#**, hogyan szúrj be egy téglalapot, és hogyan **apply shadow to shape** egy egyedi **set shadow distance**‑del. +- A példa az Aspose.Words‑t használja, amely elrejti az OpenXML bonyolultságát, és garantálja a konzisztens megjelenítést a Word verziók között. +- Szeretnél tovább lépni? Próbáld ki több alakzat kombinálását, szöveg hozzáadását a téglalapba, vagy exportáld ugyanazt a dokumentumot PDF‑ként, hogy lásd, hogyan viselkedik az árnyék. + +### Kapcsolódó témák, amelyeket érdemes felfedezni + +- **How to add shape** a fejléc/láblécbe márkaépítés céljából. +- **Aspose.Words** használata diagramok és táblázatok programozott beszúrásához. +- **Shadow effects** testreszabása képeken vektoros alakzatok helyett. +- Tömeges dokumentumgenerálás automatizálása számlák vagy bizonyítványok számára. + +Kísérletezz, törjön el a kód, majd építsd újra – ez a leggyorsabb módja a koncepciók elsajátításának. Ha elakadsz, írj egy megjegyzést alul, vagy nézd meg az Aspose.Words hivatalos dokumentációját a mélyebb API‑részletekért. + +Boldog kódolást, és élvezd, hogy a Word fájljaid egy kicsit elegánsabbak lesznek! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hungarian/net/programming-with-txtsaveoptions/_index.md b/words/hungarian/net/programming-with-txtsaveoptions/_index.md index ae0259f372..a00e35b76d 100644 --- a/words/hungarian/net/programming-with-txtsaveoptions/_index.md +++ b/words/hungarian/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Ezeknek az oktatóanyagoknak köszönhetően teljes mértékben kiaknázhatod az | [Kétirányú jelek hozzáadása Word-dokumentumban](./add-bidi-marks/) | Tanulja meg, hogyan adhat hozzá kétirányú (Bidi) jeleket Word-dokumentumokban az Aspose.Words for .NET használatával ebből az útmutatóból. Biztosítsa a megfelelő szövegirányt többnyelvű tartalom esetén. | | [Tabulátor karakter használata szintenként a lista behúzásához](./use-tab-character-per-level-for-list-indentation/) | Ismerje meg, hogyan hozhat létre többszintű, tabulátoros behúzással rendelkező listákat az Aspose.Words for .NET segítségével. Kövesse ezt az útmutatót a dokumentumokban található precíz listaformázáshoz. | | [Szóköz karakter használata szintenként a lista behúzásához](./use-space-character-per-level-for-list-indentation/) | Tanulja meg, hogyan hozhat létre többszintű listákat szóközök behúzásával az Aspose.Words for .NET programban. Lépésről lépésre útmutató a precíz dokumentumformázáshoz. | - +| [Docx mentése txt formátumba – Teljes útmutató a Word egyenletek LaTeX-be exportálásához](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Ismerje meg, hogyan exportálhatja a Word egyenleteket LaTeX formátumba, miközben a dokumentumot txt fájlba menti. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hungarian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/hungarian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..fed9f55b6c --- /dev/null +++ b/words/hungarian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Mentse a docx fájlt txt formátumba az Aspose.Words segítségével, és konvertálja + a Word dokumentumot LaTeX-re. Tanulja meg, hogyan exportálhat egyenleteket, őrizheti + meg a sima szöveget, és percek alatt szerezhet LaTeX jelölést. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: hu +og_description: Mentse a docx fájlt txt formátumba az Aspose.Words segítségével. Ez + az útmutató bemutatja, hogyan konvertálhatja a Word dokumentumot LaTeX-re, exportálhatja + a képleteket, és megtarthatja a dokumentumot egyszerű szövegként. +og_title: docx mentése txt-ként – Word egyenletek exportálása LaTeX-be +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: DOCX mentése TXT formátumba – Teljes útmutató a Word egyenletek LaTeX‑be exportálásához +url: /hu/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# DOCX mentése txt‑ként – Word egyenletek exportálása LaTeX‑be + +Valaha szükséged volt már **save docx as txt**-re, de aggódtál, hogy elvesznek a Word fájlodban lévő csodás matematikai képletek? Nem vagy egyedül. Sok tudományos munkafolyamatban a dokumentum egyszerű szöveges változata elengedhetetlen, ugyanakkor szeretnéd, ha a képletek tiszta LaTeX jelölésként megmaradnának. + +Ebben az útmutatóban lépésről‑lépésre végigvezetünk a **convert Word to LaTeX** folyamatán az Aspose.Words for .NET használatával, így a képletek helyesen exportálódnak, míg a dokumentum többi része rendezett egyszerű szöveggé válik. A végére megtanulod, hogyan **export equations to LaTeX**, hogyan tartsd a fájl többi részét egyszerű szövegként, és elkerülheted a kezdők gyakran elkövetett hibáit. + +## Mit fogsz megtanulni + +- Hogyan töltsünk be egy *.docx* fájlt, amely Office Math‑ot tartalmaz. +- `TxtSaveOptions` megfelelő beállítása, hogy az Aspose minden egyenlethez LaTeX‑et adjon ki. +- Az eredmény mentése **save word plain text** fájlként, amelyet verziókezelésbe, CI‑csővezetékekbe vagy bármely downstream eszközbe beilleszthetsz. +- Gyakori szélhelyzetek – mit tegyünk, ha egy dokumentum képeket és egyenleteket kever, vagy ha Unicode karaktereket kell megőrizni. +- Egy teljes, azonnal futtatható kódminta, amelyet beilleszthetsz egy konzolos alkalmazásba. + +### Előfeltételek + +- .NET 6.0 vagy újabb (a kód .NET Framework 4.7+‑vel is működik). +- Az **Aspose.Words for .NET** licencelt példánya (az ingyenes próba a teszteléshez megfelelő). +- Visual Studio 2022 vagy bármely IDE, amely képes C# projektek fordítására. +- Egy Word dokumentum (`input.docx`), amely már tartalmaz néhány Office Math objektumot. + +> **Pro tip:** Ha még nincs licenced, kérhetsz egy ideiglenes kulcsot az Aspose weboldaláról – csak cseréld le a kódban a helyőrzőt a saját kulcsodra a futtatás előtt. + +## 1. lépés – Aspose.Words telepítése NuGet‑en keresztül + +Először is: szükséged van a könyvtárra a projektedben. Nyisd meg a **Package Manager Console**‑t, és futtasd: + +```powershell +Install-Package Aspose.Words +``` + +Ez az egyetlen sor mindent behozza, amire szükséged van, beleértve a `Saving` névteret, ahol a `TxtSaveOptions` található. Nincs extra DLL, nincs natív függőség – csak tiszta managed kód. + +## 2. lépés – A forrás Word dokumentum betöltése + +Most már ténylegesen beolvassuk a képleteket tartalmazó fájlt. A `Document` osztály absztrahálja a teljes *.docx* struktúrát, így magas szintű objektummodellként kezelheted. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Miért fontos:** A dokumentum korai betöltése lehetővé teszi a csomópontfa vizsgálatát. Ha kihagyod az ellenőrzést, és a fájl nem tartalmaz egyenleteket, akkor is kapsz egy tiszta txt fájlt – de nem fogod tudni, miért üres a LaTeX kimenet. + +## 3. lépés – TxtSaveOptions beállítása LaTeX exporthoz + +Az Aspose finomhangolt vezérlést biztosít az Office Math megjelenítéséhez. Az `OfficeMathExportMode` `LaTeX`‑re állításával minden egyenlet a LaTeX megfelelőjévé alakul, ahelyett, hogy eltávolításra vagy képpé konvertálásra kerülne. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Miért fontos:** Az alapértelmezett export mód teljesen eltávolítaná az egyenleteket. A `LaTeX`‑re váltás megőrzi a matematikai szándékot, ami pontosan az, amire szükséged van, amikor később a fájlt LaTeX fordítóba vagy egy `$…$` szintaxist értő markdown processzorba adod. + +## 4. lépés – Dokumentum mentése egyszerű szövegként + +Az opciók beállítása után a fájl mentése egyetlen sorban megoldható. A kimenet egy `.txt` fájl lesz, ahol minden egyenlet LaTeX kódként jelenik meg `$` határolókkal körülvéve (később megváltoztathatod, ha inkább `\[` … `\]` blokkokat szeretnél). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Várható eredmény + +Nyisd meg az `output.txt`‑t bármely szerkesztőben, és valami ilyesmit fogsz látni: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Vedd észre, hogy a normál szöveg pontosan úgy marad, ahogy volt, míg az egyenletek most tiszta LaTeX karakterláncok. Ezeket közvetlenül beillesztheted egy LaTeX dokumentumba, Jupyter notebookba vagy bármely matematikát megjelenítő eszközbe. + +## 5. lépés – Szélhelyzetek kezelése + +### Vegyes tartalom (képek + egyenletek) + +Ha a Word fájlod képeket is tartalmaz, az Aspose figyelmen kívül hagyja őket, ha `TxtSaveOptions`‑t használsz. Ez általában rendben van egy **save word plain text** munkafolyamatnál, de ha a képekre helyőrzőként van szükséged, akkor a következőket teheted: + +1. Exportáld a dokumentumot először HTML‑be (`HtmlSaveOptions`), hogy a képeket `` tagekként rögzítse. +2. Futtass egy második átfutást `TxtSaveOptions`‑szal a LaTeX egyenletekhez. +3. Manuálisan vagy egy kis szkripttel egyesítsd a két eredményt. + +### Unicode szimbólumok + +Néhány egyenlet speciális Unicode karaktereket használ (pl. görög betűk). Az `Encoding = Encoding.UTF8` beállítása a `TxtSaveOptions`‑ban (ahogy a 3. lépésben látható) biztosítja, hogy ezek a szimbólumok megmaradjanak a konverzió során. + +### Nagy dokumentumok + +Nagy fájlok (> 100 MB) esetén érdemes a mentési műveletet streamelni: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +A streaming megakadályozza, hogy a teljes kimenetet a memóriába töltsd, ami alacsony memóriaigényű build ügynökökön életmentő lehet. + +## Teljes működő példa + +Az alábbiakban a teljes, másolásra és beillesztésre kész program látható, amely mindent összekapcsol. Csak cseréld le a fájl útvonalakat, és ha van, a licencsort. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Futtasd a programot (`dotnet run`, ha konzolos projektet használsz), és ellenőrizd az `output.txt`‑t. Így **save docx as txt**-t hajtottál végre, miközben minden egyenletet LaTeX‑ként megőriztél – manuális másolás‑beillesztés nélkül. + +## Gyakran Ismételt Kérdések + +**Q: Meg tudom változtatni a határolót `$…$`‑ról `\(...\)`‑re?** +A: Igen. Mentés után futtass egy egyszerű helyettesítést a fájlon: `output = output.Replace("$", @"\(").Replace("$", @"\)");` – csak légy óvatos, hogy ne cseréld le az eredeti szövegben szereplő inline `$` karaktereket. + +**Q: Működik ez a Word 2007‑2019 fájlokkal?** +A: Teljesen. Az Aspose.Words támogatja a `.doc`, `.docx`, `.docm` és még az újabb `.dotx` családot is. Ugyanaz a kód minden verzión működik. + +**Q: Mit tegyek, ha meg kell őriznem az eredeti bekezdésformázást (tabulátorok, többszörös szóközök)?** +A: Állítsd be `txtSaveOptions.PreserveTableLayout = true;` és `txtSaveOptions.PreserveSpace = true;` értékeket, hogy a szóközök érintetlenek maradjanak. + +## Összegzés + +Megmutattuk mindent, amire szükséged van a **save docx as txt** elvégzéséhez, miközben **exportálod az egyenleteket LaTeX‑be** az Aspose.Words használatával. A kulcsfontosságú lépések a dokumentum betöltése, a `TxtSaveOptions` `OfficeMathExportMode.LaTeX` beállítása, és az eredmény mentése. Ezzel a három kódsorral megbízhatóan **convert word to latex**-t hajthatsz végre, a dokumentumot **save word plain text**‑ként tarthatod, és elkerülheted a matematikai szimbólumok elvesztését. + +Készen állsz a következő kihívásra? Próbáld meg összekapcsolni ezt a munkafolyamatot egy markdown generátorral, hogy egy teljes `.md` fájlt hozz létre, amely mind a szöveget, mind a LaTeX‑et tartalmazza – tökéletes Git‑alapú dokumentációhoz vagy statikus weboldalgenerátorokhoz. Vagy fedezd fel az Aspose `PdfSaveOptions`‑át, hogy a plain‑text fájl mellett PDF verziót is kapj. + +Ha bármilyen problémába ütközöl, hagyj egy megjegyzést alább. Boldog kódolást, és élvezd a Word egyenletek tiszta LaTeX‑re alakításának egyszerűségét! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hungarian/net/working-with-fonts/_index.md b/words/hungarian/net/working-with-fonts/_index.md index 609ee46620..3604f838c5 100644 --- a/words/hungarian/net/working-with-fonts/_index.md +++ b/words/hungarian/net/working-with-fonts/_index.md @@ -40,7 +40,7 @@ Akár különböző betűtípusokkal szeretné formázni a szöveget, betűtípu | [Betűtípusok mappáinak prioritás szerinti beállítása](./set-fonts-folders-with-priority/) | Ismerje meg, hogyan állíthat be prioritást a betűtípus-mappákban a Word-dokumentumokban az Aspose.Words for .NET használatával. Útmutatónk biztosítja, hogy dokumentumai minden alkalommal tökéletesen jelenjenek meg. | | [True Type betűtípusok mappa beállítása](./set-true-type-fonts-folder/) | Ismerje meg, hogyan állíthat be True Type Fonts mappát Word-dokumentumokban az Aspose.Words for .NET segítségével. Kövesse részletes, lépésről lépésre szóló útmutatónkat a betűtípus-kezelés egységessége érdekében. | | [Alapértelmezett betűtípus megadása rendereléshez](./specify-default-font-when-rendering/) | Ismerje meg, hogyan adhat meg alapértelmezett betűtípust Word-dokumentumok renderelésekor az Aspose.Words for .NET használatával. Biztosítsa a dokumentumok egységes megjelenését a platformokon átívelően. | -| [Betűtípus-beállítások betöltési opciókkal](./font-settings-with-load-options/) Ismerje meg, hogyan kezelheti a betűtípus-beállításokat a betöltési opciókkal az Aspose.Words for .NET programban. Lépésről lépésre útmutató fejlesztőknek a betűtípusok egységes megjelenésének biztosításához a Word-dokumentumokban. +| [Betűtípus-beállítások betöltési opciókkal](./font-settings-with-load-options/) Ismerje meg, hogyan kezelheti a betűtípus-beállításokat a betöltési opciókkal az Aspose.Words for .NET programban. Lépésről lépésre útmutató fejlesztőknek a betűtípusok egységes megjelenésének biztosításához a Word-dokumentumokban. | | [Betűtípusok beállítása mappa](./set-fonts-folder/) | Ismerje meg, hogyan állíthat be egyéni betűtípusmappát az Aspose.Words for .NET programban, hogy Word-dokumentumai helyesen jelenjenek meg hiányzó betűtípusok nélkül. | | [Betűtípusbeállítások Alapértelmezett példány](./font-settings-default-instance/) | Ebben az oktatóanyagban megtudhatja, hogyan konfigurálhatja az alapértelmezett betűtípus-beállításokat egy Word-dokumentumban az Aspose.Words for .NET segítségével. | | [Elérhető betűtípusok listájának lekérése](./get-list-of-available-fonts/) | Fedezze fel, hogyan kérheti le az elérhető betűtípusok listáját az Aspose.Words for .NET használatával ebben a részletes, lépésről lépésre szóló útmutatóban. Fejlessze betűtípus-kezelési készségeit. | @@ -48,7 +48,8 @@ Akár különböző betűtípusokkal szeretné formázni a szöveget, betűtípu | [Figyelmeztető értesítés fogadása](./receive-warning-notification/) Ismerje meg, hogyan kaphat figyelmeztető értesítést az Aspose.Words for .NET használatakor, és hogyan kezelheti a dokumentumokban előforduló problémákat vagy figyelmeztetéseket. | | [Erőforrás Steam betűtípus forrás példa](./resource-steam-font-source-example/) | Ismerje meg, hogyan használható a Resource Stream Font Source egyéni betűtípusok betöltéséhez az Aspose.Words for .NET fájlba. | | [Helyettesítés kérése utótagok nélkül](./get-substitution-without-suffixes/) | Ebben az oktatóanyagban megtudhatja, hogyan lehet utótag nélküli felülírásokat beállítani egy Word-dokumentumban az Aspose.Words for .NET segítségével. | - +| [Aspose betűtípus helyettesítés – Hogyan konfigurálja a betűtípus beállításokat C#-ban](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Ismerje meg, hogyan konfigurálhatja a betűtípus beállításokat C#-ban az Aspose.Words for .NET használatával. | + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/hungarian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/hungarian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..f1416a39f7 --- /dev/null +++ b/words/hungarian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,252 @@ +--- +category: general +date: 2026-03-27 +description: 'Az Aspose betűtípus-helyettesítés egyszerűen: tanulja meg konfigurálni + a betűtípus-beállításokat, rögzíteni a figyelmeztetéseket, és kezelni a hiányzó + betűtípusokat .NET alkalmazásaiban.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: hu +og_description: Mesteri Aspose betűtípus-helyettesítés a betűtípus-beállítások konfigurálásával + és a hiányzó betűtípusok figyelmeztető visszahívással történő kezelése. Teljes C# + útmutató. +og_title: Aspose betűtípus helyettesítés – Betűtípus beállítások konfigurálása C#‑ban +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose betűtípus helyettesítés – Hogyan konfiguráljuk a betűtípus beállításait + C#‑ban +url: /hu/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Betűtípus-helyettesítés – Teljes útmutató a betűtípus-beállítások konfigurálásához + +Előfordult már, hogy egy dokumentum hirtelen az egyedi betűtípusát egy általánosra cseréli? Ez a **aspose font substitution** munkája – a hiányzó betűtípusok helyettesítése a legközelebbi megtalálhatóval. Praktikus, de ha pontosan tudni akarod, melyik betűtípust cserélte le, akkor a könyvtár figyelmeztetési rendszerét kell használnod, és saját magadnak kell konfigurálnod a betűtípus-beállításokat. + +Ebben az útmutatóban egy valós példán keresztül mutatjuk be: egy DOCX betöltése, amely egy nem létező betűtípust hivatkozik, a helyettesítési esemény rögzítése, és egy barátságos üzenet kiírása a konzolra. A végére magabiztosan tudod majd a **configure font settings** használatát, egy **Aspose.Words warning callback** beállítását, és a mintát bármilyen munkafolyamatba beilleszteni. + +> **Amire szükséged lesz** +> • .NET 6+ (vagy .NET Framework 4.7.2+) +> • Aspose.Words for .NET (legújabb NuGet) +> • Egy DOCX, amely hiányzó betűtípust hivatkozik (nevezzük `MissingFont.docx`‑nek) + +Vágjunk bele. + +--- + +## 1. lépés: Aspose.Words telepítése és a projekt előkészítése + +Mielőtt kódot írnánk, győződj meg róla, hogy az Aspose.Words csomag hivatkozásként szerepel: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro tipp:** Használd a legújabb stabil verziót; 2026. március állapotában ez a 23.11.0. Az újabb kiadások javítják a betűtípus‑illesztési algoritmusokat és további figyelmeztetéstípusokat adnak hozzá. + +Hozz létre egy új konzolos alkalmazást (vagy illeszd be a kódot egy meglévő projektbe), és add hozzá a szokásos `using` direktívákat: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Ezek a névterek biztosítják a `Document`, `LoadOptions` és a betűtípusokkal kapcsolatos osztályok elérését. + +--- + +## 2. lépés: Betűtípus-beállítások konfigurálása LoadOptions-szal + +A **aspose font substitution** vezérlésének szíve a `LoadOptions.FontSettings`. Egy üres `FontSettings` objektum megadásával azt mondjuk az Aspose‑nak, hogy használja az alapértelmezett keresési útvonalakat *és* jelentse a helyettesítéseket egy figyelmeztetési callback‑en keresztül. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Miért ne csak az alapértelmezéseket használnánk? Mert a figyelmeztetési callback (következő lépés) csak akkor működik, ha a `FontSettings` tulajdonság nem `null`. Ez a kis sor egy horgot biztosít a helyettesítési folyamatba anélkül, hogy megváltoztatná a tényleges betűtípus-keresési viselkedést. + +--- + +## 3. lépés: Figyelmeztetési callback csatolása a helyettesítések rögzítéséhez + +Az Aspose.Words megvalósítja az `IWarningCallback` interfészt. Amikor valami figyelemre méltó történik – például hiányzó betűtípus – meghívja a `Warning` metódusunkat. Egy apró kezelőt fogunk implementálni, amely a `WarningType.FontSubstitution` típusra szűr, és kiírja a leírást. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +És itt van maga a kezelő: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Miért fontos** – A callback nélkül az Aspose csendben helyettesíti a betűtípusokat, és sosem tudod, melyik lett használva. A callback átláthatóvá teszi a folyamatot, ami elengedhetetlen a megfelelőségi jelentésekhez vagy a megjelenítési problémák hibakereséséhez. + +--- + +## 4. lépés: Dokumentum betöltése a konfigurált beállításokkal + +Most végre betöltjük a dokumentumot, átadva a korábban előkészített `loadOptions`‑t. Ha a forrásfájl egy nem telepített betűtípust hivatkozik, a kezelőnk aktiválódik. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Cseréld le a `YOUR_DIRECTORY`‑t arra az útra, ahol a `MissingFont.docx` található. A program futtatásakor a kimenet valami ilyesmi lesz: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Ez a sor pontosan megmondja, melyik betűtípus hiányzott és melyik helyettesítést választotta az Aspose. + +--- + +## 5. lépés: (Opcionális) Betűtípus-keresési útvonalak finomhangolása + +Ha van egy privát mappa vállalati betűtípusokkal, megmondhatod az Aspose‑nak, hol keressen, mielőtt a rendszer‑betűtípusokra támaszkodna. Ez egy fejlett **configure font settings** használat: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +A `recursive: true` beállítás azt eredményezi, hogy az Aspose az almappákat is átvizsgálja. Így a könyvtár először a privát betűtípusokat próbálja meg, csökkentve a nem kívánt helyettesítések esélyét. + +--- + +## Teljes működő példa + +Mindent egy helyre téve, itt a komplett, azonnal futtatható program: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Várható kimenet** (ha hiányzó betűtípust talál): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Ha minden betűtípus jelen van, a program csendben fut (nincs figyelmeztetés), és továbbra is előállítja a PDF‑et. + +--- + +## Gyakori kérdések és széljegyek + +### Mi van, ha *meg akarom akadályozni* a helyettesítést? + +Állítsd a `FontSettings.SubstitutionSettings`‑t `null`‑ra, vagy használd a `FontSettings.FontSubstitutionSettings`‑t a viselkedés szabályozásához. Például: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Ekkor az Aspose kivételt dob a csendes helyettesítés helyett, amely elkapható és kezelhető. + +### Működik ez más fájlformátumokkal (pl. .doc, .rtf)? + +Természetesen. Ugyanaz a `LoadOptions` objektum átadható bármely `Document` konstruktorának, amely fájlútra vár. A figyelmeztetési callback minden, betűtípusokat igénylő formátumnál aktiválódik. + +### Rögzíthetem a *pontos* helyettesítő betűtípus nevét? + +Igen. Az `info.Description` karakterlánc tartalmazza mind a hiányzó, mind a helyettesítő betűtípust. Ha programozottan kell a nevet, kinyerheted a szövegből, vagy használhatod a `FontInfo` objektumot (újabb verziókban elérhető). + +### Hogyan viselkedik ez több szálon? + +A `FontSettings` **nem** szálbiztos. Hozz létre külön `LoadOptions`‑t (saját `FontSettings`‑szel) szálanként, vagy védj hozzáférést egy lock‑kal. + +--- + +## Összegzés + +Mindent áttekintettünk, ami ahhoz kell, hogy mesteri szinten kezeld a **aspose font substitution**‑t és a **configure font settings**‑t egy C# alkalmazásban: + +1. Telepítsd az Aspose.Words‑t és add hozzá a szükséges `using` direktívákat. +2. Hozz létre egy `LoadOptions` objektumot friss `FontSettings`‑szel. +3. Csatolj egy egyedi `IWarningCallback`‑t a helyettesítési események megjelenítéséhez. +4. Töltsd be a dokumentumot, hagyva, hogy a callback jelentse a hiányzó betűtípusokat. +5. (Opcionális) Bővítsd a keresési útvonalat vagy tiltsd le teljesen a helyettesítést. + +Ezzel a mintával naplózhatod a hiányzó betűtípusokat megfelelőségi célokra, értesítheted a felhasználókat egy UI‑ban, vagy automatikusan beágyazhatod a tartalék betűtípusokat a publikálás előtt. Következő lépésként felfedezheted a **Aspose.Words betűtípus-helyettesítési szabályait**, vagy integrálhatod a munkafolyamatot egy nagyobb dokumentum‑feldolgozó csővezetékbe. + +Boldog kódolást, és legyenek a dokumentumaid mindig a megfelelő betűtípussal renderelve! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/indonesian/net/basic-conversions/_index.md b/words/indonesian/net/basic-conversions/_index.md index a4f93f422e..ee251ebe9d 100644 --- a/words/indonesian/net/basic-conversions/_index.md +++ b/words/indonesian/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ Bahasa Indonesia: --- | --- Bahasa Indonesia: | [Simpan Word sebagai PDF dengan Aspose.Words – Panduan Lengkap C#](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Panduan langkah demi langkah menyimpan dokumen Word ke PDF menggunakan Aspose.Words dalam C#. Sempurna untuk pengembang. | | [Cara Mengekspor LaTeX dari Word – Panduan Langkah‑demi‑Langkah](./how-to-export-latex-from-word-step-by-step-guide/) | Pelajari cara mengekspor dokumen Word ke format LaTeX dengan Aspose.Words untuk .NET dalam panduan langkah demi langkah. | | [Mengonversi Word ke PDF dalam C# menggunakan Aspose.Words – Panduan](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Panduan langkah demi langkah mengonversi dokumen Word ke PDF menggunakan Aspose.Words dalam C#. Bahasa Indonesia: | +| [Mengonversi Word ke PDF dengan Aspose.Words – Panduan Lengkap](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Panduan lengkap langkah demi langkah mengonversi dokumen Word ke PDF menggunakan Aspose.Words untuk .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/indonesian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/indonesian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..0f0fe289a0 --- /dev/null +++ b/words/indonesian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-03-27 +description: Konversi Word ke PDF dengan cepat menggunakan Aspose.Words. Pelajari + cara menyimpan Word sebagai PDF, mengekspor docx ke PDF, dan menghasilkan PDF yang + dapat diakses dalam C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: id +og_description: Konversi Word ke PDF dalam C# menggunakan Aspose.Words. Panduan ini + menunjukkan cara menyimpan Word sebagai PDF, mengekspor docx ke PDF, dan menghasilkan + PDF yang dapat diakses. +og_title: Konversi Word ke PDF dengan Aspose.Words – Langkah demi Langkah +tags: +- Aspose.Words +- C# +- PDF conversion +title: Mengonversi Word ke PDF dengan Aspose.Words – Panduan Lengkap +url: /id/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Mengonversi Word ke PDF dengan Aspose.Words – Panduan Lengkap + +Pernah bertanya-tanya bagaimana cara **convert Word to PDF** tanpa repot dengan alat web pihak ketiga? Mungkin Anda sedang membangun mesin laporan otomatis dan membutuhkan cara yang andal untuk *save word as pdf* secara langsung. Kabar baiknya, Aspose.Words membuat seluruh proses menjadi sangat mudah, dan Anda bahkan dapat menghasilkan file yang mematuhi **PDF/UA‑2**—sempurna untuk persyaratan aksesibilitas. + +Dalam tutorial ini kami akan membahas semua yang Anda perlukan: memuat sebuah `.docx`, mengonfigurasi opsi PDF sehingga Anda dapat *export docx to pdf* dengan kepatuhan PDF/UA, dan akhirnya menyimpan hasilnya sebagai PDF yang dapat diakses. Pada akhir tutorial Anda akan memiliki potongan kode yang mandiri, siap produksi, yang dapat Anda sisipkan ke proyek .NET mana pun. + +![Convert Word to PDF using Aspose.Words](convert-word-to-pdf.png) + +## Apa yang Akan Anda Pelajari + +- **Mengapa Aspose.Words** merupakan pilihan yang solid untuk skenario *generate accessible pdf*. +- Langkah‑langkah tepat untuk *save document as pdf* dengan kepatuhan PDF/UA‑2. +- Cara menangani kasus tepi umum seperti font yang hilang atau file sumber yang dilindungi kata sandi. +- Tips cepat untuk men-debug output dan memverifikasi kepatuhan aksesibilitas. + +### Prasyarat + +- .NET 6 atau lebih baru (API juga berfungsi pada .NET Framework 4.6+). +- Lisensi Aspose.Words for .NET yang valid (versi percobaan gratis dapat digunakan untuk evaluasi). +- Pengetahuan dasar C#—tidak memerlukan pola yang rumit. + +Jika Anda sudah mencentang semua kotak tersebut, mari kita mulai. + +--- + +## Mengonversi Word ke PDF – Implementasi Langkah‑per‑Langkah + +Kami akan membagi solusi menjadi lima langkah jelas. Setiap langkah memiliki judul, cuplikan kode singkat, dan penjelasan tentang *mengapa* kode tersebut penting. + +### Langkah 1: Muat Dokumen Word yang Ingin Anda Konversi + +Hal pertama yang Anda butuhkan adalah objek `Document` yang mewakili file sumber. Aspose.Words dapat membaca **.docx**, **.doc**, **.rtf**, dan banyak format lainnya, sehingga Anda dapat *save word as pdf* terlepas dari cara file tersebut dibuat. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Mengapa ini penting:** +- Memuat file lebih awal memungkinkan Anda menangkap kesalahan file yang hilang sebelum membuang siklus CPU. +- Kelas `Document` menyembunyikan struktur internal file Word, memberikan Anda model objek yang bersih untuk bekerja. + +### Langkah 2: Konfigurasikan Opsi Penyimpanan PDF untuk Aksesibilitas + +Jika Anda perlu *generate accessible pdf* file, Anda harus memberi tahu Aspose.Words untuk menghasilkan dokumen yang mematuhi PDF/UA‑2. Kelas `PdfSaveOptions` memberi Anda kontrol detail atas output. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Mengapa ini penting:** +- `PdfCompliance.PdfUa2` memberi tahu perpustakaan untuk menambahkan tag, informasi struktur, dan metadata yang diperlukan oleh pembaca layar. +- Menyematkan font (`EmbedFullFonts = true`) mencegah peringatan “font not found” yang menakutkan ketika PDF dibuka di OS yang berbeda. +- Menetapkan `Title` membantu teknologi bantu mengumumkan dokumen dengan benar. + +### Langkah 3: Simpan Dokumen sebagai PDF + +Setelah sumber dimuat dan opsi diatur, konversi sebenarnya cukup satu baris kode. Inilah tempat Anda *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Mengapa ini penting:** +- Metode `Save` menghormati `PdfSaveOptions` yang kami konfigurasikan, memastikan fitur aksesibilitas terintegrasi. +- Membungkus pemanggilan dalam blok `try/catch` memberi Anda kesempatan untuk mencatat atau menampilkan kesalahan lisensi atau izin yang sering membuat pemula kebingungan. + +### Langkah 4: Verifikasi Kepatuhan PDF/UA (Opsional tetapi Disarankan) + +Meskipun Aspose.Words melakukan pekerjaan berat, praktik yang baik adalah memeriksa kembali output, terutama ketika Anda mengirim dokumen ke lembaga pemerintah atau entitas yang diatur. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Mengapa ini penting:** +- `IsTagged` adalah pemeriksaan cepat; validasi PDF/UA penuh memerlukan validator khusus, tetapi sebagian besar masalah kepatuhan muncul sebagai tag yang hilang. +- Jika flag mengembalikan `false`, Anda dapat meninjau kembali `PdfSaveOptions`—mungkin Anda lupa mengatur `Compliance` atau dokumen sumber tidak memiliki gaya heading yang tepat. + +### Langkah 5: Kesalahan Umum & Tips Pro + +| Masalah | Apa yang Terjadi | Cara Memperbaiki | +|---------|------------------|------------------| +| **Font hilang** | Teks muncul sebagai kotak di PDF. | Atur `EmbedFullFonts = true` **atau** instal font yang hilang di server. | +| **Perpustakaan tidak berlisensi** | Aspose menambahkan watermark pada setiap halaman. | Tambahkan file lisensi Anda (`Aspose.Words.lic`) di awal aplikasi (mis., `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Sumber terlindungi kata sandi** | `InvalidOperationException` pada `new Document(path)`. | Gunakan overload `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Dokumen besar menyebabkan OOM** | Pengecualian out‑of‑memory pada file besar. | Aktifkan `MemoryOptimization` di `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Tag aksesibilitas hilang** | Validasi PDF/UA gagal. | Pastikan file Word sumber menggunakan gaya heading yang tepat (`Heading 1`, `Heading 2`, dll.)—Aspose memetakan itu ke tag PDF secara otomatis. | + +**Tips Pro:** Jika Anda mengonversi banyak dokumen secara batch, gunakan kembali satu instance `PdfSaveOptions`. Membuatnya sekali mengurangi overhead alokasi dan menjaga jejak memori Anda tetap rendah. + +--- + +## Contoh Lengkap yang Berfungsi (Siap Salin‑Tempel) + +Berikut adalah program lengkap yang menggabungkan semuanya. Simpan sebagai `Program.cs`, tambahkan paket NuGet Aspose.Words dan Aspose.PDF, lalu jalankan. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Hasil yang Diharapkan:** +Sebuah file bernama `output.pdf` muncul di `C:\MyFiles`. Membukanya di Adobe Acrobat akan menampilkan “PDF/A‑2b, PDF/UA‑1” di panel kepatuhan, mengonfirmasi bahwa Anda telah berhasil *convert word to pdf* + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/indonesian/net/programming-with-markdownsaveoptions/_index.md b/words/indonesian/net/programming-with-markdownsaveoptions/_index.md index 99c8d539a0..6bb993551d 100644 --- a/words/indonesian/net/programming-with-markdownsaveoptions/_index.md +++ b/words/indonesian/net/programming-with-markdownsaveoptions/_index.md @@ -41,6 +41,12 @@ Pelajari cara mengekspor dokumen Word ke Markdown dengan panduan lengkap C#. Pelajari cara menyimpan file DOCX sebagai Markdown dengan panduan langkah demi langkah menggunakan C#. ### [Cara Mengekspor Markdown dari DOCX – Panduan Lengkap](./how-to-export-markdown-from-docx-complete-guide/) Pelajari cara mengekspor dokumen DOCX ke format Markdown dengan panduan lengkap. +### [Cara Mengekspor LaTeX dari Word – Konversi DOCX ke Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) +Pelajari cara mengekspor persamaan LaTeX dari dokumen Word dan mengonversinya menjadi format Markdown. +### [Cara Mengekspor LaTeX dari DOCX – Konversi ke Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) +Pelajari cara mengekspor persamaan LaTeX dari file DOCX dan mengonversinya menjadi format Markdown menggunakan Aspose.Words untuk .NET. +### [Buat markdown dari Word – Panduan Lengkap C#](./create-markdown-from-word-full-c-guide/) +Pelajari cara mengonversi dokumen Word menjadi markdown menggunakan C# dengan panduan lengkap. {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/indonesian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/indonesian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..122d01f736 --- /dev/null +++ b/words/indonesian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,251 @@ +--- +category: general +date: 2026-03-27 +description: Buat markdown dari Word dengan Aspose.Words C#. Pelajari cara mengonversi + docx ke markdown, mengekstrak gambar dari Word, dan cara menggunakan callback dalam + satu tutorial. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: id +og_description: Buat markdown dari Word menggunakan Aspose.Words. Panduan ini menunjukkan + cara mengonversi docx ke markdown, mengekstrak gambar dari Word, dan menggunakan + callback untuk penanganan sumber daya. +og_title: Buat markdown dari Word – Tutorial C# Lengkap +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Buat markdown dari Word – Panduan Lengkap C# +url: /id/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Buat markdown dari Word – Tutorial Lengkap C# + +Pernah perlu **membuat markdown dari Word** tetapi tidak yakin harus mulai dari mana? Anda tidak sendirian; banyak pengembang mengalami hal ini ketika mereka mencoba memindahkan konten dari file .docx ke generator situs statis atau repositori dokumentasi. Kabar baiknya? Dengan Aspose.Words Anda dapat **mengonversi docx ke markdown**, mengambil setiap gambar dari file asli, dan mengontrol tepat di mana sumber daya tersebut ditempatkan—semua dengan callback sederhana. + +> **Pro tip:** Jika Anda sudah memiliki templat Word yang berisi tangkapan layar, diagram, atau logo, metode ini akan mempertahankan setiap elemen visual tanpa Anda harus menyalin‑tempel secara manual. + +--- + +## Apa yang Anda Butuhkan + +- **.NET 6+** (atau .NET Framework 4.6+). Kode ini bekerja pada runtime terbaru apa pun. +- **Aspose.Words for .NET** (paket NuGet `Aspose.Words`). Versi percobaan gratis berfungsi untuk sebagian besar skenario. +- Sebuah **dokumen Word** (`input.docx`) yang berisi teks dan setidaknya satu gambar. +- Pemahaman dasar tentang C# dan Visual Studio (atau IDE favorit Anda). + +Tidak ada pustaka tambahan yang diperlukan—semua hal lain ditangani oleh Aspose.Words itu sendiri. + +--- + +## Langkah 1: Siapkan Proyek dan Instal Aspose.Words + +Untuk menjaga semuanya rapi, buat proyek konsol baru: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Mengapa langkah ini penting:** Menginstal paket NuGet memastikan Anda memiliki API terbaru, yang mencakup kelas `MarkdownSaveOptions` yang diperkenalkan pada versi 22.9. Tanpanya Anda harus menulis konverter khusus. + +--- + +## Langkah 2: Muat Dokumen Word Sumber + +Baris kode pertama membuka `.docx` yang ingin Anda ubah. Ganti `YOUR_DIRECTORY` dengan jalur sebenarnya di mesin Anda. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Apa yang terjadi?** `Document` mengurai file, membangun DOM internal, dan membuat setiap paragraf, tabel, serta gambar dapat diakses. Jika file tidak ditemukan, Aspose melempar `FileNotFoundException` yang jelas, yang dapat Anda tangkap untuk UI yang lebih ramah. + +--- + +## Langkah 3: Konfigurasikan Markdown Save Options dengan Callback Penyimpanan Sumber Daya + +Di sinilah keajaiban **cara menggunakan callback** berperan. Callback memungkinkan Anda memutuskan ke mana setiap gambar yang diekstrak disimpan. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Mengapa callback?** Secara default Aspose akan menyematkan gambar sebagai string base‑64 di dalam markdown—sangat merepotkan untuk kontrol versi. Callback memberi Anda kontrol penuh atas nama file dan struktur folder. + +--- + +## Langkah 4: Simpan Dokumen sebagai Markdown + +Sekarang kita benar‑benar menghasilkan file `.md`. Semua gambar akan diserahkan ke callback yang didefinisikan pada langkah berikutnya. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Jika semuanya berjalan lancar, Anda akan menemukan `Document.md` di folder target dan sub‑folder bernama `Resources` yang berisi setiap gambar yang diekstrak dari file Word asli. + +--- + +## Langkah 5: Implementasikan Callback yang Menyimpan Setiap Gambar yang Diekstrak + +Berikut implementasi lengkap `MyResourceSaver`. Ia membuat direktori `Resources` (jika belum ada), membangun nama file unik untuk setiap gambar, dan menulis aliran gambar ke disk. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Penjelasan argumen:** +> - `args.Index` – penghitung berbasis nol yang menjamin keunikan. +> - `args.FileName` – nama file asli yang disarankan Aspose (sering seperti `image001.png`). +> - `args.Stream` – aliran output tempat byte gambar ditulis. +> - `args.KeepResourceStreamOpen` – diatur ke `false` sehingga Aspose secara otomatis menutup aliran, mencegah kebocoran handle file. + +--- + +## Contoh Kerja Lengkap + +Menggabungkan semuanya, berikut satu file yang dapat Anda salin‑tempel ke `Program.cs`. Ingat untuk mengganti `YOUR_DIRECTORY` dengan jalur absolut atau relatif yang sesuai dengan lingkungan Anda. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Output yang Diharapkan + +- `YOUR_DIRECTORY/Document.md` – file markdown dengan tautan gambar markdown standar, misalnya: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – berisi `img_0.png`, `img_1.jpg`, dll., sesuai urutan kemunculannya di dokumen Word asli. + +Menjalankan program akan mencetak konfirmasi ramah, memberi tahu Anda bahwa proses berhasil. + +--- + +## Pertanyaan yang Sering Diajukan (FAQ) + +### Bagaimana cara mengekstrak gambar dari Word tanpa kehilangan kualitas? + +Callback menulis aliran biner mentah langsung ke file, mempertahankan resolusi asli. Tidak ada konversi atau kompresi yang terjadi kecuali Anda menambahkan logika pemrosesan gambar sendiri di dalam `ResourceSaving`. + +### Bisakah saya mengubah format gambar (misalnya PNG → JPEG) saat ekstraksi? + +Tentu saja. Di dalam `ResourceSaving` Anda dapat memeriksa `args.FileName` atau `args.Stream`, memuat gambar dengan `System.Drawing` atau `ImageSharp`, lalu meng‑encode‑nya kembali sebelum menulis. Ingat untuk memperbarui ekstensi tautan markdown yang sesuai. + +### Bagaimana jika saya ingin file markdown merujuk ke CDN alih‑alih folder lokal? + +Ubah callback untuk menambahkan URL dasar ke tautan markdown. Anda dapat melakukannya dengan mengatur `args.FileName` menjadi URL lengkap setelah Anda mengunggah gambar ke CDN. + +### Apakah ini bekerja dengan tabel, catatan kaki, atau fitur Word lanjutan lainnya? + +Ya. Aspose.Words menerjemahkan sebagian besar konstruksi Word ke ekivalen markdown. Tabel menjadi tabel markdown, catatan kaki menjadi tautan referensi, dan bahkan daftar bersarang ditangani dengan baik. Jika ada yang tampak aneh, periksa catatan rilis terbaru—Aspose terus meningkatkan akurasi konversi. + +### Bagaimana cara mengonversi docx ke markdown dalam pipeline CI/CD? + +Cukup tambahkan file `.exe` yang telah dikompilasi ke langkah build Anda, arahkan ke artefak `.docx` yang dihasilkan, dan dorong folder `.md` serta `Resources/` ke repositori situs statis Anda. Karena proses ini sepenuhnya deterministik, ia bekerja dengan baik di lingkungan otomatis. + +--- + +## Penutup + +Kami baru saja menunjukkan cara **membuat markdown dari Word** menggunakan Aspose.Words, membahas seluruh alur kerja **mengonversi docx ke markdown**, dan memperlihatkan cara praktis **mengekstrak gambar dari Word** dengan implementasi **cara menggunakan callback** khusus. Hasilnya adalah file markdown bersih yang dipasangkan dengan folder gambar asli—sempurna untuk situs dokumentasi, blog statis, atau alur kerja apa pun yang lebih menyukai format teks biasa. + +Langkah selanjutnya yang dapat Anda pertimbangkan: + +- **Pemrosesan batch** beberapa file `.docx` dalam satu folder (loop melalui `Directory.GetFiles`). +- **Skema penamaan khusus** untuk gambar (misalnya menggunakan teks caption asli). +- **Post‑processing** markdown untuk mengganti tautan gambar dengan URL CDN. +- Menjelajahi **format ekspor Aspose lainnya** seperti HTML, PDF, atau EPUB untuk penerbitan multi‑saluran. + +Ada pertanyaan lebih lanjut atau file Word yang sulit dikonversi? Tinggalkan komentar di bawah, dan mari kita selesaikan bersama. Selamat coding, dan nikmati kemudahan mengubah Word menjadi markdown! + +--- + +![Diagram yang menunjukkan proses konversi Word ke Markdown](image.png "Buat markdown dari diagram word") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/indonesian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/indonesian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..58859ba543 --- /dev/null +++ b/words/indonesian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,266 @@ +--- +category: general +date: 2026-03-27 +description: Cara mengekspor LaTeX dari DOCX menggunakan Aspose.Words. Pelajari cara + mengonversi DOCX ke Markdown, mengatur DPI, dan mengaktifkan pemulihan di C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: id +og_description: Cara mengekspor LaTeX dari DOCX menggunakan Aspose.Words. Tutorial + ini menunjukkan konversi langkah demi langkah ke Markdown, kontrol DPI, dan mode + pemulihan. +og_title: Cara Mengekspor LaTeX dari DOCX – Konversi ke Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Cara Mengekspor LaTeX dari DOCX – Konversi ke Markdown +url: /id/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara Mengekspor LaTeX dari DOCX – Mengonversi ke Markdown + +Pernah bertanya-tanya **how to export LaTeX** dari file DOCX tanpa kehilangan keindahan persamaan Anda? Anda tidak sendirian. Menurut pengalaman saya, titik sakit terbesar adalah mendapatkan objek OfficeMath tersebut ke dalam format yang bersih dan dapat dipindahkan untuk generator situs statis atau blog ilmiah. + +Dalam panduan ini kami akan menjelaskan cara mengonversi DOCX ke Markdown dengan Aspose.Words, sekaligus menunjukkan **how to set DPI**, **how to enable recovery**, dan beberapa trik berguna untuk pipeline yang kokoh. Pada akhir panduan Anda akan memiliki satu program C# yang menghasilkan file Markdown dengan persamaan LaTeX, gambar resolusi tinggi, dan penanganan hyperlink yang tepat. + +## Apa yang Anda Butuhkan + +- **.NET 6+** (atau .NET Framework 4.7.2 – API berfungsi sama) +- **Aspose.Words for .NET** (versi stabil terbaru per Maret 2026) +- File DOCX yang berisi persamaan, gambar, dan tautan +- Visual Studio, VS Code, atau editor apa pun yang Anda suka + +Tidak ada paket NuGet tambahan yang diperlukan selain Aspose.Words, tetapi pastikan Anda memiliki lisensi yang valid jika tidak menggunakan versi percobaan. + +## Langkah 1 – Muat DOCX dengan Mode Pemulihan Ketat + +Sebelum kita berpikir tentang mengekspor, kita harus memastikan dokumen sumber tidak menyembunyikan korupsi. Di sinilah **how to enable recovery** berperan. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Mengapa pemulihan ketat?** +Jika Anda membiarkan Aspose memperbaiki masalah secara diam‑diam, Anda mungkin akan mendapatkan paragraf yang hilang atau gambar yang rusak—sesuatu yang tidak diinginkan siapa pun saat mengekspor LaTeX. Dengan gagal cepat, Anda dapat menangkap masalah lebih awal dan memutuskan apakah memperbaiki DOCX sumber atau mencatat masalah untuk nanti. + +### Tips Pro +Bungkus pemuatan dalam try/catch dan catat `DocumentLoadingException`. Dengan cara itu pipeline CI Anda dapat menandai file bermasalah tanpa menghentikan seluruh proses build. + +## Langkah 2 – Siapkan Opsi Ekspor Markdown + +Sekarang dokumen sudah aman di memori, kami mengonfigurasi cara penyimpanannya. Ini adalah inti dari **how to export latex** dan juga mencakup **how to set DPI** untuk gambar yang disematkan. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Apa yang dilakukan setiap opsi** + +| Option | Alasan | Keterkaitan dengan Kata Kunci | +|--------|--------|-------------------------------| +| `OfficeMathExportMode = LaTeX` | Langsung menjawab **how to export latex** dari persamaan. | Primary keyword | +| `ImageResolution = 300` | Mengontrol kualitas gambar – jawaban untuk **how to set dpi**. | Secondary | +| `ResourceSavingCallback` | Menyimpan file yang disematkan ke disk, kebutuhan umum saat **convert docx to markdown**. | Secondary | +| `EmptyParagraphExportMode` | Menjamin output Markdown yang bersih, mencegah tag HTML yang terselip. | Improves overall conversion quality | +| `LinkExportMode = AsReference` | Membuat tautan mudah dibaca dan diedit, nilai tambah lain untuk **convert docx to markdown**. | + +## Langkah 3 – Implementasikan Penyimpan Sumber Daya Kustom (Opsional tapi Berguna) + +Saat Anda mengonversi DOCX ke Markdown, gambar dan sumber daya biner lainnya memerlukan tempat di sistem file. Aspose memungkinkan Anda mengontrolnya dengan `IResourceSavingCallback`. Potongan kode di atas sudah menunjukkan implementasi minimal, tetapi mari kita uraikan: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Mengapa repot?** +Jika Anda melewatkan langkah ini, Aspose akan menyematkan gambar sebagai string base‑64, yang memperbesar ukuran file Markdown dan membuat kontrol versi menjadi menyakitkan. Dengan menyimpan sumber daya ke folder terpisah, Anda menjaga Markdown tetap ringan dan membuatnya ramah untuk generator situs statis seperti Hugo atau Jekyll. + +## Langkah 4 – Simpan Dokumen sebagai Markdown + +Semua pekerjaan berat sudah selesai. Satu baris kini menulis file akhir. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Buka `output.md` dan Anda akan melihat: + +- Persamaan ditampilkan sebagai blok LaTeX `$…$` +- Gambar direferensikan sebagai `![Alt text](resources/image001.png)` dengan resolusi 300 dpi +- Tautan diubah menjadi gaya referensi: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Itulah seluruh proses **how to convert docx** secara singkat. + +## Pertanyaan Umum & Kasus Tepi + +### 1️⃣ Bagaimana jika DOCX berisi objek yang tidak didukung? +Aspose.Words akan melempar `FeatureNotSupportedException`. Karena kami menggunakan **how to enable recovery** dalam mode ketat, pengecualian muncul segera. Anda dapat: + +- Mengubah `RecoveryMode` menjadi `RecoveryMode.Default` untuk konversi upaya terbaik, **atau** +- Pra‑proses DOCX (mis., hapus SmartArt yang tidak didukung) sebelum menjalankan konverter. + +### 2️⃣ Bisakah saya mengubah DPI per gambar? +Pengaturan `ImageResolution` bersifat global. Untuk kontrol per‑gambar, implementasikan `ImageSavingCallback` kustom yang mirip dengan `MyResourceSaver` dan sesuaikan `args.ImageResolution` berdasarkan `args.ImageFileName` atau metadata. + +### 3️⃣ Bagaimana cara menyematkan LaTeX yang dihasilkan di situs Jekyll? +Dukungan MathJax bawaan Jekyll berfungsi langsung. Pastikan tata letak Anda menyertakan skrip MathJax dan blok LaTeX dibungkus dengan `$$` untuk persamaan tampilan atau `$` untuk inline. + +### 4️⃣ Apakah ini kompatibel dengan .NET Core di Linux? +Tentu saja. Aspose.Words bersifat lintas‑platform. Pastikan jalur `YOUR_DIRECTORY` mengikuti konvensi Linux (mis., `/home/user/docs`). + +## Contoh Kerja Lengkap + +Di bawah ini adalah program siap salin‑tempel. Ganti `YOUR_DIRECTORY` dengan jalur sebenarnya di mesin Anda. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Output yang diharapkan** – buka `output.md` dan Anda akan melihat sesuatu seperti: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Jika Anda membuka file dalam pratinjau Markdown yang mendukung MathJax, integral akan dirender + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/indonesian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/indonesian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..28c9a3906b --- /dev/null +++ b/words/indonesian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Cara mengekspor LaTeX dari dokumen Word menggunakan Aspose.Words – mengonversi + DOCX ke Markdown dengan persamaan sebagai LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: id +og_description: Cara mengekspor LaTeX dari dokumen Word dijelaskan di kalimat pertama, + yang menunjukkan cara mengonversi DOCX ke Markdown dengan persamaan sebagai LaTeX. +og_title: Cara Mengekspor LaTeX dari Word – Panduan Lengkap +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Cara Mengekspor LaTeX dari Word – Mengonversi DOCX ke Markdown +url: /id/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara Mengekspor LaTeX dari Word – Mengonversi DOCX ke Markdown + +Pernah bertanya-tanya **cara mengekspor LaTeX** dari file Word tanpa berakhir dengan sekumpulan PNG? Anda bukan satu-satunya; para pengembang sering menemui kendala ini ketika mereka membutuhkan persamaan yang bersih dan dapat diedit untuk situs statis atau blog ilmiah. Kabar baiknya? Dengan Aspose.Words Anda dapat **mengonversi Word ke Markdown** dan mempertahankan setiap objek OfficeMath sebagai LaTeX asli—tanpa perlu pemrosesan lanjutan. + +Pada tutorial ini kami akan membahas seluruh proses **menyimpan dokumen Word sebagai Markdown** sambil **mengekspor persamaan sebagai LaTeX**. Pada akhir tutorial Anda akan memiliki potongan kode C# yang dapat dijalankan, penjelasan jelas tentang setiap opsi, dan tip untuk menangani kasus tepi seperti formula kompleks atau konten campuran. Tanpa alat eksternal, hanya satu paket NuGet dan beberapa baris kode. + +## Apa yang Anda Butuhkan + +- .NET 6+ (atau .NET Framework 4.7.2 ke atas) – runtime terbaru bekerja paling baik. +- Visual Studio 2022 atau editor apa pun yang dapat mengompilasi proyek C#. +- Lisensi Aspose.Words untuk .NET (versi percobaan gratis dapat digunakan untuk percobaan). +- File DOCX yang berisi setidaknya satu persamaan (OfficeMath). + +Jika Anda sudah memiliki semua itu, bagus—mari kita mulai. + +## Cara Mengekspor LaTeX dari Word – Ikhtisar + +Berikut adalah gambaran tingkat tinggi dari langkah‑langkah yang terlibat: + +1. **Install** paket NuGet Aspose.Words. +2. **Load** file sumber `.docx` yang berisi persamaan Anda. +3. **Configure** `MarkdownSaveOptions` sehingga `OfficeMathExportMode` diatur ke `LaTeX`. +4. **Save** dokumen sebagai file `.md`. +5. **Verify** bahwa Markdown yang dihasilkan berisi blok LaTeX (`$$…$$`). + +Setiap langkah ini dijelaskan secara detail di bagian-bagian berikut. + +![Diagram yang menunjukkan alur dari DOCX ke Markdown dengan persamaan LaTeX](how-to-export-latex.png){alt="Diagram cara mengekspor latex dari Word"} + +## Langkah 1 – Instal Aspose.Words untuk .NET (konversi word ke markdown) + +Pertama-tama: Anda memerlukan pustaka yang benar‑benar melakukan pekerjaan berat. Buka terminal Anda (atau Package Manager Console) dan jalankan: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Tip pro:** Jika Anda menggunakan Visual Studio, klik kanan proyek → *Manage NuGet Packages* → cari “Aspose.Words” dan instal versi stabil terbaru. + +Mengapa ini penting: Aspose.Words mengabstraksi format Open XML, memberi Anda API yang bersih untuk memanipulasi dokumen Word tanpa harus berurusan dengan XML tingkat rendah. Ia juga dilengkapi dengan dukungan bawaan untuk mengonversi OfficeMath ke LaTeX, yang merupakan inti dari kebutuhan kami untuk **mengekspor persamaan sebagai LaTeX**. + +## Langkah 2 – Muat DOCX (cara mengonversi docx) + +Setelah paket terpasang, muat file yang ingin Anda transformasikan. Ganti `YOUR_DIRECTORY` dengan jalur tempat file `.docx` Anda berada: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Mengapa memuatnya dengan cara ini?** Konstruktor `Document` mengurai seluruh file menjadi model objek, memberi Anda akses langsung ke paragraf, tabel, dan—yang paling penting—objek OfficeMath. Jika file tidak ada atau rusak, Aspose akan melempar `FileNotFoundException` yang deskriptif, yang dapat Anda tangkap untuk penanganan error yang elegan. + +## Langkah 3 – Konfigurasi MarkdownSaveOptions (ekspor persamaan sebagai latex) + +Keajaiban terjadi pada objek `MarkdownSaveOptions`. Secara default Aspose akan merender persamaan sebagai gambar PNG, tetapi kita menginginkan LaTeX. Atur `OfficeMathExportMode` ke `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Catatan singkat tentang flag opsional: `ExportImagesAsBase64` memberi tahu Aspose untuk tidak menyematkan data biner, sehingga Markdown tetap bersih. `ExportHeadersFooters` memastikan Anda tidak kehilangan konteks yang mungkin berada di bagian tersebut—berguna ketika header berisi judul atau nama penulis. + +## Langkah 4 – Simpan Dokumen (simpan word sebagai markdown) + +Akhirnya, tulis konten yang telah diubah ke file `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Setelah baris ini dijalankan, Anda akan menemukan `output.md` di samping file sumber Anda. Buka di editor teks apa pun dan Anda akan melihat blok LaTeX yang terlihat seperti ini: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Itulah bagian **simpan word sebagai markdown** yang selesai—tidak diperlukan langkah konversi tambahan. + +## Langkah 5 – Verifikasi Hasil (ekspor persamaan sebagai latex) + +Mudah untuk mengabaikan verifikasi, tetapi pemeriksaan cepat dapat menghemat jam kerja nanti. Jalankan skrip sederhana yang membaca file yang dihasilkan dan mencetak blok LaTeX pertama: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Jika Anda melihat `First LaTeX block: $$ … $$` tercetak, Anda telah berhasil **mengekspor LaTeX** dari Word. Jika tidak, periksa kembali apakah dokumen sumber Anda benar‑benar berisi objek OfficeMath; persamaan teks biasa tidak akan dikonversi. + +## Menangani Kasus Tepi Umum + +| Skenario | Hal yang Perlu Diperhatikan | Perbaikan yang Disarankan | +|----------|-----------------------------|---------------------------| +| **Gambar & persamaan campuran** | Aspose mungkin masih menyematkan gambar untuk grafik non‑OfficeMath. | Atur `ExportImagesAsBase64 = false` dan simpan gambar sebagai file eksternal, lalu referensikan secara manual di Markdown. | +| **Persamaan bersarang kompleks** | Penumpukan yang sangat dalam dapat menghasilkan LaTeX yang memerlukan penyesuaian manual. | Lakukan post‑process pada blok dengan format LaTeX (mis., `latexindent`) atau sesuaikan `mdOptions` → `ExportMathAsDisplay = true`. | +| **Dokumen besar** | Penggunaan memori melonjak saat memuat file `.docx` yang sangat besar. | Gunakan `LoadOptions` dengan `LoadFormat.Docx` dan aktifkan streaming `LoadOptions.LoadFormat` jika tersedia. | +| **Lisensi hilang** | Versi percobaan gratis menambahkan komentar watermark pada output. | Terapkan lisensi yang valid melalui `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Tip ini menjaga alur kerja Anda tetap kuat, terutama ketika Anda **mengonversi word ke markdown** dalam pipeline produksi. + +## Contoh Kerja Lengkap (Semua Langkah dalam Satu File) + +Berikut adalah aplikasi konsol mandiri yang dapat Anda salin‑tempel ke proyek .NET baru dan jalankan segera. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Jalankan program, buka `output.md`, dan Anda akan melihat persamaan Anda ditampilkan sebagai LaTeX yang bersih. Itu adalah jawaban lengkap untuk **cara mengekspor latex** dari dokumen Word. + +## Kesimpulan + +Kami telah membahas **cara mengekspor LaTeX** dari Word langkah demi langkah, menunjukkan cara **mengonversi Word ke markdown**, **menyimpan word sebagai markdown**, dan **mengekspor persamaan sebagai LaTeX** menggunakan Aspose.Words. Ide dasarnya sederhana: muat DOCX, sesuaikan `MarkdownSaveOptions`, dan biarkan pustaka melakukan pekerjaan berat. + +Jika Anda siap mengotomatisasi pipeline dokumentasi, coba rangkaikan kode ini dengan generator situs statis seperti Hugo atau Jekyll—cukup dorong file `.md` yang dihasilkan ke repositori Anda dan biarkan situs dibangun kembali. Untuk bacaan lebih lanjut, jelajahi panduan “Export to LaTeX” dari Aspose, bereksperimen dengan `HtmlSaveOptions` untuk pratinjau web, atau selami API `DocumentVisitor` untuk transformasi kustom. + +Ada pertanyaan tentang kasus tepi, lisensi, atau mengintegrasikan ini ke CI/CD? Tinggalkan komentar di bawah, dan selamat coding! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/indonesian/net/programming-with-pdfsaveoptions/_index.md b/words/indonesian/net/programming-with-pdfsaveoptions/_index.md index 967ed3b1ec..ecee59632a 100644 --- a/words/indonesian/net/programming-with-pdfsaveoptions/_index.md +++ b/words/indonesian/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ Bahasa Indonesia: --- | --- Bahasa Indonesia: | [Perbarui Properti Terakhir Dicetak dalam Dokumen PDF](./update-last-printed-property/) | Pelajari cara memperbarui properti cetak terakhir dalam dokumen PDF menggunakan Aspose.Words untuk .NET dengan panduan langkah demi langkah kami. Bahasa Indonesia: | [Render 3D DML 3D Effects dalam Dokumen PDF](./dml-3deffects-rendering/) | Pelajari cara membuat efek DML 3D yang menakjubkan dalam dokumen PDF menggunakan Aspose.Words untuk .NET dengan panduan langkah demi langkah yang komprehensif ini. Bahasa Indonesia: | [Interpolasi Gambar dalam Dokumen PDF](./interpolate-images/) | Pelajari cara menginterpolasi gambar dalam dokumen PDF menggunakan Aspose.Words untuk .NET dengan panduan langkah demi langkah kami. Tingkatkan kualitas gambar PDF Anda dengan mudah. | - +| [Cara Menyimpan PDF dari DOCX dengan Aspose.Words – Panduan Langkah demi Langkah](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Pelajari cara mengonversi file DOCX menjadi PDF menggunakan Aspose.Words dengan panduan langkah demi langkah yang mudah diikuti. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/indonesian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/indonesian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..4db8647dba --- /dev/null +++ b/words/indonesian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-03-27 +description: Pelajari cara menyimpan PDF dari file DOCX menggunakan Aspose.Words. + Termasuk mengonversi DOCX ke PDF, menyimpan PDF dengan opsi, dan menangani bentuk + mengambang. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: id +og_description: Cara menyimpan PDF dari file DOCX menggunakan Aspose.Words. Panduan + ini menunjukkan cara mengonversi DOCX ke PDF, menyimpan PDF dengan opsi, dan menangani + bentuk mengambang. +og_title: Cara Menyimpan PDF dari DOCX – Tutorial Lengkap Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Cara Menyimpan PDF dari DOCX dengan Aspose.Words – Panduan Langkah demi Langkah +url: /id/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara Menyimpan PDF dari DOCX dengan Aspose.Words – Tutorial Lengkap + +Pernah bertanya-tanya **cara menyimpan PDF** dari dokumen Word tanpa kehilangan tata letak bentuk mengambang? Anda bukan satu-satunya. Dalam banyak proyek—generator faktur, pengekspor laporan, atau pengarsip dokumen sederhana—para pengembang membutuhkan cara yang andal untuk mengonversi DOCX ke PDF sambil mempertahankan tampilan persis seperti di Word. + +Dalam tutorial ini kami akan membahas cara mengonversi file DOCX ke PDF **menggunakan Aspose.Words untuk .NET**, menunjukkan **cara mengonversi docx ke pdf** dengan opsi penyimpanan khusus, dan menjelaskan mengapa flag `ExportFloatingShapesAsInlineTag` penting. Pada akhir tutorial Anda akan memiliki potongan kode siap‑jalankan yang menyimpan PDF dengan opsi yang dapat Anda kontrol. + +## Apa yang Akan Anda Pelajari + +- Langkah-langkah tepat untuk **mengonversi word document pdf** dengan Aspose.Words. +- Cara mengonfigurasi `PdfSaveOptions` agar memperlakukan bentuk mengambang sebagai tag inline. +- Kesulitan umum saat menangani objek mengambang dan cara menghindarinya. +- Program C# lengkap yang dapat dijalankan dan dapat Anda masukkan ke proyek .NET mana pun. + +> **Prasyarat:** Anda memerlukan lisensi Aspose.Words untuk .NET (atau evaluasi gratis) dan lingkungan pengembangan .NET (Visual Studio, Rider, atau `dotnet` CLI). + +## Langkah 1: Siapkan Proyek dan Tambahkan Aspose.Words + +Pertama, buat aplikasi console baru (atau tambahkan ke yang sudah ada) dan referensikan paket NuGet Aspose.Words. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Tip pro:** Jika Anda berada di server CI, kunci versi paket (`Aspose.Words --version 24.10`) untuk memastikan build yang dapat direproduksi. + +## Langkah 2: Muat DOCX yang Mengandung Bentuk Mengambang + +Gambar mengambang, kotak teks, atau SmartArt dapat menyebabkan pergeseran tata letak saat dikonversi. Memuat dokumen cukup sederhana, tetapi kami juga akan memverifikasi bahwa file ada untuk mencegah `FileNotFoundException` pada runtime. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Perhatikan pernyataan `Console.WriteLine`—mereka memberikan umpan balik cepat saat Anda menjalankan aplikasi dari terminal. + +## Langkah 3: Konfigurasikan Opsi Penyimpanan PDF (Simpan PDF dengan Opsi) + +Inilah tempat keajaiban terjadi. Secara default Aspose.Words berusaha mempertahankan objek mengambang sebagaimana muncul, yang dapat merusak tata letak pada PDF yang dihasilkan. Menetapkan `ExportFloatingShapesAsInlineTag` ke `true` memberi tahu perpustakaan untuk memperlakukan bentuk tersebut sebagai tag inline, memastikan mereka tetap terikat pada teks di sekitarnya. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Mengapa ini penting? Bayangkan sebuah kotak teks yang melayang di atas paragraf. Tanpa konversi tag inline, PDF mungkin menurunkan paragraf atau memotong kotak sepenuhnya. Flag ini menjaga hubungan visual tetap utuh—detail halus namun krusial untuk laporan profesional. + +## Langkah 4: Simpan Dokumen sebagai PDF + +Sekarang kita benar‑benar menulis file PDF. Metode `Save` menerima jalur output serta opsi yang baru saja kita atur. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Menjalankan program akan menghasilkan `output.pdf` di folder yang sama dengan DOCX sumber Anda. Buka dengan penampil PDF apa pun dan Anda akan melihat semua bentuk mengambang ditampilkan persis di tempatnya. + +## Contoh Kerja Lengkap + +Berikut seluruh program dalam satu blok. Salin‑tempel ke `Program.cs` (atau file C# apa pun) dan tekan **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Hasil yang Diharapkan + +- **File dibuat:** `output.pdf` di direktori target. +- **Kesetiaan tata letak:** Bentuk mengambang (gambar, kotak teks, SmartArt) muncul inline dengan teks di sekitarnya. +- **Tidak ada pengecualian:** Program keluar dengan lancar, mencetak pesan status ke konsol. + +## Pertanyaan yang Sering Diajukan & Kasus Tepi + +| Pertanyaan | Jawaban | +|----------|--------| +| **Bagaimana jika saya membutuhkan kualitas gambar yang lebih tinggi?** | Set `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Bisakah saya mengonversi beberapa file DOCX sekaligus?** | Bungkus logika pemuatan/penyimpanan dalam loop `foreach (var file in Directory.GetFiles(..., "*.docx"))`. Ingat untuk menggunakan satu instance `PdfSaveOptions` untuk kinerja. | +| **Apakah ini bekerja dengan .NET Core?** | Tentu saja. Aspose.Words 24.x mendukung .NET Standard 2.0+, sehingga Anda dapat menjalankan kode yang sama di Windows, Linux, atau macOS. | +| **Bagaimana dengan file DOCX yang dilindungi password?** | Muat dengan `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. `PdfSaveOptions` yang sama diterapkan saat menyimpan. | +| **Apakah konversi tag‑inline aman untuk tabel yang kompleks?** | Secara umum ya, tetapi tata letak tabel yang sangat rumit dengan bentuk yang tumpang tindih mungkin masih memerlukan penyesuaian manual. Uji sampel representatif sebelum migrasi massal. | + +## Tips untuk Proyek Dunia Nyata + +- **Log, jangan hanya `Console.WriteLine`** – Di produksi, ganti output konsol dengan kerangka logging (Serilog, NLog) untuk menangkap error. +- **Bebaskan sumber daya** – `Document` mengimplementasikan `IDisposable`. Bungkus dalam blok `using` jika Anda memproses banyak file untuk membebaskan memori dengan cepat. +- **Validasi PDF** – Gunakan validator PDF (misalnya pemeriksa kepatuhan PDF/A) jika Anda memerlukan PDF tingkat arsip. +- **Pemrosesan paralel** – Untuk beban kerja besar, pertimbangkan `Parallel.ForEach` dengan `PdfSaveOptions` yang thread‑safe (kloning per thread) untuk mempercepat konversi. + +## Kesimpulan + +Kami telah membahas **cara menyimpan PDF** dari file DOCX menggunakan Aspose.Words, mendemonstrasikan **cara mengonversi docx ke pdf** dengan opsi khusus, dan menjelaskan dampak `ExportFloatingShapesAsInlineTag`. Contoh lengkap yang dapat dijalankan menunjukkan Anda dapat **mengonversi word document pdf** dalam hanya beberapa baris kode, dan kini Anda tahu cara **menyimpan pdf dengan opsi** yang sesuai dengan kebutuhan kualitas dan kepatuhan proyek Anda. + +Siap untuk tantangan berikutnya? Cobalah mengekspor ke format lain (mis., HTML, EPUB) dengan `document.Save("output.html")`, atau bereksperimen dengan kepatuhan PDF/A untuk pengarsipan jangka panjang. Prinsip yang sama—muat, konfigurasikan opsi, simpan—berlaku di semua kasus. + +Selamat coding, dan semoga PDF Anda selalu terlihat persis seperti yang Anda inginkan! + +![Diagram yang menggambarkan bagaimana file DOCX dimuat, opsi diterapkan, dan PDF dihasilkan – cara menyimpan pdf](https://example.com/images/how-to-save-pdf-diagram.png "diagram cara menyimpan pdf") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/indonesian/net/programming-with-shapes/_index.md b/words/indonesian/net/programming-with-shapes/_index.md index 21903e0eef..bffe8858ec 100644 --- a/words/indonesian/net/programming-with-shapes/_index.md +++ b/words/indonesian/net/programming-with-shapes/_index.md @@ -24,16 +24,17 @@ Dengan menggunakan Aspose.Words untuk .NET dan mengikuti tutorial ini, Anda akan ## Tutorial | Judul | Deskripsi | Bahasa Indonesia: --- | --- Bahasa Indonesia: -| [Tambahkan Bentuk Grup](./add-group-shape/) | Pelajari cara menambahkan bentuk grup ke dokumen Word menggunakan Aspose.Words untuk .NET dengan tutorial langkah demi langkah yang komprehensif ini. Bahasa Indonesia: -| [Sisipkan Bentuk](./insert-shape/) | Pelajari cara menyisipkan dan memanipulasi bentuk dalam dokumen Word menggunakan Aspose.Words untuk .NET dengan panduan langkah demi langkah kami. Bahasa Indonesia: -| [Rasio Aspek Terkunci](./aspect-ratio-locked/) | Pelajari cara mengunci rasio aspek bentuk dalam dokumen Word menggunakan Aspose.Words untuk .NET. Ikuti panduan langkah demi langkah ini untuk menjaga gambar dan bentuk Anda tetap proporsional. Bahasa Indonesia: -| [Tata Letak Dalam Sel](./layout-in-cell/) | Pelajari cara mengatur tata letak dalam sel menggunakan Aspose.Words untuk .NET dengan panduan lengkap ini. Sempurna bagi pengembang yang ingin menyesuaikan dokumen Word. Bahasa Indonesia: -| [Tambahkan Sudut yang Dipotong](./add-corners-snipped/) | Pelajari cara menambahkan bentuk potongan sudut ke dokumen Word Anda menggunakan Aspose.Words untuk .NET. Panduan langkah demi langkah ini memastikan Anda dapat menyempurnakan dokumen Anda dengan mudah. Bahasa Indonesia: -| [Dapatkan Titik Batas Bentuk Aktual](./get-actual-shape-bounds-points/) | Temukan cara mendapatkan titik batas bentuk yang sebenarnya dalam dokumen Word menggunakan Aspose.Words untuk .NET. Pelajari manipulasi bentuk yang tepat dengan panduan terperinci ini. Bahasa Indonesia: -| [Jangkar Vertikal](./vertical-anchor/) | Pelajari cara mengatur posisi jangkar vertikal untuk kotak teks dalam dokumen Word menggunakan Aspose.Words untuk .NET. Panduan langkah demi langkah yang mudah disertakan.Bahasa Indonesia: -| [Deteksi Bentuk Seni Cerdas](./detect-smart-art-shape/) | Pelajari cara mendeteksi bentuk SmartArt dalam dokumen Word menggunakan Aspose.Words untuk .NET dengan panduan lengkap ini. Sempurna untuk mengotomatiskan alur kerja dokumen Anda. Bahasa Indonesia: +| [Tambahkan Bentuk Grup](./add-group-shape/) | Pelajari cara menambahkan bentuk grup ke dokumen Word menggunakan Aspose.Words untuk .NET dengan tutorial langkah demi langkah yang komprehensif ini. Bahasa Indonesia: | +| [Sisipkan Bentuk](./insert-shape/) | Pelajari cara menyisipkan dan memanipulasi bentuk dalam dokumen Word menggunakan Aspose.Words untuk .NET dengan panduan langkah demi langkah kami. Bahasa Indonesia: | +| [Rasio Aspek Terkunci](./aspect-ratio-locked/) | Pelajari cara mengunci rasio aspek bentuk dalam dokumen Word menggunakan Aspose.Words untuk .NET. Ikuti panduan langkah demi langkah ini untuk menjaga gambar dan bentuk Anda tetap proporsional. Bahasa Indonesia: | +| [Tata Letak Dalam Sel](./layout-in-cell/) | Pelajari cara mengatur tata letak dalam sel menggunakan Aspose.Words untuk .NET dengan panduan lengkap ini. Sempurna bagi pengembang yang ingin menyesuaikan dokumen Word. Bahasa Indonesia: | +| [Tambahkan Sudut yang Dipotong](./add-corners-snipped/) | Pelajari cara menambahkan bentuk potongan sudut ke dokumen Word Anda menggunakan Aspose.Words untuk .NET. Panduan langkah demi langkah ini memastikan Anda dapat menyempurnakan dokumen Anda dengan mudah. Bahasa Indonesia: | +| [Dapatkan Titik Batas Bentuk Aktual](./get-actual-shape-bounds-points/) | Temukan cara mendapatkan titik batas bentuk yang sebenarnya dalam dokumen Word menggunakan Aspose.Words untuk .NET. Pelajari manipulasi bentuk yang tepat dengan panduan terperinci ini. Bahasa Indonesia: | +| [Jangkar Vertikal](./vertical-anchor/) | Pelajari cara mengatur posisi jangkar vertikal untuk kotak teks dalam dokumen Word menggunakan Aspose.Words untuk .NET. Panduan langkah demi langkah yang mudah disertakan.Bahasa Indonesia: | +| [Deteksi Bentuk Seni Cerdas](./detect-smart-art-shape/) | Pelajari cara mendeteksi bentuk SmartArt dalam dokumen Word menggunakan Aspose.Words untuk .NET dengan panduan lengkap ini. Sempurna untuk mengotomatiskan alur kerja dokumen Anda. Bahasa Indonesia: | | [Perbarui Gambar Seni Cerdas](./update-smart-art-drawing/) | Pelajari cara memperbarui gambar Smart Art dalam dokumen Word menggunakan Aspose.Words untuk .NET dengan panduan langkah demi langkah ini. Pastikan visual Anda selalu akurat. | | [Buat Bentuk Persegi Panjang di Word dengan Aspose.Words – Panduan langkah demi langkah](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Pelajari cara membuat bentuk persegi panjang di dokumen Word menggunakan Aspose.Words dengan panduan langkah demi langkah. | +| [Buat Dokumen Word C# – Tambahkan Bentuk dengan Bayangan](./create-word-document-c-add-shape-with-shadow/) | Pelajari cara menambahkan bentuk dengan efek bayangan ke dokumen Word menggunakan Aspose.Words untuk .NET dalam C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/indonesian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/indonesian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..f0bd8f7e64 --- /dev/null +++ b/words/indonesian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,203 @@ +--- +category: general +date: 2026-03-27 +description: Buat dokumen Word dengan C# dan pelajari cara menambahkan bentuk, menerapkan + bayangan pada bentuk, serta mengatur jarak bayangan. Panduan langkah demi langkah + untuk Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: id +og_description: Buat dokumen Word C# dengan bentuk persegi panjang dan bayangan khusus. + Ikuti tutorial lengkap ini untuk mengatur jarak bayangan dan gaya. +og_title: Buat Dokumen Word C# – Tambahkan Bentuk dengan Bayangan +tags: +- Aspose.Words +- C# +- Document Automation +title: Buat Dokumen Word C# – Tambahkan Bentuk dengan Bayangan +url: /id/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Buat Dokumen Word C# – Tambahkan Bentuk dengan Bayangan + +Pernahkah Anda perlu **create word document c#** yang berisi persegi panjang bergaya rapi? Mungkin Anda sedang membuat templat laporan dan menginginkan bayangan drop‑shadow yang halus agar tata letak lebih menonjol. Dalam tutorial ini kami akan membahas tepat itu – cara menambahkan bentuk, menerapkan bayangan pada bentuk, dan bahkan menyesuaikan jarak bayangan menggunakan Aspose.Words. + +Kami akan memulai dengan dokumen kosong, menambahkan sebuah persegi panjang, memberikan bayangan preset, dan menyelesaikannya dengan menyimpan file. Pada akhir tutorial Anda akan memiliki .docx siap‑pakai yang dapat dibuka di Word dan melihat efeknya secara langsung. Tanpa alat eksternal, hanya kode C# murni. + +## Prasyarat + +- .NET 6 (atau .NET Framework terbaru) terpasang. +- Visual Studio 2022 atau VS Code dengan ekstensi C#. +- Paket NuGet Aspose.Words untuk .NET (`Aspose.Words` versi 23.12 atau lebih baru). + Anda dapat menambahkannya melalui Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +Itu saja – tidak diperlukan DLL tambahan atau interop COM. + +## Langkah 1: Inisialisasi Dokumen Baru dan Builder – *create word document c#* Dasar + +Pertama kita memerlukan objek `Document` yang mewakili file Word dan `DocumentBuilder` untuk mengeditnya. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Mengapa langkah ini penting:** Kelas `Document` adalah wadah untuk semua bagian Word (halaman, gaya, gambar). Builder adalah API tingkat tinggi yang menyembunyikan manipulasi node tingkat rendah, memudahkan untuk **create word document c#** tanpa harus berurusan langsung dengan XML. + +## Langkah 2: Sisipkan Bentuk Persegi Panjang – *how to create rectangle* + +Sekarang kita akan menempatkan persegi panjang pada halaman. Ukurannya dinyatakan dalam poin (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Tip pro:** Jika Anda membutuhkan bentuk lain, cukup ganti `ShapeType.Rectangle` dengan `ShapeType.Ellipse`, `ShapeType.Triangle`, dll. Kode yang sama bekerja untuk **how to add shape** dari jenis apa pun. + +## Langkah 3: Terapkan Bayangan Preset dan Sesuaikan – *apply shadow to shape* + +Aspose.Words menyediakan beberapa format bayangan preset. Kita akan menggunakan `Preset1` dan kemudian menyesuaikan jarak, blur, transparansi, dan warna. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Mengapa menyesuaikan bayangan?** Properti `Distance` mengontrol seberapa jauh bayangan berada dari persegi panjang – anggap sebagai “angkat” yang Anda lihat pada render 3‑D. Mengubah `BlurRadius` melunakkan tepi, sementara `Transparency` memungkinkan Anda menciptakan tampilan yang halus dan profesional. Ini memenuhi kebutuhan **set shadow distance** dan menunjukkan cara **apply shadow to shape** secara fleksibel. + +## Langkah 4: Simpan Dokumen – *create word document c#* Penyelesaian + +Akhirnya, tulis dokumen ke disk. Sesuaikan path ke folder yang Anda miliki hak menulis. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Buka file hasilnya di Microsoft Word, dan Anda akan melihat persegi panjang berwarna biru muda dengan bayangan abu‑abu lembut yang bergeser sebesar 5 pt. Itu bukti visual bahwa Anda berhasil **create word document c#** dengan bentuk yang bergaya. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="contoh create word document c# menampilkan persegi panjang dengan bayangan"} + +## Variasi Opsional & Kasus Tepi + +| Skenario | Apa yang Diubah | Mengapa Penting | +|----------|----------------|-----------------| +| **Gaya bayangan berbeda** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Memberikan tampilan yang lebih dramatis tanpa kode tambahan. | +| **Tanpa preset – bayangan khusus** | Hilangkan `Format` dan atur `OffsetX`, `OffsetY` secara manual. | Kontrol penuh atas arah dan kedalaman. | +| **Beberapa bentuk** | Panggil `builder.InsertShape` lagi sebelum menyimpan. | Berguna untuk templat kompleks dengan ikon, logo, dll. | +| **Kompatibilitas dengan versi Aspose lama** | Gunakan kelas `ShadowEffect` (tersedia di v20.x). | Memastikan kode Anda berjalan pada proyek lama. | +| **Menyimpan sebagai PDF** | `document.Save("ShadowShape.pdf");` | Rendering bayangan yang sama muncul pada output PDF. | + +> **Pertanyaan umum:** *Bagaimana jika bayangan tidak muncul di Word?* +> Pastikan Anda menggunakan versi terbaru Aspose.Words (≥ 22.9). Rilis lama memiliki dukungan bayangan terbatas. Juga pastikan dokumen dibuka dengan versi Word terbaru (2016+). + +## Contoh Lengkap yang Berfungsi + +Berikut adalah program lengkap yang siap disalin‑tempel. Program ini mencakup semua direktif `using`, komentar, dan penanganan error untuk pengalaman yang mulus. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Jalankan program, buka `C:\Temp\ShadowShape.docx`, dan Anda akan melihat persegi panjang dengan bayangan tepat seperti yang kami konfigurasikan. + +## Ringkasan & Langkah Selanjutnya + +- Anda kini tahu cara **create word document c#**, menyisipkan persegi panjang, dan **apply shadow to shape** dengan **set shadow distance** khusus. +- Contoh ini menggunakan Aspose.Words, yang menyembunyikan kompleksitas OpenXML dan menjamin rendering konsisten di semua versi Word. +- Ingin melangkah lebih jauh? Coba gabungkan beberapa bentuk, tambahkan teks di dalam persegi panjang, atau ekspor dokumen yang sama sebagai PDF untuk melihat bagaimana bayangan diterjemahkan. + +### Topik Terkait yang Mungkin Anda Jelajahi + +- **How to add shape** ke header/footer untuk branding. +- Menggunakan **Aspose.Words** untuk menyisipkan diagram dan tabel secara programatis. +- Menyesuaikan **shadow effects** pada gambar alih-alih bentuk vektor. +- Mengotomatiskan pembuatan dokumen massal untuk faktur atau sertifikat. + +Silakan bereksperimen, memecahkan kode, dan kemudian membangunnya kembali – itu cara tercepat untuk memahami konsep. Jika Anda mengalami kendala, tinggalkan komentar di bawah atau periksa dokumentasi resmi Aspose.Words untuk wawasan API yang lebih mendalam. + +Selamat coding, dan nikmati membuat file Word Anda tampak lebih rapi! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/indonesian/net/programming-with-txtsaveoptions/_index.md b/words/indonesian/net/programming-with-txtsaveoptions/_index.md index fc57b5423a..f740dcbb4d 100644 --- a/words/indonesian/net/programming-with-txtsaveoptions/_index.md +++ b/words/indonesian/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Bahasa Indonesia: --- | --- Bahasa Indonesia: | [Tambahkan Tanda Bidi di Dokumen Word](./add-bidi-marks/) | Pelajari cara menambahkan tanda dua arah (Bidi) dalam dokumen Word menggunakan Aspose.Words untuk .NET dengan panduan ini. Pastikan arah teks yang tepat untuk konten multibahasa. Bahasa Indonesia: | [Gunakan Karakter Tab Per Level Untuk Indentasi Daftar](./use-tab-character-per-level-for-list-indentation/) | Pelajari cara membuat daftar bertingkat dengan indentasi tab menggunakan Aspose.Words untuk .NET. Ikuti panduan ini untuk pemformatan daftar yang tepat dalam dokumen Anda. Bahasa Indonesia: | [Gunakan Karakter Spasi Per Level Untuk Indentasi Daftar](./use-space-character-per-level-for-list-indentation/) | Pelajari cara membuat daftar bertingkat dengan indentasi karakter spasi di Aspose.Words untuk .NET. Panduan langkah demi langkah untuk pemformatan dokumen yang tepat. | - +| [Simpan docx sebagai txt – Panduan Lengkap Mengekspor Persamaan Word ke LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Pelajari cara menyimpan file docx sebagai txt dan mengekspor persamaan Word ke format LaTeX dengan panduan lengkap ini. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/indonesian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/indonesian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..3d255cd795 --- /dev/null +++ b/words/indonesian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Simpan docx sebagai txt dengan Aspose.Words dan konversi Word ke LaTeX. + Pelajari cara mengekspor persamaan, mempertahankan teks biasa, dan mendapatkan markup + LaTeX dalam hitungan menit. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: id +og_description: Simpan docx sebagai txt menggunakan Aspose.Words. Panduan ini menunjukkan + cara mengonversi Word ke LaTeX, mengekspor persamaan, dan menjaga dokumen Anda tetap + teks biasa. +og_title: Simpan docx sebagai txt – Ekspor Persamaan Word ke LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Simpan docx sebagai txt – Panduan Lengkap Mengekspor Persamaan Word ke LaTeX +url: /id/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Simpan docx sebagai txt – Ekspor Persamaan Word ke LaTeX + +Pernah perlu **menyimpan docx sebagai txt** tetapi khawatir kehilangan persamaan matematika yang ada di dalam file Word Anda? Anda tidak sendirian. Dalam banyak alur kerja ilmiah, versi teks polos dari sebuah dokumen sangat diperlukan, namun Anda tetap ingin persamaan tetap ada sebagai markup LaTeX yang bersih. + +Dalam tutorial ini kami akan memandu Anda langkah demi langkah untuk **mengonversi Word ke LaTeX** menggunakan Aspose.Words untuk .NET, sehingga persamaan Anda diekspor dengan benar sementara sisanya menjadi teks polos yang rapi. Pada akhir tutorial Anda akan tahu cara **mengekspor persamaan ke LaTeX**, menjaga sisanya sebagai teks sederhana, dan menghindari jebakan umum yang sering membuat pemula kebingungan. + +## Apa yang Akan Anda Pelajari + +- Cara memuat file *.docx* yang berisi Office Math. +- Menyetel `TxtSaveOptions` yang tepat agar Aspose menghasilkan LaTeX untuk setiap persamaan. +- Menyimpan hasilnya sebagai file **save word plain text** yang dapat Anda masukkan ke dalam version control, pipeline CI, atau alat downstream lainnya. +- Kasus tepi umum—apa yang harus dilakukan ketika dokumen mencampur gambar dan persamaan, atau ketika Anda perlu mempertahankan karakter Unicode. +- Contoh kode lengkap yang siap dijalankan dan dapat Anda letakkan dalam aplikasi console. + +### Prasyarat + +- .NET 6.0 atau lebih baru (kode ini juga bekerja dengan .NET Framework 4.7+). +- Salinan berlisensi **Aspose.Words untuk .NET** (versi trial gratis dapat digunakan untuk pengujian). +- Visual Studio 2022 atau IDE apa pun yang dapat mengompilasi proyek C#. +- Dokumen Word (`input.docx`) yang sudah berisi beberapa objek Office Math. + +> **Pro tip:** Jika Anda belum memiliki lisensi, Anda dapat meminta kunci sementara dari situs web Aspose—cukup ganti placeholder di kode dengan kunci Anda sebelum menjalankannya. + +## Langkah 1 – Instal Aspose.Words via NuGet + +Hal pertama yang harus dilakukan: tambahkan pustaka ke proyek Anda. Buka **Package Manager Console** dan jalankan: + +```powershell +Install-Package Aspose.Words +``` + +Baris tunggal itu akan mengunduh semua yang Anda perlukan, termasuk namespace `Saving` tempat `TxtSaveOptions` berada. Tanpa DLL tambahan, tanpa dependensi native—hanya kode managed murni. + +## Langkah 2 – Muat Dokumen Word Sumber + +Sekarang kita benar‑benar membaca file yang berisi persamaan. Kelas `Document` mengabstraksi seluruh struktur *.docx*, sehingga Anda dapat memperlakukannya seperti model objek tingkat tinggi. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Mengapa ini penting:** Memuat dokumen di awal memungkinkan Anda memeriksa pohon node-nya. Jika Anda melewatkan pemeriksaan ini dan file tidak memiliki persamaan, Anda tetap akan mendapatkan file txt bersih—tetapi Anda tidak akan tahu mengapa output LaTeX kosong. + +## Langkah 3 – Konfigurasikan TxtSaveOptions untuk Ekspor LaTeX + +Aspose memberi Anda kontrol detail tentang cara Office Math dirender. Dengan menyetel `OfficeMathExportMode` ke `LaTeX`, setiap persamaan diubah menjadi ekivalen LaTeX‑nya alih‑alih dihapus atau diubah menjadi gambar. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Mengapa ini penting:** Mode ekspor default akan menghilangkan persamaan sepenuhnya. Beralih ke `LaTeX` mempertahankan maksud matematis, yang tepat ketika Anda nanti memasukkan file ke dalam compiler LaTeX atau processor markdown yang memahami sintaks `$…$`. + +## Langkah 4 – Simpan Dokumen sebagai Teks Polos + +Setelah opsi dikonfigurasi, menyimpan file menjadi satu baris kode. Outputnya akan berupa file `.txt` di mana setiap persamaan muncul sebagai kode LaTeX yang dibungkus oleh delimiter `$` (Anda dapat mengubahnya nanti jika lebih suka blok `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Hasil yang Diharapkan + +Buka `output.txt` di editor apa pun dan Anda akan melihat sesuatu seperti: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Perhatikan bagaimana teks biasa tetap persis seperti semula, sementara persamaan kini menjadi string LaTeX murni. Anda dapat menyalin‑tempelnya langsung ke dokumen LaTeX, notebook Jupyter, atau alat apa pun yang merender matematika. + +## Langkah 5 – Menangani Kasus Tepi + +### Konten Campuran (Gambar + Persamaan) + +Jika file Word Anda juga berisi gambar, Aspose akan mengabaikannya ketika Anda menggunakan `TxtSaveOptions`. Itu biasanya cukup untuk alur kerja **save word plain text**, tetapi jika Anda memerlukan gambar sebagai placeholder, Anda dapat: + +1. Mengekspor dokumen ke HTML terlebih dahulu (`HtmlSaveOptions`) untuk menangkap gambar sebagai tag ``. +2. Menjalankan pass kedua dengan `TxtSaveOptions` untuk mendapatkan persamaan LaTeX. +3. Menggabungkan dua hasil secara manual atau dengan skrip kecil. + +### Simbol Unicode + +Beberapa persamaan menggunakan karakter Unicode khusus (mis., huruf Yunani). Menyetel `Encoding = Encoding.UTF8` pada `TxtSaveOptions` (seperti yang ditunjukkan pada Langkah 3) memastikan simbol‑simbol tersebut tetap ada setelah konversi. + +### Dokumen Besar + +Untuk file berukuran besar (> 100 MB), pertimbangkan streaming operasi penyimpanan: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Streaming menghindari memuat seluruh output ke memori, yang dapat menjadi penyelamat pada agen build dengan memori terbatas. + +## Contoh Lengkap yang Siap Jalan + +Berikut adalah program lengkap yang siap disalin‑tempel dan dijalankan. Cukup ganti jalur file dan, jika ada, baris lisensi. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Jalankan program (`dotnet run` jika Anda menggunakan proyek console) dan periksa `output.txt`. Anda baru saja **menyimpan docx sebagai txt** sambil mempertahankan setiap persamaan sebagai LaTeX—tanpa perlu menyalin‑tempel secara manual. + +## Pertanyaan yang Sering Diajukan + +**T: Bisakah saya mengubah delimiter dari `$…$` menjadi `\(...\)`?** +J: Ya. Setelah menyimpan, jalankan penggantian sederhana pada file: `output = output.Replace("$", @"\(").Replace("$", @"\)");`—hati‑hati agar tidak mengganti karakter `$` yang memang ada dalam teks asli. + +**T: Apakah ini bekerja dengan file Word 2007‑2019?** +J: Tentu saja. Aspose.Words mendukung `.doc`, `.docx`, `.docm`, dan bahkan keluarga `.dotx` yang lebih baru. Kode yang sama berfungsi di semua versi. + +**T: Bagaimana jika saya perlu mempertahankan format paragraf asli (tab, spasi ganda)?** +J: Setel `txtSaveOptions.PreserveTableLayout = true;` dan `txtSaveOptions.PreserveSpace = true;` untuk menjaga whitespace tetap utuh. + +## Kesimpulan + +Kami telah membahas semua yang Anda perlukan untuk **menyimpan docx sebagai txt** sambil **mengekspor persamaan ke LaTeX** menggunakan Aspose.Words. Langkah kunci adalah memuat dokumen, mengonfigurasi `TxtSaveOptions` dengan `OfficeMathExportMode.LaTeX`, dan menyimpan hasilnya. Dengan tiga baris kode ini Anda dapat dengan andal **mengonversi word ke latex**, menjaga dokumen sebagai **save word plain text**, dan menghindari kehilangan simbol matematika yang menakutkan. + +Siap untuk tantangan berikutnya? Coba rangkaian alur kerja ini dengan generator markdown untuk menghasilkan file `.md` lengkap yang mencakup teks dan LaTeX—sempurna untuk dokumentasi berbasis Git atau generator situs statis. Atau jelajahi `PdfSaveOptions` dari Aspose untuk mendapatkan versi PDF bersamaan dengan file teks polos. + +Jika Anda menemui kendala, tinggalkan komentar di bawah. Selamat coding, dan nikmati kesederhanaan mengubah persamaan Word menjadi LaTeX yang bersih! + +![Ilustrasi menyimpan DOCX sebagai TXT dengan persamaan LaTeX](placeholder-image.png "contoh menyimpan docx sebagai txt") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/indonesian/net/working-with-fonts/_index.md b/words/indonesian/net/working-with-fonts/_index.md index 11693f2f17..45f381d9e0 100644 --- a/words/indonesian/net/working-with-fonts/_index.md +++ b/words/indonesian/net/working-with-fonts/_index.md @@ -37,7 +37,7 @@ Bahasa Indonesia: --- | --- Bahasa Indonesia: | [Atur Font Folder Default Instance](./set-fonts-folders-default-instance/) | Pelajari cara mengatur folder font untuk instance default di Aspose.Words untuk .NET dengan tutorial langkah demi langkah ini. Sesuaikan dokumen Word Anda dengan mudah. Bahasa Indonesia: | [Atur Font Folder Beberapa Folder](./set-fonts-folders-multiple-folders/) | Pelajari cara mengatur beberapa folder font di dokumen Word Anda menggunakan Aspose.Words untuk .NET. Panduan langkah demi langkah ini memastikan dokumen Anda menggunakan font yang tepat sesuai kebutuhan Anda. Bahasa Indonesia: | [Atur Font Folder Sistem Dan Folder Kustom](./set-fonts-folders-system-and-custom-folder/) Pelajari cara mengatur folder sistem dan font kustom dalam dokumen Word menggunakan Aspose.Words untuk .NET, memastikan dokumen Anda ditampilkan dengan benar di berbagai lingkungan. Bahasa Indonesia: -| [Atur Folder Font Dengan Prioritas](./set-fonts-folders-with-priority/) | Pelajari cara mengatur folder font dengan prioritas dalam dokumen Word menggunakan Aspose.Words untuk .NET. Panduan kami memastikan dokumen Anda ditampilkan dengan sempurna setiap saat. Bahasa Indonesia: +| [Atur Folder Font Dengan Prioritas](./set-fonts-folders-with-priority/) | Pelajari cara mengatur folder font dengan prioritas dalam dokumen Word menggunakan Aspose.Words untuk .NET. Panduan kami memastikan dokumen Anda ditampilkan sempurna setiap saat. Bahasa Indonesia: | [Atur Folder Font Jenis Benar](./set-true-type-fonts-folder/) | Pelajari cara mengatur folder True Type Fonts dalam dokumen Word menggunakan Aspose.Words untuk .NET. Ikuti panduan terperinci kami, langkah demi langkah untuk memastikan manajemen font yang konsisten. Bahasa Indonesia: | [Tentukan Font Default Saat Rendering](./specify-default-font-when-rendering/) | Pelajari cara menentukan font default saat merender dokumen Word menggunakan Aspose.Words untuk .NET. Pastikan tampilan dokumen konsisten di semua platform. Bahasa Indonesia: | [Pengaturan Font Dengan Opsi Muat](./font-settings-with-load-options/) Pelajari cara mengelola pengaturan font dengan opsi muat di Aspose.Words untuk .NET. Panduan langkah demi langkah bagi pengembang untuk memastikan tampilan font yang konsisten dalam dokumen Word. @@ -48,7 +48,7 @@ Bahasa Indonesia: [Atur Folder Font](./set-fonts-folder/) | Pelajari cara mengat | [Terima Pemberitahuan Peringatan](./receive-warning-notification/) Pelajari cara menerima pemberitahuan peringatan saat menggunakan Aspose.Words untuk .NET dan mengelola masalah atau peringatan apa pun dalam dokumen Anda. Bahasa Indonesia: | [Contoh Sumber Font Steam Sumber Daya](./resource-steam-font-source-example/) | Pelajari cara menggunakan Resource Stream Font Source untuk memuat font kustom ke Aspose.Words untuk .NET. Bahasa Indonesia: | [Dapatkan Substitusi Tanpa Sufiks](./get-substitution-without-suffixes/) | Dalam tutorial ini, pelajari cara mendapatkan penggantian tanpa sufiks dalam dokumen Word dengan Aspose.Words untuk .NET. | - +| [Penggantian Font Aspose – Cara Mengonfigurasi Pengaturan Font di C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Pelajari cara mengonfigurasi pengaturan font di Aspose.Words untuk .NET menggunakan C# dengan contoh langkah demi langkah. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/indonesian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/indonesian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..5f5313d944 --- /dev/null +++ b/words/indonesian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,237 @@ +--- +category: general +date: 2026-03-27 +description: 'Penggantian Font Aspose menjadi mudah: pelajari cara mengonfigurasi + pengaturan font, menangkap peringatan, dan menangani font yang hilang dalam aplikasi + .NET Anda.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: id +og_description: Kuasai Penggantian Font Aspose dengan mengonfigurasi pengaturan font + dan menangani font yang hilang menggunakan callback peringatan. Panduan lengkap + C#. +og_title: Penggantian Font Aspose – Konfigurasikan Pengaturan Font di C# +tags: +- Aspose.Words +- C# +- Font Management +title: Penggantian Font Aspose – Cara Mengonfigurasi Pengaturan Font di C# +url: /id/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Panduan Lengkap untuk Mengonfigurasi Pengaturan Font + +Pernah menemukan dokumen yang tiba‑tiba mengganti jenis huruf khusus Anda dengan sesuatu yang generik? Itu **aspose font substitution** yang melakukan tugasnya—mengganti font yang hilang dengan kecocokan terdekat yang dapat ditemukan. Ini berguna, tetapi jika Anda perlu mengetahui *tepat* font mana yang diganti, Anda harus memanfaatkan sistem peringatan library dan mengonfigurasi pengaturan font sendiri. + +Dalam tutorial ini kami akan membahas skenario dunia nyata: memuat DOCX yang merujuk pada font yang tidak Anda miliki, menangkap peristiwa substitusi, dan mencetak pesan ramah ke konsol. Pada akhir tutorial Anda akan nyaman dengan **configure font settings**, menyiapkan **Aspose.Words warning callback**, dan memperluas contoh untuk cocok dengan alur kerja apa pun. + +> **Apa yang Anda perlukan** +> • .NET 6+ (or .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • A DOCX that references a missing font (we’ll call it `MissingFont.docx`) + +Mari kita mulai. + +--- + +## Langkah 1: Instal Aspose.Words dan Siapkan Proyek + +Sebelum kita menulis kode apa pun, pastikan paket Aspose.Words sudah direferensikan: + +```bash +dotnet add package Aspose.Words +``` + +> **Tip Pro:** Gunakan versi stabil terbaru; per Maret 2026 versi terbarunya adalah 23.11.0. Rilis yang lebih baru meningkatkan algoritma pencocokan font dan menambahkan tipe peringatan tambahan. + +Buat aplikasi konsol baru (atau masukkan kode ke dalam proyek yang sudah ada) dan tambahkan direktif `using` yang biasa: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Namespace ini memberi kita akses ke `Document`, `LoadOptions`, dan kelas‑kelas terkait font yang akan kita butuhkan. + +## Langkah 2: Konfigurasikan Pengaturan Font dengan LoadOptions + +Inti kontrol **aspose font substitution** berada di `LoadOptions.FontSettings`. Dengan menyediakan objek `FontSettings` kosong, kita memberi tahu Aspose untuk menggunakan jalur pencarian default *dan* melaporkan setiap substitusi melalui callback peringatan. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Mengapa tidak hanya mengandalkan default? Karena menempelkan callback peringatan (langkah berikutnya) hanya berfungsi ketika properti `FontSettings` tidak null. Baris kecil ini memberi kita kait ke proses substitusi tanpa mengubah perilaku pencarian font sebenarnya. + +## Langkah 3: Lampirkan Callback Peringatan untuk Menangkap Substitusi + +Aspose.Words mengimplementasikan antarmuka `IWarningCallback`. Setiap kali terjadi sesuatu yang penting—seperti font yang hilang—ia memanggil metode `Warning` kami. Kami akan mengimplementasikan handler kecil yang menyaring `WarningType.FontSubstitution` dan mencetak deskripsinya. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +Dan inilah handlernya sendiri: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Mengapa ini penting** – Tanpa callback, Aspose secara diam‑diam mengganti font, dan Anda tidak pernah tahu font mana yang digunakan. Callback membuat proses menjadi transparan, yang penting untuk pelaporan kepatuhan atau debugging masalah tata letak. + +## Langkah 4: Muat Dokumen Menggunakan Opsi yang Dikonfigurasi + +Sekarang kita akhirnya memuat dokumen, dengan melewatkan `loadOptions` yang baru saja kita siapkan. Jika file sumber merujuk pada font yang tidak terpasang, handler kami akan dipanggil. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Ganti `YOUR_DIRECTORY` dengan jalur sebenarnya tempat `MissingFont.docx` berada. Saat Anda menjalankan program, Anda akan melihat output serupa dengan: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Baris itu memberi tahu Anda secara tepat font mana yang hilang dan fallback mana yang dipilih Aspose. + +## Langkah 5: (Opsional) Sesuaikan Jalur Pencarian Font + +Jika Anda memiliki folder pribadi dengan font perusahaan, Anda dapat memberi tahu Aspose ke mana harus mencari sebelum kembali ke font sistem. Ini adalah penggunaan lanjutan dari **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Menetapkan `recursive: true` membuat Aspose memindai subfolder juga. Sekarang perpustakaan akan mencoba font pribadi Anda terlebih dahulu, mengurangi kemungkinan substitusi yang tidak diinginkan. + +## Contoh Kerja Lengkap + +Menggabungkan semuanya, berikut program lengkap yang siap dijalankan: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Output yang diharapkan** (ketika font yang hilang ditemukan): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Jika semua font ada, program berjalan diam‑diam (tanpa peringatan) dan tetap menghasilkan PDF. + +## Pertanyaan Umum & Kasus Tepi + +### Bagaimana jika saya perlu *mencegah* substitusi sama sekali? + +Setel `FontSettings.SubstitutionSettings` ke `null` atau gunakan `FontSettings.FontSubstitutionSettings` untuk mengontrol perilaku. Misalnya: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Sekarang Aspose akan melemparkan pengecualian alih‑alih mengganti secara diam‑diam, yang dapat ditangkap dan ditangani. + +### Apakah ini bekerja dengan format file lain (mis., .doc, .rtf)? + +Tentu saja. Objek `LoadOptions` yang sama dapat diteruskan ke konstruktor `Document` mana pun yang menerima jalur file. Callback peringatan akan dipanggil untuk semua format yang bergantung pada font. + +### Bisakah saya menangkap nama font fallback yang *tepat*? + +Ya. String `info.Description` berisi kedua font yang hilang dan penggantinya. Jika Anda memerlukan nama secara programatik, Anda dapat mem‑parse atau menggunakan objek `FontInfo` (tersedia di versi yang lebih baru). + +### Bagaimana perilakunya dalam lingkungan multi‑thread? + +`FontSettings` **tidak** thread‑safe. Buat `LoadOptions` terpisah (dengan `FontSettings` masing‑masing) per thread, atau lindungi akses dengan lock. + +## Kesimpulan + +Kami telah membahas semua yang Anda perlukan untuk menguasai **aspose font substitution** dan **configure font settings** dalam aplikasi C#: + +1. Instal Aspose.Words dan tambahkan pernyataan `using` yang diperlukan. +2. Buat objek `LoadOptions` dengan `FontSettings` baru. +3. Lampirkan `IWarningCallback` khusus untuk menampilkan peristiwa substitusi. +4. Muat dokumen, biarkan callback melaporkan font yang hilang. +5. (Opsional) Perluas jalur pencarian atau nonaktifkan substitusi sepenuhnya. + +Dengan pola ini Anda dapat mencatat font yang hilang untuk kepatuhan, memberi peringatan kepada pengguna di UI, atau secara otomatis menyematkan font fallback sebelum publikasi. Selanjutnya, Anda dapat menjelajahi **Aspose.Words font substitution policies** atau mengintegrasikan alur kerja ke dalam pipeline pemrosesan dokumen yang lebih besar. + +Selamat coding, dan semoga dokumen Anda selalu ditampilkan dengan jenis huruf yang tepat! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/italian/net/basic-conversions/_index.md b/words/italian/net/basic-conversions/_index.md index 9f8ae95ae3..635b4dc94b 100644 --- a/words/italian/net/basic-conversions/_index.md +++ b/words/italian/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ | [Come esportare LaTeX da Word – Guida passo‑passo](./how-to-export-latex-from-word-step-by-step-guide/) | Scopri come esportare contenuti LaTeX da documenti Word usando Aspose.Words per .NET, con esempi pratici e istruzioni dettagliate. | | [Convertire Word in PDF in C# usando Aspose.Words – Guida](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Scopri come convertire documenti Word in PDF con C# usando Aspose.Words, con esempi di codice e passaggi dettagliati. | | [Salva Word come PDF con Aspose.Words – Guida completa C#](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Scopri come salvare documenti Word in PDF usando Aspose.Words con una guida completa in C#. | +| [Convertire Word in PDF con Aspose.Words – Guida completa](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Scopri come convertire Word in PDF con Aspose.Words – guida completa passo passo per sviluppatori .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/italian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/italian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..e1c7decb0a --- /dev/null +++ b/words/italian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Converti Word in PDF rapidamente usando Aspose.Words. Scopri come salvare + Word come PDF, esportare DOCX in PDF e generare PDF accessibili in C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: it +og_description: Converti Word in PDF in C# usando Aspose.Words. Questa guida mostra + come salvare Word come PDF, esportare DOCX in PDF e generare PDF accessibile. +og_title: Converti Word in PDF con Aspose.Words – Passo dopo passo +tags: +- Aspose.Words +- C# +- PDF conversion +title: Converti Word in PDF con Aspose.Words – Guida completa +url: /it/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Converti Word in PDF con Aspose.Words – Guida Completa + +Ti sei mai chiesto come **convertire Word in PDF** senza impazzire con strumenti web di terze parti? Forse stai costruendo un motore di report automatizzato e hai bisogno di un modo affidabile per *salvare word as pdf* al volo. La buona notizia è che Aspose.Words rende l’intero processo un gioco da ragazzi, e puoi persino generare un file conforme a **PDF/UA‑2**—perfetto per i requisiti di accessibilità. + +In questo tutorial vedremo tutto ciò di cui hai bisogno: caricare un `.docx`, configurare le opzioni PDF così da *export docx to pdf* con conformità PDF/UA, e infine salvare il risultato come PDF accessibile. Alla fine avrai uno snippet autonomo, pronto per la produzione, da inserire in qualsiasi progetto .NET. + +![Converti Word in PDF usando Aspose.Words](convert-word-to-pdf.png) + +## Cosa Imparerai + +- **Perché Aspose.Words** è una scelta solida per scenari di *generate accessible pdf*. +- I passaggi esatti per *save document as pdf* con conformità PDF/UA‑2. +- Come gestire casi particolari comuni come font mancanti o file sorgente protetti da password. +- Suggerimenti rapidi per il debug dell’output e la verifica della conformità di accessibilità. + +### Prerequisiti + +- .NET 6 o successivo (l’API funziona anche su .NET Framework 4.6+). +- Una licenza valida di Aspose.Words per .NET (la versione di prova gratuita è sufficiente per la valutazione). +- Conoscenze di base di C#—non servono pattern complessi. + +Se hai spuntato queste caselle, immergiamoci. + +--- + +## Converti Word in PDF – Implementazione Passo‑Passo + +Divideremo la soluzione in cinque passaggi chiari. Ogni passaggio ha un titolo, un breve estratto di codice e una spiegazione del *perché* il codice è importante. + +### Passo 1: Carica il Documento Word da Convertire + +La prima cosa di cui hai bisogno è un oggetto `Document` che rappresenti il file sorgente. Aspose.Words legge **.docx**, **.doc**, **.rtf** e molti altri formati, così puoi *save word as pdf* indipendentemente da come è stato creato il file. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Perché è importante:** +- Caricare il file subito ti permette di intercettare errori di file mancante prima di sprecare cicli CPU. +- La classe `Document` astrae la struttura interna di un file Word, fornendoti un modello di oggetti pulito con cui lavorare. + +### Passo 2: Configura le Opzioni di Salvataggio PDF per l’Accessibilità + +Se devi *generate accessible pdf*, devi indicare ad Aspose.Words di produrre un documento conforme a PDF/UA‑2. La classe `PdfSaveOptions` ti offre un controllo granulare sull’output. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Perché è importante:** +- `PdfCompliance.PdfUa2` dice alla libreria di aggiungere i tag, le informazioni di struttura e i metadati necessari a cui i lettori di schermo fanno affidamento. +- L’incorporamento dei font (`EmbedFullFonts = true`) evita gli avvisi “font non trovato” quando il PDF viene aperto su un OS diverso. +- Impostare un `Title` aiuta le tecnologie assistive a annunciare correttamente il documento. + +### Passo 3: Salva il Documento come PDF + +Ora che il sorgente è caricato e le opzioni sono impostate, la conversione vera e propria è una singola riga. È qui che *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Perché è importante:** +- Il metodo `Save` rispetta le `PdfSaveOptions` configurate, garantendo che le funzionalità di accessibilità siano incorporate. +- Avvolgere la chiamata in un blocco `try/catch` ti dà la possibilità di registrare o segnalare eventuali errori di licenza o permessi che spesso ostacolano i principianti. + +### Passo 4: Verifica la Conformità PDF/UA (Facoltativo ma Consigliato) + +Anche se Aspose.Words fa il lavoro pesante, è buona pratica ricontrollare l’output, soprattutto quando consegni documenti a enti governativi o altre organizzazioni regolamentate. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Perché è importante:** +- `IsTagged` è un rapido controllo di sanità; la validazione completa PDF/UA richiede un validatore dedicato, ma la maggior parte dei problemi di conformità si manifesta come tag mancanti. +- Se il flag restituisce `false`, puoi rivedere le `PdfSaveOptions`—forse hai dimenticato di impostare `Compliance` o il documento sorgente non aveva stili di intestazione corretti. + +### Passo 5: Problemi Comuni & Consigli Pro + +| Problema | Cosa Succede | Come Risolvere | +|----------|--------------|----------------| +| **Font mancanti** | Il testo appare come quadrati nel PDF. | Imposta `EmbedFullFonts = true` **oppure** installa i font mancanti sul server. | +| **Libreria non licenziata** | Aspose aggiunge una filigrana a ogni pagina. | Aggiungi il file di licenza (`Aspose.Words.lic`) all’inizio dell’app (es. `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Sorgente protetto da password** | `InvalidOperationException` su `new Document(path)`. | Usa il sovraccarico `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Documenti molto grandi causano OOM** | Eccezione Out‑of‑memory su file enormi. | Abilita `MemoryOptimization` in `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Tag di accessibilità mancanti** | La validazione PDF/UA fallisce. | Assicurati che il file Word sorgente usi stili di intestazione corretti (`Heading 1`, `Heading 2`, ecc.)—Aspose mappa automaticamente questi stili ai tag PDF. | + +**Consiglio pro:** Se converti molti documenti in batch, riutilizza una singola istanza di `PdfSaveOptions`. Crearla una sola volta riduce l’overhead di allocazione e mantiene basso il consumo di memoria. + +--- + +## Esempio Completo (Pronto per Copia‑Incolla) + +Di seguito trovi il programma completo che mette insieme tutti i passaggi. Salvalo come `Program.cs`, aggiungi i pacchetti NuGet Aspose.Words e Aspose.PDF, e avvialo. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Risultato atteso:** +Verrà creato un file chiamato `output.pdf` in `C:\MyFiles`. Aprendolo con Adobe Acrobat vedrai “PDF/A‑2b, PDF/UA‑1” nel pannello di conformità, confermando che hai **convertito word to pdf** con successo. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/italian/net/programming-with-markdownsaveoptions/_index.md b/words/italian/net/programming-with-markdownsaveoptions/_index.md index b690ecf4d4..d308ea98a3 100644 --- a/words/italian/net/programming-with-markdownsaveoptions/_index.md +++ b/words/italian/net/programming-with-markdownsaveoptions/_index.md @@ -30,9 +30,11 @@ | [Salva docx come markdown – Guida completa C# con equazioni LaTeX](./save-docx-as-markdown-complete-c-guide-with-latex-equations/) | Impara a convertire file DOCX in Markdown includendo equazioni LaTeX con una guida completa in C#. | | [Salva docx come markdown – Guida completa C# con estrazione immagini](./save-docx-as-markdown-full-c-guide-with-image-extraction/) | Impara a convertire file DOCX in Markdown includendo l'estrazione delle immagini con una guida completa in C#. | | [Come esportare Markdown da Word – Guida completa C#](./how-to-export-markdown-from-word-complete-c-guide/) | Scopri come esportare documenti Word in Markdown con una guida completa in C#. | -| [Come esportare Markdown da DOCX – Guida completa](./how-to-export-markdown-from-docx-complete-guide/) | Scopri come esportare documenti DOCX in Markdown con una guida completa in C#. | +| [Come esportare Markdown da DOCX – Guida completa](./how-to-export-markdown-from-docx-complete-guide/) | Scopri come esportare documenti DOCX in Markdown con una guida completa. | | [Come salvare Markdown da DOCX – Guida passo‑passo](./how-to-save-markdown-from-docx-step-by-step-guide/) | Scopri come salvare documenti DOCX in Markdown con una guida passo‑passo completa. | - +| [Come esportare LaTeX da Word – Converti DOCX in Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) | Scopri come esportare contenuti LaTeX da Word convertendoli in Markdown con Aspose.Words per .NET. | +| [Come esportare LaTeX da DOCX – Convertire in Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) | Scopri come esportare contenuti LaTeX da DOCX convertendoli in Markdown con Aspose.Words per .NET. | +| [Crea markdown da Word – Guida completa C#](./create-markdown-from-word-full-c-guide/) | Scopri come creare markdown da Word con una guida completa in C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/italian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/italian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..0dbe29531d --- /dev/null +++ b/words/italian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Crea markdown da Word con Aspose.Words C#. Impara a convertire docx in + markdown, estrarre le immagini da Word e come utilizzare il callback in un unico + tutorial. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: it +og_description: Crea markdown da Word usando Aspose.Words. Questa guida mostra come + convertire docx in markdown, estrarre immagini da Word e utilizzare un callback + per la gestione delle risorse. +og_title: Crea markdown da Word – Tutorial completo C# +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Crea markdown da Word – Guida completa C# +url: /it/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Crea markdown da Word – Tutorial completo C# + +Ti è mai capitato di **creare markdown da Word** senza sapere da dove cominciare? Non sei solo; molti sviluppatori si trovano di fronte a questo ostacolo quando cercano di spostare contenuti da un file .docx a un generatore di siti statici o a un repository di documentazione. La buona notizia? Con Aspose.Words puoi **convertire docx in markdown**, estrarre ogni immagine dal file originale e controllare esattamente dove atterrare quelle risorse—tutto con un semplice callback. + +In questa guida percorreremo un esempio reale che ti mostra come estrarre le immagini da Word, come usare il callback per salvarle e perché questo approccio è il più affidabile per le pipeline di automazione. Alla fine avrai un programma C# pronto all'uso che produce un file `.md` pulito e una cartella di immagini estratte. + +> **Pro tip:** Se hai già un modello Word che include screenshot, diagrammi o loghi, questo metodo preserverà ogni elemento visivo senza dover copiare‑incollare manualmente. + +--- + +## Cosa ti servirà + +- **.NET 6+** (o .NET Framework 4.6+). Il codice funziona su qualsiasi runtime recente. +- **Aspose.Words for .NET** (pacchetto NuGet `Aspose.Words`). La versione di prova gratuita è sufficiente per la maggior parte degli scenari. +- Un **documento Word** (`input.docx`) che contenga testo e almeno un'immagine. +- Una conoscenza di base di C# e Visual Studio (o del tuo IDE preferito). + +Non sono necessarie librerie aggiuntive—tutto il resto è gestito da Aspose.Words stesso. + +--- + +## Passo 1: Configura il progetto e installa Aspose.Words + +Per mantenere le cose ordinate, avvia un nuovo progetto console: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Perché questo passo è importante:** L'installazione del pacchetto NuGet garantisce di avere l'API più recente, che include la classe `MarkdownSaveOptions` introdotta nella versione 22.9. Senza di essa dovresti scrivere un convertitore personalizzato. + +--- + +## Passo 2: Carica il documento Word di origine + +La prima riga di codice apre il `.docx` che desideri trasformare. Sostituisci `YOUR_DIRECTORY` con il percorso reale sulla tua macchina. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Cosa sta succedendo?** `Document` analizza il file, costruisce un DOM interno e rende accessibili ogni paragrafo, tabella e immagine. Se il file manca, Aspose genera una chiara `FileNotFoundException`, che puoi catturare per una UI più elegante. + +--- + +## Passo 3: Configura le opzioni di salvataggio Markdown con un callback di salvataggio risorse + +Ecco dove entra in gioco la magia di **how to use callback**. Il callback ti permette di decidere dove posizionare ogni immagine estratta. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Perché un callback?** Per impostazione predefinita Aspose incorporerebbe le immagini come stringhe base‑64 all'interno del markdown—un incubo per il version control. Il callback ti dà il pieno controllo sui nomi dei file e sulla struttura delle cartelle. + +--- + +## Passo 4: Salva il documento come Markdown + +Ora generiamo effettivamente il file `.md`. Tutte le immagini verranno consegnate al callback definito nel passo successivo. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Se tutto procede senza errori, troverai `Document.md` nella cartella di destinazione e una sotto‑cartella chiamata `Resources` contenente ogni immagine estratta dal file Word originale. + +--- + +## Passo 5: Implementa il callback che salva ogni immagine estratta + +Di seguito trovi l'implementazione completa di `MyResourceSaver`. Crea una directory `Resources` (se non esiste), genera un nome file unico per ogni immagine e scrive lo stream dell'immagine su disco. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Spiegazione degli argomenti:** +> - `args.Index` – un contatore a base zero che garantisce l'unicità. +> - `args.FileName` – il nome file originale suggerito da Aspose (spesso qualcosa come `image001.png`). +> - `args.Stream` – lo stream di output dove vengono scritti i byte dell'immagine. +> - `args.KeepResourceStreamOpen` – impostato a `false` così Aspose chiude automaticamente lo stream, evitando perdite di handle dei file. + +--- + +## Esempio completo funzionante + +Riunendo tutto, ecco un unico file che puoi copiare‑incollare in `Program.cs`. Ricorda di sostituire `YOUR_DIRECTORY` con un percorso assoluto o relativo adatto al tuo ambiente. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Output previsto + +- `YOUR_DIRECTORY/Document.md` – un file markdown con link immagine standard, ad esempio: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – contiene `img_0.png`, `img_1.jpg`, ecc., corrispondenti all'ordine in cui apparivano nel documento Word originale. + +L'esecuzione del programma stampa una conferma amichevole, indicandoti che il processo è terminato con successo. + +--- + +## Domande frequenti (FAQ) + +### Come estrarre le immagini da Word senza perdere qualità? + +Il callback scrive lo stream binario grezzo direttamente su file, preservando la risoluzione originale. Nessuna conversione o compressione avviene a meno che non aggiungi una tua logica di elaborazione immagine all'interno di `ResourceSaving`. + +### Posso cambiare il formato dell'immagine (es. PNG → JPEG) durante l'estrazione? + +Assolutamente. All'interno di `ResourceSaving` puoi ispezionare `args.FileName` o `args.Stream`, caricare l'immagine con `System.Drawing` o `ImageSharp`, quindi ricodificarla prima di scriverla. Ricorda solo di aggiornare l'estensione del link markdown di conseguenza. + +### E se devo far riferire i file markdown a un CDN invece che a una cartella locale? + +Modifica il callback per anteporre un URL base al link markdown. Puoi farlo impostando `args.FileName` a un URL completamente qualificato dopo aver caricato l'immagine sul tuo CDN. + +### Funziona con tabelle, note a piè di pagina o altre funzionalità avanzate di Word? + +Sì. Aspose.Words traduce la maggior parte delle strutture Word in equivalenti markdown. Le tabelle diventano tabelle markdown, le note a piè di pagina diventano link di riferimento e anche le liste nidificate sono gestite correttamente. Se qualcosa appare strano, controlla le note di rilascio più recenti—Aspose migliora continuamente la fedeltà della conversione. + +### Come convertire docx in markdown in una pipeline CI/CD? + +Aggiungi semplicemente l'eseguibile `.exe` compilato ai tuoi passaggi di build, puntalo sugli artefatti `.docx` generati e spingi i file `.md` e la cartella `Resources/` nel repository del tuo sito statico. Poiché il processo è completamente deterministico, funziona bene in ambienti automatizzati. + +--- + +## Conclusioni + +Abbiamo appena dimostrato come **creare markdown da Word** usando Aspose.Words, coperto l'intero flusso di lavoro **convert docx to markdown** e mostrato un modo pratico per **estrarre immagini da Word** con un'implementazione personalizzata di **how to use callback**. Il risultato è un file markdown pulito accompagnato da una cartella di immagini originali—perfetto per siti di documentazione, blog statici o qualsiasi flusso di lavoro che preferisca formati di testo semplice. + +Passi successivi da considerare: + +- **Elaborazione batch** di più file `.docx` in una cartella (loop su `Directory.GetFiles`). +- **Schemi di denominazione personalizzati** per le immagini (es. usando il testo della didascalia originale). +- **Post‑processing** del markdown per sostituire i link delle immagini con URL CDN. +- Esplorare **altri formati di esportazione Aspose** come HTML, PDF o EPUB per la pubblicazione multicanale. + +Hai altre domande o un file Word ostinato che rifiuta di convertire? Lascia un commento qui sotto e risolviamo insieme. Buon coding e goditi la semplicità di trasformare Word in markdown! + +--- + +![Diagramma che mostra il processo di conversione da Word a Markdown](image.png "Crea markdown da diagramma Word") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/italian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/italian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..0ea38157f4 --- /dev/null +++ b/words/italian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,266 @@ +--- +category: general +date: 2026-03-27 +description: Come esportare LaTeX da DOCX usando Aspose.Words. Impara a convertire + DOCX in Markdown, impostare DPI e abilitare il recupero in C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: it +og_description: Come esportare LaTeX da DOCX usando Aspose.Words. Questo tutorial + mostra la conversione passo‑passo in Markdown, il controllo DPI e la modalità di + recupero. +og_title: Come esportare LaTeX da DOCX – Converti in Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Come esportare LaTeX da DOCX – Convertire in Markdown +url: /it/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come esportare LaTeX da DOCX – Convertire in Markdown + +Ti sei mai chiesto **come esportare LaTeX** da un file DOCX senza perdere la bellezza delle tue equazioni? Non sei solo. Nella mia esperienza, il punto dolente più grande è ottenere quegli oggetti OfficeMath in un formato pulito e portabile per generatori di siti statici o blog scientifici. + +In questa guida vedremo come convertire DOCX in Markdown con Aspose.Words, mostrando anche **come impostare DPI**, **come abilitare il recupero**, e alcuni trucchi utili per una pipeline solida. Alla fine avrai un unico programma C# che produce un file Markdown con equazioni LaTeX, immagini ad alta risoluzione e gestione corretta dei collegamenti ipertestuali. + +## Cosa ti serve + +- **.NET 6+** (o .NET Framework 4.7.2 – l'API funziona allo stesso modo) +- **Aspose.Words for .NET** (l'ultima versione stabile a partire da marzo 2026) +- Un file DOCX che contiene equazioni, immagini e collegamenti +- Visual Studio, VS Code, o qualsiasi editor tu preferisca + +Non sono necessari pacchetti NuGet aggiuntivi oltre ad Aspose.Words, ma assicurati di avere una licenza valida se non stai usando la versione di prova. + +## Passo 1 – Carica il DOCX con modalità di recupero rigida + +Prima di pensare all'esportazione, dobbiamo assicurarci che il documento sorgente non nasconda corruzioni. È qui che entra in gioco **come abilitare il recupero**. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Perché il recupero rigido?** +Se lasci che Aspose corregga silenziosamente i problemi, potresti ritrovarti con paragrafi mancanti o immagini rotte—qualcosa che nessuno vuole quando esporta LaTeX. Fallendo rapidamente, puoi individuare il problema subito e decidere se correggere il DOCX sorgente o registrare il problema per dopo. + +### Consiglio professionale +Avvolgi il caricamento in un try/catch e registra `DocumentLoadingException`. In questo modo la tua pipeline CI può segnalare file problematici senza interrompere l'intera build. + +## Passo 2 – Prepara le opzioni di esportazione Markdown + +Ora che il documento è in memoria in modo sicuro, configuriamo come verrà salvato. Questo è il fulcro di **come esportare latex** e copre anche **come impostare DPI** per le immagini incorporate. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Cosa fa ciascuna opzione** + +| Opzione | Motivo | Rilevanza per le parole chiave | +|--------|--------|-------------------------------| +| `OfficeMathExportMode = LaTeX` | Risponde direttamente a **how to export latex** dalle equazioni. | Parola chiave primaria | +| `ImageResolution = 300` | Controlla la qualità dell'immagine – la risposta a **how to set dpi**. | Secondaria | +| `ResourceSavingCallback` | Salva i file incorporati su disco, una necessità comune quando **convert docx to markdown**. | Secondaria | +| `EmptyParagraphExportMode` | Garantisce un output Markdown pulito, evitando tag HTML erranti. | Migliora la qualità complessiva della conversione | +| `LinkExportMode = AsReference` | Rende i collegamenti facili da leggere e modificare, un ulteriore vantaggio per **convert docx to markdown**. | | + +## Passo 3 – Implementa un salvataggio risorse personalizzato (Opzionale ma utile) + +Quando converti DOCX in Markdown, le immagini e altre risorse binarie hanno bisogno di un posto nel filesystem. Aspose ti permette di controllarlo con `IResourceSavingCallback`. Lo snippet sopra mostra già un'implementazione minima, ma analizziamolo: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Perché preoccuparsi?** +Se salti questo passo, Aspose incorporerà le immagini come stringhe base‑64, il che gonfia la dimensione del file Markdown e rende il versionamento doloroso. Salvando le risorse in una cartella separata, mantieni il Markdown leggero e lo rendi compatibile con generatori di siti statici come Hugo o Jekyll. + +## Passo 4 – Salva il documento come Markdown + +Tutto il lavoro pesante è stato fatto. Una riga ora scrive il file finale. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Apri `output.md` e vedrai: + +- Equazioni renderizzate come blocchi LaTeX `$…$` +- Immagini referenziate come `![Alt text](resources/image001.png)` con risoluzione di 300 dpi +- Collegamenti trasformati in stile riferimento: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Questo è l'intero processo **how to convert docx** in breve. + +## Domande comuni e casi limite + +### 1️⃣ E se il DOCX contiene oggetti non supportati? +Aspose.Words genererà una `FeatureNotSupportedException`. Poiché abbiamo usato **how to enable recovery** in modalità rigida, l'eccezione appare immediatamente. Puoi: + +- Cambiare `RecoveryMode` a `RecoveryMode.Default` per una conversione al meglio delle possibilità, **oppure** +- Pre‑processare il DOCX (ad esempio, rimuovere SmartArt non supportato) prima di eseguire il convertitore. + +### 2️⃣ Posso cambiare il DPI per immagine? +L'impostazione `ImageResolution` è globale. Per un controllo per immagine, implementa un `ImageSavingCallback` personalizzato simile a `MyResourceSaver` e regola `args.ImageResolution` in base a `args.ImageFileName` o ai metadati. + +### 3️⃣ Come incorporare il LaTeX generato in un sito Jekyll? +Il supporto MathJax integrato di Jekyll funziona subito. Basta assicurarsi che il layout includa lo script MathJax e che i blocchi LaTeX siano avvolti in `$$` per le equazioni di visualizzazione o `$` per quelle inline. + +### 4️⃣ È compatibile con .NET Core su Linux? +Assolutamente. Aspose.Words è cross‑platform. Basta assicurarsi che il percorso `YOUR_DIRECTORY` segua le convenzioni Linux (ad esempio, `/home/user/docs`). + +## Esempio completo funzionante + +Di seguito trovi un programma pronto per il copia‑incolla. Sostituisci `YOUR_DIRECTORY` con un percorso reale sulla tua macchina. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Output previsto** – apri `output.md` e dovresti vedere qualcosa di simile: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Se apri il file in un'anteprima Markdown che supporta MathJax, l'integrale viene renderizzato + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/italian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/italian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..7dcfddadef --- /dev/null +++ b/words/italian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Come esportare LaTeX da documenti Word usando Aspose.Words – convertire + DOCX in Markdown con equazioni in LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: it +og_description: Come esportare LaTeX da documenti Word è spiegato nella prima frase, + mostrandoti come convertire DOCX in Markdown con le equazioni in LaTeX. +og_title: Come esportare LaTeX da Word – Guida completa +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Come esportare LaTeX da Word – Convertire DOCX in Markdown +url: /it/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come esportare LaTeX da Word – Convertire DOCX in Markdown + +Ti sei mai chiesto **come esportare LaTeX** da un file Word senza ritrovarti con una serie di PNG? Non sei l’unico; gli sviluppatori si imbattono spesso in questo ostacolo quando hanno bisogno di equazioni pulite e modificabili per siti statici o blog scientifici. La buona notizia? Con Aspose.Words puoi **convertire Word in Markdown** e mantenere ogni oggetto OfficeMath come LaTeX nativo—senza alcuna post‑elaborazione. + +In questo tutorial percorreremo l’intero processo di **salvataggio di un documento Word come Markdown** esportando le equazioni come LaTeX. Alla fine avrai uno snippet C# funzionante, una chiara spiegazione di ogni opzione e consigli per gestire casi particolari come formule complesse o contenuti misti. Nessun tool esterno, solo un singolo pacchetto NuGet e poche righe di codice. + +## Cosa ti servirà + +- .NET 6+ (o .NET Framework 4.7.2 e versioni successive) – l’ultima runtime è la più indicata. +- Visual Studio 2022 o qualsiasi editor in grado di compilare progetti C#. +- Una licenza Aspose.Words per .NET (la versione di prova gratuita è sufficiente per sperimentare). +- Un file DOCX che contenga almeno un’equazione (OfficeMath). + +Se hai già tutto questo, ottimo—iniziamo. + +## Come esportare LaTeX da Word – Panoramica + +Di seguito una vista ad alto livello dei passaggi coinvolti: + +1. **Installa** il pacchetto NuGet Aspose.Words. +2. **Carica** il file `.docx` sorgente che contiene le tue equazioni. +3. **Configura** `MarkdownSaveOptions` impostando `OfficeMathExportMode` su `LaTeX`. +4. **Salva** il documento come file `.md`. +5. **Verifica** che il Markdown generato contenga blocchi LaTeX (`$$…$$`). + +Ognuno di questi passaggi è spiegato in dettaglio nelle sezioni successive. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="Diagramma su come esportare latex da Word"} + +## Passo 1 – Installa Aspose.Words per .NET (convertire word in markdown) + +Prima di tutto: ti serve la libreria che esegue il lavoro pesante. Apri il terminale (o la Console di Gestione Pacchetti) ed esegui: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** Se usi Visual Studio, fai clic destro sul progetto → *Manage NuGet Packages* → cerca “Aspose.Words” e installa l’ultima versione stabile. + +Perché è importante: Aspose.Words astrae il formato Open XML, offrendoti un’API pulita per manipolare documenti Word senza dover gestire l’XML a basso livello. Inoltre include il supporto integrato per convertire OfficeMath in LaTeX, che è il fulcro del nostro requisito **esportare equazioni come LaTeX**. + +## Passo 2 – Carica il DOCX (come convertire docx) + +Ora che il pacchetto è pronto, carica il file che vuoi trasformare. Sostituisci `YOUR_DIRECTORY` con il percorso dove si trova il tuo `.docx`: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Perché caricarlo in questo modo?** Il costruttore `Document` analizza l’intero file in un modello di oggetti, dandoti accesso immediato a paragrafi, tabelle e—soprattutto—oggetti OfficeMath. Se il file manca o è corrotto, Aspose lancia una `FileNotFoundException` descrittiva, che puoi catturare per una gestione degli errori più elegante. + +## Passo 3 – Configura MarkdownSaveOptions (esportare equazioni come latex) + +La magia avviene nell’oggetto `MarkdownSaveOptions`. Per impostazione predefinita Aspose renderizzerebbe le equazioni come immagini PNG, ma noi vogliamo LaTeX. Imposta `OfficeMathExportMode` su `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Una rapida nota sui flag opzionali: `ExportImagesAsBase64` indica ad Aspose di non incorporare dati binari, mantenendo il Markdown pulito. `ExportHeadersFooters` garantisce che non perda alcun contesto presente in quelle sezioni—utile quando l’intestazione contiene titolo o nome dell’autore. + +## Passo 4 – Salva il documento (salvare word come markdown) + +Infine, scrivi il contenuto trasformato in un file `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Dopo l’esecuzione di questa riga, troverai `output.md` accanto al file sorgente. Aprilo con qualsiasi editor di testo e dovresti vedere blocchi LaTeX simili a questi: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Questo è il **salvare word come markdown** completato—nessun passaggio di conversione aggiuntivo necessario. + +## Passo 5 – Verifica il risultato (esportare equazioni come latex) + +È facile trascurare la verifica, ma un rapido controllo di sanità fa risparmiare ore in seguito. Esegui uno script semplice che legge il file generato e stampa il primo blocco LaTeX: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Se vedi stampato `First LaTeX block: $$ … $$`, hai **esportato LaTeX** da Word con successo. In caso contrario, ricontrolla che il documento sorgente contenga effettivamente oggetti OfficeMath; le equazioni in testo normale non verranno convertite. + +## Gestione dei casi limite più comuni + +| Scenario | Cosa controllare | Correzione consigliata | +|----------|-------------------|------------------------| +| **Immagini ed equazioni miste** | Aspose potrebbe ancora incorporare immagini per grafica non‑OfficeMath. | Imposta `ExportImagesAsBase64 = false` e mantieni le immagini come file esterni, poi riferiscile manualmente in Markdown. | +| **Equazioni nidificate complesse** | Un annidamento molto profondo può generare LaTeX che necessita di aggiustamenti manuali. | Post‑processa il blocco con un formattatore LaTeX (es. `latexindent`) o imposta `mdOptions → ExportMathAsDisplay = true`. | +| **Documenti di grandi dimensioni** | L’uso di memoria aumenta notevolmente quando si caricano `.docx` enormi. | Usa `LoadOptions` con `LoadFormat.Docx` e abilita lo streaming di `LoadOptions.LoadFormat` se disponibile. | +| **Licenza mancante** | La versione di prova aggiunge un commento di watermark all’output. | Applica una licenza valida con `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Questi consigli rendono il tuo flusso di lavoro più robusto, soprattutto quando **converti word in markdown** in pipeline di produzione. + +## Esempio completo (tutti i passaggi in un unico file) + +Di seguito trovi un’app console autonoma che puoi copiare‑incollare in un nuovo progetto .NET e farla partire subito. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Esegui il programma, apri `output.md` e vedrai le tue equazioni renderizzate come LaTeX pulito. Questa è la risposta completa a **come esportare latex** da un documento Word. + +## Conclusione + +Abbiamo coperto **come esportare LaTeX** da Word passo dopo passo, mostrando come **convertire Word in markdown**, **salvare word come markdown** e **esportare equazioni come LaTeX** usando Aspose.Words. L’idea centrale è semplice: carica il DOCX, regola `MarkdownSaveOptions` e lascia che la libreria faccia il lavoro pesante. + +Se sei pronto a automatizzare pipeline di documentazione, prova a concatenare questo codice con un generatore di siti statici come Hugo o Jekyll—basta spingere i file `.md` generati nel tuo repository e lasciare che il sito si ricostruisca. Per approfondire, consulta la guida Aspose “Export to LaTeX”, sperimenta con `HtmlSaveOptions` per anteprime web, o esplora l’API `DocumentVisitor` per trasformazioni personalizzate. + +Hai domande su casi limite, licenze o integrazione in CI/CD? Lascia un commento qui sotto, e buona programmazione! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/italian/net/programming-with-pdfsaveoptions/_index.md b/words/italian/net/programming-with-pdfsaveoptions/_index.md index dd622098b0..ce93fe80c2 100644 --- a/words/italian/net/programming-with-pdfsaveoptions/_index.md +++ b/words/italian/net/programming-with-pdfsaveoptions/_index.md @@ -24,28 +24,28 @@ Che tu voglia convertire documenti Word in PDF per la distribuzione online, l'ar ## Tutorial | Titolo | Descrizione | | --- | --- | -| [Visualizza il titolo del documento nella barra del titolo della finestra](./display-doc-title-in-window-titlebar/) | Scopri come visualizzare il titolo del documento nella barra del titolo della finestra dei tuoi PDF utilizzando Aspose.Words per .NET con questa guida dettagliata. +| [Visualizza il titolo del documento nella barra del titolo della finestra](./display-doc-title-in-window-titlebar/) | Scopri come visualizzare il titolo del documento nella barra del titolo della finestra dei tuoi PDF utilizzando Aspose.Words per .NET con questa guida dettagliata. | | [Avvisi di rendering PDF](./pdf-render-warnings/) | Guida dettagliata per gestire gli avvisi di rendering PDF con Aspose.Words per .NET. | | [Aggiungi firma digitale al PDF utilizzando il titolare del certificato](./digitally-signed-pdf-using-certificate-holder/) | Proteggi i tuoi file PDF con una firma digitale utilizzando Aspose.Words per .NET. Segui questa guida passo passo per aggiungere una firma digitale ai tuoi PDF senza sforzo. | | [Incorpora i font nel documento PDF](./embedded-all-fonts/) | Incorpora i font nei documenti PDF senza sforzo utilizzando Aspose.Words per .NET con questa guida dettagliata e passo passo. Garantisci un aspetto coerente su tutti i dispositivi. | | [Incorpora i font del sottoinsieme nel documento PDF](./embedded-subset-fonts/) Riduci le dimensioni dei file PDF incorporando solo i sottoinsiemi di font necessari utilizzando Aspose.Words per .NET. Segui la nostra guida passo passo per ottimizzare i tuoi PDF in modo efficiente. | | [Riduci le dimensioni del PDF disabilitando i font incorporati](./disable-embed-windows-fonts/) | Riduci le dimensioni del PDF disabilitando i font incorporati con Aspose.Words per .NET. Segui la nostra guida passo passo per ottimizzare i tuoi documenti e ottimizzarne l'archiviazione e la condivisione. | -| [Ottimizza le dimensioni del PDF saltando i caratteri Arial e Times Roman incorporati](./skip-embedded-arial-and-times-roman-fonts/) | Ottimizza le dimensioni dei PDF ignorando i font Arial e Times Roman incorporati utilizzando Aspose.Words per .NET. Segui questa guida passo passo per ottimizzare i tuoi file PDF. +| [Ottimizza le dimensioni del PDF saltando i caratteri Arial e Times Roman incorporati](./skip-embedded-arial-and-times-roman-fonts/) | Ottimizza le dimensioni dei PDF ignorando i font Arial e Times Roman incorporati utilizzando Aspose.Words per .NET. Segui questa guida passo passo per ottimizzare i tuoi file PDF. | | [Riduci le dimensioni del file PDF non incorporando i font principali](./avoid-embedding-core-fonts/) | Scopri come ridurre le dimensioni dei file PDF evitando di incorporare i font principali utilizzando Aspose.Words per .NET. Segui la nostra guida passo passo per ottimizzare i tuoi PDF. | | [Escape URI nel documento PDF](./escape-uri/) Scopri come eseguire l'escape degli URI nei PDF utilizzando Aspose.Words per .NET. Questa guida dettagliata ti guiderà passo dopo passo. | -| [Esporta intestazione, piè di pagina, segnalibri del documento Word in un documento PDF](./export-header-footer-bookmarks/) | Scopri come esportare i segnalibri di intestazione e piè di pagina da un documento Word in PDF utilizzando Aspose.Words per .NET con la nostra guida dettagliata. +| [Esporta intestazione, piè di pagina, segnalibri del documento Word in un documento PDF](./export-header-footer-bookmarks/) | Scopri come esportare i segnalibri di intestazione e piè di pagina da un documento Word in PDF utilizzando Aspose.Words per .NET con la nostra guida dettagliata. | | [Riduci le dimensioni del PDF con Scala i caratteri WMF alle dimensioni del Metafile](./scale-wmf-fonts-to-metafile-size/) | Guida passo passo per ridurre le dimensioni del PDF ridimensionando i font WMF alle dimensioni del metafile durante la conversione in PDF con Aspose.Words per .NET. | | [Migliora il posizionamento del testo PDF con il posizionamento aggiuntivo del testo](./additional-text-positioning/) | Scopri come migliorare il posizionamento del testo nei PDF con Aspose.Words per .NET in pochi semplici passaggi. Migliora l'aspetto del tuo documento. | | [Converti documento Word in PDF 1.7](./conversion-to-pdf-17/) | Converti senza sforzo i documenti Word in PDF 1.7 utilizzando Aspose.Words per .NET. Segui questa guida per garantire che i tuoi documenti siano universalmente accessibili e formattati professionalmente. | | [Riduci le dimensioni del documento PDF con il downsampling delle immagini](./downsampling-images/) | Riduci le dimensioni dei documenti PDF riducendo la dimensione delle immagini con Aspose.Words per .NET. Ottimizza i tuoi PDF per tempi di caricamento e download più rapidi. | | [Impostare le opzioni di struttura in un documento PDF](./set-outline-options/) | Scopri come impostare le opzioni di struttura in un documento PDF utilizzando Aspose.Words per .NET. Migliora la navigazione nei PDF configurando i livelli di intestazione e le strutture espanse. | -| [Esportare proprietà personalizzate in un documento PDF](./custom-properties-export/) | Scopri come esportare proprietà personalizzate in un documento PDF utilizzando Aspose.Words per .NET con la nostra guida dettagliata e passo dopo passo. +| [Esportare proprietà personalizzate in un documento PDF](./custom-properties-export/) | Scopri come esportare proprietà personalizzate in un documento PDF utilizzando Aspose.Words per .NET con la nostra guida dettagliata e passo dopo passo. | | [Esporta la struttura del documento Word in un documento PDF](./export-document-structure/) | Esporta la struttura di un documento Word in PDF con Aspose.Words per .NET. Segui la nostra guida passo passo per preservare il layout del documento e migliorare la navigazione nei PDF. | | [Compressione delle immagini in un documento PDF](./image-compression/) Scopri come comprimere le immagini nei documenti PDF utilizzando Aspose.Words per .NET. Segui questa guida per ottimizzare le dimensioni e la qualità dei file. | -| [Aggiorna l'ultima proprietà stampata nel documento PDF](./update-last-printed-property/) | Scopri come aggiornare l'ultima proprietà stampata in un documento PDF utilizzando Aspose.Words per .NET con la nostra guida dettagliata. -| [Rendering di effetti 3D DML 3D in un documento PDF](./dml-3deffects-rendering/) | Scopri come ottenere effetti DML 3D sorprendenti nei documenti PDF utilizzando Aspose.Words per .NET con questa guida completa passo dopo passo. +| [Aggiorna l'ultima proprietà stampata nel documento PDF](./update-last-printed-property/) | Scopri come aggiornare l'ultima proprietà stampata in un documento PDF utilizzando Aspose.Words per .NET con la nostra guida dettagliata. | +| [Rendering di effetti 3D DML 3D in un documento PDF](./dml-3deffects-rendering/) | Scopri come ottenere effetti DML 3D sorprendenti nei documenti PDF utilizzando Aspose.Words per .NET con questa guida completa passo dopo passo. | | [Interpolazione delle immagini in un documento PDF](./interpolate-images/) | Scopri come interpolare le immagini in un documento PDF utilizzando Aspose.Words per .NET con la nostra guida passo passo. Migliora facilmente la qualità delle immagini del tuo PDF. | - +| [Come salvare PDF da DOCX con Aspose.Words – Guida passo‑passo](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Scopri come convertire un documento DOCX in PDF usando Aspose.Words con istruzioni dettagliate passo‑passo. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/italian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/italian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..bd644b070c --- /dev/null +++ b/words/italian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-03-27 +description: Scopri come salvare un PDF da un file DOCX usando Aspose.Words. Include + la conversione da DOCX a PDF, il salvataggio del PDF con opzioni e la gestione delle + forme fluttuanti. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: it +og_description: Come salvare un PDF da un file DOCX usando Aspose.Words. Questa guida + mostra come convertire DOCX in PDF, salvare il PDF con opzioni e gestire le forme + fluttuanti. +og_title: Come salvare PDF da DOCX – Tutorial completo di Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Come salvare PDF da DOCX con Aspose.Words – Guida passo passo +url: /it/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come salvare PDF da DOCX con Aspose.Words – Tutorial completo + +Ti sei mai chiesto **come salvare PDF** da un documento Word senza perdere il layout delle forme fluttuanti? Non sei l'unico. In molti progetti—generatori di fatture, esportatori di report o semplici archiviatori di documenti—gli sviluppatori hanno bisogno di un modo affidabile per convertire DOCX in PDF mantenendo tutto esattamente come appare in Word. + +In questo tutorial vedremo come convertire un file DOCX in PDF **usando Aspose.Words per .NET**, ti mostreremo **come convertire docx in pdf** con opzioni di salvataggio personalizzate e spiegheremo perché il flag `ExportFloatingShapesAsInlineTag` è importante. Alla fine avrai uno snippet pronto‑da‑eseguire che salva PDF con le opzioni che controlli. + +## Cosa imparerai + +- I passaggi esatti per **convertire word document pdf** con Aspose.Words. +- Come configurare `PdfSaveOptions` per trattare le forme fluttuanti come tag inline. +- Problemi comuni quando si gestiscono oggetti fluttuanti e come evitarli. +- Un programma C# completo e eseguibile che puoi inserire in qualsiasi progetto .NET. + +> **Prerequisito:** È necessaria una licenza Aspose.Words per .NET (o una valutazione gratuita) e un ambiente di sviluppo .NET (Visual Studio, Rider o la CLI `dotnet`). + +## Passo 1: Configura il progetto e aggiungi Aspose.Words + +Per prima cosa, crea una nuova app console (o aggiungila a una esistente) e aggiungi il pacchetto NuGet Aspose.Words. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Consiglio professionale:** Se sei su un server CI, fissa la versione del pacchetto (`Aspose.Words --version 24.10`) per garantire build riproducibili. + +## Passo 2: Carica il DOCX contenente forme fluttuanti + +Immagini fluttuanti, caselle di testo o SmartArt possono causare spostamenti di layout durante la conversione. Il caricamento del documento è semplice, ma verificheremo anche che il file esista per evitare una `FileNotFoundException` a runtime. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Nota le istruzioni `Console.WriteLine`—forniscono un feedback rapido quando esegui l'app da un terminale. + +## Passo 3: Configura le opzioni di salvataggio PDF (Salva PDF con opzioni) + +Qui avviene la magia. Per impostazione predefinita Aspose.Words tenta di preservare gli oggetti fluttuanti così come appaiono, il che può rompere il layout nel PDF risultante. Impostare `ExportFloatingShapesAsInlineTag` su `true` indica alla libreria di trattare quelle forme come tag inline, garantendo che rimangano ancorate al testo circostante. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Perché è importante? Immagina una casella di testo che si sovrappone a un paragrafo. Senza la conversione inline‑tag, il PDF potrebbe spostare il paragrafo verso il basso o tagliare completamente la casella. Il flag mantiene intatta la relazione visiva—un dettaglio sottile ma cruciale per report professionali. + +## Passo 4: Salva il documento come PDF + +Ora scriviamo effettivamente il file PDF. Il metodo `Save` riceve sia il percorso di output sia le opzioni appena impostate. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Eseguendo il programma verrà generato `output.pdf` nella stessa cartella del tuo DOCX di origine. Aprilo in qualsiasi visualizzatore PDF e dovresti vedere che tutte le forme fluttuanti sono renderizzate esattamente dove dovrebbero. + +## Esempio completo funzionante + +Di seguito trovi l'intero programma in un unico blocco. Copialo e incollalo in `Program.cs` (o in qualsiasi file C#) e premi **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Risultato atteso + +- **File creato:** `output.pdf` nella directory di destinazione. +- **Fedeltà del layout:** Le forme fluttuanti (immagini, caselle di testo, SmartArt) appaiono inline con il testo circostante. +- **Nessuna eccezione:** Il programma termina correttamente, stampando messaggi di stato sulla console. + +## Domande frequenti & casi particolari + +| Domanda | Risposta | +|----------|--------| +| **E se ho bisogno di una qualità immagine più alta?** | Set `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Posso convertire più file DOCX in batch?** | Avvolgi la logica di caricamento/salvataggio in un ciclo `foreach (var file in Directory.GetFiles(..., "*.docx"))`. Ricorda di riutilizzare una singola istanza di `PdfSaveOptions` per le prestazioni. | +| **Funziona con .NET Core?** | Assolutamente. Aspose.Words 24.x supporta .NET Standard 2.0+, quindi puoi eseguire lo stesso codice su Windows, Linux o macOS. | +| **E i file DOCX protetti da password?** | Caricali con `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. Le stesse `PdfSaveOptions` si applicano al salvataggio. | +| **La conversione inline‑tag è sicura per tabelle complesse?** | Generalmente sì, ma layout di tabelle molto intricati con forme sovrapposte potrebbero comunque richiedere aggiustamenti manuali. Testa un campione rappresentativo prima di una migrazione di massa. | + +## Consigli per progetti reali + +- **Logga, non solo `Console.WriteLine`** – In produzione, sostituisci l'output della console con un framework di logging (Serilog, NLog) per catturare gli errori. +- **Rilascia le risorse** – `Document` implementa `IDisposable`. Avvolgilo in un blocco `using` se stai elaborando molti file per liberare rapidamente la memoria. +- **Valida il PDF** – Usa un validatore PDF (ad esempio, un controllore di conformità PDF/A) se ti servono PDF di livello archivistico. +- **Elaborazione parallela** – Per carichi di lavoro massivi, considera `Parallel.ForEach` con `PdfSaveOptions` thread‑safe (clona per thread) per velocizzare la conversione. + +## Conclusione + +Abbiamo coperto **come salvare PDF** da un file DOCX usando Aspose.Words, dimostrato **come convertire docx in pdf** con opzioni personalizzate e spiegato l'impatto di `ExportFloatingShapesAsInlineTag`. L'esempio completo e eseguibile mostra che puoi **convertire word document pdf** in poche righe, e ora sai come **salvare pdf con opzioni** adatte alle esigenze di qualità e conformità del tuo progetto. + +Pronto per la prossima sfida? Prova a esportare in altri formati (ad es., HTML, EPUB) con `document.Save("output.html")`, o sperimenta la conformità PDF/A per l'archiviazione a lungo termine. Gli stessi principi—caricare, configurare le opzioni, salvare—si applicano a tutti i casi. + +Buona programmazione, e che i tuoi PDF siano sempre esattamente come li hai immaginati! + +![Diagramma che illustra come un file DOCX viene caricato, le opzioni vengono applicate e viene prodotto un PDF – come salvare pdf](https://example.com/images/how-to-save-pdf-diagram.png "diagramma come salvare pdf") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/italian/net/programming-with-shapes/_index.md b/words/italian/net/programming-with-shapes/_index.md index 7005679edf..42ac969217 100644 --- a/words/italian/net/programming-with-shapes/_index.md +++ b/words/italian/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Utilizzando Aspose.Words per .NET e seguendo questi tutorial, imparerai a manipo | [Rileva la forma artistica intelligente](./detect-smart-art-shape/) | Scopri come rilevare le forme SmartArt nei documenti Word utilizzando Aspose.Words per .NET con questa guida completa. Perfetta per automatizzare il flusso di lavoro dei tuoi documenti. | | [Aggiorna disegno Smart Art](./update-smart-art-drawing/) | Scopri come aggiornare i disegni Smart Art nei documenti Word utilizzando Aspose.Words per .NET con questa guida passo passo. Assicurati che le tue immagini siano sempre precise. | | [Crea forma rettangolare in Word con Aspose.Words – Guida passo‑passo](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Scopri come creare una forma rettangolare in un documento Word usando Aspose.Words per .NET con questa guida passo‑passo. | +| [Crea documento Word C# – Aggiungi forma con ombra](./create-word-document-c-add-shape-with-shadow/) | Scopri come aggiungere una forma con ombra a un documento Word usando Aspose.Words per .NET con questa guida passo passo. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/italian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/italian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..fb24b70db6 --- /dev/null +++ b/words/italian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,203 @@ +--- +category: general +date: 2026-03-27 +description: Crea un documento Word in C# e impara come aggiungere una forma, applicare + un'ombra alla forma e impostare la distanza dell'ombra. Guida passo‑passo per Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: it +og_description: Crea un documento Word in C# con una forma rettangolare e un'ombra + personalizzata. Segui questo tutorial completo per impostare la distanza e lo stile + dell'ombra. +og_title: Crea documento Word in C# – Aggiungi forma con ombra +tags: +- Aspose.Words +- C# +- Document Automation +title: Crea documento Word C# – Aggiungi forma con ombra +url: /it/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Crea Documento Word C# – Aggiungi Forma con Ombra + +Hai mai avuto bisogno di **create word document c#** che contenga un rettangolo ben stilizzato? Forse stai creando un modello di report e vuoi un'ombra leggera per far risaltare il layout. In questo tutorial vedremo esattamente questo – come aggiungere una forma, applicare l'ombra alla forma e persino regolare la distanza dell'ombra usando Aspose.Words. + +Inizieremo con un documento vuoto, inseriremo un rettangolo, gli assegneremo un'ombra predefinita e termineremo salvando il file. Alla fine avrai un .docx pronto all'uso che potrai aprire in Word e vedere l'effetto immediatamente. Nessuno strumento esterno, solo puro codice C#. + +## Prerequisiti + +- .NET 6 (o qualsiasi versione recente del .NET Framework) installato. +- Visual Studio 2022 o VS Code con estensione C#. +- Pacchetto NuGet Aspose.Words per .NET (`Aspose.Words` versione 23.12 o successiva). + Puoi aggiungerlo tramite la Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +È tutto – non sono richiesti DLL aggiuntivi o interop COM. + +## Passo 1: Inizializza un Nuovo Documento e Builder – *create word document c#* Basics + +Per prima cosa abbiamo bisogno di un oggetto `Document` che rappresenta il file Word e di un `DocumentBuilder` per modificarlo. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Perché questo passo è importante:** La classe `Document` è il contenitore di tutte le parti di Word (pagine, stili, immagini). Il builder è l'API di alto livello che astrae la manipolazione dei nodi a basso livello, rendendo facile **create word document c#** senza dover gestire direttamente l'XML. + +## Passo 2: Inserisci una Forma Rettangolo – *how to create rectangle* + +Ora inseriremo un rettangolo nella pagina. La dimensione è espressa in punti (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Consiglio professionale:** Se ti serve una forma diversa, basta sostituire `ShapeType.Rectangle` con `ShapeType.Ellipse`, `ShapeType.Triangle`, ecc. Lo stesso codice funziona per **how to add shape** di qualsiasi tipo. + +## Passo 3: Applica un'Ombra Predefinita e Regolala – *apply shadow to shape* + +Aspose.Words fornisce diversi formati di ombra predefiniti. Useremo `Preset1` e poi personalizzeremo distanza, sfocatura, trasparenza e colore. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Perché personalizzare l'ombra?** La proprietà `Distance` controlla a che distanza l'ombra si trova dal rettangolo – pensala come il “sollevamento” che vedresti in un rendering 3‑D. Modificando `BlurRadius` si ammorbidiscono i bordi, mentre `Transparency` ti permette di creare un aspetto sottile e professionale. Questo soddisfa il requisito **set shadow distance** e ti mostra come **apply shadow to shape** in modo flessibile. + +## Passo 4: Salva il Documento – *create word document c#* Completion + +Infine, scrivi il documento su disco. Regola il percorso a una cartella in cui hai i permessi di scrittura. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Apri il file risultante in Microsoft Word, e vedrai un rettangolo azzurro chiaro con un'ombra grigia morbida spostata di 5 pt. Questa è la prova visiva che hai creato con successo **create word document c#** con una forma stilizzata. + +![Crea Documento Word C# con Forma Ombreggiata](shadow-example.png){: .img alt="create word document c# esempio che mostra un rettangolo con ombra"} + +## Variazioni Opzionali & Casi Limite + +| Scenario | Cosa Cambiare | Perché è Importante | +|----------|----------------|----------------------| +| **Stile ombra diverso** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Ti offre un aspetto più drammatico senza codice aggiuntivo. | +| **Nessuna preimpostazione – ombra personalizzata** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Ometti `Format` e imposta manualmente `OffsetX`, `OffsetY`. | Controllo totale su direzione e profondità. | +| **Forme multiple** | Call `builder.InsertShape` again before saving. | Chiama nuovamente `builder.InsertShape` prima di salvare. | Utile per modelli complessi con icone, loghi, ecc. | +| **Compatibilità con versioni Aspose più vecchie** | Use `ShadowEffect` class (available in v20.x). | Usa la classe `ShadowEffect` (disponibile nella v20.x). | Garantisce che il tuo codice funzioni su progetti legacy. | +| **Salvataggio come PDF** | `document.Save("ShadowShape.pdf");` | `document.Save("ShadowShape.pdf");` | La stessa resa dell'ombra appare nell'output PDF. | + +> **Domanda comune:** *Cosa succede se l'ombra non appare in Word?* +> Assicurati di utilizzare una versione recente di Aspose.Words (≥ 22.9). Le versioni più vecchie avevano un supporto limitato per le ombre. Verifica anche che il documento sia aperto in una versione recente di Word (2016+). + +## Esempio Completo Funzionante + +Di seguito trovi il programma completo, pronto per il copia‑incolla. Include tutte le direttive `using`, i commenti e la gestione degli errori per un'esperienza fluida. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Esegui il programma, vai a `C:\Temp\ShadowShape.docx` e vedrai il rettangolo con l'ombra esatta che abbiamo configurato. + +## Riepilogo & Prossimi Passi + +- Ora sai come **create word document c#**, inserire un rettangolo e **apply shadow to shape** con una **set shadow distance** personalizzata. +- L'esempio utilizza Aspose.Words, che astrae le complessità di OpenXML e garantisce un rendering coerente su tutte le versioni di Word. +- Vuoi andare oltre? Prova a combinare più forme, aggiungere testo all'interno del rettangolo o esportare lo stesso documento come PDF per vedere come l'ombra viene tradotta. + +### Argomenti Correlati che Potresti Esplorare + +- **How to add shape** a un header/footer per il branding. +- Usare **Aspose.Words** per inserire grafici e tabelle programmaticamente. +- Personalizzare **shadow effects** su immagini invece che su forme vettoriali. +- Automatizzare la generazione di documenti in massa per fatture o certificati. + +Sentiti libero di sperimentare, rompere il codice e poi ricostruirlo – è il modo più veloce per interiorizzare i concetti. Se incontri un problema, lascia un commento qui sotto o consulta la documentazione ufficiale di Aspose.Words per approfondimenti più dettagliati sull'API. + +Buon coding e divertiti a rendere i tuoi file Word un po' più curati! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/italian/net/programming-with-txtsaveoptions/_index.md b/words/italian/net/programming-with-txtsaveoptions/_index.md index 63b26d774e..6aa42c07ab 100644 --- a/words/italian/net/programming-with-txtsaveoptions/_index.md +++ b/words/italian/net/programming-with-txtsaveoptions/_index.md @@ -25,6 +25,7 @@ Grazie a questi tutorial, potrai sfruttare appieno le funzionalità di Aspose.Wo | Titolo | Descrizione | | --- | --- | | [Aggiungere segni Bidi nel documento Word](./add-bidi-marks/) | Scopri come aggiungere marcatori bidirezionali (Bidi) nei documenti Word utilizzando Aspose.Words per .NET con questa guida. Garantisci il corretto orientamento del testo per i contenuti multilingue. | +| [Salva docx come txt – Guida completa per esportare le equazioni Word in LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Scopri come convertire documenti DOCX in file TXT mantenendo le equazioni Word e esportandole in formato LaTeX con Aspose.Words per .NET. | | [Usa il carattere di tabulazione per livello per l'indentazione dell'elenco](./use-tab-character-per-level-for-list-indentation/) | Scopri come creare elenchi multilivello con rientro a tabulazione utilizzando Aspose.Words per .NET. Segui questa guida per formattare gli elenchi in modo preciso nei tuoi documenti. | | [Usa il carattere spazio per livello per l'indentazione dell'elenco](./use-space-character-per-level-for-list-indentation/) | Scopri come creare elenchi multilivello con rientro tramite spazi in Aspose.Words per .NET. Guida passo passo per una formattazione precisa dei documenti. | diff --git a/words/italian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/italian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..a9041e1af1 --- /dev/null +++ b/words/italian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-03-27 +description: Salva docx come txt con Aspose.Words e converti Word in LaTeX. Scopri + come esportare le equazioni, mantenere il testo semplice e ottenere il markup LaTeX + in pochi minuti. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: it +og_description: Salva docx come txt usando Aspose.Words. Questa guida mostra come + convertire Word in LaTeX, esportare le equazioni e mantenere il documento in testo + semplice. +og_title: Salva docx come txt – Esporta le equazioni Word in LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Salva docx come txt – Guida completa all'esportazione delle equazioni Word + in LaTeX +url: /it/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Salva docx come txt – Esporta le equazioni Word in LaTeX + +Hai mai dovuto **salvare docx come txt** ma temuto di perdere la matematica avanzata contenuta nel tuo file Word? Non sei solo. In molti flussi di lavoro scientifici la versione in testo semplice di un documento è indispensabile, ma vuoi comunque che le equazioni rimangano come markup LaTeX pulito. + +In questo tutorial ti guideremo passo passo attraverso le operazioni necessarie per **convertire Word in LaTeX** usando Aspose.Words per .NET, così le tue equazioni verranno esportate correttamente mentre il resto del documento diventa un testo semplice ordinato. Alla fine saprai come **esportare le equazioni in LaTeX**, mantenere il resto del file come semplice testo, ed evitare le insidie più comuni che ostacolano i principianti. + +## Cosa imparerai + +- Come caricare un file *.docx* che contiene Office Math. +- Come impostare correttamente `TxtSaveOptions` affinché Aspose generi LaTeX per ogni equazione. +- Come salvare il risultato in un file **save word plain text** che puoi inserire in un sistema di versionamento, pipeline CI, o qualsiasi strumento a valle. +- Casi limite comuni—cosa fare quando un documento mescola immagini ed equazioni, o quando è necessario preservare i caratteri Unicode. +- Un esempio di codice completo, pronto all'uso, da inserire in un'app console. + +### Prerequisiti + +- .NET 6.0 o successivo (il codice funziona anche con .NET Framework 4.7+). +- Una copia con licenza di **Aspose.Words for .NET** (la versione di prova è sufficiente per i test). +- Visual Studio 2022 o qualsiasi IDE in grado di compilare progetti C#. +- Un documento Word (`input.docx`) che contenga già alcuni oggetti Office Math. + +> **Suggerimento professionale:** Se non hai ancora una licenza, puoi richiedere una chiave temporanea dal sito di Aspose—basta sostituire il segnaposto nel codice con la tua chiave prima di eseguire. + +## Passo 1 – Installa Aspose.Words via NuGet + +Prima di tutto: devi aggiungere la libreria al tuo progetto. Apri la **Package Manager Console** ed esegui: + +```powershell +Install-Package Aspose.Words +``` + +Quella singola riga scarica tutto il necessario, incluso lo spazio dei nomi `Saving` dove risiede `TxtSaveOptions`. Nessun DLL extra, nessuna dipendenza nativa—solo codice gestito puro. + +## Passo 2 – Carica il documento Word di origine + +Ora leggiamo effettivamente il file che contiene le equazioni. La classe `Document` astrae l'intera struttura *.docx*, così puoi trattarla come un modello di oggetti di alto livello. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Perché è importante:** Caricare il documento subito ti permette di ispezionare il suo albero di nodi. Se salti questo controllo e il file non contiene equazioni, otterrai comunque un file txt pulito—ma non saprai perché l'output LaTeX è vuoto. + +## Passo 3 – Configura TxtSaveOptions per l'esportazione LaTeX + +Aspose ti offre un controllo granulare su come viene renderizzato Office Math. Impostando `OfficeMathExportMode` su `LaTeX`, ogni equazione viene trasformata nella sua controparte LaTeX invece di essere rimossa o convertita in immagine. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Perché è importante:** La modalità di esportazione predefinita eliminerebbe le equazioni del tutto. Passare a `LaTeX` mantiene l'intento matematico, esattamente ciò di cui hai bisogno quando successivamente invii il file a un compilatore LaTeX o a un processore markdown che riconosce la sintassi `$…$`. + +## Passo 4 – Salva il documento come testo semplice + +Con le opzioni configurate, persistere il file è una singola riga. L'output sarà un file `.txt` dove ogni equazione appare come codice LaTeX racchiuso da delimitatori `$` (puoi cambiarli in seguito se preferisci blocchi `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Risultato atteso + +Apri `output.txt` in qualsiasi editor e vedrai qualcosa di simile: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Nota come il testo normale rimane esattamente com'era, mentre le equazioni sono ora stringhe LaTeX pure. Puoi copiarle e incollarle direttamente in un documento LaTeX, in un notebook Jupyter, o in qualsiasi strumento che renda la matematica. + +## Passo 5 – Gestione dei casi limite + +### Contenuto misto (Immagini + Equazioni) + +Se il tuo file Word contiene anche immagini, Aspose le ignorerà quando usi `TxtSaveOptions`. Questo di solito va bene per un flusso di lavoro **save word plain text**, ma se ti servono le immagini come segnaposto puoi: + +1. Esportare il documento in HTML prima (`HtmlSaveOptions`) per catturare le immagini come tag ``. +2. Eseguire un secondo passaggio con `TxtSaveOptions` per ottenere le equazioni LaTeX. +3. Unire i due risultati manualmente o con un piccolo script. + +### Simboli Unicode + +Alcune equazioni usano caratteri Unicode speciali (ad es., lettere greche). Impostare `Encoding = Encoding.UTF8` in `TxtSaveOptions` (come mostrato nel Passo 3) garantisce che quei simboli sopravvivano alla conversione. + +### Documenti di grandi dimensioni + +Per file molto grandi (> 100 MB), considera lo streaming dell'operazione di salvataggio: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Lo streaming evita di caricare l'intero output in memoria, il che può salvare la vita su agenti di build con poca RAM. + +## Esempio completo funzionante + +Di seguito trovi il programma completo, pronto per il copia‑incolla, che mette insieme tutti i passaggi. Sostituisci i percorsi dei file e, se ne possiedi una, la riga della licenza. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Esegui il programma (`dotnet run` se usi un progetto console) e controlla `output.txt`. Hai appena **salvato docx come txt** mantenendo ogni equazione in LaTeX—senza necessità di copia manuale. + +## Domande frequenti + +**D: Posso cambiare il delimitatore da `$…$` a `\(...\)`?** +R: Sì. Dopo il salvataggio, esegui una semplice sostituzione sul file: `output = output.Replace("$", @"\(").Replace("$", @"\)");`—fai attenzione a non sostituire i caratteri `$` inline che appartengono al testo originale. + +**D: Funziona con file Word 2007‑2019?** +R: Assolutamente. Aspose.Words supporta `.doc`, `.docx`, `.docm` e anche la famiglia più recente `.dotx`. Lo stesso codice funziona su tutte le versioni. + +**D: E se devo conservare la formattazione originale dei paragrafi (tabulazioni, spazi multipli)?** +R: Imposta `txtSaveOptions.PreserveTableLayout = true;` e `txtSaveOptions.PreserveSpace = true;` per mantenere intatti gli spazi bianchi. + +## Conclusione + +Abbiamo coperto tutto ciò che serve per **salvare docx come txt** mentre **esporti le equazioni in LaTeX** usando Aspose.Words. I passaggi chiave sono: caricare il documento, configurare `TxtSaveOptions` con `OfficeMathExportMode.LaTeX`, e salvare il risultato. Con queste tre righe di codice puoi convertire in modo affidabile **word to latex**, mantenere il documento come **save word plain text**, ed evitare la perdita temuta dei simboli matematici. + +Pronto per la prossima sfida? Prova a concatenare questo flusso con un generatore markdown per produrre un file `.md` completo che includa sia testo che LaTeX—perfetto per documentazione su Git o generatori di siti statici. Oppure esplora `PdfSaveOptions` di Aspose per ottenere una versione PDF accanto al file di testo semplice. + +Se incontri problemi, lascia un commento qui sotto. Buona programmazione, e goditi la semplicità di trasformare le equazioni Word in LaTeX pulito! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/italian/net/working-with-fonts/_index.md b/words/italian/net/working-with-fonts/_index.md index 7049c8dca1..04d0581c86 100644 --- a/words/italian/net/working-with-fonts/_index.md +++ b/words/italian/net/working-with-fonts/_index.md @@ -48,7 +48,7 @@ Che tu voglia formattare il testo con diversi font, impostare regole di sostituz | [Ricevi notifica di avviso](./receive-warning-notification/) Scopri come ricevere una notifica di avviso quando usi Aspose.Words per .NET e come gestire eventuali problemi o avvisi nei tuoi documenti. | [Esempio di sorgente del font Steam Resource](./resource-steam-font-source-example/) | Scopri come utilizzare Resource Stream Font Source per caricare font personalizzati in Aspose.Words per .NET. | | [Ottieni la sostituzione senza suffissi](./get-substitution-without-suffixes/) | In questo tutorial imparerai come ottenere override senza suffisso in un documento Word con Aspose.Words per .NET. | - +| [Sostituzione dei Font Aspose – Come Configurare le Impostazioni dei Font in C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Scopri come configurare le impostazioni dei font e gestire la sostituzione dei font in Aspose.Words per .NET usando C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/italian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/italian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..31c4f60a6f --- /dev/null +++ b/words/italian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,237 @@ +--- +category: general +date: 2026-03-27 +description: 'Sostituzione dei font Aspose semplificata: impara a configurare le impostazioni + dei font, catturare gli avvisi e gestire i font mancanti nelle tue app .NET.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: it +og_description: Padroneggia la sostituzione dei font Aspose configurando le impostazioni + dei font e gestendo i font mancanti con una callback di avviso. Guida completa in + C#. +og_title: Sostituzione dei Font Aspose – Configura le Impostazioni dei Font in C# +tags: +- Aspose.Words +- C# +- Font Management +title: Sostituzione dei Font Aspose – Come Configurare le Impostazioni dei Font in + C# +url: /it/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Sostituzione dei Font Aspose – Guida Completa per Configurare le Impostazioni dei Font + +Ti è mai capitato di aprire un documento che improvvisamente sostituisce il tuo carattere personalizzato con qualcosa di generico? È la **aspose font substitution** al lavoro—sostituendo i font mancanti con la corrispondenza più vicina che riesce a trovare. È comodo, ma se hai bisogno di sapere *esattamente* quale font è stato sostituito, devi accedere al sistema di avvisi della libreria e configurare le impostazioni dei font da solo. + +In questo tutorial percorreremo uno scenario reale: caricare un DOCX che fa riferimento a un font che non possiedi, catturare l'evento di sostituzione e stampare un messaggio amichevole sulla console. Alla fine sarai a tuo agio con **configure font settings**, configurando un **Aspose.Words warning callback**, e potrai estendere l'esempio per adattarlo a qualsiasi flusso di lavoro. + +> **Cosa ti servirà** +> • .NET 6+ (or .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • Un DOCX che fa riferimento a un font mancante (lo chiameremo `MissingFont.docx`) + +Iniziamo. + +--- + +## Passo 1: Installa Aspose.Words e Prepara il Progetto + +Prima di scrivere qualsiasi codice, assicurati che il pacchetto Aspose.Words sia referenziato: + +```bash +dotnet add package Aspose.Words +``` + +> **Consiglio professionale:** usa l'ultima versione stabile; a partire da marzo 2026 è la 23.11.0. Le versioni più recenti migliorano gli algoritmi di corrispondenza dei font e aggiungono nuovi tipi di avviso. + +Crea una nuova applicazione console (o inserisci il codice in un progetto esistente) e aggiungi le consuete direttive `using`: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Questi namespace ci danno accesso a `Document`, `LoadOptions` e alle classi correlate ai font di cui avremo bisogno. + +## Passo 2: Configura le Impostazioni dei Font con LoadOptions + +Il cuore del controllo **aspose font substitution** risiede in `LoadOptions.FontSettings`. Fornendo un oggetto `FontSettings` vuoto, diciamo ad Aspose di usare i percorsi di ricerca predefiniti *e* di segnalare qualsiasi sostituzione tramite un callback di avviso. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Perché non affidarsi semplicemente alle impostazioni predefinite? Perché collegare un callback di avviso (passo successivo) funziona solo quando la proprietà `FontSettings` non è null. Questa piccola riga ci fornisce un hook nel processo di sostituzione senza modificare il comportamento di ricerca dei font. + +## Passo 3: Collega un Callback di Avviso per Catturare le Sostituzioni + +Aspose.Words implementa l'interfaccia `IWarningCallback`. Ogni volta che accade qualcosa di degno di nota—come un font mancante—chiama il nostro metodo `Warning`. Implementeremo un piccolo gestore che filtra per `WarningType.FontSubstitution` e stampa la descrizione. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +Ecco il gestore stesso: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Perché è importante** – Senza il callback, Aspose sostituisce i font silenziosamente e non sai mai quale è stato usato. Il callback rende il processo trasparente, il che è essenziale per la segnalazione di conformità o per il debug di problemi di layout. + +## Passo 4: Carica il Documento Usando le Opzioni Configurate + +Ora carichiamo finalmente il documento, passando le `loadOptions` appena preparate. Se il file di origine fa riferimento a un font non installato, il nostro gestore verrà attivato. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Sostituisci `YOUR_DIRECTORY` con il percorso reale dove si trova `MissingFont.docx`. Quando esegui il programma, dovresti vedere un output simile a: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Quella riga ti dice esattamente quale font mancava e quale fallback ha scelto Aspose. + +## Passo 5: (Opzionale) Ottimizza i Percorsi di Ricerca dei Font + +Se hai una cartella privata con font aziendali, puoi indicare ad Aspose dove cercare prima di ricorrere ai font di sistema. Questo è un uso avanzato di **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Impostare `recursive: true` fa sì che Aspose scandisca anche le sottocartelle. Ora la libreria proverà prima i tuoi font privati, riducendo la probabilità di sostituzioni indesiderate. + +## Esempio Completo Funzionante + +Mettendo tutto insieme, ecco il programma completo, pronto per l'esecuzione: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Output previsto** (quando si incontra un font mancante): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Se tutti i font sono presenti, il programma gira silenziosamente (senza avvisi) e produce comunque il PDF. + +## Domande Frequenti & Casi Limite + +### Cosa succede se devo *impedire* la sostituzione del tutto? + +Imposta `FontSettings.SubstitutionSettings` a `null` o usa `FontSettings.FontSubstitutionSettings` per controllare il comportamento. Per esempio: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Ora Aspose lancerà un'eccezione invece di sostituire silenziosamente, che può essere catturata e gestita. + +### Funziona con altri formati di file (ad es., .doc, .rtf)? + +Assolutamente. Lo stesso oggetto `LoadOptions` può essere passato a qualsiasi costruttore `Document` che accetta un percorso di file. Il callback di avviso verrà attivato per tutti i formati che dipendono dai font. + +### Posso catturare il nome *esatto* del font di fallback? + +Sì. La stringa `info.Description` contiene sia il font mancante sia il sostituto. Se ti serve il nome programmaticamente, puoi analizzarla o usare l'oggetto `FontInfo` (disponibile nelle versioni più recenti). + +### Come si comporta in un ambiente multi‑thread? + +`FontSettings` **non** è thread‑safe. Crea un `LoadOptions` separato (con il proprio `FontSettings`) per ogni thread, o proteggi l'accesso con un lock. + +## Conclusione + +Abbiamo coperto tutto ciò di cui hai bisogno per padroneggiare **aspose font substitution** e **configure font settings** in un'applicazione C#: + +1. Installa Aspose.Words e aggiungi le dichiarazioni `using` necessarie. +2. Crea un oggetto `LoadOptions` con un nuovo `FontSettings`. +3. Collega un `IWarningCallback` personalizzato per evidenziare gli eventi di sostituzione. +4. Carica il documento, lasciando che il callback segnali eventuali font mancanti. +5. (Opzionale) Estendi il percorso di ricerca o disabilita completamente la sostituzione. + +Con questo modello puoi registrare i font mancanti per la conformità, avvisare gli utenti in un'interfaccia UI, o incorporare automaticamente font di fallback prima della pubblicazione. Successivamente, potresti esplorare le **politiche di sostituzione dei font di Aspose.Words** o integrare il flusso di lavoro in una pipeline di elaborazione documenti più ampia. + +Buona programmazione, e che i tuoi documenti vengano sempre visualizzati con il carattere corretto! + +--- + +![Diagramma che mostra Aspose.Words caricare un documento, invocare FontSettings, attivare un callback di avviso e visualizzare le informazioni di sostituzione](image-placeholder.png "flusso di lavoro della sostituzione dei font Aspose") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/japanese/net/basic-conversions/_index.md b/words/japanese/net/basic-conversions/_index.md index d77fb6e793..97ff77e489 100644 --- a/words/japanese/net/basic-conversions/_index.md +++ b/words/japanese/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ | [Word から LaTeX をエクスポートする方法 – ステップバイステップ ガイド](./how-to-export-latex-from-word-step-by-step-guide/) Aspose.Words for .NET を使用して、Word 文書を LaTeX 形式にエクスポートする方法をステップバイステップで解説します。 | | [C# で Word を PDF に変換する – ガイド](./convert-word-to-pdf-in-c-using-aspose-words-guide/) Aspose.Words for .NET を使用して C# で Word 文書を PDF に変換する方法を、ステップバイステップで解説します。コード例付きで開発者に最適です。 | | [Aspose.WordsでWordをPDFとして保存 – 完全なC#ガイド](./save-word-as-pdf-with-aspose-words-complete-c-guide/) Aspose.Words for .NET を使用して C# で Word 文書を PDF に変換する完全ガイドです。コード例付きで開発者に最適です。 | +| [Aspose.WordsでWordをPDFに変換する – 完全ガイド](./convert-word-to-pdf-with-aspose-words-complete-guide/) Aspose.Words for .NET を使用して C# で Word 文書を PDF に変換する完全ガイドです。コード例付きで開発者に最適です。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/japanese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/japanese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..e5be9ced4e --- /dev/null +++ b/words/japanese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words を使用して Word を PDF に迅速に変換します。Word を PDF として保存する方法、docx を PDF + にエクスポートする方法、そして C# でアクセシブルな PDF を生成する方法を学びましょう。 +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: ja +og_description: Aspose.Words を使用して C# で Word を PDF に変換します。このガイドでは、Word を PDF として保存する方法、docx + を PDF にエクスポートする方法、アクセシブルな PDF を生成する方法を示します。 +og_title: Aspose.WordsでWordをPDFに変換 – ステップバイステップ +tags: +- Aspose.Words +- C# +- PDF conversion +title: Aspose.WordsでWordをPDFに変換する – 完全ガイド +url: /ja/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose.Words で Word を PDF に変換する完全ガイド + +サードパーティのウェブツールを使わずに **Word を PDF に変換** したいと思ったことはありませんか？自動レポートエンジンを構築していて、リアルタイムで *save word as pdf* が必要な場合などに最適です。良いニュースは、Aspose.Words を使えばこのプロセスはとても簡単で、**PDF/UA‑2** に準拠したファイルも作成できるので、アクセシビリティ要件にも対応できます。 + +このチュートリアルでは、`.docx` の読み込み、PDF オプションの設定（PDF/UA 準拠で *export docx to pdf* できるように）、そして最終的にアクセシブルな PDF として保存する手順をすべて解説します。最後まで読めば、任意の .NET プロジェクトに貼り付け可能な、実運用レベルのコードスニペットが手に入ります。 + +![Aspose.Words を使用した Word から PDF への変換](convert-word-to-pdf.png) + +## 学べること + +- **なぜ Aspose.Words が *generate accessible pdf* シナリオに適しているのか**。 +- PDF/UA‑2 準拠で *save document as pdf* する正確な手順。 +- フォントが見つからない場合やパスワード保護されたソースファイルへの対処方法。 +- 出力結果のデバッグとアクセシビリティ準拠の確認に役立つクイックヒント。 + +### 前提条件 + +- .NET 6 以降（API は .NET Framework 4.6+ でも動作）。 +- 有効な Aspose.Words for .NET ライセンス（評価用の無料トライアルでも可）。 +- 基本的な C# の知識—特別なデザインパターンは不要です。 + +これらが揃っていれば、さっそく始めましょう。 + +--- + +## Word を PDF に変換する – 手順別実装 + +解決策を 5 つのステップに分けて解説します。各ステップは見出し、短いコード抜粋、そしてコードが重要な理由の説明で構成されています。 + +### ステップ 1: 変換したい Word ドキュメントを読み込む + +最初に必要なのは、ソースファイルを表す `Document` オブジェクトです。Aspose.Words は **.docx**、**.doc**、**.rtf** など多数の形式を読み取れるため、元の作成方法に関係なく *save word as pdf* が可能です。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**このステップが重要な理由:** +- 早い段階でファイルの有無を確認でき、無駄な CPU サイクルを消費しません。 +- `Document` クラスは Word ファイルの内部構造を抽象化し、扱いやすいオブジェクトモデルを提供します。 + +### ステップ 2: アクセシビリティ用 PDF 保存オプションを設定 + +*generate accessible pdf* が必要な場合、Aspose.Words に PDF/UA‑2 準拠のドキュメントを生成させる必要があります。`PdfSaveOptions` クラスで出力を細かく制御できます。 + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**このステップが重要な理由:** +- `PdfCompliance.PdfUa2` により、スクリーンリーダーが必要とするタグや構造情報、メタデータが PDF に追加されます。 +- フォント埋め込み (`EmbedFullFonts = true`) を設定すれば、別 OS で開いた際に「フォントが見つからない」警告が出ません。 +- `Title` を設定すると、支援技術が文書を正しく読み上げられます。 + +### ステップ 3: ドキュメントを PDF として保存 + +ソースの読み込みとオプション設定が完了したら、変換はワンライナーで完了です。ここが *export docx to pdf* のポイントです。 + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**このステップが重要な理由:** +- `Save` メソッドは設定した `PdfSaveOptions` を尊重し、アクセシビリティ機能が確実に組み込まれます。 +- `try/catch` でラップすることで、ライセンスエラーや権限エラーをログに記録したり、呼び出し元に通知したりできます。 + +### ステップ 4: PDF/UA 準拠を検証（任意だが推奨） + +Aspose.Words が大部分を自動で行ってくれますが、特に官公庁や規制対象の組織へ文書を提供する場合は、出力を二重チェックするのがベストプラクティスです。 + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**このステップが重要な理由:** +- `IsTagged` は簡易的なサニティチェックです。完全な PDF/UA 検証には専用バリデータが必要ですが、多くの準拠問題はタグ欠如として現れます。 +- フラグが `false` を返した場合は、`PdfSaveOptions` を再確認してください。`Compliance` の設定忘れや、元ドキュメントに見出しスタイルが不足している可能性があります。 + +### ステップ 5: よくある落とし穴とプロのコツ + +| 落とし穴 | 発生する問題 | 解決策 | +|---------|--------------|------------| +| **フォントが欠如** | PDF で文字が四角く表示される | `EmbedFullFonts = true` を設定 **または** サーバーに欠如フォントをインストール | +| **ライセンス未取得** | Aspose が各ページに透かしを付加 | アプリ起動時にライセンスファイル (`Aspose.Words.lic`) を読み込む（例: `License license = new License(); license.SetLicense("Aspose.Words.lic");`） | +| **パスワード保護されたソース** | `new Document(path)` で `InvalidOperationException` が発生 | `new Document(path, new LoadOptions { Password = "secret" })` のオーバーロードを使用 | +| **大容量ドキュメントで OOM** | 巨大ファイルでメモリ不足例外が発生 | `PdfSaveOptions` の `MemoryOptimization` を有効化 (`saveOptions.MemoryOptimization = true`) | +| **アクセシビリティタグが欠如** | PDF/UA 検証で失敗 | 元の Word ファイルで適切な見出しスタイル（`Heading 1`、`Heading 2` など）を使用する。Aspose が自動で PDF タグにマッピングします | + +**プロのコツ:** 多数のドキュメントをバッチ変換する場合は、`PdfSaveOptions` のインスタンスを再利用しましょう。1 回だけ作成すれば、割り当てオーバーヘッドが削減され、メモリ使用量も抑えられます。 + +--- + +## 完全動作サンプル（コピペで使用可能） + +以下はすべてをまとめたプログラムです。`Program.cs` として保存し、Aspose.Words と Aspose.PDF の NuGet パッケージを追加して実行してください。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**期待される結果:** +`C:\MyFiles` に `output.pdf` が生成されます。Adobe Acrobat で開くとコンプライアンスパネルに「PDF/A‑2b, PDF/UA‑1」と表示され、*convert word to pdf* が正常に完了したことが確認できます。 + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/japanese/net/programming-with-markdownsaveoptions/_index.md b/words/japanese/net/programming-with-markdownsaveoptions/_index.md index e40c007092..f5721f6c04 100644 --- a/words/japanese/net/programming-with-markdownsaveoptions/_index.md +++ b/words/japanese/net/programming-with-markdownsaveoptions/_index.md @@ -32,6 +32,9 @@ MarkdownSaveOptions を使用した Words Processing は、Aspose.Words for .NET | [Word から Markdown をエクスポートする方法 – 完全 C# ガイド](./how-to-export-markdown-from-word-complete-c-guide/) Aspose.Words for .NET を使用して、Word 文書を Markdown にエクスポートする完全な C# ガイドです。ステップバイステップで解説します。 | | [DOCX から Markdown にエクスポートする方法 – 完全ガイド](./how-to-export-markdown-from-docx-complete-guide/) Aspose.Words for .NET を使用して、DOCX 文書を Markdown にエクスポートする完全なガイドです。ステップバイステップで解説します。 | | [DOCX から Markdown に保存する方法 – ステップバイステップ ガイド](./how-to-save-markdown-from-docx-step-by-step-guide/) Aspose.Words for .NET を使用して、DOCX ファイルを Markdown に変換し保存する手順をステップバイステップで解説します。 | +| [Word から LaTeX をエクスポート – DOCX を Markdown に変換](./how-to-export-latex-from-word-convert-docx-to-markdown/) Aspose.Words for .NET を使用して、Word 文書から LaTeX をエクスポートし、DOCX を Markdown に変換する方法をステップバイステップで解説します。 | +| [DOCX から LaTeX をエクスポート – Markdown に変換](./how-to-export-latex-from-docx-convert-to-markdown/) Aspose.Words for .NET を使用して、DOCX から LaTeX をエクスポートし、Markdown に変換する手順を詳しく解説します。 | +| [Word から Markdown を作成 – 完全 C# ガイド](./create-markdown-from-word-full-c-guide/) Aspose.Words for .NET を使用して、Word 文書を Markdown に変換する完全な C# ガイドです。ステップバイステップで解説します。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/japanese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/japanese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..08598c0a8e --- /dev/null +++ b/words/japanese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,251 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words C# を使用して Word から Markdown を作成します。docx を Markdown に変換し、Word + から画像を抽出し、コールバックの使い方を学べる単一チュートリアルです。 +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: ja +og_description: Aspose.Words を使用して Word から Markdown を作成します。このガイドでは、docx を Markdown + に変換し、Word から画像を抽出し、リソース処理のためにコールバックを使用する方法を示します。 +og_title: WordからMarkdownを作成する – 完全C#チュートリアル +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: WordからMarkdownを作成する – 完全C#ガイド +url: /ja/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word から Markdown を作成 – 完全な C# チュートリアル + +Word から **markdown を作成** したいと思ったことはありませんか？しかし、どこから始めればよいか分からないことも多いでしょう。多くの開発者が .docx ファイルの内容を静的サイトジェネレータやドキュメントリポジトリに移行しようとすると、この壁にぶつかります。良いニュースは、Aspose.Words を使えば **docx を markdown に変換** でき、元のファイルからすべての画像を抽出し、リソースの保存先を正確にコントロールできることです—すべてシンプルなコールバックで実現できます。 + +このガイドでは、Word から画像を抽出する方法、コールバックを使って保存する方法、そしてこのアプローチが自動化パイプラインで最も信頼できる理由を実例を交えて解説します。最後まで読めば、クリーンな `.md` ファイルと抽出された画像フォルダーを生成する、すぐに実行可能な C# プログラムが手に入ります。 + +> **プロのコツ:** すでにスクリーンショット、図、ロゴなどを含む Word テンプレートをお持ちの場合、この方法は手動でコピー＆ペーストすることなく、すべてのビジュアル要素をそのまま保持します。 + +--- + +## 必要なもの + +- **.NET 6+**（または .NET Framework 4.6+）。コードは最新のランタイムであれば動作します。 +- **Aspose.Words for .NET**（NuGet パッケージ `Aspose.Words`）。無料トライアルでほとんどのシナリオに対応できます。 +- テキストと少なくとも 1 枚の画像を含む **Word ドキュメント**（`input.docx`）。 +- C# と Visual Studio（またはお好みの IDE）に関する基本的な知識。 + +追加のライブラリは不要です。すべて Aspose.Words が処理します。 + +--- + +## 手順 1: プロジェクトの作成と Aspose.Words のインストール + +整理しやすくするために、新しいコンソールプロジェクトを作成します。 + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **この手順が重要な理由:** NuGet パッケージをインストールすると、バージョン 22.9 で導入された `MarkdownSaveOptions` クラスを含む最新 API が利用可能になります。これがなければ、独自のコンバータを実装しなければなりません。 + +--- + +## 手順 2: ソースの Word ドキュメントを読み込む + +最初のコード行で変換したい `.docx` を開きます。`YOUR_DIRECTORY` を実際のパスに置き換えてください。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **何が起きているか？** `Document` がファイルを解析し、内部 DOM を構築して、すべての段落、表、画像にアクセスできるようにします。ファイルが見つからない場合、Aspose は明確な `FileNotFoundException` をスローし、UI でのエラーハンドリングが可能です。 + +--- + +## 手順 3: リソース保存コールバック付き Markdown 保存オプションを設定する + +ここが **コールバックの使い方** の魔法です。コールバックを使うと、抽出された各画像の保存先を自由に決められます。 + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **なぜコールバックが必要か？** デフォルトでは Aspose は画像を base‑64 文字列として markdown に埋め込んでしまい、バージョン管理が困難になります。コールバックを使用すれば、ファイル名やフォルダー構造を完全にコントロールできます。 + +--- + +## 手順 4: ドキュメントを Markdown として保存する + +これで実際に `.md` ファイルを生成します。すべての画像は次の手順で定義したコールバックに渡されます。 + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +問題なく完了すれば、対象フォルダーに `Document.md` が作成され、`Resources` というサブフォルダーに元の Word ファイルから抽出されたすべての画像が格納されます。 + +--- + +## 手順 5: 抽出された画像を保存するコールバックを実装する + +以下は `MyResourceSaver` の完全実装です。`Resources` ディレクトリ（存在しない場合）を作成し、各画像に一意のファイル名を付けてストリームを書き込みます。 + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **引数の説明:** +> - `args.Index` – 一意性を保証する 0 から始まるカウンタ。 +> - `args.FileName` – Aspose が提案する元のファイル名（例: `image001.png`）。 +> - `args.Stream` – 画像バイトが書き込まれる出力ストリーム。 +> - `args.KeepResourceStreamOpen` – `false` に設定すると Aspose が自動的にストリームを破棄し、ファイルハンドルリークを防止します。 + +--- + +## 完全動作サンプル + +すべてをまとめた単一ファイルです。`Program.cs` にコピーして使用してください。`YOUR_DIRECTORY` は環境に合わせた絶対パスまたは相対パスに置き換えることを忘れずに。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### 期待される出力 + +- `YOUR_DIRECTORY/Document.md` – 標準的な markdown 画像リンクが含まれるファイル、例: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – `img_0.png`、`img_1.jpg` など、元の Word 文書に出現した順序で保存された画像が格納されます。 + +プログラム実行時に成功メッセージが表示され、処理が完了したことが確認できます。 + +--- + +## よくある質問 (FAQ) + +### Word から画像を抽出するときに画質が劣化しない方法は？ + +コールバックはバイナリストリームをそのままファイルに書き込むため、元の解像度が保持されます。独自の画像処理ロジックを追加しない限り、変換や圧縮は行われません。 + +### 抽出時に画像形式（例: PNG → JPEG）を変更できるか？ + +可能です。`ResourceSaving` 内で `args.FileName` や `args.Stream` を調べ、`System.Drawing` や `ImageSharp` で画像を読み込んで再エンコードすれば OK です。その際、markdown のリンク拡張子も合わせて更新してください。 + +### markdown の画像リンクをローカルフォルダーではなく CDN にしたい場合は？ + +コールバックで `args.FileName` に完全修飾 URL を設定すれば、画像を CDN にアップロードした後にその URL を markdown に埋め込めます。 + +### 表や脚注、その他高度な Word 機能は変換できるか？ + +はい。Aspose.Words は多くの Word 構造を markdown に変換します。表は markdown テーブルに、脚注は参照リンクに、入れ子リストも正しく処理されます。変換結果に違和感がある場合は、最新のリリースノートをご確認ください。Aspose は変換精度を継続的に改善しています。 + +### CI/CD パイプラインで docx を markdown に変換するには？ + +コンパイル済みの `.exe` をビルドステップに組み込み、生成された `.docx` アーティファクトを対象に実行し、生成された `.md` と `Resources/` フォルダーを静的サイトリポジトリにプッシュすれば完了です。プロセスが完全に決定論的なので、自動化環境でも問題なく動作します。 + +--- + +## まとめ + +Aspose.Words を使用して **Word から markdown を作成** する方法、**docx を markdown に変換** する全工程、そしてカスタム **コールバック** を使って **Word から画像を抽出** する実践的な手順を示しました。結果として、クリーンな markdown ファイルと元画像が格納されたフォルダーが得られ、ドキュメントサイトや静的ブログ、テキスト中心のワークフローに最適です。 + +次に検討できるステップ: + +- フォルダー内の複数 `.docx` を一括処理（`Directory.GetFiles` でループ）。 +- 画像の命名規則をカスタマイズ（例: 元のキャプションテキストを使用）。 +- markdown の画像リンクを CDN URL に置換するポストプロセス。 +- HTML、PDF、EPUB など、他の Aspose エクスポート形式を活用してマルチチャネル配信。 + +質問や変換がうまくいかない Word ファイルがあれば、下のコメント欄で教えてください。一緒にトラブルシューティングしましょう。コーディングを楽しんで、Word から markdown への変換のシンプルさを体感してください！ + +--- + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/japanese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/japanese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..082b2aeaf1 --- /dev/null +++ b/words/japanese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,269 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words を使用して DOCX から LaTeX をエクスポートする方法。DOCX を Markdown に変換し、DPI + を設定し、C# でリカバリを有効にする方法を学びます。 +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: ja +og_description: Aspose.Words を使用して DOCX から LaTeX をエクスポートする方法。このチュートリアルでは、Markdown + へのステップバイステップ変換、DPI の制御、リカバリモードを示します。 +og_title: DOCXからLaTeXをエクスポートする方法 – Markdownへ変換 +tags: +- Aspose.Words +- C# +- Document Conversion +title: DOCXからLaTeXをエクスポートする方法 – Markdownに変換 +url: /ja/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# DOCX から LaTeX をエクスポートする方法 – Markdown へ変換 + +DOCX ファイルから **LaTeX をエクスポート** する際に、数式の美しさを失わない方法を考えたことはありませんか？ あなただけではありません。私の経験では、最大の課題は OfficeMath オブジェクトを静的サイトジェネレータや科学ブログ向けのクリーンでポータブルな形式に変換することです。 + +このガイドでは Aspose.Words を使って DOCX を Markdown に変換する手順を解説し、**DPI の設定方法**、**リカバリを有効にする方法**、そして堅牢なパイプラインのための便利なコツをいくつか紹介します。最後まで読むと、LaTeX 方程式、高解像度画像、適切なハイパーリンク処理を備えた Markdown ファイルを生成する単一の C# プログラムが手に入ります。 + +## 必要なもの + +- **.NET 6+**（または .NET Framework 4.7.2 – API は同じです） +- **Aspose.Words for .NET**（2026年3月時点での最新安定版） +- 方程式、画像、リンクを含む DOCX ファイル +- Visual Studio、VS Code、またはお好みのエディタ + +Aspose.Words 以外に追加の NuGet パッケージは不要ですが、トライアルでない場合は有効なライセンスを用意してください。 + +## Step 1 – Strict Recovery Mode で DOCX を読み込む + +エクスポートを考える前に、ソースドキュメントに隠れた破損がないか確認する必要があります。ここで **リカバリを有効にする方法** が重要になります。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**なぜ Strict Recovery なのか？** +Aspose に問題を黙って修正させてしまうと、段落が抜け落ちたり画像が壊れたりして、LaTeX のエクスポート時に誰も望まない結果になります。早期に失敗させることで問題をすぐに検出し、ソース DOCX を修正するか、後でログに残すかを判断できます。 + +### プロ・ヒント +ロード処理を try/catch で囲み、`DocumentLoadingException` をログに記録しましょう。これにより CI パイプラインがビルド全体を止めずに問題のあるファイルをフラグできます。 + +## Step 2 – Markdown エクスポートオプションを設定する + +ドキュメントがメモリ上に安全にロードされたので、保存方法を構成します。これが **LaTeX をエクスポートする方法** の核心であり、埋め込み画像の **DPI の設定方法** も含まれます。 + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**各オプションの役割** + +| オプション | 理由 | キーワードとの関連性 | +|------------|------|------------------------| +| `OfficeMathExportMode = LaTeX` | 数式から **LaTeX をエクスポートする方法** に直接対応します。 | 主要キーワード | +| `ImageResolution = 300` | 画像品質を制御します – **DPI の設定方法** の答えです。 | 二次的 | +| `ResourceSavingCallback` | 埋め込みファイルをディスクに保存します。**DOCX を Markdown に変換** する際の一般的なニーズです。 | 二次的 | +| `EmptyParagraphExportMode` | クリーンな Markdown 出力を保証し、不要な HTML タグの混入を防ぎます。 | 変換品質全体の向上 | +| `LinkExportMode = AsReference` | リンクを読みやすく編集しやすくし、**DOCX を Markdown に変換** のもう一つの利点です。 | + +## Step 3 – カスタムリソースセーバーを実装する（任意だが便利） + +DOCX を Markdown に変換するとき、画像やその他のバイナリリソースはファイルシステム上の場所が必要です。Aspose は `IResourceSavingCallback` でその制御を可能にします。上のスニペットは最小実装を示していますが、ここで分解してみましょう。 + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**なぜやるのか？** +このステップを省くと、Aspose は画像を Base‑64 文字列として埋め込むため、Markdown ファイルのサイズが膨大になり、バージョン管理が苦痛になります。リソースを別フォルダーに保存すれば、Markdown が軽量になり、Hugo や Jekyll といった静的サイトジェネレータにも適します。 + +## Step 4 – ドキュメントを Markdown として保存する + +すべての重い処理は完了しました。残りは一行で最終ファイルを書き出すだけです。 + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +`output.md` を開くと次のようになります： + +- 数式が `$…$` の LaTeX ブロックとしてレンダリングされます +- 画像は `![Alt text](resources/image001.png)` として参照され、300 dpi の解像度です +- ハイパーリンクは参照スタイルに変換されます： + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +これが **DOCX を変換する方法** 全体の概要です。 + +## よくある質問とエッジケース + +### 1️⃣ DOCX にサポートされていないオブジェクトが含まれている場合は？ + +Aspose.Words は `FeatureNotSupportedException` をスローします。Strict Recovery で **リカバリを有効にする方法** を使用したため、例外はすぐに表面化します。対処方法は次のいずれかです： + +- `RecoveryMode` を `RecoveryMode.Default` に切り替えてベストエフォート変換を行う **または** +- 変換前に DOCX を前処理し（例：サポート外の SmartArt を削除）問題を取り除く。 + +### 2️⃣ 画像ごとに DPI を変更できるか？ + +`ImageResolution` 設定はグローバルです。画像単位で制御したい場合は、`MyResourceSaver` と同様のカスタム `ImageSavingCallback` を実装し、`args.ImageResolution` を `args.ImageFileName` やメタデータに基づいて調整してください。 + +### 3️⃣ 生成した LaTeX を Jekyll サイトに埋め込むには？ + +Jekyll の組み込み MathJax サポートはそのまま機能します。レイアウトに MathJax スクリプトを含め、ディスプレイ数式は `$$`、インライン数式は `$` で囲んでおくだけです。 + +### 4️⃣ .NET Core on Linux と互換性はあるか？ + +もちろんです。Aspose.Words はクロスプラットフォームです。`YOUR_DIRECTORY` パスが Linux の規則（例：`/home/user/docs`）に従っていることを確認してください。 + +## 完全動作サンプル + +以下はコピペで使えるプログラムです。`YOUR_DIRECTORY` を実際のパスに置き換えてください。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**期待される出力** – `output.md` を開くと次のようになります： + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +MathJax 対応の Markdown プレビューでファイルを開くと、積分記号が正しくレンダリングされます。 + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/japanese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/japanese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..eee89a06d8 --- /dev/null +++ b/words/japanese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,210 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words を使用して Word 文書から LaTeX をエクスポートする方法 – DOCX を Markdown に変換し、数式を + LaTeX として出力する +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: ja +og_description: Word文書からLaTeXをエクスポートする方法は最初の文で説明されており、DOCXをLaTeX形式の数式を含むMarkdownに変換する手順を示しています。 +og_title: WordからLaTeXへエクスポートする方法 – 完全ガイド +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: WordからLaTeXをエクスポートする方法 – DOCXをMarkdownに変換 +url: /ja/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word から LaTeX をエクスポートする方法 – DOCX を Markdown に変換 + +Word ファイルから **LaTeX をエクスポート** する方法で、PNG が大量に出力されることに悩んだことはありませんか？ あなただけではありません。開発者は静的サイトや科学ブログで、クリーンで編集可能な数式が必要になるたびにこの壁にぶつかります。良いニュースは、Aspose.Words を使えば **Word を Markdown に変換** でき、すべての OfficeMath オブジェクトをネイティブな LaTeX として保持できるので、後処理は不要です。 + +このチュートリアルでは **Word ドキュメントを Markdown として保存** しながら **数式を LaTeX としてエクスポート** する全プロセスを解説します。最後まで読むと、実行可能な C# スニペット、各オプションの明確な説明、複雑な数式や混在コンテンツといったエッジケースの対処法が手に入ります。外部ツールは不要で、NuGet パッケージ 1 つと数行のコードだけです。 + +## 必要なもの + +- .NET 6+（または .NET Framework 4.7.2 以上） – 最新ランタイムが最適です。 +- Visual Studio 2022 または C# プロジェクトをコンパイルできるエディタ。 +- Aspose.Words for .NET のライセンス（無料トライアルで実験可能）。 +- 少なくとも 1 つの数式（OfficeMath）を含む DOCX ファイル。 + +これらがすでに揃っているなら、さっそく始めましょう。 + +## Word から LaTeX をエクスポートする方法 – 概要 + +以下は全体の流れを示すハイレベルな図です。 + +1. **Install** Aspose.Words NuGet パッケージ。 +2. **Load** 数式が入っているソース `.docx` を読み込む。 +3. `MarkdownSaveOptions` を設定し、`OfficeMathExportMode` を `LaTeX` にする。 +4. ドキュメントを `.md` ファイルとして **Save**。 +5. 生成された Markdown に LaTeX ブロック（`$$…$$`）が含まれているか **Verify**。 + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="Word から LaTeX をエクスポートするフロー図"} + +## Step 1 – Aspose.Words for .NET をインストール (convert word to markdown) + +まず最初に、実際に重い処理を行うライブラリが必要です。ターミナル（または Package Manager Console）を開き、次のコマンドを実行してください。 + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** Visual Studio を使用している場合は、プロジェクトを右クリック → *Manage NuGet Packages* → “Aspose.Words” を検索して最新の安定版をインストールします。 + +なぜこれが重要かというと、Aspose.Words は Open XML 形式を抽象化し、低レベルの XML を直接扱うことなく Word ドキュメントを操作できるクリーンな API を提供します。また、OfficeMath を LaTeX に変換する組み込みサポートがあり、これが **export equations as LaTeX** 要件の核心です。 + +## Step 2 – DOCX をロード (how to convert docx) + +パッケージが導入できたら、変換したいファイルを読み込みます。`YOUR_DIRECTORY` を `.docx` が置かれているパスに置き換えてください。 + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Why load it this way?** `Document` コンストラクタはファイル全体をオブジェクトモデルに解析し、段落・テーブル・特に OfficeMath オブジェクトへ即座にアクセスできるようにします。ファイルが存在しない、または破損している場合、Aspose は説明的な `FileNotFoundException` をスローし、適切にキャッチしてエラーハンドリングが可能です。 + +## Step 3 – MarkdownSaveOptions を設定 (export equations as latex) + +魔法は `MarkdownSaveOptions` オブジェクトで起こります。デフォルトでは Aspose は数式を PNG 画像として出力しますが、ここでは LaTeX が欲しいので `OfficeMathExportMode` を `LaTeX` に設定します。 + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +オプションフラグの簡単な説明: `ExportImagesAsBase64` を `false` にするとバイナリデータが埋め込まれず、Markdown がすっきりします。`ExportHeadersFooters` を有効にすると、ヘッダーやフッターに含まれるタイトルや著者名といったコンテキストが失われません。 + +## Step 4 – ドキュメントを保存 (save word as markdown) + +最後に、変換された内容を `.md` ファイルに書き出します。 + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +この行が実行されると、ソースファイルと同じディレクトリに `output.md` が生成されます。任意のテキストエディタで開くと、次のような LaTeX ブロックが見えるはずです。 + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +これで **save word as markdown** の工程は完了です。追加の変換ステップは不要です。 + +## Step 5 – 結果を検証 (export equations as latex) + +検証を怠りがちですが、簡単なサニティチェックは後々の時間節約につながります。生成されたファイルを読み取り、最初の LaTeX ブロックを出力するシンプルなスクリプトを実行してみましょう。 + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +`First LaTeX block: $$ … $$` と表示されれば、Word から **LaTeX をエクスポート** できています。表示されない場合は、ソース文書に本当に OfficeMath オブジェクトが含まれているか確認してください。通常のテキスト数式は変換対象になりません。 + +## 一般的なエッジケースの処理 + +| シナリオ | 注意点 | 推奨修正 | +|----------|--------|----------| +| **Mixed images & equations** | Aspose は OfficeMath 以外の画像をまだ埋め込むことがあります。 | `ExportImagesAsBase64 = false` に設定し、画像は外部ファイルとして保持し、Markdown で手動で参照します。 | +| **Complex nested equations** | 深い入れ子構造は手動で調整が必要な LaTeX を生成することがあります。 | `mdOptions.ExportMathAsDisplay = true` などで調整し、生成後に `latexindent` などの LaTeX フォーマッタで整形します。 | +| **Large documents** | 巨大な `.docx` をロードするとメモリ使用量が急増します。 | `LoadOptions` に `LoadFormat.Docx` を指定し、ストリーミングが利用可能なら有効にします。 | +| **Missing license** | 無料トライアルは出力に透かしコメントを追加します。 | `License license = new License(); license.SetLicense("Aspose.Words.lic");` で有効なライセンスを適用します。 | + +これらのヒントは、特に **convert word to markdown** を本番パイプラインで使用する際に、ワークフローを堅牢に保ちます。 + +## 完全な動作例 (All Steps in One File) + +以下は新規 .NET プロジェクトにコピペしてすぐに実行できる、自己完結型コンソールアプリです。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +プログラムを実行し、`output.md` を開くと、数式がきれいな LaTeX としてレンダリングされているはずです。これが **how to export latex** from a Word document の完全な解答です。 + +## 結論 + +**LaTeX を Word からエクスポート**する方法をステップバイステップで解説し、**Word を Markdown に変換**、**save word as markdown**、そして **export equations as LaTeX** を Aspose.Words で実現する手順を示しました。基本的な考え方はシンプルです: DOCX をロードし、`MarkdownSaveOptions` を調整し、ライブラリに任せるだけです。 + +ドキュメントパイプラインを自動化したい場合は、このコードを Hugo や Jekyll といった静的サイトジェネレータと組み合わせ、生成された `.md` ファイルをリポジトリにプッシュすればサイトが再構築されます。さらに詳しくは Aspose の「Export to LaTeX」ガイドを参照し、Web プレビュー用に `HtmlSaveOptions` を試したり、`DocumentVisitor` API でカスタム変換を実装したりしてください。 + +エッジケース、ライセンス、CI/CD への統合について質問があれば下のコメント欄にどうぞ。Happy coding! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/japanese/net/programming-with-pdfsaveoptions/_index.md b/words/japanese/net/programming-with-pdfsaveoptions/_index.md index f9c4137125..bb70aee554 100644 --- a/words/japanese/net/programming-with-pdfsaveoptions/_index.md +++ b/words/japanese/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ Word文書をPDFに変換してオンライン配信、アーカイブ、印刷 | [PDF ドキュメントの最終印刷プロパティを更新する](./update-last-printed-property/) ステップバイステップ ガイドを使用して、Aspose.Words for .NET を使用して PDF ドキュメント内の最後に印刷されたプロパティを更新する方法を学習します。 | | [PDF ドキュメントで 3D DML 3DEffects をレンダリングする](./dml-3deffects-rendering/) この包括的なステップバイステップ ガイドでは、Aspose.Words for .NET を使用して PDF ドキュメントで魅力的な 3D DML 効果をレンダリングする方法を学習します。 | | [PDF文書内の画像を補間する](./interpolate-images/) Aspose.Words for .NET を使用してPDFドキュメント内の画像を補間する方法を、ステップバイステップガイドで学びましょう。PDFの画像品質を簡単に向上させることができます。 | - +| [Aspose.Words を使用して DOCX から PDF を保存する方法 – ステップバイステップ ガイド](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) Aspose.Words for .NET を使い、DOCX ファイルを PDF に変換して保存する手順を詳しく解説します。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/japanese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/japanese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..b98c8dad98 --- /dev/null +++ b/words/japanese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words を使用して DOCX ファイルから PDF を保存する方法を学びます。DOCX を PDF に変換する、オプション付きで + PDF を保存する、浮動形状の処理を含みます。 +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: ja +og_description: Aspose.Words を使用して DOCX ファイルから PDF を保存する方法。このガイドでは、docx を PDF に変換し、オプション付きで + PDF を保存する方法と、浮動形状の処理方法を示します。 +og_title: DOCXからPDFを保存する方法 – 完全なAspose.Wordsチュートリアル +tags: +- Aspose.Words +- C# +- PDF conversion +title: Aspose.WordsでDOCXからPDFを保存する方法 – ステップバイステップガイド +url: /ja/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# DOCX から PDF を保存する方法 – 完全チュートリアル + +Word 文書から **PDF を保存** する際に、浮動形状のレイアウトが崩れないか気になったことはありませんか？ あなただけではありません。請求書ジェネレータ、レポートエクスポーター、シンプルな文書アーカイバなど、多くのプロジェクトで開発者は DOCX を PDF に変換し、Word と同じ見た目を保つ信頼できる方法を必要としています。 + +このチュートリアルでは **Aspose.Words for .NET** を使用して DOCX ファイルを PDF に変換する手順を解説し、カスタム保存オプションで **docx を pdf に変換** する方法と、`ExportFloatingShapesAsInlineTag` フラグが重要な理由を説明します。最後まで読めば、オプションを自在にコントロールできる PDF 保存用スニペットがすぐに実行可能になります。 + +## 学べること + +- Aspose.Words を使って **word document pdf を変換** する正確な手順 +- 浮動形状をインラインタグとして扱うための `PdfSaveOptions` の設定方法 +- 浮動オブジェクトに関する一般的な落とし穴と回避策 +- 任意の .NET プロジェクトに貼り付けられる、完全に動作する C# プログラム + +> **前提条件:** Aspose.Words for .NET のライセンス（または無料評価版）と、.NET 開発環境（Visual Studio、Rider、または `dotnet` CLI）が必要です。 + +## 手順 1: プロジェクトをセットアップし Aspose.Words を追加 + +まず、コンソールアプリを新規作成（または既存プロジェクトに追加）し、Aspose.Words NuGet パッケージを参照します。 + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **プロのコツ:** CI サーバー上でビルドを再現可能にするため、パッケージバージョンを固定してください（例: `Aspose.Words --version 24.10`）。 + +## 手順 2: 浮動形状を含む DOCX をロード + +浮動画像、テキストボックス、SmartArt は変換時にレイアウトがずれる原因になります。ドキュメントのロードはシンプルですが、実行時の `FileNotFoundException` を防ぐためにファイルの存在確認も行います。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +`Console.WriteLine` 文に注目してください。ターミナルからアプリを実行したときに、すぐにフィードバックが得られます。 + +## 手順 3: PDF 保存オプションを構成（オプション付きで PDF を保存） + +ここがポイントです。デフォルトでは Aspose.Words は浮動オブジェクトをそのまま保持しようとするため、生成された PDF のレイアウトが崩れることがあります。`ExportFloatingShapesAsInlineTag` を `true` に設定すると、ライブラリはこれらの形状をインラインタグとして扱い、周囲のテキストに固定されます。 + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +なぜ重要なのか？ パラグラフ上に浮かんでいるテキストボックスを想像してください。インラインタグ変換を行わないと、PDF が段落を下に押し下げたり、ボックスが切り取られたりします。このフラグは視覚的な関係性を保ち、プロフェッショナルなレポートに不可欠な微妙なディテールを守ります。 + +## 手順 4: ドキュメントを PDF として保存 + +いよいよ PDF ファイルを書き出します。`Save` メソッドには出力パスと先ほど設定したオプションの両方を渡します。 + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +プログラムを実行すると、ソース DOCX と同じフォルダーに `output.pdf` が生成されます。任意の PDF ビューアで開くと、すべての浮動形状が正確な位置に描画されていることが確認できます。 + +## 完全動作サンプル + +以下が全体プログラムです。`Program.cs`（または任意の C# ファイル）に貼り付けて **F5** キーで実行してください。 + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### 期待される結果 + +- **作成されたファイル:** ターゲットディレクトリに `output.pdf` +- **レイアウト忠実度:** 浮動形状（画像、テキストボックス、SmartArt）が周囲のテキストとインラインで表示される +- **例外なし:** プログラムは正常に終了し、コンソールにステータスメッセージを出力する + +## よくある質問 & エッジケース + +| 質問 | 回答 | +|----------|--------| +| **画像品質をもっと高くしたい場合は？** | `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` を設定します。 | +| **複数の DOCX をバッチで変換したい場合は？** | `foreach (var file in Directory.GetFiles(..., "*.docx"))` ループでロード/保存ロジックを包みます。パフォーマンス向上のため、`PdfSaveOptions` インスタンスは 1 つだけ再利用してください。 | +| **.NET Core でも動作しますか？** | はい。Aspose.Words 24.x は .NET Standard 2.0+ をサポートしているので、Windows、Linux、macOS で同じコードが実行可能です。 | +| **パスワード保護された DOCX はどう扱いますか？** | `new Document(inputPath, new LoadOptions { Password = "mySecret" })` でロードします。保存時は同じ `PdfSaveOptions` が適用されます。 | +| **インラインタグ変換は複雑な表でも安全ですか？** | 概ね安全ですが、形状が重なり合う高度に複雑な表レイアウトでは手動調整が必要になる場合があります。大量移行前に代表サンプルでテストしてください。 | + +## 実務での活用ヒント + +- **`Console.WriteLine` だけでなくロギングを** – 本番環境では Serilog や NLog などのロギングフレームワークに置き換えてエラーを記録しましょう。 | +- **リソースの破棄** – `Document` は `IDisposable` を実装しています。多数のファイルを処理する場合は `using` ブロックで囲み、メモリを速やかに解放してください。 | +- **PDF の検証** – アーカイブ用途で PDF/A 準拠が必要な場合は、PDF/A 検証ツールで出力をチェックしましょう。 | +- **並列処理** – 大規模な変換作業では、スレッドごとに `PdfSaveOptions` をクローンし `Parallel.ForEach` を活用して速度を向上させます。 | + +## 結論 + +Aspose.Words を使って DOCX から PDF を **保存する方法** を学び、カスタムオプションで **docx を pdf に変換** する手順と `ExportFloatingShapesAsInlineTag` の影響を理解しました。完全に動作するサンプルは、数行のコードで **word document pdf を変換** でき、プロジェクトの品質やコンプライアンス要件に合わせて **pdf をオプション付きで保存** できることを示しています。 + +次のステップに挑戦してみませんか？ `document.Save("output.html")` で HTML や EPUB へのエクスポートを試す、あるいは長期保存向けに PDF/A 準拠を実装するなど、同じ「ロード → オプション設定 → 保存」の流れがすべてのフォーマットで活きます。 + +コーディングを楽しみながら、作成した PDF が常に意図した通りの見た目になることを願っています！ + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/japanese/net/programming-with-shapes/_index.md b/words/japanese/net/programming-with-shapes/_index.md index d0530db430..d24c1a8bac 100644 --- a/words/japanese/net/programming-with-shapes/_index.md +++ b/words/japanese/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Aspose.Words for .NET を使い、これらのチュートリアルに従うこ | [スマートアートシェイプの検出](./detect-smart-art-shape/) この包括的なガイドでは、Aspose.Words for .NET を使用して Word 文書内の SmartArt 図形を検出する方法を学びます。ドキュメントワークフローの自動化に最適です。 | | [スマートアート描画の更新](./update-smart-art-drawing/) Aspose.Words for .NET を使用してWord文書内のスマートアート描画を更新する方法を、このステップバイステップガイドで学びましょう。常に正確なビジュアル表現を実現します。 | | [Aspose.Words で Word に長方形の図形を作成 – ステップバイステップ ガイド](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) Aspose.Words for .NET を使用して、Word 文書に長方形の図形を追加し、属性を設定する方法を段階的に解説します。 | +| [C# で Word 文書を作成 – 影付き図形の追加](./create-word-document-c-add-shape-with-shadow/) ステップバイステップで、Aspose.Words for .NET を使用して Word 文書に影付きの図形を追加する方法を学びます。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/japanese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/japanese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..c5f6debe76 --- /dev/null +++ b/words/japanese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-03-27 +description: C#でWord文書を作成し、図形の追加、図形への影の適用、影の距離設定方法を学びます。Aspose.Wordsのステップバイステップガイド。 +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: ja +og_description: C#で矩形シェイプとカスタムシャドウを使用したWord文書を作成します。シャドウの距離とスタイルを設定する完全なチュートリアルをご覧ください。 +og_title: C#でWord文書を作成 – 影付きの図形を追加 +tags: +- Aspose.Words +- C# +- Document Automation +title: C#でWord文書を作成 – 影付きシェイプを追加 +url: /ja/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word ドキュメント C# の作成 – 影付きシェイプの追加 + +きれいにスタイルされた長方形を含む **create word document c#** が必要になったことはありませんか？レポートテンプレートを作成していて、レイアウトを引き立てるためにさりげないドロップシャドウを加えたいかもしれません。このチュートリアルでは、シェイプの追加、シェイプへの影の適用、そして Aspose.Words を使用して影の距離を微調整する方法を順を追って説明します。 + +空のドキュメントから始め、長方形を配置し、プリセットの影を設定し、最後にファイルを保存します。最後までに、Word で開いてすぐに効果を確認できる、すぐに使える .docx が手に入ります。外部ツールは不要で、純粋な C# コードだけです。 + +## 前提条件 + +- .NET 6（または任意の最新 .NET Framework）がインストールされていること。 +- Visual Studio 2022 または C# 拡張機能がインストールされた VS Code。 +- Aspose.Words for .NET の NuGet パッケージ（`Aspose.Words` バージョン 23.12 以降）。 + Package Manager Console から追加できます： + + ```powershell + Install-Package Aspose.Words + ``` + +以上です – 追加の DLL や COM インタープロは不要です。 + +## ステップ 1: 新しい Document と Builder の初期化 – *create word document c#* の基本 + +まず、Word ファイルを表す `Document` オブジェクトと、編集用の `DocumentBuilder` が必要です。 + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **このステップが重要な理由:** `Document` クラスはすべての Word パーツ（ページ、スタイル、画像）を格納するコンテナです。Builder は低レベルのノード操作を抽象化したハイレベル API で、XML を直接扱うことなく **create word document c#** を簡単に行えます。 + +## ステップ 2: 長方形シェイプの挿入 – *how to create rectangle* + +ページ上に長方形を配置します。サイズはポイントで表されます（1 pt ≈ 1/72 インチ）。 + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **プロのコツ:** 別のシェイプが必要な場合は、`ShapeType.Rectangle` を `ShapeType.Ellipse`、`ShapeType.Triangle` などに置き換えるだけです。同じコードは任意のタイプの **how to add shape** にも機能します。 + +## ステップ 3: プリセット影の適用と微調整 – *apply shadow to shape* + +Aspose.Words にはいくつかのプリセット影フォーマットが用意されています。ここでは `Preset1` を使用し、距離、ぼかし、透明度、色をカスタマイズします。 + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **なぜ影をカスタマイズするのか？** `Distance` プロパティは影が長方形からどれだけ離れるかを制御します – 3D レンダリングでの「リフト」のようなイメージです。`BlurRadius` を変更するとエッジが柔らかくなり、`Transparency` でさりげなくプロフェッショナルな外観を作れます。これにより **set shadow distance** の要件を満たし、**apply shadow to shape** を柔軟に行う方法が示されます。 + +## ステップ 4: ドキュメントの保存 – *create word document c#* 完了 + +最後に、ドキュメントをディスクに書き込みます。書き込み権限のあるフォルダーにパスを調整してください。 + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Microsoft Word で生成されたファイルを開くと、淡い青色の長方形に 5 pt のオフセットで柔らかいグレーの影が付いているのが確認できます。これが、スタイル付きシェイプで **create word document c#** に成功したことの視覚的証拠です。 + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# example showing rectangle with shadow"} + +## オプションのバリエーションとエッジケース + +| シナリオ | 変更点 | 重要な理由 | +|----------|----------------|----------------| +| **異なる影スタイル** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | 余分なコードなしで、よりドラマチックな外観を提供します。 | +| **プリセットなし – カスタム影** | `Format` を省略し、`OffsetX`、`OffsetY` を手動で設定します。 | 方向と深さを完全にコントロールできます。 | +| **複数のシェイプ** | 保存前に `builder.InsertShape` を再度呼び出します。 | アイコンやロゴなどを含む複雑なテンプレートに便利です。 | +| **古い Aspose バージョンとの互換性** | `ShadowEffect` クラスを使用します（v20.x で利用可能）。 | レガシープロジェクトでもコードが動作することを保証します。 | +| **PDF として保存** | `document.Save("ShadowShape.pdf");` | PDF 出力でも同じ影のレンダリングが表示されます。 | + +> **よくある質問:** *Word で影が表示されない場合は？* +> Aspose.Words の最新バージョン（≥ 22.9）を使用していることを確認してください。古いリリースでは影のサポートが制限されていました。また、ドキュメントが最新の Word バージョン（2016 以降）で開かれているかも確認してください。 + +## 完全な動作例 + +以下は完全なコピー＆ペースト可能なプログラムです。`using` ディレクティブ、コメント、エラーハンドリングがすべて含まれており、スムーズに実行できます。 + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +プログラムを実行し、`C:\Temp\ShadowShape.docx` に移動すると、設定した通りの影が付いた長方形が表示されます。 + +## まとめと次のステップ + +- これで **create word document c#** の方法、長方形の挿入、そしてカスタム **set shadow distance** を使用した **apply shadow to shape** の方法が分かります。 +- この例は Aspose.Words を使用しており、OpenXML の複雑さを抽象化し、Word バージョン間で一貫したレンダリングを保証します。 +- さらに踏み込むには？複数のシェイプを組み合わせたり、長方形内にテキストを追加したり、同じドキュメントを PDF としてエクスポートして影の変換を確認してみてください。 + +### 関連トピック + +- ブランディングのためにヘッダー/フッターに **How to add shape** を追加する。 +- プログラムでチャートやテーブルを挿入するために **Aspose.Words** を使用する。 +- ベクターシェイプではなく画像に **shadow effects** をカスタマイズする。 +- 請求書や証明書の大量ドキュメント生成を自動化する。 + +自由に実験し、コードを壊してから再構築してください – これが概念を最速で身につける方法です。問題が発生したら、下にコメントを残すか、公式の Aspose.Words ドキュメントでより深い API の洞察を確認してください。 + +コーディングを楽しんで、Word ファイルを少しだけ洗練された見た目にしてください！ + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/japanese/net/programming-with-txtsaveoptions/_index.md b/words/japanese/net/programming-with-txtsaveoptions/_index.md index daee4aa39b..94d947d483 100644 --- a/words/japanese/net/programming-with-txtsaveoptions/_index.md +++ b/words/japanese/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Aspose.Words for .NET のチュートリアルでは、Word 文書の操作を | [Word文書にBidiマークを追加する](./add-bidi-marks/) このガイドでは、Aspose.Words for .NET を使用して Word 文書に双方向（Bidi）マークを追加する方法を学びます。多言語コンテンツで適切なテキスト方向を確保します。 | | [リストのインデントにはレベルごとにタブ文字を使用する](./use-tab-character-per-level-for-list-indentation/) Aspose.Words for .NET を使用して、タブ付きインデント付きの多階層リストを作成する方法を学びましょう。このガイドに従って、ドキュメント内のリストを正確に書式設定しましょう。 | | [リストのインデントにはレベルごとにスペース文字を使用する](./use-space-character-per-level-for-list-indentation/) Aspose.Words for .NET で、スペース文字によるインデントを含む多階層リストを作成する方法を学びましょう。ドキュメントの正確な書式設定のためのステップバイステップガイドです。 | - +| [docx を txt として保存 – Word の数式を LaTeX にエクスポートする完全ガイド](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) Aspose.Words for .NET を使用して、docx を txt に変換し、Word の数式を LaTeX 形式でエクスポートする方法を詳しく解説します。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/japanese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/japanese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..c015103066 --- /dev/null +++ b/words/japanese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,243 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Wordsでdocxをtxtに保存し、WordをLaTeXに変換します。数式のエクスポート方法、プレーンテキストの保持、数分でLaTeXマークアップを取得する方法を学びましょう。 +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: ja +og_description: Aspose.Words を使用して docx を txt に保存します。このガイドでは、Word を LaTeX に変換し、数式をエクスポートし、文書をプレーンテキストのまま保つ方法を示します。 +og_title: docx を txt に保存 – Word の数式を LaTeX にエクスポート +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: docxをtxtに保存 – Wordの数式をLaTeXへエクスポートする完全ガイド +url: /ja/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# docx を txt に保存 – Word の数式を LaTeX にエクスポート + +**docx を txt に保存**したいけど、Word ファイル内の高度な数式が失われるのが心配、ということはありませんか？ 多くの科学的ワークフローでは、文書のプレーンテキスト版が必須ですが、数式はきれいな LaTeX マークアップとして残したいものです。 + +このチュートリアルでは、Aspose.Words for .NET を使って **Word を LaTeX に変換**する正確な手順を解説します。数式は正しくエクスポートされ、残りの文書は整然としたプレーンテキストになります。最後まで読めば、**数式を LaTeX にエクスポート**し、ファイル全体をシンプルなテキストとして保持し、初心者が陥りがちな落とし穴を回避できるようになります。 + +## 学べること + +- Office Math を含む *.docx* ファイルの読み込み方法 +- Aspose がすべての数式に対して LaTeX を出力するように `TxtSaveOptions` を設定する方法 +- **save word plain text** ファイルとして結果を保存し、バージョン管理や CI パイプライン、その他の下流ツールに投入できる方法 +- 画像と数式が混在する文書や Unicode 文字を保持したい場合の一般的なエッジケースへの対処法 +- コンソールアプリにそのまま貼り付けられる、完全な実行可能コードサンプル + +### 前提条件 + +- .NET 6.0 以降（.NET Framework 4.7+ でも動作します） +- **Aspose.Words for .NET** のライセンス版（無料トライアルでもテスト可能） +- Visual Studio 2022 もしくは C# プロジェクトをコンパイルできる任意の IDE +- すでに Office Math オブジェクトを含む Word 文書（`input.docx`） + +> **プロのコツ:** まだライセンスを持っていない場合は、Aspose のウェブサイトから一時キーを取得できます。コード中のプレースホルダーを取得したキーに置き換えてから実行してください。 + +## 手順 1 – NuGet で Aspose.Words をインストール + +まず最初に、プロジェクトにライブラリを追加します。**Package Manager Console** を開き、以下を実行してください。 + +```powershell +Install-Package Aspose.Words +``` + +この一行で、`Saving` 名前空間に含まれる `TxtSaveOptions` など、必要なすべてが取得できます。余計な DLL やネイティブ依存関係は不要で、純粋なマネージドコードだけです。 + +## 手順 2 – ソースの Word 文書を読み込む + +次に、数式が格納されているファイルを実際に読み込みます。`Document` クラスは *.docx* 全体の構造を抽象化しており、高レベルのオブジェクトモデルとして扱えます。 + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**ポイント:** 早い段階で文書をロードするとノードツリーを検査できます。チェックを省いて数式が無いファイルを処理すると、空の LaTeX 出力になる原因が分からなくなります。 + +## 手順 3 – LaTeX エクスポート用に TxtSaveOptions を設定 + +Aspose は Office Math のレンダリング方法を細かく制御できます。`OfficeMathExportMode` を `LaTeX` に設定すると、すべての数式が LaTeX 形式に変換され、画像化や除去が行われません。 + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**ポイント:** デフォルトのエクスポートモードでは数式が完全に削除されます。`LaTeX` に切り替えることで、後で LaTeX コンパイラや `$…$` 構文を理解する Markdown プロセッサに渡す際に、数式の意図が保持されます。 + +## 手順 4 – 文書をプレーンテキストとして保存 + +オプション設定が完了したら、保存はワンライナーで完了します。出力は `.txt` ファイルとなり、各数式は `$` デリミタで囲まれた LaTeX コードとして現れます（必要に応じて `\[` … `\]` ブロックに変更可能です）。 + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### 期待される結果 + +任意のエディタで `output.txt` を開くと、次のような内容が表示されます。 + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +通常のテキストは元通りに残り、数式は純粋な LaTeX 文字列に置き換わっていることが分かります。これらをそのまま LaTeX 文書や Jupyter Notebook、数式をレンダリングできるツールに貼り付けて使用できます。 + +## 手順 5 – エッジケースの処理 + +### 混在コンテンツ（画像 + 数式） + +Word ファイルに画像も含まれている場合、`TxtSaveOptions` を使用すると画像は無視されます。**save word plain text** のワークフローとしては問題ありませんが、画像をプレースホルダーとして残したい場合は次の手順を検討してください。 + +1. `HtmlSaveOptions` を使って文書を HTML にエクスポートし、画像を `` タグとして取得 +2. `TxtSaveOptions` で LaTeX 数式だけを取得するために二度目のパスを実行 +3. 手動または小さなスクリプトで二つの結果をマージ + +### Unicode 記号 + +一部の数式は特殊な Unicode 文字（例: ギリシャ文字）を使用します。手順 3 で示したように `TxtSaveOptions.Encoding = Encoding.UTF8` を設定すれば、これらの記号が変換時に失われません。 + +### 大容量文書 + +100 MB 超の巨大ファイルを扱う場合は、ストリーミング保存を検討してください。 + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +ストリーミングにより、出力全体をメモリに読み込む必要がなくなり、メモリが限られたビルドエージェントでも安心です。 + +## 完全動作サンプル + +以下は、すべてをまとめたコピペ可能なプログラムです。ファイルパスと（あれば）ライセンス行だけを書き換えて実行してください。 + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +プログラムを実行（コンソールプロジェクトなら `dotnet run`）し、`output.txt` を確認します。**docx を txt に保存**しつつ、すべての数式を LaTeX として保持できました—手動でコピー＆ペーストする必要はありません。 + +## FAQ + +**Q: デリミタを `$…$` から `\(...\)` に変更できますか？** +A: できます。保存後にファイル全体で置換を行います: `output = output.Replace("$", @"\(").Replace("$", @"\)");` ただし、元テキスト中のインライン `$` 文字を誤って置換しないよう注意してください。 + +**Q: Word 2007‑2019 のファイルでも動作しますか？** +A: はい。Aspose.Words は `.doc`, `.docx`, `.docm` だけでなく、最新の `.dotx` 系列もサポートしています。同じコードがすべてのバージョンで動作します。 + +**Q: 元の段落レイアウト（タブや複数スペース）を保持したい場合は？** +A: `txtSaveOptions.PreserveTableLayout = true;` と `txtSaveOptions.PreserveSpace = true;` を設定すれば、空白文字がそのまま残ります。 + +## 結論 + +ここまでで、Aspose.Words を使って **docx を txt に保存**しつつ **数式を LaTeX にエクスポート**する方法をすべて網羅しました。重要なステップは、文書の読み込み、`TxtSaveOptions` に `OfficeMathExportMode.LaTeX` を設定、そして保存です。この 3 行のコードで **word を latex に変換**し、文書を **save word plain text** 形式で保持し、数式の喪失という恐怖から解放されます。 + +次のチャレンジは？このワークフローを Markdown ジェネレータと組み合わせて、テキストと LaTeX の両方を含む完全な `.md` ファイルを生成してみましょう。Git バックドのドキュメントや静的サイトジェネレータに最適です。また、`PdfSaveOptions` を使って PDF 版も同時に取得することも検討してください。 + +問題が発生したら、遠慮なくコメントを残してください。コーディングを楽しみながら、Word の数式をきれいな LaTeX に変換するシンプルさを体感してください！ + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/japanese/net/working-with-fonts/_index.md b/words/japanese/net/working-with-fonts/_index.md index 3e703a30da..3942210d5c 100644 --- a/words/japanese/net/working-with-fonts/_index.md +++ b/words/japanese/net/working-with-fonts/_index.md @@ -48,6 +48,7 @@ | [警告通知を受け取る](./receive-warning-notification/) Aspose.Words for .NET の使用時に警告通知を受信し、ドキュメント内の問題や警告を管理する方法について説明します。 | | [リソース Steam フォントソースの例](./resource-steam-font-source-example/) リソース ストリーム フォント ソースを使用してカスタム フォントを Aspose.Words for .NET に読み込む方法を学習します。 | | [接尾辞なしの置換を取得する](./get-substitution-without-suffixes/) このチュートリアルでは、Aspose.Words for .NET を使用して Word 文書でサフィックスなしのオーバーライドを取得する方法を学習します。 | +| [Aspose フォント置換 – C# でフォント設定を構成する方法](./aspose-font-substitution-how-to-configure-font-settings-in-c/) Aspose.Words for .NET を使用して、C# でフォント置換設定を構成する手順をステップバイステップで解説します。 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/japanese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/japanese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..c8bb2157e6 --- /dev/null +++ b/words/japanese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose のフォント置換を簡単に: フォント設定の構成方法、警告の取得方法、.NET アプリでのフォント欠損の処理方法を学びましょう。' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: ja +og_description: フォント設定の構成と警告コールバックによる欠落フォントの処理で、Aspose のフォント置換をマスター。完全な C# ガイド。 +og_title: Aspose フォント置換 – C# でフォント設定を構成する +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose フォント置換 – C# でフォント設定を構成する方法 +url: /ja/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose フォント置換 – フォント設定の構成 完全ガイド + +ドキュメントで、カスタムフォントが突然汎用フォントに置き換わったことはありませんか？それが **aspose font substitution** の働きで、欠落したフォントを最も近いものに置き換えます。便利ですが、*正確に*どのフォントが置き換えられたかを知りたい場合は、ライブラリの警告システムにアクセスし、フォント設定を自分で構成する必要があります。 + +このチュートリアルでは、実際のシナリオを順に解説します。フォントが存在しない DOCX を読み込み、置換イベントを取得し、コンソールにフレンドリーなメッセージを出力します。最後まで読めば、**configure font settings** に慣れ、**Aspose.Words warning callback** を設定し、サンプルを任意のワークフローに拡張できるようになります。 + +> **必要なもの** +> • .NET 6+（または .NET Framework 4.7.2+） +> • Aspose.Words for .NET（最新の NuGet） +> • 欠落フォントを参照している DOCX（ここでは `MissingFont.docx` と呼びます） + +さあ、始めましょう。 + +--- + +## Step 1: Install Aspose.Words and Prepare the Project + +コードを書く前に、Aspose.Words パッケージが参照されていることを確認してください。 + +```bash +dotnet add package Aspose.Words +``` + +> **プロのコツ:** 最新の安定版を使用してください。2026年3月時点では 23.11.0 です。新しいリリースではフォントマッチングアルゴリズムが改善され、追加の警告タイプが提供されています。 + +新しいコンソール アプリを作成するか（既存プロジェクトにコードを貼り付けても可）、以下の `using` ディレクティブを追加します。 + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +これらの名前空間により、`Document`、`LoadOptions`、およびフォント関連クラスにアクセスできます。 + +--- + +## Step 2: Configure Font Settings with LoadOptions + +**aspose font substitution** の制御は `LoadOptions.FontSettings` にあります。空の `FontSettings` オブジェクトを渡すことで、Aspose に既定の検索パスを使用させつつ、警告コールバックで置換を報告させます。 + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +デフォルトに任せない理由は何ですか？警告コールバック（次のステップ）を設定できるのは `FontSettings` プロパティが `null` でない場合だけです。この小さな一行で、実際のフォント検索動作を変更せずに置換プロセスへのフックを取得できます。 + +--- + +## Step 3: Attach a Warning Callback to Capture Substitutions + +Aspose.Words は `IWarningCallback` インターフェイスを実装しています。欠落フォントなど重要な出来事が起きると、`Warning` メソッドが呼び出されます。ここでは `WarningType.FontSubstitution` をフィルタリングし、説明をコンソールに出力するハンドラを実装します。 + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +ハンドラ本体は次のとおりです。 + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **この重要性** – コールバックがなければ、Aspose はフォントを黙って置換し、どのフォントが使用されたか分かりません。コールバックによりプロセスが可視化され、コンプライアンス報告やレイアウト不具合のデバッグに不可欠です。 + +--- + +## Step 4: Load the Document Using the Configured Options + +いよいよ、先ほど作成した `loadOptions` を渡してドキュメントを読み込みます。ソース ファイルがインストールされていないフォントを参照している場合、ハンドラが発火します。 + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +`YOUR_DIRECTORY` を `MissingFont.docx` が実際に存在するパスに置き換えてください。プログラムを実行すると、以下のような出力が表示されます。 + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +この行は、どのフォントが欠落していたか、そして Aspose が選択した代替フォントを正確に示します。 + +--- + +## Step 5: (Optional) Fine‑Tune Font Search Paths + +社内フォントが格納されたプライベート フォルダーがある場合、システム フォントにフォールバックする前に Aspose にその場所を教えることができます。これは **configure font settings** の高度な活用例です。 + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +`recursive: true` を設定すると、サブフォルダーも走査対象になります。これにより、ライブラリはまずプライベート フォントを検索し、不要な置換の可能性を減らします。 + +--- + +## Full Working Example + +すべてを統合した、実行可能な完全プログラムは以下の通りです。 + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**期待される出力**（欠落フォントが検出された場合）: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +すべてのフォントが揃っていれば、プログラムは警告なしで静かに実行され、PDF が生成されます。 + +--- + +## Common Questions & Edge Cases + +### What if I need to *prevent* substitution altogether? + +`FontSettings.SubstitutionSettings` を `null` に設定するか、`FontSettings.FontSubstitutionSettings` を使用して動作を制御します。例: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +これにより、Aspose は黙って置換する代わりに例外をスローし、捕捉して処理できます。 + +### Does this work with other file formats (e.g., .doc, .rtf)? + +もちろんです。同じ `LoadOptions` オブジェクトを、ファイル パスを受け取る任意の `Document` コンストラクタに渡すことができます。フォントに依存するすべての形式で警告コールバックが発火します。 + +### Can I capture the *exact* fallback font name? + +はい。`info.Description` 文字列には欠落フォントと代替フォントの両方が含まれます。プログラム上で名前が必要な場合は文字列を解析するか、（新しいバージョンで利用可能な）`FontInfo` オブジェクトを使用してください。 + +### How does this behave in a multi‑threaded environment? + +`FontSettings` は **スレッド セーフ** ではありません。スレッドごとに個別の `LoadOptions`（それぞれ独自の `FontSettings`）を作成するか、ロックでアクセスを保護してください。 + +--- + +## Conclusion + +**aspose font substitution** と **configure font settings** を C# アプリでマスターするために必要なすべてを網羅しました。 + +1. Aspose.Words をインストールし、必要な `using` 文を追加。 +2. 新しい `FontSettings` を持つ `LoadOptions` オブジェクトを作成。 +3. カスタム `IWarningCallback` を添付して置換イベントを取得。 +4. ドキュメントを読み込み、コールバックで欠落フォントを報告。 +5. （オプション）検索パスを拡張するか、置換を完全に無効化。 + +このパターンを使えば、コンプライアンス目的で欠落フォントを記録したり、UI でユーザーに警告したり、公開前に代替フォントを自動埋め込みしたりできます。次は **Aspose.Words font substitution policies** を調査するか、ワークフロー全体に統合してみてください。 + +Happy coding, and may your documents always render with the right typeface! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/korean/net/basic-conversions/_index.md b/words/korean/net/basic-conversions/_index.md index 938bccaaa3..cd3c392bb8 100644 --- a/words/korean/net/basic-conversions/_index.md +++ b/words/korean/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ | [Word에서 LaTeX 내보내기 – 단계별 가이드](./how-to-export-latex-from-word-step-by-step-guide/) | Aspose.Words for .NET을 사용하여 Word 문서에서 LaTeX 코드를 추출하고 내보내는 방법을 단계별로 안내합니다. | | [C#에서 Aspose.Words를 사용해 Word를 PDF로 변환 – 가이드](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Aspose.Words for .NET을 사용하여 C#에서 Word 문서를 PDF로 변환하는 방법을 단계별로 안내합니다. | | [Aspose.Words로 Word를 PDF로 저장 – 완전한 C# 가이드](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Aspose.Words와 C#을 활용해 Word 문서를 PDF로 변환하는 전체 단계별 가이드입니다. | +| [Aspose.Words를 사용한 Word를 PDF로 변환 – 완전 가이드](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Aspose.Words와 C#을 활용해 Word 문서를 PDF로 변환하는 전체 단계별 가이드입니다. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/korean/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/korean/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..0ccf86d60a --- /dev/null +++ b/words/korean/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words를 사용하여 Word를 PDF로 빠르게 변환하세요. Word를 PDF로 저장하고, docx를 PDF로 + 내보내며, C#에서 접근성 PDF를 생성하는 방법을 배워보세요. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: ko +og_description: Aspose.Words를 사용하여 C#에서 Word를 PDF로 변환합니다. 이 가이드는 Word를 PDF로 저장하는 방법, + docx를 PDF로 내보내는 방법, 그리고 접근성 있는 PDF를 생성하는 방법을 보여줍니다. +og_title: Aspose.Words로 Word를 PDF로 변환 – 단계별 +tags: +- Aspose.Words +- C# +- PDF conversion +title: Aspose.Words로 Word를 PDF로 변환 – 완전 가이드 +url: /ko/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose.Words를 사용한 Word → PDF 변환 – 완전 가이드 + +서드파티 웹 도구를 사용하지 않고 **Word를 PDF로 변환**하는 방법이 궁금하셨나요? 자동 보고서 엔진을 구축하고 실시간으로 *save word as pdf*가 필요할 수도 있습니다. 좋은 소식은 Aspose.Words가 전체 과정을 손쉽게 처리해 주며, **PDF/UA‑2** 준수 파일도 손쉽게 만들 수 있다는 점입니다—접근성 요구 사항에 딱 맞습니다. + +이 튜토리얼에서는 `.docx` 로드, PDF 옵션 설정(문서를 *export docx to pdf*하면서 PDF/UA 준수), 그리고 최종적으로 접근 가능한 PDF로 저장하는 전체 과정을 단계별로 살펴봅니다. 끝까지 따라오시면 .NET 프로젝트 어디에든 삽입할 수 있는 자체 포함형, 프로덕션 준비된 코드를 얻게 됩니다. + +![Convert Word to PDF using Aspose.Words](convert-word-to-pdf.png) + +## 배울 내용 + +- **왜 Aspose.Words**가 *generate accessible pdf* 시나리오에 적합한 선택인지. +- PDF/UA‑2 준수와 함께 *save document as pdf* 하는 정확한 단계. +- 누락된 폰트나 비밀번호 보호된 원본 파일과 같은 일반적인 에지 케이스 처리 방법. +- 출력 디버깅 및 접근성 준수 확인을 위한 빠른 팁. + +### 전제 조건 + +- .NET 6 이상 (API는 .NET Framework 4.6+에서도 동작). +- 유효한 Aspose.Words for .NET 라이선스 (무료 체험판으로 평가 가능). +- 기본적인 C# 지식—특별한 디자인 패턴은 필요 없음. + +위 조건을 모두 만족한다면, 바로 시작해 보겠습니다. + +--- + +## Word → PDF 변환 – 단계별 구현 + +솔루션을 다섯 개의 명확한 단계로 나눕니다. 각 단계마다 제목, 짧은 코드 조각, 그리고 코드가 중요한 이유에 대한 설명이 포함됩니다. + +### 단계 1: 변환할 Word 문서 로드 + +먼저 원본 파일을 나타내는 `Document` 객체가 필요합니다. Aspose.Words는 **.docx**, **.doc**, **.rtf** 등 다양한 형식을 읽을 수 있어, 파일이 어떻게 만들어졌든 *save word as pdf*가 가능합니다. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**왜 중요한가:** +- 파일을 일찍 로드하면 파일이 없을 때 발생하는 오류를 CPU 사이클을 낭비하기 전에 잡을 수 있습니다. +- `Document` 클래스는 Word 파일의 내부 구조를 추상화해, 깔끔한 객체 모델을 제공합니다. + +### 단계 2: 접근성을 위한 PDF 저장 옵션 구성 + +*generate accessible pdf* 파일이 필요하다면 Aspose.Words에 PDF/UA‑2 준수 문서를 만들도록 알려야 합니다. `PdfSaveOptions` 클래스가 출력에 대한 세밀한 제어를 제공합니다. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**왜 중요한가:** +- `PdfCompliance.PdfUa2`는 라이브러리에게 화면 판독기가 필요로 하는 태그, 구조 정보, 메타데이터를 추가하도록 지시합니다. +- 폰트 임베딩(`EmbedFullFonts = true`)은 다른 OS에서 PDF를 열 때 발생하는 “폰트를 찾을 수 없음” 경고를 방지합니다. +- `Title`을 설정하면 보조 기술이 문서를 올바르게 알릴 수 있습니다. + +### 단계 3: 문서를 PDF로 저장 + +이제 원본이 로드되고 옵션이 설정되었으니 실제 변환은 한 줄 코드로 끝납니다. 여기서 *export docx to pdf*가 이루어집니다. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**왜 중요한가:** +- `Save` 메서드는 앞서 구성한 `PdfSaveOptions`를 그대로 적용해 접근성 기능이 포함된 PDF를 생성합니다. +- `try/catch` 블록으로 감싸면 라이선스 문제나 권한 오류를 로깅하거나 사용자에게 알릴 수 있어 초보자에게 흔히 발생하는 실수를 방지합니다. + +### 단계 4: PDF/UA 준수 여부 확인 (선택 사항이지만 권장) + +Aspose.Words가 대부분의 작업을 수행하지만, 특히 정부 기관이나 규제 대상에 문서를 제공할 때는 출력물을 재검증하는 것이 좋은 습관입니다. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**왜 중요한가:** +- `IsTagged`는 간단한 정상 확인이며, 전체 PDF/UA 검증은 전용 검증기가 필요하지만 대부분의 준수 문제는 태그 누락으로 나타납니다. +- 플래그가 `false`이면 `PdfSaveOptions`를 다시 검토하세요—`Compliance` 설정을 놓쳤거나 원본 문서에 적절한 헤딩 스타일이 없을 수 있습니다. + +### 단계 5: 흔히 겪는 문제와 전문가 팁 + +| 문제점 | 발생 현상 | 해결 방법 | +|---------|--------------|------------| +| **폰트 누락** | PDF에서 텍스트가 사각형으로 표시됨 | `EmbedFullFonts = true` 설정 **또는** 서버에 누락된 폰트를 설치 | +| **라이선스 미적용** | Aspose가 모든 페이지에 워터마크 삽입 | 애플리케이션 초기에 라이선스 파일(`Aspose.Words.lic`)을 로드 (`License license = new License(); license.SetLicense("Aspose.Words.lic");`) | +| **비밀번호 보호된 원본** | `new Document(path)`에서 `InvalidOperationException` 발생 | `new Document(path, new LoadOptions { Password = "secret" })` 오버로드 사용 | +| **대용량 문서로 인한 OOM** | 큰 파일에서 메모리 부족 예외 발생 | `PdfSaveOptions`에서 `MemoryOptimization` 활성화 (`saveOptions.MemoryOptimization = true`) | +| **접근성 태그 누락** | PDF/UA 검증 실패 | 원본 Word 파일에 올바른 헤딩 스타일(`Heading 1`, `Heading 2` 등) 사용—Aspose가 자동으로 PDF 태그와 매핑 | + +**전문가 팁:** 다수의 문서를 배치로 변환한다면 `PdfSaveOptions` 인스턴스를 한 번만 생성해 재사용하세요. 인스턴스 생성을 최소화하면 할당 오버헤드가 줄고 메모리 사용량도 낮아집니다. + +--- + +## 전체 작업 예제 (복사‑붙여넣기 바로 사용) + +아래는 모든 코드를 하나로 모은 완전한 프로그램입니다. `Program.cs`로 저장하고 Aspose.Words와 Aspose.PDF NuGet 패키지를 추가한 뒤 실행하세요. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**예상 결과:** +`C:\MyFiles` 폴더에 `output.pdf` 파일이 생성됩니다. Adobe Acrobat에서 열면 준수 패널에 “PDF/A‑2b, PDF/UA‑1”이 표시되어 *convert word to pdf*가 성공적으로 수행됐음을 확인할 수 있습니다. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/korean/net/programming-with-markdownsaveoptions/_index.md b/words/korean/net/programming-with-markdownsaveoptions/_index.md index 7958496a56..252c189146 100644 --- a/words/korean/net/programming-with-markdownsaveoptions/_index.md +++ b/words/korean/net/programming-with-markdownsaveoptions/_index.md @@ -32,6 +32,9 @@ | [Word에서 Markdown 내보내기 – 전체 C# 가이드](./how-to-export-markdown-from-word-complete-c-guide/) | Aspose.Words for .NET을 사용하여 Word 문서를 Markdown으로 내보내는 전체 C# 가이드 | | [DOCX에서 Markdown 저장 방법 – 단계별 가이드](./how-to-save-markdown-from-docx-step-by-step-guide/) | Aspose.Words for .NET을 사용하여 DOCX 파일을 Markdown으로 저장하는 단계별 가이드를 제공합니다. | | [DOCX에서 Markdown 내보내기 – 전체 C# 가이드](./how-to-export-markdown-from-docx-complete-guide/) | Aspose.Words for .NET을 사용하여 DOCX 파일을 Markdown으로 내보내는 전체 C# 가이드 | +| [Word에서 LaTeX 내보내기 – DOCX를 Markdown으로 변환](./how-to-export-latex-from-word-convert-docx-to-markdown/) | Aspose.Words for .NET을 사용해 Word 문서에서 LaTeX를 내보내고 DOCX를 Markdown으로 변환하는 단계별 가이드 | +| [DOCX에서 LaTeX 내보내기 – Markdown으로 변환](./how-to-export-latex-from-docx-convert-to-markdown/) | Aspose.Words for .NET을 사용하여 DOCX 파일에서 LaTeX를 내보내고 Markdown으로 변환하는 단계별 가이드 | +| [Word에서 마크다운 만들기 – 전체 C# 가이드](./create-markdown-from-word-full-c-guide/) | Aspose.Words for .NET을 사용하여 Word에서 마크다운을 전체 C# 가이드로 만드는 방법 | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/korean/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/korean/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..357cba6456 --- /dev/null +++ b/words/korean/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,251 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words C#를 사용하여 Word에서 마크다운 만들기. docx를 마크다운으로 변환하고, Word에서 이미지를 + 추출하며, 콜백 사용 방법을 하나의 튜토리얼에서 배웁니다. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: ko +og_description: Aspose.Words를 사용하여 Word에서 마크다운을 생성합니다. 이 가이드는 docx를 마크다운으로 변환하고, Word에서 + 이미지를 추출하며, 리소스 처리를 위한 콜백을 사용하는 방법을 보여줍니다. +og_title: Word에서 마크다운 만들기 – 완전한 C# 튜토리얼 +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Word에서 마크다운 만들기 – 전체 C# 가이드 +url: /ko/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word에서 마크다운 만들기 – 완전한 C# 튜토리얼 + +Word에서 **마크다운을 만들**어야 할 때가 있었지만 어디서 시작해야 할지 몰랐던 적이 있나요? 당신만 그런 것이 아닙니다. 많은 개발자들이 .docx 파일의 내용을 정적 사이트 생성기나 문서 저장소로 옮기려 할 때 이 장벽에 부딪힙니다. 좋은 소식은? Aspose.Words를 사용하면 **docx를 markdown으로 변환**하고, 원본 파일에서 모든 이미지를 추출하며, 해당 리소스가 저장될 위치를 정확히 제어할 수 있습니다—모두 간단한 콜백 하나로 가능합니다. + +이 가이드에서는 Word에서 이미지를 추출하고, 콜백을 사용해 저장하는 방법, 그리고 이 접근 방식이 자동화 파이프라인에서 가장 신뢰할 수 있는 이유를 실제 예제로 보여줍니다. 끝까지 따라오면 `.md` 파일과 추출된 이미지 폴더를 생성하는 실행 가능한 C# 프로그램을 얻게 됩니다. + +> **Pro tip:** 이미 스크린샷, 다이어그램, 로고 등이 포함된 Word 템플릿이 있다면, 이 방법을 사용하면 모든 시각 요소를 수동 복사‑붙여넣기 없이 그대로 보존할 수 있습니다. + +--- + +## 준비물 + +- **.NET 6+** (또는 .NET Framework 4.6+). 코드는 최신 런타임이면 어디서든 동작합니다. +- **Aspose.Words for .NET** (NuGet 패키지 `Aspose.Words`). 무료 체험판으로 대부분의 시나리오를 커버합니다. +- 텍스트와 최소 하나의 이미지가 포함된 **Word 문서** (`input.docx`). +- C# 및 Visual Studio(또는 선호하는 IDE)에 대한 기본 이해. + +추가 라이브러리는 필요하지 않습니다—나머지는 모두 Aspose.Words가 처리합니다. + +--- + +## Step 1: 프로젝트 설정 및 Aspose.Words 설치 + +정리된 환경을 위해 새 콘솔 프로젝트를 시작합니다: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Why this step matters:** NuGet 패키지를 설치하면 최신 API를 사용할 수 있습니다. 여기에는 버전 22.9에 도입된 `MarkdownSaveOptions` 클래스가 포함됩니다. 이 클래스를 사용하지 않으면 직접 컨버터를 구현해야 합니다. + +--- + +## Step 2: 원본 Word 문서 로드 + +첫 번째 코드는 변환하려는 `.docx` 파일을 엽니다. `YOUR_DIRECTORY`를 실제 경로로 바꾸세요. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **What’s happening?** `Document`가 파일을 파싱하고 내부 DOM을 구축해 모든 단락, 표, 이미지에 접근할 수 있게 합니다. 파일이 없을 경우 Aspose는 명확한 `FileNotFoundException`을 발생시키며, 이를 잡아 보다 부드러운 UI를 구현할 수 있습니다. + +--- + +## Step 3: 리소스 저장 콜백이 포함된 Markdown 저장 옵션 구성 + +여기서 **how to use callback**의 마법이 발휘됩니다. 콜백을 통해 추출된 각 이미지가 저장될 위치를 직접 지정할 수 있습니다. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Why a callback?** 기본적으로 Aspose는 이미지를 base‑64 문자열로 markdown에 삽입합니다—버전 관리에 악몽이 됩니다. 콜백을 사용하면 파일 이름과 폴더 구조를 완전히 제어할 수 있습니다. + +--- + +## Step 4: 문서를 Markdown으로 저장 + +이제 실제로 `.md` 파일을 생성합니다. 모든 이미지는 다음 단계에서 정의한 콜백으로 전달됩니다. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +문제가 없으면 대상 폴더에 `Document.md`가 생성되고, `Resources`라는 하위 폴더에 원본 Word 파일에서 추출된 모든 그림이 들어갑니다. + +--- + +## Step 5: 추출된 이미지를 저장하는 콜백 구현 + +아래는 `MyResourceSaver` 전체 구현입니다. `Resources` 디렉터리를(존재하지 않을 경우) 만들고, 각 이미지에 고유 파일명을 부여한 뒤 스트림을 디스크에 씁니다. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Explanation of the arguments:** +> - `args.Index` – 고유성을 보장하는 0부터 시작하는 카운터. +> - `args.FileName` – Aspose가 제안하는 원본 파일명(보통 `image001.png` 형태). +> - `args.Stream` – 이미지 바이트가 기록되는 출력 스트림. +> - `args.KeepResourceStreamOpen` – `false`로 설정하면 Aspose가 스트림을 자동으로 해제해 파일 핸들 누수를 방지합니다. + +--- + +## Full Working Example + +모든 코드를 하나로 합치면 `Program.cs`에 복사‑붙여넣기 할 수 있는 단일 파일이 됩니다. `YOUR_DIRECTORY`를 환경에 맞는 절대 경로나 상대 경로로 바꾸는 것을 잊지 마세요. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Expected Output + +- `YOUR_DIRECTORY/Document.md` – 표준 markdown 이미지 링크가 포함된 markdown 파일, 예시: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – `img_0.png`, `img_1.jpg` 등 원본 Word 문서에 나타난 순서대로 저장된 이미지 파일들. + +프로그램을 실행하면 친절한 확인 메시지가 출력되어 작업이 성공했음을 알려줍니다. + +--- + +## Frequently Asked Questions (FAQ) + +### How to extract images from Word without losing quality? + +콜백은 이미지 스트림을 그대로 파일에 기록하므로 원본 해상도가 그대로 유지됩니다. 별도의 변환이나 압축을 수행하지 않으며, 필요에 따라 직접 이미지 처리 로직을 추가할 수 있습니다. + +### Can I change the image format (e.g., PNG → JPEG) during extraction? + +가능합니다. `ResourceSaving` 내부에서 `args.FileName`이나 `args.Stream`을 확인하고, `System.Drawing`이나 `ImageSharp` 등으로 이미지를 로드한 뒤 원하는 포맷으로 재인코딩한 뒤 저장하면 됩니다. 이 경우 markdown 링크의 확장자도 동일하게 바꿔야 합니다. + +### What if I need the markdown files to reference a CDN instead of a local folder? + +콜백에서 `args.FileName`을 CDN에 업로드한 후의 전체 URL로 설정하면 markdown 링크가 CDN을 가리키게 됩니다. 이미지 업로드 로직을 콜백에 추가하면 됩니다. + +### Does this work with tables, footnotes, or other advanced Word features? + +네. Aspose.Words는 대부분의 Word 구조를 markdown에 대응시킵니다. 표는 markdown 표로, 각주와 주석은 참조 링크로, 중첩 리스트도 정상적으로 변환됩니다. 변환 결과가 이상하면 최신 릴리스 노트를 확인하세요—Aspose는 변환 정확도를 지속적으로 개선하고 있습니다. + +### How to convert docx to markdown in a CI/CD pipeline? + +컴파일된 `.exe`를 빌드 단계에 추가하고, 생성된 `.docx` 아티팩트를 대상으로 실행하면 됩니다. 결과물인 `.md`와 `Resources/` 폴더를 정적 사이트 저장소에 푸시하면 자동화된 환경에서도 일관된 결과를 얻을 수 있습니다. + +--- + +## Wrapping Up + +우리는 Aspose.Words를 사용해 **Word에서 마크다운을 만들**는 방법을 시연하고, 전체 **docx를 markdown으로 변환** 워크플로를 다루었으며, 맞춤형 **how to use callback** 구현을 통해 **Word에서 이미지를 추출**하는 실용적인 방법을 보여주었습니다. 결과물은 원본 이미지를 포함한 깔끔한 markdown 파일과 이미지 폴더이며, 문서 사이트, 정적 블로그, 혹은 순수 텍스트 포맷을 선호하는 모든 워크플로에 최적입니다. + +다음 단계로 고려해볼 수 있는 내용: + +- 폴더 내 여러 `.docx` 파일을 **Batch processing**(예: `Directory.GetFiles` 루프)하는 방법. +- 이미지에 **Custom naming schemes** 적용(예: 원본 캡션 텍스트 사용). +- markdown에서 이미지 링크를 CDN URL로 교체하는 **Post‑processing**. +- HTML, PDF, EPUB 등 **다른 Aspose export formats**를 탐색해 다채널 퍼블리싱 구현. + +추가 질문이 있거나 변환이 어려운 Word 파일이 있다면 아래에 댓글을 남겨 주세요. 함께 문제를 해결해 봅시다. 즐거운 코딩 되시고, Word를 markdown으로 바꾸는 간편함을 만끽하세요! + +--- + +![Word에서 Markdown으로 변환 프로세스를 보여주는 다이어그램](image.png "Word에서 Markdown 만들기 다이어그램") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/korean/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/korean/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..cd6327f44b --- /dev/null +++ b/words/korean/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words를 사용하여 DOCX에서 LaTeX를 내보내는 방법. DOCX를 Markdown으로 변환하고, DPI를 + 설정하며, C#에서 복구 기능을 활성화하는 방법을 배웁니다. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: ko +og_description: Aspose.Words를 사용하여 DOCX에서 LaTeX로 내보내는 방법. 이 튜토리얼에서는 단계별 Markdown 변환, + DPI 제어 및 복구 모드를 보여줍니다. +og_title: DOCX에서 LaTeX 내보내는 방법 – Markdown으로 변환 +tags: +- Aspose.Words +- C# +- Document Conversion +title: DOCX에서 LaTeX 내보내는 방법 – Markdown으로 변환 +url: /ko/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# DOCX에서 LaTeX 내보내기 – Markdown으로 변환 + +DOCX 파일에서 **LaTeX를 내보내는 방법**을 고민해 본 적 있나요? 수식의 아름다움을 잃지 않으면서요. 당신만 그런 것이 아닙니다. 제 경험상 가장 큰 어려움은 OfficeMath 객체를 정적 사이트 생성기나 과학 블로그용으로 깔끔하고 휴대 가능한 형식으로 변환하는 것입니다. + +이 가이드에서는 Aspose.Words를 사용해 DOCX를 Markdown으로 변환하는 과정을 단계별로 살펴보면서 **DPI 설정 방법**, **복구 활성화 방법** 및 견고한 파이프라인을 위한 몇 가지 유용한 팁을 소개합니다. 최종적으로 LaTeX 수식, 고해상도 이미지, 올바른 하이퍼링크 처리가 포함된 Markdown 파일을 생성하는 단일 C# 프로그램을 만들 수 있습니다. + +## 준비 사항 + +- **.NET 6+** (또는 .NET Framework 4.7.2 – API는 동일하게 동작) +- **Aspose.Words for .NET** (2026년 3월 현재 최신 안정 버전) +- 수식, 이미지, 링크가 포함된 DOCX 파일 +- Visual Studio, VS Code 또는 선호하는 편집기 + +Aspose.Words 외에 추가 NuGet 패키지는 필요하지 않지만, 체험판이 아닌 경우 유효한 라이선스를 확보하십시오. + +## Step 1 – Load the DOCX with Strict Recovery Mode + +내보내기를 시도하기 전에 원본 문서에 숨겨진 손상이 없는지 확인해야 합니다. 여기서 **복구 활성화 방법**이 중요합니다. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**왜 엄격한 복구인가?** +Aspose가 문제를 조용히 수정하도록 두면 단락이 누락되거나 이미지가 깨지는 상황이 발생할 수 있습니다—LaTeX를 내보낼 때는 절대 원하지 않는 결과입니다. 빠르게 실패하도록 하면 문제를 초기에 포착하고, 원본 DOCX를 수정하거나 나중에 로그로 남길지 결정할 수 있습니다. + +### 프로 팁 +로드를 `try/catch` 로 감싸고 `DocumentLoadingException`을 기록하십시오. 이렇게 하면 CI 파이프라인이 전체 빌드를 중단하지 않고 문제 파일을 표시할 수 있습니다. + +## Step 2 – Prepare the Markdown Export Options + +문서가 메모리에 안전히 로드되었으니 저장 옵션을 설정합니다. 이것이 **LaTeX 내보내기 방법**의 핵심이며, **DPI 설정 방법**도 포함됩니다. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**각 옵션의 역할** + +| 옵션 | 이유 | 키워드와의 연관성 | +|--------|--------|-----------------------| +| `OfficeMathExportMode = LaTeX` | 수식에서 **LaTeX를 내보내는 방법**을 직접 제공 | 주요 키워드 | +| `ImageResolution = 300` | 이미지 품질 제어 – **DPI 설정 방법**에 대한 답변 | 보조 | +| `ResourceSavingCallback` | 임베디드 파일을 디스크에 저장, **DOCX를 Markdown으로 변환** 시 흔히 필요 | 보조 | +| `EmptyParagraphExportMode` | 깨끗한 Markdown 출력 보장, 불필요한 HTML 태그 방지 | 전반적인 변환 품질 향상 | +| `LinkExportMode = AsReference` | 링크를 읽고 편집하기 쉬운 형태로, **DOCX를 Markdown으로 변환**에 또 다른 장점 | | + +## Step 3 – Implement a Custom Resource Saver (Optional but Handy) + +DOCX를 Markdown으로 변환할 때 이미지 및 기타 바이너리 리소스는 파일 시스템에 저장될 위치가 필요합니다. Aspose는 `IResourceSavingCallback`을 통해 이를 제어할 수 있습니다. 위 스니펫은 최소 구현을 보여주지만, 여기서 자세히 살펴보겠습니다: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**왜 필요한가?** +이 단계를 건너뛰면 Aspose가 이미지를 Base‑64 문자열로 임베드하여 Markdown 파일 크기가 급격히 커지고 버전 관리가 어려워집니다. 리소스를 별도 폴더에 저장하면 Markdown이 가볍게 유지되고 Hugo나 Jekyll 같은 정적 사이트 생성기와도 잘 호환됩니다. + +## Step 4 – Save the Document as Markdown + +이제 모든 준비가 끝났습니다. 한 줄의 코드로 최종 파일을 저장합니다. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +`output.md`를 열면 다음과 같은 내용이 보일 것입니다: + +- `$…$` 형태의 LaTeX 블록으로 렌더링된 수식 +- `![Alt text](resources/image001.png)` 형태로 참조된 이미지(300 dpi 해상도) +- 레퍼런스 스타일로 변환된 하이퍼링크: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +이것이 **DOCX를 변환하는 전체 과정**입니다. + +## Common Questions & Edge Cases + +### 1️⃣ DOCX에 지원되지 않는 객체가 포함되어 있으면 어떻게 하나요? +Aspose.Words는 `FeatureNotSupportedException`을 발생시킵니다. **복구 활성화 방법**을 엄격 모드로 사용했기 때문에 예외가 즉시 표면화됩니다. 다음 중 하나를 선택하십시오: + +- `RecoveryMode`를 `RecoveryMode.Default`로 전환해 최선의 노력으로 변환 **또는** +- 변환기 실행 전에 DOCX를 전처리(예: 지원되지 않는 SmartArt 제거)합니다. + +### 2️⃣ 이미지마다 DPI를 다르게 설정할 수 있나요? +`ImageResolution` 설정은 전역 적용됩니다. 이미지별 제어가 필요하면 `MyResourceSaver`와 유사한 커스텀 `ImageSavingCallback`을 구현하고 `args.ImageResolution`을 `args.ImageFileName` 또는 메타데이터에 따라 조정하십시오. + +### 3️⃣ 생성된 LaTeX를 Jekyll 사이트에 어떻게 삽입하나요? +Jekyll의 기본 MathJax 지원은 바로 작동합니다. 레이아웃에 MathJax 스크립트를 포함하고, 디스플레이 수식은 `$$` 로, 인라인 수식은 `$` 로 감싸면 됩니다. + +### 4️⃣ .NET Core를 Linux에서 사용해도 되나요? +전혀 문제 없습니다. Aspose.Words는 크로스‑플랫폼을 지원합니다. 단, `YOUR_DIRECTORY` 경로를 Linux 형식(예: `/home/user/docs`)으로 지정하면 됩니다. + +## Full Working Example + +아래는 그대로 복사해 사용할 수 있는 프로그램 예시입니다. `YOUR_DIRECTORY`를 실제 경로로 바꾸세요. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**예상 출력** – `output.md`를 열면 다음과 비슷한 내용이 표시됩니다: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Markdown 미리보기가 MathJax를 지원한다면, 적분 기호가 정상적으로 렌더링됩니다. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/korean/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/korean/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..e277e6815e --- /dev/null +++ b/words/korean/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words를 사용해 Word 문서에서 LaTeX를 내보내는 방법 – 수식을 LaTeX 형태로 변환하여 DOCX를 + Markdown으로 변환. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: ko +og_description: Word 문서에서 LaTeX를 내보내는 방법은 첫 문장에서 설명되며, DOCX를 수식이 포함된 LaTeX 형태의 Markdown으로 + 변환하는 방법을 보여줍니다. +og_title: Word에서 LaTeX를 내보내는 방법 – 완전 가이드 +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Word에서 LaTeX 내보내는 방법 – DOCX를 Markdown으로 변환 +url: /ko/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word에서 LaTeX 내보내기 – DOCX를 Markdown으로 변환 + +Word 파일에서 **LaTeX 내보내기**를 시도해 본 적이 있나요? PNG 이미지가 많이 생기는 상황을 피하고 싶다면 여러분만 그런 것이 아닙니다; 개발자들은 정적 사이트나 과학 블로그용으로 깔끔하고 편집 가능한 수식이 필요할 때 이 문제에 자주 부딪힙니다. 좋은 소식은? Aspose.Words를 사용하면 **Word를 Markdown으로 변환**하면서 모든 OfficeMath 객체를 원시 LaTeX 형태로 유지할 수 있어 별도의 후처리가 필요 없습니다. + +이 튜토리얼에서는 **Word 문서를 Markdown으로 저장**하면서 **수식을 LaTeX로 내보내는** 전체 과정을 단계별로 살펴봅니다. 마지막까지 진행하면 실행 가능한 C# 스니펫, 각 옵션에 대한 명확한 설명, 복잡한 수식이나 혼합된 콘텐츠와 같은 엣지 케이스를 처리하는 팁을 얻을 수 있습니다. 외부 도구는 필요 없으며, 단일 NuGet 패키지와 몇 줄의 코드만 있으면 됩니다. + +## 준비 사항 + +- .NET 6+ (또는 .NET Framework 4.7.2 이상) – 최신 런타임이 가장 좋습니다. +- Visual Studio 2022 또는 C# 프로젝트를 컴파일할 수 있는 편집기. +- Aspose.Words for .NET 라이선스 (무료 체험판으로 실험 가능). +- 최소 하나의 수식(OfficeMath)이 포함된 DOCX 파일. + +이미 준비가 되었다면, 바로 시작해 보세요. + +## Word에서 LaTeX 내보내기 – 개요 + +아래는 전체 흐름을 한눈에 보여주는 고수준 단계입니다: + +1. **Install** the Aspose.Words NuGet package. +2. **Load** the source `.docx` that holds your equations. +3. **Configure** `MarkdownSaveOptions` so that `OfficeMathExportMode` is set to `LaTeX`. +4. **Save** the document as a `.md` file. +5. **Verify** that the generated Markdown contains LaTeX blocks (`$$…$$`). + +각 단계는 아래 섹션에서 자세히 설명합니다. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="How to export latex from Word diagram"} + +## Step 1 – Install Aspose.Words for .NET (convert word to markdown) + +First things first: you need the library that actually does the heavy lifting. Open your terminal (or Package Manager Console) and run: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** If you’re using Visual Studio, right‑click the project → *Manage NuGet Packages* → search for “Aspose.Words” and install the latest stable version. + +Why this matters: Aspose.Words abstracts the Open XML format, giving you a clean API to manipulate Word documents without dealing with the low‑level XML yourself. It also ships with built‑in support for converting OfficeMath to LaTeX, which is the core of our **export equations as LaTeX** requirement. + +## Step 2 – Load the DOCX (how to convert docx) + +Now that the package is in place, load the file you want to transform. Replace `YOUR_DIRECTORY` with the path where your `.docx` lives: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Why load it this way?** The `Document` constructor parses the entire file into an object model, giving you instant access to paragraphs, tables, and—most importantly—OfficeMath objects. If the file is missing or corrupted, Aspose throws a descriptive `FileNotFoundException`, which you can catch for graceful error handling. + +## Step 3 – Configure MarkdownSaveOptions (export equations as latex) + +The magic happens in the `MarkdownSaveOptions` object. By default Aspose would render equations as PNG images, but we want LaTeX. Set the `OfficeMathExportMode` to `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +A quick note on the optional flags: `ExportImagesAsBase64` tells Aspose not to embed binary data, which keeps the Markdown clean. `ExportHeadersFooters` ensures you don’t lose any context that might sit in those sections—useful when the header contains a title or author name. + +## Step 4 – Save the Document (save word as markdown) + +Finally, write the transformed content to a `.md` file: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +After this line runs, you’ll find `output.md` next to your source file. Open it in any text editor and you should see LaTeX blocks that look like this: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +That’s the **save word as markdown** part done—no extra conversion steps required. + +## Step 5 – Verify the Result (export equations as latex) + +It’s easy to overlook verification, but a quick sanity check saves hours later. Run a simple script that reads the generated file and prints the first LaTeX block: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +If you see `First LaTeX block: $$ … $$` printed, you’ve successfully **exported LaTeX** from Word. If not, double‑check that your source document actually contains OfficeMath objects; regular text equations won’t be converted. + +## Handling Common Edge Cases + +| Scenario | What to Watch For | Recommended Fix | +|----------|-------------------|-----------------| +| **Mixed images & equations** | Aspose may still embed images for non‑OfficeMath graphics. | Set `ExportImagesAsBase64 = false` and keep images as external files, then reference them manually in Markdown. | +| **Complex nested equations** | Very deep nesting can produce LaTeX that needs manual tweaking. | Post‑process the block with a LaTeX formatter (e.g., `latexindent`) or adjust `mdOptions` → `ExportMathAsDisplay = true`. | +| **Large documents** | Memory usage spikes when loading huge `.docx` files. | Use `LoadOptions` with `LoadFormat.Docx` and enable `LoadOptions.LoadFormat` streaming if available. | +| **Missing license** | The free trial adds a watermark comment to the output. | Apply a valid license via `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +These tips keep your workflow robust, especially when you **convert word to markdown** in production pipelines. + +## Full Working Example (All Steps in One File) + +Below is a self‑contained console app that you can copy‑paste into a new .NET project and run immediately. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Run the program, open `output.md`, and you’ll see your equations rendered as clean LaTeX. That’s the complete answer to **how to export latex** from a Word document. + +## Conclusion + +We’ve covered **how to export LaTeX** from Word step by step, showing you how to **convert Word to markdown**, **save word as markdown**, and **export equations as LaTeX** using Aspose.Words. The core idea is simple: load the DOCX, tweak `MarkdownSaveOptions`, and let the library do the heavy lifting. + +If you’re ready to automate documentation pipelines, try chaining this code with a static‑site generator like Hugo or Jekyll—just push the generated `.md` files into your repo and let the site rebuild. For further reading, explore Aspose’s “Export to LaTeX” guide, experiment with `HtmlSaveOptions` for web previews, or dive into the `DocumentVisitor` API for custom transformations. + +Got questions about edge cases, licensing, or integrating this into CI/CD? Drop a comment below, and happy coding! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/korean/net/programming-with-pdfsaveoptions/_index.md b/words/korean/net/programming-with-pdfsaveoptions/_index.md index 5e07c21333..ed79f9f1bf 100644 --- a/words/korean/net/programming-with-pdfsaveoptions/_index.md +++ b/words/korean/net/programming-with-pdfsaveoptions/_index.md @@ -37,12 +37,13 @@ Aspose.Words for .NET 튜토리얼에서는 PDFSaveOptions를 사용한 워드 | [Scale WMF 글꼴을 메타파일 크기로 PDF 크기 줄이기](./scale-wmf-fonts-to-metafile-size/) | Aspose.Words for .NET을 사용하여 PDF로 변환할 때 WMF 글꼴을 메타파일 크기로 조정하여 PDF 크기를 줄이는 단계별 가이드입니다. | | [추가 텍스트 위치 지정으로 PDF 텍스트 위치 지정 개선](./additional-text-positioning/) | Aspose.Words for .NET을 사용하여 몇 가지 간단한 단계로 PDF 텍스트 배치를 개선하는 방법을 알아보세요. 문서의 모양을 개선해 보세요. | | [Word 문서를 PDF 1.7로 변환](./conversion-to-pdf-17/) | Aspose.Words for .NET을 사용하여 Word 문서를 PDF 1.7로 손쉽게 변환하세요. 이 가이드를 따라 누구나 쉽게 접근하고 전문적인 서식을 갖춘 문서를 만드세요. | +| [Aspose.Words를 사용하여 DOCX에서 PDF 저장 방법 – 단계별 가이드](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Aspose.Words를 활용해 DOCX 파일을 PDF로 변환하는 과정을 단계별로 안내합니다. | | [이미지 다운샘플링으로 PDF 문서 크기 줄이기](./downsampling-images/) | Aspose.Words for .NET을 사용하여 이미지를 다운샘플링하여 PDF 문서 크기를 줄이세요. PDF를 최적화하여 업로드 및 다운로드 시간을 단축하세요. | | [PDF 문서에서 개요 옵션 설정](./set-outline-options/) | Aspose.Words for .NET을 사용하여 PDF 문서의 개요 옵션을 설정하는 방법을 알아보세요. 제목 수준과 확장된 개요를 구성하여 PDF 탐색 기능을 향상하세요. | | [PDF 문서에서 사용자 정의 속성 내보내기](./custom-properties-export/) | Aspose.Words for .NET을 사용하여 PDF 문서에서 사용자 지정 속성을 내보내는 방법을 자세하고 단계별 가이드를 통해 알아보세요. | | [Word 문서 구조를 PDF 문서로 내보내기](./export-document-structure/) | Aspose.Words for .NET을 사용하여 Word 문서의 구조를 PDF로 내보내세요. 단계별 가이드를 따라 문서 레이아웃을 유지하고 PDF 탐색 기능을 개선해 보세요. | | [PDF 문서의 이미지 압축](./image-compression/) Aspose.Words for .NET을 사용하여 PDF 문서의 이미지를 압축하는 방법을 알아보세요. 파일 크기와 품질을 최적화하려면 이 가이드를 따르세요. | -| [PDF 문서에서 마지막으로 인쇄된 속성 업데이트](./update-last-printed-property/) | Aspose.Words for .NET을 사용하여 PDF 문서에서 마지막으로 인쇄된 속성을 업데이트하는 방법을 단계별 가이드를 통해 알아보세요. | +| [PDF 문서에서 마지막으로 인쇄된 속성 업데이트](./update-last-printed-property/) | Aspose.Words for .NET을 사용을 통해 PDF 문서에서 마지막으로 인쇄된 속성을 업데이트하는 방법을 단계별 가이드를 통해 알아보세요. | | [PDF 문서에서 3D DML 3DEffects 렌더링](./dml-3deffects-rendering/) | 이 포괄적인 단계별 가이드를 통해 Aspose.Words for .NET을 사용하여 PDF 문서에서 놀라운 3D DML 효과를 렌더링하는 방법을 알아보세요. | | [PDF 문서에서 이미지 보간](./interpolate-images/) | Aspose.Words for .NET을 사용하여 PDF 문서의 이미지를 보간하는 방법을 단계별 가이드를 통해 알아보세요. PDF 이미지 품질을 쉽게 개선할 수 있습니다. | diff --git a/words/korean/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/korean/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..4e072014c8 --- /dev/null +++ b/words/korean/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words를 사용하여 DOCX 파일에서 PDF를 저장하는 방법을 배웁니다. DOCX를 PDF로 변환하고, 옵션으로 + PDF를 저장하며, 떠 있는 도형을 처리하는 내용을 포함합니다. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: ko +og_description: Aspose.Words를 사용하여 DOCX 파일에서 PDF를 저장하는 방법. 이 가이드는 docx를 pdf로 변환하고, + 옵션으로 pdf를 저장하며, 떠다니는 도형을 처리하는 방법을 보여줍니다. +og_title: DOCX에서 PDF로 저장하는 방법 – 완전한 Aspose.Words 튜토리얼 +tags: +- Aspose.Words +- C# +- PDF conversion +title: Aspose.Words로 DOCX를 PDF로 저장하는 방법 – 단계별 가이드 +url: /ko/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose.Words를 사용하여 DOCX에서 PDF 저장하기 – 완전 가이드 + +워드 문서에서 **PDF 저장 방법**을 떠다니는 도형의 레이아웃을 잃지 않고 변환하는 방법이 궁금했나요? 당신만 그런 것이 아닙니다. 인보이스 생성기, 보고서 내보내기, 간단한 문서 보관 등 많은 프로젝트에서 개발자는 DOCX를 PDF로 변환하면서 Word에서 보는 그대로 유지하는 신뢰할 수 있는 방법이 필요합니다. + +이 튜토리얼에서는 DOCX 파일을 PDF로 변환하는 과정을 **Aspose.Words for .NET**을 사용해 단계별로 안내하고, 사용자 지정 저장 옵션으로 **docx를 pdf로 변환하는 방법**을 보여주며, `ExportFloatingShapesAsInlineTag` 플래그가 왜 중요한지 설명합니다. 끝까지 따라오면 옵션을 직접 제어하여 PDF를 저장하는 실행 가능한 코드 조각을 얻을 수 있습니다. + +## 배울 내용 + +- Aspose.Words를 사용하여 **워드 문서 PDF 변환**을 위한 정확한 단계. +- `PdfSaveOptions`를 구성하여 떠다니는 도형을 인라인 태그로 처리하는 방법. +- 떠다니는 객체를 다룰 때 흔히 발생하는 함정과 이를 피하는 방법. +- 어떤 .NET 프로젝트에도 바로 삽입할 수 있는 완전한 실행 가능한 C# 프로그램. + +> **전제 조건:** Aspose.Words for .NET 라이선스(또는 무료 평가판)와 .NET 개발 환경(Visual Studio, Rider, 또는 `dotnet` CLI)이 필요합니다. + +## 단계 1: 프로젝트 설정 및 Aspose.Words 추가 + +먼저, 새 콘솔 앱을 만들거나 기존 앱에 추가하고 Aspose.Words NuGet 패키지를 참조합니다. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **프로 팁:** CI 서버를 사용 중이라면 패키지 버전을 고정(`Aspose.Words --version 24.10`)하여 재현 가능한 빌드를 보장하세요. + +## 단계 2: 떠다니는 도형이 포함된 DOCX 로드 + +떠다니는 그림, 텍스트 상자, SmartArt는 변환 시 레이아웃이 이동할 수 있습니다. 문서를 로드하는 것은 간단하지만, 런타임 `FileNotFoundException`을 방지하기 위해 파일 존재 여부도 확인합니다. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +`Console.WriteLine` 문을 확인하세요—터미널에서 앱을 실행할 때 빠른 피드백을 제공합니다. + +## 단계 3: PDF 저장 옵션 구성 (옵션을 사용한 PDF 저장) + +여기서 마법이 일어납니다. 기본적으로 Aspose.Words는 떠다니는 객체를 그대로 유지하려고 하는데, 이는 결과 PDF의 레이아웃을 깨뜨릴 수 있습니다. `ExportFloatingShapesAsInlineTag`를 `true`로 설정하면 라이브러리가 해당 도형을 인라인 태그로 처리하도록 하여 주변 텍스트에 고정되도록 합니다. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +왜 중요한가요? 단락 위에 떠 있는 텍스트 상자를 상상해 보세요. 인라인‑태그 변환이 없으면 PDF가 단락을 아래로 밀어내거나 상자를 완전히 잘라낼 수 있습니다. 이 플래그는 시각적 관계를 그대로 유지해 주며, 전문 보고서에서 미묘하지만 중요한 디테일입니다. + +## 단계 4: 문서를 PDF로 저장 + +이제 실제로 PDF 파일을 씁니다. `Save` 메서드는 출력 경로와 방금 설정한 옵션을 모두 받습니다. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +프로그램을 실행하면 원본 DOCX와 같은 폴더에 `output.pdf`가 생성됩니다. PDF 뷰어에서 열면 모든 떠다니는 도형이 정확히 제자리에 렌더링된 것을 확인할 수 있습니다. + +## 전체 작동 예제 + +아래는 전체 프로그램을 하나의 블록으로 정리한 것입니다. `Program.cs`(또는任意 C# 파일)에 복사‑붙여넣기하고 **F5**를 눌러 실행하세요. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### 예상 결과 + +- **파일 생성:** 대상 디렉터리에 `output.pdf`가 생성됩니다. +- **레이아웃 정확도:** 떠다니는 도형(그림, 텍스트 상자, SmartArt)이 주변 텍스트와 인라인으로 표시됩니다. +- **예외 없음:** 프로그램이 정상 종료되며 상태 메시지를 콘솔에 출력합니다. + +## 자주 묻는 질문 및 엣지 케이스 + +| Question | Answer | +|----------|--------| +| **이미지 품질을 더 높여야 한다면?** | 다음과 같이 설정합니다 `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **여러 DOCX 파일을 배치로 변환할 수 있나요?** | 로드/저장 로직을 `foreach (var file in Directory.GetFiles(..., "*.docx"))` 루프로 감싸세요. 성능을 위해 단일 `PdfSaveOptions` 인스턴스를 재사용하는 것을 기억하세요. | +| **.NET Core에서도 작동하나요?** | 네, 가능합니다. Aspose.Words 24.x는 .NET Standard 2.0+를 지원하므로 Windows, Linux, macOS에서 동일한 코드를 실행할 수 있습니다. | +| **비밀번호로 보호된 DOCX 파일은 어떻게 처리하나요?** | `new Document(inputPath, new LoadOptions { Password = "mySecret" })` 로 로드합니다. 저장 시에도 동일한 `PdfSaveOptions`가 적용됩니다. | +| **복잡한 표에서도 인라인‑태그 변환이 안전한가요?** | 대체로 안전하지만, 겹치는 도형이 있는 매우 복잡한 표 레이아웃은 수동 조정이 필요할 수 있습니다. 대량 마이그레이션 전에 대표 샘플을 테스트하세요. | + +## 실제 프로젝트를 위한 팁 + +- **`Console.WriteLine`만 사용하지 말고 로그를 남기세요** – 프로덕션에서는 콘솔 출력을 로깅 프레임워크(Serilog, NLog)로 교체하여 오류를 기록합니다. +- **리소스 해제** – `Document`는 `IDisposable`을 구현합니다. 많은 파일을 처리할 경우 `using` 블록으로 감싸 메모리를 즉시 해제하세요. +- **PDF 검증** – 보관용 PDF가 필요하면 PDF 검증 도구(예: PDF/A 준수 검사기)를 사용하세요. +- **병렬 처리** – 대규모 작업에서는 `Parallel.ForEach`와 스레드‑안전 `PdfSaveOptions`(스레드당 복제)를 사용해 변환 속도를 높이는 것을 고려하세요. + +## 결론 + +우리는 Aspose.Words를 사용하여 DOCX 파일을 PDF로 **저장하는 방법**을 다루었고, 사용자 지정 옵션으로 **docx를 pdf로 변환하는 방법**을 시연했으며, `ExportFloatingShapesAsInlineTag`의 영향을 설명했습니다. 완전하고 실행 가능한 예제를 통해 몇 줄의 코드만으로 **워드 문서 PDF 변환**이 가능함을 보여주었으며, 이제 프로젝트의 품질 및 규정 준수 요구에 맞는 **옵션을 사용한 PDF 저장** 방법을 알게 되었습니다. + +다음 도전에 준비가 되었나요? `document.Save("output.html")`와 같이 다른 형식(예: HTML, EPUB)으로 내보내거나 장기 보관을 위해 PDF/A 준수를 실험해 보세요. 로드 → 옵션 구성 → 저장이라는 동일한 원칙이 모든 경우에 적용됩니다. + +코딩을 즐기세요, 그리고 여러분의 PDF가 언제나 의도한 대로 정확히 표시되길 바랍니다! + +![DOCX 파일이 로드되고 옵션이 적용되어 PDF가 생성되는 과정을 보여주는 다이어그램 – PDF 저장 방법](https://example.com/images/how-to-save-pdf-diagram.png "PDF 저장 방법 다이어그램") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/korean/net/programming-with-shapes/_index.md b/words/korean/net/programming-with-shapes/_index.md index 9a174b8adb..c5acc5eee1 100644 --- a/words/korean/net/programming-with-shapes/_index.md +++ b/words/korean/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Aspose.Words for .NET을 사용하고 이 튜토리얼을 따라 하면 Word 문 | [스마트 아트 모양 감지](./detect-smart-art-shape/) | Aspose.Words for .NET을 사용하여 Word 문서에서 SmartArt 도형을 감지하는 방법을 이 포괄적인 가이드를 통해 알아보세요. 문서 워크플로 자동화에 매우 유용합니다. | | [스마트 아트 드로잉 업데이트](./update-smart-art-drawing/) | Aspose.Words for .NET을 사용하여 Word 문서의 Smart Art 그림을 업데이트하는 방법을 단계별 가이드를 통해 알아보세요. 시각적 표현이 항상 정확한지 확인하세요. | | [Aspose.Words를 사용하여 Word에서 사각형 도형 만들기 – 단계별 가이드](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Aspose.Words for .NET을 사용하여 Word 문서에 사각형 도형을 삽입하고 속성을 설정하는 방법을 단계별로 안내합니다. | +| [C#으로 Word 문서 만들기 – 그림자 있는 도형 추가](./create-word-document-c-add-shape-with-shadow/) | Aspose.Words for .NET을 사용하여 그림자가 적용된 도형을 Word 문서에 추가하는 방법을 단계별로 안내합니다. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/korean/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/korean/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..d8f9dd58a6 --- /dev/null +++ b/words/korean/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: C#로 워드 문서를 만들고 도형을 추가하고 도형에 그림자를 적용하며 그림자 거리를 설정하는 방법을 배웁니다. Aspose.Words + 단계별 가이드. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: ko +og_description: C#로 사각형 모양과 사용자 지정 그림자가 있는 워드 문서를 만들고, 그림자 거리와 스타일을 설정하는 전체 튜토리얼을 + 따라보세요. +og_title: C#로 워드 문서 만들기 – 그림자 있는 도형 추가 +tags: +- Aspose.Words +- C# +- Document Automation +title: C#로 워드 문서 만들기 – 그림자 있는 도형 추가 +url: /ko/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Create Word Document C# – Add Shape with Shadow + +보고서 템플릿에 깔끔한 사각형을 넣고 싶으신가요? 혹은 레이아웃을 돋보이게 할 은은한 드롭‑섀도를 원하시나요? 이 튜토리얼에서는 바로 그 방법—도형을 추가하고, 섀도를 적용하며, Aspose.Words를 사용해 섀도 거리까지 조정하는 과정을 단계별로 안내합니다. + +빈 문서에서 사각형을 삽입하고, 사전 설정된 섀도를 적용한 뒤 파일을 저장합니다. 완료되면 .docx 파일을 Word에서 바로 열어 효과를 확인할 수 있습니다. 별도의 외부 도구 없이 순수 C# 코드만으로 구현합니다. + +## Prerequisites + +- .NET 6 (또는 최신 .NET Framework) 설치 +- Visual Studio 2022 또는 C# 확장 기능이 포함된 VS Code +- Aspose.Words for .NET NuGet 패키지 (`Aspose.Words` 버전 23.12 이상) + 패키지 매니저 콘솔에서 다음 명령으로 추가합니다: + + ```powershell + Install-Package Aspose.Words + ``` + +이것만 있으면 됩니다—추가 DLL이나 COM 인터옵 필요 없음. + +## Step 1: Initialize a New Document and Builder – *create word document c#* Basics + +먼저 Word 파일을 나타내는 `Document` 객체와 이를 편집할 `DocumentBuilder` 를 생성합니다. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Why this step matters:** `Document` 클래스는 모든 Word 파트(페이지, 스타일, 이미지)를 담는 컨테이너이며, Builder는 저수준 노드 조작을 추상화한 고수준 API로, XML을 직접 다루지 않고도 **create word document c#** 를 손쉽게 할 수 있게 해줍니다. + +## Step 2: Insert a Rectangle Shape – *how to create rectangle* + +이제 페이지에 사각형을 배치합니다. 크기는 포인트 단위(1 pt ≈ 1/72 in)로 지정합니다. + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro tip:** 다른 도형이 필요하면 `ShapeType.Rectangle`을 `ShapeType.Ellipse`, `ShapeType.Triangle` 등으로 교체하면 됩니다. 동일한 코드는 **how to add shape** 모든 유형에 적용됩니다. + +## Step 3: Apply a Preset Shadow and Fine‑Tune It – *apply shadow to shape* + +Aspose.Words는 여러 사전 설정 섀도 포맷을 제공합니다. 여기서는 `Preset1`을 사용하고 거리, 블러, 투명도, 색상을 커스터마이즈합니다. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Why customize the shadow?** `Distance` 속성은 섀도가 사각형으로부터 떨어진 거리를 제어합니다—3‑D 렌더링에서 “리프트”와 같은 개념입니다. `BlurRadius`를 조정하면 가장자리가 부드러워지고, `Transparency`를 활용하면 미묘하고 전문적인 느낌을 만들 수 있습니다. 이는 **set shadow distance** 요구사항을 충족시키며 **apply shadow to shape** 를 유연하게 구현하는 방법을 보여줍니다. + +## Step 4: Save the Document – *create word document c#* Completion + +마지막으로 문서를 디스크에 저장합니다. 쓰기 권한이 있는 폴더 경로로 수정하세요. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Microsoft Word에서 결과 파일을 열면, 연한 파란색 사각형에 회색 섀도가 5 pt 만큼 오프셋된 모습을 확인할 수 있습니다. 이는 **create word document c#** 로 스타일이 적용된 도형을 성공적으로 만든 증거입니다. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# 예시: 그림자와 사각형"} + +## Optional Variations & Edge Cases + +| 시나리오 | 변경 내용 | 중요 이유 | +|----------|----------|-----------| +| **다른 섀도 스타일** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | 추가 코드 없이 더 강렬한 효과 제공 | +| **프리셋 없이 커스텀 섀도** | `Format`을 생략하고 `OffsetX`, `OffsetY`를 직접 설정 | 방향과 깊이를 완전 제어 | +| **여러 도형** | 저장하기 전에 `builder.InsertShape`를 다시 호출 | 아이콘, 로고 등 복잡한 템플릿에 유용 | +| **구버전 Aspose와 호환** | `ShadowEffect` 클래스 사용 (v20.x에서 제공) | 레거시 프로젝트에서도 동작 보장 | +| **PDF로 저장** | `document.Save("ShadowShape.pdf");` | PDF 출력에서도 동일한 섀도 렌더링 | + +> **Common question:** *섀도가 Word에서 보이지 않으면 어떻게 하나요?* +> 최신 버전의 Aspose.Words(≥ 22.9)를 사용하고 있는지 확인하세요. 이전 버전은 섀도 지원이 제한적이었습니다. 또한 Word 2016 이상 최신 버전에서 문서를 열어야 합니다. + +## Full Working Example + +아래는 복사‑붙여넣기만 하면 바로 실행 가능한 전체 프로그램입니다. 모든 `using` 지시문, 주석, 오류 처리까지 포함돼 있어 원활한 경험을 제공합니다. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +프로그램을 실행하고 `C:\Temp\ShadowShape.docx` 로 이동하면, 우리가 설정한 정확한 섀도가 적용된 사각형을 확인할 수 있습니다. + +## Recap & Next Steps + +- 이제 **create word document c#** 로 사각형을 삽입하고 **apply shadow to shape** 와 **set shadow distance** 를 커스터마이즈하는 방법을 알게 되었습니다. +- 예제는 Aspose.Words를 사용해 OpenXML 복잡성을 추상화하고 Word 버전 간 일관된 렌더링을 보장합니다. +- 더 나아가고 싶다면 여러 도형을 결합하거나 사각형 안에 텍스트를 넣어보세요. 혹은 동일 문서를 PDF로 내보내어 섀도가 어떻게 변환되는지도 확인해 보세요. + +### Related Topics You Might Explore + +- 헤더/푸터에 **how to add shape** 로 브랜드 로고 삽입하기 +- **Aspose.Words** 로 차트와 표를 프로그래밍 방식으로 삽입하기 +- 벡터 도형이 아닌 사진에 **shadow effects** 적용하기 +- 인보이스나 인증서와 같은 대량 문서 자동 생성 + +코드를 자유롭게 실험하고, 깨뜨렸다가 다시 고쳐보세요—가장 빠른 학습 방법입니다. 문제가 생기면 아래 댓글을 남기거나 공식 Aspose.Words 문서를 참고해 깊이 있는 API 정보를 확인하세요. + +Happy coding, and enjoy making your Word files look a little more polished! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/korean/net/programming-with-txtsaveoptions/_index.md b/words/korean/net/programming-with-txtsaveoptions/_index.md index 3d38efe5e7..1c2d66a2a2 100644 --- a/words/korean/net/programming-with-txtsaveoptions/_index.md +++ b/words/korean/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Aspose.Words for .NET 튜토리얼은 Word 문서 조작과 관련하여 라이 | [Word 문서에 비디 마크 추가](./add-bidi-marks/) | 이 가이드를 통해 Aspose.Words for .NET을 사용하여 Word 문서에 양방향(Bidi) 표시를 추가하는 방법을 알아보세요. 다국어 콘텐츠의 텍스트 방향을 올바르게 설정하세요. | | [목록 들여쓰기를 위해 레벨당 탭 문자 사용](./use-tab-character-per-level-for-list-indentation/) | Aspose.Words for .NET을 사용하여 탭 들여쓰기가 적용된 다단계 목록을 만드는 방법을 알아보세요. 문서에서 정확한 목록 서식을 지정하려면 이 가이드를 따르세요. | | [목록 들여쓰기에 레벨당 공백 문자 사용](./use-space-character-per-level-for-list-indentation/) | Aspose.Words for .NET에서 공백 문자 들여쓰기를 적용한 다단계 목록을 만드는 방법을 알아보세요. 정확한 문서 서식 지정을 위한 단계별 가이드입니다. | - +| [docx를 txt로 저장 – Word 방정식을 LaTeX로 내보내는 완전 가이드](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Aspose.Words for .NET을 사용해 docx 파일을 txt로 변환하고, Word 방정식을 LaTeX 형식으로 내보내는 방법을 단계별로 안내합니다. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/korean/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/korean/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..611892c472 --- /dev/null +++ b/words/korean/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,245 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words를 사용하여 docx를 txt로 저장하고 Word를 LaTeX로 변환하세요. 방정식을 내보내고 일반 텍스트를 + 유지하며 몇 분 안에 LaTeX 마크업을 얻는 방법을 배워보세요. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: ko +og_description: Aspose.Words를 사용하여 docx를 txt로 저장합니다. 이 가이드는 Word를 LaTeX로 변환하고, 수식을 + 내보내며, 문서를 일반 텍스트로 유지하는 방법을 보여줍니다. +og_title: docx를 txt로 저장 – Word 수식을 LaTeX로 내보내기 +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: docx를 txt로 저장 – Word 수식을 LaTeX로 내보내는 완전 가이드 +url: /ko/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# docx를 txt로 저장 – Word 수식들을 LaTeX로 내보내기 + +Word 파일 안에 있는 복잡한 수식을 잃을까 걱정하면서 **docx를 txt로 저장**해야 할 때가 있나요? 당신만 그런 것이 아닙니다. 많은 과학 워크플로우에서 문서의 순수 텍스트 버전은 필수이지만, 수식은 깔끔한 LaTeX 마크업으로 유지하고 싶습니다. + +이 튜토리얼에서는 Aspose.Words for .NET을 사용해 **Word를 LaTeX로 변환**하는 정확한 단계를 안내합니다. 수식은 올바르게 내보내고 나머지 문서는 깔끔한 순수 텍스트가 됩니다. 끝까지 읽으면 **수식을 LaTeX로 내보내는 방법**, 파일을 간단한 텍스트로 유지하는 방법, 그리고 초보자들이 흔히 겪는 함정을 피하는 방법을 알게 됩니다. + +## 배울 내용 + +- Office Math가 포함된 *.docx* 파일을 로드하는 방법. +- 모든 수식에 대해 Aspose가 LaTeX를 출력하도록 올바른 `TxtSaveOptions` 설정하기. +- 결과를 **save word plain text** 파일로 저장해 버전 관리, CI 파이프라인 또는 기타 다운스트림 도구에 활용하기. +- 이미지와 수식이 혼합된 문서나 Unicode 문자를 보존해야 할 때 등 일반적인 엣지 케이스 처리 방법. +- 콘솔 앱에 바로 넣어 실행할 수 있는 완전한 코드 샘플. + +### 사전 요구 사항 + +- .NET 6.0 이상 (.NET Framework 4.7+에서도 동작합니다). +- **Aspose.Words for .NET** 라이선스 사본 (무료 체험판으로 테스트 가능). +- C# 프로젝트를 컴파일할 수 있는 Visual Studio 2022 또는 기타 IDE. +- 이미 Office Math 객체가 포함된 Word 문서(`input.docx`). + +> **Pro tip:** 아직 라이선스가 없으면 Aspose 웹사이트에서 임시 키를 요청할 수 있습니다—코드에 있는 플레이스홀더를 키로 교체한 뒤 실행하세요. + +## 1단계 – NuGet을 통해 Aspose.Words 설치 + +먼저 프로젝트에 라이브러리를 추가해야 합니다. **Package Manager Console**을 열고 다음을 실행하세요: + +```powershell +Install-Package Aspose.Words +``` + +이 한 줄로 `TxtSaveOptions`가 포함된 `Saving` 네임스페이스를 비롯해 필요한 모든 것이 설치됩니다. 추가 DLL이나 네이티브 종속성 없이 순수 관리 코드만 포함됩니다. + +## 2단계 – 원본 Word 문서 로드 + +이제 실제로 수식이 들어 있는 파일을 읽습니다. `Document` 클래스는 전체 *.docx* 구조를 추상화하므로 고수준 객체 모델처럼 다룰 수 있습니다. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**왜 중요한가:** 문서를 일찍 로드하면 노드 트리를 검사할 수 있습니다. 체크를 건너뛰고 파일에 수식이 없으면 여전히 깨끗한 txt 파일이 생성되지만, LaTeX 출력이 비어 있는 이유를 알 수 없습니다. + +## 3단계 – LaTeX 내보내기를 위한 TxtSaveOptions 설정 + +Aspose는 Office Math가 렌더링되는 방식을 세밀하게 제어할 수 있게 해줍니다. `OfficeMathExportMode`를 `LaTeX`로 설정하면 모든 수식이 이미지나 삭제 대신 LaTeX 등가물로 변환됩니다. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**왜 중요한가:** 기본 내보내기 모드는 수식을 완전히 삭제합니다. `LaTeX`로 전환하면 수학적 의미가 보존되며, 이후 LaTeX 컴파일러나 `$…$` 구문을 이해하는 마크다운 프로세서에 파일을 전달할 때 정확히 필요합니다. + +## 4단계 – 문서를 순수 텍스트로 저장 + +옵션을 설정했으니 파일 저장은 한 줄 코드로 끝납니다. 출력은 각 수식이 `$` 구분자로 둘러싸인 LaTeX 코드로 표시된 `.txt` 파일이 됩니다(원한다면 `\[` … `\]` 블록으로 변경 가능). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### 예상 결과 + +편집기에서 `output.txt`를 열면 다음과 같은 내용이 보일 것입니다: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +일반 텍스트는 그대로 유지되고, 수식은 순수 LaTeX 문자열로 변환된 것을 확인할 수 있습니다. 이를 LaTeX 문서, Jupyter 노트북, 혹은 수식을 렌더링하는 어떤 도구에든 바로 복사‑붙여넣기 할 수 있습니다. + +## 5단계 – 엣지 케이스 처리 + +### 혼합 콘텐츠 (이미지 + 수식) + +Word 파일에 이미지도 포함되어 있다면 `TxtSaveOptions` 사용 시 이미지가 무시됩니다. 이는 **save word plain text** 워크플로우에 보통 문제되지 않지만, 이미지가 자리표시자로 필요하다면 다음과 같이 할 수 있습니다: + +1. 문서를 먼저 HTML(`HtmlSaveOptions`)로 내보내 이미지가 `` 태그로 캡처되게 합니다. +2. `TxtSaveOptions`로 두 번째 패스를 실행해 LaTeX 수식을 얻습니다. +3. 두 결과를 수동으로 혹은 작은 스크립트를 이용해 병합합니다. + +### 유니코드 기호 + +일부 수식은 특수 Unicode 문자(예: 그리스 문자)를 사용합니다. Step 3에서 보여준 대로 `TxtSaveOptions`에 `Encoding = Encoding.UTF8`을 설정하면 이러한 기호가 변환 과정에서 보존됩니다. + +### 대용량 문서 + +100 MB 이상과 같은 거대한 파일의 경우 저장 작업을 스트리밍하는 것을 고려하세요: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +스트리밍을 사용하면 전체 출력을 메모리에 로드하지 않아 메모리 부족 빌드 에이전트에서 큰 도움이 됩니다. + +## 전체 작업 예제 + +아래는 모든 단계를 하나로 묶은 완전한 복사‑붙여넣기 가능한 프로그램입니다. 파일 경로와(있다면) 라이선스 라인만 교체하면 됩니다. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +프로그램을 실행(`dotnet run` 콘솔 프로젝트 사용 시)하고 `output.txt`를 확인하세요. 이제 **docx를 txt로 저장**하면서 모든 수식을 LaTeX로 보존했으니 수동 복사‑붙여넣기가 필요 없습니다. + +## 자주 묻는 질문 + +**Q: 구분자를 `$…$`에서 `\(...\)` 로 바꿀 수 있나요?** +A: 가능합니다. 저장 후 파일에 대해 간단히 교체하면 됩니다: `output = output.Replace("$", @"\(").Replace("$", @"\)");`—원본 텍스트에 포함된 인라인 `$` 문자를 실수로 교체하지 않도록 주의하세요. + +**Q: Word 2007‑2019 파일에서도 동작하나요?** +A: 물론입니다. Aspose.Words는 `.doc`, `.docx`, `.docm`뿐 아니라 최신 `.dotx` 계열까지 지원합니다. 동일한 코드가 모든 버전에서 작동합니다. + +**Q: 원본 단락 서식(탭, 다중 공백)을 유지하려면 어떻게 해야 하나요?** +A: `txtSaveOptions.PreserveTableLayout = true;`와 `txtSaveOptions.PreserveSpace = true;`를 설정하면 공백이 그대로 보존됩니다. + +## 결론 + +우리는 Aspose.Words를 사용해 **docx를 txt로 저장**하면서 **수식을 LaTeX로 내보내는** 모든 방법을 다루었습니다. 핵심 단계는 문서 로드, `TxtSaveOptions`를 `OfficeMathExportMode.LaTeX`로 설정, 그리고 저장입니다. 이 세 줄의 코드만으로 **word를 latex로 변환**하고 문서를 **save word plain text** 형태로 유지하며 수식 손실을 방지할 수 있습니다. + +다음 도전 과제가 준비되셨나요? 이 워크플로우를 마크다운 생성기와 연결해 텍스트와 LaTeX가 모두 포함된 완전한 `.md` 파일을 만들어 보세요—Git 기반 문서화나 정적 사이트 생성기에 최적입니다. 혹은 Aspose의 `PdfSaveOptions`를 탐색해 평문 파일과 함께 PDF 버전을 생성해 보세요. + +문제가 발생하면 아래에 댓글을 남겨 주세요. 즐거운 코딩 되시고, Word 수식을 깔끔한 LaTeX로 변환하는 단순함을 만끽하시길 바랍니다! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/korean/net/working-with-fonts/_index.md b/words/korean/net/working-with-fonts/_index.md index 6f0e573229..6fbc7707f5 100644 --- a/words/korean/net/working-with-fonts/_index.md +++ b/words/korean/net/working-with-fonts/_index.md @@ -48,7 +48,7 @@ | [경고 알림 수신](./receive-warning-notification/) Aspose.Words for .NET을 사용할 때 경고 알림을 받는 방법과 문서의 문제나 경고를 관리하는 방법을 알아보세요. | | [리소스 Steam 글꼴 소스 예시](./resource-steam-font-source-example/) | Aspose.Words for .NET에 사용자 정의 글꼴을 로드하기 위해 Resource Stream 글꼴 소스를 사용하는 방법을 알아보세요. | | [접미사 없이 대체 가져오기](./get-substitution-without-suffixes/) | 이 튜토리얼에서는 Aspose.Words for .NET을 사용하여 Word 문서에서 접미사 없는 재정의를 얻는 방법을 알아봅니다. | - +| [Aspose 글꼴 대체 – C#에서 글꼴 설정 구성 방법](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Aspose.Words for .NET을 사용하여 C#에서 글꼴 대체 설정을 구성하는 방법을 단계별로 안내합니다. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/korean/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/korean/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..1719b4c3d3 --- /dev/null +++ b/words/korean/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose 글꼴 대체를 쉽게: .NET 앱에서 글꼴 설정을 구성하고, 경고를 캡처하며, 누락된 글꼴을 처리하는 방법을 배우세요.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: ko +og_description: 폰트 설정을 구성하고 경고 콜백으로 누락된 폰트를 처리하여 Aspose 폰트 대체를 마스터하세요. 완전한 C# 가이드. +og_title: Aspose 글꼴 대체 – C#에서 글꼴 설정 구성 +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose 글꼴 대체 – C#에서 글꼴 설정 구성 방법 +url: /ko/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose 글꼴 대체 – 글꼴 설정 구성 완전 가이드 + +문서가 갑자기 사용자 지정 글꼴을 일반적인 글꼴로 바꾸는 경우를 겪어본 적 있나요? 그것이 **aspose font substitution**이 작업을 수행하는 것으로, 누락된 글꼴을 가장 가까운 매치로 교체합니다. 편리하지만, *정확히* 어떤 글꼴이 교체되었는지 알아야 한다면 라이브러리의 경고 시스템에 접근하고 직접 글꼴 설정을 구성해야 합니다. + +이 튜토리얼에서는 실제 시나리오를 따라가 보겠습니다: 누락된 글꼴을 참조하는 DOCX를 로드하고, 대체 이벤트를 캡처하며, 콘솔에 친절한 메시지를 출력합니다. 끝까지 진행하면 **configure font settings**에 익숙해지고, **Aspose.Words warning callback**을 연결하며, 샘플을 어떤 워크플로에도 확장할 수 있게 됩니다. + +> **필요한 사항** +> • .NET 6+ (또는 .NET Framework 4.7.2+) +> • Aspose.Words for .NET (최신 NuGet) +> • 누락된 글꼴을 참조하는 DOCX (예: `MissingFont.docx`) + +자, 시작해 보겠습니다. + +--- + +## Step 1: Install Aspose.Words and Prepare the Project + +코드를 작성하기 전에 Aspose.Words 패키지가 참조되어 있는지 확인하세요: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro tip:** 최신 안정 버전을 사용하세요; 2026년 3월 현재 버전은 23.11.0입니다. 최신 릴리스는 글꼴 매칭 알고리즘을 개선하고 추가 경고 유형을 제공합니다. + +새 콘솔 앱을 만들거나 기존 프로젝트에 코드를 추가하고, 일반적인 `using` 지시문을 추가합니다: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +이 네임스페이스를 통해 `Document`, `LoadOptions` 및 필요한 글꼴 관련 클래스를 사용할 수 있습니다. + +--- + +## Step 2: Configure Font Settings with LoadOptions + +**aspose font substitution** 제어의 핵심은 `LoadOptions.FontSettings`에 있습니다. 빈 `FontSettings` 객체를 제공하면 Aspose가 기본 검색 경로를 사용하도록 하면서, 대체 정보를 경고 콜백을 통해 보고하도록 합니다. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +왜 기본값만 사용하지 않을까요? 경고 콜백(다음 단계)을 연결하려면 `FontSettings` 속성이 null이 아니어야 합니다. 이 작은 한 줄이 실제 글꼴 검색 동작을 바꾸지 않으면서도 대체 프로세스에 훅을 제공합니다. + +--- + +## Step 3: Attach a Warning Callback to Capture Substitutions + +Aspose.Words는 `IWarningCallback` 인터페이스를 구현합니다. 누락된 글꼴과 같은 중요한 일이 발생하면 `Warning` 메서드를 호출합니다. 우리는 `WarningType.FontSubstitution`을 필터링하고 설명을 콘솔에 출력하는 작은 핸들러를 구현합니다. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +그리고 실제 핸들러는 다음과 같습니다: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **왜 중요한가** – 콜백이 없으면 Aspose가 조용히 글꼴을 교체하고, 어떤 글꼴이 사용됐는지 알 수 없습니다. 콜백을 통해 프로세스가 투명해져서 규정 준수 보고나 레이아웃 디버깅에 필수적입니다. + +--- + +## Step 4: Load the Document Using the Configured Options + +이제 준비한 `loadOptions`를 전달하면서 문서를 로드합니다. 소스 파일이 설치되지 않은 글꼴을 참조하면 핸들러가 작동합니다. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +`YOUR_DIRECTORY`를 `MissingFont.docx`가 실제로 위치한 경로로 바꾸세요. 프로그램을 실행하면 다음과 유사한 출력이 표시됩니다: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +이 라인은 누락된 글꼴과 Aspose가 선택한 대체 글꼴을 정확히 알려줍니다. + +--- + +## Step 5: (Optional) Fine‑Tune Font Search Paths + +사내 전용 글꼴 폴더가 있다면 시스템 글꼴에 fallback하기 전에 Aspose가 해당 폴더를 검색하도록 지정할 수 있습니다. 이는 **configure font settings**의 고급 활용 예입니다: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +`recursive: true` 옵션을 사용하면 하위 폴더까지 스캔합니다. 이제 라이브러리는 사설 글꼴을 먼저 시도하므로 원치 않는 대체가 발생할 가능성이 줄어듭니다. + +--- + +## Full Working Example + +모든 코드를 합치면 다음과 같은 완전한 실행 프로그램이 됩니다: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**예상 출력** (누락된 글꼴이 발견된 경우): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +모든 글꼴이 존재하면 프로그램은 조용히 실행되며(경고 없음) PDF를 생성합니다. + +--- + +## Common Questions & Edge Cases + +### What if I need to *prevent* substitution altogether? + +`FontSettings.SubstitutionSettings`를 `null`로 설정하거나 `FontSettings.FontSubstitutionSettings`를 사용해 동작을 제어합니다. 예시: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +이제 Aspose는 조용히 대체하지 않고 예외를 발생시키며, 이를 잡아 처리할 수 있습니다. + +### Does this work with other file formats (e.g., .doc, .rtf)? + +물론입니다. 동일한 `LoadOptions` 객체를 파일 경로를 받는 모든 `Document` 생성자에 전달할 수 있습니다. 경고 콜백은 글꼴을 사용하는 모든 형식에서 작동합니다. + +### Can I capture the *exact* fallback font name? + +가능합니다. `info.Description` 문자열에 누락된 글꼴과 교체된 글꼴이 모두 포함됩니다. 프로그래밍적으로 이름이 필요하면 문자열을 파싱하거나 최신 버전에서 제공되는 `FontInfo` 객체를 사용할 수 있습니다. + +### How does this behave in a multi‑threaded environment? + +`FontSettings`는 **스레드 안전**하지 않습니다. 스레드당 별도의 `LoadOptions`(및 자체 `FontSettings`)를 생성하거나, 접근을 `lock`으로 보호하세요. + +--- + +## Conclusion + +우리는 C# 애플리케이션에서 **aspose font substitution**과 **configure font settings**를 마스터하기 위해 필요한 모든 것을 다루었습니다: + +1. Aspose.Words를 설치하고 필요한 `using` 문을 추가합니다. +2. 새 `FontSettings`가 포함된 `LoadOptions` 객체를 생성합니다. +3. 사용자 정의 `IWarningCallback`을 연결해 대체 이벤트를 표시합니다. +4. 문서를 로드하고 콜백이 누락된 글꼴을 보고하도록 합니다. +5. (선택 사항) 검색 경로를 확장하거나 대체 자체를 비활성화합니다. + +이 패턴을 사용하면 규정 준수를 위해 누락된 글꼴을 기록하거나 UI에서 사용자에게 알리거나, 배포 전에 대체 글꼴을 자동으로 삽입할 수 있습니다. 다음 단계로 **Aspose.Words 글꼴 대체 정책**을 탐색하거나 워크플로에 통합해 보세요. + +행복한 코딩 되시고, 문서가 언제나 올바른 글꼴로 렌더링되길 바랍니다! + +--- + +![Aspose.Words가 문서를 로드하고 FontSettings를 호출하며 경고 콜백을 트리거하고 대체 정보를 출력하는 흐름도](image-placeholder.png "aspose 글꼴 대체 워크플로우") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/polish/net/basic-conversions/_index.md b/words/polish/net/basic-conversions/_index.md index 209d5ec211..f751c630e7 100644 --- a/words/polish/net/basic-conversions/_index.md +++ b/words/polish/net/basic-conversions/_index.md @@ -23,7 +23,7 @@ Basic Conversions przeprowadzi Cię przez podstawowe konwersje dokumentów przy | --- | --- | | [Konwertuj Doc do Docx](./doc-to-docx/) | Dowiedz się, jak przekonwertować DOC na DOCX za pomocą Aspose.Words dla .NET. Przewodnik krok po kroku z przykładami kodu. Idealny dla programistów. | | [Konwertuj Docx do RTF](./docx-to-rtf/) | Dowiedz się, jak przekonwertować DOCX na RTF za pomocą Aspose.Words dla .NET dzięki naszemu przewodnikowi krok po kroku. Łatwa konwersja dla bezproblemowego przetwarzania dokumentów. | -| [Konwertuj plik Word do PDF](./docx-to-pdf/) Dowiedz się, jak łatwo konwertować pliki Word do PDF za pomocą Aspose.Words dla .NET z naszym przewodnikiem. Idealne dla programistów poszukujących szybkiej i niezawodnej konwersji dokumentów. | +| [Konwertuj plik Word do PDF](./docx-to-pdf/) Dowiedz się, jak łatwo konwertować pliki Word do PDF za pomocą Aspose.Words dla .NET z naszym przewodnikiem. Idealne dla programistów poszukujących szybkiej i niezawodnej konwersji dokumentów. | | [Konwertuj Word do PDF w C# przy użyciu Aspose.Words – przewodnik](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Dowiedz się, jak w prosty sposób konwertować dokumenty Word do PDF w C# przy użyciu biblioteki Aspose.Words. | | [Konwertuj Docx na Bajt](./docx-to-byte/) | Dowiedz się, jak przekonwertować Docx na tablicę bajtów w .NET przy użyciu Aspose.Words w celu wydajnego przetwarzania dokumentów. Zawiera przewodnik krok po kroku. | | [Konwertuj Docx do Epub](./docx-to-epub/) | Łatwa konwersja DOCX do EPUB za pomocą Aspose.Words dla .NET. Skorzystaj z naszego samouczka, aby zapewnić sobie bezproblemową integrację z aplikacjami .NET. | @@ -35,6 +35,7 @@ Basic Conversions przeprowadzi Cię przez podstawowe konwersje dokumentów przy | [Zapisz PDF do formatu Word (Docx)](./pdf-to-docx/) | Dowiedz się, jak przekonwertować plik PDF na dokument Word (Docx) za pomocą Aspose.Words dla .NET w tym szczegółowym przewodniku krok po kroku. Idealne dla programistów. | | [Jak wyeksportować LaTeX z Worda – przewodnik krok po kroku](./how-to-export-latex-from-word-step-by-step-guide/) | Dowiedz się, jak wyeksportować dokument Word do formatu LaTeX przy użyciu Aspose.Words dla .NET. Szczegółowy przewodnik krok po kroku. | | [Zapisz Word jako PDF przy użyciu Aspose.Words – Kompletny przewodnik C#](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Dowiedz się, jak w prosty sposób zapisać dokument Word jako PDF przy użyciu Aspose.Words w C#. Szczegółowy przewodnik krok po kroku. | +| [Konwertuj Word do PDF przy użyciu Aspose.Words – Kompletny przewodnik](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Kompletny przewodnik, jak konwertować dokumenty Word do PDF przy użyciu Aspose.Words w C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/polish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/polish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..4562527fe1 --- /dev/null +++ b/words/polish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-03-27 +description: Szybko konwertuj Word na PDF przy użyciu Aspose.Words. Dowiedz się, jak + zapisać dokument Word jako PDF, wyeksportować docx do PDF i wygenerować dostępny + PDF w C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: pl +og_description: Konwertuj Word na PDF w C# przy użyciu Aspose.Words. Ten przewodnik + pokazuje, jak zapisać dokument Word jako PDF, wyeksportować docx do PDF oraz wygenerować + dostępny PDF. +og_title: Konwertuj Word do PDF za pomocą Aspose.Words – krok po kroku +tags: +- Aspose.Words +- C# +- PDF conversion +title: Konwertuj Word do PDF za pomocą Aspose.Words – Kompletny przewodnik +url: /pl/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Konwertowanie Word do PDF przy użyciu Aspose.Words – Kompletny przewodnik + +Zastanawiałeś się kiedyś, jak **konwertować Word do PDF** bez kombinowania z narzędziami internetowymi firm trzecich? Być może tworzysz zautomatyzowany silnik raportów i potrzebujesz niezawodnego sposobu na *zapisanie word jako pdf* w locie. Dobra wiadomość jest taka, że Aspose.Words sprawia, że cały proces jest banalny, a dodatkowo możesz wygenerować plik zgodny z **PDF/UA‑2** — idealny pod kątem wymagań dostępności. + +W tym samouczku przeprowadzimy Cię przez wszystko, co potrzebne: wczytanie pliku `.docx`, skonfigurowanie opcji PDF, abyś mógł *wyeksportować docx do pdf* z zachowaniem zgodności PDF/UA, a na końcu zapisanie wyniku jako dostępny PDF. Po zakończeniu będziesz mieć samodzielny, gotowy do produkcji fragment kodu, który możesz wkleić do dowolnego projektu .NET. + +![Konwertuj Word do PDF przy użyciu Aspose.Words](convert-word-to-pdf.png) + +## Czego się nauczysz + +- **Dlaczego Aspose.Words** jest solidnym wyborem dla scenariuszy *generowania dostępnych pdf*. +- Dokładne kroki, aby *zapisać dokument jako pdf* zgodnie z PDF/UA‑2. +- Jak radzić sobie z typowymi przypadkami brzegowymi, takimi jak brakujące czcionki lub pliki źródłowe chronione hasłem. +- Szybkie wskazówki dotyczące debugowania wyniku i weryfikacji zgodności dostępności. + +### Wymagania wstępne + +- .NET 6 lub nowszy (API działa również na .NET Framework 4.6+). +- Ważna licencja Aspose.Words for .NET (bezpłatna wersja próbna działa w celach oceny). +- Podstawowa znajomość C# — nie są wymagane skomplikowane wzorce. + +Jeśli spełniasz te warunki, zanurzmy się. + +--- + +## Konwertowanie Word do PDF – Implementacja krok po kroku + +Podzielimy rozwiązanie na pięć przejrzystych kroków. Każdy krok ma nagłówek, krótki fragment kodu i wyjaśnienie, *dlaczego* kod ma znaczenie. + +### Krok 1: Wczytaj dokument Word, który chcesz przekonwertować + +Pierwszą rzeczą, której potrzebujesz, jest obiekt `Document` reprezentujący plik źródłowy. Aspose.Words odczytuje **.docx**, **.doc**, **.rtf** i wiele innych formatów, więc możesz *zapisować word jako pdf* niezależnie od tego, jak plik został pierwotnie utworzony. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Dlaczego to ważne:** +- Wczesne wczytanie pliku pozwala wykryć błędy brakującego pliku, zanim zmarnujesz cykle CPU. +- Klasa `Document` abstrahuje wewnętrzną strukturę pliku Word, dając czysty model obiektowy do pracy. + +### Krok 2: Skonfiguruj opcje zapisu PDF pod kątem dostępności + +Jeśli potrzebujesz *generować dostępne pdf* pliki, musisz poinstruować Aspose.Words, aby wyprodukował dokument zgodny z PDF/UA‑2. Klasa `PdfSaveOptions` daje precyzyjną kontrolę nad wynikiem. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Dlaczego to ważne:** +- `PdfCompliance.PdfUa2` informuje bibliotekę, aby dodała niezbędne znaczniki, informacje o strukturze i metadane, na których polegają czytniki ekranu. +- Osadzanie czcionek (`EmbedFullFonts = true`) zapobiega niechcianym ostrzeżeniom „czcionka nie znaleziona” przy otwieraniu PDF na innym systemie operacyjnym. +- Ustawienie `Title` pomaga technologiom wspomagającym prawidłowo ogłosić dokument. + +### Krok 3: Zapisz dokument jako PDF + +Teraz, gdy źródło jest wczytane i opcje ustawione, rzeczywista konwersja to jednowierszowy kod. To tutaj *eksportujesz docx do pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Dlaczego to ważne:** +- Metoda `Save` respektuje skonfigurowane `PdfSaveOptions`, zapewniając wbudowanie funkcji dostępności. +- Otoczenie wywołania w blok `try/catch` daje możliwość logowania lub wyświetlania błędów licencyjnych lub uprawnień, które często sprawiają problemy nowicjuszom. + +### Krok 4: Zweryfikuj zgodność PDF/UA (Opcjonalnie, ale zalecane) + +Mimo że Aspose.Words wykonuje ciężką pracę, dobrą praktyką jest podwójna weryfikacja wyniku, szczególnie gdy dostarczasz dokumenty do agencji rządowych lub innych podmiotów regulowanych. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Dlaczego to ważne:** +- `IsTagged` to szybka kontrola poprawności; pełna walidacja PDF/UA wymaga dedykowanego walidatora, ale większość problemów z zgodnością objawia się brakującymi znacznikami. +- Jeśli flaga zwróci `false`, możesz ponownie sprawdzić `PdfSaveOptions` — być może zapomniałeś ustawić `Compliance` lub dokument źródłowy nie zawierał prawidłowych stylów nagłówków. + +### Krok 5: Typowe pułapki i wskazówki profesjonalne + +| Pułapka | Co się dzieje | Jak naprawić | +|---------|--------------|------------| +| **Missing fonts** | Tekst wyświetla się jako kwadraty w PDF. | Ustaw `EmbedFullFonts = true` **lub** zainstaluj brakujące czcionki na serwerze. | +| **Unlicensed library** | Aspose dodaje znak wodny na każdej stronie. | Dodaj plik licencji (`Aspose.Words.lic`) na początku aplikacji (np. `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Password‑protected source** | `InvalidOperationException` przy `new Document(path)`. | Użyj przeciążenia `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Large documents cause OOM** | Wyjątek Out‑of‑memory przy dużych plikach. | Włącz `MemoryOptimization` w `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Accessibility tags missing** | Walidacja PDF/UA nie powodzi się. | Upewnij się, że plik Word źródłowy używa prawidłowych stylów nagłówków (`Heading 1`, `Heading 2` itd.) — Aspose mapuje je automatycznie na znaczniki PDF. | + +**Wskazówka profesjonalna:** Jeśli konwertujesz wiele dokumentów w partii, ponownie używaj jednej instancji `PdfSaveOptions`. Utworzenie jej raz zmniejsza narzut alokacji i utrzymuje niski ślad pamięci. + +--- + +## Pełny działający przykład (gotowy do kopiowania i wklejenia) + +Poniżej znajduje się kompletny program, który łączy wszystko razem. Zapisz go jako `Program.cs`, dodaj pakiety NuGet Aspose.Words i Aspose.PDF i uruchom. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Oczekiwany rezultat:** +Plik o nazwie `output.pdf` pojawia się w `C:\MyFiles`. Otwierając go w Adobe Acrobat zobaczysz „PDF/A‑2b, PDF/UA‑1” w panelu zgodności, co potwierdza, że pomyślnie *konwertowałeś word do pdf*. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/polish/net/programming-with-markdownsaveoptions/_index.md b/words/polish/net/programming-with-markdownsaveoptions/_index.md index 1b3955d9fc..1e49b8e521 100644 --- a/words/polish/net/programming-with-markdownsaveoptions/_index.md +++ b/words/polish/net/programming-with-markdownsaveoptions/_index.md @@ -46,6 +46,15 @@ Kompletny przewodnik krok po kroku, jak zapisać plik DOCX jako Markdown przy u ### [Jak wyeksportować Markdown z DOCX – Kompletny przewodnik](./how-to-export-markdown-from-docx-complete-guide/) Kompletny przewodnik pokazujący, jak wyeksportować pliki DOCX do formatu Markdown przy użyciu Aspose.Words dla .NET. +### [Jak wyeksportować LaTeX z Worda – konwertuj DOCX do Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) +Kompletny przewodnik C# pokazujący, jak wyeksportować równania LaTeX z dokumentu Word do formatu Markdown. + +### [Jak wyeksportować LaTeX z DOCX – konwertuj do Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) +Kompletny przewodnik C# pokazujący, jak wyeksportować równania LaTeX z pliku DOCX do formatu Markdown. + +### [Utwórz markdown z Worda – Pełny przewodnik C#](./create-markdown-from-word-full-c-guide/) +Kompletny przewodnik C# pokazujący, jak konwertować dokumenty Word do formatu Markdown przy użyciu Aspose.Words. + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/polish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/polish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..a66db191f3 --- /dev/null +++ b/words/polish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Twórz markdown z Worda przy użyciu Aspose.Words C#. Dowiedz się, jak + konwertować docx na markdown, wyodrębniać obrazy z Worda oraz jak używać callbacku + w jednym samouczku. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: pl +og_description: Utwórz markdown z Worda przy użyciu Aspose.Words. Ten przewodnik pokazuje, + jak konwertować docx na markdown, wyodrębniać obrazy z Worda oraz używać callbacku + do obsługi zasobów. +og_title: Utwórz markdown z Worda – Kompletny samouczek C# +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Utwórz markdown z Worda – Pełny przewodnik C# +url: /pl/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Tworzenie markdown z Word – Kompletny samouczek C# + +Kiedykolwiek potrzebowałeś **utworzyć markdown z Word**, ale nie wiedziałeś od czego zacząć? Nie jesteś sam; wielu programistów napotyka ten problem, gdy próbują przenieść zawartość z pliku .docx do generatora stron statycznych lub repozytorium dokumentacji. Dobra wiadomość? Dzięki Aspose.Words możesz **konwertować docx na markdown**, wyciągnąć każdy obrazek z oryginalnego pliku i precyzyjnie określić, gdzie te zasoby zostaną zapisane — wszystko przy użyciu prostego callbacku. + +W tym przewodniku przeprowadzimy Cię przez praktyczny przykład, który pokaże, jak wyodrębnić obrazy z Worda, jak używać callbacku do ich przechowywania i dlaczego takie podejście jest najpewniejsze w pipeline’ach automatyzacji. Po zakończeniu będziesz mieć gotowy do uruchomienia program w C#, który generuje czysty plik `.md` oraz folder z wyodrębnionymi obrazami. + +> **Wskazówka:** Jeśli już masz szablon Worda zawierający zrzuty ekranu, diagramy lub loga, ta metoda zachowa każdy element wizualny bez konieczności ręcznego kopiowania i wklejania. + +--- + +## Co będzie potrzebne + +- **.NET 6+** (lub .NET Framework 4.6+). Kod działa na każdym nowoczesnym środowisku uruchomieniowym. +- **Aspose.Words for .NET** (pakiet NuGet `Aspose.Words`). Darmowa wersja próbna wystarcza w większości scenariuszy. +- Dokument **Word** (`input.docx`) zawierający tekst i przynajmniej jeden obrazek. +- Podstawowa znajomość C# oraz Visual Studio (lub ulubionego IDE). + +Nie są wymagane dodatkowe biblioteki — wszystko, czego potrzebujesz, obsługuje Aspose.Words. + +--- + +## Krok 1: Utworzenie projektu i instalacja Aspose.Words + +Aby zachować porządek, rozpocznij nowy projekt konsolowy: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Dlaczego ten krok ma znaczenie:** Instalacja pakietu NuGet zapewnia najnowsze API, w tym klasę `MarkdownSaveOptions` wprowadzonej w wersji 22.9. Bez niej musiałbyś pisać własny konwerter. + +--- + +## Krok 2: Załadowanie źródłowego dokumentu Word + +Pierwsza linia kodu otwiera plik `.docx`, który chcesz przekształcić. Zamień `YOUR_DIRECTORY` na rzeczywistą ścieżkę na swoim komputerze. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Co się dzieje?** `Document` parsuje plik, buduje wewnętrzny DOM i udostępnia każdy akapit, tabelę oraz obrazek. Jeśli plik nie istnieje, Aspose rzuca czytelny `FileNotFoundException`, który możesz przechwycić, aby zapewnić bardziej przyjazny interfejs użytkownika. + +--- + +## Krok 3: Konfiguracja opcji zapisu Markdown z callbackiem zapisywania zasobów + +Tutaj wchodzi w grę magia **how to use callback**. Callback pozwala zdecydować, gdzie zostanie zapisany każdy wyodrębniony obrazek. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Dlaczego callback?** Domyślnie Aspose osadza obrazy jako ciągi base‑64 w markdown — koszmar dla kontroli wersji. Callback daje pełną kontrolę nad nazwami plików i strukturą folderów. + +--- + +## Krok 4: Zapis dokumentu jako Markdown + +Teraz faktycznie generujemy plik `.md`. Wszystkie obrazy zostaną przekazane do callbacku zdefiniowanego w następnym kroku. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Jeśli wszystko pójdzie dobrze, znajdziesz `Document.md` w docelowym folderze oraz podfolder `Resources` zawierający każdy obrazek wyodrębniony z oryginalnego pliku Word. + +--- + +## Krok 5: Implementacja callbacku, który zapisuje każdy wyodrębniony obrazek + +Poniżej pełna implementacja klasy `MyResourceSaver`. Tworzy ona katalog `Resources` (jeśli nie istnieje), generuje unikalną nazwę pliku dla każdego obrazu i zapisuje strumień obrazu na dysku. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Wyjaśnienie argumentów:** +> - `args.Index` – licznik zerowy, który zapewnia unikalność. +> - `args.FileName` – oryginalna nazwa pliku sugerowana przez Aspose (często coś w stylu `image001.png`). +> - `args.Stream` – strumień wyjściowy, do którego zapisywane są bajty obrazu. +> - `args.KeepResourceStreamOpen` – ustawione na `false`, aby Aspose automatycznie zwolniło strumień, zapobiegając wyciekom uchwytów plików. + +--- + +## Pełny działający przykład + +Łącząc wszystko w jedną całość, oto pojedynczy plik, który możesz skopiować do `Program.cs`. Pamiętaj, aby zamienić `YOUR_DIRECTORY` na ścieżkę absolutną lub względną pasującą do Twojego środowiska. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Oczekiwany wynik + +- `YOUR_DIRECTORY/Document.md` – plik markdown ze standardowymi linkami do obrazów, np.: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – zawiera `img_0.png`, `img_1.jpg` itd., w takiej samej kolejności, w jakiej pojawiały się w oryginalnym dokumencie Word. + +Uruchomienie programu wypisuje przyjazne potwierdzenie, informując, że proces zakończył się sukcesem. + +--- + +## Najczęściej zadawane pytania (FAQ) + +### Jak wyodrębnić obrazy z Worda bez utraty jakości? + +Callback zapisuje surowy strumień binarny bezpośrednio do pliku, zachowując oryginalną rozdzielczość. Nie odbywa się żadna konwersja ani kompresja, chyba że samodzielnie dodasz logikę przetwarzania obrazu wewnątrz `ResourceSaving`. + +### Czy mogę zmienić format obrazu (np. PNG → JPEG) podczas wyodrębniania? + +Oczywiście. Wewnątrz `ResourceSaving` możesz sprawdzić `args.FileName` lub `args.Stream`, wczytać obraz przy pomocy `System.Drawing` lub `ImageSharp`, a następnie ponownie zakodować go przed zapisem. Pamiętaj tylko, aby odpowiednio zaktualizować rozszerzenie w linku markdown. + +### Co zrobić, gdy chcę, aby pliki markdown odwoływały się do CDN zamiast lokalnego folderu? + +Zmodyfikuj callback, aby przedrostek URL został dodany do linku markdown. Możesz to osiągnąć, ustawiając `args.FileName` na pełny adres URL po przesłaniu obrazu do CDN. + +### Czy to działa z tabelami, przypisami dolnymi lub innymi zaawansowanymi funkcjami Worda? + +Tak. Aspose.Words tłumaczy większość konstrukcji Worda na odpowiedniki markdown. Tabele stają się tabelami markdown, przypisy dolne zamieniane są na odnośniki, a zagnieżdżone listy są obsługiwane bez problemu. Jeśli coś wygląda nieprawidłowo, sprawdź najnowsze notatki wydania — Aspose nieustannie poprawia jakość konwersji. + +### Jak konwertować docx na markdown w pipeline CI/CD? + +Po prostu dodaj skompilowany `.exe` do kroków budowania, wskaż na wygenerowane artefakty `.docx` i wypchnij powstałe `.md` oraz folder `Resources/` do repozytorium statycznej strony. Ponieważ proces jest w pełni deterministyczny, doskonale sprawdza się w środowiskach automatyzowanych. + +--- + +## Podsumowanie + +Pokazaliśmy, jak **utworzyć markdown z Word** przy użyciu Aspose.Words, omówiliśmy cały **workflow konwersji docx do markdown** oraz przedstawiliśmy praktyczną metodę **wyodrębniania obrazów z Word** za pomocą własnej implementacji **how to use callback**. Efektem jest czysty plik markdown wraz z folderem oryginalnych obrazów — idealny dla witryn dokumentacyjnych, statycznych blogów czy wszelkich procesów preferujących formaty tekstowe. + +Kolejne kroki, które możesz rozważyć: + +- **Przetwarzanie wsadowe** wielu plików `.docx` w folderze (pętla `Directory.GetFiles`). +- **Niestandardowe schematy nazewnictwa** obrazów (np. wykorzystujące oryginalny tekst podpisu). +- **Post‑processing** markdowna w celu zamiany linków do obrazów na URL‑e CDN. +- Eksploracja **innych formatów eksportu Aspose**, takich jak HTML, PDF czy EPUB, dla publikacji wielokanałowej. + +Masz więcej pytań lub trudny plik Word, który odmawia konwersji? zostaw komentarz poniżej, a wspólnie znajdziemy rozwiązanie. Miłego kodowania i ciesz się prostotą przekształcania Worda w markdown! + +--- + +![Diagram przedstawiający konwersję z Word do Markdown](image.png "Diagram tworzenia markdown z Word") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/polish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/polish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..ef0b456e76 --- /dev/null +++ b/words/polish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Jak wyeksportować LaTeX z DOCX przy użyciu Aspose.Words. Dowiedz się, + jak konwertować DOCX na Markdown, ustawiać DPI i włączać odzyskiwanie w C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: pl +og_description: Jak wyeksportować LaTeX z DOCX przy użyciu Aspose.Words. Ten samouczek + pokazuje konwersję krok po kroku do Markdown, kontrolę DPI oraz tryb odzyskiwania. +og_title: Jak wyeksportować LaTeX z DOCX – konwertuj na Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Jak wyeksportować LaTeX z DOCX – konwersja na Markdown +url: /pl/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak wyeksportować LaTeX z DOCX – konwersja do Markdown + +Zastanawiałeś się kiedyś **jak wyeksportować LaTeX** z pliku DOCX bez utraty piękna równań? Nie jesteś sam. Z mojego doświadczenia największym problemem jest przeniesienie obiektów OfficeMath do czystego, przenośnego formatu dla generatorów stron statycznych lub blogów naukowych. + +W tym przewodniku przeprowadzimy konwersję DOCX do Markdown przy użyciu Aspose.Words, jednocześnie pokazując **jak ustawić DPI**, **jak włączyć odzyskiwanie** oraz kilka przydatnych sztuczek dla solidnego potoku. Po zakończeniu będziesz mieć pojedynczy program w C#, który generuje plik Markdown z równaniami LaTeX, obrazami wysokiej rozdzielczości i prawidłową obsługą hiperłączy. + +## Czego będziesz potrzebować + +- **.NET 6+** (lub .NET Framework 4.7.2 – API działa tak samo) +- **Aspose.Words for .NET** (najnowsza stabilna wersja na marzec 2026) +- Plik DOCX zawierający równania, obrazy i linki +- Visual Studio, VS Code lub dowolny edytor, który preferujesz + +Nie są wymagane dodatkowe pakiety NuGet poza Aspose.Words, ale upewnij się, że masz ważną licencję, jeśli nie korzystasz z wersji próbnej. + +## Krok 1 – Wczytaj DOCX w trybie ścisłego odzyskiwania + +Zanim pomyślimy o eksporcie, musimy upewnić się, że dokument źródłowy nie ukrywa uszkodzeń. Właśnie tutaj wkracza **jak włączyć odzyskiwanie**. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Dlaczego ścisłe odzyskiwanie?** +Jeśli pozwolisz Aspose cicho naprawiać problemy, możesz skończyć z brakującymi akapitami lub zepsutymi obrazami — czego nikt nie chce przy eksporcie LaTeX. Dzięki szybkiemu zgłoszeniu błędu możesz wykryć problem wcześnie i zdecydować, czy naprawić źródłowy DOCX, czy zalogować problem na później. + +### Wskazówka pro +Opakuj wczytywanie w blok try/catch i loguj `DocumentLoadingException`. Dzięki temu Twój pipeline CI może oznaczyć problematyczne pliki bez zatrzymywania całej kompilacji. + +## Krok 2 – Przygotuj opcje eksportu do Markdown + +Teraz, gdy dokument jest bezpiecznie w pamięci, konfigurujemy sposób jego zapisu. To serce **jak wyeksportować latex** i jednocześnie obejmuje **jak ustawić DPI** dla osadzonych obrazów. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Co robi każda opcja** + +| Opcja | Powód | Związek z słowami kluczowymi | +|--------|--------|-----------------------| +| `OfficeMathExportMode = LaTeX` | Bezpośrednio odpowiada na **jak wyeksportować latex** z równań. | Główne słowo kluczowe | +| `ImageResolution = 300` | Kontroluje jakość obrazu – odpowiedź na **jak ustawić dpi**. | Drugorzędne | +| `ResourceSavingCallback` | Zapisuje osadzone pliki na dysk, powszechna potrzeba przy **konwersji docx do markdown**. | Drugorzędne | +| `EmptyParagraphExportMode` | Gwarantuje czysty wynik Markdown, zapobiegając niechcianym tagom HTML. | Poprawia ogólną jakość konwersji | +| `LinkExportMode = AsReference` | Ułatwia czytanie i edycję linków, kolejny plus przy **konwersji docx do markdown**. | + +## Krok 3 – Zaimplementuj własny zapis zasobów (Opcjonalnie, ale przydatne) + +Podczas konwersji DOCX do Markdown obrazy i inne zasoby binarne potrzebują miejsca w systemie plików. Aspose pozwala kontrolować to za pomocą `IResourceSavingCallback`. Powyższy fragment już pokazuje minimalną implementację, ale rozłóżmy ją na części: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Dlaczego warto?** +Jeśli pominiesz ten krok, Aspose osadzi obrazy jako ciągi base‑64, co zwiększa rozmiar pliku Markdown i utrudnia kontrolę wersji. Zapisując zasoby w osobnym folderze, utrzymujesz Markdown lekki i przyjazny dla generatorów stron statycznych takich jak Hugo czy Jekyll. + +## Krok 4 – Zapisz dokument jako Markdown + +Całe ciężkie przetwarzanie jest już zrobione. Jedna linijka zapisuje finalny plik. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Otwórz `output.md` i zobaczysz: + +- Równania wyświetlane jako bloki LaTeX `$…$` +- Obrazy odwoływane jako `![Alt text](resources/image001.png)` z rozdzielczością 300 dpi +- Hiperłącza przekształcone w styl referencyjny: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +To cały proces **jak konwertować docx** w pigułce. + +## Często zadawane pytania i przypadki brzegowe + +### 1️⃣ Co zrobić, gdy DOCX zawiera nieobsługiwane obiekty? +Aspose.Words zgłosi `FeatureNotSupportedException`. Ponieważ użyliśmy **jak włączyć odzyskiwanie** w trybie ścisłym, wyjątek pojawi się od razu. Możesz: + +- Przełączyć `RecoveryMode` na `RecoveryMode.Default` dla konwersji typu best‑effort, **lub** +- Wstępnie przetworzyć DOCX (np. usunąć nieobsługiwany SmartArt) przed uruchomieniem konwertera. + +### 2️⃣ Czy mogę zmienić DPI dla poszczególnych obrazów? +Ustawienie `ImageResolution` jest globalne. Aby sterować DPI per obraz, zaimplementuj własny `ImageSavingCallback` podobny do `MyResourceSaver` i dostosuj `args.ImageResolution` w zależności od `args.ImageFileName` lub metadanych. + +### 3️⃣ Jak wstawić wygenerowany LaTeX w witrynę Jekyll? +Wbudowane wsparcie MathJax w Jekyll działa od razu. Upewnij się, że Twój layout zawiera skrypt MathJax, a bloki LaTeX są otoczone `$$` dla równań wyświetlanych lub `$` dla wierszowych. + +### 4️⃣ Czy to działa z .NET Core na Linuksie? +Zdecydowanie tak. Aspose.Words jest wieloplatformowy. Tylko pamiętaj, aby ścieżka `YOUR_DIRECTORY` używała konwencji linuksowych (np. `/home/user/docs`). + +## Pełny działający przykład + +Poniżej znajduje się gotowy do skopiowania program. Zamień `YOUR_DIRECTORY` na rzeczywistą ścieżkę w swoim systemie. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Oczekiwany wynik** – otwórz `output.md` i powinieneś zobaczyć coś podobnego: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Jeśli otworzysz plik w podglądzie Markdown obsługującym MathJax, całka zostanie wyrenderowana + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/polish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/polish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..f9ced4513c --- /dev/null +++ b/words/polish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-03-27 +description: Jak wyeksportować LaTeX z dokumentów Word przy użyciu Aspose.Words – + konwertuj DOCX na Markdown z równaniami w formacie LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: pl +og_description: Jak wyeksportować LaTeX z dokumentów Word, wyjaśniono w pierwszym + zdaniu, pokazując, jak przekonwertować plik DOCX na Markdown z równaniami w formacie + LaTeX. +og_title: Jak wyeksportować LaTeX z Worda – kompletny przewodnik +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Jak wyeksportować LaTeX z Worda – konwertuj DOCX na Markdown +url: /pl/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak wyeksportować LaTeX z Worda – Konwertuj DOCX na Markdown + +Zastanawiałeś się kiedyś **jak wyeksportować LaTeX** z pliku Word bez uzyskania szeregu PNG‑ów? Nie jesteś sam; programiści często napotykają ten problem, gdy potrzebują czystych, edytowalnych równań dla statycznych stron lub blogów naukowych. Dobra wiadomość? Dzięki Aspose.Words możesz **konwertować Word na Markdown** i zachować każdy obiekt OfficeMath jako natywny LaTeX — bez konieczności dodatkowego przetwarzania. + +W tym samouczku przeprowadzimy Cię przez cały proces **zapisywania dokumentu Word jako Markdown** przy **eksportowaniu równań jako LaTeX**. Na koniec otrzymasz działający fragment C#, klarowne wyjaśnienie każdej opcji oraz wskazówki, jak radzić sobie z trudnymi przypadkami, takimi jak złożone formuły czy mieszana zawartość. Bez zewnętrznych narzędzi, tylko jeden pakiet NuGet i kilka linii kodu. + +## Co będzie potrzebne + +- .NET 6+ (lub .NET Framework 4.7.2 i wyższy) – najnowszy runtime działa najlepiej. +- Visual Studio 2022 lub dowolny edytor, który potrafi kompilować projekty C#. +- Licencja Aspose.Words for .NET (bezpłatna wersja próbna wystarczy do eksperymentów). +- Plik DOCX zawierający przynajmniej jedno równanie (OfficeMath). + +Jeśli już to masz, świetnie — zanurzmy się. + +## Jak wyeksportować LaTeX z Worda – przegląd + +Poniżej przedstawiono wysokopoziomowy widok kolejnych kroków: + +1. **Zainstaluj** pakiet NuGet Aspose.Words. +2. **Wczytaj** źródłowy plik `.docx` zawierający równania. +3. **Skonfiguruj** `MarkdownSaveOptions`, aby `OfficeMathExportMode` było ustawione na `LaTeX`. +4. **Zapisz** dokument jako plik `.md`. +5. **Zweryfikuj**, że wygenerowany Markdown zawiera bloki LaTeX (`$$…$$`). + +Każdy z tych kroków jest szczegółowo opisany w kolejnych sekcjach. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="Diagram pokazujący przepływ z DOCX do Markdown z równaniami LaTeX"} + +## Krok 1 – Zainstaluj Aspose.Words dla .NET (convert word to markdown) + +Na początek potrzebujesz biblioteki, która wykona ciężką pracę. Otwórz terminal (lub Package Manager Console) i uruchom: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** Jeśli używasz Visual Studio, kliknij prawym przyciskiem projektu → *Manage NuGet Packages* → wyszukaj „Aspose.Words” i zainstaluj najnowszą stabilną wersję. + +Dlaczego to ważne: Aspose.Words abstrahuje format Open XML, dając czyste API do manipulacji dokumentami Word bez konieczności ręcznego obchodzenia się z niskopoziomowym XML. Biblioteka zawiera wbudowane wsparcie dla konwersji OfficeMath do LaTeX, co jest sednem naszego **export equations as LaTeX**. + +## Krok 2 – Wczytaj DOCX (how to convert docx) + +Teraz, gdy pakiet jest już dostępny, wczytaj plik, który chcesz przekształcić. Zamień `YOUR_DIRECTORY` na ścieżkę, w której znajduje się Twój plik `.docx`: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Dlaczego wczytywać w ten sposób?** Konstruktor `Document` parsuje cały plik do modelu obiektowego, dając natychmiastowy dostęp do akapitów, tabel i — co najważniejsze — obiektów OfficeMath. Jeśli plik jest nieobecny lub uszkodzony, Aspose rzuca opisowy `FileNotFoundException`, który możesz przechwycić, aby obsłużyć błąd w elegancki sposób. + +## Krok 3 – Skonfiguruj MarkdownSaveOptions (export equations as latex) + +Magia dzieje się w obiekcie `MarkdownSaveOptions`. Domyślnie Aspose renderowałby równania jako obrazy PNG, ale my chcemy LaTeX. Ustaw `OfficeMathExportMode` na `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Krótka uwaga o opcjonalnych flagach: `ExportImagesAsBase64` mówi Aspose, aby nie osadzał danych binarnych, co utrzymuje Markdown w czystości. `ExportHeadersFooters` zapewnia, że nie utracisz żadnego kontekstu znajdującego się w nagłówkach lub stopkach — przydatne, gdy w nagłówku znajduje się tytuł lub nazwisko autora. + +## Krok 4 – Zapisz dokument (save word as markdown) + +Na koniec zapisz przekształconą zawartość do pliku `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Po wykonaniu tej linii znajdziesz `output.md` obok pliku źródłowego. Otwórz go w dowolnym edytorze tekstu, a zobaczysz bloki LaTeX wyglądające tak: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +To już **save word as markdown** — bez dodatkowych kroków konwersji. + +## Krok 5 – Zweryfikuj wynik (export equations as latex) + +Łatwo pominąć weryfikację, a szybka kontrola może zaoszczędzić godziny później. Uruchom prosty skrypt, który odczyta wygenerowany plik i wypisze pierwszy blok LaTeX: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Jeśli zobaczysz `First LaTeX block: $$ … $$` w konsoli, udało Ci się **export LaTeX** z Worda. Jeśli nie, sprawdź, czy dokument źródłowy naprawdę zawiera obiekty OfficeMath; zwykłe tekstowe równania nie zostaną skonwertowane. + +## Radzenie sobie z typowymi przypadkami brzegowymi + +| Scenariusz | Na co zwrócić uwagę | Zalecane rozwiązanie | +|------------|---------------------|----------------------| +| **Mieszane obrazy i równania** | Aspose może nadal osadzać obrazy dla grafiki nie‑OfficeMath. | Ustaw `ExportImagesAsBase64 = false` i pozostaw obrazy jako pliki zewnętrzne, a następnie odwołuj się do nich ręcznie w Markdown. | +| **Złożone, zagnieżdżone równania** | Głęboko zagnieżdżone struktury mogą generować LaTeX wymagający ręcznej korekty. | Przetwórz blok przy pomocy formatatora LaTeX (np. `latexindent`) lub ustaw `mdOptions → ExportMathAsDisplay = true`. | +| **Duże dokumenty** | Zużycie pamięci rośnie przy ładowaniu ogromnych plików `.docx`. | Użyj `LoadOptions` z `LoadFormat.Docx` i włącz strumieniowe ładowanie, jeśli jest dostępne. | +| **Brak licencji** | Bezpłatna wersja próbna dodaje komentarz‑znak wodny do wyniku. | Zastosuj ważną licencję: `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Te wskazówki utrzymują Twój przepływ pracy stabilnym, szczególnie gdy **convert word to markdown** w środowiskach produkcyjnych. + +## Pełny przykład działający (Wszystkie kroki w jednym pliku) + +Poniżej znajduje się samodzielna aplikacja konsolowa, którą możesz skopiować do nowego projektu .NET i od razu uruchomić. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Uruchom program, otwórz `output.md` i zobaczysz równania wyświetlone jako czysty LaTeX. To kompletną odpowiedź na pytanie **jak wyeksportować latex** z dokumentu Word. + +## Zakończenie + +Omówiliśmy **jak wyeksportować LaTeX** z Worda krok po kroku, pokazując, jak **konwertować Word na markdown**, **zapisować word jako markdown** i **eksportować równania jako LaTeX** przy użyciu Aspose.Words. Główna idea jest prosta: wczytaj DOCX, dostosuj `MarkdownSaveOptions` i pozwól bibliotece wykonać ciężką pracę. + +Jeśli chcesz zautomatyzować pipeline dokumentacji, spróbuj połączyć ten kod ze statycznym generatorami stron, takimi jak Hugo lub Jekyll — po prostu wrzuć wygenerowane pliki `.md` do repozytorium i niech strona się przebuduje. Po dalsze lektury: przewodnik Aspose „Export to LaTeX”, eksperymenty z `HtmlSaveOptions` dla podglądów webowych lub zagłębienie się w API `DocumentVisitor` dla własnych transformacji. + +Masz pytania o przypadki brzegowe, licencjonowanie lub integrację w CI/CD? Zostaw komentarz poniżej i powodzenia w kodowaniu! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/polish/net/programming-with-pdfsaveoptions/_index.md b/words/polish/net/programming-with-pdfsaveoptions/_index.md index 81c85b6691..9069f07abd 100644 --- a/words/polish/net/programming-with-pdfsaveoptions/_index.md +++ b/words/polish/net/programming-with-pdfsaveoptions/_index.md @@ -35,7 +35,7 @@ Niezależnie od tego, czy chcesz przekonwertować dokumenty Word do PDF w celu d | [URI ucieczki w dokumencie PDF](./escape-uri/) Dowiedz się, jak uciec URI w plikach PDF za pomocą Aspose.Words dla .NET. Ten szczegółowy przewodnik przeprowadzi Cię przez ten proces krok po kroku. | | [Eksportuj nagłówek, stopkę i zakładki dokumentu Word do dokumentu PDF](./export-header-footer-bookmarks/) | Dowiedz się, jak eksportować zakładki nagłówka i stopki z dokumentu Word do pliku PDF za pomocą Aspose.Words dla .NET, korzystając z naszego przewodnika krok po kroku. | | [Zmniejsz rozmiar pliku PDF za pomocą funkcji Skaluj czcionki WMF do rozmiaru metapliku](./scale-wmf-fonts-to-metafile-size/) | Przewodnik krok po kroku, jak zmniejszyć rozmiar pliku PDF, skalując czcionki WMF do rozmiaru metapliku podczas konwersji do pliku PDF za pomocą Aspose.Words dla platformy .NET. | -| [Popraw pozycjonowanie tekstu PDF dzięki dodatkowemu pozycjonowaniu tekstu](./additional-text-positioning/) | Dowiedz się, jak poprawić pozycjonowanie tekstu PDF za pomocą Aspose.Words dla .NET w kilku prostych krokach. Popraw wygląd swojego dokumentu. | +| [Popraw pozycjonowanie tekstu PDF dzięki dodatkowi pozycjonowaniu tekstu](./additional-text-positioning/) | Dowiedz się, jak poprawić pozycjonowanie tekstu PDF za pomocą Aspose.Words dla .NET w kilku prostych krokach. Popraw wygląd swojego dokumentu. | | [Konwertuj dokument Word do PDF 1.7](./conversion-to-pdf-17/) | Bezproblemowa konwersja dokumentów Word do PDF 1.7 przy użyciu Aspose.Words dla .NET. Postępuj zgodnie z tym przewodnikiem, aby mieć pewność, że Twoje dokumenty są powszechnie dostępne i profesjonalnie sformatowane. | | [Zmniejsz rozmiar dokumentu PDF dzięki próbkowaniu obrazów w dół](./downsampling-images/) | Zmniejsz rozmiar dokumentu PDF, zmniejszając próbkowanie obrazów za pomocą Aspose.Words dla .NET. Zoptymalizuj pliki PDF, aby przyspieszyć czas przesyłania i pobierania. | | [Ustawianie opcji konspektu w dokumencie PDF](./set-outline-options/) | Dowiedz się, jak ustawić opcje konspektu w dokumencie PDF za pomocą Aspose.Words for .NET. Ulepsz nawigację w pliku PDF, konfigurując poziomy nagłówków i rozszerzone konspekty. | @@ -45,7 +45,7 @@ Niezależnie od tego, czy chcesz przekonwertować dokumenty Word do PDF w celu d | [Aktualizuj ostatnio wydrukowaną właściwość w dokumencie PDF](./update-last-printed-property/) | Dowiedz się, jak zaktualizować ostatnią wydrukowaną właściwość w dokumencie PDF za pomocą Aspose.Words dla platformy .NET, korzystając z naszego przewodnika krok po kroku. | | [Renderuj efekty 3D DML 3DEffects w dokumencie PDF](./dml-3deffects-rendering/) | Dowiedz się, jak renderować niesamowite efekty 3D DML w dokumentach PDF za pomocą Aspose.Words dla .NET dzięki temu kompleksowemu przewodnikowi krok po kroku. | | [Interpolacja obrazów w dokumencie PDF](./interpolate-images/) | Dowiedz się, jak interpolować obrazy w dokumencie PDF za pomocą Aspose.Words dla .NET dzięki naszemu przewodnikowi krok po kroku. Łatwo popraw jakość obrazu w swoim pliku PDF. | - +| [Jak zapisać PDF z DOCX przy użyciu Aspose.Words – przewodnik krok po kroku](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Dowiedz się, jak konwertować pliki DOCX do PDF przy użyciu Aspose.Words, krok po kroku. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/polish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/polish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..72ac1b98a1 --- /dev/null +++ b/words/polish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,198 @@ +--- +category: general +date: 2026-03-27 +description: Dowiedz się, jak zapisać PDF z pliku DOCX przy użyciu Aspose.Words. Zawiera + konwersję docx do pdf, zapisywanie pdf z opcjami oraz obsługę pływających kształtów. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: pl +og_description: Jak zapisać PDF z pliku DOCX przy użyciu Aspose.Words. Ten przewodnik + pokazuje, jak konwertować docx na pdf, zapisywać pdf z opcjami oraz obsługiwać unoszące + się kształty. +og_title: Jak zapisać PDF z DOCX – Kompletny poradnik Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Jak zapisać PDF z DOCX przy użyciu Aspose.Words – Przewodnik krok po kroku +url: /pl/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak zapisać PDF z DOCX przy użyciu Aspose.Words – Kompletny poradnik + +Zastanawiałeś się kiedyś **jak zapisać PDF** z dokumentu Word bez utraty układu pływających kształtów? Nie jesteś jedyny. W wielu projektach — generatorach faktur, eksporterach raportów czy prostych archiwizatorach dokumentów — programiści potrzebują niezawodnego sposobu konwersji DOCX do PDF, zachowując dokładnie taki sam wygląd jak w Wordzie. + +W tym poradniku przeprowadzimy Cię krok po kroku przez konwersję pliku DOCX do PDF **przy użyciu Aspose.Words for .NET**, pokażemy **jak konwertować docx do pdf** z własnymi opcjami zapisu oraz wyjaśnimy, dlaczego flaga `ExportFloatingShapesAsInlineTag` ma znaczenie. Po zakończeniu będziesz mieć gotowy do uruchomienia fragment kodu, który zapisuje PDF z kontrolowanymi opcjami. + +## Co się nauczysz + +- Dokładne kroki **konwersji dokumentu word do pdf** przy użyciu Aspose.Words. +- Jak skonfigurować `PdfSaveOptions`, aby traktować pływające kształty jako tagi inline. +- Typowe pułapki przy pracy z obiektami pływającymi i jak ich unikać. +- Pełny, uruchamialny program w C#, który możesz wkleić do dowolnego projektu .NET. + +> **Wymaganie wstępne:** Potrzebujesz licencji Aspose.Words for .NET (lub darmowej wersji ewaluacyjnej) oraz środowiska programistycznego .NET (Visual Studio, Rider lub `dotnet` CLI). + +## Krok 1: Przygotuj projekt i dodaj Aspose.Words + +Najpierw utwórz nową aplikację konsolową (lub dodaj do istniejącej) i odwołaj się do pakietu NuGet Aspose.Words. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Wskazówka:** Jeśli pracujesz na serwerze CI, przypnij wersję pakietu (`Aspose.Words --version 24.10`), aby zapewnić powtarzalne buildy. + +## Krok 2: Wczytaj plik DOCX zawierający pływające kształty + +Pływające obrazy, pola tekstowe lub SmartArt mogą powodować przesunięcia układu po konwersji. Wczytanie dokumentu jest proste, ale dodatkowo sprawdzimy, czy plik istnieje, aby zapobiec wyjątkowi `FileNotFoundException` w czasie wykonywania. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Zwróć uwagę na instrukcje `Console.WriteLine` — zapewniają szybki feedback podczas uruchamiania aplikacji w terminalu. + +## Krok 3: Skonfiguruj opcje zapisu PDF (Zapisz PDF z opcjami) + +Tutaj dzieje się magia. Domyślnie Aspose.Words stara się zachować pływające obiekty tak, jak wyglądają, co może zepsuć układ w powstałym PDF. Ustawienie `ExportFloatingShapesAsInlineTag` na `true` instruuje bibliotekę, aby traktowała te kształty jako tagi inline, zapewniając ich przywiązanie do otaczającego tekstu. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Dlaczego to ważne? Wyobraź sobie pole tekstowe unoszące się nad akapitem. Bez konwersji na tagi inline, PDF może przesunąć akapit w dół lub całkowicie przyciąć pole. Flaga utrzymuje relację wizualną — subtelny, ale kluczowy szczegół w profesjonalnych raportach. + +## Krok 4: Zapisz dokument jako PDF + +Teraz faktycznie zapisujemy plik PDF. Metoda `Save` przyjmuje zarówno ścieżkę wyjściową, jak i opcje, które właśnie ustawiliśmy. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Uruchomienie programu wygeneruje `output.pdf` w tym samym folderze co źródłowy DOCX. Otwórz go w dowolnym przeglądarce PDF i zobaczysz, że wszystkie pływające kształty są renderowane dokładnie tam, gdzie powinny. + +## Pełny działający przykład + +Poniżej znajduje się cały program w jednym bloku. Skopiuj‑wklej go do `Program.cs` (lub dowolnego pliku C#) i naciśnij **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Oczekiwany rezultat + +- **Utworzony plik:** `output.pdf` w docelowym katalogu. +- **Wierność układu:** Pływające kształty (obrazy, pola tekstowe, SmartArt) pojawiają się inline z otaczającym tekstem. +- **Brak wyjątków:** Program kończy się płynnie, wypisując komunikaty statusu w konsoli. + +## Najczęściej zadawane pytania i przypadki brzegowe + +| Question | Answer | +|----------|--------| +| **Co jeśli potrzebuję wyższej jakości obrazu?** | Ustaw `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Czy mogę konwertować wiele plików DOCX jednocześnie?** | Umieść logikę wczytywania/zapisu w pętli `foreach (var file in Directory.GetFiles(..., "*.docx"))`. Pamiętaj, aby ponownie używać jednej instancji `PdfSaveOptions` dla lepszej wydajności. | +| **Czy to działa z .NET Core?** | Zdecydowanie. Aspose.Words 24.x obsługuje .NET Standard 2.0+, więc możesz uruchomić ten sam kod na Windows, Linuxie lub macOS. | +| **A co z plikami DOCX chronionymi hasłem?** | Wczytaj przy użyciu `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. Te same `PdfSaveOptions` obowiązują przy zapisie. | +| **Czy konwersja na tagi inline jest bezpieczna dla skomplikowanych tabel?** | Generalnie tak, ale bardzo złożone układy tabel z nakładającymi się kształtami mogą wymagać ręcznej korekty. Przetestuj reprezentatywną próbkę przed masową migracją. | + +## Wskazówki dla projektów w rzeczywistym świecie + +- **Loguj, nie tylko `Console.WriteLine`** – W produkcji zamień wyjście konsoli na framework logowania (Serilog, NLog), aby rejestrować błędy. +- **Zwalniaj zasoby** – `Document` implementuje `IDisposable`. Umieść go w bloku `using`, jeśli przetwarzasz wiele plików, aby szybko zwolnić pamięć. +- **Waliduj PDF** – Użyj walidatora PDF (np. sprawdzacza zgodności PDF/A), jeśli potrzebujesz PDF‑ów archiwalnych. +- **Przetwarzanie równoległe** – Przy dużych obciążeniach rozważ `Parallel.ForEach` z wątkowo‑bezpiecznym `PdfSaveOptions` (klonuj na wątek), aby przyspieszyć konwersję. + +## Zakończenie + +Omówiliśmy **jak zapisać PDF** z pliku DOCX przy użyciu Aspose.Words, pokazaliśmy **jak konwertować docx do pdf** z własnymi opcjami i wyjaśniliśmy wpływ `ExportFloatingShapesAsInlineTag`. Pełny, uruchamialny przykład pokazuje, że możesz **konwertować dokument word do pdf** w zaledwie kilku linijkach, a teraz wiesz, jak **zapisać pdf z opcjami**, które odpowiadają wymaganiom jakości i zgodności Twojego projektu. + +Gotowy na kolejne wyzwanie? Spróbuj eksportować do innych formatów (np. HTML, EPUB) przy użyciu `document.Save("output.html")` lub poeksperymentuj ze zgodnością PDF/A dla długoterminowego archiwizowania. Te same zasady — wczytaj, skonfiguruj opcje, zapisz — mają zastosowanie wszędzie. + +Miłego kodowania i niech Twoje PDF‑y zawsze wyglądają dokładnie tak, jak tego oczekujesz! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/polish/net/programming-with-shapes/_index.md b/words/polish/net/programming-with-shapes/_index.md index 8502368e68..2cae54231e 100644 --- a/words/polish/net/programming-with-shapes/_index.md +++ b/words/polish/net/programming-with-shapes/_index.md @@ -34,7 +34,7 @@ Korzystając z Aspose.Words dla .NET i postępując zgodnie z tymi samouczkami, | [Wykryj kształt Smart Art](./detect-smart-art-shape/) | Dowiedz się, jak wykrywać kształty SmartArt w dokumentach Word za pomocą Aspose.Words dla .NET dzięki temu kompleksowemu przewodnikowi. Idealne do automatyzacji przepływu pracy nad dokumentami. | | [Aktualizuj rysunek Smart Art](./update-smart-art-drawing/) | Dowiedz się, jak aktualizować rysunki Smart Art w dokumentach Word za pomocą Aspose.Words dla .NET dzięki temu przewodnikowi krok po kroku. Upewnij się, że Twoje wizualizacje są zawsze dokładne. | | [Utwórz prostokątny kształt w Wordzie za pomocą Aspose.Words – przewodnik krok po kroku](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Dowiedz się, jak utworzyć prostokątny kształt w dokumencie Word przy użyciu Aspose.Words, korzystając z naszego szczegółowego przewodnika krok po kroku. | - +| [Utwórz dokument Word C# – Dodaj kształt z cieniem](./create-word-document-c-add-shape-with-shadow/) | Dowiedz się, jak dodać kształt z efektem cienia do dokumentu Word przy użyciu Aspose.Words w C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/polish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/polish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..53a690e418 --- /dev/null +++ b/words/polish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: Utwórz dokument Word w C# i dowiedz się, jak dodać kształt, zastosować + cień do kształtu oraz ustawić odległość cienia. Przewodnik krok po kroku dla Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: pl +og_description: Utwórz dokument Word w C# z prostokątnym kształtem i niestandardowym + cieniem. Skorzystaj z tego pełnego poradnika, aby ustawić odległość cienia i styl. +og_title: Utwórz dokument Word w C# – Dodaj kształt z cieniem +tags: +- Aspose.Words +- C# +- Document Automation +title: Utwórz dokument Word w C# – Dodaj kształt z cieniem +url: /pl/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Utwórz dokument Word C# – Dodaj kształt z cieniem + +Czy kiedykolwiek potrzebowałeś **create word document c#**, który zawiera ładnie wystylizowany prostokąt? Może tworzysz szablon raportu i chcesz subtelną cieniowaną krawędź, aby układ się wyróżniał. W tym samouczku przejdziemy krok po kroku przez to – jak dodać kształt, zastosować cień do kształtu i nawet dostroić odległość cienia przy użyciu Aspose.Words. + +Zaczniemy od pustego dokumentu, wstawimy prostokąt, nadamy mu presetowy cień i zakończymy zapisaniem pliku. Na końcu będziesz mieć gotowy .docx, który możesz otworzyć w Wordzie i od razu zobaczyć efekt. Bez zewnętrznych narzędzi, tylko czysty kod C#. + +## Wymagania wstępne + +- .NET 6 (lub dowolny nowszy .NET Framework) zainstalowany. +- Visual Studio 2022 lub VS Code z rozszerzeniem C#. +- Pakiet NuGet Aspose.Words for .NET (`Aspose.Words` wersja 23.12 lub nowsza). + Możesz dodać go za pomocą Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +To wszystko – nie są potrzebne dodatkowe DLL‑y ani interfejs COM. + +## Krok 1: Zainicjalizuj nowy dokument i builder – *create word document c#* podstawy + +Najpierw potrzebujemy obiektu `Document`, który reprezentuje plik Word oraz `DocumentBuilder`, aby go edytować. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Why this step matters:** Klasa `Document` jest kontenerem dla wszystkich części Worda (strony, style, obrazy). Builder to wysokopoziomowe API, które ukrywa manipulację niskopoziomowymi węzłami, ułatwiając **create word document c#** bez konieczności bezpośredniej pracy z XML. + +## Krok 2: Wstaw kształt prostokąta – *how to create rectangle* + +Teraz umieścimy prostokąt na stronie. Rozmiar podawany jest w punktach (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro tip:** Jeśli potrzebujesz innego kształtu, po prostu zamień `ShapeType.Rectangle` na `ShapeType.Ellipse`, `ShapeType.Triangle` itd. Ten sam kod działa dla **how to add shape** dowolnego typu. + +## Krok 3: Zastosuj presetowy cień i dopasuj go – *apply shadow to shape* + +Aspose.Words dostarcza kilka presetowych formatów cieni. Użyjemy `Preset1`, a następnie dostosujemy odległość, rozmycie, przezroczystość i kolor. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Why customize the shadow?** Właściwość `Distance` określa, jak daleko cień znajduje się od prostokąta – można to porównać do „uniesienia”, które widzisz w renderingu 3‑D. Zmiana `BlurRadius` zmiękcza krawędzie, a `Transparency` pozwala uzyskać subtelny, profesjonalny wygląd. To spełnia wymaganie **set shadow distance** i pokazuje, jak **apply shadow to shape** w elastyczny sposób. + +## Krok 4: Zapisz dokument – *create word document c#* zakończenie + +Na koniec zapisz dokument na dysku. Dostosuj ścieżkę do folderu, w którym masz prawo zapisu. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Otwórz powstały plik w Microsoft Word i zobaczysz jasnoniebieski prostokąt z miękkim szarym cieniem odsuniętym o 5 pt. To wizualny dowód, że udało Ci się **create word document c#** z wystylizowanym kształtem. + +![Utwórz dokument Word C# z kształtem z cieniem](shadow-example.png){: .img alt="przykład create word document c# pokazujący prostokąt z cieniem"} + +## Opcjonalne warianty i przypadki brzegowe + +| Scenariusz | Co zmienić | Dlaczego to ważne | +|------------|------------|-------------------| +| **Inny styl cienia** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Daje bardziej dramatyczny wygląd bez dodatkowego kodu. | +| **Brak presetu – własny cień** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Pełna kontrola nad kierunkiem i głębokością. | +| **Wiele kształtów** | Call `builder.InsertShape` again before saving. | Przydatne w złożonych szablonach z ikonami, logo itp. | +| **Kompatybilność ze starszymi wersjami Aspose** | Use `ShadowEffect` class (available in v20.x). | Zapewnia, że Twój kod działa w starszych projektach. | +| **Zapisywanie jako PDF** | `document.Save("ShadowShape.pdf");` | Ten sam efekt cienia pojawia się w wyjściowym pliku PDF. | + +> **Częste pytanie:** *Co zrobić, gdy cień nie pojawia się w Wordzie?* +> Upewnij się, że używasz najnowszej wersji Aspose.Words (≥ 22.9). Starsze wydania miały ograniczone wsparcie dla cieni. Sprawdź także, czy dokument jest otwierany w aktualnej wersji Worda (2016+). + +## Pełny działający przykład + +Poniżej znajduje się kompletny, gotowy do skopiowania program. Zawiera wszystkie dyrektywy `using`, komentarze i obsługę błędów dla płynnego doświadczenia. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Uruchom program, przejdź do `C:\Temp\ShadowShape.docx` i zobaczysz prostokąt z dokładnie takim cieniem, jaki skonfigurowaliśmy. + +## Podsumowanie i kolejne kroki + +- Teraz wiesz, jak **create word document c#**, wstawić prostokąt i **apply shadow to shape** z niestandardowym **set shadow distance**. +- Przykład używa Aspose.Words, które ukrywa złożoność OpenXML i zapewnia spójne renderowanie we wszystkich wersjach Worda. +- Chcesz iść dalej? Spróbuj połączyć wiele kształtów, dodać tekst wewnątrz prostokąta lub wyeksportować ten sam dokument jako PDF, aby zobaczyć, jak cień się przenosi. + +### Powiązane tematy, które możesz zbadać + +- **How to add shape** do nagłówka/stopki w celu brandingu. +- Korzystanie z **Aspose.Words** do programowego wstawiania wykresów i tabel. +- Dostosowywanie **shadow effects** na obrazach zamiast wektorowych kształtów. +- Automatyzacja masowej generacji dokumentów dla faktur lub certyfikatów. + +Śmiało eksperymentuj, łam kod, a potem go odbudowuj – to najszybszy sposób na przyswojenie koncepcji. Jeśli napotkasz problem, zostaw komentarz poniżej lub sprawdź oficjalną dokumentację Aspose.Words, aby uzyskać głębsze informacje o API. + +Miłego kodowania i ciesz się bardziej dopracowanymi plikami Word! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/polish/net/programming-with-txtsaveoptions/_index.md b/words/polish/net/programming-with-txtsaveoptions/_index.md index 44581dd48c..60f5e754fe 100644 --- a/words/polish/net/programming-with-txtsaveoptions/_index.md +++ b/words/polish/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Dzięki tym samouczkom będziesz w stanie w pełni wykorzystać funkcjonalności | [Dodaj znaczniki Bidi w dokumencie Word](./add-bidi-marks/) | Dowiedz się, jak dodawać znaki dwukierunkowe (Bidi) w dokumentach Worda przy użyciu Aspose.Words dla .NET z tego przewodnika. Zapewnij właściwy kierunek tekstu dla treści wielojęzycznych. | | [Użyj znaku tabulacji na poziomie, aby uzyskać wcięcie listy](./use-tab-character-per-level-for-list-indentation/) | Dowiedz się, jak tworzyć listy wielopoziomowe z wcięciami tabulacyjnymi przy użyciu Aspose.Words dla .NET. Postępuj zgodnie z tym przewodnikiem, aby uzyskać precyzyjne formatowanie listy w dokumentach. | | [Użyj znaku spacji na każdym poziomie do wcięcia listy](./use-space-character-per-level-for-list-indentation/) | Dowiedz się, jak tworzyć listy wielopoziomowe z wcięciem znaku spacji w Aspose.Words dla .NET. Przewodnik krok po kroku dotyczący precyzyjnego formatowania dokumentu. | - +| [Zapisz docx jako txt – Kompletny przewodnik po eksportowaniu równań Word do LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Dowiedz się, jak zapisać plik docx jako txt i wyeksportować równania Word do formatu LaTeX przy użyciu Aspose.Words dla .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/polish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/polish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..3c13e82da7 --- /dev/null +++ b/words/polish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-03-27 +description: Zapisz plik docx jako txt przy użyciu Aspose.Words i konwertuj Word na + LaTeX. Dowiedz się, jak eksportować równania, zachować zwykły tekst i uzyskać znacznik + LaTeX w kilka minut. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: pl +og_description: Zapisz plik docx jako txt przy użyciu Aspose.Words. Ten przewodnik + pokazuje, jak konwertować Word do LaTeX, eksportować równania i zachować dokument + w formie zwykłego tekstu. +og_title: Zapisz docx jako txt – Eksportuj równania Word do LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Zapisz docx jako txt – Kompletny przewodnik po eksportowaniu równań Worda do + LaTeX +url: /pl/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Zapisz docx jako txt – Eksportuj równania Word do LaTeX + +Czy kiedykolwiek potrzebowałeś **zapisz docx jako txt**, ale obawiałeś się, że stracisz skomplikowaną matematykę znajdującą się w pliku Word? Nie jesteś sam. W wielu przepływach pracy naukowej wersja tekstowa dokumentu jest niezbędna, ale nadal chcesz, aby równania zachowały się jako czysty kod LaTeX. + +W tym samouczku przeprowadzimy Cię przez dokładne kroki, aby **convert Word to LaTeX** przy użyciu Aspose.Words for .NET, tak aby Twoje równania zostały poprawnie wyeksportowane, a reszta dokumentu stała się schludnym tekstem zwykłym. Po zakończeniu będziesz wiedział, jak **export equations to LaTeX**, zachować resztę pliku jako prosty tekst i uniknąć typowych pułapek, które potykają nowicjuszy. + +## Czego się nauczysz + +- Jak wczytać plik *.docx* zawierający Office Math. +- Ustawienie odpowiednich `TxtSaveOptions`, aby Aspose generował LaTeX dla każdego równania. +- Zapisanie wyniku jako plik **save word plain text**, który możesz wprowadzić do systemu kontroli wersji, potoków CI lub dowolnego narzędzia downstream. +- Typowe przypadki brzegowe — co zrobić, gdy dokument miesza obrazy i równania, lub gdy potrzebne jest zachowanie znaków Unicode. +- Pełny, gotowy do uruchomienia przykład kodu, który możesz wkleić do aplikacji konsolowej. + +### Wymagania wstępne + +- .NET 6.0 lub nowszy (kod działa również z .NET Framework 4.7+). +- Licencjonowana kopia **Aspose.Words for .NET** (darmowa wersja próbna działa do testów). +- Visual Studio 2022 lub dowolne IDE, które potrafi kompilować projekty C#. +- Dokument Word (`input.docx`) zawierający już pewne obiekty Office Math. + +> **Wskazówka:** Jeśli nie masz jeszcze licencji, możesz poprosić o tymczasowy klucz na stronie Aspose — po prostu zamień placeholder w kodzie na swój klucz przed uruchomieniem. + +## Krok 1 – Zainstaluj Aspose.Words przez NuGet + +First thing’s first: you need the library in your project. Open the **Package Manager Console** and run: + +```powershell +Install-Package Aspose.Words +``` + +That single line pulls in everything you need, including the `Saving` namespace where `TxtSaveOptions` lives. No extra DLLs, no native dependencies—just pure managed code. + +## Krok 2 – Wczytaj źródłowy dokument Word + +Now we actually read the file that holds the equations. The `Document` class abstracts the entire *.docx* structure, so you can treat it like a high‑level object model. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Why this matters:** Loading the document early lets you inspect its node tree. If you skip the check and the file has no equations, you’ll still get a clean txt file—but you won’t know why the LaTeX output is empty. + +## Krok 3 – Skonfiguruj TxtSaveOptions dla eksportu LaTeX + +Aspose gives you fine‑grained control over how Office Math is rendered. By setting `OfficeMathExportMode` to `LaTeX`, every equation is turned into its LaTeX equivalent instead of being stripped out or turned into an image. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Why this matters:** The default export mode would drop the equations entirely. Switching to `LaTeX` keeps the mathematical intent, which is exactly what you need when you later feed the file into a LaTeX compiler or a markdown processor that understands `$…$` syntax. + +## Krok 4 – Zapisz dokument jako zwykły tekst + +With the options configured, persisting the file is a one‑liner. The output will be a `.txt` file where every equation appears as LaTeX code surrounded by `$` delimiters (you can change that later if you prefer `\[` … `\]` blocks). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Oczekiwany wynik + +Open `output.txt` in any editor and you’ll see something like: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Notice how the regular text stays exactly as it was, while the equations are now pure LaTeX strings. You can copy‑paste these directly into a LaTeX document, a Jupyter notebook, or any tool that renders math. + +## Krok 5 – Obsługa przypadków brzegowych + +### Mieszana zawartość (obrazy + równania) + +If your Word file also contains images, Aspose will ignore them when you use `TxtSaveOptions`. That’s usually fine for a **save word plain text** workflow, but if you need the images as placeholders you can: + +1. Export the document to HTML first (`HtmlSaveOptions`) to capture images as `` tags. +2. Run a second pass with `TxtSaveOptions` to get the LaTeX equations. +3. Merge the two results manually or with a small script. + +### Symbole Unicode + +Some equations use special Unicode characters (e.g., Greek letters). Setting `Encoding = Encoding.UTF8` in `TxtSaveOptions` (as shown in Step 3) ensures those symbols survive the conversion. + +### Duże dokumenty + +For massive files (> 100 MB), consider streaming the save operation: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Streaming avoids loading the entire output into memory, which can be a lifesaver on low‑memory build agents. + +## Pełny działający przykład + +Below is the complete, copy‑paste‑ready program that ties everything together. Just replace the file paths and, if you have one, the license line. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Run the program (`dotnet run` if you’re using a console project) and check `output.txt`. You’ve just **saved docx as txt** while preserving every equation as LaTeX—no manual copy‑pasting required. + +## Najczęściej zadawane pytania + +**Q: Czy mogę zmienić delimiter z `$…$` na `\(...\)`?** +A: Tak. Po zapisaniu uruchom prostą zamianę w pliku: `output = output.Replace("$", @"\(").Replace("$", @"\)");` — tylko uważaj, aby nie zamienić znaków `$` występujących w oryginalnym tekście. + +**Q: Czy to działa z plikami Word 2007‑2019?** +A: Absolutnie. Aspose.Words obsługuje `.doc`, `.docx`, `.docm`, a nawet nowszą rodzinę `.dotx`. Ten sam kod działa we wszystkich wersjach. + +**Q: Co zrobić, jeśli muszę zachować oryginalne formatowanie akapitu (tabulatory, wielokrotne spacje)?** +A: Ustaw `txtSaveOptions.PreserveTableLayout = true;` oraz `txtSaveOptions.PreserveSpace = true;`, aby zachować białe znaki. + +## Zakończenie + +We’ve covered everything you need to **save docx as txt** while **exporting equations to LaTeX** using Aspose.Words. The key steps are loading the document, configuring `TxtSaveOptions` with `OfficeMathExportMode.LaTeX`, and saving the result. With these three lines of code you can reliably **convert word to latex**, keep your document as **save word plain text**, and avoid the dreaded loss of math symbols. + +Ready for the next challenge? Try chaining this workflow with a markdown generator to produce a full `.md` file that includes both text and LaTeX—perfect for Git‑backed documentation or static‑site generators. Or explore Aspose’s `PdfSaveOptions` to get a PDF version alongside the plain‑text file. + +If you hit any snags, drop a comment below. Happy coding, and enjoy the simplicity of turning Word equations into clean LaTeX! + +![Ilustracja zapisywania DOCX jako TXT z równaniami LaTeX](placeholder-image.png "przykład zapisu docx jako txt") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/polish/net/working-with-fonts/_index.md b/words/polish/net/working-with-fonts/_index.md index 5208aef90b..ae81693b28 100644 --- a/words/polish/net/working-with-fonts/_index.md +++ b/words/polish/net/working-with-fonts/_index.md @@ -48,7 +48,7 @@ Niezależnie od tego, czy chcesz formatować tekst za pomocą różnych czcionek | [Otrzymaj powiadomienie ostrzegawcze](./receive-warning-notification/) Dowiedz się, jak otrzymywać powiadomienia ostrzegawcze podczas korzystania z Aspose.Words dla platformy .NET i jak zarządzać wszelkimi problemami lub ostrzeżeniami w dokumentach. | | [Przykład źródła czcionki Steam](./resource-steam-font-source-example/) | Dowiedz się, jak używać źródła czcionek strumienia zasobów do ładowania niestandardowych czcionek do Aspose.Words dla platformy .NET. | | [Uzyskaj zamiennik bez sufiksów](./get-substitution-without-suffixes/) | W tym samouczku dowiesz się, jak uzyskać nadpisania bez sufiksów w dokumencie programu Word za pomocą Aspose.Words dla platformy .NET. | - +| [Podstawianie czcionek Aspose – Jak skonfigurować ustawienia czcionek w C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Dowiedz się, jak skonfigurować ustawienia czcionek w Aspose.Words dla .NET przy użyciu C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/polish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/polish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..9868250fdf --- /dev/null +++ b/words/polish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,237 @@ +--- +category: general +date: 2026-03-27 +description: 'Łatwa zamiana czcionek Aspose: dowiedz się, jak konfigurować ustawienia + czcionek, przechwytywać ostrzeżenia i obsługiwać brakujące czcionki w aplikacjach + .NET.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: pl +og_description: Opanuj zamianę czcionek w Aspose, konfigurować ustawienia czcionek + i obsługiwać brakujące czcionki za pomocą funkcji zwrotnej ostrzeżenia. Kompletny + przewodnik C#. +og_title: Zastępowanie czcionek Aspose – Konfiguracja ustawień czcionek w C# +tags: +- Aspose.Words +- C# +- Font Management +title: Zastępowanie czcionek Aspose – Jak skonfigurować ustawienia czcionek w C# +url: /pl/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Kompletny przewodnik po konfigurowaniu ustawień czcionek + +Czy kiedykolwiek natrafiłeś na dokument, który nagle zamienia twoją niestandardową czcionkę na coś ogólnego? To **aspose font substitution** wykonuje swoją pracę — zastępuje brakujące czcionki najbliższym dopasowaniem, które może znaleźć. To przydatne, ale jeśli musisz dokładnie wiedzieć, która czcionka została zamieniona, musisz skorzystać z systemu ostrzeżeń biblioteki i samodzielnie skonfigurować ustawienia czcionek. + +W tym samouczku przeprowadzimy Cię przez rzeczywisty scenariusz: wczytanie pliku DOCX, który odwołuje się do czcionki, której nie masz, przechwycenie zdarzenia zamiany oraz wypisanie przyjaznej wiadomości na konsolę. Po zakończeniu będziesz swobodnie korzystać z **configure font settings**, podłączania **Aspose.Words warning callback** i rozszerzania przykładu do dowolnego przepływu pracy. + +> **Co będzie potrzebne** +> • .NET 6+ (or .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • DOCX, który odwołuje się do brakującej czcionki (nazwijmy go `MissingFont.docx`) + +Zanurzmy się. + +--- + +## Krok 1: Zainstaluj Aspose.Words i przygotuj projekt + +Zanim napiszemy jakikolwiek kod, upewnij się, że pakiet Aspose.Words jest dodany jako odwołanie: + +```bash +dotnet add package Aspose.Words +``` + +> **Wskazówka:** Użyj najnowszej stabilnej wersji; od marca 2026 jest to 23.11.0. Nowsze wydania ulepszają algorytmy dopasowywania czcionek i dodają dodatkowe typy ostrzeżeń. + +Utwórz nową aplikację konsolową (lub wstaw kod do istniejącego projektu) i dodaj standardowe dyrektywy `using`: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Te przestrzenie nazw dają dostęp do `Document`, `LoadOptions` oraz klas związanych z czcionkami, których będziemy potrzebować. + +## Krok 2: Skonfiguruj ustawienia czcionek za pomocą LoadOptions + +Sednem kontroli **aspose font substitution** jest `LoadOptions.FontSettings`. Dostarczając pusty obiekt `FontSettings`, informujemy Aspose, aby używał domyślnych ścieżek wyszukiwania *i* zgłaszał każdą zamianę za pomocą callbacku ostrzeżeń. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Dlaczego nie polegać po prostu na ustawieniach domyślnych? Ponieważ podłączenie callbacku ostrzeżeń (następny krok) działa tylko wtedy, gdy właściwość `FontSettings` nie jest null. Ta mała linijka daje nam punkt zaczepienia do procesu zamiany, nie zmieniając rzeczywistego zachowania wyszukiwania czcionek. + +## Krok 3: Dołącz callback ostrzeżeń, aby przechwycić zamiany + +Aspose.Words implementuje interfejs `IWarningCallback`. Za każdym razem, gdy zdarzy się coś godnego uwagi — np. brakująca czcionka — wywołuje naszą metodę `Warning`. Zaimplementujemy mały obsługujący kod, który filtruje `WarningType.FontSubstitution` i wypisuje opis. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +A oto sam handler: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Dlaczego to ważne** — Bez callbacku Aspose cicho zamienia czcionki i nigdy nie wiesz, której użyto. Callback czyni proces przejrzystym, co jest niezbędne przy raportowaniu zgodności lub debugowaniu problemów z układem. + +## Krok 4: Wczytaj dokument używając skonfigurowanych opcji + +Teraz w końcu wczytujemy dokument, przekazując `loadOptions`, które właśnie przygotowaliśmy. Jeśli plik źródłowy odwołuje się do czcionki, której nie ma zainstalowanej, nasz handler zostanie wywołany. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Zastąp `YOUR_DIRECTORY` rzeczywistą ścieżką, w której znajduje się `MissingFont.docx`. Po uruchomieniu programu powinieneś zobaczyć wyjście podobne do: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Ten wiersz informuje dokładnie, której czcionki brakowało i jaką czcionkę zastępczą wybrało Aspose. + +## Krok 5: (Opcjonalnie) Dostosuj ścieżki wyszukiwania czcionek + +Jeśli masz prywatny folder z firmowymi czcionkami, możesz wskazać Aspose, gdzie szukać, zanim przejdzie do czcionek systemowych. To zaawansowane użycie **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Ustawienie `recursive: true` sprawia, że Aspose skanuje również podfoldery. Teraz biblioteka najpierw spróbuje użyć twoich prywatnych czcionek, zmniejszając ryzyko niepożądanej zamiany. + +## Pełny działający przykład + +Łącząc wszystko razem, oto kompletny, gotowy do uruchomienia program: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Oczekiwane wyjście** (gdy napotkano brakującą czcionkę): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Jeśli wszystkie czcionki są dostępne, program działa cicho (bez ostrzeżeń) i nadal generuje PDF. + +## Częste pytania i przypadki brzegowe + +### Co zrobić, jeśli muszę *całkowicie* zapobiec zamianie? + +Ustaw `FontSettings.SubstitutionSettings` na `null` lub użyj `FontSettings.FontSubstitutionSettings`, aby kontrolować zachowanie. Na przykład: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Teraz Aspose wyrzuci wyjątek zamiast cichej zamiany, który można przechwycić i obsłużyć. + +### Czy to działa z innymi formatami plików (np. .doc, .rtf)? + +Zdecydowanie. Ten sam obiekt `LoadOptions` może być przekazany do dowolnego konstruktora `Document`, który przyjmuje ścieżkę do pliku. Callback ostrzeżeń zostanie wywołany dla wszystkich formatów, które korzystają z czcionek. + +### Czy mogę przechwycić *dokładną* nazwę czcionki zastępczej? + +Tak. Ciąg `info.Description` zawiera zarówno brakującą czcionkę, jak i zamiennik. Jeśli potrzebujesz nazwy programowo, możesz ją sparsować lub użyć obiektu `FontInfo` (dostępnego w nowszych wersjach). + +### Jak to zachowuje się w środowisku wielowątkowym? + +`FontSettings` nie jest **bezpieczny** wątkowo. Utwórz osobny `LoadOptions` (z własnym `FontSettings`) dla każdego wątku lub zabezpiecz dostęp przy pomocy blokady. + +## Podsumowanie + +Omówiliśmy wszystko, co potrzebne, aby opanować **aspose font substitution** i **configure font settings** w aplikacji C#: + +1. Zainstaluj Aspose.Words i dodaj niezbędne dyrektywy `using`. +2. Utwórz obiekt `LoadOptions` z nowym `FontSettings`. +3. Dołącz własny `IWarningCallback`, aby wyświetlać zdarzenia zamiany. +4. Wczytaj dokument, pozwalając callbackowi zgłaszać brakujące czcionki. +5. (Opcjonalnie) Rozszerz ścieżkę wyszukiwania lub całkowicie wyłącz zamianę. + +Mając ten wzorzec, możesz logować brakujące czcionki w celu zapewnienia zgodności, powiadamiać użytkowników w interfejsie UI lub automatycznie osadzać czcionki zastępcze przed publikacją. Następnie możesz zbadać **Aspose.Words font substitution policies** lub zintegrować ten przepływ pracy z większym potokiem przetwarzania dokumentów. + +Miłego kodowania i niech Twoje dokumenty zawsze wyświetlają się z odpowiednią czcionką! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/portuguese/net/basic-conversions/_index.md b/words/portuguese/net/basic-conversions/_index.md index 52ea0a466d..777bd86316 100644 --- a/words/portuguese/net/basic-conversions/_index.md +++ b/words/portuguese/net/basic-conversions/_index.md @@ -33,6 +33,8 @@ Conversões Básicas orienta você nas conversões básicas de documentos usando | [Como Exportar LaTeX do Word – Guia Passo a Passo](./how-to-export-latex-from-word-step-by-step-guide/) | Aprenda a exportar conteúdo LaTeX de documentos Word usando Aspose.Words para .NET. Guia passo a passo com exemplos de código. | | [Converter Word para PDF em C# usando Aspose.Words – Guia](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Aprenda a converter documentos Word para PDF em C# usando Aspose.Words com este guia passo a passo. | | [Salvar Word como PDF com Aspose.Words – Guia Completo C#](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Aprenda a salvar documentos Word como PDF usando Aspose.Words em C#. Guia completo passo a passo. | +| [Converter Word para PDF com Aspose.Words – Guia Completo](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Aprenda a converter documentos Word para PDF usando Aspose.Words com este guia completo passo a passo. | + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/portuguese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/portuguese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..3ce8130e79 --- /dev/null +++ b/words/portuguese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Converta Word para PDF rapidamente usando Aspose.Words. Aprenda como + salvar Word como PDF, exportar DOCX para PDF e gerar PDF acessível em C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: pt +og_description: Converter Word para PDF em C# usando Aspose.Words. Este guia mostra + como salvar Word como PDF, exportar DOCX para PDF e gerar PDF acessível. +og_title: Converter Word para PDF com Aspose.Words – Passo a passo +tags: +- Aspose.Words +- C# +- PDF conversion +title: Converter Word para PDF com Aspose.Words – Guia Completo +url: /pt/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Converter Word para PDF com Aspose.Words – Guia Completo + +Já se perguntou como **converter Word para PDF** sem depender de ferramentas web de terceiros? Talvez você esteja construindo um motor de relatórios automatizado e precise de uma forma confiável de *salvar word como pdf* em tempo real. A boa notícia é que o Aspose.Words torna todo o processo muito simples, e você ainda pode gerar um arquivo compatível com **PDF/UA‑2** — perfeito para requisitos de acessibilidade. + +Neste tutorial vamos percorrer tudo o que você precisa: carregar um `.docx`, configurar as opções de PDF para que você possa *exportar docx para pdf* com conformidade PDF/UA, e finalmente salvar o resultado como um PDF acessível. Ao final, você terá um trecho de código autônomo, pronto para produção, que pode ser inserido em qualquer projeto .NET. + +![Converter Word para PDF usando Aspose.Words](convert-word-to-pdf.png) + +## O que Você Vai Aprender + +- **Por que o Aspose.Words** é uma escolha sólida para cenários de *gerar pdf acessível*. +- Os passos exatos para *salvar documento como pdf* com conformidade PDF/UA‑2. +- Como lidar com casos comuns, como fontes ausentes ou arquivos de origem protegidos por senha. +- Dicas rápidas para depurar a saída e verificar a conformidade de acessibilidade. + +### Pré‑requisitos + +- .NET 6 ou superior (a API também funciona no .NET Framework 4.6+). +- Uma licença válida do Aspose.Words for .NET (a versão de avaliação gratuita serve para testes). +- Conhecimento básico de C# — sem padrões avançados necessários. + +Se você já marcou esses itens, vamos começar. + +--- + +## Converter Word para PDF – Implementação Passo a Passo + +Dividiremos a solução em cinco etapas claras. Cada etapa tem um título, um pequeno trecho de código e uma explicação do *porquê* o código é importante. + +### Etapa 1: Carregar o Documento Word que Você Deseja Converter + +A primeira coisa que você precisa é um objeto `Document` que represente o arquivo de origem. O Aspose.Words lê **.docx**, **.doc**, **.rtf** e muitos outros formatos, então você pode *salvar word como pdf* independentemente de como o arquivo foi criado. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Por que isso importa:** +- Carregar o arquivo logo no início permite detectar erros de arquivo inexistente antes de desperdiçar ciclos de CPU. +- A classe `Document` abstrai a estrutura interna de um arquivo Word, oferecendo um modelo de objeto limpo para trabalhar. + +### Etapa 2: Configurar as Opções de Salvamento PDF para Acessibilidade + +Se você precisa *gerar pdf acessível*, deve instruir o Aspose.Words a produzir um documento compatível com PDF/UA‑2. A classe `PdfSaveOptions` oferece controle detalhado sobre a saída. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Por que isso importa:** +- `PdfCompliance.PdfUa2` indica à biblioteca que ela deve adicionar as tags, informações de estrutura e metadados necessários que leitores de tela utilizam. +- Incorporar fontes (`EmbedFullFonts = true`) evita os temidos avisos de “fonte não encontrada” quando o PDF é aberto em outro sistema operacional. +- Definir um `Title` ajuda as tecnologias assistivas a anunciar o documento corretamente. + +### Etapa 3: Salvar o Documento como PDF + +Agora que a origem está carregada e as opções configuradas, a conversão real é feita em uma única linha. É aqui que você *exporta docx para pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Por que isso importa:** +- O método `Save` respeita as `PdfSaveOptions` que configuramos, garantindo que os recursos de acessibilidade estejam incorporados. +- Envolver a chamada em um bloco `try/catch` permite registrar ou exibir erros de licença ou permissão que costumam surpreender iniciantes. + +### Etapa 4: Verificar a Conformidade PDF/UA (Opcional, mas Recomendado) + +Mesmo que o Aspose.Words faça o trabalho pesado, é uma boa prática validar a saída, especialmente quando você entrega documentos a órgãos governamentais ou outras entidades reguladas. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Por que isso importa:** +- `IsTagged` é uma verificação rápida; a validação completa de PDF/UA requer um validador dedicado, mas a maioria dos problemas de conformidade aparece como tags ausentes. +- Se o retorno for `false`, você pode revisar as `PdfSaveOptions` — talvez tenha esquecido de definir `Compliance` ou o documento de origem não possua estilos de título adequados. + +### Etapa 5: Armadilhas Comuns & Dicas Profissionais + +| Armadilha | O que Acontece | Como Corrigir | +|----------|----------------|---------------| +| **Fontes ausentes** | O texto aparece como caixas no PDF. | Defina `EmbedFullFonts = true` **ou** instale as fontes faltantes no servidor. | +| **Biblioteca sem licença** | Aspose adiciona marca d'água em todas as páginas. | Carregue seu arquivo de licença (`Aspose.Words.lic`) logo no início da aplicação (ex.: `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Fonte de origem protegida por senha** | `InvalidOperationException` ao usar `new Document(path)`. | Use a sobrecarga `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Documentos grandes causam OOM** | Exceção de falta de memória em arquivos volumosos. | Ative `MemoryOptimization` nas `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Tags de acessibilidade ausentes** | Falha na validação PDF/UA. | Garanta que o arquivo Word de origem use estilos de título corretos (`Heading 1`, `Heading 2`, etc.) — o Aspose mapeia esses estilos automaticamente para tags PDF. | + +**Dica profissional:** Se você estiver convertendo muitos documentos em lote, reutilize uma única instância de `PdfSaveOptions`. Criá‑la uma única vez reduz a sobrecarga de alocação e mantém o consumo de memória baixo. + +--- + +## Exemplo Completo (Pronto para Copiar e Colar) + +A seguir está o programa completo que reúne tudo. Salve como `Program.cs`, adicione os pacotes NuGet Aspose.Words e Aspose.PDF, e execute. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Resultado esperado:** +Um arquivo chamado `output.pdf` será criado em `C:\MyFiles`. Ao abri‑lo no Adobe Acrobat, o painel de conformidade exibirá “PDF/A‑2b, PDF/UA‑1”, confirmando que você *converteu word para pdf* com sucesso. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/portuguese/net/programming-with-markdownsaveoptions/_index.md b/words/portuguese/net/programming-with-markdownsaveoptions/_index.md index c6638c1efc..1c3e52f501 100644 --- a/words/portuguese/net/programming-with-markdownsaveoptions/_index.md +++ b/words/portuguese/net/programming-with-markdownsaveoptions/_index.md @@ -50,6 +50,15 @@ Aprenda a exportar documentos DOCX para Markdown usando C# com Aspose.Words, pas ### [Como salvar Markdown de DOCX – Guia passo a passo](./how-to-save-markdown-from-docx-step-by-step-guide/) Aprenda a salvar documentos DOCX como arquivos Markdown passo a passo usando Aspose.Words para .NET. +### [Como Exportar LaTeX do Word – Converter DOCX para Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) +Aprenda a exportar equações LaTeX de documentos Word ao convertê-los para Markdown usando Aspose.Words para .NET. + +### [Como Exportar LaTeX de DOCX – Converter para Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) +Aprenda a exportar equações LaTeX de arquivos DOCX ao convertê-los para Markdown com Aspose.Words para .NET. + +### [Criar markdown a partir do Word – Guia completo em C#](./create-markdown-from-word-full-c-guide/) +Aprenda a gerar arquivos markdown a partir de documentos Word usando C# e Aspose.Words. + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/portuguese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/portuguese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..3b8a4e7adf --- /dev/null +++ b/words/portuguese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,252 @@ +--- +category: general +date: 2026-03-27 +description: Crie markdown a partir do Word com Aspose.Words C#. Aprenda a converter + docx para markdown, extrair imagens do Word e como usar callbacks em um único tutorial. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: pt +og_description: Crie markdown a partir do Word usando Aspose.Words. Este guia mostra + como converter docx para markdown, extrair imagens do Word e usar um callback para + o tratamento de recursos. +og_title: Criar markdown a partir do Word – Tutorial completo de C# +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Criar markdown a partir do Word – Guia completo de C# +url: /pt/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Criar markdown a partir do Word – Tutorial Completo em C# + +Já precisou **criar markdown a partir do Word** mas não sabia por onde começar? Você não está sozinho; muitos desenvolvedores se deparam com esse obstáculo ao tentar mover conteúdo de um arquivo .docx para um gerador de site estático ou um repositório de documentação. A boa notícia? Com Aspose.Words você pode **converter docx para markdown**, extrair todas as imagens do arquivo original e controlar exatamente onde esses recursos são armazenados — tudo com um simples callback. + +Neste guia vamos percorrer um exemplo real que mostra como extrair imagens do Word, como usar o callback para armazená‑las e por que essa abordagem é a mais confiável para pipelines de automação. Ao final, você terá um programa C# pronto‑para‑executar que produz um arquivo `.md` limpo e uma pasta com as imagens extraídas. + +> **Dica de especialista:** Se você já tem um modelo Word que inclui capturas de tela, diagramas ou logotipos, este método preservará cada elemento visual sem que você precise copiar‑colar manualmente. + +--- + +## O que você vai precisar + +- **.NET 6+** (ou .NET Framework 4.6+). O código funciona em qualquer runtime recente. +- **Aspose.Words for .NET** (pacote NuGet `Aspose.Words`). O trial gratuito funciona na maioria dos cenários. +- Um **documento Word** (`input.docx`) que contenha texto e ao menos uma imagem. +- Noções básicas de C# e Visual Studio (ou sua IDE favorita). + +Nenhuma biblioteca extra é necessária — todo o restante é tratado pelo próprio Aspose.Words. + +--- + +## Etapa 1: Configurar o projeto e instalar o Aspose.Words + +Para manter as coisas organizadas, crie um novo projeto de console: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Por que esta etapa importa:** Instalar o pacote NuGet garante que você tenha a API mais recente, que inclui a classe `MarkdownSaveOptions` introduzida na versão 22.9. Sem ela, seria necessário escrever um conversor personalizado. + +--- + +## Etapa 2: Carregar o documento Word de origem + +A primeira linha de código abre o `.docx` que você deseja transformar. Substitua `YOUR_DIRECTORY` pelo caminho real na sua máquina. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **O que está acontecendo?** `Document` analisa o arquivo, constrói um DOM interno e torna cada parágrafo, tabela e imagem acessíveis. Se o arquivo estiver ausente, o Aspose lança uma `FileNotFoundException` clara, que você pode capturar para uma UI mais amigável. + +--- + +## Etapa 3: Configurar as opções de salvamento em Markdown com um callback de salvamento de recursos + +Aqui é onde a magia de **como usar callback** entra em ação. O callback permite decidir onde cada imagem extraída será armazenada. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Por que um callback?** Por padrão o Aspose incorporaria as imagens como strings base‑64 dentro do markdown — um pesadelo para controle de versão. O callback dá controle total sobre nomes de arquivos e estrutura de pastas. + +--- + +## Etapa 4: Salvar o documento como Markdown + +Agora geramos realmente o arquivo `.md`. Todas as imagens serão entregues ao callback definido na etapa seguinte. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Se tudo correr bem, você encontrará `Document.md` na pasta de destino e uma subpasta chamada `Resources` contendo todas as imagens extraídas do arquivo Word original. + +--- + +## Etapa 5: Implementar o callback que armazena cada imagem extraída + +A seguir está a implementação completa de `MyResourceSaver`. Ela cria um diretório `Resources` (se ainda não existir), gera um nome de arquivo único para cada imagem e grava o fluxo da imagem no disco. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Explicação dos argumentos:** +> - `args.Index` – um contador base‑zero que garante unicidade. +> - `args.FileName` – o nome de arquivo original sugerido pelo Aspose (geralmente algo como `image001.png`). +> - `args.Stream` – o fluxo de saída onde os bytes da imagem são escritos. +> - `args.KeepResourceStreamOpen` – definido como `false` para que o Aspose descarte o fluxo automaticamente, evitando vazamentos de manipuladores de arquivo. + +--- + +## Exemplo completo em funcionamento + +Juntando tudo, aqui está um único arquivo que você pode copiar‑colar em `Program.cs`. Lembre‑se de substituir `YOUR_DIRECTORY` por um caminho absoluto ou relativo que se ajuste ao seu ambiente. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Saída esperada + +- `YOUR_DIRECTORY/Document.md` – um arquivo markdown com links de imagem padrão, por exemplo: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – contém `img_0.png`, `img_1.jpg`, etc., correspondendo à ordem em que apareceram no documento Word original. + +Ao executar o programa, ele imprime uma confirmação amigável, informando que o processo foi concluído com sucesso. + +--- + +## Perguntas Frequentes (FAQ) + +### Como extrair imagens do Word sem perder qualidade? + +O callback grava o fluxo binário bruto diretamente em um arquivo, preservando a resolução original. Nenhuma conversão ou compressão ocorre, a menos que você adicione sua própria lógica de processamento de imagem dentro de `ResourceSaving`. + +### Posso mudar o formato da imagem (ex.: PNG → JPEG) durante a extração? + +Com certeza. Dentro de `ResourceSaving` você pode inspecionar `args.FileName` ou `args.Stream`, carregar a imagem com `System.Drawing` ou `ImageSharp` e re‑codificá‑la antes de gravar. Apenas lembre‑se de atualizar a extensão do link markdown adequadamente. + +### E se eu precisar que os arquivos markdown referenciem um CDN em vez de uma pasta local? + +Modifique o callback para prefixar uma URL base ao link markdown. Você pode fazer isso definindo `args.FileName` como uma URL totalmente qualificada após fazer upload da imagem para o seu CDN. + +### Isso funciona com tabelas, notas de rodapé ou outros recursos avançados do Word? + +Sim. Aspose.Words traduz a maioria dos constructos do Word para equivalentes markdown. Tabelas se tornam tabelas markdown, notas de rodapé viram links de referência e até listas aninhadas são tratadas de forma elegante. Se algo parecer estranho, verifique as notas de versão mais recentes — o Aspose aprimora continuamente a fidelidade da conversão. + +### Como converter docx para markdown em um pipeline CI/CD? + +Basta adicionar o `.exe` compilado às suas etapas de build, apontá‑lo para os artefatos `.docx` gerados e enviar o `.md` resultante e a pasta `Resources/` para o repositório do seu site estático. Como o processo é totalmente determinístico, funciona bem em ambientes automatizados. + +--- + +## Conclusão + +Acabamos de demonstrar como **criar markdown a partir do Word** usando Aspose.Words, cobrimos todo o fluxo **converter docx para markdown** e mostramos uma maneira prática de **extrair imagens do Word** com uma implementação personalizada de **como usar callback**. O resultado é um arquivo markdown limpo acompanhado de uma pasta com as imagens originais — perfeito para sites de documentação, blogs estáticos ou qualquer fluxo de trabalho que prefira formatos de texto puro. + +Próximos passos que você pode considerar: + +- **Processamento em lote** de múltiplos arquivos `.docx` em uma pasta (loop sobre `Directory.GetFiles`). +- **Esquemas de nomenclatura personalizados** para imagens (ex.: usando o texto da legenda original). +- **Pós‑processamento** do markdown para substituir links de imagem por URLs de CDN. +- Explorar **outros formatos de exportação Aspose** como HTML, PDF ou EPUB para publicação multicanal. + +Tem mais dúvidas ou um arquivo Word complicado que se recusa a converter? Deixe um comentário abaixo e vamos solucionar juntos. Boa codificação e aproveite a simplicidade de transformar Word em markdown! + +--- + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/portuguese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/portuguese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..9f80df76d1 --- /dev/null +++ b/words/portuguese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Como exportar LaTeX de DOCX usando Aspose.Words. Aprenda a converter + DOCX para Markdown, definir DPI e habilitar a recuperação em C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: pt +og_description: Como exportar LaTeX de DOCX usando Aspose.Words. Este tutorial mostra + conversão passo a passo para Markdown, controle de DPI e modo de recuperação. +og_title: Como Exportar LaTeX de DOCX – Converter para Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Como Exportar LaTeX de DOCX – Converter para Markdown +url: /pt/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como Exportar LaTeX de DOCX – Converter para Markdown + +Já se perguntou **como exportar LaTeX** de um arquivo DOCX sem perder a beleza das suas equações? Você não está sozinho. Na minha experiência, o maior ponto problemático é obter esses objetos OfficeMath em um formato limpo e portátil para geradores de sites estáticos ou blogs científicos. + +Neste guia vamos percorrer a conversão de DOCX para Markdown com Aspose.Words, mostrando também **como definir DPI**, **como habilitar recuperação**, e alguns truques úteis para um pipeline à prova de falhas. Ao final você terá um único programa C# que produz um arquivo Markdown com equações LaTeX, imagens em alta resolução e tratamento adequado de hyperlinks. + +## O que Você Precisará + +- **.NET 6+** (ou .NET Framework 4.7.2 – a API funciona da mesma forma) +- **Aspose.Words for .NET** (a versão estável mais recente em março 2026) +- Um arquivo DOCX que contenha equações, imagens e links +- Visual Studio, VS Code ou qualquer editor de sua preferência + +Nenhum pacote NuGet extra é necessário além do Aspose.Words, mas certifique‑se de ter uma licença válida se não estiver usando a versão de avaliação. + +## Etapa 1 – Carregar o DOCX com Modo de Recuperação Estrita + +Antes de sequer pensar em exportar, precisamos garantir que o documento fonte não esteja ocultando corrupção. É aqui que **como habilitar recuperação** entra em ação. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Por que recuperação estrita?** +Se você deixar o Aspose corrigir problemas silenciosamente, pode acabar com parágrafos ausentes ou imagens quebradas — algo que ninguém quer ao exportar LaTeX. Falhando rapidamente, você captura o problema cedo e decide se corrige o DOCX fonte ou registra o problema para depois. + +### Dica profissional +Envolva o carregamento em um try/catch e registre `DocumentLoadingException`. Dessa forma seu pipeline CI pode sinalizar arquivos problemáticos sem interromper toda a compilação. + +## Etapa 2 – Preparar as Opções de Exportação para Markdown + +Agora que o documento está seguramente na memória, configuramos como ele será salvo. Este é o coração de **como exportar latex** e também cobre **como definir DPI** para imagens incorporadas. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**O que cada opção faz** + +| Option | Reason | Relevance to Keywords | +|--------|--------|-----------------------| +| `OfficeMathExportMode = LaTeX` | Responde diretamente **how to export latex** a partir de equações. | Palavra‑chave principal | +| `ImageResolution = 300` | Controla a qualidade da imagem – a resposta para **how to set dpi**. | Secundário | +| `ResourceSavingCallback` | Salva arquivos incorporados no disco, uma necessidade comum ao **convert docx to markdown**. | Secundário | +| `EmptyParagraphExportMode` | Garante saída Markdown limpa, evitando tags HTML soltas. | Melhora a qualidade geral da conversão | +| `LinkExportMode = AsReference` | Facilita a leitura e edição de links, outro benefício para **convert docx to markdown**. | Secundário | + +## Etapa 3 – Implementar um Salvador de Recursos Personalizado (Opcional, mas Útil) + +Ao converter DOCX para Markdown, imagens e outros recursos binários precisam de um local no sistema de arquivos. O Aspose permite controlar isso com `IResourceSavingCallback`. O trecho acima já mostra uma implementação mínima, mas vamos detalhá‑lo: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Por que se preocupar?** +Se você pular esta etapa, o Aspose incorporará imagens como strings base‑64, o que inflaciona o tamanho do arquivo Markdown e torna o controle de versão doloroso. Salvando os recursos em uma pasta separada, você mantém o Markdown leve e amigável para geradores de sites estáticos como Hugo ou Jekyll. + +## Etapa 4 – Salvar o Documento como Markdown + +Todo o trabalho pesado está concluído. Uma única linha agora grava o arquivo final. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Abra `output.md` e você verá: + +- Equações renderizadas como blocos LaTeX `$…$` +- Imagens referenciadas como `![Alt text](resources/image001.png)` com resolução de 300 dpi +- Links convertidos para estilo de referência: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Esse é todo o processo de **how to convert docx** resumido. + +## Perguntas Frequentes & Casos Limítrofes + +### 1️⃣ E se o DOCX contiver objetos não suportados? +Aspose.Words lançará uma `FeatureNotSupportedException`. Como usamos **how to enable recovery** em modo estrito, a exceção aparece imediatamente. Você pode: + +- Trocar `RecoveryMode` para `RecoveryMode.Default` para uma conversão de melhor esforço, **ou** +- Pré‑processar o DOCX (por exemplo, remover SmartArt não suportado) antes de executar o conversor. + +### 2️⃣ Posso mudar o DPI por imagem? +A configuração `ImageResolution` é global. Para controle por imagem, implemente um `ImageSavingCallback` personalizado semelhante ao `MyResourceSaver` e ajuste `args.ImageResolution` com base em `args.ImageFileName` ou metadados. + +### 3️⃣ Como incorporo o LaTeX gerado em um site Jekyll? +O suporte nativo do Jekyll ao MathJax funciona imediatamente. Basta garantir que seu layout inclua o script MathJax e que os blocos LaTeX estejam envoltos em `$$` para equações de exibição ou `$` para inline. + +### 4️⃣ Isso é compatível com .NET Core no Linux? +Absolutamente. Aspose.Words é multiplataforma. Apenas assegure que o caminho `YOUR_DIRECTORY` siga as convenções Linux (por exemplo, `/home/user/docs`). + +## Exemplo Completo em Funcionamento + +Abaixo está um programa pronto para copiar e colar. Substitua `YOUR_DIRECTORY` por um caminho real na sua máquina. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Saída esperada** – abra `output.md` e você deverá ver algo como: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Se você abrir o arquivo em uma visualização Markdown que suporte MathJax, a integral será renderizada + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/portuguese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/portuguese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..ecbb9b2d0a --- /dev/null +++ b/words/portuguese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Como exportar LaTeX de documentos Word usando Aspose.Words – converter + DOCX para Markdown com equações em LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: pt +og_description: Como exportar LaTeX de documentos Word é explicado na primeira frase, + mostrando como converter DOCX para Markdown com equações em LaTeX. +og_title: Como Exportar LaTeX do Word – Guia Completo +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Como Exportar LaTeX do Word – Converter DOCX para Markdown +url: /pt/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como Exportar LaTeX do Word – Converter DOCX para Markdown + +Já se perguntou **como exportar LaTeX** de um arquivo Word sem acabar com um monte de PNGs? Você não está sozinho; desenvolvedores frequentemente esbarram nessa barreira quando precisam de equações limpas e editáveis para sites estáticos ou blogs científicos. A boa notícia? Com Aspose.Words você pode **converter Word para Markdown** e manter cada objeto OfficeMath como LaTeX nativo — sem necessidade de pós‑processamento. + +Neste tutorial vamos percorrer todo o processo de **salvar um documento Word como Markdown** enquanto **exportamos equações como LaTeX**. Ao final você terá um trecho de código C# executável, uma explicação clara de cada opção e dicas para lidar com casos especiais, como fórmulas complexas ou conteúdo misto. Sem ferramentas externas, apenas um único pacote NuGet e algumas linhas de código. + +## O que você precisará + +- .NET 6+ (ou .NET Framework 4.7.2 ou superior) – a runtime mais recente funciona melhor. +- Visual Studio 2022 ou qualquer editor que compile projetos C#. +- Uma licença do Aspose.Words for .NET (a avaliação gratuita serve para experimentação). +- Um arquivo DOCX que contenha ao menos uma equação (OfficeMath). + +Se já tem tudo isso, ótimo — vamos começar. + +## Como Exportar LaTeX do Word – Visão geral + +A seguir, uma visão de alto nível das etapas envolvidas: + +1. **Instalar** o pacote NuGet Aspose.Words. +2. **Carregar** o `.docx` fonte que contém suas equações. +3. **Configurar** `MarkdownSaveOptions` para que `OfficeMathExportMode` esteja definido como `LaTeX`. +4. **Salvar** o documento como um arquivo `.md`. +5. **Verificar** se o Markdown gerado contém blocos LaTeX (`$$…$$`). + +Cada uma dessas etapas é explicada em detalhes nas seções a seguir. + +![Diagrama mostrando o fluxo de DOCX para Markdown com equações LaTeX](how-to-export-latex.png){alt="Diagrama de como exportar LaTeX do Word"} + +## Etapa 1 – Instalar Aspose.Words para .NET (converter word para markdown) + +Primeiro de tudo: você precisa da biblioteca que realmente faz o trabalho pesado. Abra seu terminal (ou Package Manager Console) e execute: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Dica profissional:** Se você estiver usando o Visual Studio, clique com o botão direito no projeto → *Manage NuGet Packages* → procure por “Aspose.Words” e instale a versão estável mais recente. + +Por que isso importa: Aspose.Words abstrai o formato Open XML, oferecendo uma API limpa para manipular documentos Word sem lidar com o XML de baixo nível. Ele também inclui suporte nativo para converter OfficeMath para LaTeX, que é o núcleo do nosso requisito de **exportar equações como LaTeX**. + +## Etapa 2 – Carregar o DOCX (como converter docx) + +Com o pacote instalado, carregue o arquivo que você deseja transformar. Substitua `YOUR_DIRECTORY` pelo caminho onde seu `.docx` está localizado: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Por que carregá‑lo dessa forma?** O construtor `Document` analisa todo o arquivo em um modelo de objeto, dando acesso imediato a parágrafos, tabelas e — mais importante — objetos OfficeMath. Se o arquivo estiver ausente ou corrompido, Aspose lança uma `FileNotFoundException` descritiva, que você pode capturar para tratamento de erro elegante. + +## Etapa 3 – Configurar MarkdownSaveOptions (exportar equações como latex) + +A mágica acontece no objeto `MarkdownSaveOptions`. Por padrão, Aspose renderizaria as equações como imagens PNG, mas queremos LaTeX. Defina `OfficeMathExportMode` como `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Uma breve observação sobre as flags opcionais: `ExportImagesAsBase64` indica ao Aspose que não incorpore dados binários, mantendo o Markdown limpo. `ExportHeadersFooters` garante que você não perca nenhum contexto que possa estar nesses trechos — útil quando o cabeçalho contém título ou nome do autor. + +## Etapa 4 – Salvar o Documento (salvar word como markdown) + +Por fim, escreva o conteúdo transformado em um arquivo `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Depois que esta linha for executada, você encontrará `output.md` ao lado do seu arquivo fonte. Abra‑o em qualquer editor de texto e deverá ver blocos LaTeX semelhantes a este: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Essa é a parte de **salvar word como markdown** concluída — sem etapas de conversão adicionais necessárias. + +## Etapa 5 – Verificar o Resultado (exportar equações como latex) + +É fácil esquecer a verificação, mas um rápido teste de sanidade economiza horas depois. Execute um script simples que lê o arquivo gerado e imprime o primeiro bloco LaTeX: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Se aparecer `First LaTeX block: $$ … $$` no console, você exportou **LaTeX** do Word com sucesso. Caso contrário, verifique se seu documento fonte realmente contém objetos OfficeMath; equações de texto simples não serão convertidas. + +## Lidando com Casos de Borda Comuns + +| Cenário | O que observar | Correção recomendada | +|----------|-------------------|-----------------| +| **Imagens e equações misturadas** | Aspose ainda pode incorporar imagens para gráficos que não são OfficeMath. | Defina `ExportImagesAsBase64 = false` e mantenha as imagens como arquivos externos, referenciando‑as manualmente no Markdown. | +| **Equações aninhadas complexas** | Aninhamento muito profundo pode gerar LaTeX que precise de ajustes manuais. | Pós‑processar o bloco com um formatador LaTeX (ex.: `latexindent`) ou ajustar `mdOptions` → `ExportMathAsDisplay = true`. | +| **Documentos grandes** | O uso de memória aumenta ao carregar arquivos `.docx` enormes. | Use `LoadOptions` com `LoadFormat.Docx` e habilite streaming em `LoadOptions.LoadFormat`, se disponível. | +| **Licença ausente** | O trial gratuito adiciona um comentário de marca‑d’água na saída. | Aplique uma licença válida via `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Essas dicas mantêm seu fluxo de trabalho robusto, especialmente quando você **converte word para markdown** em pipelines de produção. + +## Exemplo Completo (Todas as Etapas em Um Arquivo) + +Abaixo está um aplicativo console autocontido que você pode copiar‑colar em um novo projeto .NET e executar imediatamente. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Execute o programa, abra `output.md` e verá suas equações renderizadas como LaTeX limpo. Essa é a resposta completa para **como exportar latex** de um documento Word. + +## Conclusão + +Cobremos **como exportar LaTeX** do Word passo a passo, mostrando como **converter Word para markdown**, **salvar word como markdown** e **exportar equações como LaTeX** usando Aspose.Words. A ideia central é simples: carregar o DOCX, ajustar `MarkdownSaveOptions` e deixar a biblioteca fazer o trabalho pesado. + +Se você está pronto para automatizar pipelines de documentação, experimente encadear esse código com um gerador de sites estáticos como Hugo ou Jekyll — basta enviar os arquivos `.md` gerados ao seu repositório e deixar o site recompilar. Para leituras adicionais, explore o guia “Export to LaTeX” da Aspose, experimente `HtmlSaveOptions` para pré‑visualizações web ou aprofunde‑se na API `DocumentVisitor` para transformações personalizadas. + +Tem perguntas sobre casos de borda, licenciamento ou integração em CI/CD? Deixe um comentário abaixo, e feliz codificação! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/portuguese/net/programming-with-pdfsaveoptions/_index.md b/words/portuguese/net/programming-with-pdfsaveoptions/_index.md index 0e6ad2ad0f..9cc1aab2a2 100644 --- a/words/portuguese/net/programming-with-pdfsaveoptions/_index.md +++ b/words/portuguese/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ Quer você queira converter documentos do Word em PDF para distribuição online | [Atualizar a última propriedade impressa no documento PDF](./update-last-printed-property/) | Aprenda como atualizar a última propriedade impressa em um documento PDF usando o Aspose.Words para .NET com nosso guia passo a passo. | | [Renderizar efeitos 3D DML 3DEffects em um documento PDF](./dml-3deffects-rendering/) | Aprenda a renderizar efeitos DML 3D impressionantes em documentos PDF usando o Aspose.Words para .NET com este guia passo a passo abrangente. | | [Interpolar imagens em um documento PDF](./interpolate-images/) | Aprenda a interpolar imagens em um documento PDF usando o Aspose.Words para .NET com nosso guia passo a passo. Melhore a qualidade das imagens do seu PDF facilmente. | - +| [Como salvar PDF a partir de DOCX com Aspose.Words – Guia passo a passo](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Aprenda a converter documentos DOCX em PDF usando Aspose.Words passo a passo. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/portuguese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/portuguese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..f3db68146b --- /dev/null +++ b/words/portuguese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,198 @@ +--- +category: general +date: 2026-03-27 +description: Aprenda como salvar PDF a partir de um arquivo DOCX usando Aspose.Words. + Inclui converter DOCX para PDF, salvar PDF com opções e lidar com formas flutuantes. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: pt +og_description: Como salvar PDF a partir de um arquivo DOCX usando Aspose.Words. Este + guia mostra como converter DOCX para PDF, salvar o PDF com opções e lidar com formas + flutuantes. +og_title: Como salvar PDF a partir de DOCX – Tutorial completo do Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Como salvar PDF a partir de DOCX com Aspose.Words – Guia passo a passo +url: /pt/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como Salvar PDF a partir de DOCX com Aspose.Words – Tutorial Completo + +Já se perguntou **como salvar PDF** a partir de um documento Word sem perder o layout das formas flutuantes? Você não está sozinho. Em muitos projetos—geradores de faturas, exportadores de relatórios ou simples arquivadores de documentos—os desenvolvedores precisam de uma forma confiável de converter DOCX para PDF mantendo tudo exatamente como aparece no Word. + +Neste tutorial vamos percorrer a conversão de um arquivo DOCX para PDF **usando Aspose.Words para .NET**, mostrar **como converter docx para pdf** com opções de salvamento personalizadas e explicar por que a flag `ExportFloatingShapesAsInlineTag` é importante. Ao final, você terá um trecho pronto‑para‑executar que salva PDF com as opções que você controla. + +## O que Você Vai Aprender + +- Os passos exatos para **converter word document pdf** com Aspose.Words. +- Como configurar `PdfSaveOptions` para tratar formas flutuantes como tags inline. +- Armadilhas comuns ao lidar com objetos flutuantes e como evitá‑las. +- Um programa C# completo e executável que você pode inserir em qualquer projeto .NET. + +> **Pré‑requisito:** Você precisa de uma licença Aspose.Words para .NET (ou uma avaliação gratuita) e de um ambiente de desenvolvimento .NET (Visual Studio, Rider ou a CLI `dotnet`). + +## Etapa 1: Configurar o Projeto e Adicionar Aspose.Words + +Primeiro, crie um novo aplicativo de console (ou adicione a um existente) e referencie o pacote NuGet Aspose.Words. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Dica de especialista:** Se você estiver em um servidor de CI, fixe a versão do pacote (`Aspose.Words --version 24.10`) para garantir builds reproduzíveis. + +## Etapa 2: Carregar o DOCX que Contém Formas Flutuantes + +Imagens, caixas de texto ou SmartArt flutuantes podem causar deslocamentos de layout ao serem convertidos. Carregar o documento é simples, mas também verificaremos se o arquivo existe para evitar uma `FileNotFoundException` em tempo de execução. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Observe as instruções `Console.WriteLine`—elas fornecem feedback rápido quando você executa o aplicativo a partir de um terminal. + +## Etapa 3: Configurar Opções de Salvamento PDF (Save PDF with Options) + +É aqui que a mágica acontece. Por padrão, Aspose.Words tenta preservar os objetos flutuantes como aparecem, o que pode quebrar o layout no PDF resultante. Definir `ExportFloatingShapesAsInlineTag` como `true` indica à biblioteca que trate essas formas como tags inline, garantindo que permaneçam ancoradas ao texto circundante. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Por que isso importa? Imagine uma caixa de texto que paira sobre um parágrafo. Sem a conversão para tag inline, o PDF pode empurrar o parágrafo para baixo ou recortar a caixa completamente. A flag mantém a relação visual intacta—um detalhe sutil, porém crucial, para relatórios profissionais. + +## Etapa 4: Salvar o Documento como PDF + +Agora realmente gravamos o arquivo PDF. O método `Save` recebe tanto o caminho de saída quanto as opções que acabamos de definir. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Executar o programa produzirá `output.pdf` na mesma pasta do seu DOCX de origem. Abra‑o em qualquer visualizador de PDF e você verá que todas as formas flutuantes são renderizadas exatamente onde pertencem. + +## Exemplo Completo Funcional + +Abaixo está o programa inteiro em um único bloco. Copie‑e‑cole em `Program.cs` (ou em qualquer arquivo C#) e pressione **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Resultado Esperado + +- **Arquivo criado:** `output.pdf` no diretório de destino. +- **Fidelidade de layout:** Formas flutuantes (imagens, caixas de texto, SmartArt) aparecem inline com o texto ao redor. +- **Sem exceções:** O programa finaliza graciosamente, imprimindo mensagens de status no console. + +## Perguntas Frequentes & Casos Limites + +| Pergunta | Resposta | +|----------|----------| +| **E se eu precisar de qualidade de imagem maior?** | Defina `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Posso converter vários arquivos DOCX em lote?** | Envolva a lógica de carregamento/salvamento em um loop `foreach (var file in Directory.GetFiles(..., "*.docx"))`. Lembre‑se de reutilizar uma única instância de `PdfSaveOptions` para melhorar o desempenho. | +| **Isso funciona com .NET Core?** | Absolutamente. Aspose.Words 24.x suporta .NET Standard 2.0+, então você pode executar o mesmo código no Windows, Linux ou macOS. | +| **E arquivos DOCX protegidos por senha?** | Carregue com `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. As mesmas `PdfSaveOptions` são aplicadas ao salvar. | +| **A conversão para tag inline é segura para tabelas complexas?** | Geralmente sim, mas layouts de tabela muito intrincados com formas sobrepostas ainda podem precisar de ajustes manuais. Teste uma amostra representativa antes de uma migração em massa. | + +## Dicas para Projetos do Mundo Real + +- **Log, não apenas `Console.WriteLine`** – Em produção, substitua a saída de console por um framework de logging (Serilog, NLog) para capturar erros. +- **Liberar recursos** – `Document` implementa `IDisposable`. Envolva‑o em um bloco `using` se estiver processando muitos arquivos para liberar memória rapidamente. +- **Validar o PDF** – Use um validador de PDF (por exemplo, verificador de conformidade PDF/A) se precisar de PDFs de nível arquivístico. +- **Processamento paralelo** – Para cargas massivas, considere `Parallel.ForEach` com `PdfSaveOptions` thread‑safe (clone por thread) para acelerar a conversão. + +## Conclusão + +Cobrimos **como salvar PDF** a partir de um arquivo DOCX usando Aspose.Words, demonstramos **como converter docx para pdf** com opções personalizadas e explicamos o impacto de `ExportFloatingShapesAsInlineTag`. O exemplo completo e executável mostra que você pode **converter word document pdf** em apenas algumas linhas, e agora sabe como **salvar pdf com opções** que atendam às necessidades de qualidade e conformidade do seu projeto. + +Pronto para o próximo desafio? Experimente exportar para outros formatos (por exemplo, HTML, EPUB) com `document.Save("output.html")`, ou teste a conformidade PDF/A para arquivamento de longo prazo. Os mesmos princípios—carregar, configurar opções, salvar—valem para todos os casos. + +Feliz codificação, e que seus PDFs estejam sempre exatamente como você planejou! + +![Diagrama ilustrando como um arquivo DOCX é carregado, opções são aplicadas e um PDF é produzido – como salvar pdf](https://example.com/images/how-to-save-pdf-diagram.png "diagrama de como salvar pdf") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/portuguese/net/programming-with-shapes/_index.md b/words/portuguese/net/programming-with-shapes/_index.md index 5d3b835838..f1f470e56b 100644 --- a/words/portuguese/net/programming-with-shapes/_index.md +++ b/words/portuguese/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Usando o Aspose.Words para .NET e seguindo estes tutoriais, você dominará a ma | [Detectar Forma de Arte Inteligente](./detect-smart-art-shape/) | Aprenda a detectar formas SmartArt em documentos do Word usando o Aspose.Words para .NET com este guia abrangente. Perfeito para automatizar seu fluxo de trabalho de documentos. | | [Atualizar desenho de arte inteligente](./update-smart-art-drawing/) | Aprenda a atualizar desenhos Smart Art em documentos do Word usando o Aspose.Words para .NET com este guia passo a passo. Garanta que seus visuais estejam sempre precisos. | | [Criar forma retangular no Word com Aspose.Words – Guia passo a passo](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Aprenda a criar uma forma retangular em documentos do Word usando o Aspose.Words para .NET com este guia passo a passo. | +| [Criar documento Word C# – Adicionar forma com sombra](./create-word-document-c-add-shape-with-shadow/) | Aprenda a adicionar uma forma com sombra a documentos do Word usando o Aspose.Words para .NET com este guia passo a passo. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/portuguese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/portuguese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..abd37a629b --- /dev/null +++ b/words/portuguese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: Crie um documento Word em C# e aprenda como adicionar forma, aplicar + sombra à forma e definir a distância da sombra. Guia passo a passo para Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: pt +og_description: Crie um documento Word em C# com uma forma retangular e sombra personalizada. + Siga este tutorial completo para definir a distância e o estilo da sombra. +og_title: Criar documento Word C# – Adicionar forma com sombra +tags: +- Aspose.Words +- C# +- Document Automation +title: Criar documento Word C# – Adicionar forma com sombra +url: /pt/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Criar Documento Word C# – Adicionar Forma com Sombra + +Já precisou **create word document c#** que contenha um retângulo bem estilizado? Talvez você esteja criando um modelo de relatório e queira uma sombra sutil para realçar o layout. Neste tutorial vamos percorrer exatamente isso – como adicionar uma forma, aplicar sombra à forma e até ajustar a distância da sombra usando Aspose.Words. + +Começaremos com um documento em branco, inseriremos um retângulo, aplicaremos uma sombra predefinida e finalizaremos salvando o arquivo. Ao final você terá um .docx pronto‑para‑usar que pode abrir no Word e ver o efeito instantaneamente. Sem ferramentas externas, apenas código C# puro. + +## Pré-requisitos + +- .NET 6 (ou qualquer .NET Framework recente) instalado. +- Visual Studio 2022 ou VS Code com extensão C#. +- Pacote NuGet Aspose.Words para .NET (`Aspose.Words` versão 23.12 ou posterior). + Você pode adicioná‑lo via o Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +É isso – nenhum DLL extra ou interop COM necessário. + +## Passo 1: Inicializar um Novo Documento e Builder – *create word document c#* Básico + +Primeiro precisamos de um objeto `Document` que representa o arquivo Word e de um `DocumentBuilder` para editá‑lo. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Por que este passo importa:** A classe `Document` é o contêiner para todas as partes do Word (páginas, estilos, imagens). O builder é a API de alto nível que abstrai a manipulação de nós de baixo nível, facilitando **create word document c#** sem lidar diretamente com XML. + +## Passo 2: Inserir uma Forma Retângulo – *how to create rectangle* + +Agora vamos colocar um retângulo na página. O tamanho é expresso em pontos (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Dica de especialista:** Se precisar de uma forma diferente, basta trocar `ShapeType.Rectangle` por `ShapeType.Ellipse`, `ShapeType.Triangle`, etc. O mesmo código funciona para **how to add shape** de qualquer tipo. + +## Passo 3: Aplicar uma Sombra Predefinida e Ajustá‑la – *apply shadow to shape* + +Aspose.Words vem com vários formatos de sombra predefinidos. Usaremos `Preset1` e então personalizaremos distância, desfoque, transparência e cor. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Por que personalizar a sombra?** A propriedade `Distance` controla quão longe a sombra fica do retângulo – pense nisso como o “levante” que você veria em uma renderização 3‑D. Alterar `BlurRadius` suaviza as bordas, enquanto `Transparency` permite criar um visual sutil e profissional. Isso cobre o requisito de **set shadow distance** e mostra como **apply shadow to shape** de forma flexível. + +## Passo 4: Salvar o Documento – *create word document c#* Conclusão + +Finalmente, grave o documento no disco. Ajuste o caminho para uma pasta onde você tenha permissão de gravação. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Abra o arquivo resultante no Microsoft Word, e você verá um retângulo azul‑claro com uma sombra cinza suave deslocada em 5 pt. Essa é a prova visual de que você **create word document c#** com uma forma estilizada com sucesso. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="exemplo de create word document c# mostrando retângulo com sombra"} + +## Variações Opcionais & Casos Limite + +| Cenário | O que Alterar | Por que é Importante | +|----------|----------------|----------------| +| **Estilo de sombra diferente** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Fornece um visual mais dramático sem código extra. | +| **Sem predefinição – sombra personalizada** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Controle total sobre direção e profundidade. | +| **Múltiplas formas** | Call `builder.InsertShape` again before saving. | Útil para modelos complexos com ícones, logotipos, etc. | +| **Compatibilidade com versões mais antigas do Aspose** | Use `ShadowEffect` class (available in v20.x). | Garante que seu código funcione em projetos legados. | +| **Salvar como PDF** | `document.Save("ShadowShape.pdf");` | A mesma renderização da sombra aparece na saída PDF. | + +> **Pergunta comum:** *E se a sombra não aparecer no Word?* +> Certifique‑se de que está usando uma versão recente do Aspose.Words (≥ 22.9). Versões mais antigas tinham suporte limitado a sombras. Também verifique se o documento está sendo aberto em uma versão recente do Word (2016+). + +## Exemplo Completo Funcional + +Abaixo está o programa completo, pronto para copiar e colar. Inclui todas as diretivas `using`, comentários e tratamento de erros para uma experiência tranquila. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Execute o programa, navegue até `C:\Temp\ShadowShape.docx`, e você verá o retângulo com a sombra exata que configuramos. + +## Recapitulação & Próximos Passos + +- Agora você sabe como **create word document c#**, inserir um retângulo e **apply shadow to shape** com uma **set shadow distance** personalizada. +- O exemplo usa Aspose.Words, que abstrai as complexidades do OpenXML e garante renderização consistente em diferentes versões do Word. +- Quer ir além? Experimente combinar múltiplas formas, adicionar texto dentro do retângulo ou exportar o mesmo documento como PDF para ver como a sombra se traduz. + +### Tópicos Relacionados que Você Pode Explorar + +- **How to add shape** a um cabeçalho/rodapé para branding. +- Usando **Aspose.Words** para inserir gráficos e tabelas programaticamente. +- Personalizando **shadow effects** em imagens ao invés de formas vetoriais. +- Automatizando a geração em massa de documentos para faturas ou certificados. + +Sinta‑se à vontade para experimentar, quebrar o código e depois reconstruí‑lo – essa é a maneira mais rápida de internalizar os conceitos. Se encontrar algum problema, deixe um comentário abaixo ou consulte a documentação oficial do Aspose.Words para insights mais profundos da API. + +Feliz codificação, e aproveite para deixar seus arquivos Word um pouco mais polidos! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/portuguese/net/programming-with-txtsaveoptions/_index.md b/words/portuguese/net/programming-with-txtsaveoptions/_index.md index d9e7d6cb39..b36c65dfe2 100644 --- a/words/portuguese/net/programming-with-txtsaveoptions/_index.md +++ b/words/portuguese/net/programming-with-txtsaveoptions/_index.md @@ -27,6 +27,7 @@ Graças a estes tutoriais, você poderá explorar ao máximo as funcionalidades | [Adicionar marcas Bidi em um documento do Word](./add-bidi-marks/) | Aprenda a adicionar marcas bidirecionais (Bidi) em documentos do Word usando o Aspose.Words para .NET com este guia. Garanta a direção correta do texto para conteúdo multilíngue. | | [Use o caractere de tabulação por nível para recuo de lista](./use-tab-character-per-level-for-list-indentation/) | Aprenda a criar listas multinível com recuo por tabulação usando o Aspose.Words para .NET. Siga este guia para obter uma formatação precisa de listas em seus documentos. | | [Use caractere de espaço por nível para recuo de lista](./use-space-character-per-level-for-list-indentation/) | Aprenda a criar listas multinível com recuo de caracteres de espaço no Aspose.Words para .NET. Guia passo a passo para formatação precisa de documentos. | +| [Salvar docx como txt – Guia completo para exportar equações do Word para LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Aprenda a converter documentos docx em arquivos txt preservando equações do Word e exportando-as para LaTeX usando Aspose.Words para .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/portuguese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/portuguese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..e9aeb13c93 --- /dev/null +++ b/words/portuguese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,245 @@ +--- +category: general +date: 2026-03-27 +description: Salve docx como txt com Aspose.Words e converta Word para LaTeX. Aprenda + como exportar equações, manter texto simples e obter marcação LaTeX em minutos. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: pt +og_description: Salve docx como txt usando Aspose.Words. Este guia mostra como converter + Word para LaTeX, exportar equações e manter seu documento em texto simples. +og_title: Salvar docx como txt – Exportar equações do Word para LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Salvar docx como txt – Guia completo para exportar equações do Word para LaTeX +url: /pt/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Salvar docx como txt – Exportar Equações do Word para LaTeX + +Já precisou **salvar docx como txt** mas temia perder a matemática avançada que está dentro do seu arquivo Word? Você não está sozinho. Em muitos fluxos de trabalho científicos a versão em texto puro de um documento é indispensável, porém ainda se deseja que as equações sobrevivam como marcação LaTeX limpa. + +Neste tutorial vamos percorrer passo a passo as etapas exatas para **converter Word para LaTeX** usando Aspose.Words for .NET, de modo que suas equações sejam exportadas corretamente enquanto o restante do documento se torna texto simples bem organizado. Ao final, você saberá como **exportar equações para LaTeX**, manter o resto do arquivo como texto simples e evitar as armadilhas comuns que atrapalham iniciantes. + +## O que você vai aprender + +- Como carregar um arquivo *.docx* que contém Office Math. +- Configurar o `TxtSaveOptions` correto para que o Aspose gere LaTeX para cada equação. +- Salvar o resultado como um arquivo **save word plain text** que pode ser usado em controle de versão, pipelines CI ou qualquer ferramenta downstream. +- Casos de borda comuns — o que fazer quando um documento mistura imagens e equações, ou quando você precisa preservar caracteres Unicode. +- Um exemplo completo, pronto‑para‑executar, que você pode inserir em um aplicativo console. + +### Pré‑requisitos + +- .NET 6.0 ou superior (o código também funciona com .NET Framework 4.7+). +- Uma cópia licenciada do **Aspose.Words for .NET** (a versão de avaliação gratuita serve para testes). +- Visual Studio 2022 ou qualquer IDE que compile projetos C#. +- Um documento Word (`input.docx`) que já contenha alguns objetos Office Math. + +> **Dica de especialista:** Se ainda não tem uma licença, você pode solicitar uma chave temporária no site da Aspose — basta substituir o placeholder no código pela sua chave antes de executar. + +## Etapa 1 – Instalar Aspose.Words via NuGet + +Primeiro de tudo: você precisa da biblioteca no seu projeto. Abra o **Package Manager Console** e execute: + +```powershell +Install-Package Aspose.Words +``` + +Essa única linha traz tudo que você precisa, inclusive o namespace `Saving` onde o `TxtSaveOptions` está localizado. Sem DLLs extras, sem dependências nativas — apenas código gerenciado puro. + +## Etapa 2 – Carregar o Documento Word de origem + +Agora realmente lemos o arquivo que contém as equações. A classe `Document` abstrai toda a estrutura *.docx*, permitindo tratá‑la como um modelo de objeto de alto nível. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Por que isso importa:** Carregar o documento antecipadamente permite inspecionar sua árvore de nós. Se você pular essa verificação e o arquivo não contiver equações, ainda obterá um txt limpo — mas não saberá por que a saída LaTeX está vazia. + +## Etapa 3 – Configurar TxtSaveOptions para Exportação LaTeX + +Aspose oferece controle fino sobre como o Office Math é renderizado. Definindo `OfficeMathExportMode` para `LaTeX`, cada equação é convertida para seu equivalente LaTeX em vez de ser removida ou transformada em imagem. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Por que isso importa:** O modo de exportação padrão descartaria as equações completamente. Trocar para `LaTeX` preserva a intenção matemática, exatamente o que você precisa quando, mais tarde, alimentar o arquivo a um compilador LaTeX ou a um processador markdown que entende a sintaxe `$…$`. + +## Etapa 4 – Salvar o Documento como Texto Simples + +Com as opções configuradas, persistir o arquivo é uma única linha. A saída será um arquivo `.txt` onde cada equação aparece como código LaTeX cercado por delimitadores `$` (você pode mudar isso depois, se preferir blocos `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Resultado esperado + +Abra `output.txt` em qualquer editor e você verá algo como: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Observe como o texto regular permanece exatamente como estava, enquanto as equações agora são strings LaTeX puras. Você pode copiar‑colar diretamente em um documento LaTeX, em um notebook Jupyter ou em qualquer ferramenta que renderize matemática. + +## Etapa 5 – Tratamento de Casos de Borda + +### Conteúdo misto (Imagens + Equações) + +Se seu arquivo Word também contém imagens, o Aspose as ignorará ao usar `TxtSaveOptions`. Isso costuma ser suficiente para um fluxo **save word plain text**, mas se precisar das imagens como placeholders, você pode: + +1. Exportar o documento para HTML primeiro (`HtmlSaveOptions`) para capturar imagens como tags ``. +2. Executar uma segunda passagem com `TxtSaveOptions` para obter as equações LaTeX. +3. Mesclar os dois resultados manualmente ou com um pequeno script. + +### Símbolos Unicode + +Algumas equações utilizam caracteres Unicode especiais (por exemplo, letras gregas). Definir `Encoding = Encoding.UTF8` em `TxtSaveOptions` (conforme mostrado na Etapa 3) garante que esses símbolos sobrevivam à conversão. + +### Documentos grandes + +Para arquivos massivos (> 100 MB), considere fazer streaming da operação de salvamento: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +O streaming evita carregar toda a saída na memória, o que pode ser um salva‑vidas em agentes de build com pouca memória. + +## Exemplo completo em funcionamento + +A seguir está o programa completo, pronto‑para‑copiar‑colar, que une tudo. Basta substituir os caminhos dos arquivos e, se houver, a linha de licença. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Execute o programa (`dotnet run` se estiver usando um projeto console) e verifique `output.txt`. Você acabou de **salvar docx como txt** preservando cada equação como LaTeX — sem necessidade de copiar‑colar manual. + +## Perguntas Frequentes + +**P: Posso mudar o delimitador de `$…$` para `\(...\)`?** +R: Sim. Após salvar, execute um simples replace no arquivo: `output = output.Replace("$", @"\(").Replace("$", @"\)");` — apenas tome cuidado para não substituir caracteres `$` que já fazem parte do texto original. + +**P: Isso funciona com arquivos Word 2007‑2019?** +R: Absolutamente. Aspose.Words suporta `.doc`, `.docx`, `.docm` e até a família mais recente `.dotx`. O mesmo código funciona em todas as versões. + +**P: E se eu precisar manter a formatação original dos parágrafos (tabulações, múltiplos espaços)?** +R: Defina `txtSaveOptions.PreserveTableLayout = true;` e `txtSaveOptions.PreserveSpace = true;` para manter o espaço em branco intacto. + +## Conclusão + +Cobremos tudo que você precisa para **salvar docx como txt** enquanto **exporta equações para LaTeX** usando Aspose.Words. Os passos chave são carregar o documento, configurar `TxtSaveOptions` com `OfficeMathExportMode.LaTeX` e salvar o resultado. Com essas três linhas de código você pode converter Word para LaTeX de forma confiável, manter seu documento como **save word plain text** e evitar a temida perda de símbolos matemáticos. + +Pronto para o próximo desafio? Experimente encadear esse fluxo com um gerador markdown para produzir um arquivo `.md` completo que inclua texto e LaTeX — perfeito para documentação versionada em Git ou geradores de sites estáticos. Ou explore `PdfSaveOptions` da Aspose para obter uma versão PDF ao lado do arquivo de texto simples. + +Se encontrar algum obstáculo, deixe um comentário abaixo. Boa codificação e aproveite a simplicidade de transformar equações do Word em LaTeX limpo! + +![Ilustração de salvar um DOCX como TXT com equações LaTeX](placeholder-image.png "exemplo de salvar docx como txt") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/portuguese/net/working-with-fonts/_index.md b/words/portuguese/net/working-with-fonts/_index.md index 36022e3fdb..5cd20a6989 100644 --- a/words/portuguese/net/working-with-fonts/_index.md +++ b/words/portuguese/net/working-with-fonts/_index.md @@ -27,7 +27,7 @@ Quer você queira formatar texto com fontes diferentes, definir regras de substi | --- | --- | | [Formatação de fonte](./font-formatting/) | Aprenda a formatar fontes em documentos do Word usando o Aspose.Words para .NET com um guia detalhado passo a passo. | | [Obter espaçamento entre linhas de fonte](./get-font-line-spacing/) | Aprenda como obter espaçamento entre linhas de fonte usando o Aspose.Words para .NET com este tutorial passo a passo. Perfeito para desenvolvedores. | -| [Verifique o efeito de texto do DrawingML](./check-drawingml-text-effect/) Aprenda a verificar os efeitos de texto do DrawingML em documentos do Word usando o Aspose.Words para .NET com nosso guia passo a passo detalhado. Aprimore seus documentos com facilidade. | +| [Verifique o efeito de texto do DrawingML](./check-drawingml-text-effect/) Aprenda a verificar os efeitos texto do DrawingML em documentos do Word usando o Aspose.Words para .NET com nosso guia passo a passo detalhado. Aprimore seus documentos com facilidade. | | [Definir formatação de fonte](./set-font-formatting/) | Aprenda a definir a formatação de fontes em documentos do Word usando o Aspose.Words para .NET. Siga nosso guia passo a passo detalhado para aprimorar a automação de seus documentos. | | [Definir marca de ênfase da fonte](./set-font-emphasis-mark/) | Aprenda a definir marcas de ênfase de fonte em documentos do Word usando o Aspose.Words para .NET com este guia passo a passo detalhado. Perfeito para desenvolvedores .NET. | | [Definir pastas de fontes](./set-fonts-folders/) | Aprenda a definir pastas de fontes personalizadas no Aspose.Words para .NET com este guia passo a passo abrangente. Perfeito para desenvolvedores que buscam aprimorar fontes em documentos. | @@ -40,7 +40,7 @@ Quer você queira formatar texto com fontes diferentes, definir regras de substi | [Definir pastas de fontes com prioridade](./set-fonts-folders-with-priority/) | Aprenda a definir pastas de fontes com prioridade em documentos do Word usando o Aspose.Words para .NET. Nosso guia garante que seus documentos sejam renderizados perfeitamente sempre. | | [Definir pasta de fontes True Type](./set-true-type-fonts-folder/) | Aprenda a definir uma pasta de fontes True Type em documentos do Word usando o Aspose.Words para .NET. Siga nosso guia passo a passo detalhado para garantir um gerenciamento consistente de fontes. | | [Especificar fonte padrão ao renderizar](./specify-default-font-when-rendering/) | Aprenda a especificar uma fonte padrão ao renderizar documentos do Word usando o Aspose.Words para .NET. Garanta a consistência da aparência do documento em todas as plataformas. | -| [Configurações de fonte com opções de carregamento](./font-settings-with-load-options/) Aprenda a gerenciar as configurações de fonte com opções de carregamento no Aspose.Words para .NET. Guia passo a passo para desenvolvedores garantirem a consistência da aparência da fonte em documentos do Word. +| [Configurações de fonte com opções de carregamento](./font-settings-with-load-options/) Aprenda a gerenciar as configurações de fonte com opções de carregamento no Aspose.Words para .NET. Guia passo a passo para desenvolvedores garantirem a consistência da aparência da fonte em documentos do Word. | | [Definir pasta de fontes](./set-fonts-folder/) | Aprenda como definir uma pasta de fontes personalizada no Aspose.Words para .NET para garantir que seus documentos do Word sejam renderizados corretamente, sem fontes ausentes. | | [Configurações de fonte Instância padrão](./font-settings-default-instance/) | Neste tutorial, aprenda a configurar as configurações de fonte padrão em um documento do Word com o Aspose.Words para .NET. | | [Obtenha a lista de fontes disponíveis](./get-list-of-available-fonts/) | Descubra como obter uma lista de fontes disponíveis usando o Aspose.Words para .NET neste tutorial passo a passo detalhado. Aprimore suas habilidades de gerenciamento de fontes. | @@ -48,7 +48,7 @@ Quer você queira formatar texto com fontes diferentes, definir regras de substi | [Receber notificação de aviso](./receive-warning-notification/) Aprenda como receber uma notificação de aviso ao usar o Aspose.Words para .NET e gerencie quaisquer problemas ou avisos em seus documentos. | | [Exemplo de fonte de fonte do Resource Steam](./resource-steam-font-source-example/) | Aprenda a usar o Resource Stream Font Source para carregar fontes personalizadas no Aspose.Words para .NET. | | [Obtenha substituição sem sufixos](./get-substitution-without-suffixes/) | Neste tutorial, aprenda como obter substituições sem sufixo em um documento do Word com o Aspose.Words para .NET. | - +| [Substituição de Fonte Aspose – Como Configurar Configurações de Fonte em C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Aprenda a configurar as configurações de substituição de fontes no Aspose.Words para .NET usando C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/portuguese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/portuguese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..42e2b533b3 --- /dev/null +++ b/words/portuguese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,250 @@ +--- +category: general +date: 2026-03-27 +description: 'Substituição de fontes Aspose facilitada: aprenda a configurar as definições + de fontes, capturar avisos e lidar com fontes ausentes em seus aplicativos .NET.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: pt +og_description: Domine a substituição de fontes Aspose configurando as definições + de fonte e tratando fontes ausentes com um callback de aviso. Guia completo em C#. +og_title: Substituição de Fonte Aspose – Configurar Configurações de Fonte em C# +tags: +- Aspose.Words +- C# +- Font Management +title: Substituição de Fonte Aspose – Como Configurar as Configurações de Fonte em + C# +url: /pt/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Guia Completo para Configurar Configurações de Fonte + +Já se deparou com um documento que de repente troca sua tipografia personalizada por algo genérico? Isso é **aspose font substitution** fazendo seu trabalho — substituindo fontes ausentes pela correspondência mais próxima que consegue encontrar. É útil, mas se você precisar saber *exatamente* qual fonte foi trocada, precisará acessar o sistema de avisos da biblioteca e configurar as configurações de fonte manualmente. + +Neste tutorial vamos percorrer um cenário real: carregar um DOCX que referencia uma fonte que você não possui, capturar o evento de substituição e imprimir uma mensagem amigável no console. Ao final, você estará confortável com **configure font settings**, configurando um **Aspose.Words warning callback**, e estendendo o exemplo para se adequar a qualquer fluxo de trabalho. + +> **O que você precisará** +> • .NET 6+ (ou .NET Framework 4.7.2+) +> • Aspose.Words for .NET (último NuGet) +> • Um DOCX que referencia uma fonte ausente (vamos chamá‑lo de `MissingFont.docx`) + +Vamos mergulhar. + +--- + +## Step 1: Install Aspose.Words and Prepare the Project + +Antes de escrever qualquer código, certifique‑se de que o pacote Aspose.Words está referenciado: + +```bash +dotnet add package Aspose.Words +``` + +> **Dica profissional:** Use a versão estável mais recente; a partir de março 2026 é 23.11.0. Versões mais novas melhoram os algoritmos de correspondência de fontes e adicionam tipos extras de avisos. + +Crie um novo aplicativo de console (ou insira o código em um projeto existente) e adicione as diretivas `using` habituais: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Esses namespaces nos dão acesso ao `Document`, `LoadOptions` e às classes relacionadas a fontes que precisaremos. + +--- + +## Step 2: Configure Font Settings with LoadOptions + +O coração do controle de **aspose font substitution** está em `LoadOptions.FontSettings`. Ao fornecer um objeto `FontSettings` vazio, instruímos o Aspose a usar seus caminhos de pesquisa padrão *e* a relatar qualquer substituição via um callback de aviso. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Por que não confiar apenas nos padrões? Porque anexar um callback de aviso (próximo passo) só funciona quando a propriedade `FontSettings` não é nula. Essa linha diminuta nos dá um ponto de conexão ao processo de substituição sem alterar o comportamento real de busca de fontes. + +--- + +## Step 3: Attach a Warning Callback to Capture Substitutions + +Aspose.Words implementa a interface `IWarningCallback`. Sempre que algo relevante acontece — como uma fonte ausente — ele chama nosso método `Warning`. Implementaremos um manipulador pequeno que filtra por `WarningType.FontSubstitution` e imprime a descrição. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +E aqui está o próprio manipulador: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Por que isso importa** – Sem o callback, o Aspose troca fontes silenciosamente, e você nunca sabe qual foi usada. O callback torna o processo transparente, o que é essencial para relatórios de conformidade ou para depuração de problemas de layout. + +--- + +## Step 4: Load the Document Using the Configured Options + +Agora finalmente carregamos o documento, passando o `loadOptions` que acabamos de preparar. Se o arquivo de origem referencia uma fonte que não está instalada, nosso manipulador será acionado. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Substitua `YOUR_DIRECTORY` pelo caminho real onde o `MissingFont.docx` está localizado. Quando você executar o programa, deverá ver uma saída semelhante a: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Essa linha informa exatamente qual fonte estava ausente e qual substituta o Aspose escolheu. + +--- + +## Step 5: (Optional) Fine‑Tune Font Search Paths + +Se você possui uma pasta privada com fontes corporativas, pode dizer ao Aspose onde procurar antes que ele recorra às fontes do sistema. Este é um uso avançado de **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Definir `recursive: true` faz o Aspose varrer subpastas também. Agora a biblioteca tentará suas fontes privadas primeiro, reduzindo a chance de substituição indesejada. + +--- + +## Full Working Example + +Juntando tudo, aqui está o programa completo, pronto‑para‑executar: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Saída esperada** (quando uma fonte ausente é encontrada): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Se todas as fontes estiverem presentes, o programa roda silenciosamente (sem avisos) e ainda produz o PDF. + +--- + +## Common Questions & Edge Cases + +### O que fazer se eu precisar *impedir* a substituição completamente? + +Defina `FontSettings.SubstitutionSettings` como `null` ou use `FontSettings.FontSubstitutionSettings` para controlar o comportamento. Por exemplo: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Agora o Aspose lançará uma exceção em vez de substituir silenciosamente, a qual pode ser capturada e tratada. + +### Isso funciona com outros formatos de arquivo (ex.: .doc, .rtf)? + +Absolutamente. O mesmo objeto `LoadOptions` pode ser passado para qualquer construtor `Document` que aceite um caminho de arquivo. O callback de aviso será disparado para todos os formatos que dependem de fontes. + +### Posso capturar o nome exato da fonte de substituição? + +Sim. A string `info.Description` contém tanto a fonte ausente quanto a de substituição. Se precisar do nome programaticamente, pode analisá‑la ou usar o objeto `FontInfo` (disponível em versões mais recentes). + +### Como isso se comporta em um ambiente multithread? + +`FontSettings` **não** é thread‑safe. Crie um `LoadOptions` separado (com seu próprio `FontSettings`) por thread, ou proteja o acesso com um lock. + +--- + +## Conclusion + +Cobremos tudo o que você precisa para dominar **aspose font substitution** e **configure font settings** em uma aplicação C#: + +1. Instale o Aspose.Words e adicione as declarações `using` necessárias. +2. Crie um objeto `LoadOptions` com um `FontSettings` novo. +3. Anexe um `IWarningCallback` personalizado para expor eventos de substituição. +4. Carregue o documento, permitindo que o callback relate quaisquer fontes ausentes. +5. (Opcional) Amplie o caminho de busca ou desative a substituição totalmente. + +Com esse padrão, você pode registrar fontes ausentes para conformidade, alertar usuários em uma UI, ou incorporar fontes de fallback automaticamente antes da publicação. Em seguida, você pode explorar **políticas de substituição de fontes do Aspose.Words** ou integrar o fluxo de trabalho a um pipeline maior de processamento de documentos. + +Feliz codificação, e que seus documentos sempre renderizem com a tipografia correta! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/russian/net/basic-conversions/_index.md b/words/russian/net/basic-conversions/_index.md index 43375dc72d..f093e64bcd 100644 --- a/words/russian/net/basic-conversions/_index.md +++ b/words/russian/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ Basic Conversions проведет вас через базовые преобр | [Как экспортировать LaTeX из Word – пошаговое руководство](./how-to-export-latex-from-word-step-by-step-guide/) | Узнайте, как экспортировать документ Word в LaTeX с помощью Aspose.Words для .NET, следуя пошаговому руководству. | | [Конвертировать Word в PDF в C# с Aspose.Words – Руководство](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Узнайте, как конвертировать Word в PDF в C# с помощью Aspose.Words. Пошаговое руководство для разработчиков. | | [Сохранить Word как PDF с Aspose.Words – Полное руководство C#](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Узнайте, как сохранить документ Word в PDF с помощью Aspose.Words в C#. Подробное руководство с примерами кода. | +| [Конвертировать Word в PDF с Aspose.Words – Полное руководство](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Узнайте, как полностью конвертировать документы Word в PDF с помощью Aspose.Words в C#. Подробное руководство с примерами кода. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/russian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/russian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..770e960660 --- /dev/null +++ b/words/russian/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-03-27 +description: Быстро преобразуйте Word в PDF с помощью Aspose.Words. Узнайте, как сохранить + документ Word в PDF, экспортировать DOCX в PDF и создавать доступные PDF в C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: ru +og_description: Конвертировать Word в PDF в C# с помощью Aspose.Words. Это руководство + показывает, как сохранить документ Word в PDF, экспортировать DOCX в PDF и создавать + доступные PDF. +og_title: Конвертировать Word в PDF с Aspose.Words – пошагово +tags: +- Aspose.Words +- C# +- PDF conversion +title: Конвертировать Word в PDF с помощью Aspose.Words – Полное руководство +url: /ru/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Конвертация Word в PDF с Aspose.Words – Полное руководство + +Когда‑нибудь задумывались, как **конвертировать Word в PDF** без использования сторонних веб‑инструментов? Возможно, вы создаёте автоматический движок отчётов и вам нужен надёжный способ *save word as pdf* «на лету». Хорошая новость: Aspose.Words делает весь процесс простым, и вы даже можете получить файл, соответствующий **PDF/UA‑2** — идеально для требований доступности. + +В этом руководстве мы пройдём всё необходимое: загрузка `.docx`, настройка параметров PDF для *export docx to pdf* с соблюдением PDF/UA, и окончательное сохранение результата как доступного PDF. К концу вы получите автономный, готовый к продакшну фрагмент кода, который можно вставить в любой .NET‑проект. + +![Конвертировать Word в PDF с помощью Aspose.Words](convert-word-to-pdf.png) + +## Что вы узнаете + +- **Почему Aspose.Words** — надёжный выбор для сценариев *generate accessible pdf*. +- Точные шаги для *save document as pdf* с соблюдением PDF/UA‑2. +- Как обрабатывать типичные крайние случаи, такие как отсутствие шрифтов или защищённые паролем исходные файлы. +- Быстрые советы по отладке вывода и проверке соответствия доступности. + +### Предварительные требования + +- .NET 6 или новее (API также работает на .NET Framework 4.6+). +- Действительная лицензия Aspose.Words for .NET (бесплатная пробная версия подходит для оценки). +- Базовые знания C# — никаких сложных шаблонов не требуется. + +Если все пункты отмечены, приступаем. + +--- + +## Конвертация Word в PDF – пошаговая реализация + +Разделим решение на пять чётких шагов. Каждый шаг имеет заголовок, короткий фрагмент кода и объяснение *почему* этот код важен. + +### Шаг 1: Загрузка документа Word, который нужно конвертировать + +Первое, что нужно — объект `Document`, представляющий исходный файл. Aspose.Words читает **.docx**, **.doc**, **.rtf** и многие другие форматы, так что вы можете *save word as pdf* независимо от того, как файл был изначально создан. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Почему это важно:** +- Загрузка файла на раннем этапе позволяет отловить ошибки отсутствующего файла до того, как будут потрачены ресурсы процессора. +- Класс `Document` абстрагирует внутреннюю структуру Word‑файла, предоставляя чистую объектную модель для работы. + +### Шаг 2: Настройка параметров сохранения PDF для доступности + +Если вам нужно *generate accessible pdf*, необходимо указать Aspose.Words создавать документ, соответствующий PDF/UA‑2. Класс `PdfSaveOptions` даёт тонкую настройку вывода. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Почему это важно:** +- `PdfCompliance.PdfUa2` инструктирует библиотеку добавить необходимые теги, структуру и метаданные, которые используют скрин‑ридеры. +- Встраивание шрифтов (`EmbedFullFonts = true`) предотвращает неприятные предупреждения «font not found», когда PDF открывается на другой ОС. +- Установка `Title` помогает вспомогательным технологиям правильно объявлять документ. + +### Шаг 3: Сохранение документа как PDF + +Теперь, когда источник загружен и параметры заданы, сама конвертация — однострочник. Здесь вы *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Почему это важно:** +- Метод `Save` учитывает настроенные `PdfSaveOptions`, гарантируя включение функций доступности. +- Оборачивание вызова в `try/catch` даёт возможность залогировать или вывести ошибки лицензирования или прав доступа, которые часто ставят новичков в тупик. + +### Шаг 4: Проверка соответствия PDF/UA (необязательно, но рекомендуется) + +Хотя Aspose.Words делает большую часть работы, полезно дважды проверить результат, особенно когда документы передаются государственным учреждениям или другим регулируемым организациям. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Почему это важно:** +- `IsTagged` — быстрая проверка; полная валидация PDF/UA требует отдельного валидатора, но большинство проблем доступности проявляются как отсутствие тегов. +- Если флаг возвращает `false`, вернитесь к `PdfSaveOptions` — возможно, вы забыли установить `Compliance` или исходный документ не содержит правильных стилей заголовков. + +### Шаг 5: Распространённые подводные камни и профессиональные советы + +| Подводный камень | Что происходит | Как исправить | +|------------------|----------------|----------------| +| **Отсутствие шрифтов** | Текст в PDF отображается в виде коробок. | Установите `EmbedFullFonts = true` **или** установите недостающие шрифты на сервере. | +| **Библиотека без лицензии** | Aspose добавляет водяной знак на каждую страницу. | Добавьте файл лицензии (`Aspose.Words.lic`) в начале приложения (например, `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Защищённый паролем источник** | `InvalidOperationException` при `new Document(path)`. | Используйте перегрузку `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Большие документы вызывают OOM** | Исключение «Out‑of‑memory» при работе с огромными файлами. | Включите `MemoryOptimization` в `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Отсутствуют теги доступности** | Валидация PDF/UA не проходит. | Убедитесь, что исходный Word‑файл использует правильные стили заголовков (`Heading 1`, `Heading 2` и т.д.) — Aspose автоматически сопоставляет их с PDF‑тегами. | + +**Профессиональный совет:** При пакетной конвертации множества документов переиспользуйте один экземпляр `PdfSaveOptions`. Создание его один раз снижает накладные расходы на выделение памяти и уменьшает общий объём используемых ресурсов. + +--- + +## Полный рабочий пример (готов к копированию) + +Ниже представлен полный код программы, объединяющий всё вышеописанное. Сохраните его как `Program.cs`, добавьте пакеты NuGet Aspose.Words и Aspose.PDF, и запустите. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Ожидаемый результат:** +В каталоге `C:\MyFiles` появится файл `output.pdf`. Открыв его в Adobe Acrobat, вы увидите «PDF/A‑2b, PDF/UA‑1» в панели соответствия, подтверждая, что вы успешно *convert word to pdf*. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/russian/net/programming-with-markdownsaveoptions/_index.md b/words/russian/net/programming-with-markdownsaveoptions/_index.md index 4be0115f6d..590f80fe2a 100644 --- a/words/russian/net/programming-with-markdownsaveoptions/_index.md +++ b/words/russian/net/programming-with-markdownsaveoptions/_index.md @@ -32,6 +32,9 @@ | [Как экспортировать Markdown из Word – Полное руководство C#](./how-to-export-markdown-from-word-complete-c-guide/) | Полное руководство по экспорту Markdown из Word с использованием C# и Aspose.Words. | | [Как сохранить Markdown из DOCX – пошаговое руководство](./how-to-save-markdown-from-docx-step-by-step-guide/) | Подробное руководство по сохранению документа DOCX в формате Markdown с пошаговыми инструкциями на C#. | | [Как экспортировать Markdown из DOCX – Полное руководство](./how-to-export-markdown-from-docx-complete-guide/) | Полное руководство по экспорту Markdown из DOCX с использованием Aspose.Words для .NET. | +| [Как экспортировать LaTeX из Word – Конвертировать DOCX в Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) | Экспортируйте LaTeX из Word в формат Markdown, конвертируя DOCX с помощью Aspose.Words для .NET. | +| [Создать markdown из Word – Полное руководство C#](./create-markdown-from-word-full-c-guide/) | Полное руководство по созданию Markdown из Word с помощью C# и Aspose.Words. | +| [Как экспортировать LaTeX из DOCX – Конвертировать в Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) | Экспортируйте LaTeX из DOCX в формат Markdown с помощью Aspose.Words для .NET. Подробное руководство по конвертации. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/russian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/russian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..1131112761 --- /dev/null +++ b/words/russian/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Создайте markdown из Word с помощью Aspose.Words C#. Узнайте, как конвертировать + docx в markdown, извлекать изображения из Word и как использовать обратный вызов + в одном учебнике. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: ru +og_description: Создайте markdown из Word с помощью Aspose.Words. Это руководство + показывает, как конвертировать docx в markdown, извлекать изображения из Word и + использовать обратный вызов для обработки ресурсов. +og_title: Создайте markdown из Word – Полный учебник по C# +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Создание markdown из Word – Полное руководство по C# +url: /ru/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Создание markdown из Word – Полный C#‑урок + +Когда‑то вам нужно **создать markdown из Word**, но вы не знаете, с чего начать? Вы не одиноки; многие разработчики сталкиваются с этой проблемой, пытаясь перенести содержимое из файла .docx в генератор статических сайтов или репозиторий документации. Хорошая новость? С помощью Aspose.Words вы можете **конвертировать docx в markdown**, извлечь все изображения из исходного файла и точно контролировать, куда эти ресурсы будут сохраняться — всё это с помощью простого обратного вызова. + +В этом руководстве мы пройдём реальный пример, показывающий, как извлекать изображения из Word, как использовать обратный вызов для их сохранения и почему такой подход является самым надёжным для автоматизационных конвейеров. К концу вы получите готовую к запуску программу на C#, которая создаёт чистый файл `.md` и папку с извлечёнными изображениями. + +> **Pro tip:** Если у вас уже есть шаблон Word, содержащий скриншоты, схемы или логотипы, этот метод сохранит каждый визуальный элемент без необходимости копировать‑вставлять вручную. + +--- + +## Что понадобится + +- **.NET 6+** (или .NET Framework 4.6+). Код работает на любой современной платформе. +- **Aspose.Words for .NET** (NuGet‑пакет `Aspose.Words`). Бесплатная пробная версия подходит для большинства сценариев. +- **Документ Word** (`input.docx`), содержащий текст и хотя бы одно изображение. +- Базовое понимание C# и Visual Studio (или вашей любимой IDE). + +Дополнительные библиотеки не требуются — всё остальное обрабатывается самим Aspose.Words. + +--- + +## Шаг 1: Создание проекта и установка Aspose.Words + +Чтобы всё было аккуратно, создайте новый консольный проект: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Почему это важно:** Установка NuGet‑пакета гарантирует, что у вас самая свежая API, включающая класс `MarkdownSaveOptions`, появившийся в версии 22.9. Без него пришлось бы писать собственный конвертер. + +--- + +## Шаг 2: Загрузка исходного документа Word + +Первая строка кода открывает `.docx`, который вы хотите преобразовать. Замените `YOUR_DIRECTORY` на реальный путь на вашем компьютере. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Что происходит?** `Document` разбирает файл, строит внутреннее DOM‑дерево и делает каждый абзац, таблицу и изображение доступными. Если файл отсутствует, Aspose бросает понятное `FileNotFoundException`, которое можно перехватить для более дружелюбного UI. + +--- + +## Шаг 3: Настройка параметров сохранения Markdown с обратным вызовом сохранения ресурсов + +Здесь вступает в действие магия **how to use callback**. Обратный вызов позволяет решить, куда сохранять каждое извлечённое изображение. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Зачем нужен обратный вызов?** По умолчанию Aspose внедряет изображения как строки base‑64 внутри markdown — это кошмар для систем контроля версий. Обратный вызов даёт полный контроль над именами файлов и структурой папок. + +--- + +## Шаг 4: Сохранение документа в формате Markdown + +Теперь мы действительно генерируем файл `.md`. Все изображения будут переданы в обратный вызов, определённый на следующем шаге. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Если всё прошло успешно, вы найдёте `Document.md` в целевой папке и подпапку `Resources` с каждым изображением, извлечённым из исходного Word‑файла. + +--- + +## Шаг 5: Реализация обратного вызова, сохраняющего каждое извлечённое изображение + +Ниже полная реализация `MyResourceSaver`. Она создаёт каталог `Resources` (если его нет), формирует уникальное имя файла для каждого изображения и записывает поток изображения на диск. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Пояснение аргументов:** +> - `args.Index` — нумерация с нуля, гарантирующая уникальность. +> - `args.FileName` — исходное имя файла, предлагаемое Aspose (обычно что‑то вроде `image001.png`). +> - `args.Stream` — выходной поток, в который записываются байты изображения. +> - `args.KeepResourceStreamOpen` — установлено в `false`, чтобы Aspose автоматически освобождал поток, предотвращая утечки дескрипторов файлов. + +--- + +## Полный рабочий пример + +Объединив всё вместе, получаем один файл, который можно скопировать в `Program.cs`. Не забудьте заменить `YOUR_DIRECTORY` на абсолютный или относительный путь, подходящий вашей среде. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Ожидаемый результат + +- `YOUR_DIRECTORY/Document.md` — markdown‑файл со стандартными ссылками на изображения, например: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` — содержит `img_0.png`, `img_1.jpg` и т.д., в том порядке, в каком они встречались в оригинальном документе Word. + +Запуск программы выводит дружелюбное подтверждение, информирующее о успешном завершении процесса. + +--- + +## Часто задаваемые вопросы (FAQ) + +### Как извлечь изображения из Word без потери качества? + +Обратный вызов записывает необработанный бинарный поток напрямую в файл, сохраняя оригинальное разрешение. Преобразование или сжатие происходит только если вы добавите собственную логику обработки изображений внутри `ResourceSaving`. + +### Можно ли изменить формат изображения (например, PNG → JPEG) при извлечении? + +Конечно. Внутри `ResourceSaving` вы можете проанализировать `args.FileName` или `args.Stream`, загрузить изображение через `System.Drawing` или `ImageSharp`, затем перекодировать его перед записью. Не забудьте обновить расширение ссылки в markdown соответственно. + +### Что если мне нужны markdown‑файлы, ссылающиеся на CDN вместо локальной папки? + +Измените обратный вызов, добавив базовый URL к markdown‑ссылке. Это можно сделать, установив `args.FileName` в полностью квалифицированный URL после загрузки изображения на ваш CDN. + +### Работает ли это с таблицами, сносками и другими продвинутыми функциями Word? + +Да. Aspose.Words переводит большинство конструкций Word в эквиваленты markdown. Таблицы становятся markdown‑таблицами, сноски — ссылками‑сносками, вложенные списки обрабатываются корректно. Если что‑то выглядит странно, проверьте примечания к последнему релизу — Aspose постоянно улучшает точность конвертации. + +### Как конвертировать docx в markdown в CI/CD‑конвейере? + +Просто добавьте скомпилированный `.exe` в шаги сборки, укажите ему путь к сгенерированным `.docx` артефактам и отправьте полученные `.md` и папку `Resources/` в репозиторий статического сайта. Поскольку процесс полностью детерминирован, он отлично подходит для автоматизированных сред. + +--- + +## Подведение итогов + +Мы продемонстрировали, как **создать markdown из Word** с помощью Aspose.Words, рассмотрели весь процесс **convert docx to markdown** и показали практический способ **extract images from Word** с помощью пользовательской реализации **how to use callback**. В результате получаем чистый markdown‑файл и папку с оригинальными изображениями — идеально для сайтов документации, статических блогов или любого рабочего процесса, предпочитающего текстовые форматы. + +Следующие шаги, которые стоит рассмотреть: + +- **Пакетная обработка** нескольких `.docx` в папке (цикл по `Directory.GetFiles`). +- **Пользовательские схемы именования** изображений (например, используя оригинальный подпись к рисунку). +- **Постобработка** markdown — замена ссылок на изображения URL‑ами CDN. +- Исследование **других форматов экспорта Aspose**, таких как HTML, PDF или EPUB, для многоканального публикации. + +Есть дополнительные вопросы или «упрямый» Word‑файл, который отказывается конвертироваться? Оставьте комментарий ниже, и мы разберёмся вместе. Счастливого кодинга и наслаждайтесь простотой превращения Word в markdown! + +--- + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/russian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/russian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..baeebb423d --- /dev/null +++ b/words/russian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Как экспортировать LaTeX из DOCX с помощью Aspose.Words. Узнайте, как + конвертировать DOCX в Markdown, установить DPI и включить восстановление в C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: ru +og_description: Как экспортировать LaTeX из DOCX с помощью Aspose.Words. Этот учебник + показывает пошаговое преобразование в Markdown, управление DPI и режим восстановления. +og_title: Как экспортировать LaTeX из DOCX — преобразовать в Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Как экспортировать LaTeX из DOCX – преобразовать в Markdown +url: /ru/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как экспортировать LaTeX из DOCX – Конвертировать в Markdown + +Когда‑нибудь задавались вопросом **how to export LaTeX** из DOCX‑файла, не теряя красоты ваших уравнений? Вы не одиноки. По моему опыту, самая большая проблема — это получение объектов OfficeMath в чистый, переносимый формат для генераторов статических сайтов или научных блогов. + +В этом руководстве мы пройдем процесс конвертации DOCX в Markdown с помощью Aspose.Words, одновременно показывая **how to set DPI**, **how to enable recovery** и несколько полезных приёмов для надёжного конвейера. К концу у вас будет одна программа на C#, которая генерирует файл Markdown с уравнениями LaTeX, изображениями высокого разрешения и корректной обработкой гиперссылок. + +## Что понадобится + +- **.NET 6+** (или .NET Framework 4.7.2 – API работает одинаково) +- **Aspose.Words for .NET** (последняя стабильная версия на март 2026) +- DOCX‑файл, содержащий уравнения, изображения и ссылки +- Visual Studio, VS Code или любой предпочитаемый редактор + +Дополнительные пакеты NuGet не требуются, кроме Aspose.Words, но убедитесь, что у вас есть действующая лицензия, если вы не используете пробную версию. + +## Шаг 1 – Загрузка DOCX в режиме строгого восстановления + +Прежде чем думать об экспорте, нам нужно убедиться, что исходный документ не скрывает повреждения. Здесь в игру вступает **how to enable recovery**. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Почему строгий режим восстановления?** +Если позволить Aspose тихо исправлять проблемы, вы можете получить недостающие абзацы или сломанные изображения — то, чего никто не хочет при экспорте LaTeX. При быстром сбое вы сможете обнаружить проблему рано и решить, исправлять ли исходный DOCX или записать проблему для последующего анализа. + +### Совет профессионала +Оберните загрузку в try/catch и логируйте `DocumentLoadingException`. Таким образом ваш CI‑конвейер сможет помечать проблемные файлы, не останавливая всю сборку. + +## Шаг 2 – Настройка параметров экспорта в Markdown + +Теперь, когда документ безопасно загружен в память, мы настраиваем, как он будет сохраняться. Это суть **how to export latex** и также охватывает **how to set DPI** для встроенных изображений. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Что делает каждый параметр** + +| Option | Причина | Связь с ключевыми словами | +|--------|--------|---------------------------| +| `OfficeMathExportMode = LaTeX` | Прямо отвечает на **how to export latex** из уравнений. | Основное ключевое слово | +| `ImageResolution = 300` | Управляет качеством изображения — ответ на **how to set dpi**. | Второстепенное | +| `ResourceSavingCallback` | Сохраняет вложенные файлы на диск, часто требуется при **convert docx to markdown**. | Второстепенное | +| `EmptyParagraphExportMode` | Гарантирует чистый вывод Markdown, предотвращая лишние HTML‑теги. | Улучшает общее качество конвертации | +| `LinkExportMode = AsReference` | Делает ссылки удобными для чтения и редактирования, ещё один плюс для **convert docx to markdown**. | + +## Шаг 3 – Реализация пользовательского сохранителя ресурсов (необязательно, но удобно) + +При конвертации DOCX в Markdown изображения и другие бинарные ресурсы нуждаются в месте в файловой системе. Aspose позволяет управлять этим через `IResourceSavingCallback`. Приведённый выше фрагмент уже показывает минимальную реализацию, но разберём его подробнее: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Зачем это нужно?** +Если пропустить этот шаг, Aspose будет внедрять изображения как строки base‑64, что сильно увеличивает размер файла Markdown и делает работу с системой контроля версий болезненной. Сохраняя ресурсы в отдельную папку, вы делаете Markdown лёгким и удобным для генераторов статических сайтов, таких как Hugo или Jekyll. + +## Шаг 4 – Сохранение документа в формате Markdown + +Вся тяжёлая работа завершена. Одна строка теперь записывает окончательный файл. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Откройте `output.md`, и вы увидите: + +- Уравнения, отформатированные как блоки LaTeX `$…$` +- Изображения, указанные как `![Alt text](resources/image001.png)` с разрешением 300 dpi +- Гиперссылки, преобразованные в ссылочный стиль: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Это весь процесс **how to convert docx** в двух словах. + +## Часто задаваемые вопросы и особые случаи + +### 1️⃣ Что делать, если DOCX содержит неподдерживаемые объекты? +Aspose.Words выбросит `FeatureNotSupportedException`. Поскольку мы использовали **how to enable recovery** в строгом режиме, исключение появляется сразу. Вы можете либо: + +- Переключить `RecoveryMode` на `RecoveryMode.Default` для конвертации с наилучшей попыткой, **или** +- Предварительно обработать DOCX (например, удалить неподдерживаемый SmartArt) перед запуском конвертера. + +### 2️⃣ Можно ли изменить DPI для отдельного изображения? +Настройка `ImageResolution` глобальна. Для управления DPI отдельного изображения реализуйте пользовательский `ImageSavingCallback`, аналогичный `MyResourceSaver`, и изменяйте `args.ImageResolution` в зависимости от `args.ImageFileName` или метаданных. + +### 3️⃣ Как встроить сгенерированный LaTeX в сайт Jekyll? +Встроенная поддержка MathJax в Jekyll работает сразу. Просто убедитесь, что ваш шаблон включает скрипт MathJax, а блоки LaTeX обёрнуты в `$$` для отображаемых уравнений или `$` для встроенных. + +### 4️⃣ Совместимо ли это с .NET Core на Linux? +Абсолютно. Aspose.Words кроссплатформенный. Просто убедитесь, что путь `YOUR_DIRECTORY` соответствует конвенциям Linux (например, `/home/user/docs`). + +## Полный рабочий пример + +Ниже готовая к копированию программа. Замените `YOUR_DIRECTORY` реальным путём на вашей машине. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Ожидаемый результат** — откройте `output.md`, и вы должны увидеть что‑то вроде: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Если открыть файл в просмотрщике Markdown с поддержкой MathJax, интеграл отобразится + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/russian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/russian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..9f4cb06f33 --- /dev/null +++ b/words/russian/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Как экспортировать LaTeX из документов Word с помощью Aspose.Words – + преобразовать DOCX в Markdown с уравнениями в виде LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: ru +og_description: Как экспортировать LaTeX из документов Word объясняется в первом предложении, + показывая, как преобразовать DOCX в Markdown с уравнениями в виде LaTeX. +og_title: Как экспортировать LaTeX из Word – Полное руководство +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Как экспортировать LaTeX из Word — преобразовать DOCX в Markdown +url: /ru/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как экспортировать LaTeX из Word – Преобразовать DOCX в Markdown + +Когда‑нибудь задавались вопросом **как экспортировать LaTeX** из файла Word, не получив кучу PNG‑файлов? Вы не одиноки; разработчики постоянно сталкиваются с этой проблемой, когда им нужны чистые, редактируемые формулы для статических сайтов или научных блогов. Хорошая новость? С Aspose.Words вы можете **конвертировать Word в Markdown** и сохранить каждый объект OfficeMath в виде нативного LaTeX — без пост‑обработки. + +В этом руководстве мы пройдём весь процесс **сохранения документа Word как Markdown** с **экспортом уравнений в LaTeX**. К концу вы получите готовый фрагмент C#, чёткое объяснение каждой опции и советы по работе с краевыми случаями, такими как сложные формулы или смешанное содержимое. Никаких внешних инструментов, только один NuGet‑пакет и несколько строк кода. + +## Что вам понадобится + +- .NET 6+ (или .NET Framework 4.7.2 и выше) — последняя версия среды работает лучше всего. +- Visual Studio 2022 или любой редактор, способный компилировать проекты C#. +- Лицензия Aspose.Words for .NET (бесплатная trial‑версия подходит для экспериментов). +- Файл DOCX, содержащий хотя бы одно уравнение (OfficeMath). + +Если всё это уже есть, отлично — приступаем. + +## Как экспортировать LaTeX из Word – Обзор + +Ниже представлена высокоуровневая схема шагов: + +1. **Установить** пакет Aspose.Words NuGet. +2. **Загрузить** исходный `.docx`, в котором находятся ваши уравнения. +3. **Настроить** `MarkdownSaveOptions`, указав `OfficeMathExportMode = LaTeX`. +4. **Сохранить** документ как файл `.md`. +5. **Проверить**, что сгенерированный Markdown содержит LaTeX‑блоки (`$$…$$`). + +Каждый из этих шагов подробно описан в последующих разделах. + +![Диаграмма, показывающая поток преобразования из DOCX в Markdown с уравнениями LaTeX](how-to-export-latex.png){alt="Диаграмма «Как экспортировать LaTeX из Word»"} + +## Шаг 1 – Установить Aspose.Words for .NET (convert word to markdown) + +Первое, что нужно: библиотека, которая действительно делает тяжёлую работу. Откройте терминал (или Package Manager Console) и выполните: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** Если вы используете Visual Studio, щёлкните правой кнопкой мыши по проекту → *Manage NuGet Packages* → найдите “Aspose.Words” и установите последнюю стабильную версию. + +Почему это важно: Aspose.Words абстрагирует формат Open XML, предоставляя чистый API для работы с документами Word без необходимости разбираться в низкоуровневом XML. Пакет также включает встроенную поддержку преобразования OfficeMath в LaTeX, что является ядром нашей задачи **export equations as LaTeX**. + +## Шаг 2 – Загрузить DOCX (how to convert docx) + +Теперь, когда пакет установлен, загрузите файл, который хотите преобразовать. Замените `YOUR_DIRECTORY` на путь к вашему `.docx`: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Почему именно так?** Конструктор `Document` парсит весь файл в объектную модель, давая мгновенный доступ к абзацам, таблицам и — самое главное — объектам OfficeMath. Если файл отсутствует или повреждён, Aspose бросит информативное `FileNotFoundException`, которое можно перехватить для корректной обработки ошибок. + +## Шаг 3 – Настроить MarkdownSaveOptions (export equations as latex) + +Магия происходит в объекте `MarkdownSaveOptions`. По умолчанию Aspose будет рендерить уравнения как PNG‑изображения, но нам нужен LaTeX. Установите `OfficeMathExportMode` в `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Кратко о дополнительных флагах: `ExportImagesAsBase64` говорит Aspose не встраивать бинарные данные, что делает Markdown чище. `ExportHeadersFooters` гарантирует, что вы не потеряете контекст, находящийся в шапках/подвалах — полезно, когда в заголовке указано название или имя автора. + +## Шаг 4 – Сохранить документ (save word as markdown) + +Наконец, запишите преобразованное содержимое в файл `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +После выполнения этой строки вы найдёте `output.md` рядом с исходным файлом. Откройте его в любом текстовом редакторе, и вы увидите LaTeX‑блоки, выглядящие примерно так: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Это часть **save word as markdown** завершена — никаких дополнительных шагов конвертации не требуется. + +## Шаг 5 – Проверить результат (export equations as latex) + +Легко забыть о проверке, но быстрая sanity‑check экономит часы позже. Запустите простой скрипт, который читает сгенерированный файл и выводит первый LaTeX‑блок: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Если в консоли появилось `First LaTeX block: $$ … $$`, значит вы успешно **exported LaTeX** из Word. Если нет, проверьте, действительно ли ваш исходный документ содержит объекты OfficeMath; обычные текстовые формулы не будут преобразованы. + +## Обработка типичных краевых случаев + +| Сценарий | На что обратить внимание | Рекомендуемое решение | +|----------|--------------------------|-----------------------| +| **Смешанные изображения и уравнения** | Aspose может всё ещё встраивать изображения для графики, не являющейся OfficeMath. | Установите `ExportImagesAsBase64 = false` и храните изображения как внешние файлы, затем вручную ссылаться на них в Markdown. | +| **Сложные вложенные уравнения** | Глубокая вложенность может породить LaTeX, требующий ручной доработки. | Пост‑обработайте блок с помощью форматтера LaTeX (например, `latexindent`) или включите `mdOptions → ExportMathAsDisplay = true`. | +| **Большие документы** | Потребление памяти резко возрастает при загрузке огромных `.docx`. | Используйте `LoadOptions` с `LoadFormat.Docx` и включите потоковую загрузку, если она доступна. | +| **Отсутствующая лицензия** | Бесплатная trial‑версия добавляет комментарий‑водяной знак в вывод. | Примените действующую лицензию: `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Эти рекомендации делают ваш процесс надёжным, особенно когда вы **convert word to markdown** в производственных конвейерах. + +## Полный рабочий пример (Все шаги в одном файле) + +Ниже представлено самостоятельное консольное приложение, которое можно скопировать в новый .NET‑проект и сразу запустить. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Запустите программу, откройте `output.md`, и вы увидите свои уравнения в чистом LaTeX. Это окончательный ответ на вопрос **how to export latex** из документа Word. + +## Заключение + +Мы подробно рассмотрели **как экспортировать LaTeX** из Word шаг за шагом, показав, как **convert Word to markdown**, **save word as markdown** и **export equations as LaTeX** с помощью Aspose.Words. Суть проста: загрузить DOCX, настроить `MarkdownSaveOptions` и позволить библиотеке выполнить всю тяжёлую работу. + +Если вы готовы автоматизировать конвейеры документации, попробуйте связать этот код со статическим генератором сайтов, например Hugo или Jekyll — просто поместите сгенерированные `.md` файлы в репозиторий и позвольте сайту пересобраться. Для дальнейшего чтения изучите руководство Aspose «Export to LaTeX», поэкспериментируйте с `HtmlSaveOptions` для веб‑просмотров или погрузитесь в API `DocumentVisitor` для кастомных трансформаций. + +Есть вопросы о краевых случаях, лицензировании или интеграции в CI/CD? Оставляйте комментарий ниже, и happy coding! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/russian/net/programming-with-pdfsaveoptions/_index.md b/words/russian/net/programming-with-pdfsaveoptions/_index.md index 9590111d2c..a105409d35 100644 --- a/words/russian/net/programming-with-pdfsaveoptions/_index.md +++ b/words/russian/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ | [Обновить последнее напечатанное свойство в документе PDF](./update-last-printed-property/) | Узнайте, как обновить последнее напечатанное свойство в документе PDF с помощью Aspose.Words для .NET с помощью нашего пошагового руководства. | | [Визуализация 3D DML 3DEffects в PDF-документе](./dml-3deffects-rendering/) | Узнайте, как визуализировать потрясающие 3D-эффекты DML в документах PDF с помощью Aspose.Words для .NET с помощью этого подробного пошагового руководства. | | [Интерполяция изображений в PDF-документе](./interpolate-images/) | Узнайте, как интерполировать изображения в PDF-документе с помощью Aspose.Words для .NET с помощью нашего пошагового руководства. Улучшите качество изображений в PDF-файле легко. | - +| [Как сохранить PDF из DOCX с помощью Aspose.Words – пошаговое руководство](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Пошаговое руководство по сохранению PDF из DOCX с использованием Aspose.Words для .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/russian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/russian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..2d38a5b24c --- /dev/null +++ b/words/russian/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,198 @@ +--- +category: general +date: 2026-03-27 +description: Узнайте, как сохранить PDF из файла DOCX с помощью Aspose.Words. Включает + преобразование DOCX в PDF, сохранение PDF с параметрами и работу с плавающими объектами. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: ru +og_description: Как сохранить PDF из файла DOCX с помощью Aspose.Words. Это руководство + показывает, как конвертировать DOCX в PDF, сохранить PDF с параметрами и работать + с плавающими объектами. +og_title: Как сохранить PDF из DOCX – Полный учебник по Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Как сохранить PDF из DOCX с помощью Aspose.Words – пошаговое руководство +url: /ru/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как сохранить PDF из DOCX с помощью Aspose.Words – Полный учебник + +Когда‑нибудь задумывались **как сохранить PDF** из Word‑документа, не теряя расположения плавающих объектов? Вы не одиноки. Во многих проектах — генераторах счетов, экспортёрах отчётов или простых архиваторах документов — разработчикам нужен надёжный способ конвертировать DOCX в PDF, сохраняя внешний вид точно таким же, как в Word. + +В этом учебнике мы пройдём процесс конвертации файла DOCX в PDF **с помощью Aspose.Words for .NET**, покажем **как конвертировать docx в pdf** с пользовательскими параметрами сохранения и объясним, почему флаг `ExportFloatingShapesAsInlineTag` имеет значение. К концу вы получите готовый к запуску фрагмент кода, который сохраняет PDF с контролируемыми вами опциями. + +## Что вы узнаете + +- Точные шаги **конвертации word document pdf** с Aspose.Words. +- Как настроить `PdfSaveOptions` для обработки плавающих фигур как inline‑тегов. +- Распространённые подводные камни при работе с плавающими объектами и как их избежать. +- Полную, исполняемую программу на C#, которую можно вставить в любой .NET‑проект. + +> **Предварительные требования:** Вам нужна лицензия Aspose.Words for .NET (или бесплатная оценочная версия) и среда разработки .NET (Visual Studio, Rider или `dotnet` CLI). + +## Шаг 1: Настройте проект и добавьте Aspose.Words + +Сначала создайте новое консольное приложение (или добавьте в существующее) и подключите пакет Aspose.Words через NuGet. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro tip:** Если вы работаете на CI‑сервере, зафиксируйте версию пакета (`Aspose.Words --version 24.10`), чтобы обеспечить воспроизводимые сборки. + +## Шаг 2: Загрузите DOCX, содержащий плавающие фигуры + +Плавающие изображения, текстовые блоки или SmartArt могут вызывать смещения макета при конвертации. Загрузка документа проста, но мы также проверим, существует ли файл, чтобы избежать `FileNotFoundException` во время выполнения. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Обратите внимание на вызовы `Console.WriteLine` — они дают быстрый отклик, когда вы запускаете приложение из терминала. + +## Шаг 3: Настройте параметры сохранения PDF (Save PDF with Options) + +Здесь происходит магия. По умолчанию Aspose.Words пытается сохранить плавающие объекты в их исходном виде, что может нарушить макет в получаемом PDF. Установка `ExportFloatingShapesAsInlineTag` в `true` заставляет библиотеку рассматривать эти фигуры как inline‑теги, гарантируя их привязку к окружающему тексту. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Почему это важно? Представьте текстовый блок, который «парит» над абзацем. Без конвертации в inline‑тег PDF может сдвинуть абзац вниз или полностью обрезать блок. Флаг сохраняет визуальное взаимное расположение — тонкая, но критически важная деталь для профессиональных отчётов. + +## Шаг 4: Сохраните документ как PDF + +Теперь действительно записываем PDF‑файл. Метод `Save` принимает как путь вывода, так и только что настроенные параметры. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Запуск программы создаст `output.pdf` в той же папке, где находится ваш исходный DOCX. Откройте его в любом PDF‑просмотрщике — все плавающие фигуры будут отрисованы точно там, где должны быть. + +## Полный рабочий пример + +Ниже представлен весь код программы в одном блоке. Скопируйте‑вставьте его в `Program.cs` (или любой C#‑файл) и нажмите **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Ожидаемый результат + +- **Созданный файл:** `output.pdf` в целевом каталоге. +- **Точность макета:** Плавающие фигуры (изображения, текстовые блоки, SmartArt) отображаются inline с окружающим текстом. +- **Без исключений:** Программа завершается корректно, выводя статусные сообщения в консоль. + +## Часто задаваемые вопросы и особые случаи + +| Вопрос | Ответ | +|----------|--------| +| **Что делать, если нужна более высокая качество изображения?** | Установите `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Можно ли конвертировать несколько DOCX файлов пакетно?** | Оберните логику загрузки/сохранения в цикл `foreach (var file in Directory.GetFiles(..., "*.docx"))`. Не забудьте переиспользовать один экземпляр `PdfSaveOptions` для повышения производительности. | +| **Работает ли это с .NET Core?** | Абсолютно. Aspose.Words 24.x поддерживает .NET Standard 2.0+, так что код можно запускать на Windows, Linux или macOS. | +| **Как обрабатывать DOCX, защищённые паролем?** | Загружайте с помощью `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. При сохранении применяются те же `PdfSaveOptions`. | +| **Безопасно ли преобразование в inline‑тег для сложных таблиц?** | Как правило, да, но очень сложные таблицы с перекрывающимися фигурами могут потребовать ручной доработки. Протестируйте репрезентативный набор перед массовой миграцией. | + +## Советы для реальных проектов + +- **Логируйте, а не только `Console.WriteLine`** — в продакшене замените вывод в консоль на фреймворк логирования (Serilog, NLog), чтобы фиксировать ошибки. +- **Освобождайте ресурсы** — `Document` реализует `IDisposable`. Оберните его в `using`, если обрабатываете много файлов, чтобы своевременно освобождать память. +- **Проверяйте PDF** — используйте валидатор PDF (например, проверку соответствия PDF/A), если нужны архивные PDF‑файлы. +- **Параллельная обработка** — для больших объёмов рассмотрите `Parallel.ForEach` с потокобезопасными копиями `PdfSaveOptions` (клонировать для каждого потока), чтобы ускорить конвертацию. + +## Заключение + +Мы рассмотрели **как сохранить PDF** из DOCX‑файла с помощью Aspose.Words, продемонстрировали **как конвертировать docx в pdf** с пользовательскими параметрами и объяснили влияние `ExportFloatingShapesAsInlineTag`. Полный, исполняемый пример показывает, что **конвертировать word document pdf** можно всего в несколько строк, а теперь вы знаете, как **сохранить pdf с опциями**, соответствующими требованиям вашего проекта по качеству и соответствию. + +Готовы к следующему вызову? Попробуйте экспортировать в другие форматы (например, HTML, EPUB) с помощью `document.Save("output.html")` или поэкспериментируйте с соответствием PDF/A для долгосрочного архивирования. Те же принципы — загрузка, настройка параметров, сохранение — применимы во всех случаях. + +Счастливого кодинга, и пусть ваши PDF всегда выглядят точно так, как вы задумали! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/russian/net/programming-with-shapes/_index.md b/words/russian/net/programming-with-shapes/_index.md index 9f00b2c652..92653d0d12 100644 --- a/words/russian/net/programming-with-shapes/_index.md +++ b/words/russian/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ | [Определить форму интеллектуального искусства](./detect-smart-art-shape/) | Узнайте, как обнаружить фигуры SmartArt в документах Word с помощью Aspose.Words для .NET с помощью этого всеобъемлющего руководства. Идеально подходит для автоматизации вашего документооборота. | | [Обновление Smart Art Drawing](./update-smart-art-drawing/) | Узнайте, как обновить рисунки Smart Art в документах Word с помощью Aspose.Words для .NET с помощью этого пошагового руководства. Убедитесь, что ваши визуальные эффекты всегда точны. | | [Создать прямоугольную форму в Word с Aspose.Words – пошаговое руководство](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Узнайте, как создать прямоугольную форму в документах Word с помощью Aspose.Words для .NET в этом пошаговом руководстве. | +| [Создать документ Word C# – Добавить форму с тенью](./create-word-document-c-add-shape-with-shadow/) | Узнайте, как добавить форму с теневым эффектом в документ Word с помощью Aspose.Words для .NET на C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/russian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/russian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..c358d1f3b9 --- /dev/null +++ b/words/russian/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: Создайте документ Word на C# и узнайте, как добавить форму, применить + к ней тень и установить расстояние тени. Пошаговое руководство по Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: ru +og_description: Создайте документ Word на C# с прямоугольной фигурой и пользовательской + тенью. Следуйте этому полному руководству, чтобы задать расстояние тени и её стиль. +og_title: Создание документа Word на C# – Добавление фигуры с тенью +tags: +- Aspose.Words +- C# +- Document Automation +title: Создание документа Word на C# – Добавление фигуры с тенью +url: /ru/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Создать Word документ C# – Добавить форму с тенью + +Когда‑нибудь вам нужно было **create word document c#**, содержащий аккуратно оформленный прямоугольник? Возможно, вы создаёте шаблон отчёта и хотите добавить лёгкую тень, чтобы макет выглядел более выразительно. В этом руководстве мы пошагово покажем, как добавить форму, применить к ней тень и даже отрегулировать расстояние тени с помощью Aspose.Words. + +Мы начнём с пустого документа, вставим прямоугольник, зададим предустановленную тень и завершим сохранением файла. К концу у вас будет готовый .docx, который можно открыть в Word и сразу увидеть эффект. Никаких внешних инструментов, только чистый C# код. + +## Предварительные требования + +- .NET 6 (или любой современный .NET Framework) установлен. +- Visual Studio 2022 или VS Code с расширением C#. +- NuGet‑пакет Aspose.Words for .NET (`Aspose.Words` версии 23.12 или новее). + Добавить его можно через консоль диспетчера пакетов: + + ```powershell + Install-Package Aspose.Words + ``` + +Это всё – никаких дополнительных DLL или COM‑interop не требуется. + +## Шаг 1: Инициализация нового документа и билдера – *create word document c#* Основы + +Сначала нам нужен объект `Document`, представляющий файл Word, и `DocumentBuilder` для его редактирования. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Why this step matters:** Класс `Document` является контейнером для всех частей Word (страницы, стили, изображения). Builder – это высокоуровневый API, который абстрагирует низкоуровневую работу с узлами, делая процесс **create word document c#** простым без необходимости работать с XML напрямую. + +## Шаг 2: Вставка прямоугольной формы – *how to create rectangle* + +Теперь мы разместим прямоугольник на странице. Размер указывается в пунктах (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro tip:** Если нужна другая форма, просто замените `ShapeType.Rectangle` на `ShapeType.Ellipse`, `ShapeType.Triangle` и т.д. Тот же код работает для **how to add shape** любого типа. + +## Шаг 3: Применение предустановленной тени и её тонкая настройка – *apply shadow to shape* + +Aspose.Words поставляется с несколькими предустановленными форматами теней. Мы используем `Preset1`, а затем настраиваем расстояние, размытие, прозрачность и цвет. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Why customize the shadow?** Свойство `Distance` определяет, насколько далеко тень располагается от прямоугольника – это как «подъём», который вы видите в 3‑D‑визуализации. Изменение `BlurRadius` смягчает края, а `Transparency` позволяет создать тонкий, профессиональный вид. Это покрывает требование **set shadow distance** и показывает, как **apply shadow to shape** гибко настраивать. + +## Шаг 4: Сохранение документа – *create word document c#* Завершение + +Наконец, сохраняем документ на диск. Укажите путь к папке, в которую у вас есть права записи. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Откройте полученный файл в Microsoft Word, и вы увидите светло‑синий прямоугольник с мягкой серой тенью, смещённой на 5 pt. Это визуальное подтверждение того, что вы успешно **create word document c#** с оформленной формой. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# пример, показывающий прямоугольник с тенью"} + +## Дополнительные варианты и граничные случаи + +| Сценарий | Что изменить | Почему это важно | +|----------|----------------|----------------| +| **Другой стиль тени** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Даёт более драматичный вид без дополнительного кода. | +| **Без предустановки – пользовательская тень** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Полный контроль над направлением и глубиной. | +| **Несколько фигур** | Call `builder.InsertShape` again before saving. | Полезно для сложных шаблонов с иконками, логотипами и т.д. | +| **Совместимость со старыми версиями Aspose** | Use `ShadowEffect` class (available in v20.x). | Гарантирует работу кода в устаревших проектах. | +| **Сохранение в PDF** | `document.Save("ShadowShape.pdf");` | Тень отображается одинаково в PDF‑выводе. | + +> **Частый вопрос:** *Что делать, если тень не отображается в Word?* +> Убедитесь, что используете актуальную версию Aspose.Words (≥ 22.9). В более старых версиях поддержка теней была ограничена. Также проверьте, что документ открыт в актуальной версии Word (2016+). + +## Полный рабочий пример + +Ниже приведена полностью готовая к копированию программа. В ней включены все директивы `using`, комментарии и обработка ошибок для комфортной работы. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Запустите программу, перейдите к `C:\Temp\ShadowShape.docx`, и вы увидите прямоугольник с точно такой же тенью, которую мы настроили. + +## Итоги и дальнейшие шаги + +- Теперь вы знаете, как **create word document c#**, вставить прямоугольник и **apply shadow to shape** с пользовательским **set shadow distance**. +- Пример использует Aspose.Words, который скрывает сложности OpenXML и гарантирует одинаковый рендеринг во всех версиях Word. +- Хотите идти дальше? Попробуйте комбинировать несколько фигур, добавить текст внутрь прямоугольника или экспортировать тот же документ в PDF, чтобы увидеть, как тень переносится. + +### Связанные темы, которые могут быть интересны + +- **How to add shape** в верхний/нижний колонтитул для брендинга. +- Использование **Aspose.Words** для программного вставления диаграмм и таблиц. +- Настройка **shadow effects** на изображениях вместо векторных форм. +- Автоматизация массовой генерации документов для счетов или сертификатов. + +Экспериментируйте, ломайте код и затем восстанавливайте его – так быстрее всего усвоите материал. Если столкнётесь с проблемой, оставьте комментарий ниже или обратитесь к официальной документации Aspose.Words для более глубокого изучения API. + +Счастливого кодинга и приятного улучшения ваших Word‑файлов! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/russian/net/programming-with-txtsaveoptions/_index.md b/words/russian/net/programming-with-txtsaveoptions/_index.md index 1827608650..1d135d1537 100644 --- a/words/russian/net/programming-with-txtsaveoptions/_index.md +++ b/words/russian/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ | [Добавить знаки биди в документ Word](./add-bidi-marks/) | Узнайте, как добавлять двунаправленные (Bidi) знаки в документы Word с помощью Aspose.Words для .NET с помощью этого руководства. Обеспечьте правильное направление текста для многоязычного контента. | | [Использовать символ табуляции на уровне для отступа списка](./use-tab-character-per-level-for-list-indentation/) | Узнайте, как создавать многоуровневые списки с табулированными отступами с помощью Aspose.Words для .NET. Следуйте этому руководству для точного форматирования списков в ваших документах. | | [Используйте пробел на каждом уровне для отступа списка](./use-space-character-per-level-for-list-indentation/) | Узнайте, как создавать многоуровневые списки с отступом в виде пробела в Aspose.Words для .NET. Пошаговое руководство по точному форматированию документов. | - +| [Сохранить docx как txt – Полное руководство по экспорту уравнений Word в LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Узнайте, как экспортировать уравнения из документов Word в формат LaTeX при сохранении как TXT с помощью Aspose.Words для .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/russian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/russian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..a29397957b --- /dev/null +++ b/words/russian/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Сохраните docx как txt с помощью Aspose.Words и преобразуйте Word в LaTeX. + Узнайте, как экспортировать уравнения, сохранять обычный текст и получать разметку + LaTeX за считанные минуты. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: ru +og_description: Сохраните docx как txt с помощью Aspose.Words. Это руководство показывает, + как конвертировать Word в LaTeX, экспортировать уравнения и сохранить документ в + виде простого текста. +og_title: Сохранить docx в txt – экспортировать уравнения Word в LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Сохранить docx как txt – Полное руководство по экспорту уравнений Word в LaTeX +url: /ru/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Сохранить docx как txt – Экспорт уравнений Word в LaTeX + +Когда‑нибудь вам нужно было **save docx as txt**, но вы боялись потерять сложную математику, находящуюся внутри вашего файла Word? Вы не одиноки. Во многих научных рабочих процессах текстовая версия документа обязательна, однако вы всё равно хотите, чтобы уравнения сохранялись в виде чистой разметки LaTeX. + +В этом руководстве мы пройдём точные шаги по **convert Word to LaTeX** с использованием Aspose.Words for .NET, чтобы ваши уравнения экспортировались корректно, а остальная часть документа превратилась в аккуратный простой текст. К концу вы узнаете, как **export equations to LaTeX**, сохранить остальную часть файла как простой текст и избежать типичных подводных камней, с которыми сталкиваются новички. + +## Что вы узнаете + +- Как загрузить файл *.docx*, содержащий Office Math. +- Настройка правильных `TxtSaveOptions` для того, чтобы Aspose выводил LaTeX для каждого уравнения. +- Сохранение результата как файл **save word plain text**, который вы можете передать в систему контроля версий, CI‑конвейеры или любой downstream‑инструмент. +- Распространённые граничные случаи — что делать, когда документ сочетает изображения и уравнения, или когда необходимо сохранить Unicode‑символы. +- Полный, готовый к запуску пример кода, который вы можете вставить в консольное приложение. + +### Предварительные требования + +- .NET 6.0 или новее (код также работает с .NET Framework 4.7+). +- Лицензионная копия **Aspose.Words for .NET** (бесплатная пробная версия подходит для тестирования). +- Visual Studio 2022 или любой IDE, способный компилировать проекты C#. +- Документ Word (`input.docx`), уже содержащий некоторые объекты Office Math. + +> **Pro tip:** Если у вас ещё нет лицензии, вы можете запросить временный ключ на сайте Aspose — просто замените заполнитель в коде на ваш ключ перед запуском. + +## Шаг 1 – Установить Aspose.Words через NuGet + +Первым делом: вам нужна эта библиотека в вашем проекте. Откройте **Package Manager Console** и выполните: + +```powershell +Install-Package Aspose.Words +``` + +Эта единственная строка подтягивает всё необходимое, включая пространство имён `Saving`, где находится `TxtSaveOptions`. Никаких дополнительных DLL, никаких нативных зависимостей — только чистый управляемый код. + +## Шаг 2 – Загрузить исходный документ Word + +Теперь мы действительно читаем файл, содержащий уравнения. Класс `Document` абстрагирует всю структуру *.docx*, так что вы можете работать с ним как с высокоуровневой объектной моделью. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Почему это важно:** Раннее загрузка документа позволяет вам исследовать его дерево узлов. Если пропустить проверку и в файле нет уравнений, вы всё равно получите чистый txt‑файл — но не поймёте, почему вывод LaTeX пустой. + +## Шаг 3 – Настроить TxtSaveOptions для экспорта в LaTeX + +Aspose предоставляет тонкую настройку того, как рендерится Office Math. Установив `OfficeMathExportMode` в `LaTeX`, каждое уравнение преобразуется в его эквивалент LaTeX вместо того, чтобы быть удалённым или превращённым в изображение. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Почему это важно:** Режим экспорта по умолчанию полностью удалит уравнения. Переключение на `LaTeX` сохраняет математический смысл, что именно нужно, когда вы позже передаёте файл в компилятор LaTeX или markdown‑процессор, понимающий синтаксис `$…$`. + +## Шаг 4 – Сохранить документ как простой текст + +С настроенными параметрами сохранение файла занимает одну строку. Выход будет файлом `.txt`, где каждое уравнение представлено кодом LaTeX, окружённым разделителями `$` (при желании вы можете позже изменить их на блоки `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Ожидаемый результат + +Откройте `output.txt` в любом редакторе, и вы увидите примерно следующее: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Обратите внимание, что обычный текст остаётся точно таким же, а уравнения теперь представляют собой чистые строки LaTeX. Вы можете копировать‑вставлять их напрямую в документ LaTeX, ноутбук Jupyter или любой инструмент, отображающий математику. + +## Шаг 5 – Обработка граничных случаев + +### Смешанное содержимое (изображения + уравнения) + +Если ваш файл Word также содержит изображения, Aspose будет игнорировать их при использовании `TxtSaveOptions`. Обычно этого достаточно для рабочего процесса **save word plain text**, но если вам нужны изображения как заполнители, вы можете: + +1. Экспортировать документ в HTML сначала (`HtmlSaveOptions`), чтобы захватить изображения как теги ``. +2. Выполнить второй проход с `TxtSaveOptions`, чтобы получить уравнения LaTeX. +3. Объединить два результата вручную или с помощью небольшого скрипта. + +### Unicode‑символы + +Некоторые уравнения используют специальные Unicode‑символы (например, греческие буквы). Установка `Encoding = Encoding.UTF8` в `TxtSaveOptions` (как показано в Шаге 3) гарантирует сохранение этих символов при конвертации. + +### Большие документы + +Для огромных файлов (> 100 МБ) рассмотрите возможность потоковой операции сохранения: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Потоковая запись избегает загрузки всего вывода в память, что может спасти жизнь на агентах сборки с небольшим объёмом памяти. + +## Полный рабочий пример + +Ниже представлен полный, готовый к копированию и вставке, пример программы, объединяющий всё вместе. Просто замените пути к файлам и, если есть, строку лицензии. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Запустите программу (`dotnet run`, если вы используете консольный проект) и проверьте `output.txt`. Вы только что **saved docx as txt**, сохранив каждое уравнение в виде LaTeX — без необходимости ручного копирования. + +## Часто задаваемые вопросы + +**Q: Можно ли изменить разделитель с `$…$` на `\(...\)`?** +A: Да. После сохранения выполните простую замену в файле: `output = output.Replace("$", @"\(").Replace("$", @"\)");` — только будьте осторожны, чтобы не заменить встроенные `$`‑символы, принадлежащие оригинальному тексту. + +**Q: Работает ли это с файлами Word 2007‑2019?** +A: Абсолютно. Aspose.Words поддерживает `.doc`, `.docx`, `.docm` и даже более новые семейства `.dotx`. Один и тот же код работает со всеми версиями. + +**Q: Что делать, если нужно сохранить оригинальное форматирование абзацев (табуляции, множественные пробелы)?** +A: Установите `txtSaveOptions.PreserveTableLayout = true;` и `txtSaveOptions.PreserveSpace = true;`, чтобы сохранить пробелы без изменений. + +## Заключение + +Мы рассмотрели всё, что нужно, чтобы **save docx as txt**, одновременно **exporting equations to LaTeX** с помощью Aspose.Words. Ключевые шаги — загрузка документа, настройка `TxtSaveOptions` с `OfficeMathExportMode.LaTeX` и сохранение результата. С помощью этих трёх строк кода вы надёжно можете **convert word to latex**, сохранить ваш документ как **save word plain text** и избежать ужасной потери математических символов. + +Готовы к следующему вызову? Попробуйте связать этот рабочий процесс с генератором markdown, чтобы получить полноценный файл `.md`, включающий и текст, и LaTeX — идеально для документации, хранящейся в Git, или генераторов статических сайтов. Или изучите `PdfSaveOptions` от Aspose, чтобы получить PDF‑версию вместе с файлом простого текста. + +Если возникнут проблемы, оставьте комментарий ниже. Счастливого кодинга и наслаждайтесь простотой преобразования уравнений Word в чистый LaTeX! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/russian/net/working-with-fonts/_index.md b/words/russian/net/working-with-fonts/_index.md index 57d561bdc8..899c9405f4 100644 --- a/words/russian/net/working-with-fonts/_index.md +++ b/words/russian/net/working-with-fonts/_index.md @@ -48,7 +48,7 @@ | [Получать предупреждающие уведомления](./receive-warning-notification/) Узнайте, как получать предупреждающие уведомления при использовании Aspose.Words для .NET и управлять любыми проблемами или предупреждениями в ваших документах. | | [Пример исходного кода шрифта Steam](./resource-steam-font-source-example/) | Узнайте, как использовать источник шрифтов Resource Stream для загрузки пользовательских шрифтов в Aspose.Words для .NET. | | [Получить замену без суффиксов](./get-substitution-without-suffixes/) | В этом уроке вы узнаете, как получить переопределения без суффиксов в документе Word с помощью Aspose.Words для .NET. | - +| [Aspose Font Substitution – Как настроить параметры шрифтов в C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Узнайте, как настроить параметры замены шрифтов в Aspose.Words для .NET с помощью C# в этом пошаговом руководстве. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/russian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/russian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..bd36964370 --- /dev/null +++ b/words/russian/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,237 @@ +--- +category: general +date: 2026-03-27 +description: 'Подмена шрифтов Aspose стала проще: узнайте, как настроить параметры + шрифтов, отлавливать предупреждения и обрабатывать отсутствующие шрифты в ваших + приложениях .NET.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: ru +og_description: Освойте замену шрифтов в Aspose, настроив параметры шрифтов и обработав + отсутствие шрифтов с помощью обратного вызова предупреждения. Полное руководство + по C#. +og_title: Замена шрифтов Aspose – настройка параметров шрифтов в C# +tags: +- Aspose.Words +- C# +- Font Management +title: Замена шрифтов Aspose – Как настроить параметры шрифтов в C# +url: /ru/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Полное руководство по настройке параметров шрифтов + +Случалось ли вам сталкиваться с документом, который внезапно заменяет ваш пользовательский шрифт на что‑то общее? Это **aspose font substitution** делает свою работу — заменяя отсутствующие шрифты на самое близкое совпадение, которое она может найти. Это удобно, но если вам нужно точно знать, какой шрифт был заменён, вам придётся воспользоваться системой предупреждений библиотеки и самостоятельно настроить параметры шрифтов. + +В этом руководстве мы пройдём реальный сценарий: загрузим DOCX, который ссылается на шрифт, которого у вас нет, зафиксируем событие замены и выведем дружелюбное сообщение в консоль. К концу вы будете уверенно работать с **configure font settings**, настроив **Aspose.Words warning callback**, и сможете расширить пример под любой рабочий процесс. + +> **Что вам понадобится** +> • .NET 6+ (или .NET Framework 4.7.2+) +> • Aspose.Words for .NET (последний NuGet) +> • DOCX, который ссылается на отсутствующий шрифт (назовём его `MissingFont.docx`) + +Давайте начнём. + +--- + +## Шаг 1: Установите Aspose.Words и подготовьте проект + +Прежде чем писать код, убедитесь, что пакет Aspose.Words подключён: + +```bash +dotnet add package Aspose.Words +``` + +> **Подсказка:** Используйте последнюю стабильную версию; по состоянию на март 2026 она 23.11.0. Более новые релизы улучшают алгоритмы сопоставления шрифтов и добавляют дополнительные типы предупреждений. + +Создайте новое консольное приложение (или вставьте код в существующий проект) и добавьте обычные директивы `using`: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Эти пространства имён дают нам доступ к `Document`, `LoadOptions` и классам, связанным со шрифтами, которые нам понадобятся. + +## Шаг 2: Настройте параметры шрифтов с помощью LoadOptions + +Ядро управления **aspose font substitution** находится в `LoadOptions.FontSettings`. Предоставив пустой объект `FontSettings`, мы говорим Aspose использовать его пути поиска по умолчанию *и* сообщать о любой замене через callback предупреждений. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Почему не полагаться только на значения по умолчанию? Потому что привязка callback предупреждений (следующий шаг) работает только когда свойство `FontSettings` не равно null. Эта небольшая строка даёт нам точку входа в процесс замены без изменения поведения поиска шрифтов. + +## Шаг 3: Присоедините callback предупреждений для захвата замен + +Aspose.Words реализует интерфейс `IWarningCallback`. Каждый раз, когда происходит что‑то значимое — например, отсутствует шрифт — вызывается наш метод `Warning`. Мы реализуем небольшой обработчик, который фильтрует `WarningType.FontSubstitution` и выводит описание. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +А вот сам обработчик: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Почему это важно** – Без callback Aspose тихо заменяет шрифты, и вы никогда не узнаёте, какой был использован. Callback делает процесс прозрачным, что важно для отчётности по соответствию или отладки проблем верстки. + +## Шаг 4: Загрузите документ, используя настроенные параметры + +Теперь мы наконец загружаем документ, передавая `loadOptions`, которые только что подготовили. Если исходный файл ссылается на шрифт, который не установлен, наш обработчик сработает. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Замените `YOUR_DIRECTORY` реальным путём, где находится `MissingFont.docx`. При запуске программы вы должны увидеть вывод, похожий на: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Эта строка точно указывает, какой шрифт был отсутствующим и какой запасной шрифт выбрал Aspose. + +## Шаг 5: (Опционально) Тонкая настройка путей поиска шрифтов + +Если у вас есть приватная папка с корпоративными шрифтами, вы можете указать Aspose, где искать их, прежде чем он перейдёт к системным шрифтам. Это расширенное использование **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Установка `recursive: true` заставляет Aspose сканировать также подпапки. Теперь библиотека будет сначала проверять ваши приватные шрифты, уменьшая вероятность нежелательной замены. + +## Полный рабочий пример + +Собрав всё вместе, представляем полностью готовую к запуску программу: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Ожидаемый вывод** (когда обнаружен отсутствующий шрифт): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Если все шрифты присутствуют, программа работает тихо (без предупреждений) и всё равно создаёт PDF. + +## Часто задаваемые вопросы и особые случаи + +### Что делать, если нужно полностью *запретить* замену? + +Установите `FontSettings.SubstitutionSettings` в `null` или используйте `FontSettings.FontSubstitutionSettings` для управления поведением. Например: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Теперь Aspose будет бросать исключение вместо тихой замены, которое можно перехватить и обработать. + +### Работает ли это с другими форматами файлов (например, .doc, .rtf)? + +Абсолютно. Тот же объект `LoadOptions` можно передать любому конструктору `Document`, принимающему путь к файлу. Callback предупреждений сработает для всех форматов, использующих шрифты. + +### Можно ли получить *точное* название запасного шрифта? + +Да. Строка `info.Description` содержит как отсутствующий шрифт, так и замену. Если вам нужно получить название программно, вы можете разобрать её или использовать объект `FontInfo` (доступен в новых версиях). + +### Как это работает в многопоточном окружении? + +`FontSettings` **не** является потокобезопасным. Создавайте отдельный `LoadOptions` (со своим `FontSettings`) для каждого потока или защищайте доступ с помощью блокировки. + +## Заключение + +Мы рассмотрели всё, что нужно, чтобы освоить **aspose font substitution** и **configure font settings** в приложении C#: + +1. Установите Aspose.Words и добавьте необходимые директивы `using`. +2. Создайте объект `LoadOptions` с новым `FontSettings`. +3. Присоедините пользовательский `IWarningCallback`, чтобы выводить события замены. +4. Загрузите документ, позволяя callback сообщать о любых отсутствующих шрифтах. +5. (Опционально) Расширьте путь поиска или полностью отключите замену. + +Обладая этим шаблоном, вы можете вести журнал отсутствующих шрифтов для соответствия требованиям, оповещать пользователей в UI или автоматически внедрять запасные шрифты перед публикацией. Далее вы можете изучить **Aspose.Words font substitution policies** или интегрировать процесс в более крупный конвейер обработки документов. + +Удачной разработки, и пусть ваши документы всегда отображаются правильным шрифтом! + +--- + +![Диаграмма, показывающая загрузку документа Aspose.Words, вызов FontSettings, срабатывание callback предупреждений и вывод информации о замене шрифтов](image-placeholder.png "рабочий процесс замены шрифтов Aspose") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/spanish/net/basic-conversions/_index.md b/words/spanish/net/basic-conversions/_index.md index 0145e04557..fccbde1750 100644 --- a/words/spanish/net/basic-conversions/_index.md +++ b/words/spanish/net/basic-conversions/_index.md @@ -35,6 +35,7 @@ Conversiones Básicas te guía a través de las conversiones básicas de documen | [Cómo exportar LaTeX desde Word – Guía paso a paso](./how-to-export-latex-from-word-step-by-step-guide/) Aprenda a exportar contenido LaTeX desde Word usando Aspose.Words para .NET con esta guía paso a paso. | [Convertir Word a PDF en C# usando Aspose.Words – Guía](./convert-word-to-pdf-in-c-using-aspose-words-guide/) Aprenda a convertir documentos Word a PDF en C# con Aspose.Words. Guía paso a paso con ejemplos de código. | [Guardar Word como PDF con Aspose.Words – Guía completa en C#](./save-word-as-pdf-with-aspose-words-complete-c-guide/) Aprenda a guardar documentos Word como PDF usando Aspose.Words en C#. Guía paso a paso con ejemplos de código. | +| [Convertir Word a PDF con Aspose.Words – Guía completa](./convert-word-to-pdf-with-aspose-words-complete-guide/) Aprenda a convertir documentos Word a PDF usando Aspose.Words con una guía completa paso a paso. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/spanish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/spanish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..a49e7907b8 --- /dev/null +++ b/words/spanish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Convierte Word a PDF rápidamente usando Aspose.Words. Aprende cómo guardar + Word como PDF, exportar DOCX a PDF y generar PDF accesible en C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: es +og_description: Convertir Word a PDF en C# usando Aspose.Words. Esta guía muestra + cómo guardar Word como PDF, exportar DOCX a PDF y generar PDF accesible. +og_title: Convertir Word a PDF con Aspose.Words – Paso a paso +tags: +- Aspose.Words +- C# +- PDF conversion +title: Convertir Word a PDF con Aspose.Words – Guía completa +url: /es/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convertir Word a PDF con Aspose.Words – Guía Completa + +¿Alguna vez te has preguntado cómo **convertir Word a PDF** sin tener que usar herramientas web de terceros? Tal vez estés construyendo un motor de informes automatizado y necesites una forma fiable de *guardar word como pdf* al vuelo. La buena noticia es que Aspose.Words hace que todo el proceso sea pan comido, y además puedes generar un archivo compatible con **PDF/UA‑2**, perfecto para requisitos de accesibilidad. + +En este tutorial repasaremos todo lo que necesitas: cargar un `.docx`, configurar las opciones de PDF para que puedas *exportar docx a pdf* con cumplimiento PDF/UA, y finalmente guardar el resultado como un PDF accesible. Al final tendrás un fragmento autónomo, listo para producción, que podrás insertar en cualquier proyecto .NET. + +![Convertir Word a PDF usando Aspose.Words](convert-word-to-pdf.png) + +## Lo que aprenderás + +- **Por qué Aspose.Words** es una opción sólida para escenarios de *generar pdf accesible*. +- Los pasos exactos para *guardar documento como pdf* con cumplimiento PDF/UA‑2. +- Cómo manejar casos comunes como fuentes faltantes o archivos de origen protegidos con contraseña. +- Consejos rápidos para depurar la salida y verificar el cumplimiento de accesibilidad. + +### Requisitos previos + +- .NET 6 o posterior (la API también funciona en .NET Framework 4.6+). +- Una licencia válida de Aspose.Words for .NET (la prueba gratuita sirve para evaluación). +- Conocimientos básicos de C#—no se requieren patrones avanzados. + +Si ya marcaste esas casillas, vamos al grano. + +--- + +## Convertir Word a PDF – Implementación paso a paso + +Dividiremos la solución en cinco pasos claros. Cada paso tiene un encabezado, un breve fragmento de código y una explicación del *por qué* del código. + +### Paso 1: Cargar el documento Word que deseas convertir + +Lo primero que necesitas es un objeto `Document` que represente el archivo fuente. Aspose.Words lee **.docx**, **.doc**, **.rtf** y muchos otros formatos, así que puedes *guardar word como pdf* sin importar cómo se creó originalmente el archivo. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Por qué es importante:** +- Cargar el archivo al inicio te permite detectar errores de archivo inexistente antes de gastar ciclos de CPU. +- La clase `Document` abstrae la estructura interna de un archivo Word, ofreciéndote un modelo de objetos limpio con el que trabajar. + +### Paso 2: Configurar las opciones de guardado PDF para accesibilidad + +Si necesitas *generar pdf accesible*, debes indicarle a Aspose.Words que produzca un documento compatible con PDF/UA‑2. La clase `PdfSaveOptions` te brinda un control granular sobre la salida. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Por qué es importante:** +- `PdfCompliance.PdfUa2` indica a la biblioteca que añada las etiquetas, la información estructural y los metadatos necesarios que los lectores de pantalla utilizan. +- Incrustar fuentes (`EmbedFullFonts = true`) evita las temidas advertencias de “fuente no encontrada” cuando el PDF se abre en otro sistema operativo. +- Establecer un `Title` ayuda a las tecnologías de asistencia a anunciar el documento correctamente. + +### Paso 3: Guardar el documento como PDF + +Ahora que la fuente está cargada y las opciones configuradas, la conversión real es una sola línea. Aquí es donde *exportas docx a pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Por qué es importante:** +- El método `Save` respeta las `PdfSaveOptions` que configuramos, garantizando que las características de accesibilidad queden integradas. +- Envolver la llamada en un bloque `try/catch` te permite registrar o mostrar cualquier error de licencia o permisos que a menudo sorprende a los principiantes. + +### Paso 4: Verificar el cumplimiento PDF/UA (Opcional pero recomendado) + +Aunque Aspose.Words realiza la mayor parte del trabajo, es una buena práctica volver a comprobar la salida, sobre todo cuando entregas documentos a agencias gubernamentales u otras entidades reguladas. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Por qué es importante:** +- `IsTagged` es una verificación rápida; la validación completa de PDF/UA requiere un validador dedicado, pero la mayoría de los problemas de cumplimiento aparecen como etiquetas faltantes. +- Si la bandera devuelve `false`, puedes volver a revisar `PdfSaveOptions`—quizá olvidaste establecer `Compliance` o el documento fuente carecía de estilos de encabezado adecuados. + +### Paso 5: Errores comunes y consejos profesionales + +| Problema | Qué ocurre | Cómo solucionarlo | +|----------|------------|-------------------| +| **Fuentes faltantes** | El texto aparece como cuadros en el PDF. | Establece `EmbedFullFonts = true` **o** instala las fuentes faltantes en el servidor. | +| **Biblioteca sin licencia** | Aspose añade una marca de agua en cada página. | Añade tu archivo de licencia (`Aspose.Words.lic`) al inicio de la aplicación (p. ej., `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Fuente protegida con contraseña** | `InvalidOperationException` al ejecutar `new Document(path)`. | Usa la sobrecarga `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Documentos muy grandes provocan OOM** | Excepción de falta de memoria en archivos enormes. | Habilita `MemoryOptimization` en `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Faltan etiquetas de accesibilidad** | La validación PDF/UA falla. | Asegúrate de que el archivo Word fuente use estilos de encabezado correctos (`Heading 1`, `Heading 2`, etc.)—Aspose los mapea automáticamente a etiquetas PDF. | + +**Consejo profesional:** Si conviertes muchos documentos en lote, reutiliza una única instancia de `PdfSaveOptions`. Crearla una sola vez reduce la sobrecarga de asignación y mantiene bajo el consumo de memoria. + +--- + +## Ejemplo completo (Listo para copiar y pegar) + +A continuación tienes el programa completo que reúne todo. Guárdalo como `Program.cs`, agrega los paquetes NuGet de Aspose.Words y Aspose.PDF, y ejecútalo. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Resultado esperado:** +Aparece un archivo llamado `output.pdf` en `C:\MyFiles`. Al abrirlo en Adobe Acrobat verás “PDF/A‑2b, PDF/UA‑1” en el panel de cumplimiento, confirmando que has *convertido word a pdf* con éxito. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/spanish/net/programming-with-markdownsaveoptions/_index.md b/words/spanish/net/programming-with-markdownsaveoptions/_index.md index bc76e03596..a47c8c08ec 100644 --- a/words/spanish/net/programming-with-markdownsaveoptions/_index.md +++ b/words/spanish/net/programming-with-markdownsaveoptions/_index.md @@ -26,13 +26,16 @@ Procesamiento de textos con MarkdownSaveOptions es un recurso detallado que te g | [Convertir docx a markdown – Guía paso a paso en C#](./convert-docx-to-markdown-step-by-step-c-guide/) Aprenda a convertir archivos DOCX a Markdown paso a paso con C# y Aspose.Words. | | [Guardar Word como PDF y Recuperar Word Corrupto – Convertir Word a Markdown en C#](./save-word-as-pdf-and-recover-corrupted-word-convert-word-to/) | | [Cómo usar Markdown: Convertir DOCX a Markdown con ecuaciones LaTeX](./how-to-use-markdown-convert-docx-to-markdown-with-latex-equa/) Aprenda a convertir documentos DOCX a Markdown conservando ecuaciones LaTeX usando Aspose.Words para .NET. | -| [Guardar docx como markdown – Guía completa en C# con ecuaciones LaTeX](./save-docx-as-markdown-complete-c-guide-with-latex-equations/) Aprenda a guardar documentos DOCX como Markdown conservando ecuaciones LaTeX usando Aspose.Words para .NET. | +| [Guardar docx como markdown – Guía completa en C# con ecuaciones LaTeX](./save-docx-as-markdown-complete-c-guide-with-latex-equations/) Aprende a guardar documentos DOCX como Markdown conservando ecuaciones LaTeX usando Aspose.Words para .NET. | | [Guardar docx como markdown – Guía completa en C# con extracción de imágenes](./save-docx-as-markdown-full-c-guide-with-image-extraction/) Aprenda a guardar documentos DOCX como Markdown y extraer imágenes usando Aspose.Words para .NET. | -| [Cómo exportar Markdown desde Word – Guía completa en C#](./how-to-export-markdown-from-word-complete-c-guide/) Aprenda a exportar contenido de Word a formato Markdown con una guía completa en C# usando Aspose.Words. | +| [Cómo exportar Markdown desde Word – Guía completa en C#](./how-to-export-markdown-from-word-complete-c-guide/) Aprenda a exportar contenido de Word a formato Markdown con una guía completa en C# usando Aspose.Words para .NET. | ### [Crear PDF accesible y convertir Word a Markdown – Guía completa en C#](./create-accessible-pdf-and-convert-word-to-markdown-full-c-gu/) Aprenda a generar PDFs accesibles y convertir documentos Word a Markdown usando C# y Aspose.Words para .NET. ### [Cómo guardar Markdown desde DOCX – Guía paso a paso](./how-to-save-markdown-from-docx-step-by-step-guide/) Aprenda a guardar documentos DOCX como archivos Markdown paso a paso con Aspose.Words para .NET. ### [Cómo exportar Markdown desde DOCX – Guía completa](./how-to-export-markdown-from-docx-complete-guide/) Aprenda a exportar contenido de archivos DOCX a formato Markdown con una guía completa usando Aspose.Words para .NET. +### [Cómo exportar LaTeX desde Word – Convertir DOCX a Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) Aprenda a extraer ecuaciones LaTeX de documentos Word y convertirlos a Markdown con Aspose.Words para .NET. +### [Crear markdown desde Word – Guía completa en C#](./create-markdown-from-word-full-c-guide/) Aprenda a generar archivos Markdown a partir de documentos Word con una guía completa en C# usando Aspose.Words para .NET. +### [Cómo exportar LaTeX desde DOCX – Convertir a Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) Aprenda a extraer ecuaciones LaTeX de archivos DOCX y convertirlos a Markdown usando Aspose.Words para .NET. {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/spanish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/spanish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..477851db80 --- /dev/null +++ b/words/spanish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,232 @@ +--- +category: general +date: 2026-03-27 +description: Crear markdown desde Word con Aspose.Words C#. Aprende a convertir docx + a markdown, extraer imágenes de Word y cómo usar callback en un solo tutorial. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: es +og_description: Crea markdown a partir de Word usando Aspose.Words. Esta guía muestra + cómo convertir docx a markdown, extraer imágenes de Word y usar una devolución de + llamada para el manejo de recursos. +og_title: Crear markdown desde Word – Tutorial completo de C# +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Crear markdown desde Word – Guía completa de C# +url: /es/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Crear markdown desde Word – Tutorial completo de C# + +¿Alguna vez necesitaste **crear markdown desde Word** pero no sabías por dónde empezar? No estás solo; muchos desarrolladores se encuentran con este obstáculo cuando intentan mover contenido de un archivo .docx a un generador de sitios estáticos o a un repositorio de documentación. ¿La buena noticia? Con Aspose.Words puedes **convertir docx a markdown**, extraer cada imagen del archivo original y controlar exactamente dónde se ubican esos recursos, todo con una simple callback. + +En esta guía recorreremos un ejemplo del mundo real que muestra cómo extraer imágenes de Word, cómo usar una callback para almacenarlas y por qué este enfoque es el más fiable para pipelines de automatización. Al final tendrás un programa C# listo para ejecutar que produce un archivo `.md` limpio y una carpeta con las imágenes extraídas. + +> **Consejo profesional:** Si ya tienes una plantilla de Word que incluye capturas de pantalla, diagramas o logotipos, este método preservará cada elemento visual sin que tengas que copiar‑pegar manualmente. + +## Lo que necesitarás + +- **.NET 6+** (o .NET Framework 4.6+). El código funciona en cualquier runtime reciente. +- **Aspose.Words for .NET** (paquete NuGet `Aspose.Words`). La prueba gratuita funciona para la mayoría de los escenarios. +- Un **documento Word** (`input.docx`) que contiene texto y al menos una imagen. +- Un conocimiento básico de C# y Visual Studio (o tu IDE favorito). + +No se requieren bibliotecas adicionales; todo lo demás lo maneja Aspose.Words por sí mismo. + +## Paso 1: Configurar el proyecto e instalar Aspose.Words + +Para mantener todo ordenado, inicia un nuevo proyecto de consola: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Por qué este paso es importante:** Instalar el paquete NuGet garantiza que tengas la API más reciente, que incluye la clase `MarkdownSaveOptions` introducida en la versión 22.9. Sin ella tendrías que escribir un conversor personalizado. + +## Paso 2: Cargar el documento Word de origen + +La primera línea de código abre el `.docx` que deseas transformar. Reemplaza `YOUR_DIRECTORY` con la ruta real en tu máquina. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **¿Qué está sucediendo?** `Document` analiza el archivo, construye un DOM interno y hace accesibles cada párrafo, tabla e imagen. Si el archivo falta, Aspose lanza una clara `FileNotFoundException`, que puedes capturar para una interfaz de usuario más amigable. + +## Paso 3: Configurar las opciones de guardado Markdown con una callback de guardado de recursos + +Aquí es donde entra en juego la magia de **cómo usar callback**. La callback te permite decidir dónde va cada imagen extraída. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **¿Por qué una callback?** Por defecto, Aspose incrustaría las imágenes como cadenas base‑64 dentro del markdown, lo que es una pesadilla para el control de versiones. La callback te brinda control total sobre los nombres de archivo y la estructura de carpetas. + +## Paso 4: Guardar el documento como Markdown + +Ahora realmente generamos el archivo `.md`. Todas las imágenes se pasarán a la callback definida en el siguiente paso. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Si todo va bien, encontrarás `Document.md` en la carpeta de destino y una subcarpeta llamada `Resources` que contiene cada imagen extraída del archivo Word original. + +## Paso 5: Implementar la callback que almacena cada imagen extraída + +A continuación se muestra la implementación completa de `MyResourceSaver`. Crea un directorio `Resources` (si no existe), genera un nombre de archivo único para cada imagen y escribe el flujo de la imagen en disco. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Explicación de los argumentos:** +> - `args.Index` – un contador basado en cero que garantiza la unicidad. +> - `args.FileName` – el nombre de archivo original que sugiere Aspose (a menudo algo como `image001.png`). +> - `args.Stream` – el flujo de salida donde se escriben los bytes de la imagen. +> - `args.KeepResourceStreamOpen` – establecido en `false` para que Aspose libere el flujo automáticamente, evitando fugas de manejadores de archivo. + +## Ejemplo completo funcional + +Juntando todo, aquí tienes un solo archivo que puedes copiar‑pegar en `Program.cs`. Recuerda reemplazar `YOUR_DIRECTORY` con una ruta absoluta o relativa que se ajuste a tu entorno. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Salida esperada + +- `YOUR_DIRECTORY/Document.md` – un archivo markdown con enlaces de imagen estándar, por ejemplo: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – contiene `img_0.png`, `img_1.jpg`, etc., coincidiendo con el orden en que aparecieron en el documento Word original. + +Ejecutar el programa muestra una confirmación amigable, indicándote que el proceso se completó con éxito. + +## Preguntas frecuentes (FAQ) + +### ¿Cómo extraer imágenes de Word sin perder calidad? + +La callback escribe el flujo binario crudo directamente a un archivo, preservando la resolución original. No se realiza conversión ni compresión a menos que añadas tu propia lógica de procesamiento de imágenes dentro de `ResourceSaving`. + +### ¿Puedo cambiar el formato de la imagen (p.ej., PNG → JPEG) durante la extracción? + +Absolutamente. Dentro de `ResourceSaving` puedes inspeccionar `args.FileName` o `args.Stream`, cargar la imagen con `System.Drawing` o `ImageSharp`, y luego volver a codificarla antes de escribirla. Solo recuerda actualizar la extensión del enlace markdown en consecuencia. + +### ¿Qué pasa si necesito que los archivos markdown referencien un CDN en lugar de una carpeta local? + +Modifica la callback para anteponer una URL base al enlace markdown. Puedes lograrlo estableciendo `args.FileName` a una URL completamente calificada después de subir la imagen a tu CDN. + +### ¿Esto funciona con tablas, notas al pie u otras características avanzadas de Word? + +Sí. Aspose.Words traduce la mayoría de los constructos de Word a equivalentes markdown. Las tablas se convierten en tablas markdown, las notas al pie en enlaces de referencia, e incluso las listas anidadas se manejan sin problemas. Si algo se ve extraño, revisa las notas de la última versión; Aspose mejora continuamente la fidelidad de la conversión. + +### ¿Cómo convertir docx a markdown en una pipeline CI/CD? + +Simplemente agrega el `.exe` compilado a tus pasos de construcción, apúntalo a los artefactos `.docx` generados y empuja el `.md` resultante y la carpeta `Resources/` a tu repositorio de sitio estático. Como el proceso es totalmente determinista, funciona bien en entornos automatizados. + +## Conclusión + +Acabamos de demostrar cómo **crear markdown desde Word** usando Aspose.Words, cubrimos todo el flujo de trabajo de **convertir docx a markdown**, y mostramos una forma práctica de **extraer imágenes de Word** con una implementación personalizada de **cómo usar callback**. El resultado es un archivo markdown limpio acompañado de una carpeta con las imágenes originales, perfecto para sitios de documentación, blogs estáticos o cualquier flujo de trabajo que prefiera formatos de texto plano. + +Próximos pasos que podrías considerar: + +- **Procesamiento por lotes** de varios archivos `.docx` en una carpeta (bucle sobre `Directory.GetFiles`). +- **Esquemas de nombres personalizados** para imágenes (p. ej., usando el texto del título original). +- **Post‑procesamiento** del markdown para reemplazar los enlaces de imagen con URLs de CDN. +- Explorar **otros formatos de exportación de Aspose** como HTML, PDF o EPUB para publicación multicanal. + +¿Tienes más preguntas o un archivo Word complicado que se niega a convertir? Deja un comentario abajo y solucionemos el problema juntos. ¡Feliz codificación y disfruta de la simplicidad de convertir Word a markdown! + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/spanish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/spanish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..9d903f5f5c --- /dev/null +++ b/words/spanish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Cómo exportar LaTeX desde DOCX usando Aspose.Words. Aprende a convertir + DOCX a Markdown, establecer DPI y habilitar la recuperación en C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: es +og_description: Cómo exportar LaTeX desde DOCX usando Aspose.Words. Este tutorial + muestra la conversión paso a paso a Markdown, control de DPI y modo de recuperación. +og_title: Cómo exportar LaTeX desde DOCX – Convertir a Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Cómo exportar LaTeX desde DOCX – Convertir a Markdown +url: /es/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo exportar LaTeX desde DOCX – Convertir a Markdown + +¿Alguna vez te has preguntado **cómo exportar LaTeX** de un archivo DOCX sin perder la belleza de tus ecuaciones? No estás solo. En mi experiencia, el mayor punto doloroso es obtener esos objetos OfficeMath en un formato limpio y portátil para generadores de sitios estáticos o blogs científicos. + +En esta guía recorreremos la conversión de DOCX a Markdown con Aspose.Words, mostrando también **cómo establecer DPI**, **cómo habilitar la recuperación**, y algunos trucos útiles para una canalización robusta. Al final tendrás un único programa en C# que genera un archivo Markdown con ecuaciones LaTeX, imágenes de alta resolución y manejo adecuado de hipervínculos. + +## Lo que necesitarás + +- **.NET 6+** (or .NET Framework 4.7.2 – the API works the same) +- **Aspose.Words for .NET** (the latest stable version as of March 2026) +- Un archivo DOCX que contenga ecuaciones, imágenes y enlaces +- Visual Studio, VS Code, o cualquier editor que prefieras + +No se requieren paquetes NuGet adicionales más allá de Aspose.Words, pero asegúrate de tener una licencia válida si no estás usando la versión de prueba. + +## Paso 1 – Cargar el DOCX con modo de recuperación estricta + +Antes de siquiera pensar en exportar, necesitamos asegurarnos de que el documento fuente no esté ocultando corrupción. Ahí es donde entra **cómo habilitar la recuperación**. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**¿Por qué recuperación estricta?** +Si dejas que Aspose solucione silenciosamente los problemas, podrías terminar con párrafos faltantes o imágenes rotas—algo que nadie quiere al exportar LaTeX. Al fallar rápidamente, puedes detectar el problema temprano y decidir si corregir el DOCX fuente o registrar el problema para más tarde. + +### Consejo profesional +Envuelve la carga en un try/catch y registra `DocumentLoadingException`. De esa manera tu canal de CI puede marcar archivos problemáticos sin detener toda la compilación. + +## Paso 2 – Preparar las opciones de exportación a Markdown + +Ahora que el documento está seguro en memoria, configuramos cómo se guardará. Este es el núcleo de **cómo exportar latex** y también cubre **cómo establecer DPI** para imágenes incrustadas. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Qué hace cada opción** + +| Opción | Razón | Relevancia para palabras clave | +|--------|--------|-------------------------------| +| `OfficeMathExportMode = LaTeX` | Responde directamente **cómo exportar latex** de las ecuaciones. | Palabra clave principal | +| `ImageResolution = 300` | Controla la calidad de la imagen – la respuesta a **cómo establecer dpi**. | Secundaria | +| `ResourceSavingCallback` | Guarda archivos incrustados en disco, una necesidad común al **convertir docx a markdown**. | Secundaria | +| `EmptyParagraphExportMode` | Garantiza una salida Markdown limpia, evitando etiquetas HTML sueltas. | Mejora la calidad general de la conversión | +| `LinkExportMode = AsReference` | Facilita la lectura y edición de enlaces, otro beneficio para **convertir docx a markdown**. | | + +## Paso 3 – Implementar un guardador de recursos personalizado (Opcional pero útil) + +Al convertir DOCX a Markdown, las imágenes y otros recursos binarios necesitan un lugar en el sistema de archivos. Aspose te permite controlar eso con `IResourceSavingCallback`. El fragmento anterior ya muestra una implementación mínima, pero desglosémoslo: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**¿Por qué molestarse?** +Si omites este paso, Aspose incrustará las imágenes como cadenas base‑64, lo que inflará el tamaño del archivo Markdown y hará que el control de versiones sea doloroso. Al guardar los recursos en una carpeta separada, mantienes el Markdown ligero y lo haces amigable para generadores de sitios estáticos como Hugo o Jekyll. + +## Paso 4 – Guardar el documento como Markdown + +Todo el trabajo pesado está hecho. Una sola línea escribe ahora el archivo final. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Abre `output.md` y verás: + +- Ecuaciones renderizadas como bloques LaTeX `$…$` +- Imágenes referenciadas como `![Alt text](resources/image001.png)` con resolución de 300 dpi +- Hipervínculos convertidos a estilo de referencia: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Ese es todo el proceso de **cómo convertir docx** en resumen. + +## Preguntas comunes y casos límite + +### 1️⃣ ¿Qué pasa si el DOCX contiene objetos no compatibles? +Aspose.Words lanzará una `FeatureNotSupportedException`. Como usamos **cómo habilitar la recuperación** en modo estricto, la excepción aparece de inmediato. Puedes: + +- Cambiar `RecoveryMode` a `RecoveryMode.Default` para una conversión de mejor esfuerzo, **o** +- Pre‑procesar el DOCX (p. ej., eliminar SmartArt no compatible) antes de ejecutar el conversor. + +### 2️⃣ ¿Puedo cambiar el DPI por imagen? +La configuración `ImageResolution` es global. Para control por imagen, implementa un `ImageSavingCallback` personalizado similar a `MyResourceSaver` y ajusta `args.ImageResolution` según `args.ImageFileName` o los metadatos. + +### 3️⃣ ¿Cómo incrusto el LaTeX generado en un sitio Jekyll? +El soporte integrado de MathJax de Jekyll funciona de inmediato. Solo asegúrate de que tu diseño incluya el script de MathJax y que los bloques LaTeX estén envueltos en `$$` para ecuaciones de bloque o `$` para en línea. + +### 4️⃣ ¿Es compatible con .NET Core en Linux? +Absolutamente. Aspose.Words es multiplataforma. Solo asegúrate de que la ruta `YOUR_DIRECTORY` siga las convenciones de Linux (p. ej., `/home/user/docs`). + +## Ejemplo completo funcional + +A continuación hay un programa listo para copiar y pegar. Reemplaza `YOUR_DIRECTORY` con una ruta real en tu máquina. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Salida esperada** – abre `output.md` y deberías ver algo como: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Si abres el archivo en una vista previa de Markdown que soporte MathJax, la integral se renderiza + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/spanish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/spanish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..18cc90d780 --- /dev/null +++ b/words/spanish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Cómo exportar LaTeX de documentos Word usando Aspose.Words – convertir + DOCX a Markdown con ecuaciones en LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: es +og_description: Cómo exportar LaTeX desde documentos de Word se explica en la primera + frase, mostrándote cómo convertir DOCX a Markdown con ecuaciones en LaTeX. +og_title: Cómo exportar LaTeX desde Word – Guía completa +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Cómo exportar LaTeX desde Word – Convertir DOCX a Markdown +url: /es/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo exportar LaTeX desde Word – Convertir DOCX a Markdown + +¿Alguna vez te has preguntado **cómo exportar LaTeX** de un archivo Word sin terminar con un montón de PNGs? No eres el único; los desarrolladores se topan con este obstáculo cuando necesitan ecuaciones limpias y editables para sitios estáticos o blogs científicos. ¿La buena noticia? Con Aspose.Words puedes **convertir Word a Markdown** y mantener cada objeto OfficeMath como LaTeX nativo—sin necesidad de post‑procesamiento. + +En este tutorial recorreremos todo el proceso de **guardar un documento Word como Markdown** mientras **exportamos ecuaciones como LaTeX**. Al final tendrás un fragmento de C# ejecutable, una explicación clara de cada opción y consejos para manejar casos límite como fórmulas complejas o contenido mixto. Sin herramientas externas, solo un paquete NuGet y unas pocas líneas de código. + +## Qué necesitarás + +- .NET 6+ (o .NET Framework 4.7.2 o superior) – la última versión del runtime funciona mejor. +- Visual Studio 2022 o cualquier editor que pueda compilar proyectos C#. +- Una licencia de Aspose.Words for .NET (la prueba gratuita sirve para experimentar). +- Un archivo DOCX que contenga al menos una ecuación (OfficeMath). + +Si ya tienes todo eso, genial—¡vamos al grano! + +## Cómo exportar LaTeX desde Word – Visión general + +A continuación se muestra una vista de alto nivel de los pasos involucrados: + +1. **Instalar** el paquete NuGet Aspose.Words. +2. **Cargar** el `.docx` fuente que contiene tus ecuaciones. +3. **Configurar** `MarkdownSaveOptions` para que `OfficeMathExportMode` esté establecido en `LaTeX`. +4. **Guardar** el documento como un archivo `.md`. +5. **Verificar** que el Markdown generado contenga bloques LaTeX (`$$…$$`). + +Cada uno de estos pasos se explica en detalle en las secciones siguientes. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="How to export latex from Word diagram"} + +## Paso 1 – Instalar Aspose.Words for .NET (convert word to markdown) + +Lo primero: necesitas la biblioteca que realmente hace el trabajo pesado. Abre tu terminal (o la Consola del Administrador de paquetes) y ejecuta: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Consejo profesional:** Si usas Visual Studio, haz clic derecho en el proyecto → *Manage NuGet Packages* → busca “Aspose.Words” e instala la versión estable más reciente. + +Por qué es importante: Aspose.Words abstrae el formato Open XML, dándote una API limpia para manipular documentos Word sin lidiar con el XML de bajo nivel. Además, incluye soporte integrado para convertir OfficeMath a LaTeX, que es el núcleo de nuestro requisito de **exportar ecuaciones como LaTeX**. + +## Paso 2 – Cargar el DOCX (how to convert docx) + +Ahora que el paquete está instalado, carga el archivo que deseas transformar. Reemplaza `YOUR_DIRECTORY` con la ruta donde se encuentra tu `.docx`: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **¿Por qué cargarlo de esta forma?** El constructor `Document` analiza todo el archivo en un modelo de objetos, dándote acceso inmediato a párrafos, tablas y—lo más importante—objetos OfficeMath. Si el archivo falta o está corrupto, Aspose lanza una `FileNotFoundException` descriptiva, que puedes capturar para manejar el error de forma elegante. + +## Paso 3 – Configurar MarkdownSaveOptions (export equations as latex) + +La magia ocurre en el objeto `MarkdownSaveOptions`. Por defecto Aspose renderizaría las ecuaciones como imágenes PNG, pero nosotros queremos LaTeX. Establece `OfficeMathExportMode` a `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Una breve nota sobre las banderas opcionales: `ExportImagesAsBase64` indica a Aspose que no incruste datos binarios, lo que mantiene el Markdown limpio. `ExportHeadersFooters` asegura que no pierdas contexto que pueda estar en esas secciones—útil cuando el encabezado contiene un título o el nombre del autor. + +## Paso 4 – Guardar el documento (save word as markdown) + +Finalmente, escribe el contenido transformado en un archivo `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Después de ejecutar esta línea, encontrarás `output.md` junto a tu archivo fuente. Ábrelo en cualquier editor de texto y deberías ver bloques LaTeX que se ven así: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Eso completa la parte de **save word as markdown**—sin pasos de conversión adicionales. + +## Paso 5 – Verificar el resultado (export equations as latex) + +Es fácil pasar por alto la verificación, pero una rápida comprobación de sentido ahorra horas después. Ejecuta un script sencillo que lea el archivo generado e imprima el primer bloque LaTeX: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Si ves `First LaTeX block: $$ … $$` impreso, has **exportado LaTeX** desde Word con éxito. Si no, verifica que tu documento fuente realmente contenga objetos OfficeMath; las ecuaciones de texto normal no se convertirán. + +## Manejo de casos límite comunes + +| Escenario | Qué observar | Solución recomendada | +|----------|-------------------|-----------------| +| **Imágenes y ecuaciones mezcladas** | Aspose puede seguir incrustando imágenes para gráficos que no son OfficeMath. | Establece `ExportImagesAsBase64 = false` y mantén las imágenes como archivos externos, luego referencia manualmente en Markdown. | +| **Ecuaciones anidadas complejas** | Un anidamiento muy profundo puede generar LaTeX que requiera ajustes manuales. | Post‑procesa el bloque con un formateador LaTeX (p. ej., `latexindent`) o ajusta `mdOptions` → `ExportMathAsDisplay = true`. | +| **Documentos grandes** | El uso de memoria se dispara al cargar archivos `.docx` muy pesados. | Usa `LoadOptions` con `LoadFormat.Docx` y habilita streaming en `LoadOptions.LoadFormat` si está disponible. | +| **Licencia ausente** | La prueba gratuita añade un comentario de marca de agua al output. | Aplica una licencia válida mediante `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Estos consejos mantienen tu flujo de trabajo robusto, especialmente cuando **convert word to markdown** en pipelines de producción. + +## Ejemplo completo (todos los pasos en un solo archivo) + +A continuación tienes una aplicación de consola autocontenida que puedes copiar‑pegar en un nuevo proyecto .NET y ejecutar de inmediato. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Ejecuta el programa, abre `output.md` y verás tus ecuaciones renderizadas como LaTeX limpio. Esa es la respuesta completa a **cómo exportar latex** desde un documento Word. + +## Conclusión + +Hemos cubierto **cómo exportar LaTeX** desde Word paso a paso, mostrándote cómo **convertir Word a markdown**, **save word as markdown**, y **exportar ecuaciones como LaTeX** usando Aspose.Words. La idea central es simple: cargar el DOCX, ajustar `MarkdownSaveOptions` y dejar que la biblioteca haga el trabajo pesado. + +Si estás listo para automatizar pipelines de documentación, prueba encadenar este código con un generador de sitios estáticos como Hugo o Jekyll—solo sube los archivos `.md` generados a tu repositorio y deja que el sitio se reconstruya. Para seguir leyendo, explora la guía “Export to LaTeX” de Aspose, experimenta con `HtmlSaveOptions` para vistas web, o sumérgete en la API `DocumentVisitor` para transformaciones personalizadas. + +¿Tienes preguntas sobre casos límite, licencias o integración en CI/CD? Deja un comentario abajo, ¡y feliz codificación! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/spanish/net/programming-with-pdfsaveoptions/_index.md b/words/spanish/net/programming-with-pdfsaveoptions/_index.md index 925b3d7eb2..b489581e8e 100644 --- a/words/spanish/net/programming-with-pdfsaveoptions/_index.md +++ b/words/spanish/net/programming-with-pdfsaveoptions/_index.md @@ -38,14 +38,14 @@ Si desea convertir documentos de Word a PDF para distribuirlos en línea, archiv | [Mejore la posición del texto PDF con posicionamiento de texto adicional](./additional-text-positioning/) Aprenda a mejorar la posición del texto en PDF con Aspose.Words para .NET en unos sencillos pasos. Mejore la apariencia de su documento. | [Convertir documento de Word a PDF 1.7](./conversion-to-pdf-17/) Convierta fácilmente documentos de Word a PDF 1.7 con Aspose.Words para .NET. Siga esta guía para garantizar que sus documentos sean accesibles universalmente y tengan un formato profesional. | [Reducir el tamaño de un documento PDF con la reducción de resolución de imágenes](./downsampling-images/) Reduzca el tamaño de sus documentos PDF reduciendo el tamaño de las imágenes con Aspose.Words para .NET. Optimice sus PDF para una carga y descarga más rápidas. -| [Establecer opciones de esquema en un documento PDF](./set-outline-options/) Aprenda a configurar opciones de contorno en un documento PDF con Aspose.Words para .NET. Mejore la navegación en PDF configurando niveles de encabezado y contornos expandidos. +| [Establecer opciones de esquema en un documento PDF](./set-outline-options/) Aprenda a configurar opciones contorno en un documento PDF con Aspose.Words para .NET. Mejore la navegación en PDF configurando niveles de encabezado y contornos expandidos. | [Exportar propiedades personalizadas en un documento PDF](./custom-properties-export/) | Aprenda a exportar propiedades personalizadas en un documento PDF usando Aspose.Words para .NET con nuestra guía detallada paso a paso. | | [Exportar la estructura de un documento de Word a un documento PDF](./export-document-structure/) Exporte la estructura de un documento de Word a PDF con Aspose.Words para .NET. Siga nuestra guía paso a paso para conservar el diseño del documento y mejorar la navegación en PDF. | [Compresión de imágenes en un documento PDF](./image-compression/) Aprenda a comprimir imágenes en documentos PDF con Aspose.Words para .NET. Siga esta guía para optimizar el tamaño y la calidad de los archivos. | [Actualizar la última propiedad impresa en un documento PDF](./update-last-printed-property/) | Aprenda a actualizar la última propiedad impresa en un documento PDF usando Aspose.Words para .NET con nuestra guía paso a paso. | | [Renderizar efectos 3D DML 3D en un documento PDF](./dml-3deffects-rendering/) | Aprenda a renderizar impresionantes efectos DML 3D en documentos PDF usando Aspose.Words para .NET con esta completa guía paso a paso. | | [Interpolar imágenes en un documento PDF](./interpolate-images/) Aprenda a interpolar imágenes en un documento PDF con Aspose.Words para .NET con nuestra guía paso a paso. Mejore fácilmente la calidad de imagen de su PDF. - +| [Cómo guardar PDF desde DOCX con Aspose.Words – Guía paso a paso](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Aprenda a convertir DOCX a PDF usando Aspose.Words con esta guía paso a paso. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/spanish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/spanish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..f0b8ad39cf --- /dev/null +++ b/words/spanish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,198 @@ +--- +category: general +date: 2026-03-27 +description: Aprenda cómo guardar un PDF a partir de un archivo DOCX usando Aspose.Words. + Incluye convertir DOCX a PDF, guardar el PDF con opciones y manejar formas flotantes. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: es +og_description: Cómo guardar PDF a partir de un archivo DOCX usando Aspose.Words. + Esta guía muestra cómo convertir docx a pdf, guardar pdf con opciones y manejar + formas flotantes. +og_title: Cómo guardar PDF desde DOCX – Tutorial completo de Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Cómo guardar PDF desde DOCX con Aspose.Words – Guía paso a paso +url: /es/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo guardar PDF desde DOCX con Aspose.Words – Tutorial completo + +¿Alguna vez te has preguntado **cómo guardar PDF** a partir de un documento Word sin perder el diseño de las formas flotantes? No eres el único. En muchos proyectos—generadores de facturas, exportadores de informes o simples archivadores de documentos—los desarrolladores necesitan una forma fiable de convertir DOCX a PDF manteniendo todo exactamente como aparece en Word. + +En este tutorial recorreremos la conversión de un archivo DOCX a PDF **usando Aspose.Words para .NET**, te mostraremos **cómo convertir docx a pdf** con opciones de guardado personalizadas y explicaremos por qué la bandera `ExportFloatingShapesAsInlineTag` es importante. Al final tendrás un fragmento listo‑para‑ejecutar que guarda PDF con las opciones que controlas. + +## Lo que aprenderás + +- Los pasos exactos para **convertir word document pdf** con Aspose.Words. +- Cómo configurar `PdfSaveOptions` para tratar las formas flotantes como etiquetas inline. +- Trampas comunes al trabajar con objetos flotantes y cómo evitarlas. +- Un programa completo en C# que puedes incorporar a cualquier proyecto .NET. + +> **Prerequisite:** Necesitas una licencia de Aspose.Words para .NET (o una evaluación gratuita) y un entorno de desarrollo .NET (Visual Studio, Rider o la CLI `dotnet`). + +## Paso 1: Configura el proyecto y agrega Aspose.Words + +Primero, crea una nueva aplicación de consola (o añádela a una existente) y referencia el paquete NuGet de Aspose.Words. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro tip:** Si trabajas en un servidor CI, fija la versión del paquete (`Aspose.Words --version 24.10`) para garantizar compilaciones reproducibles. + +## Paso 2: Carga el DOCX que contiene formas flotantes + +Las imágenes flotantes, los cuadros de texto o SmartArt pueden provocar desplazamientos de diseño al convertir. Cargar el documento es sencillo, pero también verificaremos que el archivo exista para evitar una `FileNotFoundException` en tiempo de ejecución. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Observa las sentencias `Console.WriteLine`; te dan una retroalimentación rápida cuando ejecutas la aplicación desde la terminal. + +## Paso 3: Configura las opciones de guardado PDF (Save PDF with Options) + +Aquí es donde ocurre la magia. Por defecto Aspose.Words intenta preservar los objetos flotantes tal como aparecen, lo que puede romper el diseño en el PDF resultante. Establecer `ExportFloatingShapesAsInlineTag` a `true` indica a la biblioteca que trate esas formas como etiquetas inline, asegurando que permanezcan ancladas al texto circundante. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +¿Por qué importa esto? Imagina un cuadro de texto que flota sobre un párrafo. Sin la conversión a etiqueta inline, el PDF podría empujar el párrafo hacia abajo o recortar el cuadro por completo. La bandera mantiene intacta la relación visual—un detalle sutil pero crucial para informes profesionales. + +## Paso 4: Guarda el documento como PDF + +Ahora realmente escribimos el archivo PDF. El método `Save` recibe tanto la ruta de salida como las opciones que acabamos de establecer. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Ejecutar el programa producirá `output.pdf` en la misma carpeta que tu DOCX de origen. Ábrelo con cualquier visor de PDF y deberías ver que todas las formas flotantes se renderizan exactamente donde les corresponde. + +## Ejemplo completo y funcional + +A continuación tienes el programa completo en un solo bloque. Copia‑pega en `Program.cs` (o cualquier archivo C#) y pulsa **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Resultado esperado + +- **Archivo creado:** `output.pdf` en el directorio de destino. +- **Fidelidad del diseño:** Las formas flotantes (imágenes, cuadros de texto, SmartArt) aparecen inline con el texto circundante. +- **Sin excepciones:** El programa finaliza sin problemas, imprimiendo mensajes de estado en la consola. + +## Preguntas frecuentes y casos límite + +| Pregunta | Respuesta | +|----------|-----------| +| **¿Qué pasa si necesito mayor calidad de imagen?** | Establece `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **¿Puedo convertir varios archivos DOCX en lote?** | Envuelve la lógica de carga/guardado en un bucle `foreach (var file in Directory.GetFiles(..., "*.docx"))`. Recuerda reutilizar una única instancia de `PdfSaveOptions` para mejorar el rendimiento. | +| **¿Esto funciona con .NET Core?** | Absolutamente. Aspose.Words 24.x soporta .NET Standard 2.0+, así que puedes ejecutar el mismo código en Windows, Linux o macOS. | +| **¿Qué hay de los archivos DOCX protegidos con contraseña?** | Cárgalos con `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. Las mismas `PdfSaveOptions` se aplican al guardar. | +| **¿Es segura la conversión a etiqueta inline para tablas complejas?** | En general sí, pero diseños de tabla muy intrincados con formas superpuestas pueden requerir ajustes manuales. Prueba con una muestra representativa antes de una migración masiva. | + +## Consejos para proyectos del mundo real + +- **Registra, no solo `Console.WriteLine`** – En producción, sustituye la salida de consola por un framework de logging (Serilog, NLog) para capturar errores. +- **Libera recursos** – `Document` implementa `IDisposable`. Envuélvelo en un bloque `using` si procesas muchos archivos para liberar memoria rápidamente. +- **Valida el PDF** – Usa un validador de PDF (p. ej., comprobador de conformidad PDF/A) si necesitas PDFs de grado archivístico. +- **Procesamiento en paralelo** – Para cargas masivas, considera `Parallel.ForEach` con `PdfSaveOptions` seguro para hilos (clona la instancia por hilo) para acelerar la conversión. + +## Conclusión + +Hemos cubierto **cómo guardar PDF** desde un archivo DOCX usando Aspose.Words, demostrado **cómo convertir docx a pdf** con opciones personalizadas y explicado el impacto de `ExportFloatingShapesAsInlineTag`. El ejemplo completo y ejecutable muestra que puedes **convertir word document pdf** en unas pocas líneas, y ahora sabes cómo **guardar pdf con opciones** que se ajusten a los requisitos de calidad y cumplimiento de tu proyecto. + +¿Listo para el siguiente reto? Prueba exportar a otros formatos (p. ej., HTML, EPUB) con `document.Save("output.html")`, o experimenta con la conformidad PDF/A para archivado a largo plazo. Los mismos principios—cargar, configurar opciones, guardar—se aplican en todos los casos. + +¡Feliz codificación, y que tus PDFs siempre luzcan exactamente como los imaginaste! + +![Diagrama que ilustra cómo se carga un archivo DOCX, se aplican opciones y se produce un PDF – cómo guardar pdf](https://example.com/images/how-to-save-pdf-diagram.png "how to save pdf diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/spanish/net/programming-with-shapes/_index.md b/words/spanish/net/programming-with-shapes/_index.md index 339e2034dd..b24f0acc81 100644 --- a/words/spanish/net/programming-with-shapes/_index.md +++ b/words/spanish/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Al usar Aspose.Words para .NET y seguir estos tutoriales, dominará la manipulac | [Detectar formas de arte inteligentes](./detect-smart-art-shape/) Aprenda a detectar formas SmartArt en documentos de Word con Aspose.Words para .NET con esta guía completa. Ideal para automatizar el flujo de trabajo de sus documentos. | [Actualizar Smart Art Drawing](./update-smart-art-drawing/) Aprenda a actualizar dibujos Smart Art en documentos de Word con Aspose.Words para .NET con esta guía paso a paso. Asegúrese de que sus imágenes sean siempre precisas. | [Crear forma de rectángulo en Word con Aspose.Words – Guía paso a paso](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Aprenda a crear una forma de rectángulo en documentos de Word usando Aspose.Words con esta guía paso a paso. | +| [Crear documento Word C# – Agregar forma con sombra](./create-word-document-c-add-shape-with-shadow/) | Aprenda a crear un documento Word en C# y agregar una forma con sombra usando Aspose.Words para .NET con esta guía paso a paso. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/spanish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/spanish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..8902cfd256 --- /dev/null +++ b/words/spanish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,204 @@ +--- +category: general +date: 2026-03-27 +description: Crear documento Word en C# y aprender cómo agregar una forma, aplicar + sombra a la forma y establecer la distancia de la sombra. Guía paso a paso para + Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: es +og_description: Crea un documento de Word en C# con una forma rectangular y sombra + personalizada. Sigue este tutorial completo para establecer la distancia y el estilo + de la sombra. +og_title: Crear documento de Word C# – Añadir forma con sombra +tags: +- Aspose.Words +- C# +- Document Automation +title: Crear documento Word C# – Añadir forma con sombra +url: /es/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Crear documento Word C# – Añadir forma con sombra + +¿Alguna vez necesitaste **create word document c#** que contenga un rectángulo con estilo? Tal vez estés creando una plantilla de informe y quieras una sombra sutil para que el diseño destaque. En este tutorial recorreremos exactamente eso: cómo añadir una forma, aplicar sombra a la forma e incluso ajustar la distancia de la sombra usando Aspose.Words. + +Comenzaremos con un documento en blanco, insertaremos un rectángulo, le daremos una sombra predefinida y terminaremos guardando el archivo. Al final tendrás un .docx listo para usar que podrás abrir en Word y ver el efecto al instante. Sin herramientas externas, solo código C# puro. + +## Requisitos previos + +- .NET 6 (o cualquier .NET Framework reciente) instalado. +- Visual Studio 2022 o VS Code con la extensión C#. +- Paquete NuGet Aspose.Words para .NET (`Aspose.Words` versión 23.12 o posterior). + Puedes añadirlo mediante la consola del Administrador de paquetes: + + ```powershell + Install-Package Aspose.Words + ``` + +Eso es todo: no se requieren DLLs adicionales ni interop COM. + +## Paso 1: Inicializar un nuevo documento y Builder – *create word document c#* conceptos básicos + +Primero necesitamos un objeto `Document` que representa el archivo Word y un `DocumentBuilder` para editarlo. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Por qué es importante este paso:** La clase `Document` es el contenedor de todas las partes de Word (páginas, estilos, imágenes). El builder es la API de alto nivel que abstrae la manipulación de nodos de bajo nivel, facilitando **create word document c#** sin tener que trabajar directamente con XML. + +## Paso 2: Insertar una forma rectangular – *how to create rectangle* + +Ahora colocaremos un rectángulo en la página. El tamaño se expresa en puntos (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Consejo profesional:** Si necesitas una forma diferente, simplemente cambia `ShapeType.Rectangle` por `ShapeType.Ellipse`, `ShapeType.Triangle`, etc. El mismo código funciona para **how to add shape** de cualquier tipo. + +## Paso 3: Aplicar una sombra predefinida y ajustarla finamente – *apply shadow to shape* + +Aspose.Words incluye varios formatos de sombra predefinidos. Usaremos `Preset1` y luego personalizaremos la distancia, difuminado, transparencia y color. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **¿Por qué personalizar la sombra?** La propiedad `Distance` controla qué tan lejos está la sombra del rectángulo, como el “elevado” que verías en una representación 3D. Cambiar `BlurRadius` suaviza los bordes, mientras que `Transparency` te permite crear un aspecto sutil y profesional. Esto cubre el requisito de **set shadow distance** y te muestra cómo **apply shadow to shape** de forma flexible. + +## Paso 4: Guardar el documento – *create word document c#* finalización + +Finalmente, escribe el documento en disco. Ajusta la ruta a una carpeta donde tengas permisos de escritura. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Abre el archivo resultante en Microsoft Word y verás un rectángulo azul claro con una sombra gris suave desplazada 5 pt. Esa es la prueba visual de que has **create word document c#** con una forma con estilo. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="ejemplo de crear documento Word c# mostrando rectángulo con sombra"} + +## Variaciones opcionales y casos límite + +| Escenario | Qué cambiar | Por qué es importante | +|----------|----------------|----------------| +| **Estilo de sombra diferente** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Te brinda un aspecto más dramático sin código adicional. | +| **Sin predefinido – sombra personalizada** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Control total sobre la dirección y profundidad. | +| **Múltiples formas** | Call `builder.InsertShape` again before saving. | Útil para plantillas complejas con íconos, logotipos, etc. | +| **Compatibilidad con versiones antiguas de Aspose** | Use `ShadowEffect` class (available in v20.x). | Garantiza que tu código se ejecute en proyectos heredados. | +| **Guardar como PDF** | `document.Save("ShadowShape.pdf");` | El mismo renderizado de sombra aparece en la salida PDF. | + +> **Pregunta frecuente:** *¿Qué pasa si la sombra no aparece en Word?* +> Asegúrate de estar usando una versión reciente de Aspose.Words (≥ 22.9). Las versiones anteriores tenían soporte limitado de sombras. También verifica que el documento se abra en una versión reciente de Word (2016+). + +## Ejemplo completo funcional + +A continuación está el programa completo, listo para copiar y pegar. Incluye todas las directivas `using`, comentarios y manejo de errores para una experiencia fluida. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Ejecuta el programa, navega a `C:\Temp\ShadowShape.docx` y verás el rectángulo con la sombra exacta que configuramos. + +## Recapitulación y próximos pasos + +- Ahora sabes cómo **create word document c#**, insertar un rectángulo y **apply shadow to shape** con una **set shadow distance** personalizada. +- El ejemplo usa Aspose.Words, que abstrae las complejidades de OpenXML y garantiza un renderizado consistente en todas las versiones de Word. +- ¿Quieres ir más allá? Prueba combinar múltiples formas, añadir texto dentro del rectángulo o exportar el mismo documento como PDF para ver cómo se traslada la sombra. + +### Temas relacionados que podrías explorar + +- **How to add shape** a un encabezado/pie de página para branding. +- Usar **Aspose.Words** para insertar gráficos y tablas programáticamente. +- Personalizar **shadow effects** en imágenes en lugar de formas vectoriales. +- Automatizar la generación masiva de documentos para facturas o certificados. + +Siéntete libre de experimentar, romper el código y luego reconstruirlo: esa es la forma más rápida de interiorizar los conceptos. Si encuentras un problema, deja un comentario abajo o consulta la documentación oficial de Aspose.Words para obtener información más profunda de la API. + +¡Feliz codificación y disfruta haciendo que tus archivos Word luzcan un poco más pulidos! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/spanish/net/programming-with-txtsaveoptions/_index.md b/words/spanish/net/programming-with-txtsaveoptions/_index.md index 8013c307cf..301cf23d86 100644 --- a/words/spanish/net/programming-with-txtsaveoptions/_index.md +++ b/words/spanish/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Gracias a estos tutoriales, podrá aprovechar al máximo las funcionalidades de | [Agregar marcas bidireccionales en un documento de Word](./add-bidi-marks/) Aprenda a agregar marcas bidireccionales (Bidi) en documentos de Word con Aspose.Words para .NET con esta guía. Asegúrese de que la dirección del texto sea correcta para contenido multilingüe. | [Usar carácter de tabulación por nivel para sangría de lista](./use-tab-character-per-level-for-list-indentation/) Aprenda a crear listas multinivel con sangría de tabulación usando Aspose.Words para .NET. Siga esta guía para un formato de lista preciso en sus documentos. | [Utilice el carácter de espacio por nivel para la sangría de la lista](./use-space-character-per-level-for-list-indentation/) Aprenda a crear listas multinivel con sangría de espacios en Aspose.Words para .NET. Guía paso a paso para un formato preciso de documentos. - +| [Guardar docx como txt – Guía completa para exportar ecuaciones de Word a LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) Aprenda a guardar documentos DOCX como archivos TXT y exportar ecuaciones de Word a LaTeX usando Aspose.Words para .NET. {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/spanish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/spanish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..c96a379c1d --- /dev/null +++ b/words/spanish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,245 @@ +--- +category: general +date: 2026-03-27 +description: Guarda docx como txt con Aspose.Words y convierte Word a LaTeX. Aprende + cómo exportar ecuaciones, mantener texto plano y obtener el marcado LaTeX en minutos. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: es +og_description: Guarda docx como txt usando Aspose.Words. Esta guía muestra cómo convertir + Word a LaTeX, exportar ecuaciones y mantener tu documento en texto plano. +og_title: Guardar docx como txt – Exportar ecuaciones de Word a LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Guardar docx como txt – Guía completa para exportar ecuaciones de Word a LaTeX +url: /es/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Guardar docx como txt – Exportar ecuaciones de Word a LaTeX + +¿Alguna vez necesitaste **guardar docx como txt** pero temías perder las elegantes fórmulas que viven dentro de tu archivo Word? No estás solo. En muchos flujos de trabajo científicos la versión de texto plano de un documento es indispensable, pero aún deseas que las ecuaciones permanezcan como un marcado LaTeX limpio. + +En este tutorial recorreremos los pasos exactos para **convertir Word a LaTeX** usando Aspose.Words para .NET, de modo que tus ecuaciones se exporten correctamente mientras el resto del documento se convierta en texto plano ordenado. Al final sabrás cómo **exportar ecuaciones a LaTeX**, mantener el resto del archivo como texto simple y evitar los obstáculos habituales que tropiezan los principiantes. + +## Lo que aprenderás + +- Cómo cargar un archivo *.docx* que contiene Office Math. +- Configurar el `TxtSaveOptions` correcto para que Aspose genere LaTeX para cada ecuación. +- Guardar el resultado como un archivo **save word plain text** que puedas introducir en control de versiones, pipelines CI o cualquier herramienta downstream. +- Casos límite comunes—qué hacer cuando un documento mezcla imágenes y ecuaciones, o cuando necesitas que se preserven los caracteres Unicode. +- Un ejemplo de código completo, listo‑para‑ejecutar, que puedes insertar en una aplicación de consola. + +### Requisitos previos + +- .NET 6.0 o posterior (el código también funciona con .NET Framework 4.7+). +- Una copia con licencia de **Aspose.Words for .NET** (la prueba gratuita sirve para pruebas). +- Visual Studio 2022 o cualquier IDE que pueda compilar proyectos C#. +- Un documento Word (`input.docx`) que ya contiene algunos objetos Office Math. + +> **Consejo profesional:** Si aún no tienes una licencia, puedes solicitar una clave temporal en el sitio web de Aspose—simplemente reemplaza el marcador de posición en el código con tu clave antes de ejecutar. + +## Paso 1 – Instalar Aspose.Words vía NuGet + +Lo primero es lo primero: necesitas la biblioteca en tu proyecto. Abre la **Package Manager Console** y ejecuta: + +```powershell +Install-Package Aspose.Words +``` + +Esa única línea trae todo lo que necesitas, incluido el espacio de nombres `Saving` donde reside `TxtSaveOptions`. Sin DLLs adicionales, sin dependencias nativas—solo código administrado puro. + +## Paso 2 – Cargar el documento Word de origen + +Ahora realmente leemos el archivo que contiene las ecuaciones. La clase `Document` abstrae toda la estructura *.docx*, de modo que puedes tratarla como un modelo de objetos de alto nivel. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Por qué es importante:** Cargar el documento temprano te permite inspeccionar su árbol de nodos. Si omites la verificación y el archivo no tiene ecuaciones, aún obtendrás un archivo txt limpio—pero no sabrás por qué la salida LaTeX está vacía. + +## Paso 3 – Configurar TxtSaveOptions para la exportación a LaTeX + +Aspose te brinda un control granular sobre cómo se renderiza Office Math. Al establecer `OfficeMathExportMode` a `LaTeX`, cada ecuación se convierte en su equivalente LaTeX en lugar de ser eliminada o transformada en una imagen. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Por qué es importante:** El modo de exportación predeterminado eliminaría las ecuaciones por completo. Cambiar a `LaTeX` conserva la intención matemática, que es exactamente lo que necesitas cuando luego alimentas el archivo a un compilador LaTeX o a un procesador markdown que entiende la sintaxis `$…$`. + +## Paso 4 – Guardar el documento como texto plano + +Con las opciones configuradas, persistir el archivo es una sola línea. La salida será un archivo `.txt` donde cada ecuación aparece como código LaTeX rodeado por delimitadores `$` (puedes cambiarlo más tarde si prefieres bloques `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Resultado esperado + +Abre `output.txt` en cualquier editor y verás algo como: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Observa cómo el texto regular permanece exactamente como estaba, mientras que las ecuaciones ahora son cadenas LaTeX puras. Puedes copiar‑pegarlas directamente en un documento LaTeX, un cuaderno Jupyter o cualquier herramienta que renderice matemáticas. + +## Paso 5 – Manejo de casos límite + +### Contenido mixto (Imágenes + Ecuaciones) + +Si tu archivo Word también contiene imágenes, Aspose las ignorará cuando uses `TxtSaveOptions`. Eso suele estar bien para un flujo de trabajo **save word plain text**, pero si necesitas las imágenes como marcadores de posición puedes: + +1. Exportar el documento a HTML primero (`HtmlSaveOptions`) para capturar imágenes como etiquetas ``. +2. Ejecutar una segunda pasada con `TxtSaveOptions` para obtener las ecuaciones LaTeX. +3. Fusionar los dos resultados manualmente o con un pequeño script. + +### Símbolos Unicode + +Algunas ecuaciones usan caracteres Unicode especiales (p. ej., letras griegas). Establecer `Encoding = Encoding.UTF8` en `TxtSaveOptions` (como se muestra en el Paso 3) garantiza que esos símbolos sobrevivan a la conversión. + +### Documentos grandes + +Para archivos masivos (> 100 MB), considera transmitir la operación de guardado: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +La transmisión evita cargar toda la salida en memoria, lo que puede ser un salvavidas en agentes de compilación con poca memoria. + +## Ejemplo completo funcional + +A continuación se muestra el programa completo, listo para copiar y pegar, que une todo. Simplemente reemplaza las rutas de archivo y, si tienes una, la línea de licencia. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Ejecuta el programa (`dotnet run` si estás usando un proyecto de consola) y revisa `output.txt`. Acabas de **guardar docx como txt** preservando cada ecuación como LaTeX—sin necesidad de copiar‑pegar manualmente. + +## Preguntas frecuentes + +**Q: ¿Puedo cambiar el delimitador de `$…$` a `\(...\)`?** +A: Sí. Después de guardar, ejecuta un reemplazo simple en el archivo: `output = output.Replace("$", @"\(").Replace("$", @"\)");`—solo ten cuidado de no reemplazar los caracteres `$` en línea que pertenecen al texto original. + +**Q: ¿Esto funciona con archivos Word 2007‑2019?** +A: Absolutamente. Aspose.Words soporta `.doc`, `.docx`, `.docm`, e incluso la familia más reciente `.dotx`. El mismo código funciona en todas las versiones. + +**Q: ¿Qué pasa si necesito mantener el formato original de los párrafos (tabulaciones, espacios múltiples)?** +A: Establece `txtSaveOptions.PreserveTableLayout = true;` y `txtSaveOptions.PreserveSpace = true;` para mantener los espacios en blanco intactos. + +## Conclusión + +Hemos cubierto todo lo que necesitas para **guardar docx como txt** mientras **exportas ecuaciones a LaTeX** usando Aspose.Words. Los pasos clave son cargar el documento, configurar `TxtSaveOptions` con `OfficeMathExportMode.LaTeX` y guardar el resultado. Con estas tres líneas de código puedes convertir de forma fiable **word a latex**, mantener tu documento como **save word plain text**, y evitar la temida pérdida de símbolos matemáticos. + +¿Listo para el próximo desafío? Intenta encadenar este flujo de trabajo con un generador markdown para producir un archivo `.md` completo que incluya tanto texto como LaTeX—perfecto para documentación respaldada por Git o generadores de sitios estáticos. O explora `PdfSaveOptions` de Aspose para obtener una versión PDF junto al archivo de texto plano. + +Si encuentras algún problema, deja un comentario abajo. ¡Feliz codificación y disfruta de la simplicidad de convertir ecuaciones de Word en LaTeX limpio! + +![Ilustración de guardar un DOCX como TXT con ecuaciones LaTeX](placeholder-image.png "ejemplo de guardar docx como txt") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/spanish/net/working-with-fonts/_index.md b/words/spanish/net/working-with-fonts/_index.md index 7e48c7dc00..104f5c7321 100644 --- a/words/spanish/net/working-with-fonts/_index.md +++ b/words/spanish/net/working-with-fonts/_index.md @@ -26,29 +26,29 @@ Ya sea que desee formatear texto con diferentes fuentes, establecer reglas de su | Título | Descripción | | --- | --- | | [Formato de fuente](./font-formatting/) | Aprenda a formatear fuentes en documentos de Word usando Aspose.Words para .NET con una guía detallada paso a paso. | -| [Obtener el interlineado de la fuente](./get-font-line-spacing/) Aprenda a obtener el interlineado de fuentes con Aspose.Words para .NET con este tutorial paso a paso. Ideal para desarrolladores. -| [Comprobar el efecto de texto de DrawingML](./check-drawingml-text-effect/) Aprenda a comprobar los efectos de texto de DrawingML en documentos de Word con Aspose.Words para .NET con nuestra guía detallada paso a paso. Mejore sus documentos fácilmente. -| [Establecer el formato de fuente](./set-font-formatting/) Aprenda a configurar el formato de fuente en documentos de Word con Aspose.Words para .NET. Siga nuestra guía detallada paso a paso para optimizar la automatización de sus documentos. -| [Establecer marca de énfasis de fuente](./set-font-emphasis-mark/) Aprenda a establecer marcas de énfasis de fuente en documentos de Word con Aspose.Words para .NET con esta guía detallada paso a paso. Ideal para desarrolladores .NET. -| [Establecer carpetas de fuentes](./set-fonts-folders/) Aprenda a configurar carpetas de fuentes personalizadas en Aspose.Words para .NET con esta guía completa paso a paso. Ideal para desarrolladores que buscan mejorar las fuentes de sus documentos. -| [Habilitar Deshabilitar Sustitución de Fuentes](./enable-disable-font-substitution/) Aprenda a habilitar o deshabilitar la sustitución de fuentes en documentos de Word con Aspose.Words para .NET. Asegúrese de que sus documentos se vean uniformes en todas las plataformas. +| [Obtener el interlineado de la fuente](./get-font-line-spacing/) Aprenda a obtener el interlineado de fuentes con Aspose.Words para .NET con este tutorial paso a paso. Ideal para desarrolladores. | +| [Comprobar el efecto de texto de DrawingML](./check-drawingml-text-effect/) Aprenda a comprobar los efectos texto de DrawingML en documentos de Word con Aspose.Words para .NET con nuestra guía detallada paso a paso. Mejore sus documentos fácilmente. | +| [Establecer el formato de fuente](./set-font-formatting/) Aprenda a configurar el formato de fuente en documentos de Word con Aspose.Words para .NET. Siga nuestra guía detallada paso a paso para optimizar la automatización de sus documentos. | +| [Establecer marca de énfasis de fuente](./set-font-emphasis-mark/) Aprenda a establecer marcas de énfasis de fuente en documentos de Word con Aspose.Words para .NET con esta guía detallada paso a paso. Ideal para desarrolladores .NET. | +| [Establecer carpetas de fuentes](./set-fonts-folders/) Aprenda a configurar carpetas de fuentes personalizadas en Aspose.Words para .NET con esta guía completa paso a paso. Ideal para desarrolladores que buscan mejorar las fuentes de sus documentos. | +| [Habilitar Deshabilitar Sustitución de Fuentes](./enable-disable-font-substitution/) Aprenda a habilitar o deshabilitar la sustitución de fuentes en documentos de Word con Aspose.Words para .NET. Asegúrese de que sus documentos se vean uniformes en todas las plataformas. | | [Establecer la configuración de reserva de fuentes](./set-font-fallback-settings/) | Aprenda a configurar la sustitución de fuentes en Aspose.Words para .NET y a personalizar la sustitución de fuentes en sus documentos de Word. | -| [Cargar configuración de respaldo de Noto](./load-noto-fallback-settings/) Aprenda a cargar la configuración de respaldo de Noto en un documento de Word con Aspose.Words para .NET. Siga nuestra guía paso a paso para garantizar que todos los caracteres se muestren correctamente. -| [Establecer carpetas de fuentes como instancia predeterminada](./set-fonts-folders-default-instance/) Aprenda a configurar carpetas de fuentes para la instancia predeterminada en Aspose.Words para .NET con este tutorial paso a paso. Personalice sus documentos de Word fácilmente. -| [Establecer carpetas de fuentes en varias carpetas](./set-fonts-folders-multiple-folders/) Aprenda a configurar varias carpetas de fuentes en sus documentos de Word con Aspose.Words para .NET. Esta guía paso a paso garantiza que sus documentos usen las fuentes exactas que necesita. +| [Cargar configuración de respaldo de Noto](./load-noto-fallback-settings/) Aprenda a cargar la configuración de respaldo de Noto en un documento de Word con Aspose.Words para .NET. Siga nuestra guía paso a paso para garantizar que todos los caracteres se muestren correctamente. | +| [Establecer carpetas de fuentes como instancia predeterminada](./set-fonts-folders-default-instance/) Aprenda a configurar carpetas de fuentes para la instancia predeterminada en Aspose.Words para .NET con este tutorial paso a paso. Personalice sus documentos de Word fácilmente. | +| [Establecer carpetas de fuentes en varias carpetas](./set-fonts-folders-multiple-folders/) Aprenda a configurar varias carpetas de fuentes en sus documentos de Word con Aspose.Words para .NET. Esta guía paso a paso garantiza que sus documentos usen las fuentes exactas que necesita. | | [Establecer carpetas de fuentes del sistema y carpetas personalizadas](./set-fonts-folders-system-and-custom-folder/) Aprenda a configurar carpetas de fuentes personalizadas y del sistema en documentos de Word usando Aspose.Words para .NET, garantizando que sus documentos se muestren correctamente en diferentes entornos. | -| [Establecer carpetas de fuentes con prioridad](./set-fonts-folders-with-priority/) Aprenda a configurar carpetas de fuentes con prioridad en documentos de Word con Aspose.Words para .NET. Nuestra guía garantiza que sus documentos se visualicen perfectamente en todo momento. -| [Establecer carpeta de fuentes True Type](./set-true-type-fonts-folder/) Aprenda a configurar una carpeta de fuentes True Type en documentos de Word con Aspose.Words para .NET. Siga nuestra guía detallada paso a paso para garantizar una gestión de fuentes consistente. -| [Especificar la fuente predeterminada al renderizar](./specify-default-font-when-rendering/) Aprenda a especificar una fuente predeterminada al renderizar documentos de Word con Aspose.Words para .NET. Asegúrese de que la apariencia de los documentos sea uniforme en todas las plataformas. -| [Configuración de fuente con opciones de carga](./font-settings-with-load-options/) Aprenda a administrar la configuración de fuentes con las opciones de carga en Aspose.Words para .NET. Guía paso a paso para desarrolladores que garantiza una apariencia uniforme de las fuentes en documentos de Word. +| [Establecer carpetas de fuentes con prioridad](./set-fonts-folders-with-priority/) Aprenda a configurar carpetas de fuentes con prioridad en documentos de Word con Aspose.Words para .NET. Nuestra guía garantiza que sus documentos se visualicen perfectamente en todo momento. | +| [Establecer carpeta de fuentes True Type](./set-true-type-fonts-folder/) Aprenda a configurar una carpeta de fuentes True Type en documentos de Word con Aspose.Words para .NET. Siga nuestra guía detallada paso a paso para garantizar una gestión de fuentes consistente. | +| [Especificar la fuente predeterminada al renderizar](./specify-default-font-when-rendering/) Aprenda a especificar una fuente predeterminada al renderizar documentos de Word con Aspose.Words para .NET. Asegúrese de que la apariencia de los documentos sea uniforme en todas las plataformas. | +| [Configuración de fuente con opciones de carga](./font-settings-with-load-options/) Aprenda a administrar la configuración de fuentes con las opciones de carga en Aspose.Words para .NET. Guía paso a paso para desarrolladores que garantiza una apariencia uniforme de las fuentes en documentos de Word. | | [Establecer carpeta de fuentes](./set-fonts-folder/) | Aprenda a configurar una carpeta de fuentes personalizadas en Aspose.Words para .NET para garantizar que sus documentos de Word se representen correctamente sin fuentes faltantes. | -| [Configuración de fuente Instancia predeterminada](./font-settings-default-instance/) | En este tutorial, aprenda a configurar la configuración de fuente predeterminada en un documento de Word con Aspose.Words para .NET. -| [Obtener lista de fuentes disponibles](./get-list-of-available-fonts/) Descubre cómo obtener una lista de fuentes disponibles con Aspose.Words para .NET en este detallado tutorial paso a paso. Mejora tus habilidades de gestión de fuentes. +| [Configuración de fuente Instancia predeterminada](./font-settings-default-instance/) | En este tutorial, aprenda a configurar la configuración de fuente predeterminada en un documento de Word con Aspose.Words para .NET. | +| [Obtener lista de fuentes disponibles](./get-list-of-available-fonts/) Descubre cómo obtener una lista de fuentes disponibles con Aspose.Words para .NET en este detallado tutorial paso a paso. Mejora tus habilidades de gestión de fuentes. | | [Recibir notificaciones de fuentes](./receive-notifications-of-fonts/) | Aprenda cómo recibir notificaciones de fuentes faltantes o sustituidas al usar Aspose.Words para .NET. | | [Recibir notificación de advertencia](./receive-warning-notification/) Aprenda cómo recibir una notificación de advertencia al usar Aspose.Words para .NET y administrar cualquier problema o advertencia en sus documentos. | | [Ejemplo de fuente de recurso de Steam](./resource-steam-font-source-example/) | Aprenda a utilizar la fuente de flujo de recursos para cargar fuentes personalizadas en Aspose.Words para .NET. | -| [Obtener sustitución sin sufijos](./get-substitution-without-suffixes/) | En este tutorial, aprenda cómo obtener anulaciones sin sufijos en un documento de Word con Aspose.Words para .NET. - +| [Obtener sustitución sin sufijos](./get-substitution-without-suffixes/) | En este tutorial, aprenda cómo obtener anulaciones sin sufijos en un documento de Word con Aspose.Words para .NET. | +| [Sustitución de fuentes Aspose – Cómo configurar la configuración de fuentes en C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Aprenda a configurar la sustitución de fuentes y ajustes de fuentes en Aspose.Words para .NET usando C# paso a paso. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/spanish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/spanish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..676edf96e3 --- /dev/null +++ b/words/spanish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,252 @@ +--- +category: general +date: 2026-03-27 +description: 'Sustitución de fuentes Aspose fácil: aprenda a configurar los ajustes + de fuentes, capturar advertencias y manejar fuentes faltantes en sus aplicaciones + .NET.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: es +og_description: Domina la sustitución de fuentes de Aspose configurando la configuración + de fuentes y manejando fuentes faltantes con una devolución de llamada de advertencia. + Guía completa de C#. +og_title: Sustitución de fuentes Aspose – Configurar ajustes de fuentes en C# +tags: +- Aspose.Words +- C# +- Font Management +title: Sustitución de fuentes Aspose – Cómo configurar la configuración de fuentes + en C# +url: /es/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Sustitución de fuentes Aspose – Guía completa para configurar la configuración de fuentes + +¿Alguna vez te has encontrado con un documento que de repente cambia tu tipografía personalizada por algo genérico? Eso es **aspose font substitution** haciendo su trabajo—reemplazando fuentes faltantes con la coincidencia más cercana que puede encontrar. Es útil, pero si necesitas saber *exactamente* qué fuente se sustituyó, debes acceder al sistema de advertencias de la biblioteca y configurar la configuración de fuentes tú mismo. + +En este tutorial recorreremos un escenario del mundo real: cargar un DOCX que hace referencia a una fuente que no tienes, capturar el evento de sustitución y imprimir un mensaje amigable en la consola. Al final estarás cómodo con **configure font settings**, configurando un **Aspose.Words warning callback**, y ampliando el ejemplo para adaptarlo a cualquier flujo de trabajo. + +> **Lo que necesitarás** +> • .NET 6+ (o .NET Framework 4.7.2+) +> • Aspose.Words for .NET (último NuGet) +> • Un DOCX que haga referencia a una fuente faltante (lo llamaremos `MissingFont.docx`) + +¡Vamos a sumergirnos! + +--- + +## Paso 1: Instalar Aspose.Words y preparar el proyecto + +Antes de escribir cualquier código, asegúrate de que el paquete Aspose.Words esté referenciado: + +```bash +dotnet add package Aspose.Words +``` + +> **Consejo profesional:** Usa la última versión estable; a partir de marzo 2026 es 23.11.0. Las versiones más recientes mejoran los algoritmos de coincidencia de fuentes y añaden tipos de advertencia adicionales. + +Crea una nueva aplicación de consola (o inserta el código en un proyecto existente) y agrega las directivas `using` habituales: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Estos espacios de nombres nos dan acceso a `Document`, `LoadOptions` y a las clases relacionadas con fuentes que necesitaremos. + +--- + +## Paso 2: Configurar Font Settings con LoadOptions + +El corazón del control de **aspose font substitution** vive en `LoadOptions.FontSettings`. Al proporcionar un objeto `FontSettings` vacío le decimos a Aspose que use sus rutas de búsqueda predeterminadas *y* que informe cualquier sustitución mediante una callback de advertencia. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +¿Por qué no confiar solo en los valores predeterminados? Porque adjuntar una callback de advertencia (paso siguiente) solo funciona cuando la propiedad `FontSettings` no es nula. Esta pequeña línea nos brinda un punto de enganche en el proceso de sustitución sin cambiar el comportamiento real de búsqueda de fuentes. + +--- + +## Paso 3: Adjuntar una callback de advertencia para capturar sustituciones + +Aspose.Words implementa la interfaz `IWarningCallback`. Cada vez que ocurre algo notable—como una fuente faltante—llama a nuestro método `Warning`. Implementaremos un manejador pequeño que filtre `WarningType.FontSubstitution` y muestre la descripción. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +Y aquí está el manejador propiamente dicho: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Por qué es importante** – Sin la callback, Aspose sustituye fuentes silenciosamente y nunca sabrás cuál se utilizó. La callback hace el proceso transparente, lo cual es esencial para informes de cumplimiento o para depurar problemas de maquetación. + +--- + +## Paso 4: Cargar el documento usando las opciones configuradas + +Ahora finalmente cargamos el documento, pasando el `loadOptions` que acabamos de preparar. Si el archivo fuente hace referencia a una fuente que no está instalada, nuestro manejador se activará. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Reemplaza `YOUR_DIRECTORY` con la ruta real donde se encuentra `MissingFont.docx`. Cuando ejecutes el programa, deberías ver una salida similar a: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Esa línea te indica exactamente qué fuente faltaba y qué fuente de respaldo eligió Aspose. + +--- + +## Paso 5: (Opcional) Ajustar finamente las rutas de búsqueda de fuentes + +Si dispones de una carpeta privada con fuentes corporativas, puedes indicarle a Aspose dónde buscar antes de que recurra a las fuentes del sistema. Este es un uso avanzado de **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Establecer `recursive: true` hace que Aspose escanee también las subcarpetas. Ahora la biblioteca intentará primero tus fuentes privadas, reduciendo la probabilidad de sustituciones no deseadas. + +--- + +## Ejemplo completo y funcional + +Juntando todo, aquí tienes el programa completo, listo para ejecutarse: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Salida esperada** (cuando se encuentre una fuente faltante): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Si todas las fuentes están presentes, el programa se ejecuta silenciosamente (sin advertencias) y aún así genera el PDF. + +--- + +## Preguntas frecuentes y casos límite + +### ¿Qué pasa si necesito *evitar* la sustitución por completo? + +Establece `FontSettings.SubstitutionSettings` a `null` o usa `FontSettings.FontSubstitutionSettings` para controlar el comportamiento. Por ejemplo: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Ahora Aspose lanzará una excepción en lugar de sustituir silenciosamente, la cual puedes capturar y manejar. + +### ¿Esto funciona con otros formatos de archivo (p. ej., .doc, .rtf)? + +Absolutamente. El mismo objeto `LoadOptions` puede pasarse a cualquier constructor de `Document` que acepte una ruta de archivo. La callback de advertencia se activará para todos los formatos que dependan de fuentes. + +### ¿Puedo capturar el nombre exacto de la fuente de respaldo? + +Sí. La cadena `info.Description` contiene tanto la fuente faltante como la de reemplazo. Si necesitas el nombre programáticamente, puedes analizarla o usar el objeto `FontInfo` (disponible en versiones más recientes). + +### ¿Cómo se comporta esto en un entorno multihilo? + +`FontSettings` **no** es seguro para hilos. Crea un `LoadOptions` separado (con su propio `FontSettings`) por hilo, o protege el acceso con un bloqueo (`lock`). + +--- + +## Conclusión + +Hemos cubierto todo lo que necesitas para dominar **aspose font substitution** y **configure font settings** en una aplicación C#: + +1. Instala Aspose.Words y agrega las declaraciones `using` necesarias. +2. Crea un objeto `LoadOptions` con un `FontSettings` nuevo. +3. Adjunta un `IWarningCallback` personalizado para exponer los eventos de sustitución. +4. Carga el documento, dejando que la callback informe cualquier fuente faltante. +5. (Opcional) Amplía la ruta de búsqueda o desactiva la sustitución por completo. + +Con este patrón puedes registrar fuentes faltantes para cumplimiento, alertar a los usuarios en una UI, o incrustar automáticamente fuentes de respaldo antes de publicar. A continuación, podrías explorar **políticas de sustitución de fuentes de Aspose.Words** o integrar el flujo de trabajo en una canalización de procesamiento de documentos más grande. + +¡Feliz codificación, y que tus documentos siempre se rendericen con la tipografía correcta! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/swedish/net/basic-conversions/_index.md b/words/swedish/net/basic-conversions/_index.md index 3ae482bcd8..a885e3dbce 100644 --- a/words/swedish/net/basic-conversions/_index.md +++ b/words/swedish/net/basic-conversions/_index.md @@ -23,7 +23,7 @@ Grundläggande konverteringar guidar dig genom grundläggande dokumentkonverteri | --- | --- | | [Konvertera dokument till docx](./doc-to-docx/) | Lär dig hur du konverterar DOC till DOCX med Aspose.Words för .NET. Steg-för-steg-guide med kodexempel. Perfekt för utvecklare. | | [Konvertera Docx till Rtf](./docx-to-rtf/) | Lär dig hur du konverterar DOCX till RTF med Aspose.Words för .NET med vår steg-för-steg-guide. Enkel konvertering för sömlös dokumentbehandling. | -| [Konvertera Word-fil till PDF](./docx-to-pdf/) Lär dig hur du enkelt konverterar Word-filer till PDF med Aspose.Words för .NET med vår guide. Perfekt för utvecklare som söker snabb och pålitlig dokumentkonvertering. | +| [Konvertera Word-fil till PDF](./docx-to-pdf/) Lär dig hur du enkelt konverterar Word-filer till PDF med Aspose.Words för .NET med vår guide. Perfekt för utvecklare som söker snabb och pålitlig dokumentkonvertering. | | [Konvertera Docx till Byte](./docx-to-byte/) | Lär dig hur du konverterar Docx till byte array i .NET med hjälp av Aspose.Words för effektiv dokumenthantering. Steg-för-steg-guide ingår. | | [Konvertera Docx till Epub](./docx-to-epub/) | Konvertera DOCX till EPUB enkelt med Aspose.Words för .NET. Följ vår handledning för sömlös integration i dina .NET-applikationer. | | [Konvertera docx till mhtml och skicka e-post](./docx-to-mhtml-and-sending-email/) | Lär dig hur du konverterar DOCX till MHTML och skickar e-postmeddelanden med Aspose.Words för .NET i den här steg-för-steg-guiden. Öka din produktivitet med enkel automatisering. | @@ -35,6 +35,7 @@ Grundläggande konverteringar guidar dig genom grundläggande dokumentkonverteri | [Exportera LaTeX från Word – steg‑för‑steg‑guide](./how-to-export-latex-from-word-step-by-step-guide/) | Lär dig hur du exporterar LaTeX från ett Word-dokument med Aspose.Words för .NET i en tydlig steg‑för‑steg‑guide. | | [Konvertera Word till PDF i C# med Aspose.Words – Guide](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Lär dig hur du konverterar Word-dokument till PDF i C# med Aspose.Words. Steg‑för‑steg‑guide med kodexempel. | | [Spara Word som PDF med Aspose.Words – Komplett C#-guide](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Lär dig hur du sparar Word-dokument som PDF med Aspose.Words i C#. Steg‑för‑steg‑guide med kodexempel. | +| [Konvertera Word till PDF med Aspose.Words – Komplett guide](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Lär dig hur du konverterar Word-dokument till PDF med Aspose.Words i en komplett steg‑för‑steg‑guide med kodexempel. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/swedish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/swedish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..e47473eda1 --- /dev/null +++ b/words/swedish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,245 @@ +--- +category: general +date: 2026-03-27 +description: Konvertera Word till PDF snabbt med Aspose.Words. Lär dig hur du sparar + Word som PDF, exporterar docx till PDF och skapar tillgänglig PDF i C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: sv +og_description: Konvertera Word till PDF i C# med Aspose.Words. Denna guide visar + hur du sparar Word som PDF, exporterar DOCX till PDF och skapar tillgänglig PDF. +og_title: Konvertera Word till PDF med Aspose.Words – Steg för steg +tags: +- Aspose.Words +- C# +- PDF conversion +title: Konvertera Word till PDF med Aspose.Words – Komplett guide +url: /sv/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Konvertera Word till PDF med Aspose.Words – Komplett guide + +Har du någonsin undrat hur man **konvertera Word till PDF** utan att pilla med tredjeparts webverktyg? Kanske bygger du en automatiserad rapportmotor och behöver ett pålitligt sätt att *spara word som pdf* i farten. Den goda nyheten är att Aspose.Words gör hela processen enkel, och du kan till och med skapa en **PDF/UA‑2**‑kompatibel fil—perfekt för tillgänglighetskrav. + +I den här handledningen går vi igenom allt du behöver: läsa in en `.docx`, konfigurera PDF‑alternativen så att du kan *exportera docx till pdf* med PDF/UA‑kompatibilitet, och slutligen spara resultatet som en tillgänglig PDF. I slutet har du ett självständigt, produktionsklart kodsnutt som du kan lägga in i vilket .NET‑projekt som helst. + +![Convert Word to PDF using Aspose.Words](convert-word-to-pdf.png) + +## Vad du kommer att lära dig + +- **Why Aspose.Words** är ett solidt val för *generera tillgänglig pdf*-scenarier. +- De exakta stegen för att *spara dokument som pdf* med PDF/UA‑2‑kompatibilitet. +- Hur man hanterar vanliga edge cases som saknade teckensnitt eller lösenordsskyddade källfiler. +- Snabba tips för att felsöka outputen och verifiera tillgänglighetskompatibilitet. + +### Förutsättningar + +- .NET 6 eller senare (API:et fungerar även på .NET Framework 4.6+). +- En giltig Aspose.Words för .NET-licens (gratis provversion fungerar för utvärdering). +- Grundläggande C#-kunskaper—inga avancerade mönster krävs. + +Om du har kryssat i dessa rutor, låt oss dyka ner. + +--- + +## Konvertera Word till PDF – Steg‑för‑steg‑implementation + +Vi delar upp lösningen i fem tydliga steg. Varje steg har en rubrik, ett kort kodexempel och en förklaring till *varför* koden är viktig. + +### Steg 1: Läs in Word-dokumentet du vill konvertera + +Det första du behöver är ett `Document`-objekt som representerar källfilen. Aspose.Words läser **.docx**, **.doc**, **.rtf** och många andra format, så du kan *spara word som pdf* oavsett hur filen ursprungligen skapades. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Varför detta är viktigt:** +- Att ladda filen tidigt låter dig fånga fel för saknad fil innan du slösar CPU‑cykler. +- `Document`-klassen abstraherar bort den interna strukturen i en Word-fil, vilket ger dig en ren objektmodell att arbeta med. + +### Steg 2: Konfigurera PDF‑sparalternativ för tillgänglighet + +Om du behöver *generate accessible pdf*-filer måste du instruera Aspose.Words att producera ett PDF/UA‑2‑kompatibelt dokument. `PdfSaveOptions`-klassen ger dig fin‑granulerad kontroll över outputen. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Varför detta är viktigt:** +- `PdfCompliance.PdfUa2` instruerar biblioteket att lägga till nödvändiga taggar, strukturinformation och metadata som skärmläsare förlitar sig på. +- Inbäddning av teckensnitt (`EmbedFullFonts = true`) förhindrar de fruktade “font not found”-varningarna när PDF:en öppnas på ett annat OS. +- Att sätta ett `Title` hjälper hjälpmedel att korrekt annonsera dokumentet. + +### Steg 3: Spara dokumentet som PDF + +Nu när källan är inläst och alternativen är satta är den faktiska konverteringen en enradare. Här är där du *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Varför detta är viktigt:** +- `Save`-metoden respekterar de `PdfSaveOptions` vi konfigurerade, vilket garanterar att tillgänglighetsfunktionerna är inbäddade. +- Att omsluta anropet i ett `try/catch`-block ger dig möjlighet att logga eller visa eventuella licens- eller behörighetsfel som ofta får nybörjare att snubbla. + +### Steg 4: Verifiera PDF/UA‑kompatibilitet (Valfritt men rekommenderat) + +Även om Aspose.Words gör det tunga arbetet är det god praxis att dubbelkolla outputen, särskilt när du levererar dokument till myndigheter eller andra reglerade enheter. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Varför detta är viktigt:** +- `IsTagged` är en snabb kontroll; full PDF/UA‑validering kräver en dedikerad validator, men de flesta kompatibilitetsproblem visar sig som saknade taggar. +- Om flaggan returnerar `false` kan du gå tillbaka till `PdfSaveOptions`—kanske glömde du att sätta `Compliance` eller så saknade källdokumentet korrekta rubrikstilar. + +### Steg 5: Vanliga fallgropar & pro‑tips + +| Fallgrop | Vad händer | Hur man åtgärdar | +|----------|------------|------------------| +| **Saknade teckensnitt** | Text visas som rutor i PDF:en. | Sätt `EmbedFullFonts = true` **eller** installera de saknade teckensnitten på servern. | +| **Olicensierat bibliotek** | Aspose lägger till ett vattenstämpel på varje sida. | Lägg till din licensfil (`Aspose.Words.lic`) tidigt i appen (t.ex. `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Lösenordsskyddad källa** | `InvalidOperationException` på `new Document(path)`. | Använd overloaden `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Stora dokument orsakar OOM** | Out‑of‑memory‑undantag på stora filer. | Aktivera `MemoryOptimization` i `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Tillgänglighetstaggar saknas** | PDF/UA‑validering misslyckas. | Säkerställ att käll‑Word‑filen använder korrekta rubrikstilar (`Heading 1`, `Heading 2`, etc.)—Aspose mappar dessa till PDF‑taggar automatiskt. | + +**Pro‑tips:** Om du konverterar många dokument i ett batch, återanvänd en enda `PdfSaveOptions`-instans. Att skapa den en gång minskar allokeringskostnaden och håller ditt minnesavtryck lågt. + +## Fullt fungerande exempel (Kopiera‑klistra redo) + +Nedan är det kompletta programmet som sätter ihop allt. Spara det som `Program.cs`, lägg till Aspose.Words- och Aspose.PDF‑paketen via NuGet, och kör. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Förväntat resultat:** +En fil kallad `output.pdf` visas i `C:\MyFiles`. När du öppnar den i Adobe Acrobat visas “PDF/A‑2b, PDF/UA‑1” i kompatibilitetspanelen, vilket bekräftar att du framgångsrikt *konvertera word till pdf*. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/swedish/net/programming-with-markdownsaveoptions/_index.md b/words/swedish/net/programming-with-markdownsaveoptions/_index.md index ccb402999a..83e5e58079 100644 --- a/words/swedish/net/programming-with-markdownsaveoptions/_index.md +++ b/words/swedish/net/programming-with-markdownsaveoptions/_index.md @@ -39,7 +39,7 @@ Lär dig konvertera DOCX-filer till Markdown med en detaljerad steg‑för‑ste Lär dig spara DOCX-filer som Markdown med en komplett C#-guide som inkluderar LaTeX‑ekvationer. ### [Spara docx som markdown – Fullständig C#-guide med bildextraktion](./save-docx-as-markdown-full-c-guide-with-image-extraction/) -Lär dig spara DOCX-filer som Markdown och extrahera bilder med en komplett C#-guide. +Lär dig spara DOCX som Markdown och extrahera bilder med en komplett C#-guide. ### [Hur man exporterar Markdown från Word – Fullständig C#-guide](./how-to-export-markdown-from-word-complete-c-guide/) Lär dig exportera Word-dokument till Markdown med en komplett C#‑guide som täcker alla steg. @@ -50,6 +50,15 @@ Lär dig spara DOCX som Markdown med en detaljerad steg‑för‑steg‑guide i ### [Hur man exporterar Markdown från DOCX – Fullständig guide](./how-to-export-markdown-from-docx-complete-guide/) Lär dig exportera Markdown från DOCX-filer med en komplett guide i C#. +### [Hur man exporterar LaTeX från Word – Konvertera DOCX till Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) +Lär dig exportera LaTeX från Word och konvertera DOCX-filer till Markdown med en komplett guide i C#. + +### [Hur man exporterar LaTeX från DOCX – Konvertera till Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) +Lär dig exportera LaTeX från DOCX och konvertera till Markdown med en komplett C#‑guide. + +### [Skapa markdown från Word – Fullständig C#‑guide](./create-markdown-from-word-full-c-guide/) +Lär dig skapa markdown från Word-dokument med en komplett C#‑guide. + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/swedish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/swedish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..fda6f14e90 --- /dev/null +++ b/words/swedish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Skapa markdown från Word med Aspose.Words C#. Lär dig att konvertera + docx till markdown, extrahera bilder från Word och hur du använder callback i en + enda handledning. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: sv +og_description: Skapa markdown från Word med Aspose.Words. Den här guiden visar hur + du konverterar docx till markdown, extraherar bilder från Word och använder en återuppringning + för resurshantering. +og_title: Skapa markdown från Word – Komplett C#‑handledning +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Skapa markdown från Word – Fullständig C#‑guide +url: /sv/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Skapa markdown från Word – Komplett C#‑handledning + +Har du någonsin behövt **skapa markdown från Word** men inte vetat var du ska börja? Du är inte ensam; många utvecklare stöter på detta hinder när de försöker flytta innehåll från en .docx‑fil till en static‑site‑generator eller ett dokumentations‑repo. Den goda nyheten? Med Aspose.Words kan du **konvertera docx till markdown**, extrahera varje bild från den ursprungliga filen och exakt styra var dessa resurser hamnar – allt med ett enkelt callback. + +I den här guiden går vi igenom ett verkligt exempel som visar hur du extraherar bilder från Word, hur du använder ett callback för att lagra dem, och varför detta tillvägagångssätt är det mest pålitliga för automatiserings‑pipelines. När du är klar har du ett färdigt C#‑program som producerar en ren `.md`‑fil och en mapp med extraherade bilder. + +> **Proffstips:** Om du redan har en Word‑mall som innehåller skärmdumpar, diagram eller logotyper, bevarar den här metoden varje visuellt element utan att du behöver kopiera‑klistra manuellt. + +--- + +## Vad du behöver + +- **.NET 6+** (eller .NET Framework 4.6+). Koden fungerar på alla moderna runtime‑miljöer. +- **Aspose.Words for .NET** (NuGet‑paket `Aspose.Words`). Den kostnadsfria trial‑versionen räcker för de flesta scenarier. +- Ett **Word‑dokument** (`input.docx`) som innehåller text och minst en bild. +- Grundläggande kunskaper i C# och Visual Studio (eller din favorit‑IDE). + +Inga extra bibliotek behövs – allt annat hanteras av Aspose.Words självt. + +--- + +## Steg 1: Skapa projektet och installera Aspose.Words + +För att hålla det organiserat, starta ett nytt konsolprojekt: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Varför detta steg är viktigt:** Att installera NuGet‑paketet säkerställer att du har den senaste API:n, som inkluderar klassen `MarkdownSaveOptions` som introducerades i version 22.9. Utan den skulle du behöva skriva en egen konverterare. + +--- + +## Steg 2: Läs in källdokumentet i Word + +Den första kodraden öppnar den `.docx` du vill omvandla. Ersätt `YOUR_DIRECTORY` med den faktiska sökvägen på din maskin. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Vad händer?** `Document` analyserar filen, bygger ett internt DOM‑träd och gör varje stycke, tabell och bild åtkomlig. Om filen saknas kastar Aspose ett tydligt `FileNotFoundException`, som du kan fånga för en mer elegant UI‑hantering. + +--- + +## Steg 3: Konfigurera Markdown‑spara‑alternativ med ett resursspar‑callback + +Här kommer magin med **hur man använder callback** in i bilden. Callback‑metoden låter dig bestämma var varje extraherad bild placeras. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Varför ett callback?** Som standard skulle Aspose bädda in bilder som base‑64‑strängar i markdown‑filen – en mardröm för versionskontroll. Callback‑metoden ger dig full kontroll över filnamn och mappstruktur. + +--- + +## Steg 4: Spara dokumentet som Markdown + +Nu genererar vi faktiskt `.md`‑filen. Alla bilder överlämnas till callback‑metoden som definieras i nästa steg. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Om allt går bra hittar du `Document.md` i mål‑mappen samt en undermapp som heter `Resources` med varje bild som extraherats från original‑Word‑filen. + +--- + +## Steg 5: Implementera callback‑metoden som lagrar varje extraherad bild + +Nedan finns den fullständiga implementationen av `MyResourceSaver`. Den skapar en `Resources`‑katalog (om den inte redan finns), bygger ett unikt filnamn för varje bild och skriver bildströmmen till disk. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Förklaring av argumenten:** +> - `args.Index` – en noll‑baserad räknare som garanterar unikhet. +> - `args.FileName` – det ursprungliga filnamnet som Aspose föreslår (ofta något i stil med `image001.png`). +> - `args.Stream` – utströmmen där bildens byte‑data skrivs. +> - `args.KeepResourceStreamOpen` – sätts till `false` så att Aspose automatiskt disponerar strömmen och förhindrar fil‑handtags‑läckor. + +--- + +## Fullt fungerande exempel + +Sätter vi ihop allt får du en enda fil som du kan kopiera‑klistra in i `Program.cs`. Kom ihåg att ersätta `YOUR_DIRECTORY` med en absolut eller relativ sökväg som passar din miljö. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Förväntad utdata + +- `YOUR_DIRECTORY/Document.md` – en markdown‑fil med vanliga markdown‑bildlänkar, t.ex.: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – innehåller `img_0.png`, `img_1.jpg` osv., i samma ordning som de förekom i original‑Word‑dokumentet. + +När programmet körs skrivs en vänlig bekräftelse ut som visar att processen lyckades. + +--- + +## Vanliga frågor (FAQ) + +### Hur extraherar jag bilder från Word utan att förlora kvalitet? + +Callback‑metoden skriver den råa binära strömmen direkt till en fil, vilket bevarar den ursprungliga upplösningen. Ingen konvertering eller komprimering sker om du inte själv lägger till bild‑behandlingslogik i `ResourceSaving`. + +### Kan jag ändra bildformatet (t.ex. PNG → JPEG) under extraktionen? + +Absolut. Inuti `ResourceSaving` kan du inspektera `args.FileName` eller `args.Stream`, ladda bilden med `System.Drawing` eller `ImageSharp` och sedan åter‑koda den innan du skriver. Glöm bara inte att uppdatera filändelsen i markdown‑länken. + +### Vad gör jag om markdown‑filerna ska referera till ett CDN istället för en lokal mapp? + +Modifiera callback‑metoden så att den lägger till en bas‑URL framför markdown‑länken. Det kan du göra genom att sätta `args.FileName` till en fullständig URL efter att du har laddat upp bilden till ditt CDN. + +### Fungerar detta med tabeller, fotnoter eller andra avancerade Word‑funktioner? + +Ja. Aspose.Words översätter de flesta Word‑konstruktioner till markdown‑ekvivalenter. Tabeller blir markdown‑tabeller, fotnoter blir referenslänkar och även nästlade listor hanteras korrekt. Om något ser konstigt ut, kolla de senaste release‑noterna – Aspose förbättrar kontinuerligt konverteringsnoggrannheten. + +### Hur konverterar jag docx till markdown i en CI/CD‑pipeline? + +Lägg bara den kompilerade `.exe`‑filen i dina byggsteg, peka den på de genererade `.docx`‑artefakterna och pusha de resulterande `.md`‑ och `Resources/`‑mapparna till ditt static‑site‑repo. Eftersom processen är helt deterministisk fungerar den utmärkt i automatiserade miljöer. + +--- + +## Avslutning + +Vi har just demonstrerat hur du **skapar markdown från Word** med Aspose.Words, gått igenom hela **konvertera docx till markdown**‑arbetsflödet och visat ett praktiskt sätt att **extrahera bilder från Word** med en anpassad **hur man använder callback**‑implementation. Resultatet är en ren markdown‑fil tillsammans med en mapp av originalbilder – perfekt för dokumentationssajter, statiska bloggar eller alla arbetsflöden som föredrar rena textformat. + +Nästa steg du kan överväga: + +- **Batch‑behandling** av flera `.docx`‑filer i en mapp (loopa över `Directory.GetFiles`). +- **Anpassade namngivningsscheman** för bilder (t.ex. med bildtextens ursprungliga text). +- **Efterbehandling** av markdown för att ersätta bildlänkar med CDN‑URL:er. +- Utforska **andra Aspose‑exportformat** som HTML, PDF eller EPUB för multikanal‑publicering. + +Har du fler frågor eller en knepig Word‑fil som vägrar konverteras? Lämna en kommentar nedan så felsöker vi tillsammans. Lycka till med kodandet, och njut av enkelheten i att förvandla Word till markdown! + +--- + +![Diagram som visar Word‑till‑Markdown‑konverteringsprocessen](image.png "Skapa markdown från Word‑diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/swedish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/swedish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..5cc5915558 --- /dev/null +++ b/words/swedish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Hur man exporterar LaTeX från DOCX med Aspose.Words. Lär dig konvertera + DOCX till Markdown, ställa in DPI och aktivera återställning i C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: sv +og_description: Hur man exporterar LaTeX från DOCX med Aspose.Words. Denna handledning + visar steg‑för‑steg konvertering till Markdown, DPI‑kontroll och återställningsläge. +og_title: Hur man exporterar LaTeX från DOCX – Konvertera till Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Hur man exporterar LaTeX från DOCX – Konvertera till Markdown +url: /sv/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hur man exporterar LaTeX från DOCX – Konvertera till Markdown + +Har du någonsin undrat **how to export LaTeX** från en DOCX‑fil utan att förlora skönheten i dina ekvationer? Du är inte ensam. Enligt min erfarenhet är den största smärtan att få dessa OfficeMath‑objekt till ett rent, portabelt format för static‑site generators eller vetenskapliga bloggar. + +I den här guiden går vi igenom hur du konverterar DOCX till Markdown med Aspose.Words, samtidigt som vi visar **how to set DPI**, **how to enable recovery**, och några praktiska knep för en robust pipeline. När du är klar har du ett enda C#‑program som producerar en Markdown‑fil med LaTeX‑ekvationer, högupplösta bilder och korrekt hantering av hyperlänkar. + +## Vad du behöver + +- **.NET 6+** (eller .NET Framework 4.7.2 – API‑et fungerar likadant) +- **Aspose.Words for .NET** (den senaste stabila versionen i mars 2026) +- En DOCX‑fil som innehåller ekvationer, bilder och länkar +- Visual Studio, VS Code eller någon annan editor du föredrar + +Inga extra NuGet‑paket krävs utöver Aspose.Words, men se till att du har en giltig licens om du inte använder provversionen. + +## Steg 1 – Ladda DOCX med Strict Recovery Mode + +Innan vi ens tänker på export måste vi försäkra oss om att källdokumentet inte döljer korruption. Det är här **how to enable recovery** kommer in i bilden. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Varför strikt återhämtning?** +Om du låter Aspose tyst fixa problem kan du sluta med saknade stycken eller trasiga bilder – något ingen vill ha när man exporterar LaTeX. Genom att misslyckas snabbt kan du fånga problemet tidigt och avgöra om du ska fixa källdokumentet eller logga problemet för senare. + +### Proffstips +Wrapa laddningen i ett try/catch‑block och logga `DocumentLoadingException`. På så sätt kan din CI‑pipeline flagga problematiska filer utan att stoppa hela bygget. + +## Steg 2 – Förbered Markdown Exportalternativ + +Nu när dokumentet säkert ligger i minnet konfigurerar vi hur det ska sparas. Detta är hjärtat av **how to export latex** och täcker också **how to set DPI** för inbäddade bilder. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Vad varje alternativ gör** + +| Alternativ | Orsak | Relevans för nyckelord | +|------------|-------|------------------------| +| `OfficeMathExportMode = LaTeX` | Svarar direkt på **how to export latex** från ekvationer. | Primärt nyckelord | +| `ImageResolution = 300` | Styr bildkvalitet – svaret på **how to set dpi**. | Sekundär | +| `ResourceSavingCallback` | Sparar inbäddade filer till disk, ett vanligt behov när **convert docx to markdown**. | Sekundär | +| `EmptyParagraphExportMode` | Säkerställer ren Markdown‑utmatning, förhindrar lösa HTML‑taggar. | Förbättrar den övergripande konverteringskvaliteten | +| `LinkExportMode = AsReference` | Gör länkar lätta att läsa och redigera, ytterligare ett plus för **convert docx to markdown**. | | + +## Steg 3 – Implementera en anpassad resurssparare (valfritt men praktiskt) + +När du konverterar DOCX till Markdown behöver bilder och andra binära resurser en plats i filsystemet. Aspose låter dig kontrollera detta med `IResourceSavingCallback`. Snutten ovan visar redan en minimal implementation, men låt oss gå igenom den: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Varför bry sig?** +Om du hoppar över detta steg kommer Aspose att bädda in bilder som base‑64‑strängar, vilket blåser upp Markdown‑filens storlek och gör versionskontroll smärtsam. Genom att spara resurser i en separat mapp håller du Markdown‑filen lättviktig och gör den vänlig för static‑site generators som Hugo eller Jekyll. + +## Steg 4 – Spara dokumentet som Markdown + +Allt tungt arbete är gjort. En rad skriver nu den slutgiltiga filen. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Öppna `output.md` och du kommer att se: + +- Ekvationer renderade som `$…$` LaTeX‑block +- Bilder refererade som `![Alt text](resources/image001.png)` med 300 dpi‑upplösning +- Hyperlänkar omvandlade till referensstil: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Det är hela **how to convert docx**‑processen i ett nötskal. + +## Vanliga frågor & edge‑cases + +### 1️⃣ Vad händer om DOCX innehåller objekt som inte stöds? +Aspose.Words kommer att kasta ett `FeatureNotSupportedException`. Eftersom vi använde **how to enable recovery** i strikt läge visas undantaget omedelbart. Du kan antingen: + +- Byta `RecoveryMode` till `RecoveryMode.Default` för en bästa‑möjliga konvertering, **eller** +- Förprocessa DOCX (t.ex. ta bort osupporterad SmartArt) innan du kör konverteraren. + +### 2️⃣ Kan jag ändra DPI per bild? +Inställningen `ImageResolution` är global. För per‑bild‑kontroll, implementera en anpassad `ImageSavingCallback` liknande `MyResourceSaver` och justera `args.ImageResolution` baserat på `args.ImageFileName` eller metadata. + +### 3️⃣ Hur bäddar jag in den genererade LaTeX i en Jekyll‑site? +Jekylls inbyggda MathJax‑stöd fungerar direkt. Se bara till att ditt layout‑template inkluderar MathJax‑scriptet och att LaTeX‑blocken är omslutna av `$$` för display‑ekvationer eller `$` för inline. + +### 4️⃣ Är detta kompatibelt med .NET Core på Linux? +Absolut. Aspose.Words är plattformsoberoende. Se bara till att `YOUR_DIRECTORY`‑sökvägen följer Linux‑konventioner (t.ex. `/home/user/docs`). + +## Fullt fungerande exempel + +Nedan är ett kopiera‑och‑klistra‑klart program. Ersätt `YOUR_DIRECTORY` med en faktisk sökväg på din maskin. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Förväntad utmatning** – öppna `output.md` och du bör se något i stil med: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Om du öppnar filen i en Markdown‑preview som stödjer MathJax, renderas integralen. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/swedish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/swedish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..3ca8247e09 --- /dev/null +++ b/words/swedish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,211 @@ +--- +category: general +date: 2026-03-27 +description: Hur man exporterar LaTeX från Word-dokument med Aspose.Words – konvertera + DOCX till Markdown med ekvationer som LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: sv +og_description: Hur man exporterar LaTeX från Word-dokument förklaras i den första + meningen, och visar hur du konverterar DOCX till Markdown med ekvationer som LaTeX. +og_title: Hur du exporterar LaTeX från Word – Komplett guide +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Hur man exporterar LaTeX från Word – Konvertera DOCX till Markdown +url: /sv/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Så exporterar du LaTeX från Word – Konvertera DOCX till Markdown + +Har du någonsin undrat **hur man exporterar LaTeX** från en Word‑fil utan att sluta med en massa PNG‑bilder? Du är inte ensam; utvecklare stöter ständigt på detta problem när de behöver rena, redigerbara ekvationer för statiska webbplatser eller vetenskapliga bloggar. Den goda nyheten? Med Aspose.Words kan du **konvertera Word till Markdown** och behålla varje OfficeMath‑objekt som native LaTeX—ingen efterbehandling krävs. + +I den här handledningen går vi igenom hela processen för att **spara ett Word‑dokument som Markdown** samtidigt som vi **exporterar ekvationer som LaTeX**. I slutet har du ett körbart C#‑snutt, en tydlig förklaring av varje alternativ och tips för att hantera kantfall som komplexa formler eller blandat innehåll. Inga externa verktyg, bara ett enda NuGet‑paket och några rader kod. + +## Vad du behöver + +- .NET 6+ (eller .NET Framework 4.7.2 och högre) – den senaste runtime fungerar bäst. +- Visual Studio 2022 eller någon editor som kan kompilera C#‑projekt. +- En Aspose.Words för .NET‑licens (gratis provversion fungerar för experiment). +- En DOCX‑fil som innehåller minst en ekvation (OfficeMath). + +Om du redan har dem, bra—låt oss dyka in. + +## Så exporterar du LaTeX från Word – Översikt + +Nedan är en översiktlig vy av de involverade stegen: + +1. **Install** Aspose.Words NuGet‑paketet. +2. **Load** käll‑`.docx`‑filen som innehåller dina ekvationer. +3. **Configure** `MarkdownSaveOptions` så att `OfficeMathExportMode` är satt till `LaTeX`. +4. **Save** dokumentet som en `.md`‑fil. +5. **Verify** att den genererade Markdown‑filen innehåller LaTeX‑block (`$$…$$`). + +![Diagram som visar flödet från DOCX till Markdown med LaTeX ekvationer](how-to-export-latex.png){alt="Hur man exporterar latex från Word diagram"} + +## Steg 1 – Installera Aspose.Words för .NET (konvertera word till markdown) + +Först och främst: du behöver biblioteket som faktiskt gör det tunga arbetet. Öppna din terminal (eller Package Manager Console) och kör: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** Om du använder Visual Studio, högerklicka på projektet → *Manage NuGet Packages* → sök efter “Aspose.Words” och installera den senaste stabila versionen. + +Varför detta är viktigt: Aspose.Words abstraherar Open XML‑formatet, vilket ger dig ett rent API för att manipulera Word‑dokument utan att själv hantera låg‑nivå‑XML. Det levereras också med inbyggt stöd för att konvertera OfficeMath till LaTeX, vilket är kärnan i vårt krav på **exportera ekvationer som LaTeX**. + +## Steg 2 – Ladda DOCX‑filen (hur man konverterar docx) + +Nu när paketet är på plats, ladda filen du vill omvandla. Ersätt `YOUR_DIRECTORY` med sökvägen där din `.docx`‑fil finns: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Varför ladda den på detta sätt?** `Document`‑konstruktorn parsar hela filen till en objektmodell, vilket ger dig omedelbar åtkomst till stycken, tabeller och—framför allt—OfficeMath‑objekt. Om filen saknas eller är korrupt, kastar Aspose ett beskrivande `FileNotFoundException`, som du kan fånga för smidig felhantering. + +## Steg 3 – Konfigurera MarkdownSaveOptions (exportera ekvationer som latex) + +Magin sker i `MarkdownSaveOptions`‑objektet. Som standard renderar Aspose ekvationer som PNG‑bilder, men vi vill ha LaTeX. Sätt `OfficeMathExportMode` till `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +En snabb notering om de valfria flaggorna: `ExportImagesAsBase64` instruerar Aspose att inte bädda in binär data, vilket håller Markdown‑filen ren. `ExportHeadersFooters` säkerställer att du inte förlorar någon kontext som kan finnas i dessa sektioner—användbart när rubriken innehåller en titel eller författarnamn. + +## Steg 4 – Spara dokumentet (spara word som markdown) + +Till sist, skriv det transformerade innehållet till en `.md`‑fil: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Efter att den här raden har körts hittar du `output.md` bredvid din källfil. Öppna den i någon textredigerare så bör du se LaTeX‑block som ser ut så här: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Det är **spara word som markdown**‑delen klar—inga extra konverteringssteg behövs. + +## Steg 5 – Verifiera resultatet (exportera ekvationer som latex) + +Det är lätt att förbise verifiering, men en snabb kontroll sparar timmar senare. Kör ett enkelt skript som läser den genererade filen och skriver ut det första LaTeX‑blocket: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Om du ser `First LaTeX block: $$ … $$` skrivet, har du lyckats **exportera LaTeX** från Word. Om inte, dubbelkolla att ditt källdokument faktiskt innehåller OfficeMath‑objekt; vanliga textekvationer konverteras inte. + +## Hantera vanliga kantfall + +| Scenario | Vad att hålla utkik efter | Rekommenderad åtgärd | +|----------|---------------------------|----------------------| +| **Blandade bilder & ekvationer** | Aspose kan fortfarande bädda in bilder för grafik som inte är OfficeMath. | Sätt `ExportImagesAsBase64 = false` och behåll bilder som externa filer, referera dem sedan manuellt i Markdown. | +| **Komplexa nästlade ekvationer** | Mycket djup nästning kan producera LaTeX som kräver manuell justering. | Efterbehandla blocket med en LaTeX‑formatterare (t.ex. `latexindent`) eller justera `mdOptions` → `ExportMathAsDisplay = true`. | +| **Stora dokument** | Minnesanvändning ökar kraftigt när stora `.docx`‑filer laddas. | Använd `LoadOptions` med `LoadFormat.Docx` och aktivera strömning via `LoadOptions.LoadFormat` om tillgängligt. | +| **Saknad licens** | Gratisprovversionen lägger till en vattenstämpelkommentar i resultatet. | Applicera en giltig licens via `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Dessa tips håller ditt arbetsflöde robust, särskilt när du **konverterar word till markdown** i produktionspipelines. + +## Fullt fungerande exempel (Alla steg i en fil) + +Nedan är en fristående konsolapp som du kan kopiera‑klistra in i ett nytt .NET‑projekt och köra omedelbart. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Kör programmet, öppna `output.md`, och du kommer att se dina ekvationer renderade som ren LaTeX. Det är det kompletta svaret på **hur man exporterar latex** från ett Word‑dokument. + +## Slutsats + +Vi har gått igenom **hur man exporterar LaTeX** från Word steg för steg, och visat hur du **konverterar Word till markdown**, **sparar word som markdown**, och **exporterar ekvationer som LaTeX** med Aspose.Words. Kärnidén är enkel: ladda DOCX‑filen, justera `MarkdownSaveOptions` och låt biblioteket göra det tunga arbetet. + +Om du är redo att automatisera dokumentationspipelines, prova att kedja denna kod med en statisk webbplatsgenerator som Hugo eller Jekyll—pusha bara de genererade `.md`‑filerna till ditt repo och låt sidan byggas om. För vidare läsning, utforska Asposes “Export to LaTeX”-guide, experimentera med `HtmlSaveOptions` för webb‑förhandsvisningar, eller dyka ner i `DocumentVisitor`‑API:t för anpassade transformationer. + +Har du frågor om kantfall, licensiering eller hur du integrerar detta i CI/CD? Lämna en kommentar nedan, och lycka till med kodandet! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/swedish/net/programming-with-pdfsaveoptions/_index.md b/words/swedish/net/programming-with-pdfsaveoptions/_index.md index 7a4b38c484..87ee39dec6 100644 --- a/words/swedish/net/programming-with-pdfsaveoptions/_index.md +++ b/words/swedish/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ Oavsett om du vill konvertera Word-dokument till PDF för onlinedistribution, ar | [Uppdatera senast utskrivna egenskap i PDF-dokument](./update-last-printed-property/) | Lär dig hur du uppdaterar den senast utskrivna egenskapen i ett PDF-dokument med Aspose.Words för .NET med vår steg-för-steg-guide. | | [Rendera 3D DML 3DEffects i ett PDF-dokument](./dml-3deffects-rendering/) | Lär dig hur du renderar fantastiska 3D DML-effekter i PDF-dokument med Aspose.Words för .NET med den här omfattande steg-för-steg-guiden. | | [Interpolera bilder i ett PDF-dokument](./interpolate-images/) | Lär dig hur du interpolerar bilder i ett PDF-dokument med Aspose.Words för .NET med vår steg-för-steg-guide. Förbättra enkelt bildkvaliteten på din PDF. | - +| [Spara PDF från DOCX med Aspose.Words – Steg‑för‑steg‑guide](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Lär dig hur du konverterar ett DOCX-dokument till PDF med Aspose.Words i en enkel steg‑för‑steg‑guide. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/swedish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/swedish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..0950ca62f6 --- /dev/null +++ b/words/swedish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-03-27 +description: Lär dig hur du sparar PDF från en DOCX‑fil med Aspose.Words. Inkluderar + konvertering av docx till pdf, spara pdf med alternativ och hantering av flytande + former. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: sv +og_description: Hur man sparar PDF från en DOCX-fil med Aspose.Words. Denna guide + visar hur man konverterar docx till pdf, sparar pdf med alternativ och hanterar + flytande former. +og_title: Hur man sparar PDF från DOCX – Komplett Aspose.Words-handledning +tags: +- Aspose.Words +- C# +- PDF conversion +title: Hur man sparar PDF från DOCX med Aspose.Words – Steg‑för‑steg‑guide +url: /sv/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hur man sparar PDF från DOCX med Aspose.Words – Komplett handledning + +Har du någonsin undrat **hur man sparar PDF** från ett Word‑dokument utan att förlora layouten för flytande former? Du är inte ensam. I många projekt—fakturageneratorer, rapportexportörer eller enkla dokumentarkiv—behöver utvecklare ett pålitligt sätt att konvertera DOCX till PDF samtidigt som allt ser exakt ut som i Word. + +I den här handledningen går vi igenom hur man konverterar en DOCX‑fil till PDF **med Aspose.Words för .NET**, visar dig **hur man konverterar docx till pdf** med anpassade sparalternativ, och förklarar varför flaggan `ExportFloatingShapesAsInlineTag` är viktig. I slutet har du ett färdigt kodexempel som sparar PDF med de alternativ du styr. + +## Vad du kommer att lära dig + +- De exakta stegen för att **konvertera word document pdf** med Aspose.Words. +- Hur man konfigurerar `PdfSaveOptions` för att behandla flytande former som inline‑taggar. +- Vanliga fallgropar när man hanterar flytande objekt och hur man undviker dem. +- Ett komplett, körbart C#‑program som du kan lägga in i vilket .NET‑projekt som helst. + +> **Förutsättning:** Du behöver en Aspose.Words för .NET‑licens (eller en gratis utvärdering) och en .NET‑utvecklingsmiljö (Visual Studio, Rider eller `dotnet`‑CLI). + +## Steg 1: Ställ in projektet och lägg till Aspose.Words + +Först, skapa en ny konsolapp (eller lägg till i en befintlig) och referera till Aspose.Words‑paketet via NuGet. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Proffstips:** Om du kör på en CI‑server, lås paketversionen (`Aspose.Words --version 24.10`) för att garantera reproducerbara byggen. + +## Steg 2: Ladda DOCX‑filen som innehåller flytande former + +Flytande bilder, textrutor eller SmartArt kan orsaka layoutförändringar vid konvertering. Att ladda dokumentet är enkelt, men vi kommer också att verifiera att filen finns för att undvika ett runtime‑`FileNotFoundException`. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Observera `Console.WriteLine`‑satserna—de ger dig snabb återkoppling när du kör appen från en terminal. + +## Steg 3: Konfigurera PDF‑sparalternativ (Spara PDF med alternativ) + +Här sker magin. Som standard försöker Aspose.Words bevara flytande objekt som de visas, vilket kan förstöra layouten i den resulterande PDF‑filen. Genom att sätta `ExportFloatingShapesAsInlineTag` till `true` instrueras biblioteket att behandla dessa former som inline‑taggar, så att de förblir förankrade i den omgivande texten. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Varför är detta viktigt? Föreställ dig en textruta som svävar över ett stycke. Utan inline‑tag‑konverteringen kan PDF‑filen skjuta ner stycket eller klippa bort rutan helt. Flaggan bevarar den visuella relationen—en subtil men avgörande detalj för professionella rapporter. + +## Steg 4: Spara dokumentet som PDF + +Nu skriver vi faktiskt PDF‑filen. Metoden `Save` tar både utdata‑sökvägen och de alternativ vi just konfigurerade. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +När programmet körs skapas `output.pdf` i samma mapp som din käll‑DOCX. Öppna den i någon PDF‑visare så bör du se att alla flytande former återges exakt där de hör hemma. + +## Fullt fungerande exempel + +Nedan är hela programmet i ett block. Kopiera‑klistra in det i `Program.cs` (eller någon C#‑fil) och tryck **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Förväntat resultat + +- **Fil skapad:** `output.pdf` i mål‑katalogen. +- **Layout‑fidelitet:** Flytande former (bilder, textrutor, SmartArt) visas inline med den omgivande texten. +- **Inga undantag:** Programmet avslutas smidigt och skriver statusmeddelanden till konsolen. + +## Vanliga frågor & kantfall + +| Fråga | Svar | +|----------|--------| +| **Vad händer om jag behöver högre bildkvalitet?** | Set `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Kan jag konvertera flera DOCX‑filer i en batch?** | Wrap the loading/saving logic in a `foreach (var file in Directory.GetFiles(..., "*.docx"))` loop. Remember to reuse a single `PdfSaveOptions` instance for performance. | +| **Fungerar detta med .NET Core?** | Absolutely. Aspose.Words 24.x supports .NET Standard 2.0+, so you can run the same code on Windows, Linux, or macOS. | +| **Vad händer med lösenordsskyddade DOCX‑filer?** | Load with `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. The same `PdfSaveOptions` apply when saving. | +| **Är inline‑tag‑konverteringen säker för komplexa tabeller?** | Generally yes, but very intricate table layouts with overlapping shapes may still need manual tweaking. Test a representative sample before a bulk migration. | + +## Tips för verkliga projekt + +- **Logga, inte bara `Console.WriteLine`** – I produktion, ersätt konsolutskrifter med ett loggningsramverk (Serilog, NLog) för att fånga fel. +- **Frigör resurser** – `Document` implementerar `IDisposable`. Lägg den i ett `using`‑block om du bearbetar många filer för att snabbt frigöra minne. +- **Validera PDF‑filen** – Använd en PDF‑validerare (t.ex. PDF/A‑kompatibilitetskontroll) om du behöver arkiveringsklassade PDF‑filer. +- **Parallell bearbetning** – För stora arbetsbelastningar, överväg `Parallel.ForEach` med trådsäkra `PdfSaveOptions` (klona per tråd) för att snabba upp konverteringen. + +## Slutsats + +Vi har gått igenom **hur man sparar PDF** från en DOCX‑fil med Aspose.Words, demonstrerat **hur man konverterar docx till pdf** med anpassade alternativ, och förklarat påverkan av `ExportFloatingShapesAsInlineTag`. Det kompletta, körbara exemplet visar att du kan **konvertera word document pdf** på bara några få rader, och du vet nu hur du **sparar pdf med alternativ** som passar ditt projekts kvalitets‑ och efterlevnadsbehov. + +Redo för nästa utmaning? Prova att exportera till andra format (t.ex. HTML, EPUB) med `document.Save("output.html")`, eller experimentera med PDF/A‑kompatibilitet för långsiktig arkivering. Samma principer—ladda, konfigurera alternativ, spara—gäller överallt. + +Lycka till med kodandet, och må dina PDF‑filer alltid se exakt ut som du tänkt! + +![Diagram som visar hur en DOCX‑fil laddas, alternativ tillämpas och en PDF skapas – hur man sparar pdf](https://example.com/images/how-to-save-pdf-diagram.png "hur man sparar pdf-diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/swedish/net/programming-with-shapes/_index.md b/words/swedish/net/programming-with-shapes/_index.md index 3404be8f85..d9ff8e486e 100644 --- a/words/swedish/net/programming-with-shapes/_index.md +++ b/words/swedish/net/programming-with-shapes/_index.md @@ -30,10 +30,11 @@ Genom att använda Aspose.Words för .NET och följa dessa handledningar kommer | [Layout i cell](./layout-in-cell/) | Lär dig hur du ställer in layouten i celler med Aspose.Words för .NET med den här omfattande guiden. Perfekt för utvecklare som vill anpassa Word-dokument. | | [Lägg till hörnklippta](./add-corners-snipped/) | Lär dig hur du lägger till en hörnklippt form i dina Word-dokument med Aspose.Words för .NET. Den här steg-för-steg-guiden gör att du enkelt kan förbättra dina dokument. | | [Hämta faktiska formgränspunkter](./get-actual-shape-bounds-points/) | Upptäck hur du får fram faktiska formgränser i Word-dokument med Aspose.Words för .NET. Lär dig exakt formmanipulation med den här detaljerade guiden. | -| [Vertikalt ankare](./vertical-anchor/) | Lär dig hur du ställer in vertikala ankarpositioner för textrutor i Word-dokument med Aspose.Words för .NET. Enkel steg-för-steg-guide ingår. +| [Vertikalt ankare](./vertical-anchor/) | Lär dig hur du ställer in vertikala ankarpositioner för textrutor i Word-dokument med Aspose.Words för .NET. Enkel steg-för-steg-guide ingår. | | [Identifiera smart konstform](./detect-smart-art-shape/) | Lär dig hur du identifierar SmartArt-former i Word-dokument med Aspose.Words för .NET med den här omfattande guiden. Perfekt för att automatisera ditt dokumentarbetsflöde. | | [Uppdatera Smart Art-teckning](./update-smart-art-drawing/) | Lär dig hur du uppdaterar Smart Art-ritningar i Word-dokument med Aspose.Words för .NET med den här steg-för-steg-guiden. Se till att dina bilder alltid är korrekta. | | [Skapa rektangelform i Word med Aspose.Words – Steg‑för‑steg‑guide](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Lär dig hur du skapar en rektangel i Word-dokument med Aspose.Words i en tydlig steg‑för‑steg‑guide. | +| [Skapa Word-dokument C# – Lägg till form med skugga](./create-word-document-c-add-shape-with-shadow/) | Lär dig hur du lägger till en form med skugga i ett Word-dokument med Aspose.Words för .NET i C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/swedish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/swedish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..a405edab74 --- /dev/null +++ b/words/swedish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: Skapa Word‑dokument i C# och lär dig hur du lägger till en form, applicerar + skugga på formen och ställer in skuggavståndet. Steg‑för‑steg‑guide för Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: sv +og_description: Skapa ett Word‑dokument i C# med en rektangelform och anpassad skugga. + Följ den kompletta handledningen för att ställa in skuggavstånd och stil. +og_title: Skapa Word-dokument i C# – Lägg till form med skugga +tags: +- Aspose.Words +- C# +- Document Automation +title: Skapa Word-dokument i C# – Lägg till form med skugga +url: /sv/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Skapa Word-dokument C# – Lägg till form med skugga + +Har du någonsin behövt **create word document c#** som innehåller en snyggt stylad rektangel? Kanske bygger du en rapportmall och vill ha en subtil drop‑shadow för att få layouten att sticka ut. I den här handledningen går vi igenom precis det – hur man lägger till en form, applicerar skugga på formen och till och med justerar skuggavståndet med Aspose.Words. + +Vi börjar med ett tomt dokument, lägger in en rektangel, ger den en förinställd skugga och avslutar med att spara filen. När du är klar har du en färdig .docx som du kan öppna i Word och se effekten omedelbart. Inga externa verktyg, bara ren C#-kod. + +## Förutsättningar + +- .NET 6 (eller någon recent .NET Framework) installerat. +- Visual Studio 2022 eller VS Code med C#-tillägg. +- Aspose.Words för .NET NuGet-paket (`Aspose.Words` version 23.12 eller senare). + Du kan lägga till det via Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +Det är allt – inga extra DLL:er eller COM-interoperabilitet krävs. + +## Steg 1: Initiera ett nytt dokument och en builder – *create word document c#* grunderna + +Först behöver vi ett `Document`-objekt som representerar Word-filen och en `DocumentBuilder` för att redigera den. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Varför detta steg är viktigt:** `Document`-klassen är behållaren för alla Word-delar (sidor, stilar, bilder). Buildern är ett hög‑nivå API som abstraherar bort låg‑nivå nodmanipulation, vilket gör det enkelt att **create word document c#** utan att behöva hantera XML direkt. + +## Steg 2: Infoga en rektangel‑form – *how to create rectangle* + +Nu placerar vi en rektangel på sidan. Storleken anges i punkter (1 pt ≈ 1/72 tum). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Proffstips:** Om du behöver en annan form, byt bara `ShapeType.Rectangle` mot `ShapeType.Ellipse`, `ShapeType.Triangle` osv. Samma kod fungerar för **how to add shape** av vilken typ som helst. + +## Steg 3: Applicera en förinställd skugga och finjustera den – *apply shadow to shape* + +Aspose.Words levereras med flera förinställda skuggformat. Vi kommer att använda `Preset1` och sedan anpassa avstånd, oskärpa, transparens och färg. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Varför anpassa skuggan?** `Distance`‑egenskapen styr hur långt skuggan sitter från rektangeln – tänk på det som “lyftet” du ser i en 3‑D‑rendering. Att ändra `BlurRadius` mjukar upp kanterna, medan `Transparency` låter dig skapa ett subtilt, professionellt utseende. Detta uppfyller kravet **set shadow distance** och visar hur du **apply shadow to shape** på ett flexibelt sätt. + +## Steg 4: Spara dokumentet – *create word document c#* slutförande + +Till sist skriver du dokumentet till disk. Justera sökvägen till en mapp du har skrivbehörighet till. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Öppna den resulterande filen i Microsoft Word, så ser du en ljusblå rektangel med en mjuk grå skugga förskjuten med 5 pt. Det är det visuella beviset på att du framgångsrikt **create word document c#** med en stylad form. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="exempel på create word document c# som visar rektangel med skugga"} + +## Valfria variationer & kantfall + +| Scenario | Vad som ska ändras | Varför det är viktigt | +|----------|--------------------|-----------------------| +| **Olika skuggstil** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Ger dig ett mer dramatiskt utseende utan extra kod. | +| **Ingen förinställning – anpassad skugga** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | Full kontroll över riktning och djup. | +| **Flera former** | Call `builder.InsertShape` again before saving. | Användbart för komplexa mallar med ikoner, logotyper osv. | +| **Kompatibilitet med äldre Aspose-versioner** | Use `ShadowEffect` class (available in v20.x). | Säkerställer att din kod körs på legacy projects. | +| **Spara som PDF** | `document.Save("ShadowShape.pdf");` | Same shadow rendering appears in PDF output. | + +> **Vanlig fråga:** *Vad händer om skuggan inte visas i Word?* +> Se till att du använder en recent version of Aspose.Words (≥ 22.9). Äldre versioner hade begränsat stöd för skuggor. Verifiera också att dokumentet öppnas i en recent version of Word (2016+). + +## Fullt fungerande exempel + +Nedan är det kompletta, kopiera‑och‑klistra‑klara programmet. Det inkluderar alla `using`‑direktiv, kommentarer och felhantering för en smidig upplevelse. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Kör programmet, navigera till `C:\Temp\ShadowShape.docx`, och du kommer att se rektangeln med den exakta skuggan vi konfigurerade. + +## Sammanfattning & nästa steg + +- Du vet nu hur man **create word document c#**, infogar en rektangel och **apply shadow to shape** med en anpassad **set shadow distance**. +- Exemplet använder Aspose.Words, som abstraherar bort OpenXML-komplexiteten och garanterar konsekvent rendering över Word-versioner. +- Vill du gå längre? Prova att kombinera flera former, lägga till text i rektangeln eller exportera samma dokument som PDF för att se hur skuggan översätts. + +### Relaterade ämnen du kan utforska + +- **How to add shape** till ett sidhuvud/sidfot för varumärkesprofilering. +- Använda **Aspose.Words** för att programatiskt infoga diagram och tabeller. +- Anpassa **shadow effects** på bilder istället för vektorformer. +- Automatisera massgenerering av dokument för fakturor eller certifikat. + +Känn dig fri att experimentera, bryta koden och sedan bygga om den – det är det snabbaste sättet att internalisera koncepten. Om du stöter på problem, lämna en kommentar nedan eller kolla den officiella Aspose.Words-dokumentationen för djupare API‑insikter. + +Lycka till med kodandet, och njut av att göra dina Word-filer lite mer polerade! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/swedish/net/programming-with-txtsaveoptions/_index.md b/words/swedish/net/programming-with-txtsaveoptions/_index.md index b83d0feb0b..2120cbebc8 100644 --- a/words/swedish/net/programming-with-txtsaveoptions/_index.md +++ b/words/swedish/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Tack vare dessa handledningar kommer du att kunna utnyttja funktionerna i Aspose | [Lägg till Bidi-markeringar i Word-dokument](./add-bidi-marks/) | Lär dig hur du lägger till dubbelriktade (Bidi) tecken i Word-dokument med Aspose.Words för .NET med den här guiden. Säkerställ korrekt textriktning för flerspråkigt innehåll. | | [Använd tabbtecken per nivå för listindrag](./use-tab-character-per-level-for-list-indentation/) | Lär dig hur du skapar listor i flera nivåer med tabbindrag med Aspose.Words för .NET. Följ den här guiden för exakt listformatering i dina dokument. | | [Använd mellanslagstecken per nivå för listindrag](./use-space-character-per-level-for-list-indentation/) | Lär dig hur du skapar listor med flera nivåer med mellanslag i Aspose.Words för .NET. Steg-för-steg-guide för exakt dokumentformatering. | - +| [Spara docx som txt – Komplett guide för att exportera Word-ekvationer till LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Lär dig hur du sparar docx-filer som txt och exporterar Word-ekvationer till LaTeX med Aspose.Words för .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/swedish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/swedish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..b6354007a5 --- /dev/null +++ b/words/swedish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Spara docx som txt med Aspose.Words och konvertera Word till LaTeX. Lär + dig hur du exporterar ekvationer, behåller vanlig text och får LaTeX‑markup på några + minuter. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: sv +og_description: Spara docx som txt med Aspose.Words. Denna guide visar hur du konverterar + Word till LaTeX, exporterar ekvationer och behåller ditt dokument som ren text. +og_title: Spara docx som txt – Exportera Word‑ekvationer till LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Spara docx som txt – Komplett guide för att exportera Word‑ekvationer till + LaTeX +url: /sv/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Save docx as txt – Export Word Equations to LaTeX + +Har du någonsin behövt **save docx as txt** men oroat dig för att du skulle förlora den avancerade matematiken som finns i din Word‑fil? Du är inte ensam. I många vetenskapliga arbetsflöden är en ren‑textversion av ett dokument ett måste, men du vill ändå att ekvationerna ska bevaras som ren LaTeX‑markup. + +I den här handledningen går vi igenom de exakta stegen för att **convert Word to LaTeX** med Aspose.Words för .NET, så att dina ekvationer exporteras korrekt medan resten av dokumentet blir ren ren text. I slutet kommer du att veta hur du **export equations to LaTeX**, behåller resten av filen som enkel text och undviker de vanliga fallgroparna som får nybörjare att snubbla. + +## Vad du kommer att lära dig + +- Hur du laddar en *.docx*-fil som innehåller Office Math. +- Ställer in rätt `TxtSaveOptions` för att få Aspose att outputa LaTeX för varje ekvation. +- Sparar resultatet som en **save word plain text**‑fil som du kan mata in i versionskontroll, CI‑pipelines eller något efterföljande verktyg. +- Vanliga kantfall — vad du ska göra när ett dokument blandar bilder och ekvationer, eller när du behöver bevara Unicode‑tecken. +- Ett komplett, färdigt‑till‑körning kodexempel som du kan slänga in i en konsolapp. + +### Förutsättningar + +- .NET 6.0 eller senare (koden fungerar även med .NET Framework 4.7+). +- En licensierad kopia av **Aspose.Words for .NET** (gratis provversion fungerar för testning). +- Visual Studio 2022 eller någon IDE som kan kompilera C#‑projekt. +- Ett Word‑dokument (`input.docx`) som redan innehåller några Office Math‑objekt. + +> **Pro tip:** Om du ännu inte har en licens kan du begära en tillfällig nyckel från Asposes webbplats — ersätt bara platshållaren i koden med din nyckel innan du kör. + +## Steg 1 – Installera Aspose.Words via NuGet + +Först och främst: du behöver biblioteket i ditt projekt. Öppna **Package Manager Console** och kör: + +```powershell +Install-Package Aspose.Words +``` + +Den enda raden hämtar allt du behöver, inklusive `Saving`‑namnutrymmet där `TxtSaveOptions` finns. Inga extra DLL‑filer, inga inhemska beroenden — bara ren hanterad kod. + +## Steg 2 – Läs in källdokumentet Word + +Nu läser vi faktiskt filen som innehåller ekvationerna. `Document`‑klassen abstraherar hela *.docx*-strukturen, så att du kan behandla den som en hög‑nivå objektmodell. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Varför detta är viktigt:** Att ladda dokumentet tidigt låter dig inspektera dess nodträd. Om du hoppar över kontrollen och filen saknar ekvationer får du fortfarande en ren txt‑fil — men du vet inte varför LaTeX‑utdata är tom. + +## Steg 3 – Konfigurera TxtSaveOptions för LaTeX‑export + +Aspose ger dig fin‑granulerad kontroll över hur Office Math renderas. Genom att sätta `OfficeMathExportMode` till `LaTeX` omvandlas varje ekvation till dess LaTeX‑ekvivalent istället för att tas bort eller konverteras till en bild. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Varför detta är viktigt:** Standard‑exportläget skulle ta bort ekvationerna helt. Att byta till `LaTeX` bevarar den matematiska avsikten, vilket är exakt vad du behöver när du senare matar filen till en LaTeX‑kompilator eller en markdown‑processor som förstår `$…$`‑syntax. + +## Steg 4 – Spara dokumentet som ren text + +Med alternativen konfigurerade är sparandet av filen en enradare. Utdata blir en `.txt`‑fil där varje ekvation visas som LaTeX‑kod omgiven av `$`‑avgränsare (du kan ändra det senare om du föredrar `\[` … `\]`‑block). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Förväntat resultat + +Öppna `output.txt` i någon redigerare så ser du något liknande: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Lägg märke till hur den vanliga texten förblir exakt som den var, medan ekvationerna nu är rena LaTeX‑strängar. Du kan kopiera‑klistra in dem direkt i ett LaTeX‑dokument, en Jupyter‑notebook eller något verktyg som renderar matematik. + +## Steg 5 – Hantera kantfall + +### Blandat innehåll (Bilder + Ekvationer) + +Om din Word‑fil också innehåller bilder kommer Aspose att ignorera dem när du använder `TxtSaveOptions`. Det är vanligtvis okej för ett **save word plain text**‑arbetsflöde, men om du behöver bilderna som platshållare kan du: + +1. Exportera dokumentet till HTML först (`HtmlSaveOptions`) för att fånga bilder som ``‑taggar. +2. Kör ett andra pass med `TxtSaveOptions` för att få LaTeX‑ekvationerna. +3. Slå ihop de två resultaten manuellt eller med ett litet skript. + +### Unicode‑symboler + +Vissa ekvationer använder speciella Unicode‑tecken (t.ex. grekiska bokstäver). Att sätta `Encoding = Encoding.UTF8` i `TxtSaveOptions` (som visas i Steg 3) säkerställer att dessa symboler överlever konverteringen. + +### Stora dokument + +För enorma filer (> 100 MB) bör du överväga att strömma sparoperationen: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Strömning undviker att hela utdata laddas in i minnet, vilket kan vara en livräddare på byggagenter med lite minne. + +## Fullt fungerande exempel + +Nedan är det kompletta, kopiera‑och‑klistra‑klara programmet som binder ihop allt. Byt bara ut filsökvägarna och, om du har en, licensraden. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Kör programmet (`dotnet run` om du använder ett konsolprojekt) och kontrollera `output.txt`. Du har just **saved docx as txt** samtidigt som du bevarar varje ekvation som LaTeX — ingen manuell kopiering‑och‑klistring behövs. + +## Vanliga frågor och svar + +**Q: Kan jag ändra avgränsaren från `$…$` till `\(...\)`?** +A: Ja. Efter sparandet kör du en enkel ersättning i filen: `output = output.Replace("$", @"\(").Replace("$", @"\)");` — var bara försiktig så att du inte ersätter inline `$`‑tecken som tillhör den ursprungliga texten. + +**Q: Fungerar detta med Word‑filer från 2007‑2019?** +A: Absolut. Aspose.Words stödjer `.doc`, `.docx`, `.docm` och även den nyare `.dotx`‑familjen. Samma kod fungerar i alla versioner. + +**Q: Vad gör jag om jag behöver behålla den ursprungliga styckeformaten (flikar, flera mellanslag)?** +A: Sätt `txtSaveOptions.PreserveTableLayout = true;` och `txtSaveOptions.PreserveSpace = true;` för att behålla blanksteg intakta. + +## Slutsats + +Vi har gått igenom allt du behöver för att **save docx as txt** samtidigt som du **export equations to LaTeX** med Aspose.Words. Nyckelstegen är att ladda dokumentet, konfigurera `TxtSaveOptions` med `OfficeMathExportMode.LaTeX` och spara resultatet. Med dessa tre kodrader kan du på ett pålitligt sätt **convert word to latex**, behålla ditt dokument som **save word plain text**, och undvika den fruktade förlusten av matematiska symboler. + +Redo för nästa utmaning? Prova att kedja detta arbetsflöde med en markdown‑generator för att producera en fullständig `.md`‑fil som innehåller både text och LaTeX — perfekt för Git‑baserad dokumentation eller statiska webbplats‑generatorer. Eller utforska Asposes `PdfSaveOptions` för att få en PDF‑version tillsammans med ren‑text‑filen. + +Om du stöter på problem, lämna en kommentar nedan. Lycka till med kodandet, och njut av enkelheten att omvandla Word‑ekvationer till ren LaTeX! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/swedish/net/working-with-fonts/_index.md b/words/swedish/net/working-with-fonts/_index.md index 6377059a27..d56ea775d8 100644 --- a/words/swedish/net/working-with-fonts/_index.md +++ b/words/swedish/net/working-with-fonts/_index.md @@ -20,7 +20,7 @@ Handledningar för ordbehandling med teckensnitt guidar dig genom olika aspekter Handledningarna ger dig detaljerade steg-för-steg-förklaringar för varje funktion, tillsammans med källkod för C#-språket som illustrerar koncepten. Du kommer att lära dig hur du använder klasser och metoder från Aspose.Words-biblioteket för .NET för att utföra specifika teckensnittsrelaterade uppgifter i dina Word-dokument. -Oavsett om du vill formatera text med olika teckensnitt, ange regler för teckensnittsersättning, ladda teckensnitt från specifika kataloger eller ta emot teckensnittsmeddelanden, kommer handledningarna i "Ordbehandling med teckensnitt" att ge dig kunskapen för att enkelt utföra dessa uppgifter. +Oavsett om du vill formatera text med olika teckensnitt, ange regler för teckensnittsersättning, ladda teckensnitt från specifika kataloger eller ta emot teckensnittsmeldanden, kommer handledningarna i "Ordbehandling med teckensnitt" att ge dig kunskapen för att enkelt utföra dessa uppgifter. ## Handledningar | Titel | Beskrivning | @@ -40,7 +40,7 @@ Oavsett om du vill formatera text med olika teckensnitt, ange regler för tecken | [Prioriteringsinställningar för teckensnittsmappar](./set-fonts-folders-with-priority/) | Lär dig hur du prioriterar teckensnittsmappar i Word-dokument med Aspose.Words för .NET. Vår guide säkerställer att dina dokument renderas perfekt varje gång. | | [Ställ in mappen True Type-teckensnitt](./set-true-type-fonts-folder/) | Lär dig hur du ställer in en True Type Fonts-mapp i Word-dokument med Aspose.Words för .NET. Följ vår detaljerade steg-för-steg-guide för att säkerställa konsekvent typsnittshantering. | | [Ange standardteckensnitt vid rendering](./specify-default-font-when-rendering/) | Lär dig hur du anger ett standardteckensnitt när du renderar Word-dokument med Aspose.Words för .NET. Säkerställ ett enhetligt dokumentutseende över olika plattformar. | -| [Teckensnittsinställningar med laddningsalternativ](./font-settings-with-load-options/) Lär dig hur du hanterar teckensnittsinställningar med laddningsalternativ i Aspose.Words för .NET. Steg-för-steg-guide för utvecklare för att säkerställa ett enhetligt teckensnittsutseende i Word-dokument. +| [Teckensnittsinställningar med laddningsalternativ](./font-settings-with-load-options/) Lär dig hur du hanterar teckensnittsinställningar med laddningsalternativ i Aspose.Words för .NET. Steg-för-steg-guide för utvecklare för att säkerställa ett enhetligt teckensnittsutseende i Word-dokument. | | [Ange teckensnittsmapp](./set-fonts-folder/) | Lär dig hur du ställer in en mapp för anpassade teckensnitt i Aspose.Words för .NET för att säkerställa att dina Word-dokument återges korrekt utan att teckensnitt saknas. | | [Standardinstans för teckensnittsinställningar](./font-settings-default-instance/) | I den här handledningen lär du dig hur du konfigurerar standardinställningar för teckensnitt i ett Word-dokument med Aspose.Words för .NET. | | [Hämta lista över tillgängliga teckensnitt](./get-list-of-available-fonts/) | Upptäck hur du får en lista över tillgängliga teckensnitt med Aspose.Words för .NET i den här detaljerade steg-för-steg-handledningen. Öka dina kunskaper i teckensnittshantering. | @@ -48,7 +48,7 @@ Oavsett om du vill formatera text med olika teckensnitt, ange regler för tecken | [Få varningsmeddelande](./receive-warning-notification/) Lär dig hur du får en varningsmeddelande när du använder Aspose.Words för .NET och hanterar eventuella problem eller varningar i dina dokument. | | [Exempel på teckensnittskälla för resurs Steam](./resource-steam-font-source-example/) | Lär dig hur du använder teckensnittskällan Resource Stream för att läsa in anpassade teckensnitt i Aspose.Words för .NET. | | [Hämta substitution utan suffix](./get-substitution-without-suffixes/) | I den här handledningen lär du dig hur du får suffixlösa åsidosättningar i ett Word-dokument med Aspose.Words för .NET. | - +| [Aspose teckensnittsersättning – Så konfigurerar du teckensnittsinställningar i C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Lär dig hur du konfigurerar teckensnittsinställningar i C# med Aspose Font Substitution. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/swedish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/swedish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..9015de7e97 --- /dev/null +++ b/words/swedish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,238 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose teckensnittssubstitution gjort enkelt: lär dig att konfigurera + teckensnittinställningar, fånga varningar och hantera saknade teckensnitt i dina + .NET‑appar.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: sv +og_description: Behärska Aspose teckensnittssubstitution genom att konfigurera teckensnittsinställningar + och hantera saknade teckensnitt med en varningsåteruppringning. Komplett C#‑guide. +og_title: Aspose teckensnittssubstitution – Konfigurera teckensnittsinställningar + i C# +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose teckensnittssubstitution – Hur man konfigurerar teckensnittsinställningar + i C# +url: /sv/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Komplett guide för att konfigurera teckensnittsinställningar + +Har du någonsin stött på ett dokument som plötsligt byter ditt anpassade typsnitt mot något generiskt? Det är **aspose font substitution** som gör sitt jobb – den ersätter saknade teckensnitt med den närmaste matchning den kan hitta. Det är praktiskt, men om du behöver veta *exakt* vilket teckensnitt som byttes ut, måste du ansluta till bibliotekets varningssystem och konfigurera teckensnittsinställningarna själv. + +I den här handledningen går vi igenom ett verkligt scenario: vi laddar en DOCX som refererar till ett teckensnitt du inte har, fångar substitutions‑händelsen och skriver ett vänligt meddelande till konsolen. När du är klar kommer du att känna dig bekväm med **configure font settings**, att koppla en **Aspose.Words warning callback**, och att utöka exemplet för att passa vilket arbetsflöde som helst. + +> **What you’ll need** +> • .NET 6+ (or .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • A DOCX that references a missing font (we’ll call it `MissingFont.docx`) + +Låt oss dyka ner. + +--- + +## Step 1: Install Aspose.Words and Prepare the Project + +Innan vi skriver någon kod, se till att Aspose.Words‑paketet är refererat: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro tip:** Använd den senaste stabila versionen; i mars 2026 är den 23.11.0. Nyare releaser förbättrar algoritmer för teckensnittsmatchning och lägger till extra varningstyper. + +Skapa en ny konsolapp (eller klistra in koden i ett befintligt projekt) och lägg till de vanliga `using`‑direktiven: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Dessa namnrymder ger oss åtkomst till `Document`, `LoadOptions` och de teckensnittsklasser vi kommer att behöva. + +## Step 2: Configure Font Settings with LoadOptions + +Kärnan i **aspose font substitution**‑kontrollen finns i `LoadOptions.FontSettings`. Genom att tillhandahålla ett tomt `FontSettings`‑objekt säger vi åt Aspose att använda sina standardsökvägar *och* att rapportera eventuell substitution via en varnings‑callback. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Varför inte bara förlita sig på standardinställningarna? För att en varnings‑callback (nästa steg) bara fungerar när egenskapen `FontSettings` är icke‑null. Den här lilla raden ger oss en krok in i substitutionsprocessen utan att ändra det faktiska teckensnittssökbeteendet. + +## Step 3: Attach a Warning Callback to Capture Substitutions + +Aspose.Words implementerar gränssnittet `IWarningCallback`. När något anmärkningsvärt händer – till exempel ett saknat teckensnitt – anropar det vår `Warning`‑metod. Vi implementerar en liten hanterare som filtrerar på `WarningType.FontSubstitution` och skriver ut beskrivningen. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +Och så ser själva hanteraren ut: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Why this matters** – Utan callback byter Aspose tyst ut teckensnitt, och du får aldrig veta vilket som användes. Callbacken gör processen transparent, vilket är viktigt för efterlevnadsrapportering eller för att felsöka layoutproblem. + +## Step 4: Load the Document Using the Configured Options + +Nu laddar vi äntligen dokumentet och passerar de `loadOptions` vi just förberett. Om källfilen refererar till ett teckensnitt som inte är installerat, kommer vår hanterare att triggas. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Byt ut `YOUR_DIRECTORY` mot den faktiska sökvägen där `MissingFont.docx` ligger. När du kör programmet bör du se en utskrift liknande: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Den raden talar om exakt vilket teckensnitt som saknades och vilken reserv Aspose valde. + +## Step 5: (Optional) Fine‑Tune Font Search Paths + +Om du har en privat mapp med företags‑teckensnitt kan du tala om för Aspose var den ska leta innan den faller tillbaka på systemteckensnitt. Detta är en avancerad användning av **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Genom att sätta `recursive: true` får Aspose även att skanna undermappar. Nu kommer biblioteket att försöka med dina privata teckensnitt först, vilket minskar risken för oönskad substitution. + +## Full Working Example + +Sätter vi ihop allt får vi det kompletta, körklara programmet: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Expected output** (when a missing font is encountered): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Om alla teckensnitt finns installerade körs programmet tyst (inga varningar) och producerar ändå PDF‑filen. + +## Common Questions & Edge Cases + +### What if I need to *prevent* substitution altogether? + +Sätt `FontSettings.SubstitutionSettings` till `null` eller använd `FontSettings.FontSubstitutionSettings` för att styra beteendet. Till exempel: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Nu kommer Aspose att kasta ett undantag istället för att tyst ersätta, vilket kan fångas och hanteras. + +### Does this work with other file formats (e.g., .doc, .rtf)? + +Absolut. Samma `LoadOptions`‑objekt kan passeras till vilken `Document`‑konstruktor som helst som accepterar en filsökväg. Varnings‑callbacken kommer att triggas för alla format som är beroende av teckensnitt. + +### Can I capture the *exact* fallback font name? + +Ja. Strängen `info.Description` innehåller både det saknade teckensnittet och ersättningen. Om du behöver namnet programatiskt kan du parsra det eller använda `FontInfo`‑objektet (tillgängligt i nyare versioner). + +### How does this behave in a multi‑threaded environment? + +`FontSettings` är **inte** trådsäker. Skapa ett separat `LoadOptions` (med sin egen `FontSettings`) per tråd, eller skydda åtkomsten med en låsning. + +## Conclusion + +Vi har gått igenom allt du behöver för att bemästra **aspose font substitution** och **configure font settings** i en C#‑applikation: + +1. Installera Aspose.Words och lägg till de nödvändiga `using`‑satserna. +2. Skapa ett `LoadOptions`‑objekt med ett nytt `FontSettings`. +3. Koppla en anpassad `IWarningCallback` för att exponera substitutions‑händelser. +4. Ladda dokumentet och låt callbacken rapportera eventuella saknade teckensnitt. +5. (Valfritt) Utöka sökvägen eller inaktivera substitution helt. + +Med detta mönster kan du logga saknade teckensnitt för efterlevnad, varna användare i ett UI, eller automatiskt bädda in reservteckensnitt innan publicering. Nästa steg kan vara att utforska **Aspose.Words font substitution policies** eller integrera arbetsflödet i en större dokument‑bearbetningspipeline. + +Lycka till med kodningen, och må dina dokument alltid renderas med rätt teckensnitt! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/thai/net/basic-conversions/_index.md b/words/thai/net/basic-conversions/_index.md index a0128bb8eb..0192a0b778 100644 --- a/words/thai/net/basic-conversions/_index.md +++ b/words/thai/net/basic-conversions/_index.md @@ -26,6 +26,7 @@ Basic Conversions จะแนะนำคุณเกี่ยวกับก | [แปลงไฟล์ Word เป็น PDF](./docx-to-pdf/) เรียนรู้วิธีการแปลงไฟล์ Word เป็น PDF ได้อย่างง่ายดายโดยใช้ Aspose.Words สำหรับ .NET ด้วยคู่มือของเรา เหมาะสำหรับนักพัฒนาที่ต้องการการแปลงเอกสารที่รวดเร็วและเชื่อถือได้ - - [แปลง Word เป็น PDF ใน C# ด้วย Aspose.Words – คู่มือ](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | เรียนรู้วิธีแปลงไฟล์ Word เป็น PDF ด้วย C# และ Aspose.Words อย่างละเอียด พร้อมตัวอย่างโค้ดและขั้นตอนที่ชัดเจน - - [บันทึก Word เป็น PDF ด้วย Aspose.Words – คู่มือ C# ฉบับสมบูรณ์](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | เรียนรู้วิธีบันทึกไฟล์ Word เป็น PDF ด้วย C# และ Aspose.Words อย่างละเอียด พร้อมตัวอย่างโค้ดและขั้นตอนที่ชัดเจน - +- [แปลง Word เป็น PDF ด้วย Aspose.Words – คู่มือฉบับสมบูรณ์](./convert-word-to-pdf-with-aspose-words-complete-guide/) | เรียนรู้วิธีแปลงไฟล์ Word เป็น PDF อย่างละเอียดด้วย Aspose.Words สำหรับ .NET พร้อมตัวอย่างโค้ดและขั้นตอนที่ชัดเจน - | [แปลง Docx เป็นไบต์](./docx-to-byte/) | เรียนรู้วิธีการแปลง Docx เป็นอาร์เรย์ไบต์ใน .NET โดยใช้ Aspose.Words เพื่อการประมวลผลเอกสารอย่างมีประสิทธิภาพ มีคู่มือทีละขั้นตอนรวมอยู่ด้วย - | [แปลง Docx เป็น Epub](./docx-to-epub/) | แปลง DOCX เป็น EPUB ได้อย่างง่ายดายด้วย Aspose.Words สำหรับ .NET ทำตามบทช่วยสอนของเราเพื่อบูรณาการกับแอปพลิเคชัน .NET ของคุณได้อย่างราบรื่น - | [แปลง Docx เป็น Mhtml และส่งอีเมล](./docx-to-mhtml-and-sending-email/) | เรียนรู้วิธีแปลง DOCX เป็น MHTML และส่งอีเมลโดยใช้ Aspose.Words สำหรับ .NET ในคู่มือทีละขั้นตอนนี้ เพิ่มประสิทธิภาพการทำงานของคุณด้วยระบบอัตโนมัติที่ง่ายดาย - diff --git a/words/thai/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/thai/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..3eda415a81 --- /dev/null +++ b/words/thai/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: แปลง Word เป็น PDF อย่างรวดเร็วด้วย Aspose.Words เรียนรู้วิธีบันทึกไฟล์ + Word เป็น PDF, ส่งออก docx เป็น PDF, และสร้าง PDF ที่เข้าถึงได้ใน C# +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: th +og_description: แปลง Word เป็น PDF ด้วย C# โดยใช้ Aspose.Words คู่มือนี้แสดงวิธีบันทึก + Word เป็น PDF, ส่งออกไฟล์ docx ไปเป็น PDF, และสร้าง PDF ที่เข้าถึงได้ +og_title: แปลง Word เป็น PDF ด้วย Aspose.Words – ทีละขั้นตอน +tags: +- Aspose.Words +- C# +- PDF conversion +title: แปลง Word เป็น PDF ด้วย Aspose.Words – คู่มือฉบับสมบูรณ์ +url: /th/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# แปลง Word เป็น PDF ด้วย Aspose.Words – คู่มือฉบับสมบูรณ์ + +เคยสงสัยไหมว่า **แปลง Word เป็น PDF** อย่างไรโดยไม่ต้องยุ่งกับเครื่องมือเว็บของบุคคลที่สาม? บางทีคุณอาจกำลังสร้างเครื่องยนต์รายงานอัตโนมัติและต้องการวิธีที่เชื่อถือได้ในการ *save word as pdf* อย่างรวดเร็ว ข่าวดีคือ Aspose.Words ทำให้กระบวนการทั้งหมดง่ายดายเหมือนเค้ก และคุณยังสามารถสร้างไฟล์ที่สอดคล้องกับ **PDF/UA‑2** — เหมาะสำหรับข้อกำหนดการเข้าถึง + +ในบทแนะนำนี้เราจะพาคุณผ่านทุกขั้นตอนที่ต้องการ: โหลดไฟล์ `.docx` ตั้งค่าตัวเลือก PDF เพื่อให้คุณ *export docx to pdf* พร้อมการปฏิบัติตาม PDF/UA และสุดท้ายบันทึกผลลัพธ์เป็น PDF ที่เข้าถึงได้ เมื่อเสร็จคุณจะได้โค้ดสั้น ๆ ที่พร้อมใช้งานในสภาพแวดล้อมการผลิตและสามารถนำไปใส่ในโปรเจกต์ .NET ใดก็ได้ + +![Convert Word to PDF using Aspose.Words](convert-word-to-pdf.png) + +## สิ่งที่คุณจะได้เรียนรู้ + +- **ทำไม Aspose.Words** จึงเป็นตัวเลือกที่มั่นคงสำหรับสถานการณ์ *generate accessible pdf* +- ขั้นตอนที่แน่นอนในการ *save document as pdf* พร้อมการปฏิบัติตาม PDF/UA‑2 +- วิธีจัดการกับกรณีขอบเขตทั่วไป เช่น ฟอนต์หายหรือไฟล์ต้นทางที่มีการป้องกันด้วยรหัสผ่าน +- เคล็ดลับเร็ว ๆ สำหรับการดีบักผลลัพธ์และตรวจสอบการปฏิบัติตามมาตรฐานการเข้าถึง + +### ข้อกำหนดเบื้องต้น + +- .NET 6 หรือใหม่กว่า (API ยังทำงานบน .NET Framework 4.6+ ด้วย) +- ใบอนุญาต Aspose.Words for .NET ที่ถูกต้อง (รุ่นทดลองฟรีใช้ได้สำหรับการประเมิน) +- ความรู้พื้นฐาน C# — ไม่จำเป็นต้องใช้แพทเทิร์นซับซ้อน + +หากคุณมีสิ่งเหล่านี้ครบแล้ว มาเริ่มกันเลย + +--- + +## แปลง Word เป็น PDF – การดำเนินการแบบขั้นตอนต่อขั้นตอน + +เราจะแบ่งวิธีแก้เป็นห้าขั้นตอนชัดเจน แต่ละขั้นมีหัวข้อย่อย โค้ดสั้น ๆ และคำอธิบายว่า *ทำไม* โค้ดนี้สำคัญ + +### ขั้นตอนที่ 1: โหลดเอกสาร Word ที่ต้องการแปลง + +สิ่งแรกที่คุณต้องมีคืออ็อบเจกต์ `Document` ที่แทนไฟล์ต้นทาง Aspose.Words รองรับ **.docx**, **.doc**, **.rtf** และรูปแบบอื่น ๆ มากมาย ดังนั้นคุณสามารถ *save word as pdf* ไม่ว่าฟाइलจะถูกสร้างอย่างไร + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**ทำไมสิ่งนี้สำคัญ:** +- การโหลดไฟล์ตั้งแต่ต้นช่วยให้คุณตรวจจับข้อผิดพลาดไฟล์หายก่อนที่จะเสียเวลาใช้ CPU +- คลาส `Document` ซ่อนโครงสร้างภายในของไฟล์ Word ไว้ ทำให้คุณได้โมเดลอ็อบเจกต์ที่สะอาดสำหรับทำงานต่อ + +### ขั้นตอนที่ 2: ตั้งค่าตัวเลือกการบันทึก PDF เพื่อการเข้าถึง + +หากคุณต้องการไฟล์ *generate accessible pdf* คุณต้องบอก Aspose.Words ให้สร้างเอกสารที่สอดคล้องกับ PDF/UA‑2 คลาส `PdfSaveOptions` ให้การควบคุมละเอียดบนผลลัพธ์ + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**ทำไมสิ่งนี้สำคัญ:** +- `PdfCompliance.PdfUa2` บอกไลบรารีให้เพิ่มแท็ก โครงสร้างข้อมูล และเมตาดาต้าที่เครื่องอ่านหน้าจอจำเป็น +- การฝังฟอนต์ (`EmbedFullFonts = true`) ป้องกันคำเตือน “font not found” เมื่อเปิด PDF บนระบบปฏิบัติการอื่น +- การตั้งค่า `Title` ช่วยให้เทคโนโลยีช่วยเหลือประกาศชื่อเอกสารอย่างถูกต้อง + +### ขั้นตอนที่ 3: บันทึกเอกสารเป็น PDF + +เมื่อโหลดต้นทางและตั้งค่าตัวเลือกแล้ว การแปลงจริงเป็นเพียงบรรทัดเดียว นี่คือจุดที่คุณ *export docx to pdf* + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**ทำไมสิ่งนี้สำคัญ:** +- เมธอด `Save` จะเคารพ `PdfSaveOptions` ที่กำหนดไว้ ทำให้คุณมั่นใจว่าฟีเจอร์การเข้าถึงถูกรวมไว้แล้ว +- การห่อหุ้มการเรียกในบล็อก `try/catch` ให้โอกาสบันทึกหรือแสดงข้อผิดพลาดเกี่ยวกับใบอนุญาตหรือสิทธิ์ที่มักทำให้ผู้เริ่มต้นติดขัด + +### ขั้นตอนที่ 4: ตรวจสอบการปฏิบัติตาม PDF/UA (ไม่บังคับแต่แนะนำ) + +แม้ Aspose.Words จะทำงานหนักให้แล้ว การตรวจสอบผลลัพธ์เป็นแนวปฏิบัติที่ดี โดยเฉพาะเมื่อคุณส่งเอกสารให้หน่วยงานรัฐบาลหรือองค์กรที่ต้องปฏิบัติตามกฎระเบียบ + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**ทำไมสิ่งนี้สำคัญ:** +- `IsTagged` เป็นการตรวจสอบอย่างรวดเร็ว; การตรวจสอบ PDF/UA อย่างเต็มรูปแบบต้องใช้ตัวตรวจสอบเฉพาะ แต่ส่วนใหญ่ของปัญหาการปฏิบัติตามจะปรากฏเป็นการขาดแท็ก +- หากค่าเป็น `false` คุณอาจต้องกลับไปตรวจสอบ `PdfSaveOptions` — บางทีอาจลืมตั้ง `Compliance` หรือเอกสารต้นทางไม่มีสไตล์หัวข้อที่เหมาะสม + +### ขั้นตอนที่ 5: จุดบกพร่องทั่วไป & เคล็ดลับระดับมืออาชีพ + +| จุดบกพร่อง | สิ่งที่เกิดขึ้น | วิธีแก้ | +|------------|----------------|----------| +| **Missing fonts** | ตัวอักษรแสดงเป็นกล่องใน PDF | ตั้งค่า `EmbedFullFonts = true` **หรือ** ติดตั้งฟอนต์ที่หายบนเซิร์ฟเวอร์ | +| **Unlicensed library** | Aspose ใส่ลายน้ำบนทุกหน้า | เพิ่มไฟล์ใบอนุญาต (`Aspose.Words.lic`) ตั้งแต่ต้นแอป (เช่น `License license = new License(); license.SetLicense("Aspose.Words.lic");`) | +| **Password‑protected source** | `InvalidOperationException` ที่ `new Document(path)` | ใช้ overload `new Document(path, new LoadOptions { Password = "secret" })` | +| **Large documents cause OOM** | เกิดข้อยกเว้น Out‑of‑memory กับไฟล์ขนาดใหญ่ | เปิดใช้งาน `MemoryOptimization` ใน `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`) | +| **Accessibility tags missing** | การตรวจสอบ PDF/UA ล้มเหลว | ตรวจสอบให้ไฟล์ Word ใช้สไตล์หัวข้อที่ถูกต้อง (`Heading 1`, `Heading 2`, ฯลฯ) — Aspose จะแมปสไตล์เหล่านี้เป็นแท็ก PDF อัตโนมัติ | + +**เคล็ดลับระดับมืออาชีพ:** หากคุณต้องแปลงเอกสารหลายไฟล์เป็นชุด ๆ ให้ใช้ตัวอย่าง `PdfSaveOptions` เพียงอันเดียว การสร้างครั้งเดียวช่วยลดการจัดสรรหน่วยความจำและทำให้รอยเท้าหน่วยความจำต่ำลง + +--- + +## ตัวอย่างทำงานเต็มรูปแบบ (คัดลอก‑วางได้ทันที) + +ด้านล่างเป็นโปรแกรมเต็มที่รวมทุกอย่างไว้ด้วยกัน บันทึกเป็น `Program.cs` เพิ่มแพคเกจ NuGet ของ Aspose.Words และ Aspose.PDF แล้วรัน + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**ผลลัพธ์ที่คาดหวัง:** +ไฟล์ชื่อ `output.pdf` จะปรากฏใน `C:\MyFiles` เปิดด้วย Adobe Acrobat จะเห็น “PDF/A‑2b, PDF/UA‑1” ในแผง compliance ยืนยันว่าคุณได้ *convert word to pdf* สำเร็จแล้ว + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/thai/net/programming-with-markdownsaveoptions/_index.md b/words/thai/net/programming-with-markdownsaveoptions/_index.md index 57c58415e0..44424c5764 100644 --- a/words/thai/net/programming-with-markdownsaveoptions/_index.md +++ b/words/thai/net/programming-with-markdownsaveoptions/_index.md @@ -44,6 +44,15 @@ ### [วิธีส่งออก Markdown จาก DOCX – คู่มือเต็ม C#](./how-to-export-markdown-from-docx-complete-guide/) เรียนรู้วิธีส่งออก Markdown จากไฟล์ DOCX ด้วย Aspose.Words สำหรับ .NET อย่างละเอียดด้วยขั้นตอนที่ชัดเจน +### [วิธีส่งออก LaTeX จาก Word – แปลง DOCX เป็น Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) +เรียนรู้วิธีส่งออกสูตร LaTeX จากไฟล์ Word และแปลงเป็น Markdown ด้วย Aspose.Words สำหรับ .NET อย่างละเอียด + +### [วิธีส่งออก LaTeX จาก DOCX – แปลงเป็น Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) +เรียนรู้วิธีส่งออกสูตร LaTeX จากไฟล์ DOCX และแปลงเป็น Markdown ด้วย Aspose.Words สำหรับ .NET อย่างละเอียด + +### [สร้าง markdown จาก Word – คู่มือเต็ม C#](./create-markdown-from-word-full-c-guide/) +เรียนรู้ขั้นตอนการสร้างไฟล์ markdown จาก Word อย่างครบถ้วนด้วย C# + {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/thai/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/thai/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..95907642a6 --- /dev/null +++ b/words/thai/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,251 @@ +--- +category: general +date: 2026-03-27 +description: สร้าง markdown จาก Word ด้วย Aspose.Words C#. เรียนรู้การแปลง docx เป็น + markdown, การดึงรูปภาพจาก Word, และวิธีใช้ callback ในบทเรียนเดียว. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: th +og_description: สร้าง markdown จาก Word ด้วย Aspose.Words คู่มือนี้แสดงวิธีแปลง docx + เป็น markdown ดึงรูปภาพจาก Word และใช้ callback สำหรับการจัดการทรัพยากร +og_title: สร้าง markdown จาก Word – คอร์สสอน C# ครบถ้วน +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: สร้าง Markdown จาก Word – คู่มือ C# ฉบับเต็ม +url: /th/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# สร้าง markdown จาก Word – คำแนะนำ C# ฉบับสมบูรณ์ + +เคยต้อง **สร้าง markdown จาก Word** แต่ไม่รู้ว่าจะเริ่มต้นอย่างไรหรือไม่? คุณไม่ได้อยู่คนเดียว; นักพัฒนาหลายคนเจออุปสรรคนี้เมื่อต้องย้ายเนื้อหาจากไฟล์ .docx ไปยัง static‑site generator หรือ repository เอกสาร ข่าวดีคือ? ด้วย Aspose.Words คุณสามารถ **แปลง docx เป็น markdown**, ดึงรูปภาพทั้งหมดออกจากไฟล์ต้นฉบับ, และควบคุมตำแหน่งที่ทรัพยากรเหล่านั้นจะถูกจัดเก็บ—ทั้งหมดด้วย callback ง่าย ๆ + +ในคู่มือนี้เราจะเดินผ่านตัวอย่างจริงที่แสดงวิธีดึงรูปภาพจาก Word, วิธีใช้ callback เพื่อจัดเก็บ, และทำไมวิธีนี้จึงเป็นวิธีที่เชื่อถือได้ที่สุดสำหรับ pipeline การทำอัตโนมัติ เมื่อเสร็จแล้วคุณจะมีโปรแกรม C# ที่พร้อมรันซึ่งสร้างไฟล์ `.md` ที่สะอาดและโฟลเดอร์ของรูปภาพที่ดึงออกมา + +> **เคล็ดลับ:** หากคุณมีเทมเพลต Word ที่มีสกรีนช็อต, แผนภาพ หรือโลโก้ วิธีนี้จะคงรักษาองค์ประกอบภาพทุกอย่างไว้โดยไม่ต้องคัดลอก‑วางด้วยตนเอง + +--- + +## สิ่งที่คุณต้องเตรียม + +- **.NET 6+** (หรือ .NET Framework 4.6+). โค้ดทำงานบน runtime ใดก็ได้ที่ทันสมัย +- **Aspose.Words for .NET** (แพ็กเกจ NuGet `Aspose.Words`). เวอร์ชันทดลองฟรีทำงานกับกรณีส่วนใหญ่ +- **เอกสาร Word** (`input.docx`) ที่มีข้อความและอย่างน้อยหนึ่งรูปภาพ +- ความเข้าใจพื้นฐานเกี่ยวกับ C# และ Visual Studio (หรือ IDE ที่คุณชอบ) + +ไม่ต้องใช้ไลบรารีเสริมอื่น—ทุกอย่างที่เหลือจัดการโดย Aspose.Words เอง + +--- + +## ขั้นตอนที่ 1: ตั้งค่าโปรเจกต์และติดตั้ง Aspose.Words + +เพื่อให้เป็นระเบียบ ให้สร้างโปรเจกต์คอนโซลใหม่: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **ทำไมขั้นตอนนี้สำคัญ:** การติดตั้งแพ็กเกจ NuGet ทำให้คุณได้ API ล่าสุด ซึ่งรวมคลาส `MarkdownSaveOptions` ที่เปิดตัวในเวอร์ชัน 22.9 หากไม่มีคุณจะต้องเขียนคอนเวอร์เตอร์แบบกำหนดเอง + +--- + +## ขั้นตอนที่ 2: โหลดเอกสาร Word ต้นฉบับ + +บรรทัดแรกของโค้ดเปิดไฟล์ `.docx` ที่คุณต้องการแปลง แทนที่ `YOUR_DIRECTORY` ด้วยพาธจริงบนเครื่องของคุณ + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **กำลังเกิดอะไรขึ้น?** `Document` จะทำการพาร์สไฟล์, สร้าง DOM ภายใน, และทำให้ทุกพารากราฟ, ตาราง, และรูปภาพเข้าถึงได้ หากไฟล์หายไป Aspose จะโยน `FileNotFoundException` ที่ชัดเจน ซึ่งคุณสามารถจับเพื่อแสดง UI ที่เป็นมิตรกว่าได้ + +--- + +## ขั้นตอนที่ 3: ตั้งค่า Markdown Save Options พร้อม Callback การบันทึกทรัพยากร + +นี่คือจุดที่ **วิธีใช้ callback** เข้ามามีบทบาท Callback จะให้คุณกำหนดว่ารูปภาพที่ดึงออกแต่ละไฟล์จะถูกจัดเก็บไว้ที่ไหน + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **ทำไมต้องใช้ callback?** โดยค่าเริ่มต้น Aspose จะฝังรูปภาพเป็นสตริง base‑64 ภายใน markdown—เป็นปัญหาสำหรับระบบ version control Callback ให้คุณควบคุมชื่อไฟล์และโครงสร้างโฟลเดอร์ได้เต็มที่ + +--- + +## ขั้นตอนที่ 4: บันทึกเอกสารเป็น Markdown + +ตอนนี้เราจะสร้างไฟล์ `.md` จริง ๆ รูปภาพทั้งหมดจะถูกส่งต่อไปยัง callback ที่กำหนดในขั้นตอนต่อไป + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +หากทุกอย่างทำงานได้สำเร็จ คุณจะพบ `Document.md` ในโฟลเดอร์เป้าหมายและโฟลเดอร์ย่อยชื่อ `Resources` ที่บรรจุรูปภาพทั้งหมดที่ดึงออกมาจากไฟล์ Word ต้นฉบับ + +--- + +## ขั้นตอนที่ 5: Implement Callback ที่จัดเก็บรูปภาพที่ดึงออกแต่ละไฟล์ + +ด้านล่างเป็นการทำงานเต็มรูปแบบของ `MyResourceSaver` มันจะสร้างไดเรกทอรี `Resources` (ถ้ายังไม่มี), สร้างชื่อไฟล์ที่ไม่ซ้ำสำหรับแต่ละรูปภาพ, และเขียนสตรีมของรูปภาพลงดิสก์ + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **คำอธิบายของพารามิเตอร์:** +> - `args.Index` – ตัวนับแบบ zero‑based ที่รับประกันความไม่ซ้ำกัน +> - `args.FileName` – ชื่อไฟล์ต้นฉบับที่ Aspose แนะนำ (มักเป็นอย่างเช่น `image001.png`) +> - `args.Stream` – สตรีมเอาต์พุตที่บรรจุไบต์ของรูปภาพ +> - `args.KeepResourceStreamOpen` – ตั้งเป็น `false` เพื่อให้ Aspose ปิดสตรีมโดยอัตโนมัติ ป้องกันการรั่วของไฟล์แฮนด์เดิล + +--- + +## ตัวอย่างทำงานเต็มรูปแบบ + +รวมทุกอย่างเข้าด้วยกัน นี่คือไฟล์เดียวที่คุณสามารถคัดลอก‑วางลงใน `Program.cs` อย่าลืมเปลี่ยน `YOUR_DIRECTORY` ให้เป็นพาธแบบ absolute หรือ relative ที่เหมาะกับสภาพแวดล้อมของคุณ + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### ผลลัพธ์ที่คาดหวัง + +- `YOUR_DIRECTORY/Document.md` – ไฟล์ markdown ที่มีลิงก์รูปภาพตามมาตรฐาน markdown, ตัวอย่างเช่น: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – มีไฟล์ `img_0.png`, `img_1.jpg` ฯลฯ ตามลำดับที่ปรากฏในเอกสาร Word ต้นฉบับ + +เมื่อรันโปรแกรมจะแสดงข้อความยืนยันที่เป็นมิตร บอกว่ากระบวนการสำเร็จ + +--- + +## คำถามที่พบบ่อย (FAQ) + +### จะดึงรูปภาพจาก Word โดยไม่เสียคุณภาพได้อย่างไร? + +Callback จะเขียนสตรีมไบนารีดิบลงไฟล์โดยตรง คงความละเอียดเดิมไว้ ไม่ได้ทำการแปลงหรือบีบอัดใด ๆ เว้นแต่คุณจะเพิ่มตรรกะการประมวลผลรูปภาพของคุณเองใน `ResourceSaving` + +### สามารถเปลี่ยนรูปแบบภาพ (เช่น PNG → JPEG) ระหว่างการดึงออกได้หรือไม่? + +ทำได้แน่นอน ภายใน `ResourceSaving` คุณสามารถตรวจสอบ `args.FileName` หรือ `args.Stream` โหลดรูปด้วย `System.Drawing` หรือ `ImageSharp` แล้วทำการเข้ารหัสใหม่ก่อนบันทึก จำเป็นต้องอัปเดตส่วนขยายของลิงก์ markdown ให้สอดคล้องกันด้วย + +### ถ้าต้องการให้ไฟล์ markdown อ้างอิง CDN แทนโฟลเดอร์โลคัลจะทำอย่างไร? + +แก้ไข callback ให้เพิ่ม base URL เข้าไปในลิงก์ markdown คุณทำได้โดยตั้งค่า `args.FileName` ให้เป็น URL เต็มรูปแบบหลังจากอัปโหลดรูปไปยัง CDN + +### วิธีนี้ทำงานกับตาราง, footnote หรือฟีเจอร์ Word ขั้นสูงอื่น ๆ หรือไม่? + +ใช่ Aspose.Words แปลงส่วนใหญ่ของโครงสร้าง Word ให้เป็น markdown ได้อย่างถูกต้อง ตารางจะกลายเป็นตาราง markdown, footnote จะเป็นลิงก์อ้างอิง, และรายการซ้อนกันก็จัดการได้อย่างราบรื่น หากผลลัพธ์ดูแปลก ให้ตรวจสอบ release notes ล่าสุด—Aspose ปรับปรุงความแม่นยำของการแปลงอย่างต่อเนื่อง + +### จะนำการแปลง docx เป็น markdown ไปใช้ใน pipeline CI/CD อย่างไร? + +เพียงเพิ่มไฟล์ `.exe` ที่คอมไพล์แล้วเข้าไปในขั้นตอน build, ชี้ให้มันทำงานกับไฟล์ `.docx` ที่สร้างขึ้นเป็น artifacts, แล้วผลักไฟล์ `.md` และโฟลเดอร์ `Resources/` ไปยัง repository ของ static site เนื่องจากกระบวนการเป็น deterministic จึงทำงานได้ดีในสภาพแวดล้อมอัตโนมัติ + +--- + +## สรุป + +เราได้สาธิตวิธี **สร้าง markdown จาก Word** ด้วย Aspose.Words, ครอบคลุม workflow **แปลง docx เป็น markdown** ทั้งหมด, และแสดงวิธี **ดึงรูปภาพจาก Word** ด้วยการ implement **วิธีใช้ callback** ที่กำหนดเอง ผลลัพธ์คือไฟล์ markdown ที่สะอาดพร้อมโฟลเดอร์รูปภาพต้นฉบับ—เหมาะสำหรับเว็บไซต์เอกสาร, บล็อกสเตติก, หรือ workflow ใด ๆ ที่ต้องการรูปแบบ plain‑text + +ขั้นตอนต่อไปที่คุณอาจพิจารณา: + +- **ประมวลผลเป็นชุด** หลายไฟล์ `.docx` ในโฟลเดอร์ (วนลูป `Directory.GetFiles`) +- **กำหนดชื่อรูปภาพแบบกำหนดเอง** (เช่น ใช้ข้อความ caption ดั้งเดิม) +- **หลังการประมวลผล** markdown เพื่อเปลี่ยนลิงก์รูปภาพเป็น URL ของ CDN +- สำรวจ **ฟอร์แมตการส่งออกของ Aspose** อื่น ๆ เช่น HTML, PDF, หรือ EPUB สำหรับการเผยแพร่หลายช่องทาง + +มีคำถามเพิ่มเติมหรือไฟล์ Word ที่แปลงยาก? แสดงความคิดเห็นด้านล่าง แล้วเราจะช่วยกันแก้ไข ปล่อยให้การเขียนโค้ดสนุกและเพลิดเพลินกับความง่ายของการแปลง Word เป็น markdown! + +--- + +![Diagram showing Word to Markdown conversion process](image.png "Create markdown from word diagram") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/thai/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/thai/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..911ef269bb --- /dev/null +++ b/words/thai/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,269 @@ +--- +category: general +date: 2026-03-27 +description: วิธีส่งออก LaTeX จาก DOCX ด้วย Aspose.Words. เรียนรู้การแปลง DOCX เป็น + Markdown, ตั้งค่า DPI, และเปิดใช้งานการกู้คืนใน C# +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: th +og_description: วิธีส่งออก LaTeX จาก DOCX ด้วย Aspose.Words บทเรียนนี้แสดงการแปลงเป็น + Markdown อย่างเป็นขั้นตอน การควบคุม DPI และโหมดกู้คืน +og_title: วิธีส่งออก LaTeX จาก DOCX – แปลงเป็น Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: วิธีส่งออก LaTeX จาก DOCX – แปลงเป็น Markdown +url: /th/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีส่งออก LaTeX จาก DOCX – แปลงเป็น Markdown + +เคยสงสัย **วิธีส่งออก LaTeX** จากไฟล์ DOCX โดยไม่สูญเสียความสวยงามของสมการของคุณหรือไม่? คุณไม่ได้เป็นคนเดียวที่คิดแบบนี้ ตามประสบการณ์ของผม จุดบอดที่ใหญ่ที่สุดคือการนำวัตถุ OfficeMath ไปสู่รูปแบบที่สะอาดและพกพาได้สำหรับตัวสร้างเว็บไซต์แบบสถิตหรือบล็อกวิทยาศาสตร์ + +ในคู่มือนี้เราจะอธิบายขั้นตอนการแปลง DOCX เป็น Markdown ด้วย Aspose.Words พร้อมกับแสดง **วิธีตั้งค่า DPI**, **วิธีเปิดใช้งานการกู้คืน**, และเทคนิคเล็ก ๆ น้อย ๆ สำหรับการทำงานของ pipeline ที่มั่นคง สุดท้ายคุณจะได้โปรแกรม C# เดียวที่สร้างไฟล์ Markdown พร้อมสมการ LaTeX, รูปภาพความละเอียดสูง, และการจัดการลิงก์ที่ถูกต้อง + +## สิ่งที่คุณต้องการ + +- **.NET 6+** (หรือ .NET Framework 4.7.2 – API ทำงานเช่นเดียวกัน) +- **Aspose.Words for .NET** (เวอร์ชันเสถียรล่าสุด ณ เดือนมีนาคม 2026) +- ไฟล์ DOCX ที่มีสมการ, รูปภาพ, และลิงก์ +- Visual Studio, VS Code, หรือโปรแกรมแก้ไขใด ๆ ที่คุณชอบ + +ไม่จำเป็นต้องใช้แพ็กเกจ NuGet เพิ่มเติมนอกจาก Aspose.Words แต่ต้องแน่ใจว่าคุณมีลิขสิทธิ์ที่ถูกต้องหากไม่ได้ใช้รุ่นทดลอง + +## ขั้นตอนที่ 1 – โหลด DOCX ด้วยโหมดการกู้คืนแบบเข้มงวด + +ก่อนที่เราจะคิดถึงการส่งออก เราต้องแน่ใจว่าเอกสารต้นทางไม่ได้ซ่อนความเสียหาย นั่นคือจุดที่ **วิธีเปิดใช้งานการกู้คืน** เข้ามามีบทบาท + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**ทำไมต้องการการกู้คืนแบบเข้มงวด?** +หากให้ Aspose แก้ไขปัญหาโดยเงียบ ๆ คุณอาจเจอย่อหน้าที่หายไปหรือรูปภาพที่เสีย—สิ่งที่ไม่มีใครต้องการเมื่อส่งออก LaTeX การล้มเหลวอย่างรวดเร็วช่วยให้คุณจับปัญหาได้ตั้งแต่ต้นและตัดสินใจว่าจะแก้ไข DOCX ต้นทางหรือบันทึกปัญหาไว้เพื่อแก้ในภายหลัง + +### เคล็ดลับพิเศษ +ห่อการโหลดด้วย try/catch และบันทึก `DocumentLoadingException` วิธีนี้ pipeline CI ของคุณจะสามารถระบุไฟล์ที่มีปัญหาโดยไม่ต้องหยุดการสร้างทั้งหมด + +## ขั้นตอนที่ 2 – เตรียมตัวเลือกการส่งออก Markdown + +ตอนนี้เอกสารถูกโหลดเข้าสู่หน่วยความจำอย่างปลอดภัยแล้ว เราจะกำหนดวิธีการบันทึก นี่คือหัวใจของ **วิธีส่งออก latex** และยังครอบคลุม **วิธีตั้งค่า DPI** สำหรับรูปภาพที่ฝังอยู่ + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**แต่ละตัวเลือกทำอะไร** + +| Option | Reason | Relevance to Keywords | +|--------|--------|-----------------------| +| `OfficeMathExportMode = LaTeX` | ตอบโดยตรงกับ **วิธีส่งออก latex** จากสมการ | คำหลักหลัก | +| `ImageResolution = 300` | ควบคุมคุณภาพของรูปภาพ – คำตอบสำหรับ **วิธีตั้งค่า dpi** | คำหลักรอง | +| `ResourceSavingCallback` | บันทึกไฟล์ที่ฝังไว้ลงดิสก์, ความต้องการทั่วไปเมื่อ **แปลง docx เป็น markdown** | คำหลักรอง | +| `EmptyParagraphExportMode` | รับประกันผลลัพธ์ Markdown ที่สะอาด, ป้องกันแท็ก HTML ที่หลงเหลือ | ปรับปรุงคุณภาพการแปลงโดยรวม | +| `LinkExportMode = AsReference` | ทำให้ลิงก์อ่านและแก้ไขง่าย, อีกหนึ่งข้อดีสำหรับ **แปลง docx เป็น markdown** | | + +## ขั้นตอนที่ 3 – สร้าง Custom Resource Saver (ไม่บังคับแต่เป็นประโยชน์) + +เมื่อคุณแปลง DOCX เป็น Markdown รูปภาพและทรัพยากรไบนารีอื่น ๆ ต้องการตำแหน่งบนระบบไฟล์ Aspose ให้คุณควบคุมด้วย `IResourceSavingCallback` โค้ดตัวอย่างข้างบนแสดงการทำงานอย่างพื้นฐานแล้ว แต่เราจะอธิบายรายละเอียด + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**ทำไมต้องทำ?** +หากข้ามขั้นตอนนี้ Aspose จะฝังรูปภาพเป็นสตริง base‑64 ซึ่งทำให้ไฟล์ Markdown ใหญ่ขึ้นอย่างมากและทำให้การควบคุมเวอร์ชันยากขึ้น การบันทึกทรัพยากรลงในโฟลเดอร์แยกทำให้ Markdown มีขนาดเบาและเป็นมิตรกับตัวสร้างเว็บไซต์แบบสถิตเช่น Hugo หรือ Jekyll + +## ขั้นตอนที่ 4 – บันทึกเอกสารเป็น Markdown + +ทุกอย่างที่ต้องทำงานหนักเสร็จแล้ว บรรทัดเดียวจะเขียนไฟล์สุดท้าย + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +เปิด `output.md` แล้วคุณจะเห็น: + +- สมการที่แสดงเป็นบล็อก LaTeX `$…$` +- รูปภาพที่อ้างอิงเป็น `![Alt text](resources/image001.png)` ด้วยความละเอียด 300 dpi +- ลิงก์ที่เปลี่ยนเป็นรูปแบบอ้างอิง: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +นี่คือกระบวนการ **วิธีแปลง docx** ทั้งหมดในสรุปสั้น ๆ + +## คำถามทั่วไปและกรณีขอบ + +### 1️⃣ หาก DOCX มีวัตถุที่ไม่รองรับ? + +Aspose.Words จะโยน `FeatureNotSupportedException` เนื่องจากเราใช้ **วิธีเปิดใช้งานการกู้คืน** ในโหมดเข้มงวด ข้อผิดพลาดจะแสดงทันที คุณสามารถทำได้สองวิธี: + +- เปลี่ยน `RecoveryMode` เป็น `RecoveryMode.Default` เพื่อการแปลงแบบพยายามเต็มที่, **หรือ** +- ทำการประมวลผลล่วงหน้า DOCX (เช่น ลบ SmartArt ที่ไม่รองรับ) ก่อนรันตัวแปลง + +### 2️⃣ ฉันสามารถเปลี่ยน DPI ต่อภาพได้หรือไม่? + +การตั้งค่า `ImageResolution` เป็นค่าทั่วไป สำหรับการควบคุมต่อภาพ ให้สร้าง `ImageSavingCallback` แบบกำหนดเองคล้ายกับ `MyResourceSaver` แล้วปรับ `args.ImageResolution` ตาม `args.ImageFileName` หรือเมตาดาต้า + +### 3️⃣ ฉันจะฝัง LaTeX ที่สร้างขึ้นในเว็บไซต์ Jekyll อย่างไร? + +การสนับสนุน MathJax ในตัวของ Jekyll ทำงานได้ทันที เพียงตรวจสอบว่าเลย์เอาต์ของคุณรวมสคริปต์ MathJax และบล็อก LaTeX ถูกห่อด้วย `$$` สำหรับสมการแสดงผลหรือ `$` สำหรับในบรรทัด + +### 4️⃣ นี้เข้ากันได้กับ .NET Core บน Linux หรือไม่? + +แน่นอน Aspose.Words รองรับหลายแพลตฟอร์ม เพียงตรวจสอบว่าเส้นทาง `YOUR_DIRECTORY` ปฏิบัติตามรูปแบบของ Linux (เช่น `/home/user/docs`) + +## ตัวอย่างการทำงานเต็มรูปแบบ + +ด้านล่างเป็นโปรแกรมที่พร้อมคัดลอกและวาง แทนที่ `YOUR_DIRECTORY` ด้วยเส้นทางจริงบนเครื่องของคุณ + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**ผลลัพธ์ที่คาดหวัง** – เปิด `output.md` แล้วคุณควรเห็นประมาณนี้: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +หากคุณเปิดไฟล์ในตัวดู Markdown ที่รองรับ MathJax สมการอินทิกรัลจะถูกแสดงผล + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/thai/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/thai/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..bccc6cbd89 --- /dev/null +++ b/words/thai/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,211 @@ +--- +category: general +date: 2026-03-27 +description: วิธีส่งออก LaTeX จากเอกสาร Word ด้วย Aspose.Words – แปลง DOCX เป็น Markdown + พร้อมสมการในรูปแบบ LaTeX +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: th +og_description: วิธีการส่งออก LaTeX จากเอกสาร Word ได้รับการอธิบายในประโยคแรก ซึ่งจะแสดงให้คุณเห็นวิธีแปลง + DOCX เป็น Markdown พร้อมสมการในรูปแบบ LaTeX. +og_title: วิธีส่งออก LaTeX จาก Word – คู่มือเต็ม +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: วิธีส่งออก LaTeX จาก Word – แปลง DOCX เป็น Markdown +url: /th/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีส่งออก LaTeX จาก Word – แปลง DOCX เป็น Markdown + +เคยสงสัยไหมว่า **how to export LaTeX** จากไฟล์ Word โดยไม่ต้องลงท้ายด้วยภาพ PNG จำนวนมาก? คุณไม่ได้เป็นคนเดียว; นักพัฒนามักเจออุปสรรคนี้เมื่อต้องการสมการที่สะอาดและแก้ไขได้สำหรับเว็บไซต์แบบสถิตหรือบล็อกวิทยาศาสตร์ ข่าวดี? ด้วย Aspose.Words คุณสามารถ **convert Word to Markdown** และเก็บวัตถุ OfficeMath ทั้งหมดเป็น LaTeX แบบดั้งเดิม—ไม่ต้องทำการประมวลผลต่อ + +ในบทแนะนำนี้เราจะเดินผ่านกระบวนการทั้งหมดของ **saving a Word document as Markdown** พร้อมกับ **exporting equations as LaTeX**. เมื่อจบคุณจะมีโค้ดสแนป C# ที่สามารถรันได้, คำอธิบายที่ชัดเจนของแต่ละตัวเลือก, และเคล็ดลับสำหรับจัดการกรณีขอบเช่นสูตรซับซ้อนหรือเนื้อหาผสม. ไม่ต้องใช้เครื่องมือภายนอก, เพียงแพคเกจ NuGet เดียวและไม่กี่บรรทัดของโค้ด. + +## สิ่งที่คุณต้องการ + +- .NET 6+ (หรือ .NET Framework 4.7.2 ขึ้นไป) – เวอร์ชัน runtime ล่าสุดทำงานได้ดีที่สุด +- Visual Studio 2022 หรือโปรแกรมแก้ไขใด ๆ ที่สามารถคอมไพล์โปรเจกต์ C# +- ใบอนุญาต Aspose.Words for .NET (ทดลองฟรีใช้ได้สำหรับการทดลอง) +- ไฟล์ DOCX ที่มีอย่างน้อยหนึ่งสมการ (OfficeMath) + +ถ้าคุณมีทั้งหมดแล้ว, ยอดเยี่ยม—มาเริ่มกันเลย. + +## วิธีส่งออก LaTeX จาก Word – ภาพรวม + +ด้านล่างเป็นมุมมองระดับสูงของขั้นตอนที่เกี่ยวข้อง: + +1. **Install** the Aspose.Words NuGet package. +2. **Load** the source `.docx` that holds your equations. +3. **Configure** `MarkdownSaveOptions` so that `OfficeMathExportMode` is set to `LaTeX`. +4. **Save** the document as a `.md` file. +5. **Verify** that the generated Markdown contains LaTeX blocks (`$$…$$`). + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="แผนภาพการแปลงจาก DOCX ไปเป็น Markdown พร้อมสมการ LaTeX"} + +## ขั้นตอนที่ 1 – ติดตั้ง Aspose.Words for .NET (convert word to markdown) + +สิ่งแรกที่ต้องทำคือคุณต้องมีไลบรารีที่ทำงานหนักนี้. เปิดเทอร์มินัลของคุณ (หรือ Package Manager Console) แล้วรัน: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** หากคุณใช้ Visual Studio, คลิกขวาที่โปรเจกต์ → *Manage NuGet Packages* → ค้นหา “Aspose.Words” และติดตั้งเวอร์ชัน stable ล่าสุด + +ทำไมเรื่องนี้ถึงสำคัญ: Aspose.Words แยกความซับซ้อนของรูปแบบ Open XML, ให้คุณมี API ที่สะอาดเพื่อจัดการเอกสาร Word โดยไม่ต้องเจาะลึก XML ระดับต่ำ. มันยังมาพร้อมการสนับสนุนในตัวสำหรับการแปลง OfficeMath เป็น LaTeX, ซึ่งเป็นหัวใจของความต้องการ **export equations as LaTeX** ของเรา. + +## ขั้นตอนที่ 2 – โหลดไฟล์ DOCX (how to convert docx) + +ตอนนี้แพคเกจพร้อมแล้ว, โหลดไฟล์ที่คุณต้องการแปลง. แทนที่ `YOUR_DIRECTORY` ด้วยเส้นทางที่ไฟล์ `.docx` ของคุณอยู่: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Why load it this way?** ตัวสร้าง `Document` จะทำการพาร์สไฟล์ทั้งหมดเป็นโมเดลอ็อบเจกต์, ให้คุณเข้าถึงย่อหน้า, ตาราง, และ—ที่สำคัญที่สุด—วัตถุ OfficeMath ได้ทันที. หากไฟล์หายหรือเสียหาย, Aspose จะโยน `FileNotFoundException` ที่อธิบายได้ชัดเจน, ซึ่งคุณสามารถจับเพื่อจัดการข้อผิดพลาดอย่างสุภาพ. + +## ขั้นตอนที่ 3 – ตั้งค่า MarkdownSaveOptions (export equations as latex) + +ความมหัศจรรย์เกิดขึ้นในอ็อบเจกต์ `MarkdownSaveOptions`. โดยค่าเริ่มต้น Aspose จะเรนเดอร์สมการเป็นภาพ PNG, แต่เราต้องการ LaTeX. ตั้งค่า `OfficeMathExportMode` เป็น `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +หมายเหตุสั้น ๆ เกี่ยวกับแฟล็กทางเลือก: `ExportImagesAsBase64` บอก Aspose ไม่ให้ฝังข้อมูลไบนารี, ทำให้ Markdown สะอาด. `ExportHeadersFooters` รับประกันว่าคุณจะไม่สูญเสียบริบทใด ๆ ที่อาจอยู่ในส่วนหัวหรือส่วนท้าย—มีประโยชน์เมื่อหัวเรื่องมีชื่อเรื่องหรือชื่อผู้เขียน. + +## ขั้นตอนที่ 4 – บันทึกเอกสาร (save word as markdown) + +สุดท้าย, เขียนเนื้อหาที่แปลงแล้วลงไฟล์ `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +หลังจากบรรทัดนี้ทำงาน, คุณจะพบ `output.md` อยู่ข้างไฟล์ต้นฉบับ. เปิดไฟล์ด้วยโปรแกรมแก้ไขข้อความใดก็ได้และคุณควรเห็นบล็อก LaTeX ที่มีลักษณะดังนี้: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +นั่นคือส่วน **save word as markdown** เสร็จแล้ว—ไม่ต้องมีขั้นตอนแปลงเพิ่มเติมใด ๆ. + +## ขั้นตอนที่ 5 – ตรวจสอบผลลัพธ์ (export equations as latex) + +ง่ายต่อการมองข้ามการตรวจสอบ, แต่การตรวจสอบอย่างรวดเร็วช่วยประหยัดเวลามากในภายหลัง. รันสคริปต์ง่าย ๆ ที่อ่านไฟล์ที่สร้างขึ้นและพิมพ์บล็อก LaTeX แรก: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +หากคุณเห็น `First LaTeX block: $$ … $$` แสดงว่าคุณได้ **exported LaTeX** จาก Word อย่างสำเร็จ. หากไม่, ตรวจสอบอีกครั้งว่าเอกสารต้นฉบับของคุณมีวัตถุ OfficeMath จริงหรือไม่; สมการที่เป็นข้อความธรรมดาจะไม่ถูกแปลง. + +## การจัดการกรณีขอบทั่วไป + +| สถานการณ์ | สิ่งที่ควรระวัง | วิธีแก้แนะนำ | +|----------|-------------------|-----------------| +| **Mixed images & equations** | Aspose อาจยังฝังรูปภาพสำหรับกราฟิกที่ไม่ใช่ OfficeMath. | ตั้งค่า `ExportImagesAsBase64 = false` และเก็บรูปภาพเป็นไฟล์ภายนอก, จากนั้นอ้างอิงด้วยตนเองใน Markdown. | +| **Complex nested equations** | การซ้อนลึกมากอาจทำให้ LaTeX ที่ได้ต้องปรับแก้ด้วยตนเอง. | ทำ post‑process บล็อกด้วย LaTeX formatter (เช่น `latexindent`) หรือปรับ `mdOptions` → `ExportMathAsDisplay = true`. | +| **Large documents** | การใช้หน่วยความจำพุ่งสูงเมื่อโหลดไฟล์ `.docx` ขนาดใหญ่. | ใช้ `LoadOptions` กับ `LoadFormat.Docx` และเปิดการสตรีม `LoadOptions.LoadFormat` หากมีให้ใช้. | +| **Missing license** | รุ่นทดลองฟรีจะเพิ่มคอมเมนต์ลายน้ำลงในผลลัพธ์. | ใช้ใบอนุญาตที่ถูกต้องผ่าน `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +เคล็ดลับเหล่านี้ทำให้ workflow ของคุณแข็งแรง, โดยเฉพาะเมื่อคุณ **convert word to markdown** ในสายการผลิต. + +## ตัวอย่างทำงานเต็มรูปแบบ (All Steps in One File) + +ด้านล่างเป็นแอปคอนโซลที่รวมทุกขั้นตอนไว้ในไฟล์เดียว, คุณสามารถคัดลอก‑วางลงในโปรเจกต์ .NET ใหม่และรันได้ทันที. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +รันโปรแกรม, เปิด `output.md`, แล้วคุณจะเห็นสมการของคุณแสดงเป็น LaTeX ที่สะอาด. นั่นคือคำตอบสมบูรณ์สำหรับ **how to export latex** จากเอกสาร Word. + +## สรุป + +เราครอบคลุม **how to export LaTeX** จาก Word อย่างเป็นขั้นตอน, แสดงให้คุณเห็นวิธี **convert Word to markdown**, **save word as markdown**, และ **export equations as LaTeX** ด้วย Aspose.Words. แนวคิดหลักง่าย ๆ: โหลด DOCX, ปรับ `MarkdownSaveOptions`, แล้วให้ไลบรารีทำงานหนักให้. + +หากคุณพร้อมที่จะอัตโนมัติ pipeline ของเอกสาร, ลองเชื่อมโค้ดนี้กับ static‑site generator อย่าง Hugo หรือ Jekyll—แค่ผลักไฟล์ `.md` ที่สร้างขึ้นเข้ารีโพและให้ไซต์รีบิลด์. สำหรับการอ่านต่อ, สำรวจคู่มือ “Export to LaTeX” ของ Aspose, ทดลอง `HtmlSaveOptions` เพื่อดูตัวอย่างเว็บ, หรือเจาะลึก API `DocumentVisitor` สำหรับการแปลงแบบกำหนดเอง. + +มีคำถามเกี่ยวกับกรณีขอบ, ใบอนุญาต, หรือการผสานเข้ากับ CI/CD? ทิ้งคอมเมนต์ไว้ด้านล่าง, แล้วขอให้เขียนโค้ดอย่างสนุกสนาน! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/thai/net/programming-with-pdfsaveoptions/_index.md b/words/thai/net/programming-with-pdfsaveoptions/_index.md index 9b9ca8e183..17ad69ecc4 100644 --- a/words/thai/net/programming-with-pdfsaveoptions/_index.md +++ b/words/thai/net/programming-with-pdfsaveoptions/_index.md @@ -45,7 +45,7 @@ | [อัปเดตคุณสมบัติที่พิมพ์ล่าสุดในเอกสาร PDF](./update-last-printed-property/) | เรียนรู้วิธีอัปเดตคุณสมบัติที่พิมพ์ล่าสุดในเอกสาร PDF โดยใช้ Aspose.Words สำหรับ .NET ด้วยคำแนะนำทีละขั้นตอนของเรา - [เรนเดอร์ 3D DML 3DEffects ในเอกสาร PDF](./dml-3deffects-rendering/) | เรียนรู้วิธีการเรนเดอร์เอฟเฟ็กต์ DML สามมิติอันน่าทึ่งในเอกสาร PDF โดยใช้ Aspose.Words สำหรับ .NET ด้วยคู่มือทีละขั้นตอนที่ครอบคลุมนี้ - [การแทรกภาพในเอกสาร PDF](./interpolate-images/) | เรียนรู้วิธีการแทรกรูปภาพในเอกสาร PDF โดยใช้ Aspose.Words สำหรับ .NET ด้วยคู่มือทีละขั้นตอนของเรา ปรับปรุงคุณภาพรูปภาพใน PDF ของคุณได้อย่างง่ายดาย | - +- [วิธีบันทึก PDF จาก DOCX ด้วย Aspose.Words – คู่มือทีละขั้นตอน](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | เรียนรู้วิธีแปลงไฟล์ DOCX เป็น PDF อย่างละเอียดด้วย Aspose.Words ผ่านขั้นตอนง่าย ๆ | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/thai/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/thai/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..c6ea6be437 --- /dev/null +++ b/words/thai/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-03-27 +description: เรียนรู้วิธีบันทึก PDF จากไฟล์ DOCX ด้วย Aspose.Words รวมถึงการแปลง DOCX + เป็น PDF, การบันทึก PDF พร้อมตัวเลือก, และการจัดการรูปทรงลอยตัว +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: th +og_description: วิธีบันทึก PDF จากไฟล์ DOCX ด้วย Aspose.Words คู่มือนี้แสดงการแปลง + DOCX เป็น PDF, การบันทึก PDF พร้อมตัวเลือก, และการจัดการรูปทรงลอยตัว +og_title: วิธีบันทึก PDF จาก DOCX – บทเรียน Aspose.Words อย่างสมบูรณ์ +tags: +- Aspose.Words +- C# +- PDF conversion +title: วิธีบันทึก PDF จาก DOCX ด้วย Aspose.Words – คู่มือขั้นตอนโดยละเอียด +url: /th/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีบันทึก PDF จาก DOCX ด้วย Aspose.Words – บทเรียนฉบับสมบูรณ์ + +เคยสงสัย **วิธีบันทึก PDF** จากเอกสาร Word โดยไม่เสียรูปแบบของวัตถุลอยอยู่หรือไม่? คุณไม่ได้เป็นคนเดียว ในหลายโครงการ—เช่นตัวสร้างใบแจ้งหนี้, ตัวส่งออกรายงาน, หรือเครื่องมือจัดเก็บเอกสารอย่างง่าย—นักพัฒนาต้องการวิธีที่เชื่อถือได้ในการแปลง DOCX เป็น PDF พร้อมคงรูปลักษณ์เดิมเหมือนใน Word + +ในบทเรียนนี้เราจะอธิบายขั้นตอนการแปลงไฟล์ DOCX เป็น PDF **โดยใช้ Aspose.Words for .NET**, แสดง **วิธีแปลง docx to pdf** ด้วยตัวเลือกการบันทึกที่กำหนดเอง, และอธิบายว่าทำไมแฟล็ก `ExportFloatingShapesAsInlineTag` ถึงสำคัญ สุดท้ายคุณจะได้โค้ดสั้น ๆ ที่พร้อมรันเพื่อบันทึก PDF ด้วยตัวเลือกที่คุณควบคุม + +## สิ่งที่คุณจะได้เรียนรู้ + +- ขั้นตอนที่แม่นยำในการ **convert word document pdf** ด้วย Aspose.Words +- วิธีตั้งค่า `PdfSaveOptions` ให้จัดการวัตถุลอยเป็นแท็กอินไลน์ +- ปัญหาที่พบบ่อยเมื่อทำงานกับวัตถุลอยและวิธีหลีกเลี่ยง +- โปรแกรม C# ที่สมบูรณ์และรันได้ซึ่งคุณสามารถนำไปใส่ในโครงการ .NET ใดก็ได้ + +> **Prerequisite:** คุณต้องมีลิขสิทธิ์ Aspose.Words for .NET (หรือเวอร์ชันทดลองฟรี) และสภาพแวดล้อมการพัฒนา .NET (Visual Studio, Rider หรือ `dotnet` CLI) + +## ขั้นตอนที่ 1: ตั้งค่าโปรเจกต์และเพิ่ม Aspose.Words + +เริ่มแรกสร้างแอปคอนโซลใหม่ (หรือเพิ่มในแอปที่มีอยู่) แล้วอ้างอิงแพคเกจ NuGet ของ Aspose.Words + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro tip:** หากคุณทำงานบนเซิร์ฟเวอร์ CI ให้ระบุเวอร์ชันของแพคเกจ (`Aspose.Words --version 24.10`) เพื่อรับประกันการสร้างที่ทำซ้ำได้ + +## ขั้นตอนที่ 2: โหลด DOCX ที่มีวัตถุลอย + +รูปภาพ, กล่องข้อความ, หรือ SmartArt ที่ลอยอยู่สามารถทำให้การจัดวางเปลี่ยนแปลงเมื่อแปลงได้ การโหลดเอกสารทำได้ง่าย แต่เราจะตรวจสอบให้ไฟล์มีอยู่จริงเพื่อป้องกัน `FileNotFoundException` ระหว่างรัน + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +สังเกตคำสั่ง `Console.WriteLine` — มันจะให้ฟีดแบ็กอย่างรวดเร็วเมื่อคุณรันแอปจากเทอร์มินัล + +## ขั้นตอนที่ 3: ตั้งค่าตัวเลือกการบันทึก PDF (Save PDF with Options) + +นี่คือจุดที่ “เวทมนต์” เกิดขึ้น โดยค่าเริ่มต้น Aspose.Words จะพยายามคงวัตถุลอยไว้ตามที่ปรากฏ ซึ่งอาจทำให้การจัดวางใน PDF ผลลัพธ์เสีย การตั้งค่า `ExportFloatingShapesAsInlineTag` เป็น `true` จะบอกไลบรารีให้จัดการวัตถุเหล่านั้นเป็นแท็กอินไลน์ ทำให้พวกมันยึดติดกับข้อความรอบข้าง + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +ทำไมจึงสำคัญ? ลองนึกถึงกล่องข้อความที่ลอยเหนือย่อหน้า หากไม่มีการแปลงเป็นอินไลน์ แฟล็กนี้อาจทำให้ PDF ผลักย่อหน้าลงหรือคลิปกล่องโดยสมบูรณ์ แฟล็กช่วยรักษาความสัมพันธ์เชิงภาพไว้—รายละเอียดเล็ก ๆ แต่สำคัญสำหรับรายงานระดับมืออาชีพ + +## ขั้นตอนที่ 4: บันทึกเอกสารเป็น PDF + +ตอนนี้เราจะเขียนไฟล์ PDF จริง ๆ เมธอด `Save` จะรับทั้งเส้นทางไฟล์เอาต์พุตและตัวเลือกที่เราตั้งไว้ + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +เมื่อรันโปรแกรมจะสร้าง `output.pdf` ในโฟลเดอร์เดียวกับ DOCX ต้นฉบับ เปิดไฟล์ด้วยโปรแกรมดู PDF ใดก็ได้ คุณควรเห็นวัตถุลอยทั้งหมดแสดงตรงตำแหน่งที่ควรอยู่ + +## ตัวอย่างทำงานเต็มรูปแบบ + +ด้านล่างเป็นโปรแกรมทั้งหมดในบล็อกเดียว คัดลอก‑วางลงใน `Program.cs` (หรือไฟล์ C# ใดก็ได้) แล้วกด **F5** + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### ผลลัพธ์ที่คาดหวัง + +- **ไฟล์ที่สร้าง:** `output.pdf` ในไดเรกทอรีเป้าหมาย +- **ความแม่นยำของการจัดวาง:** วัตถุลอย (รูปภาพ, กล่องข้อความ, SmartArt) ปรากฏเป็นอินไลน์กับข้อความรอบข้าง +- **ไม่มีข้อยกเว้น:** โปรแกรมจบอย่างราบรื่น พร้อมพิมพ์ข้อความสถานะลงคอนโซล + +## คำถามที่พบบ่อย & กรณีขอบ + +| Question | Answer | +|----------|--------| +| **ต้องการคุณภาพภาพสูงขึ้นไหม?** | ตั้งค่า `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **สามารถแปลงหลายไฟล์ DOCX พร้อมกันได้หรือไม่?** | ห่อโลจิกการโหลด/บันทึกไว้ในลูป `foreach (var file in Directory.GetFiles(..., "*.docx"))` จำไว้ว่าให้ใช้อินสแตนซ์ `PdfSaveOptions` ตัวเดียวสำหรับประสิทธิภาพ | +| **ทำงานกับ .NET Core ได้หรือไม่?** | ได้เลย Aspose.Words 24.x รองรับ .NET Standard 2.0+ จึงรันได้บน Windows, Linux หรือ macOS | +| **ไฟล์ DOCX ที่มีรหัสผ่านล่ะ?** | โหลดด้วย `new Document(inputPath, new LoadOptions { Password = "mySecret" })` ตัวเลือก `PdfSaveOptions` เดิมใช้ได้เมื่อบันทึก | +| **การแปลงเป็นอินไลน์ปลอดภัยกับตารางซับซ้อนไหม?** | ส่วนใหญ่ใช่ แต่ตารางที่ซับซ้อนมากพร้อมรูปทรงทับซ้อนอาจต้องปรับแต่งด้วยตนเอง ทดสอบตัวอย่างที่เป็นตัวแทนก่อนทำการย้ายจำนวนมาก | + +## เคล็ดลับสำหรับโครงการจริง + +- **Log, don’t just `Console.WriteLine`** – ในการผลิตให้เปลี่ยนการพิมพ์คอนโซลเป็นเฟรมเวิร์กล็อก (Serilog, NLog) เพื่อบันทึกข้อผิดพลาด +- **Dispose of resources** – `Document` implements `IDisposable` ใช้ `using` block หากประมวลผลหลายไฟล์เพื่อคืนหน่วยความจำทันที +- **Validate the PDF** – ใช้ตัวตรวจสอบ PDF (เช่น PDF/A compliance checker) หากต้องการ PDF ระดับเก็บถาวร +- **Parallel processing** – สำหรับงานจำนวนมาก พิจารณา `Parallel.ForEach` พร้อม `PdfSaveOptions` ที่ปลอดภัยต่อเธรด (clone ต่อเธรด) เพื่อเร่งความเร็วการแปลง + +## สรุป + +เราได้ครอบคลุม **วิธีบันทึก PDF** จากไฟล์ DOCX ด้วย Aspose.Words, แสดง **วิธีแปลง docx to pdf** ด้วยตัวเลือกกำหนดเอง, และอธิบายผลของ `ExportFloatingShapesAsInlineTag` ตัวอย่างเต็มที่รันได้แสดงให้เห็นว่าคุณสามารถ **convert word document pdf** ได้ในไม่กี่บรรทัด และตอนนี้คุณรู้วิธี **save pdf with options** ที่เหมาะกับคุณภาพและความต้องการการปฏิบัติตามของโครงการคุณแล้ว + +พร้อมรับความท้าทายต่อไปหรือยัง? ลองส่งออกเป็นรูปแบบอื่น (เช่น HTML, EPUB) ด้วย `document.Save("output.html")` หรือทดลอง PDF/A สำหรับการเก็บถาวร หลักการเดียวกัน—โหลด, ตั้งค่าตัวเลือก, บันทึก—ใช้ได้กับทุกกรณี + +ขอให้เขียนโค้ดสนุกและ PDF ของคุณออกมาตรงตามที่คุณต้องการเสมอ! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "แผนภาพวิธีบันทึก pdf") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/thai/net/programming-with-shapes/_index.md b/words/thai/net/programming-with-shapes/_index.md index a4034019ec..fc01517f0e 100644 --- a/words/thai/net/programming-with-shapes/_index.md +++ b/words/thai/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ - [ตรวจจับรูปทรงศิลปะอัจฉริยะ](./detect-smart-art-shape/) | เรียนรู้วิธีการตรวจจับรูปทรง SmartArt ในเอกสาร Word โดยใช้ Aspose.Words สำหรับ .NET ด้วยคู่มือฉบับสมบูรณ์นี้ เหมาะอย่างยิ่งสำหรับการสร้างระบบอัตโนมัติในเวิร์กโฟลว์เอกสารของคุณ - | [อัพเดท Smart Art Drawing](./update-smart-art-drawing/) | เรียนรู้วิธีอัปเดตภาพวาด Smart Art ในเอกสาร Word โดยใช้ Aspose.Words สำหรับ .NET ด้วยคำแนะนำทีละขั้นตอนนี้ รับรองว่าภาพของคุณจะถูกต้องเสมอ - [สร้างรูปสี่เหลี่ยมใน Word ด้วย Aspose.Words – คู่มือทีละขั้นตอน](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | เรียนรู้วิธีสร้างรูปสี่เหลี่ยมในเอกสาร Word ด้วย Aspose.Words สำหรับ .NET ผ่านขั้นตอนที่ชัดเจนและตัวอย่างโค้ด +- [สร้างเอกสาร Word C# – เพิ่มรูปทรงพร้อมเงา](./create-word-document-c-add-shape-with-shadow/) | เรียนรู้วิธีสร้างเอกสาร Word ด้วย C# และเพิ่มรูปทรงพร้อมเงาโดยใช้ Aspose.Words สำหรับ .NET {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/thai/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/thai/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..89acb332d4 --- /dev/null +++ b/words/thai/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-03-27 +description: สร้างเอกสาร Word ด้วย C# และเรียนรู้วิธีเพิ่มรูปทรง, ใส่เงาให้รูปทรง, + และตั้งค่าระยะเงา คู่มือขั้นตอนโดยละเอียดสำหรับ Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: th +og_description: สร้างเอกสาร Word ด้วย C# พร้อมรูปสี่เหลี่ยมและเงาที่กำหนดเอง ทำตามบทเรียนฉบับเต็มนี้เพื่อกำหนดระยะห่างและสไตล์ของเงา. +og_title: สร้างเอกสาร Word ด้วย C# – เพิ่มรูปทรงพร้อมเงา +tags: +- Aspose.Words +- C# +- Document Automation +title: สร้างเอกสาร Word ด้วย C# – เพิ่มรูปทรงพร้อมเงา +url: /th/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# สร้าง Word Document C# – เพิ่มรูปร่างพร้อมเงา + +เคยต้องการ **create word document c#** ที่มีสี่เหลี่ยมผืนผ้าตกแต่งอย่างสวยงามหรือไม่? บางทีคุณอาจกำลังสร้างเทมเพลตรายงานและต้องการเงาตกที่ละเอียดเพื่อทำให้การจัดวางโดดเด่นขึ้น ในบทแนะนำนี้เราจะอธิบายขั้นตอนนั้น – วิธีเพิ่มรูปร่าง, ใช้เงากับรูปร่าง, และแม้กระทั่งปรับระยะเงาโดยใช้ Aspose.Words. + +เราจะเริ่มจากเอกสารเปล่า, แทรกสี่เหลี่ยม, ให้เงาตั้งล่วงหน้า, แล้วบันทึกไฟล์ เมื่อเสร็จคุณจะได้ไฟล์ .docx ที่พร้อมใช้งานซึ่งสามารถเปิดใน Word และเห็นผลทันที ไม่ต้องใช้เครื่องมือภายนอก เพียงแค่โค้ด C# ธรรมดา + +## ข้อกำหนดเบื้องต้น + +- .NET 6 (หรือ .NET Framework เวอร์ชันล่าสุด) ที่ติดตั้งแล้ว +- Visual Studio 2022 หรือ VS Code พร้อมส่วนขยาย C# +- Aspose.Words for .NET NuGet package (`Aspose.Words` version 23.12 หรือใหม่กว่า) + คุณสามารถเพิ่มได้ผ่าน Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +แค่นั้นเอง – ไม่ต้องใช้ DLL เพิ่มเติมหรือ COM interop + +## ขั้นตอนที่ 1: เริ่มต้นเอกสารใหม่และ Builder – *create word document c#* Basics + +ก่อนอื่นเราต้องการอ็อบเจ็กต์ `Document` ที่เป็นตัวแทนไฟล์ Word และ `DocumentBuilder` เพื่อแก้ไขมัน + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **ทำไมขั้นตอนนี้สำคัญ:** คลาส `Document` เป็นคอนเทนเนอร์สำหรับส่วนต่าง ๆ ของ Word (หน้า, สไตล์, รูปภาพ) Builder เป็น API ระดับสูงที่ซ่อนการจัดการโหนดระดับล่าง ทำให้คุณสามารถ **create word document c#** ได้ง่ายโดยไม่ต้องจัดการ XML ด้วยตนเอง + +## ขั้นตอนที่ 2: แทรกรูปร่างสี่เหลี่ยม – *how to create rectangle* + +ตอนนี้เราจะวางสี่เหลี่ยมบนหน้า ขนาดจะระบุเป็นจุด (1 pt ≈ 1/72 in) + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **เคล็ดลับ:** หากต้องการรูปร่างอื่น เพียงเปลี่ยน `ShapeType.Rectangle` เป็น `ShapeType.Ellipse`, `ShapeType.Triangle` ฯลฯ โค้ดเดียวกันทำงานได้กับ **how to add shape** ทุกประเภท + +## ขั้นตอนที่ 3: ใช้เงาตั้งล่วงหน้าและปรับแต่ง – *apply shadow to shape* + +Aspose.Words มีเงาตั้งล่วงหน้าหลายแบบ เราจะใช้ `Preset1` แล้วปรับระยะ, ความเบลอ, ความโปร่งใส, และสีตามต้องการ + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **ทำไมต้องปรับเงา:** คุณสมบัติ `Distance` ควบคุมระยะห่างของเงาจากสี่เหลี่ยม – เหมือนกับ “การยก” ที่เห็นในเรนเดอร์ 3‑D การเปลี่ยน `BlurRadius` ทำให้ขอบนุ่มขึ้น ส่วน `Transparency` ช่วยสร้างลุคที่ละเอียดและเป็นมืออาชีพ สิ่งนี้ตอบสนองความต้องการ **set shadow distance** และแสดงวิธี **apply shadow to shape** อย่างยืดหยุ่น + +## ขั้นตอนที่ 4: บันทึกเอกสาร – *create word document c#* Completion + +สุดท้ายให้เขียนเอกสารลงดิสก์ ปรับเส้นทางให้ชี้ไปยังโฟลเดอร์ที่คุณมีสิทธิ์เขียน + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +เปิดไฟล์ที่ได้ใน Microsoft Word คุณจะเห็นสี่เหลี่ยมสีฟ้าอ่อนพร้อมเงาสีเทานุ่มที่เลื่อนออก 5 pt นั่นคือหลักฐานว่าคุณได้ **create word document c#** พร้อมรูปร่างที่ตกแต่งเรียบร้อยแล้ว + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="สร้างเอกสาร word c# ตัวอย่างแสดงสี่เหลี่ยมพร้อมเงา"} + +## ตัวแปรเพิ่มเติม & กรณีขอบ + +| Scenario | What to Change | Why it Matters | +|----------|----------------|----------------| +| **สไตล์เงาที่แตกต่าง** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | ให้ลุคที่ดราม่ามากขึ้นโดยไม่ต้องเขียนโค้ดเพิ่มเติม | +| **ไม่มี preset – เงากำหนดเอง** | Omit `Format` and set `OffsetX`, `OffsetY` manually. | ควบคุมเต็มที่เกี่ยวกับทิศทางและความลึก | +| **หลายรูปร่าง** | Call `builder.InsertShape` again before saving. | มีประโยชน์สำหรับเทมเพลตซับซ้อนที่มีไอคอน, โลโก้ ฯลฯ | +| **ความเข้ากันได้กับเวอร์ชัน Aspose เก่า** | Use `ShadowEffect` class (available in v20.x). | ทำให้แน่ใจว่าโค้ดของคุณทำงานบนโครงการเก่า | +| **บันทึกเป็น PDF** | `document.Save("ShadowShape.pdf");` | การเรนเดอร์เงาเดียวกันจะปรากฏในไฟล์ PDF | + +> **คำถามทั่วไป:** *ถ้าเงาไม่แสดงใน Word จะทำอย่างไร?* +> ตรวจสอบว่าคุณใช้ Aspose.Words เวอร์ชันล่าสุด (≥ 22.9) รุ่นเก่ามีการสนับสนุนเงาที่จำกัด และตรวจสอบว่าเปิดเอกสารด้วย Word เวอร์ชันใหม่ (2016+) ด้วย + +## ตัวอย่างการทำงานเต็มรูปแบบ + +ด้านล่างเป็นโปรแกรมที่พร้อมคัดลอกและวาง ใช้ `using` directive ทั้งหมด, คอมเมนต์, และการจัดการข้อผิดพลาดเพื่อประสบการณ์ที่ราบรื่น + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +เรียกใช้โปรแกรม, ไปที่ `C:\Temp\ShadowShape.docx` แล้วคุณจะเห็นสี่เหลี่ยมพร้อมเงาที่กำหนดไว้ตรงตามที่ตั้งค่า + +## สรุป & ขั้นตอนต่อไป + +- ตอนนี้คุณรู้วิธี **create word document c#**, แทรกสี่เหลี่ยม, และ **apply shadow to shape** พร้อม **set shadow distance** ที่กำหนดเอง +- ตัวอย่างใช้ Aspose.Words ซึ่งทำให้ซับซ้อนของ OpenXML หายไปและรับประกันการเรนเดอร์ที่สม่ำเสมอในทุกเวอร์ชันของ Word +- อยากไปต่อ? ลองรวมหลายรูปร่าง, เพิ่มข้อความภายในสี่เหลี่ยม, หรือส่งออกเป็น PDF เพื่อดูว่าการเงาถูกแปลงอย่างไร + +### หัวข้อที่เกี่ยวข้องที่คุณอาจสนใจ + +- **How to add shape** ไปยังส่วนหัว/ส่วนท้ายเพื่อสร้างแบรนด์ +- ใช้ **Aspose.Words** แทรกแผนภูมิและตารางโดยอัตโนมัติ +- ปรับแต่ง **shadow effects** บนรูปภาพแทนรูปเวกเตอร์ +- อัตโนมัติการสร้างเอกสารจำนวนมากสำหรับใบแจ้งหนี้หรือใบรับรอง + +ทดลองเล่น, ทำให้โค้ดพัง, แล้วสร้างใหม่ – นั่นคือวิธีที่เร็วที่สุดในการทำความเข้าใจแนวคิด หากเจออุปสรรคใด ๆ คอมเมนต์ด้านล่างหรือดูเอกสาร Aspose.Words อย่างเป็นทางการเพื่อข้อมูลเชิงลึกของ API + +ขอให้เขียนโค้ดอย่างสนุกและทำให้ไฟล์ Word ของคุณดูเป็นมืออาชีพยิ่งขึ้น! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/thai/net/programming-with-txtsaveoptions/_index.md b/words/thai/net/programming-with-txtsaveoptions/_index.md index 6d5e19b143..eedc39c89d 100644 --- a/words/thai/net/programming-with-txtsaveoptions/_index.md +++ b/words/thai/net/programming-with-txtsaveoptions/_index.md @@ -26,8 +26,8 @@ - - [เพิ่มเครื่องหมาย Bidi ในเอกสาร Word](./add-bidi-marks/) | เรียนรู้วิธีการเพิ่มเครื่องหมายทิศทางสองทาง (Bidi) ในเอกสาร Word โดยใช้ Aspose.Words สำหรับ .NET ด้วยคู่มือนี้ รับรองทิศทางข้อความที่ถูกต้องสำหรับเนื้อหาหลายภาษา - | [ใช้อักขระแท็บต่อระดับสำหรับการเยื้องรายการ](./use-tab-character-per-level-for-list-indentation/) | เรียนรู้วิธีการสร้างรายการหลายระดับพร้อมการเยื้องแบบแท็บโดยใช้ Aspose.Words สำหรับ .NET ปฏิบัติตามคู่มือนี้เพื่อการจัดรูปแบบรายการที่แม่นยำในเอกสารของคุณ - -| [ใช้ช่องว่างต่อระดับสำหรับการเยื้องรายการ](./use-space-character-per-level-for-list-indentation/) | เรียนรู้วิธีการสร้างรายการหลายระดับพร้อมการเยื้องอักขระช่องว่างใน Aspose.Words สำหรับ .NET คำแนะนำทีละขั้นตอนสำหรับการจัดรูปแบบเอกสารอย่างแม่นยำ | - +| [ใช้ช่องว่างต่อระดับสำหรับการเยื้องรายการ](./use-space-character-per-level-for-list-indentation/) | เรียนรู้วิธีการสร้างรายการหลายระดับพร้อมการเยื้องอักขระช่องว่างใน Aspose.Words สำหรับ .NET คำแนะนำทีละขั้นตอนสำหรับการจัดรูปแบบเอกสารอย่างแม่นยำ - +- [บันทึก docx เป็น txt – คู่มือครบวงจรสำหรับการส่งออกสมการ Word ไปยัง LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | เรียนรู้วิธีบันทึกไฟล์ docx เป็น txt พร้อมส่งออกสมการ Word ไปเป็น LaTeX อย่างละเอียด - {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/thai/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/thai/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..162f2d4cbb --- /dev/null +++ b/words/thai/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,245 @@ +--- +category: general +date: 2026-03-27 +description: บันทึกไฟล์ docx เป็น txt ด้วย Aspose.Words และแปลง Word เป็น LaTeX เรียนรู้วิธีส่งออกสมการ + รักษาข้อความธรรมดา และรับโค้ด LaTeX ภายในไม่กี่นาที. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: th +og_description: บันทึกไฟล์ docx เป็น txt ด้วย Aspose.Words. คู่มือนี้แสดงวิธีแปลง + Word เป็น LaTeX ส่งออกสมการ และทำให้เอกสารของคุณเป็นข้อความธรรมดา. +og_title: บันทึก docx เป็น txt – ส่งออกสมการ Word ไปยัง LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: บันทึกไฟล์ docx เป็น txt – คู่มือเต็มสำหรับการส่งออกสมการ Word ไปยัง LaTeX +url: /th/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# บันทึก docx เป็น txt – ส่งออกสมการ Word เป็น LaTeX + +เคยต้อง **บันทึก docx เป็น txt** แต่กังวลว่าจะเสียสมการคณิตศาสตร์ที่ซับซ้อนในไฟล์ Word หรือไม่? คุณไม่ได้อยู่คนเดียว ในหลายกระบวนการทำงานด้านวิทยาศาสตร์ การมีเวอร์ชันข้อความธรรมดาของเอกสารเป็นสิ่งจำเป็น แต่คุณก็ยังต้องการให้สมการคงอยู่ในรูปแบบ LaTeX ที่สะอาดตา + +ในบทเรียนนี้เราจะพาคุณผ่านขั้นตอนที่แน่นอนเพื่อ **แปลง Word เป็น LaTeX** ด้วย Aspose.Words for .NET เพื่อให้สมการของคุณถูกส่งออกอย่างถูกต้อง ส่วนที่เหลือของเอกสารก็จะกลายเป็นข้อความธรรมดาที่เรียบร้อย เมื่อจบคุณจะรู้วิธี **ส่งออกสมการเป็น LaTeX** เก็บไฟล์ส่วนที่เหลือเป็นข้อความง่าย ๆ และหลีกเลี่ยงข้อผิดพลาดทั่วไปที่มักทำให้ผู้เริ่มต้นเจอ + +## สิ่งที่คุณจะได้เรียนรู้ + +- วิธีโหลดไฟล์ *.docx* ที่มี Office Math อยู่ +- การตั้งค่า `TxtSaveOptions` ให้ Aspose ส่งออก LaTeX สำหรับทุกสมการ +- การบันทึกผลลัพธ์เป็นไฟล์ **save word plain text** ที่คุณสามารถนำไปใช้ในระบบควบคุมเวอร์ชัน, pipeline CI, หรือเครื่องมืออื่น ๆ ต่อไป +- กรณีขอบเขตทั่วไป—วิธีจัดการเมื่อเอกสารผสมรูปภาพและสมการ, หรือเมื่อคุณต้องการรักษาอักขระ Unicode ไว้ +- ตัวอย่างโค้ดที่พร้อมรันเต็มรูปแบบที่คุณสามารถคัดลอกไปใส่ในแอปคอนโซลได้ทันที + +### ข้อกำหนดเบื้องต้น + +- .NET 6.0 หรือใหม่กว่า (โค้ดนี้ยังทำงานกับ .NET Framework 4.7+ ด้วย) +- สำเนาไลเซนส์ของ **Aspose.Words for .NET** (คุณสามารถใช้เวอร์ชันทดลองฟรีสำหรับการทดสอบ) +- Visual Studio 2022 หรือ IDE ใด ๆ ที่สามารถคอมไพล์โปรเจกต์ C# ได้ +- เอกสาร Word (`input.docx`) ที่มี Office Math อยู่แล้ว + +> **เคล็ดลับระดับมืออาชีพ:** หากคุณยังไม่มีไลเซนส์ คุณสามารถขอคีย์ชั่วคราวจากเว็บไซต์ของ Aspose — เพียงแทนที่ค่า placeholder ในโค้ดด้วยคีย์ของคุณก่อนรัน + +## ขั้นตอนที่ 1 – ติดตั้ง Aspose.Words ผ่าน NuGet + +อันดับแรกคุณต้องมีไลบรารีในโปรเจกต์ของคุณ เปิด **Package Manager Console** แล้วรัน: + +```powershell +Install-Package Aspose.Words +``` + +บรรทัดเดียวนี้จะดึงทุกอย่างที่คุณต้องการ รวมถึง namespace `Saving` ที่มี `TxtSaveOptions` อยู่ ไม่ต้องเพิ่ม DLL เพิ่มเติม ไม่ต้องพึ่งพา native dependencies — เพียงแค่โค้ดที่จัดการโดย .NET เท่านั้น + +## ขั้นตอนที่ 2 – โหลดเอกสาร Word ต้นฉบับ + +ต่อไปเราจะอ่านไฟล์ที่บรรจุสมการ `Document` class จะทำหน้าที่เป็นตัวแทนของโครงสร้าง *.docx* ทั้งหมด ทำให้คุณสามารถจัดการมันในระดับออบเจกต์โมเดลระดับสูงได้ + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**ทำไมจึงสำคัญ:** การโหลดเอกสารตั้งแต่ต้นทำให้คุณสามารถตรวจสอบโครงสร้าง node tree ของมันได้ หากคุณข้ามขั้นตอนนี้และไฟล์ไม่มีสมการ คุณก็จะได้ไฟล์ txt ที่สะอาด แต่คุณจะไม่รู้ว่าทำไมผลลัพธ์ LaTeX ถึงว่างเปล่า + +## ขั้นตอนที่ 3 – ตั้งค่า TxtSaveOptions สำหรับการส่งออก LaTeX + +Aspose ให้การควบคุมระดับละเอียดว่าควรเรนเดอร์ Office Math อย่างไร โดยการตั้งค่า `OfficeMathExportMode` เป็น `LaTeX` ทุกสมการจะถูกแปลงเป็นรูปแบบ LaTeX แทนที่จะถูกตัดออกหรือแปลงเป็นรูปภาพ + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**ทำไมจึงสำคัญ:** โหมดการส่งออกเริ่มต้นจะตัดสมการออกทั้งหมด การสลับเป็น `LaTeX` จะรักษาความหมายทางคณิตศาสตร์ไว้ ซึ่งเป็นสิ่งที่คุณต้องการเมื่อจะนำไฟล์ไปประมวลผลต่อด้วยคอมไพเลอร์ LaTeX หรือ markdown processor ที่เข้าใจไวยากรณ์ `$…$` + +## ขั้นตอนที่ 4 – บันทึกเอกสารเป็นข้อความธรรมดา + +เมื่อกำหนดตัวเลือกแล้ว การบันทึกไฟล์ก็เป็นบรรทัดเดียว ผลลัพธ์จะเป็นไฟล์ `.txt` ที่ทุกสมการปรากฏเป็นโค้ด LaTeX อยู่ในเครื่องหมาย `$` (คุณสามารถเปลี่ยนเป็นบล็อก `\[` … `\]` ได้ในภายหลังหากต้องการ) + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### ผลลัพธ์ที่คาดหวัง + +เปิด `output.txt` ด้วยโปรแกรมแก้ไขใดก็ได้ คุณจะเห็นประมาณนี้: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +สังเกตว่าข้อความทั่วไปยังคงอยู่เหมือนเดิม ส่วนสมการกลายเป็นสตริง LaTeX บริสุทธิ์ คุณสามารถคัดลอก‑วางเหล่านี้ไปยังเอกสาร LaTeX, Jupyter notebook, หรือเครื่องมือใด ๆ ที่รองรับการแสดงผลคณิตศาสตร์ได้ทันที + +## ขั้นตอนที่ 5 – จัดการกรณีขอบเขต + +### เนื้อหาผสม (รูปภาพ + สมการ) + +หากไฟล์ Word ของคุณมีรูปภาพด้วย Aspose จะละเลยรูปภาพเมื่อใช้ `TxtSaveOptions` ซึ่งโดยทั่วไปก็พอสำหรับ workflow **save word plain text** แต่หากคุณต้องการให้รูปภาพเป็น placeholder สามารถทำได้โดย: + +1. ส่งออกเอกสารเป็น HTML ก่อน (`HtmlSaveOptions`) เพื่อจับรูปภาพเป็นแท็ก `` +2. รัน pass ที่สองด้วย `TxtSaveOptions` เพื่อดึงสมการ LaTeX +3. ผสานผลลัพธ์สองส่วนด้วยตนเองหรือใช้สคริปต์เล็ก ๆ + +### สัญลักษณ์ Unicode + +สมการบางสมการใช้อักขระ Unicode พิเศษ (เช่น ตัวอักษรกรีก) การตั้งค่า `Encoding = Encoding.UTF8` ใน `TxtSaveOptions` (ตามที่แสดงในขั้นตอน 3) จะทำให้สัญลักษณ์เหล่านั้นคงอยู่หลังการแปลง + +### เอกสารขนาดใหญ่ + +สำหรับไฟล์ขนาดใหญ่ (> 100 MB) ควรพิจารณาใช้การสตรีมการบันทึก: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +การสตรีมช่วยหลีกเลี่ยงการโหลดผลลัพธ์ทั้งหมดเข้าสู่หน่วยความจำ ซึ่งเป็นการช่วยชีวิตบนเอเจนต์ที่มีหน่วยความจำจำกัด + +## ตัวอย่างทำงานเต็มรูปแบบ + +ด้านล่างเป็นโปรแกรมที่พร้อมคัดลอก‑วางครบชุด ซึ่งเชื่อมทุกขั้นตอนเข้าด้วยกัน เพียงเปลี่ยนเส้นทางไฟล์และหากมีไลเซนส์ก็เพิ่มบรรทัดไลเซนส์เข้าไป + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +รันโปรแกรม (`dotnet run` หากคุณใช้โปรเจกต์คอนโซล) แล้วตรวจสอบ `output.txt` คุณเพิ่ง **บันทึก docx เป็น txt** พร้อมคงสมการทุกสมการเป็น LaTeX — ไม่ต้องคัดลอก‑วางด้วยตนเอง + +## คำถามที่พบบ่อย + +**ถาม: ฉันสามารถเปลี่ยน delimiter จาก `$…$` เป็น `\(...\)` ได้หรือไม่?** +ตอบ: ได้ หลังจากบันทึก ให้ทำการแทนที่ง่าย ๆ ในไฟล์: `output = output.Replace("$", @"\(").Replace("$", @"\)");` — ระวังอย่าแทนที่ `$` ที่เป็นส่วนของข้อความต้นฉบับ + +**ถาม: วิธีนี้ทำงานกับไฟล์ Word 2007‑2019 หรือไม่?** +ตอบ: ทำได้แน่นอน Aspose.Words รองรับ `.doc`, `.docx`, `.docm` และแม้กระทั่งตระกูล `.dotx` เวอร์ชันใหม่ ๆ โค้ดเดียวกันทำงานได้กับทุกเวอร์ชัน + +**ถาม: ถ้าต้องการรักษาการจัดรูปแบบย่อหน้าเดิม (แท็บ, ช่องว่างหลายช่อง) จะทำอย่างไร?** +ตอบ: ตั้งค่า `txtSaveOptions.PreserveTableLayout = true;` และ `txtSaveOptions.PreserveSpace = true;` เพื่อคง whitespace ไว้ครบถ้วน + +## สรุป + +เราครอบคลุมทุกอย่างที่คุณต้องการเพื่อ **บันทึก docx เป็น txt** พร้อม **ส่งออกสมการเป็น LaTeX** ด้วย Aspose.Words ขั้นตอนสำคัญคือการโหลดเอกสาร, ตั้งค่า `TxtSaveOptions` ด้วย `OfficeMathExportMode.LaTeX`, แล้วบันทึกผลลัพธ์ ด้วยสามบรรทัดโค้ดนี้คุณสามารถ **แปลง word เป็น latex** อย่างเชื่อถือได้, เก็บเอกสารเป็น **save word plain text**, และหลีกเลี่ยงการสูญเสียสัญลักษณ์คณิตศาสตร์ + +พร้อมรับความท้าทายต่อไปหรือยัง? ลองเชื่อม workflow นี้กับเครื่องมือสร้าง markdown เพื่อผลิตไฟล์ `.md` ที่รวมข้อความและ LaTeX ทั้งหมด — เหมาะสำหรับเอกสารที่เก็บบน Git หรือ static‑site generator หรือสำรวจ `PdfSaveOptions` ของ Aspose เพื่อให้ได้ไฟล์ PDF ควบคู่กับไฟล์ข้อความธรรมดา + +หากคุณเจออุปสรรคใด ๆ แสดงความคิดเห็นด้านล่างได้เลย ขอให้สนุกกับการเขียนโค้ดและเพลิดเพลินกับการแปลงสมการ Word เป็น LaTeX ที่สะอาดตา! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/thai/net/working-with-fonts/_index.md b/words/thai/net/working-with-fonts/_index.md index b32fe4c65b..74722912dd 100644 --- a/words/thai/net/working-with-fonts/_index.md +++ b/words/thai/net/working-with-fonts/_index.md @@ -47,8 +47,8 @@ | [รับการแจ้งเตือนแบบอักษร](./receive-notifications-of-fonts/) | เรียนรู้วิธีรับการแจ้งเตือนแบบอักษรที่ขาดหายหรือถูกแทนที่เมื่อใช้ Aspose.Words สำหรับ .NET - | [รับการแจ้งเตือน](./receive-warning-notification/) เรียนรู้วิธีรับการแจ้งเตือนเมื่อใช้ Aspose.Words สำหรับ .NET และจัดการปัญหาหรือคำเตือนต่างๆ ในเอกสารของคุณ - | [ตัวอย่างแหล่งที่มาของฟอนต์ Steam](./resource-steam-font-source-example/) | เรียนรู้วิธีใช้ Resource Stream Font Source เพื่อโหลดแบบอักษรที่กำหนดเองลงใน Aspose.Words สำหรับ .NET - -| [รับการทดแทนโดยไม่ต้องมีคำต่อท้าย](./get-substitution-without-suffixes/) | ในบทช่วยสอนนี้ เรียนรู้วิธีรับการแทนที่แบบไม่มีคำต่อท้ายในเอกสาร Word ด้วย Aspose.Words สำหรับ .NET | - +| [รับการทดแทนโดยไม่ต้องมีคำต่อท้าย](./get-substitution-without-suffixes/) | ในบทช่วยสอนนี้ เรียนรู้วิธีรับการแทนที่แบบไม่มีคำต่อท้ายในเอกสาร Word ด้วย Aspose.Words สำหรับ .NET - +- [การทดแทนฟอนต์ Aspose – วิธีกำหนดค่าการตั้งค่าแบบอักษรใน C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | เรียนรู้วิธีกำหนดค่าการทดแทนฟอนต์และการตั้งค่าแบบอักษรใน Aspose.Words สำหรับ .NET ด้วย C# - {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/thai/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/thai/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..b7edcf757a --- /dev/null +++ b/words/thai/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose Font Substitution ง่ายดาย: เรียนรู้การตั้งค่าฟอนต์, จับคำเตือน, + และจัดการฟอนต์ที่หายไปในแอป .NET ของคุณ.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: th +og_description: เชี่ยวชาญการแทนที่ฟอนต์ของ Aspose ด้วยการกำหนดค่าฟอนต์และจัดการฟอนต์ที่หายไปด้วยการแจ้งเตือนแบบคอลแบ็ก + คู่มือ C# ฉบับสมบูรณ์. +og_title: การแทนที่ฟอนต์ของ Aspose – กำหนดค่าการตั้งค่าฟอนต์ใน C# +tags: +- Aspose.Words +- C# +- Font Management +title: การแทนที่ฟอนต์ของ Aspose – วิธีตั้งค่าฟอนต์ใน C# +url: /th/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – คู่มือเต็มสำหรับการกำหนดค่า Font Settings + +เคยเจอเอกสารที่ทันใดนั้นสลับฟอนต์ที่คุณกำหนดเองเป็นฟอนต์ทั่วไปหรือไม่? นั่นคือ **aspose font substitution** ทำหน้าที่ของมัน—แทนที่ฟอนต์ที่หายไปด้วยฟอนต์ที่ใกล้เคียงที่สุดที่มันหาได้ มันสะดวก แต่ถ้าคุณต้องการรู้ *อย่างแม่นยำ* ว่าฟอนต์ใดถูกสลับ คุณต้องเข้าถึงระบบคำเตือนของไลบรารีและกำหนดค่า font settings ด้วยตนเอง + +ในบทแนะนำนี้เราจะเดินผ่านสถานการณ์จริง: โหลดไฟล์ DOCX ที่อ้างอิงฟอนต์ที่คุณไม่มี, จับเหตุการณ์การสลับฟอนต์, และพิมพ์ข้อความที่เป็นมิตรไปยังคอนโซล. เมื่อจบคุณจะคุ้นเคยกับ **configure font settings**, การเชื่อมต่อ **Aspose.Words warning callback**, และการขยายตัวอย่างให้เข้ากับกระบวนการทำงานใด ๆ + +> **สิ่งที่คุณต้องมี** +> • .NET 6+ (หรือ .NET Framework 4.7.2+) +> • Aspose.Words for .NET (เวอร์ชันล่าสุดจาก NuGet) +> • DOCX ที่อ้างอิงฟอนต์ที่หายไป (เราจะเรียกมันว่า `MissingFont.docx`) + +มาเริ่มกันเลย + +--- + +## Step 1: Install Aspose.Words and Prepare the Project + +ก่อนที่เราจะเขียนโค้ดใด ๆ ตรวจสอบให้แน่ใจว่าได้อ้างอิงแพคเกจ Aspose.Words แล้ว: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro tip:** ใช้เวอร์ชันเสถียรล่าสุด; ณ เดือนมีนาคม 2026 คือ 23.11.0. เวอร์ชันใหม่ ๆ ปรับปรุงอัลกอริทึมการจับคู่ฟอนต์และเพิ่มประเภทคำเตือนเพิ่มเติม + +สร้างแอปคอนโซลใหม่ (หรือวางโค้ดลงในโปรเจกต์ที่มีอยู่) แล้วเพิ่ม `using` directives ตามปกติ: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +เนมสเปซเหล่านี้ให้เราเข้าถึง `Document`, `LoadOptions`, และคลาสที่เกี่ยวกับฟอนต์ที่เราต้องการใช้ + +--- + +## Step 2: Configure Font Settings with LoadOptions + +หัวใจของการควบคุม **aspose font substitution** อยู่ที่ `LoadOptions.FontSettings`. การส่งออบเจกต์ `FontSettings` ว่าง ๆ ให้ Aspose ใช้เส้นทางค้นหาเริ่มต้น *และ* รายงานการสลับใด ๆ ผ่าน callback คำเตือน + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +ทำไมไม่ใช้ค่าเริ่มต้นเลย? เพราะการแนบ callback คำเตือน (ขั้นตอนต่อไป) จะทำงานได้เฉพาะเมื่อคุณสมบัติ `FontSettings` ไม่เป็น null. บรรทัดเล็ก ๆ นี้ให้จุดเชื่อมต่อเข้าสู่กระบวนการสลับโดยไม่เปลี่ยนแปลงพฤติกรรมการค้นหาฟอนต์จริง ๆ + +--- + +## Step 3: Attach a Warning Callback to Capture Substitutions + +Aspose.Words ใช้ interface `IWarningCallback`. ทุกครั้งที่มีเหตุการณ์สำคัญ—เช่นฟอนต์หาย—มันจะเรียกเมธอด `Warning` ของเรา. เราจะสร้าง handler เล็ก ๆ ที่กรอง `WarningType.FontSubstitution` แล้วพิมพ์คำอธิบาย + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +และนี่คือ handler เอง: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **ทำไมเรื่องนี้ถึงสำคัญ** – หากไม่มี callback, Aspose จะสลับฟอนต์โดยเงียบ ๆ ทำให้คุณไม่รู้ว่าฟอนต์ใดถูกใช้. Callback ทำให้กระบวนการโปร่งใส ซึ่งจำเป็นสำหรับการรายงานการปฏิบัติตามหรือการดีบักปัญหาเลย์เอาต์ + +--- + +## Step 4: Load the Document Using the Configured Options + +ตอนนี้เราจะโหลดเอกสารโดยส่ง `loadOptions` ที่เตรียมไว้. หากไฟล์ต้นทางอ้างอิงฟอนต์ที่ไม่ได้ติดตั้ง, handler ของเราจะทำงาน + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +แทนที่ `YOUR_DIRECTORY` ด้วยพาธจริงที่เก็บ `MissingFont.docx`. เมื่อรันโปรแกรม คุณควรเห็นผลลัพธ์คล้ายกับ: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +บรรทัดนั้นบอกคุณอย่างชัดเจนว่าฟอนต์ใดหายไปและฟอนต์สำรองที่ Aspose เลือกใช้คืออะไร + +--- + +## Step 5: (Optional) Fine‑Tune Font Search Paths + +หากคุณมีโฟลเดอร์ส่วนตัวที่เก็บฟอนต์ขององค์กร, คุณสามารถบอก Aspose ให้ค้นหาที่นั่นก่อนที่จะย้อนกลับไปใช้ฟอนต์ระบบ. นี่คือการใช้ **configure font settings** ขั้นสูง: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +การตั้งค่า `recursive: true` ทำให้ Aspose สแกนโฟลเดอร์ย่อยด้วย. ตอนนี้ไลบรารีจะลองใช้ฟอนต์ส่วนตัวของคุณก่อน ลดโอกาสการสลับฟอนต์ที่ไม่ต้องการ + +--- + +## Full Working Example + +รวมทุกอย่างเข้าด้วยกัน นี่คือตัวอย่างโปรแกรมที่พร้อมรัน: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**ผลลัพธ์ที่คาดหวัง** (เมื่อพบฟอนต์ที่หายไป): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +หากฟอนต์ทั้งหมดมีอยู่ โปรแกรมจะทำงานแบบเงียบ (ไม่มีคำเตือน) และยังคงสร้าง PDF ได้ตามปกติ + +--- + +## Common Questions & Edge Cases + +### What if I need to *prevent* substitution altogether? + +ตั้งค่า `FontSettings.SubstitutionSettings` เป็น `null` หรือใช้ `FontSettings.FontSubstitutionSettings` เพื่อควบคุมพฤติกรรม. ตัวอย่าง: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +ตอนนี้ Aspose จะโยนข้อยกเว้นแทนการสลับโดยเงียบ ๆ ซึ่งคุณสามารถจับและจัดการได้ + +### Does this work with other file formats (e.g., .doc, .rtf)? + +แน่นอน. ออบเจกต์ `LoadOptions` เดียวกันสามารถส่งให้คอนสตรัคเตอร์ `Document` ใด ๆ ที่รับพาธไฟล์ได้. Callback คำเตือนจะทำงานสำหรับทุกฟอร์แมตที่พึ่งพาฟอนต์ + +### Can I capture the *exact* fallback font name? + +ได้. สตริง `info.Description` มีทั้งฟอนต์ที่หายและฟอนต์สำรอง. หากต้องการชื่อแบบโปรแกรมเมติก, คุณสามารถพาร์สสตริงนั้นหรือใช้ `FontInfo` (พร้อมในเวอร์ชันใหม่) + +### How does this behave in a multi‑threaded environment? + +`FontSettings` **ไม่**เป็น thread‑safe. สร้าง `LoadOptions` (พร้อม `FontSettings` ของมัน) แยกสำหรับแต่ละเธรด, หรือปกป้องการเข้าถึงด้วย lock + +--- + +## Conclusion + +เราได้ครอบคลุมทุกอย่างที่คุณต้องการเพื่อเชี่ยวชาญ **aspose font substitution** และ **configure font settings** ในแอป C#: + +1. ติดตั้ง Aspose.Words และเพิ่ม `using` ที่จำเป็น +2. สร้างออบเจกต์ `LoadOptions` พร้อม `FontSettings` ใหม่ +3. แนบ `IWarningCallback` ที่กำหนดเองเพื่อแสดงเหตุการณ์สลับฟอนต์ +4. โหลดเอกสารและให้ callback รายงานฟอนต์ที่หายไป +5. (เลือก) ขยายเส้นทางค้นหาหรือปิดการสลับฟอนต์ทั้งหมด + +ด้วยรูปแบบนี้คุณสามารถบันทึกฟอนต์ที่หายไปเพื่อการปฏิบัติตาม, แจ้งผู้ใช้ใน UI, หรือฝังฟอนต์สำรองโดยอัตโนมัติก่อนเผยแพร่. ขั้นต่อไปอาจเป็นการสำรวจ **Aspose.Words font substitution policies** หรือผสานกระบวนการนี้เข้าสู่ pipeline การประมวลผลเอกสารขนาดใหญ่ + +Happy coding, and may your documents always render with the right typeface! + +--- + +![Diagram showing Aspose.Words loading a document, invoking FontSettings, triggering a warning callback, and outputting substitution info](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/net/basic-conversions/_index.md b/words/turkish/net/basic-conversions/_index.md index e9f5c4eebc..782944200c 100644 --- a/words/turkish/net/basic-conversions/_index.md +++ b/words/turkish/net/basic-conversions/_index.md @@ -26,6 +26,7 @@ Basic Conversions, Aspose.Words for .NET kitaplığını kullanarak temel belge | [Word Dosyasını PDF'ye Dönüştür](./docx-to-pdf/) Aspose.Words for .NET rehberimizle Word dosyalarını PDF'ye nasıl kolayca dönüştürebileceğinizi öğrenin. Hızlı ve güvenilir belge dönüşümü arayan geliştiriciler için mükemmeldir. | | [Word'ü PDF olarak kaydet – Aspose.Words Tam C# Rehberi](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Aspose.Words for .NET kullanarak C# ile Word belgelerini PDF'ye dönüştürmenin adım adım rehberi. | | [C# ile Word'ü PDF'ye Dönüştür – Aspose.Words Rehberi](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Aspose.Words for .NET ile C# kullanarak Word belgelerini PDF'ye nasıl dönüştüreceğinizi adım adım öğrenin. | +| [Aspose.Words ile Word'ü PDF'ye Dönüştür – Tam Kılavuz](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Aspose.Words for .NET kullanarak C# ile Word belgelerini PDF'ye dönüştürmenin adım adım tam rehberi. | | [Docx'i Bayta Dönüştür](./docx-to-byte/) | Verimli belge işleme için Aspose.Words kullanarak .NET'te Docx'i bayt dizisine nasıl dönüştüreceğinizi öğrenin. Adım adım kılavuz dahildir. | | [Docx'i Epub'a Dönüştür](./docx-to-epub/) | DOCX'i Aspose.Words for .NET ile kolayca EPUB'a dönüştürün. .NET uygulamalarınıza kusursuz entegrasyon için eğitimimizi takip edin. | | [Docx'i Mhtml'e Dönüştürme ve E-posta Gönderme](./docx-to-mhtml-and-sending-email/) | Bu adım adım kılavuzda DOCX'i MHTML'e nasıl dönüştüreceğinizi ve Aspose.Words for .NET kullanarak e-postaları nasıl göndereceğinizi öğrenin. Kolay otomasyonla üretkenliğinizi artırın. | diff --git a/words/turkish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/turkish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..4cde4a5385 --- /dev/null +++ b/words/turkish/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words kullanarak Word'ü hızlıca PDF'ye dönüştürün. Word'ü PDF + olarak kaydetmeyi, docx'i PDF'ye dışa aktarmayı ve C#'ta erişilebilir PDF oluşturmayı + öğrenin. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: tr +og_description: Aspose.Words kullanarak C#'ta Word'ü PDF'ye dönüştürün. Bu kılavuz, + Word'ü PDF olarak kaydetmeyi, docx'i PDF'ye dışa aktarmayı ve erişilebilir PDF oluşturmayı + gösterir. +og_title: Aspose.Words ile Word'ü PDF'ye Dönüştür – Adım Adım +tags: +- Aspose.Words +- C# +- PDF conversion +title: Aspose.Words ile Word'ü PDF'ye Dönüştürme – Tam Kılavuz +url: /tr/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose.Words ile Word'ü PDF'e Dönüştürme – Tam Kılavuz + +Üçüncü taraf web araçlarıyla uğraşmadan **Word'ü PDF'e dönüştürmeyi** hiç merak ettiniz mi? Belki otomatik bir rapor motoru oluşturuyorsunuz ve anında *word'ü pdf olarak kaydetmek* için güvenilir bir yol gerekiyor. İyi haber şu ki Aspose.Words tüm süreci çocuk oyuncağı haline getiriyor ve hatta **PDF/UA‑2** uyumlu bir dosya üretebiliyorsunuz—erişilebilirlik gereksinimleri için mükemmel. + +Bu öğreticide ihtiyacınız olan her şeyi adım adım göstereceğiz: bir `.docx` dosyasını yükleme, PDF/UA uyumluluğu ile *docx'i pdf'e dışa aktarmanız* için PDF seçeneklerini yapılandırma ve sonunda sonucu erişilebilir bir PDF olarak kaydetme. Sonunda, herhangi bir .NET projesine ekleyebileceğiniz, kendi içinde çalışan, üretim‑hazır bir kod parçacığına sahip olacaksınız. + +![Aspose.Words kullanarak Word'ü PDF'e Dönüştürme](convert-word-to-pdf.png) + +## Öğrenecekleriniz + +- **Aspose.Words**'in *erişilebilir pdf üretme* senaryoları için sağlam bir tercih olmasının nedeni. +- PDF/UA‑2 uyumluluğu ile *belgeyi pdf olarak kaydetmek* için kesin adımlar. +- Eksik fontlar veya şifre korumalı kaynak dosyalar gibi yaygın kenar durumlarını nasıl ele alacağınız. +- Çıktıyı hata ayıklamak ve erişilebilirlik uyumluluğunu doğrulamak için hızlı ipuçları. + +### Önkoşullar + +- .NET 6 veya daha yeni (API .NET Framework 4.6+ üzerinde de çalışır). +- Geçerli bir Aspose.Words for .NET lisansı (ücretsiz deneme değerlendirme için çalışır). +- Temel C# bilgisi—karmaşık desenler gerekmez. + +Bu maddeleri işaretlediyseniz, başlayalım. + +--- + +## Word'ü PDF'e Dönüştürme – Adım‑Adım Uygulama + +Çözümü beş net adıma böleceğiz. Her adım bir başlık, kısa bir kod alıntısı ve kodun *neden* önemli olduğuna dair bir açıklama içerir. + +### Adım 1: Dönüştürmek İstediğiniz Word Belgesini Yükleyin + +İhtiyacınız olan ilk şey, kaynak dosyayı temsil eden bir `Document` nesnesidir. Aspose.Words **.docx**, **.doc**, **.rtf** ve birçok diğer formatı okuyabilir, böylece dosya nasıl oluşturulmuş olursa olsun *word'ü pdf olarak kaydedebilirsiniz*. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Neden Önemli:** +- Dosyayı erken yüklemek, CPU döngülerini boşa harcamadan eksik dosya hatalarını yakalamanızı sağlar. +- `Document` sınıfı, bir Word dosyasının iç yapısını soyutlayarak, üzerinde çalışabileceğiniz temiz bir nesne modeli sunar. + +### Adım 2: Erişilebilirlik İçin PDF Kaydetme Seçeneklerini Yapılandırın + +Eğer *erişilebilir pdf* dosyaları üretmeniz gerekiyorsa, Aspose.Words'a PDF/UA‑2 uyumlu bir belge oluşturmasını söylemelisiniz. `PdfSaveOptions` sınıfı, çıktıyı ince ayarlarla kontrol etmenizi sağlar. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Neden Önemli:** +- `PdfCompliance.PdfUa2`, kütüphaneye ekran okuyucuların ihtiyaç duyduğu gerekli etiketleri, yapı bilgilerini ve meta verileri eklemesini söyler. +- Fontları gömmek (`EmbedFullFonts = true`) PDF farklı bir işletim sisteminde açıldığında ortaya çıkan korkutucu “font bulunamadı” uyarılarını önler. +- `Title` ayarlamak, yardımcı teknolojilerin belgeyi doğru şekilde duyurmasına yardımcı olur. + +### Adım 3: Belgeyi PDF Olarak Kaydedin + +Kaynak yüklendi ve seçenekler ayarlandığına göre, gerçek dönüşüm tek satırda yapılır. İşte *docx'i pdf'e dışa aktardığınız* yer. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Neden Önemli:** +- `Save` yöntemi, yapılandırdığımız `PdfSaveOptions`'ı dikkate alır ve erişilebilirlik özelliklerinin dahil edilmesini garanti eder. +- Çağrıyı bir `try/catch` bloğuna sarmak, yeni başlayanların sıkça karşılaştığı lisans veya izin hatalarını kaydetme veya gösterme fırsatı verir. + +### Adım 4: PDF/UA Uyumluluğunu Doğrulayın (Opsiyonel ama Tavsiye Edilir) + +Aspose.Words ağır işi yapsa da, çıktıyı iki kez kontrol etmek iyi bir uygulamadır, özellikle belgeleri devlet kurumlarına veya diğer düzenlenmiş kuruluşlara teslim ediyorsanız. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Neden Önemli:** +- `IsTagged`, hızlı bir mantık kontrolüdür; tam PDF/UA doğrulaması özel bir doğrulayıcı gerektirir, ancak çoğu uyumluluk sorunu eksik etiketler olarak ortaya çıkar. +- Eğer bayrak `false` dönerse, `PdfSaveOptions`'ı yeniden gözden geçirebilirsiniz—belki `Compliance` ayarlamayı unuttunuz ya da kaynak belge uygun başlık stillerine sahip değildi. + +### Adım 5: Yaygın Tuzaklar ve Uzman İpuçları + +| Sorun | Ne Olur | Nasıl Düzeltilir | +|---------|--------------|------------| +| **Missing fonts** | Metin PDF'te kutucuklar olarak görünür. | `EmbedFullFonts = true` olarak ayarlayın **veya** eksik fontları sunucuya kurun. | +| **Unlicensed library** | Aspose her sayfaya bir filigran ekler. | Uygulamanın başında lisans dosyanızı (`Aspose.Words.lic`) ekleyin (örnek: `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Password‑protected source** | `new Document(path)` sırasında `InvalidOperationException`. | `new Document(path, new LoadOptions { Password = "secret" })` aşırı yüklemesini kullanın. | +| **Large documents cause OOM** | Büyük dosyalarda bellek yetersizliği (Out‑of‑memory) hatası. | `PdfSaveOptions` içinde `MemoryOptimization` özelliğini etkinleştirin (`saveOptions.MemoryOptimization = true`). | +| **Accessibility tags missing** | PDF/UA doğrulaması başarısız olur. | Kaynak Word dosyasının uygun başlık stillerini (`Heading 1`, `Heading 2`, vb.) kullandığından emin olun—Aspose bunları otomatik olarak PDF etiketlerine eşler. | + +**Uzman ipucu:** Bir toplu işlemde çok sayıda belge dönüştürüyorsanız, tek bir `PdfSaveOptions` örneğini yeniden kullanın. Bir kez oluşturmak, tahsis yükünü azaltır ve bellek ayak izinizin düşük kalmasını sağlar. + +## Tam Çalışan Örnek (Kopyala‑Yapıştır Hazır) + +Aşağıda her şeyi bir araya getiren tam program yer alıyor. `Program.cs` olarak kaydedin, Aspose.Words ve Aspose.PDF NuGet paketlerini ekleyin ve çalıştırın. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Beklenen sonuç:** +`C:\MyFiles` içinde `output.pdf` adlı bir dosya oluşur. Adobe Acrobat'ta açtığınızda uyumluluk panelinde “PDF/A‑2b, PDF/UA‑1” gösterilir ve *word'ü pdf'e başarıyla dönüştürdüğünüz* doğrulanır. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/net/programming-with-markdownsaveoptions/_index.md b/words/turkish/net/programming-with-markdownsaveoptions/_index.md index 5be26b20dc..7c63262b40 100644 --- a/words/turkish/net/programming-with-markdownsaveoptions/_index.md +++ b/words/turkish/net/programming-with-markdownsaveoptions/_index.md @@ -32,6 +32,9 @@ Words Processing with MarkdownSaveOptions, .NET için Aspose.Words kütüphanesi | [Word'den Markdown Dışa Aktarma – Tam C# Rehberi](./how-to-export-markdown-from-word-complete-c-guide/) | Aspose.Words for .NET kullanarak Word belgelerini Markdown formatına dışa aktarmayı öğrenin. Tam C# rehberiyle adım adım ilerleyin. | | [DOCX'ten Markdown Kaydetme – Adım Adım Rehber](./how-to-save-markdown-from-docx-step-by-step-guide/) | Aspose.Words for .NET kullanarak DOCX dosyasını Markdown formatına kaydetmeyi adım adım öğrenin. | | [DOCX'ten Markdown Dışa Aktarma – Tam Rehber](./how-to-export-markdown-from-docx-complete-guide/) | Aspose.Words for .NET kullanarak DOCX dosyasını Markdown formatına dışa aktarmayı adım adım öğrenin. | +| [LaTeX'i Word'ten Dışa Aktarma – DOCX'i Markdown'a Dönüştür](./how-to-export-latex-from-word-convert-docx-to-markdown/) | Aspose.Words for .NET kullanarak Word'den LaTeX dışa aktarın ve DOCX'i Markdown formatına dönüştürün. | +| [LaTeX'i DOCX'ten Dışa Aktarma – Markdown'a Dönüştür](./how-to-export-latex-from-docx-convert-to-markdown/) | Aspose.Words for .NET kullanarak DOCX dosyasından LaTeX dışa aktarın ve Markdown formatına dönüştürün. | +| [Word'den Markdown Oluştur – Tam C# Rehberi](./create-markdown-from-word-full-c-guide/) | Aspose.Words for .NET kullanarak Word belgelerinden tam C# rehberiyle markdown oluşturmayı öğrenin. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/turkish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/turkish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..5972a756c2 --- /dev/null +++ b/words/turkish/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words C# ile Word’tan markdown oluşturun. Docx’i markdown’a dönüştürmeyi, + Word’tan resimleri çıkarmayı ve tek bir öğreticide geri çağırma (callback) kullanımını + öğrenin. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: tr +og_description: Aspose.Words kullanarak Word'den markdown oluşturun. Bu kılavuz, docx + dosyasını markdown'a dönüştürmeyi, Word'den resimleri çıkarmayı ve kaynak yönetimi + için bir geri arama kullanmayı gösterir. +og_title: Word'den markdown oluştur – Tam C# Öğreticisi +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Word'den markdown oluşturma – Tam C# Rehberi +url: /tr/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word'den Markdown Oluşturma – Tam C# Öğreticisi + +Word'den **markdown oluşturma** ihtiyacınız oldu mu ama nereden başlayacağınızı bilemediniz mi? Yalnız değilsiniz; birçok geliştirici .docx dosyasındaki içeriği bir static‑site jeneratörüne ya da bir dokümantasyon deposuna taşımaya çalışırken bu engelle karşılaşıyor. İyi haber? Aspose.Words ile **docx'i markdown'a dönüştürebilir**, orijinal dosyadan tüm görselleri çıkarabilir ve bu kaynakların tam olarak nereye yerleştirileceğini kontrol edebilirsiniz—hepsi basit bir callback ile. + +Bu rehberde, Word'den görselleri nasıl çıkaracağınızı, callback'i nasıl kullanarak depolayacağınızı ve bu yaklaşımın otomasyon hatları için neden en güvenilir yöntem olduğunu gösteren gerçek bir örnek üzerinden ilerleyeceğiz. Sonunda, temiz bir `.md` dosyası ve çıkarılmış görsellerin bulunduğu bir klasör üreten, çalıştırmaya hazır bir C# programına sahip olacaksınız. + +> **Pro ipucu:** Zaten ekran görüntüleri, diyagramlar veya logolar içeren bir Word şablonunuz varsa, bu yöntem her görsel öğeyi manuel kopyala‑yapıştır yapmadan korur. + +--- + +## Gereksinimler + +- **.NET 6+** (veya .NET Framework 4.6+). Kod, herhangi bir yeni çalışma zamanında çalışır. +- **Aspose.Words for .NET** (NuGet paketi `Aspose.Words`). Ücretsiz deneme sürümü çoğu senaryo için yeterlidir. +- **Word belgesi** (`input.docx`) – içinde metin ve en az bir görsel bulundurmalı. +- C# ve Visual Studio (veya favori IDE'niz) hakkında temel bir anlayış. + +Ek kütüphanelere gerek yok—geri kalan her şey Aspose.Words tarafından halledilir. + +--- + +## Adım 1: Projeyi Oluşturun ve Aspose.Words'i Yükleyin + +Her şeyi düzenli tutmak için yeni bir konsol projesi başlatın: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Bu adım neden önemli:** NuGet paketini yüklemek, en yeni API'ye sahip olmanızı sağlar; bu API, 22.9 sürümünde tanıtılan `MarkdownSaveOptions` sınıfını içerir. Olmasaydı, özel bir dönüştürücü yazmanız gerekirdi. + +--- + +## Adım 2: Kaynak Word Belgesini Yükleyin + +Kodun ilk satırı, dönüştürmek istediğiniz `.docx` dosyasını açar. `YOUR_DIRECTORY` ifadesini makinenizdeki gerçek yol ile değiştirin. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Ne oluyor?** `Document` dosyayı ayrıştırır, içsel bir DOM oluşturur ve her paragraf, tablo ve görsele erişim sağlar. Dosya eksikse, Aspose net bir `FileNotFoundException` fırlatır; bu hatayı yakalayarak daha nazik bir UI sunabilirsiniz. + +--- + +## Adım 3: Markdown Kaydetme Seçeneklerini Bir Kaynak‑Kaydetme Callback'i ile Yapılandırın + +İşte **callback nasıl kullanılır** sihrinin devreye girdiği yer. Callback, çıkarılan her görselin nereye kaydedileceğine karar vermenizi sağlar. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Neden callback?** Varsayılan olarak Aspose, görselleri markdown içinde base‑64 dizileri olarak gömer—sürüm kontrolü için bir kabus. Callback, dosya adları ve klasör yapısı üzerinde tam kontrol sunar. + +--- + +## Adım 4: Belgeyi Markdown Olarak Kaydedin + +Şimdi gerçek anlamda `.md` dosyasını üretiyoruz. Tüm görseller, bir sonraki adımda tanımlanan callback'e aktarılacak. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Her şey yolunda giderse, hedef klasörde `Document.md` dosyasını ve orijinal Word dosyasından çıkarılan tüm resimleri içeren `Resources` adlı bir alt klasörü bulacaksınız. + +--- + +## Adım 5: Her Çıkarılan Görseli Depolayan Callback'i Uygulayın + +Aşağıda `MyResourceSaver` sınıfının tam uygulaması yer alıyor. `Resources` dizinini (var değilse) oluşturur, her görsel için benzersiz bir dosya adı üretir ve görsel akışını diske yazar. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Argümanların açıklaması:** +> - `args.Index` – benzersizliği garantileyen sıfır‑tabanlı bir sayaç. +> - `args.FileName` – Aspose'un önerdiği orijinal dosya adı (genellikle `image001.png` gibi). +> - `args.Stream` – görsel baytlarının yazıldığı çıktı akışı. +> - `args.KeepResourceStreamOpen` – `false` olarak ayarlanır, böylece Aspose akışı otomatik olarak kapatır ve dosya‑tanıtıcı sızıntılarını önler. + +--- + +## Tam Çalışan Örnek + +Her şeyi bir araya getirerek, `Program.cs` içine kopyala‑yapıştır yapabileceğiniz tek bir dosya sunuyoruz. `YOUR_DIRECTORY` ifadesini ortamınıza uygun mutlak ya da göreli bir yol ile değiştirin. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Beklenen Çıktı + +- `YOUR_DIRECTORY/Document.md` – standart markdown görsel bağlantılarına sahip bir markdown dosyası, örn.: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – `img_0.png`, `img_1.jpg` vb. dosyalarını içerir; bu dosyalar, orijinal Word belgesinde göründükleri sıraya göre adlandırılmıştır. + +Programı çalıştırdığınızda, işlemin başarılı olduğunu belirten dostça bir onay mesajı görüntülenir. + +--- + +## Sık Sorulan Sorular (SSS) + +### Word'den görselleri kalite kaybı olmadan nasıl çıkarırım? + +Callback, ham ikili akışı doğrudan bir dosyaya yazar; böylece orijinal çözünürlük korunur. `ResourceSaving` içinde kendi görüntü‑işleme mantığınızı eklemediğiniz sürece hiçbir dönüşüm ya da sıkıştırma gerçekleşmez. + +### Çıkarma sırasında görsel formatını (örn. PNG → JPEG) değiştirebilir miyim? + +Kesinlikle. `ResourceSaving` içinde `args.FileName` veya `args.Stream`'i inceleyebilir, görseli `System.Drawing` ya da `ImageSharp` ile yükleyebilir, ardından yeniden kodlayarak kaydedebilirsiniz. Markdown bağlantı uzantısını da buna göre güncellemeyi unutmayın. + +### Markdown dosyalarının yerel klasör yerine bir CDN'ye işaret etmesini istesem ne yapmalıyım? + +Callback'i, markdown bağlantısına bir temel URL ekleyecek şekilde değiştirin. Görseli CDN'ye yükledikten sonra `args.FileName`'i tam nitelikli bir URL olarak ayarlayarak bunu başarabilirsiniz. + +### Tablolar, dipnotlar veya diğer gelişmiş Word özellikleriyle çalışır mı? + +Evet. Aspose.Words, çoğu Word yapısını markdown eşdeğerlerine dönüştürür. Tablolar markdown tablolarına, dipnotlar referans bağlantılarına ve iç içe listeler sorunsuz şekilde işlenir. Bir şey garip görünüyorsa, en son sürüm notlarını kontrol edin—Aspose dönüşüm doğruluğunu sürekli iyileştiriyor. + +### CI/CD hattında docx'i markdown'a nasıl dönüştürürüm? + +Derlenmiş `.exe` dosyasını derleme adımlarınıza ekleyin, oluşturulan `.docx` artefaktlarını işaret edin ve ortaya çıkan `.md` ve `Resources/` klasörünü static site deponuza gönderin. İşlem tamamen deterministik olduğundan otomatik ortamlarda sorunsuz çalışır. + +--- + +## Sonuç + +Aspose.Words kullanarak **Word'den markdown oluşturma** yöntemini, **docx'i markdown'a dönüştürme** iş akışını ve **Word'den görsel çıkarma** için özel bir **callback nasıl kullanılır** uygulamasını gösterdik. Sonuç, orijinal görsellerin bulunduğu bir klasörle eşleşen temiz bir markdown dosyasıdır—dokümantasyon siteleri, statik bloglar veya düz metin formatlarını tercih eden herhangi bir iş akışı için mükemmeldir. + +İleriye dönük düşünebileceğiniz adımlar: + +- **Batch processing**: bir klasördeki birden fazla `.docx` dosyasını işlemek (örnek: `Directory.GetFiles` döngüsü). +- **Custom naming schemes**: görseller için özel adlandırma (örn. orijinal başlık metnini kullanmak). +- **Post‑processing**: markdown içindeki görsel bağlantılarını CDN URL'leriyle değiştirmek. +- **Diğer Aspose dışa aktarma formatlarını** keşfetmek (HTML, PDF, EPUB vb.) çok kanallı yayıncılık için. + +Daha fazla sorunuz veya dönüştürülmesi zor bir Word dosyanız mı var? Aşağıya yorum bırakın, birlikte çözümleyelim. Mutlu kodlamalar ve Word'ü markdown'a dönüştürmenin sadeliğinin tadını çıkarın! + +--- + +![Word'ten Markdown'a dönüşüm sürecini gösteren diyagram](image.png "Word'den markdown oluşturma diyagramı") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/turkish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..a4eacc6d1c --- /dev/null +++ b/words/turkish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words kullanarak DOCX'ten LaTeX nasıl dışa aktarılır. DOCX'i Markdown'a + dönüştürmeyi, DPI ayarlamayı ve C#'ta kurtarmayı etkinleştirmeyi öğrenin. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: tr +og_description: Aspose.Words kullanarak DOCX'ten LaTeX nasıl dışa aktarılır. Bu öğreticide + adım adım Markdown'a dönüşüm, DPI kontrolü ve kurtarma modu gösterilmektedir. +og_title: DOCX'ten LaTeX Nasıl Dışa Aktarılır – Markdown'a Dönüştürme +tags: +- Aspose.Words +- C# +- Document Conversion +title: DOCX'ten LaTeX Nasıl Dışa Aktarılır – Markdown'a Dönüştürme +url: /tr/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# DOCX'ten LaTeX Nasıl Dışa Aktarılır – Markdown'a Dönüştürme + +DOCX dosyasından **LaTeX nasıl dışa aktarılır** diye hiç merak ettiniz mi, denklemlerinizin güzelliğini kaybetmeden? Tek başınıza değilsiniz. Benim deneyimime göre en büyük sorun, bu OfficeMath nesnelerini statik‑site jeneratörleri veya bilimsel bloglar için temiz, taşınabilir bir formata getirmektir. + +Bu rehberde Aspose.Words ile DOCX'i Markdown'a dönüştürmeyi adım adım gösterecek, ayrıca **DPI nasıl ayarlanır**, **kurtarma nasıl etkinleştirilir** ve sağlam bir işlem hattı için birkaç kullanışlı ipucu sunacağız. Sonunda LaTeX denklemleri, yüksek çözünürlüklü görseller ve doğru bağlantı yönetimi içeren bir Markdown dosyası üreten tek bir C# programına sahip olacaksınız. + +## Gerekenler + +- **.NET 6+** (veya .NET Framework 4.7.2 – API aynı şekilde çalışır) +- **Aspose.Words for .NET** (Mart 2026 itibarıyla en son kararlı sürüm) +- Denklemler, görseller ve bağlantılar içeren bir DOCX dosyası +- Visual Studio, VS Code veya tercih ettiğiniz herhangi bir editör + +Aspose.Words dışındaki ek NuGet paketlerine ihtiyaç yoktur, ancak deneme sürümünü kullanmıyorsanız geçerli bir lisansınız olduğundan emin olun. + +## Adım 1 – DOCX'i Katı Kurtarma Modu ile Yükle + +Dışa aktarmaya başlamadan önce kaynak belgenin gizli bir bozulma içerip içermediğini kontrol etmemiz gerekir. İşte **kurtarma nasıl etkinleştirilir** sorusunun devreye girdiği yer. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Katı kurtarma neden?** +Aspose sorunları sessizce düzeltirse, eksik paragraflar veya bozuk görsellerle karşılaşabilirsiniz – LaTeX dışa aktarırken kimsenin istemeyeceği bir durum. Hızlı bir şekilde hata alarak sorunu erken yakalar ve kaynak DOCX'i düzeltmeye ya da sorunu daha sonra kaydetmeye karar verebilirsiniz. + +### Pro ipucu +Yüklemeyi bir try/catch bloğuna sarın ve `DocumentLoadingException` kaydedin. Böylece CI işlem hattınız sorunlu dosyaları tüm derlemeyi durdurmadan işaretleyebilir. + +## Adım 2 – Markdown Dışa Aktarım Seçeneklerini Hazırla + +Belge artık bellekte güvenli bir şekilde olduğuna göre, kaydedileceği şekli yapılandırıyoruz. Bu, **LaTeX nasıl dışa aktarılır** sorusunun kalbi ve aynı zamanda gömülü görseller için **DPI nasıl ayarlanır** konusunu da kapsar. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Her seçeneğin ne yaptığı** + +| Seçenek | Sebep | Anahtar Kelimelerle İlgililik | +|--------|--------|-------------------------------| +| `OfficeMathExportMode = LaTeX` | Denklemlerden **how to export latex** sorusuna doğrudan yanıt verir. | Birincil anahtar kelime | +| `ImageResolution = 300` | Görsel kalitesini kontrol eder – **how to set dpi** sorusunun cevabı. | İkincil | +| `ResourceSavingCallback` | Gömülü dosyaları diske kaydeder, **convert docx to markdown** sırasında yaygın bir ihtiyaçtır. | İkincil | +| `EmptyParagraphExportMode` | Temiz Markdown çıktısı garantiler, gereksiz HTML etiketlerini önler. | Genel dönüşüm kalitesini artırır | +| `LinkExportMode = AsReference` | Bağlantıları okunması ve düzenlenmesi kolay hâle getirir, **convert docx to markdown** için bir başka artı. | + +## Adım 3 – Özel Bir Kaynak Kaydedici Uygula (Opsiyonel ama Kullanışlı) + +DOCX'i Markdown'a dönüştürdüğünüzde, görseller ve diğer ikili kaynakların dosya sisteminde bir yeri olmalı. Aspose, bunu `IResourceSavingCallback` ile kontrol etmenizi sağlar. Yukarıdaki snippet zaten minimal bir uygulama gösteriyor, ama şimdi adım adım inceleyelim: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Neden uğraşalım?** +Bu adımı atladığınızda Aspose görselleri base‑64 string olarak gömer ve Markdown dosyasının boyutu şişer, sürüm kontrolü zorlaşır. Kaynakları ayrı bir klasöre kaydederek Markdown dosyasını hafif tutar ve Hugo ya da Jekyll gibi statik site jeneratörleriyle uyumlu hâle getirirsiniz. + +## Adım 4 – Belgeyi Markdown Olarak Kaydet + +Tüm ağır iş bitti. Şimdi tek bir satırla son dosyayı yazdırıyoruz. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +`output.md` dosyasını açın ve şunları göreceksiniz: + +- Denklemler `$…$` LaTeX blokları olarak render edilir +- Görseller `![Alt text](resources/image001.png)` şeklinde referans edilir ve 300 dpi çözünürlüğe sahiptir +- Bağlantılar referans stiline dönüştürülür: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Bu, **how to convert docx** sürecinin tüm özeti. + +## Yaygın Sorular & Kenar Durumlar + +### 1️⃣ DOCX desteklenmeyen nesneler içeriyorsa ne olur? +Aspose.Words bir `FeatureNotSupportedException` fırlatır. Katı modda **how to enable recovery** kullandığımız için istisna anında ortaya çıkar. Şunları yapabilirsiniz: + +- En iyi çaba dönüşümü için `RecoveryMode`'u `RecoveryMode.Default`'a değiştirin, **veya** +- Dönüştürücüyü çalıştırmadan önce DOCX'i ön‑işlemden geçirin (ör. desteklenmeyen SmartArt'ı kaldırın). + +### 2️⃣ DPI'yı görsel başına değiştirebilir miyim? +`ImageResolution` ayarı geneldir. Görsel başına kontrol için `MyResourceSaver` benzeri bir `ImageSavingCallback` uygulayın ve `args.ImageResolution` değerini `args.ImageFileName` ya da meta veri üzerinden ayarlayın. + +### 3️⃣ Oluşturulan LaTeX'i bir Jekyll sitesine nasıl gömerim? +Jekyll'in yerleşik MathJax desteği kutudan çıkar çıkmaz çalışır. Sadece layout'unuza MathJax script'ini ekleyin ve LaTeX bloklarının gösterim denklemleri için `$$`, satır içi için `$` ile çevrildiğinden emin olun. + +### 4️⃣ Bu, Linux üzerindeki .NET Core ile uyumlu mu? +Kesinlikle. Aspose.Words platformlar arasıdır. Tek yapmanız gereken `YOUR_DIRECTORY` yolunun Linux kurallarına (ör. `/home/user/docs`) uygun olduğundan emin olmak. + +## Tam Çalışan Örnek + +Aşağıda kopyala‑yapıştır yapabileceğiniz bir program var. `YOUR_DIRECTORY` kısmını makinenizdeki gerçek bir yol ile değiştirin. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Beklenen çıktı** – `output.md` dosyasını açın, aşağıdakine benzer bir içerik görmelisiniz: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Dosyayı MathJax destekli bir Markdown önizleyicide açarsanız integral doğru şekilde render olur + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/turkish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..ec4ad428f2 --- /dev/null +++ b/words/turkish/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words kullanarak Word belgelerinden LaTeX nasıl dışa aktarılır + – DOCX'i denklemler LaTeX olarak Markdown'a dönüştürme. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: tr +og_description: Word belgelerinden LaTeX dışa aktarmanın nasıl yapılacağı ilk cümlede + açıklanıyor ve size DOCX'i denklemlerle LaTeX olarak Markdown'a nasıl dönüştüreceğinizi + gösteriyor. +og_title: Word'den LaTeX Nasıl Dışa Aktarılır – Tam Kılavuz +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Word'ten LaTeX Nasıl Dışa Aktarılır – DOCX'i Markdown'a Dönüştür +url: /tr/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to Export LaTeX from Word – Convert DOCX to Markdown + +Hiç **LaTeX'i Word dosyasından dışa aktarmanın** nasıl yapılacağını, bir sürü PNG ile sonuçlanmadan merak ettiniz mi? Tek başınıza değilsiniz; geliştiriciler temiz, düzenlenebilir denklemlere statik siteler ya da bilimsel bloglar için ihtiyaç duyduklarında bu engelle sık sık karşılaşıyor. İyi haber? Aspose.Words ile **Word'ü Markdown'a dönüştürebilir** ve her OfficeMath nesnesini yerel LaTeX olarak tutabilirsiniz—ek işleme gerek yok. + +Bu öğreticide **Word belgesini Markdown olarak kaydetme** ve **denklemleri LaTeX olarak dışa aktarma** sürecini adım adım göstereceğiz. Sonunda çalıştırılabilir bir C# kod parçacığı, her seçeneğin net açıklaması ve karmaşık formüller ya da karışık içerik gibi uç durumları ele almanız için ipuçları elde edeceksiniz. Harici araçlar yok, sadece tek bir NuGet paketi ve birkaç satır kod. + +## What You’ll Need + +- .NET 6+ (veya .NET Framework 4.7.2 ve üzeri) – en yeni çalışma zamanı en iyi sonucu verir. +- Visual Studio 2022 ya da C# projelerini derleyebilen herhangi bir editör. +- Aspose.Words for .NET lisansı (deneme sürümü deneyim için yeterli). +- En az bir denklem (OfficeMath) içeren bir DOCX dosyası. + +Eğer bunlara sahipseniz, harika—hadi başlayalım. + +## How to Export LaTeX from Word – Overview + +Aşağıda sürecin yüksek seviyeli bir görünümü yer alıyor: + +1. **Install** the Aspose.Words NuGet package. +2. **Load** the source `.docx` that holds your equations. +3. **Configure** `MarkdownSaveOptions` so that `OfficeMathExportMode` is set to `LaTeX`. +4. **Save** the document as a `.md` file. +5. **Verify** that the generated Markdown contains LaTeX blocks (`$$…$$`). + +Bu adımların her biri, aşağıdaki bölümlerde ayrıntılı olarak açıklanmıştır. + +![Diagram showing the flow from DOCX to Markdown with LaTeX equations](how-to-export-latex.png){alt="Word'tan LaTeX dışa aktarma diyagramı"} + +## Step 1 – Install Aspose.Words for .NET (convert word to markdown) + +İlk iş: gerçekten işi yapan kütüphaneye ihtiyacınız var. Terminalinizi (ya da Package Manager Console) açın ve şu komutu çalıştırın: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Pro tip:** Visual Studio kullanıyorsanız, proje üzerine sağ‑tıklayın → *Manage NuGet Packages* → “Aspose.Words” aratın ve en son stabil sürümü kurun. + +Neden önemli? Aspose.Words, Open XML formatını soyutlayarak Word belgelerini düşük seviyeli XML ile uğraşmadan temiz bir API üzerinden yönetmenizi sağlar. Ayrıca OfficeMath nesnelerini LaTeX'e dönüştürmek için yerleşik destek sunar; bu da **denklemleri LaTeX olarak dışa aktarma** gereksiniminin kalbidir. + +## Step 2 – Load the DOCX (how to convert docx) + +Paket kurulduğuna göre, dönüştürmek istediğiniz dosyayı yükleyin. `YOUR_DIRECTORY` kısmını `.docx` dosyanızın bulunduğu yol ile değiştirin: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Neden bu şekilde yüklüyor?** `Document` yapıcısı dosyanın tamamını bir nesne modeline ayrıştırır, böylece paragraflara, tablolara ve en önemlisi OfficeMath nesnelerine anında erişebilirsiniz. Dosya eksik ya da bozuksa, Aspose açıklayıcı bir `FileNotFoundException` fırlatır; bunu yakalayarak hatayı nazikçe işleyebilirsiniz. + +## Step 3 – Configure MarkdownSaveOptions (export equations as latex) + +Sihir, `MarkdownSaveOptions` nesnesinde gerçekleşir. Varsayılan olarak Aspose denklemleri PNG olarak render eder, ama biz LaTeX istiyoruz. `OfficeMathExportMode` değerini `LaTeX` olarak ayarlayın: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Opsiyonel bayraklara kısa bir not: `ExportImagesAsBase64` Aspose'un ikili veriyi gömmemesini sağlar, bu da Markdown dosyanızı temiz tutar. `ExportHeadersFooters` ise başlık ya da yazar adı gibi bağlamı kaybetmemenizi garantiler—özellikle bu bilgiler header’da bulunuyorsa faydalıdır. + +## Step 4 – Save the Document (save word as markdown) + +Son olarak, dönüştürülmüş içeriği bir `.md` dosyasına yazın: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Bu satır çalıştıktan sonra, `output.md` dosyasını kaynak dosyanızın yaninda bulacaksınız. Herhangi bir metin editörüyle açtığınızda aşağıdaki gibi LaTeX blokları görmelisiniz: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +İşte **save word as markdown** kısmı tamamlandı—ek bir dönüşüm adımına gerek yok. + +## Step 5 – Verify the Result (export equations as latex) + +Doğrulamayı göz ardı etmek kolaydır, ama basit bir kontrol ileride saatler kazandırır. Oluşturulan dosyayı okuyup ilk LaTeX bloğunu ekrana yazdıran basit bir betik çalıştırın: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Eğer `First LaTeX block: $$ … $$` çıktısını görürseniz, **LaTeX'i Word'ten dışa aktarmayı** başarıyla gerçekleştirmişsiniz demektir. Görmezseniz, kaynak belgenizin gerçekten OfficeMath nesneleri içerdiğini kontrol edin; normal metin denklemleri dönüştürülmez. + +## Handling Common Edge Cases + +| Scenario | What to Watch For | Recommended Fix | +|----------|-------------------|-----------------| +| **Mixed images & equations** | Aspose may still embed images for non‑OfficeMath graphics. | Set `ExportImagesAsBase64 = false` and keep images as external files, then reference them manually in Markdown. | +| **Complex nested equations** | Very deep nesting can produce LaTeX that needs manual tweaking. | Post‑process the block with a LaTeX formatter (e.g., `latexindent`) or adjust `mdOptions` → `ExportMathAsDisplay = true`. | +| **Large documents** | Memory usage spikes when loading huge `.docx` files. | Use `LoadOptions` with `LoadFormat.Docx` and enable `LoadOptions.LoadFormat` streaming if available. | +| **Missing license** | The free trial adds a watermark comment to the output. | Apply a valid license via `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Bu ipuçları, **convert word to markdown** işlemini üretim hatlarında bile sorunsuz yürütmenizi sağlar. + +## Full Working Example (All Steps in One File) + +Aşağıda, yeni bir .NET projesine kopyalayıp hemen çalıştırabileceğiniz, tek dosyalı bir konsol uygulaması yer alıyor. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Programı çalıştırın, `output.md` dosyasını açın ve denklemlerinizin temiz LaTeX olarak render edildiğini görün. İşte **how to export latex** sorusunun tam yanıtı. + +## Conclusion + +**How to export LaTeX from Word** konusunu adım adım ele aldık; **convert Word to markdown**, **save word as markdown** ve **export equations as LaTeX** işlemlerini Aspose.Words ile nasıl yapacağınızı gösterdik. Temel fikir basit: DOCX'i yükleyin, `MarkdownSaveOptions`'ı ayarlayın ve kütüphanenin işi halletmesine izin verin. + +Dokümantasyon hatlarını otomatikleştirmeye hazırsanız, bu kodu Hugo ya da Jekyll gibi bir static‑site generator ile zincirleyin—oluşturulan `.md` dosyalarını repoya itip sitenizin yeniden derlenmesini sağlayın. Daha fazla bilgi için Aspose'un “Export to LaTeX” rehberine göz atın, web ön izlemeleri için `HtmlSaveOptions` deneyin ya da özel dönüşümler için `DocumentVisitor` API'sini keşfedin. + +Uç durumlar, lisanslama ya da CI/CD entegrasyonu hakkında sorularınız varsa, aşağıya yorum bırakın. İyi kodlamalar! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/net/programming-with-pdfsaveoptions/_index.md b/words/turkish/net/programming-with-pdfsaveoptions/_index.md index 72073c1bf8..d725a2be6a 100644 --- a/words/turkish/net/programming-with-pdfsaveoptions/_index.md +++ b/words/turkish/net/programming-with-pdfsaveoptions/_index.md @@ -1,8 +1,8 @@ --- "description": "Aspose.Words for .NET'te PDF kaydetme seçenekleriyle Word İşlemeyi keşfedin. Adım adım eğitimler ve örnek kodlar aracılığıyla Word belgelerini gelişmiş özelliklerle PDF'ye nasıl dönüştüreceğinizi öğrenin." -"linktitle": "Pdfsaveoptions ile Kelime İşleme" +"linktitle": "Pdfsaveoptions ile Kelime İşlemeyi" "second_title": "Aspose.Words Belge İşleme API'si" -"title": "Pdfsaveoptions ile Kelime İşleme" +"title": "Pdfsaveoptions ile Kelime İşlemeyi" "url": "/tr/net/programming-with-pdfsaveoptions/" "weight": 1680 --- @@ -13,7 +13,7 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Pdfsaveoptions ile Kelime İşleme +# Pdfsaveoptions ile Kelime İşlemeyi Aspose.Words for .NET eğitimleri, PdfSaveOptions ile Words Processing'in PDF kaydetme seçenekleriyle Words Processing'in çeşitli özellikleri ve teknikleri konusunda size yol gösterir. Bu eğitimler, düzen ayarlarını, yazı tiplerini, görüntüleri, meta verileri ve daha fazlasını değiştirerek Word'den PDF'ye dönüştürmeyi nasıl özelleştireceğinizi anlamanıza yardımcı olur. @@ -24,7 +24,7 @@ Görüntü kalitesi seçeneklerini ayarlamayı, görüntüler için sıkıştır ## Eğitimler | Başlık | Açıklama | | --- | --- | -| [Belge Başlığını Pencere Başlık Çubuğunda Görüntüle](./display-doc-title-in-window-titlebar/) | Bu adım adım kılavuzla Aspose.Words for .NET'i kullanarak PDF'lerinizin pencere başlık çubuğunda belge başlığının nasıl görüntüleneceğini öğrenin. +| [Belge Başlığını Pencere Başlık Çubuğunda Görüntüle](./display-doc-title-in-window-titlebar/) | Bu adım adım kılavuzla Aspose.Words for .NET'i kullanarak PDF'lerinizin pencere başlık çubuğunda belge başlığının nasıl görüntüleneceğini öğrenin. | | [PDF Render Uyarıları](./pdf-render-warnings/) | Aspose.Words for .NET ile PDF oluşturma uyarılarıyla başa çıkma konusunda adım adım kılavuz. | | [Sertifika Sahibini kullanarak PDF'ye Dijital İmza Ekleme](./digitally-signed-pdf-using-certificate-holder/) | Aspose.Words for .NET kullanarak PDF dosyalarınızı dijital imzayla güvenceye alın. PDF'lerinize zahmetsizce dijital imza eklemek için bu adım adım kılavuzu izleyin. | | [PDF Belgesine Yazı Tiplerini Göm](./embedded-all-fonts/) | Bu ayrıntılı, adım adım kılavuzla Aspose.Words for .NET'i kullanarak PDF belgelerine zahmetsizce fontlar yerleştirin. Tüm cihazlarda tutarlı bir görünüm sağlayın. | @@ -33,26 +33,24 @@ Görüntü kalitesi seçeneklerini ayarlamayı, görüntüler için sıkıştır | [Skip Embedded Arial ve Times Roman Yazı Tipleriyle PDF Boyutunu Optimize Edin](./skip-embedded-arial-and-times-roman-fonts/) | Aspose.Words for .NET kullanarak gömülü Arial ve Times Roman yazı tiplerini atlayarak PDF boyutunu optimize edin. PDF dosyalarınızı kolaylaştırmak için bu adım adım kılavuzu izleyin. | | [Çekirdek Yazı Tiplerini Yerleştirmeyerek PDF Dosya Boyutunu Azaltın](./avoid-embedding-core-fonts/) | Aspose.Words for .NET kullanarak çekirdek yazı tiplerini gömmeyerek PDF dosya boyutunu nasıl küçülteceğinizi öğrenin. PDF'lerinizi optimize etmek için adım adım kılavuzumuzu izleyin. | | [PDF Belgesinde URI'den Kaçış](./escape-uri/) Aspose.Words for .NET kullanarak PDF'lerdeki URI'lerden nasıl kaçacağınızı öğrenin. Bu ayrıntılı kılavuz sizi adım adım süreçte yönlendirir. | -| [Word Belgesi Üstbilgi Altbilgi Yer İşaretlerini PDF Belgesine Aktar](./export-header-footer-bookmarks/) | Aspose.Words for .NET'i kullanarak adım adım kılavuzumuzla Word belgesinden üst bilgi ve alt bilgi yer imlerini PDF'ye nasıl aktaracağınızı öğrenin. +| [Word Belgesi Üstbilgi Altbilgi Yer İşaretlerini PDF Belgesine Aktar](./export-header-footer-bookmarks/) | Aspose.Words for .NET'i kullanarak adım adım kılavuzumuzla Word belgesinden üst bilgi ve alt bilgi yer imlerini PDF'ye nasıl aktaracağınızı öğrenin. | | [Scale Wmf Fonts To Metafile Boyutuyla PDF Boyutunu Küçültün](./scale-wmf-fonts-to-metafile-size/) | Aspose.Words for .NET ile PDF'ye dönüştürürken ölçek wmf yazı tiplerini meta dosyası boyutuna küçültme kılavuzu. | | [Ek Metin Konumlandırması ile PDF Metin Konumlandırmasını Geliştirin](./additional-text-positioning/) | Aspose.Words for .NET ile PDF metin konumlandırmasını birkaç kolay adımda nasıl iyileştireceğinizi öğrenin. Belgenizin görünümünü geliştirin. | | [Word Belgesini PDF'ye Dönüştürme 1.7](./conversion-to-pdf-17/) | Aspose.Words for .NET kullanarak Word belgelerini zahmetsizce PDF 1.7'ye dönüştürün. Belgelerinizin evrensel olarak erişilebilir ve profesyonelce biçimlendirilmiş olduğundan emin olmak için bu kılavuzu izleyin. | | [Görüntüleri Aşağı Örnekleme ile PDF Belge Boyutunu Azaltın](./downsampling-images/) | Aspose.Words for .NET kullanarak görüntüleri alt örnekleme yoluyla PDF belge boyutunu azaltın. PDF'lerinizi daha hızlı yükleme ve indirme süreleri için optimize edin. | | [PDF Belgesinde Anahat Seçeneklerini Ayarlama](./set-outline-options/) | Aspose.Words for .NET kullanarak bir PDF belgesinde anahat seçeneklerini nasıl ayarlayacağınızı öğrenin. Başlık düzeylerini ve genişletilmiş anahatları yapılandırarak PDF gezinmesini geliştirin. | -| [PDF Belgesinde Özel Özellikleri Dışa Aktarma](./custom-properties-export/) | Ayrıntılı, adım adım kılavuzumuzla Aspose.Words for .NET kullanarak PDF belgesinde özel özelliklerin nasıl dışa aktarılacağını öğrenin. +| [PDF Belgesinde Özel Özellikleri Dışa Aktarma](./custom-properties-export/) | Ayrıntılı, adım adım kılavuzumuzla Aspose.Words for .NET kullanarak PDF belgesinde özel özelliklerin nasıl dışa aktarılacağını öğrenin. | | [Word Belgesi Yapısını PDF Belgesine Aktar](./export-document-structure/) | Bir Word belgesinin yapısını Aspose.Words for .NET ile PDF'ye aktarın. Belge düzenini korumak ve PDF gezinmesini iyileştirmek için adım adım kılavuzumuzu izleyin. | | [PDF Belgesinde Görüntü Sıkıştırma](./image-compression/) Aspose.Words for .NET kullanarak PDF belgelerindeki resimleri nasıl sıkıştıracağınızı öğrenin. Optimize edilmiş dosya boyutu ve kalitesi için bu kılavuzu izleyin. | -| [PDF Belgesinde Son Yazdırılan Özelliği Güncelle](./update-last-printed-property/) | Aspose.Words for .NET'i kullanarak adım adım kılavuzumuzla bir PDF belgesinde son yazdırılan özelliğin nasıl güncelleneceğini öğrenin. -| [PDF Belgesinde 3D DML 3DEffects Oluşturun](./dml-3deffects-rendering/) | Bu kapsamlı adım adım kılavuzla Aspose.Words for .NET'i kullanarak PDF belgelerinde çarpıcı 3D DML efektlerinin nasıl oluşturulacağını öğrenin. +| [PDF Belgesinde Son Yazdırılan Özelliği Güncelle](./update-last-printed-property/) | Aspose.Words for .NET'i kullanarak adım adım kılavuzumuzla bir PDF belgesinde son yazdırılan özelliğin nasıl güncelleneceğini öğrenin. | +| [PDF Belgesinde 3D DML 3DEffects Oluşturun](./dml-3deffects-rendering/) | Bu kapsamlı adım adım kılavuzla Aspose.Words for .NET'i kullanarak PDF belgelerinde çarpıcı 3D DML efektlerinin nasıl oluşturulacağını öğrenin. | | [PDF Belgesindeki Görüntüleri Araya Ekleme](./interpolate-images/) | Aspose.Words for .NET'i kullanarak PDF belgesinde görüntüleri nasıl interpole edeceğinizi adım adım kılavuzumuzla öğrenin. PDF'lerinizin görüntü kalitesini kolayca iyileştirin. | - +| [Aspose.Words ile DOCX'den PDF Kaydetme – Adım Adım Kılavuz](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Aspose.Words kullanarak DOCX dosyasını PDF olarak kaydetmeyi adım adım öğrenin. | {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/turkish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..2430b0408b --- /dev/null +++ b/words/turkish/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words kullanarak bir DOCX dosyasından PDF kaydetmeyi öğrenin. + DOCX'i PDF'ye dönüştürme, PDF'yi seçeneklerle kaydetme ve yüzen şekilleri işleme + içerir. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: tr +og_description: Aspose.Words kullanarak bir DOCX dosyasından PDF nasıl kaydedilir. + Bu kılavuz, docx'i pdf'ye dönüştürmeyi, pdf'yi seçeneklerle kaydetmeyi ve yüzen + şekilleri yönetmeyi gösterir. +og_title: DOCX'ten PDF'ye Nasıl Kaydedilir – Tam Aspose.Words Öğreticisi +tags: +- Aspose.Words +- C# +- PDF conversion +title: Aspose.Words ile DOCX'ten PDF Kaydetme – Adım Adım Rehber +url: /tr/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# DOCX'ten PDF Kaydetme Aspose.Words ile – Tam Kılavuz + +Word belgesinden **PDF nasıl kaydedilir** sorusunu hiç merak ettiniz mi, özellikle yüzen şekillerin düzenini kaybetmeden? Tek başınıza değilsiniz. Birçok projede—fatura oluşturucular, rapor dışa aktarıcıları veya basit belge arşivleyicileri—geliştiriciler, DOCX'i PDF'e dönüştürürken her şeyin Word'de olduğu gibi görünmesini sağlayan güvenilir bir yol ihtiyacına sahiptir. + +Bu öğreticide bir DOCX dosyasını PDF **Aspose.Words for .NET kullanarak** nasıl dönüştüreceğimizi adım adım inceleyecek, **docx to pdf nasıl dönüştürülür** gösteren özel kaydetme seçeneklerini gösterecek ve `ExportFloatingShapesAsInlineTag` bayrağının neden önemli olduğunu açıklayacağız. Sonunda, kontrol ettiğiniz seçeneklerle PDF kaydeden, doğrudan çalıştırılabilir bir kod parçacığına sahip olacaksınız. + +## Öğrenecekleriniz + +- Aspose.Words ile **word document pdf nasıl dönüştürülür** tam adımları. +- Yüzen şekilleri satır içi etiket olarak ele almak için `PdfSaveOptions` nasıl yapılandırılır. +- Yüzen nesnelerle çalışırken sıkça karşılaşılan tuzaklar ve bunlardan nasıl kaçınılır. +- Herhangi bir .NET projesine ekleyebileceğiniz eksiksiz, çalıştırılabilir bir C# programı. + +> **Önkoşul:** Bir Aspose.Words for .NET lisansına (veya ücretsiz deneme sürümüne) ve bir .NET geliştirme ortamına (Visual Studio, Rider veya `dotnet` CLI) ihtiyacınız var. + +## Adım 1: Projeyi Oluşturun ve Aspose.Words'i Ekleyin + +İlk olarak yeni bir konsol uygulaması oluşturun (veya mevcut birine ekleyin) ve Aspose.Words NuGet paketine referans verin. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Pro ipucu:** CI sunucusunda çalışıyorsanız, paket sürümünü (`Aspose.Words --version 24.10`) sabitleyerek tekrarlanabilir derlemeler sağlayın. + +## Adım 2: Yüzen Şekiller İçeren DOCX'i Yükleyin + +Yüzen resimler, metin kutuları veya SmartArt, dönüştürme sırasında düzen kaymalarına neden olabilir. Belgeyi yüklemek basittir, ancak dosyanın varlığını kontrol ederek olası bir `FileNotFoundException` hatasını önleyeceğiz. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +`Console.WriteLine` ifadelerine dikkat edin—uygulamayı bir terminalden çalıştırdığınızda size hızlı geri bildirim verir. + +## Adım 3: PDF Kaydetme Seçeneklerini Yapılandırın (Save PDF with Options) + +İşte sihir burada gerçekleşir. Varsayılan olarak Aspose.Words, yüzen nesneleri göründükleri gibi korumaya çalışır; bu da ortaya çıkan PDF'de düzenin bozulmasına yol açabilir. `ExportFloatingShapesAsInlineTag` değerini `true` olarak ayarlamak, kütüphaneye bu şekilleri satır içi etiket olarak ele almasını söyler ve böylece şekiller çevre metne bağlı kalır. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Bu neden önemli? Bir paragrafın üzerinde süzülen bir metin kutusunu hayal edin. Satır içi‑etiket dönüşümü yapılmazsa, PDF paragrafı aşağı itebilir veya kutuyu tamamen kırpabilir. Bayrak, görsel ilişkiyi korur—profesyonel raporlar için ince ama kritik bir detay. + +## Adım 4: Belgeyi PDF Olarak Kaydedin + +Şimdi PDF dosyasını gerçekten yazıyoruz. `Save` yöntemi, hem çıktı yolunu hem de az önce ayarladığımız seçenekleri alır. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Programı çalıştırdığınızda, kaynak DOCX'inizin bulunduğu klasörde `output.pdf` oluşturulur. Herhangi bir PDF görüntüleyicide açın; yüzen şekillerin tam olarak bulundukları yerde render edildiğini görmelisiniz. + +## Tam Çalışan Örnek + +Aşağıda tüm program tek bir blokta verilmiştir. `Program.cs` dosyasına (veya herhangi bir C# dosyasına) yapıştırın ve **F5** tuşuna basın. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Beklenen Sonuç + +- **Dosya oluşturuldu:** Hedef dizinde `output.pdf`. +- **Düzen sadakati:** Yüzen şekiller (resimler, metin kutuları, SmartArt) çevre metinle satır içinde görünür. +- **İstisna yok:** Program sorunsuz şekilde sonlanır ve durum mesajlarını konsola yazar. + +## Sık Sorulan Sorular & Özel Durumlar + +| Soru | Cevap | +|----------|--------| +| **Daha yüksek görüntü kalitesine ihtiyacım olursa ne yapmalıyım?** | `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Birden fazla DOCX dosyasını toplu olarak dönüştürebilir miyim?** | Yükleme/kaydetme mantığını `foreach (var file in Directory.GetFiles(..., "*.docx"))` döngüsü içinde sarın. Performans için tek bir `PdfSaveOptions` örneğini yeniden kullanmayı unutmayın. | +| **Bu .NET Core ile çalışır mı?** | Kesinlikle. Aspose.Words 24.x, .NET Standard 2.0+ destekler; aynı kodu Windows, Linux veya macOS'ta çalıştırabilirsiniz. | +| **Şifre korumalı DOCX dosyalarıyla ne yapılmalı?** | `new Document(inputPath, new LoadOptions { Password = "mySecret" })` ile yükleyin. Kaydederken aynı `PdfSaveOptions` geçerlidir. | +| **Satır içi‑etiket dönüşümü karmaşık tablolar için güvenli mi?** | Genel olarak evet, ancak birbirine geçen şekillerle çok karmaşık tablo düzenleri hâlâ manuel ayarlama gerektirebilir. Toplu geçişten önce temsilci bir örnekle test edin. | + +## Gerçek Dünya Projeleri İçin İpuçları + +- **Loglayın, sadece `Console.WriteLine` kullanmayın** – Üretimde, hataları yakalamak için konsol çıktısını bir kayıt çerçevesi (Serilog, NLog) ile değiştirin. +- **Kaynakları serbest bırakın** – `Document` `IDisposable` uygular. Birçok dosya işliyorsanız, belleği zamanında boşaltmak için `using` bloğu içinde kullanın. +- **PDF'i doğrulayın** – Arşiv kalitesinde PDF'lere ihtiyacınız varsa bir PDF doğrulayıcı (ör. PDF/A uyumluluk denetleyicisi) kullanın. +- **Paralel işleme** – Büyük iş yüklerinde, `Parallel.ForEach` ile iş parçacığı‑güvenli `PdfSaveOptions` (her iş parçacığı için kopya) kullanarak dönüşüm hızını artırın. + +## Sonuç + +Aspose.Words kullanarak bir DOCX dosyasından **PDF nasıl kaydedilir** konusunu ele aldık, **docx to pdf nasıl dönüştürülür** özel seçeneklerle gösterdik ve `ExportFloatingShapesAsInlineTag` etkisini açıkladık. Eksiksiz, çalıştırılabilir örnek, sadece birkaç satırla **word document pdf nasıl dönüştürülür** gösteriyor ve proje kaliteniz ve uyumluluk gereksinimleriniz için **pdf with options nasıl kaydedilir** konusunda bilgi sahibi olmanızı sağlıyor. + +Bir sonraki zorluğa hazır mısınız? `document.Save("output.html")` ile diğer formatlara (HTML, EPUB vb.) dışa aktarmayı deneyin veya uzun vadeli arşivleme için PDF/A uyumluluğu üzerinde çalışın. Aynı prensipler—yükle, seçenekleri yapılandır, kaydet—her yerde geçerlidir. + +Kodlamaktan keyif alın ve PDF'leriniz her zaman istediğiniz gibi görünsün! + +![Bir DOCX dosyasının nasıl yüklendiğini, seçeneklerin nasıl uygulandığını ve bir PDF'in nasıl üretildiğini gösteren diyagram – nasıl pdf kaydedilir](https://example.com/images/how-to-save-pdf-diagram.png "pdf kaydetme diyagramı") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/net/programming-with-shapes/_index.md b/words/turkish/net/programming-with-shapes/_index.md index 7f82953262..c649f7aaf5 100644 --- a/words/turkish/net/programming-with-shapes/_index.md +++ b/words/turkish/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Aspose.Words for .NET'i kullanarak ve bu eğitimleri takip ederek, Word belgeler | [Akıllı Sanat Şeklini Algıla](./detect-smart-art-shape/) | Bu kapsamlı kılavuzla Aspose.Words for .NET kullanarak Word belgelerinde SmartArt şekillerini nasıl algılayacağınızı öğrenin. Belge iş akışınızı otomatikleştirmek için mükemmeldir. | | [Akıllı Sanat Çizimini Güncelle](./update-smart-art-drawing/) | Bu adım adım kılavuzla Aspose.Words for .NET kullanarak Word belgelerindeki Smart Art çizimlerini nasıl güncelleyeceğinizi öğrenin. Görsellerinizin her zaman doğru olduğundan emin olun. | | [Aspose.Words ile Word'de Dikdörtgen Şekil Oluşturma – Adım Adım Kılavuz](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Aspose.Words for .NET kullanarak Word belgesine dikdörtgen şekil eklemeyi ve özelliklerini ayarlamayı adım adım öğrenin. | +| [Word Belgesi Oluşturma C# – Gölgeli Şekil Ekle](./create-word-document-c-add-shape-with-shadow/) | Aspose.Words for .NET kullanarak C# ile Word belgesine gölge efektiyle şekil eklemeyi öğrenin. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/turkish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/turkish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..d1290b34ce --- /dev/null +++ b/words/turkish/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: C# ile Word belgesi oluşturun ve şekil eklemeyi, şekle gölge uygulamayı + ve gölge mesafesini ayarlamayı öğrenin. Aspose.Words için adım adım rehber. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: tr +og_description: C# ile bir dikdörtgen şekli ve özel gölge içeren Word belgesi oluşturun. + Gölge mesafesini ve stilini ayarlamak için bu tam öğreticiyi izleyin. +og_title: C# ile Word Belgesi Oluştur – Gölgeli Şekil Ekle +tags: +- Aspose.Words +- C# +- Document Automation +title: Word Belgesi Oluştur C# – Gölgeli Şekil Ekle +url: /tr/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word Belgesi Oluştur C# – Gölgelikli Şekil Ekle + +Hiç **create word document c#** gibi güzel stil verilmiş bir dikdörtgen içeren bir Word belgesi oluşturmanız gerekti mi? Belki bir rapor şablonu oluşturuyorsunuz ve düzeni öne çıkarmak için ince bir gölge eklemek istiyorsunuz. Bu öğreticide tam olarak bunu adım adım göstereceğiz – şekil ekleme, şekle gölge uygulama ve gölge mesafesini Aspose.Words kullanarak ayarlama. + +Boş bir belgeyle başlayacağız, bir dikdörtgen ekleyeceğiz, ön tanımlı bir gölge vereceğiz ve dosyayı kaydederek bitireceğiz. Sonunda, Word’de açıp etkisini anında görebileceğiniz hazır bir .docx dosyanız olacak. Harici araç gerekmez, sadece saf C# kodu. + +## Önkoşullar + +- .NET 6 (veya herhangi bir yeni .NET Framework) yüklü. +- Visual Studio 2022 veya C# uzantılı VS Code. +- Aspose.Words for .NET NuGet paketi (`Aspose.Words` sürüm 23.12 veya daha yeni). + Paketi Package Manager Console üzerinden ekleyebilirsiniz: + + ```powershell + Install-Package Aspose.Words + ``` + +Hepsi bu – ekstra DLL veya COM interop gerekmez. + +## Adım 1: Yeni Bir Belge ve Builder Başlatma – *create word document c#* Temelleri + +İlk olarak Word dosyasını temsil eden bir `Document` nesnesine ve onu düzenlemek için bir `DocumentBuilder` nesnesine ihtiyacımız var. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Why this step matters:** `Document` sınıfı tüm Word parçalarının (sayfalar, stiller, görseller) konteyneridir. Builder, düşük seviyeli düğüm manipülasyonunu soyutlayan yüksek‑seviye bir API olup, XML ile uğraşmadan **create word document c#** yapmayı kolaylaştırır. + +## Adım 2: Dikdörtgen Şekli Ekle – *how to create rectangle* + +Şimdi sayfaya bir dikdörtgen yerleştireceğiz. Boyut, puan cinsinden ifade edilir (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Pro tip:** Farklı bir şekle ihtiyacınız varsa, sadece `ShapeType.Rectangle` yerine `ShapeType.Ellipse`, `ShapeType.Triangle` vb. kullanın. Aynı kod **how to add shape** için her türlü şekil ile çalışır. + +## Adım 3: Ön Tanımlı Gölge Uygula ve İnce Ayar Yap – *apply shadow to shape* + +Aspose.Words birkaç ön tanımlı gölge formatı sunar. `Preset1` kullanacağız ve ardından mesafe, bulanıklık, şeffaflık ve rengi özelleştireceğiz. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Why customize the shadow?** `Distance` özelliği gölgenin dikdörtgenden ne kadar uzakta durduğunu kontrol eder – bunu bir 3‑D renderda gördüğünüz “kaldırma” olarak düşünebilirsiniz. `BlurRadius` kenarları yumuşatırken, `Transparency` daha ince, profesyonel bir görünüm sağlar. Bu, **set shadow distance** gereksinimini karşılar ve **apply shadow to shape** işlemini esnek bir şekilde yapmanızı gösterir. + +## Adım 4: Belgeyi Kaydet – *create word document c#* Tamamlanması + +Son olarak belgeyi diske yazalım. Yazma izniniz olan bir klasöre yolu ayarlayın. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Oluşan dosyayı Microsoft Word’de açın; 5 pt kaydırılmış, hafif gri bir gölgeye sahip açık mavi bir dikdörtgen göreceksiniz. Bu, stil verilmiş bir şekil ile **create word document c#** başarılı bir şekilde oluşturduğunuzun görsel kanıtıdır. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# örneği, gölgeli dikdörtgen gösterimi"} + +## İsteğe Bağlı Varyasyonlar ve Kenar Durumları + +| Senaryo | Ne Değiştirilmeli | Neden Önemli | +|----------|-------------------|--------------| +| **Farklı gölge stili** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Ek kod yazmadan daha çarpıcı bir görünüm sağlar. | +| **Ön tanımlı yok – özel gölge** | `Format` özelliğini atlayıp `OffsetX`, `OffsetY` değerlerini manuel ayarlayın. | Yön ve derinlik üzerinde tam kontrol sağlar. | +| **Birden çok şekil** | Kaydetmeden önce `builder.InsertShape` komutunu tekrar çağırın. | İkon, logo gibi öğeler içeren karmaşık şablonlar için faydalıdır. | +| **Eski Aspose sürümleriyle uyumluluk** | `ShadowEffect` sınıfını kullanın (v20.x’te mevcut). | Kodunuzun eski projelerde çalışmasını garantiler. | +| **PDF olarak kaydetme** | `document.Save("ShadowShape.pdf");` | Aynı gölge renderı PDF çıktısında da görülür. | + +> **Common question:** *What if the shadow doesn’t appear in Word?* +> Aspose.Words’un (≥ 22.9) güncel bir sürümünü kullandığınızdan emin olun. Eski sürümlerde gölge desteği sınırlıydı. Ayrıca belgenin Word 2016+ gibi yeni bir sürümde açıldığını doğrulayın. + +## Tam Çalışan Örnek + +Aşağıda tamamen kopyala‑yapıştır hazır program yer alıyor. Tüm `using` yönergeleri, yorumlar ve sorunsuz bir deneyim için hata yönetimi içerir. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Programı çalıştırın, `C:\Temp\ShadowShape.docx` konumuna gidin ve yapılandırdığımız tam gölgeye sahip dikdörtgeni görün. + +## Özet ve Sonraki Adımlar + +- Artık **create word document c#**, bir dikdörtgen ekleme ve **apply shadow to shape** işlemini özel bir **set shadow distance** ile nasıl yapacağınızı biliyorsunuz. +- Örnek, OpenXML karmaşıklıklarını soyutlayan ve Word sürümleri arasında tutarlı render garantileyen Aspose.Words kullanıyor. +- Daha ileri gitmek ister misiniz? Birden çok şekli birleştirmeyi, dikdörtgenin içine metin eklemeyi veya aynı belgeyi PDF olarak dışa aktarmayı deneyin; gölgenin nasıl aktığını göreceksiniz. + +### İlgili Konular + +- **How to add shape** başlık/altbilgiye marka eklemek için. +- **Aspose.Words** kullanarak programatik olarak grafik ve tablo eklemek. +- Vektörel şekiller yerine resimlerde **shadow effects** özelleştirme. +- Faturalar veya sertifikalar için toplu belge üretimini otomatikleştirme. + +Deney yapmaktan, kodu kırmaktan ve ardından yeniden inşa etmekten çekinmeyin – bu, kavramları içselleştirmenin en hızlı yoludur. Bir sorunla karşılaşırsanız, aşağıya yorum bırakın veya daha derin API bilgileri için resmi Aspose.Words dokümantasyonuna bakın. + +Kodlamanın tadını çıkarın ve Word dosyalarınızı biraz daha şık hâle getirin! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/net/programming-with-txtsaveoptions/_index.md b/words/turkish/net/programming-with-txtsaveoptions/_index.md index 6a3fef3f94..0570695456 100644 --- a/words/turkish/net/programming-with-txtsaveoptions/_index.md +++ b/words/turkish/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Bu eğitimler sayesinde, Aspose.Words for .NET'in işlevselliklerinden tam olara | [Word Belgesine Bidi İşaretleri Ekleme](./add-bidi-marks/) | Bu kılavuzla Aspose.Words for .NET kullanarak Word belgelerine çift yönlü (Bidi) işaretlerin nasıl ekleneceğini öğrenin. Çok dilli içerik için uygun metin yönünü sağlayın. | | [Liste Girintisi İçin Seviye Başına Sekme Karakteri Kullan](./use-tab-character-per-level-for-list-indentation/) | Aspose.Words for .NET kullanarak sekmeli girintili çok seviyeli listeler oluşturmayı öğrenin. Belgelerinizde hassas liste biçimlendirmesi için bu kılavuzu izleyin. | | [Liste Girintisi İçin Seviye Başına Boşluk Karakteri Kullan](./use-space-character-per-level-for-list-indentation/) | Aspose.Words for .NET'te boşluk karakteri girintili çok seviyeli listelerin nasıl oluşturulacağını öğrenin. Hassas belge biçimlendirmesi için adım adım kılavuz. | - +| [docx'i txt olarak kaydet – Word denklemlerini LaTeX'e dışa aktarma tam rehberi](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Bu kılavuz, Aspose.Words for .NET kullanarak docx dosyalarını txt'ye dönüştürürken Word denklemlerini LaTeX formatına nasıl dışa aktaracağınızı gösterir. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/turkish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/turkish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..ab5447478e --- /dev/null +++ b/words/turkish/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Aspose.Words ile docx dosyasını txt olarak kaydedin ve Word'ü LaTeX'e + dönüştürün. Denklemleri nasıl dışa aktaracağınızı, düz metni nasıl koruyacağınızı + ve dakikalar içinde LaTeX işaretlemesini nasıl alacağınızı öğrenin. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: tr +og_description: Aspose.Words kullanarak docx'i txt olarak kaydedin. Bu kılavuz, Word'ü + LaTeX'e dönüştürmeyi, denklemleri dışa aktarmayı ve belgenizi düz metin olarak tutmayı + gösterir. +og_title: docx'i txt olarak kaydet – Word denklemlerini LaTeX'e aktar +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: docx'i txt olarak kaydet – Word denklemlerini LaTeX'e aktarmak için tam rehber +url: /tr/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# docx'i txt olarak kaydet – Word denklemlerini LaTeX'e dışa aktar + +Hiç **docx'i txt olarak kaydet**meniz gerektiğinde, Word dosyanızdaki süslü matematiği kaybedeceğinizden endişe ettiniz mi? Yalnız değilsiniz. Birçok bilimsel iş akışında bir belgenin düz metin sürümü zorunludur, ancak denklemlerin temiz LaTeX işaretlemesi olarak korunmasını da istersiniz. + +Bu öğreticide, Aspose.Words for .NET kullanarak **Word'ü LaTeX'e dönüştür**menin tam adımlarını göstereceğiz; böylece denklemleriniz doğru şekilde dışa aktarılırken belgenin geri kalanı düzenli düz metin olur. Sonuna geldiğinizde **denklemleri LaTeX'e dışa aktarmayı**, dosyanın geri kalanını basit metin olarak tutmayı ve yeni başlayanların sıkça karşılaştığı tuzaklardan kaçınmayı öğreneceksiniz. + +## Öğrenecekleriniz + +- Office Math içeren bir *.docx* dosyasının nasıl yükleneceği. +- Her denklem için Aspose'un LaTeX üretmesini sağlamak amacıyla doğru `TxtSaveOptions` ayarının yapılması. +- Sonucun **save word plain text** dosyası olarak kaydedilmesi; bu dosyayı sürüm kontrolüne, CI boru hatlarına veya herhangi bir downstream araca besleyebilirsiniz. +- Yaygın kenar durumları—belge görseller ve denklemler karıştığında ne yapılacağı veya Unicode karakterlerin korunması gerektiğinde ne yapılacağı. +- Konsol uygulamasına doğrudan ekleyebileceğiniz eksiksiz, çalıştırmaya hazır bir kod örneği. + +### Önkoşullar + +- .NET 6.0 veya üzeri (kod .NET Framework 4.7+ ile de çalışır). +- **Aspose.Words for .NET** lisanslı bir kopya (ücretsiz deneme sürümü test için yeterlidir). +- C# projelerini derleyebilen Visual Studio 2022 veya herhangi bir IDE. +- Zaten bazı Office Math nesneleri içeren bir Word belgesi (`input.docx`). + +> **Pro ipucu:** Henüz bir lisansınız yoksa, Aspose’un web sitesinden geçici bir anahtar talep edebilirsiniz—çalıştırmadan önce koddaki yer tutucuyu anahtarınızla değiştirin. + +## Adım 1 – NuGet üzerinden Aspose.Words'i Yükleyin + +İlk iş olarak, kütüphaneyi projenize eklemeniz gerekir. **Package Manager Console**'u açın ve şu komutu çalıştırın: + +```powershell +Install-Package Aspose.Words +``` + +Bu tek satır, `Saving` ad alanının bulunduğu `TxtSaveOptions` dahil olmak üzere ihtiyacınız olan her şeyi getirir. Ek DLL'ler, yerel bağımlılıklar yok—sadece saf yönetilen kod. + +## Adım 2 – Kaynak Word Belgesini Yükleyin + +Şimdi denklemleri barındıran dosyayı gerçekten okuyacağız. `Document` sınıfı, tüm *.docx* yapısını soyutlar, böylece yüksek seviyeli bir nesne modeli gibi davranabilirsiniz. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Neden bu önemli:** Belgeyi erken yüklemek, düğüm ağacını incelemenizi sağlar. Kontrolü atlayıp dosyada denklem yoksa, yine de temiz bir txt dosyası alırsınız—ancak LaTeX çıktısının neden boş olduğunu bilmezsiniz. + +## Adım 3 – LaTeX Dışa Aktarımı için TxtSaveOptions'ı Yapılandırın + +Aspose, Office Math'in nasıl render edileceği konusunda ince ayar yapmanıza izin verir. `OfficeMathExportMode`'u `LaTeX` olarak ayarladığınızda, her denklem bir LaTeX eşdeğeriyle değiştirilir; silinmez veya görüntüye dönüştürülmez. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Neden bu önemli:** Varsayılan dışa aktarma modu denklemleri tamamen atar. `LaTeX`'e geçmek, matematiksel amacı korur; bu da dosyayı daha sonra bir LaTeX derleyicisine veya `$…$` sözdizimini anlayan bir markdown işlemcisine beslediğinizde tam ihtiyacınız olan şeydir. + +## Adım 4 – Belgeyi Düz Metin Olarak Kaydedin + +Seçenekler yapılandırıldıktan sonra, dosyayı kaydetmek tek satır bir işlem olur. Çıktı, her denklemin `$` sınırlayıcıları içinde LaTeX kodu olarak göründüğü bir `.txt` dosyası olacaktır (isteğe bağlı olarak `\[` … `\]` bloklarına da çevirebilirsiniz). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Beklenen Sonuç + +`output.txt` dosyasını herhangi bir editörde açtığınızda aşağıdakine benzer bir şey göreceksiniz: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Düzenli metnin tam olarak aynı kaldığını, denklemlerin ise artık saf LaTeX dizgileri olduğunu fark edin. Bu dizgileri doğrudan bir LaTeX belgesine, Jupyter defterine veya matematik render eden herhangi bir araca kopyalayıp yapıştırabilirsiniz. + +## Adım 5 – Kenar Durumlarını Ele Alma + +### Karışık İçerik (Görseller + Denklemler) + +Word dosyanız görseller de içeriyorsa, `TxtSaveOptions` kullandığınızda Aspose bunları yok sayar. Bu, bir **save word plain text** iş akışı için genellikle uygundur, ancak görselleri yer tutucu olarak da ihtiyacınız varsa şu adımları izleyebilirsiniz: + +1. Görselleri `` etiketleri olarak yakalamak için belgeyi önce HTML olarak dışa aktarın (`HtmlSaveOptions`). +2. LaTeX denklemlerini almak için ikinci bir geçişte `TxtSaveOptions` kullanın. +3. İki sonucu manuel olarak veya küçük bir betikle birleştirin. + +### Unicode Sembolleri + +Bazı denklemler özel Unicode karakterleri (ör. Yunan harfleri) kullanır. Adım 3'te gösterildiği gibi `TxtSaveOptions` içinde `Encoding = Encoding.UTF8` ayarlamak, bu sembollerin dönüşüm sırasında korunmasını sağlar. + +### Büyük Belgeler + +100 MB'den büyük dosyalar için kaydetme işlemini akış (stream) olarak yapmayı düşünün: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Akış, tüm çıktıyı belleğe yüklemeyi önler; düşük bellekli derleme ajanlarında hayat kurtarıcı olabilir. + +## Tam Çalışan Örnek + +Aşağıda her şeyi bir araya getiren, kopyala‑yapıştır‑hazır program yer alıyor. Dosya yollarını ve varsa lisans satırını değiştirmeniz yeterli. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Programı çalıştırın (`dotnet run` bir konsol projesi kullanıyorsanız) ve `output.txt` dosyasını kontrol edin. **docx'i txt olarak kaydetmiş** ve her denklemi LaTeX olarak korumuş oldunuz—manuel kopyala‑yapıştıra gerek kalmadı. + +## Sıkça Sorulan Sorular + +**S: Delimitörü `$…$` yerine `\(...\)` olarak değiştirebilir miyim?** +C: Evet. Kaydettikten sonra dosyada basit bir replace işlemi yapın: `output = output.Replace("$", @"\(").Replace("$", @"\)");`—orijinal metinde yer alan satır içi `$` karakterlerini değiştirmediğinizden emin olun. + +**S: Bu, Word 2007‑2019 dosyalarıyla çalışır mı?** +C: Kesinlikle. Aspose.Words `.doc`, `.docx`, `.docm` ve hatta yeni `.dotx` ailesini destekler. Aynı kod tüm sürümlerde sorunsuz çalışır. + +**S: Orijinal paragraf biçimlendirmesini (sekme, birden fazla boşluk) korumam gerekirse?** +C: `txtSaveOptions.PreserveTableLayout = true;` ve `txtSaveOptions.PreserveSpace = true;` ayarlarını yaparak boşlukları olduğu gibi tutabilirsiniz. + +## Sonuç + +Aspose.Words kullanarak **docx'i txt olarak kaydet** ve **denklemleri LaTeX'e dışa aktar**manız için ihtiyacınız olan her şeyi ele aldık. Temel adımlar belgeyi yüklemek, `TxtSaveOptions`'ı `OfficeMathExportMode.LaTeX` ile yapılandırmak ve sonucu kaydetmek. Bu üç satır kodla güvenilir bir şekilde **word'u latex'e dönüştürebilir**, belgenizi **save word plain text** olarak tutabilir ve matematik sembollerinin kaybolması sorununu ortadan kaldırabilirsiniz. + +Bir sonraki meydan okumaya hazır mısınız? Bu iş akışını bir markdown üreticisiyle zincirleyerek hem metin hem de LaTeX içeren tam bir `.md` dosyası oluşturabilirsiniz—Git‑tabanlı dokümantasyon veya statik site jeneratörleri için mükemmel. Ya da yanına bir PDF sürümü eklemek için Aspose’un `PdfSaveOptions`'ını keşfedin. + +Herhangi bir sorunla karşılaşırsanız, aşağıya yorum bırakın. İyi kodlamalar ve Word denklemlerini temiz LaTeX'e dönüştürmenin sadeliğinin tadını çıkarın! + +![DOCX'i TXT olarak kaydetme ve LaTeX denklemleri](placeholder-image.png "docx'i txt örneği") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/net/working-with-fonts/_index.md b/words/turkish/net/working-with-fonts/_index.md index 924616f109..86cae2f26c 100644 --- a/words/turkish/net/working-with-fonts/_index.md +++ b/words/turkish/net/working-with-fonts/_index.md @@ -32,6 +32,7 @@ Metni farklı yazı tipleriyle biçimlendirmek, yazı tipi değiştirme kurallar | [Yazı Tipi Vurgu İşaretini Ayarla](./set-font-emphasis-mark/) | Bu ayrıntılı, adım adım kılavuzla Aspose.Words for .NET kullanarak Word belgelerinde yazı tipi vurgu işaretlerinin nasıl ayarlanacağını öğrenin. .NET geliştiricileri için mükemmel. | | [Yazı Tipleri Klasörlerini Ayarla](./set-fonts-folders/) | Bu kapsamlı, adım adım kılavuzla Aspose.Words for .NET'te özel yazı tipi klasörlerinin nasıl ayarlanacağını öğrenin. Belge yazı tiplerini geliştirmek isteyen geliştiriciler için mükemmeldir. | | [Yazı Tipi Değiştirmeyi Etkinleştir Devre Dışı Bırak](./enable-disable-font-substitution/) | Aspose.Words for .NET kullanarak Word belgelerinde yazı tipi değişimini nasıl etkinleştireceğinizi veya devre dışı bırakacağınızı öğrenin. Belgelerinizin tüm platformlarda tutarlı görünmesini sağlayın. | +| [Aspose Font Değiştirme – C#'ta Yazı Tipi Ayarlarını Yapılandırma](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Aspose.Words for .NET kullanarak C# ile yazı tipi ayarlarını nasıl yapılandıracağınızı adım adım öğrenin. | | [Yazı Tipi Yedek Ayarlarını Ayarla](./set-font-fallback-settings/) | Aspose.Words for .NET'te font değiştirme ayarlarının nasıl yapılacağını öğrenin ve Word belgelerinizdeki font değiştirmeyi özelleştirin. | | [Noto Yedek Ayarlarını Yükle](./load-noto-fallback-settings/) | Aspose.Words for .NET kullanarak bir Word belgesine Noto yedek ayarlarının nasıl yükleneceğini öğrenin. Tüm karakterlerin doğru şekilde görüntülendiğinden emin olmak için adım adım kılavuzumuzu izleyin. | | [Yazı Tipleri Klasörlerini Varsayılan Örnek Olarak Ayarla](./set-fonts-folders-default-instance/) | Bu adım adım eğitimle Aspose.Words for .NET'te varsayılan örnek için font klasörlerini nasıl ayarlayacağınızı öğrenin. Word belgelerinizi zahmetsizce özelleştirin. | @@ -40,7 +41,7 @@ Metni farklı yazı tipleriyle biçimlendirmek, yazı tipi değiştirme kurallar | [Font Klasörlerini Öncelikli Olarak Ayarla](./set-fonts-folders-with-priority/) | Aspose.Words for .NET kullanarak Word belgelerinde font klasörlerini öncelikli olarak nasıl ayarlayacağınızı öğrenin. Kılavuzumuz belgelerinizin her seferinde mükemmel şekilde işlenmesini sağlar. | | [True Type Yazı Tipleri Klasörünü Ayarla](./set-true-type-fonts-folder/) | Aspose.Words for .NET kullanarak Word belgelerinde True Type Fonts klasörünün nasıl ayarlanacağını öğrenin. Tutarlı font yönetimini sağlamak için ayrıntılı, adım adım kılavuzumuzu izleyin. | | [İşleme Sırasında Varsayılan Yazı Tipini Belirle](./specify-default-font-when-rendering/) | Aspose.Words for .NET kullanarak Word belgelerini işlerken varsayılan yazı tipini nasıl belirleyeceğinizi öğrenin. Platformlar arasında tutarlı belge görünümünü sağlayın. | -| [Yükleme Seçenekleriyle Yazı Tipi Ayarları](./font-settings-with-load-options/) Aspose.Words for .NET'te yükleme seçenekleriyle yazı tipi ayarlarının nasıl yönetileceğini öğrenin. Geliştiricilerin Word belgelerinde tutarlı yazı tipi görünümünü sağlamaları için adım adım kılavuz. +| [Yükleme Seçenekleriyle Yazı Tipi Ayarları](./font-settings-with-load-options/) Aspose.Words for .NET'te yükleme seçenekleriyle yazı tipi ayarlarının nasıl yönetileceğini öğrenin. Geliştiricilerin Word belgelerinde tutarlı yazı tipi görünümünü sağlamaları için adım adım kılavuz. | | [Yazı Tipleri Klasörünü Ayarla](./set-fonts-folder/) | Word belgelerinizin eksik yazı tipleri olmadan doğru şekilde işlenmesini sağlamak için Aspose.Words for .NET'te özel yazı tipleri klasörünün nasıl ayarlanacağını öğrenin. | | [Yazı Tipi Ayarları Varsayılan Örnek](./font-settings-default-instance/) | Bu eğitimde, Aspose.Words for .NET ile bir Word belgesinde varsayılan yazı tipi ayarlarının nasıl yapılandırılacağını öğrenin. | | [Mevcut Yazı Tiplerinin Listesini Alın](./get-list-of-available-fonts/) | Bu detaylı adım adım eğitimde Aspose.Words for .NET kullanarak mevcut fontların listesini nasıl alacağınızı keşfedin. Font yönetimi becerilerinizi artırın. | diff --git a/words/turkish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/turkish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..61381066f7 --- /dev/null +++ b/words/turkish/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,235 @@ +--- +category: general +date: 2026-03-27 +description: 'Aspose Font Değiştirme kolaylaştırıldı: yazı tipi ayarlarını yapılandırmayı, + uyarıları yakalamayı ve .NET uygulamalarınızda eksik yazı tiplerini yönetmeyi öğrenin.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: tr +og_description: Aspose Yazı Tipi Değişimini, yazı tipi ayarlarını yapılandırarak ve + eksik yazı tiplerini bir uyarı geri çağrısı ile ele alarak ustalaşın. Tam C# rehberi. +og_title: Aspose Yazı Tipi Değiştirme – C#'ta Yazı Tipi Ayarlarını Yapılandırma +tags: +- Aspose.Words +- C# +- Font Management +title: Aspose Yazı Tipi Değiştirme – C#'ta Yazı Tipi Ayarlarını Nasıl Yapılandırılır +url: /tr/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Aspose Font Substitution – Font Ayarlarını Yapılandırma İçin Tam Kılavuz + +Hiç bir belgenin aniden özel yazı tipinizi genel bir şeyle değiştirdiğine rastladınız mı? Bu, **aspose font substitution** işini yapıyor—eksik yazı tiplerini bulabildiği en yakın eşleşmeyle değiştiriyor. Bu kullanışlı, ancak hangi yazı tipinin *tam olarak* değiştirildiğini bilmeniz gerekiyorsa, kütüphanenin uyarı sistemine erişmeli ve font ayarlarını kendiniz yapılandırmalısınız. + +Bu öğreticide gerçek bir senaryoyu adım adım inceleyeceğiz: eksik bir yazı tipine referans veren bir DOCX dosyasını yüklemek, değişim olayını yakalamak ve konsola dostça bir mesaj yazdırmak. Sonunda **configure font settings** konusunda rahat olacak, bir **Aspose.Words warning callback** bağlayacak ve örneği herhangi bir iş akışına uyacak şekilde genişletebileceksiniz. + +> **İhtiyacınız olanlar** +> • .NET 6+ (or .NET Framework 4.7.2+) +> • Aspose.Words for .NET (latest NuGet) +> • A DOCX that references a missing font (we’ll call it `MissingFont.docx`) + +Hadi başlayalım. + +--- + +## Adım 1: Aspose.Words'ı Yükleyin ve Projeyi Hazırlayın + +Herhangi bir kod yazmadan önce, Aspose.Words paketinin referans alındığından emin olun: + +```bash +dotnet add package Aspose.Words +``` + +> **Pro ipucu:** En son kararlı sürümü kullanın; Mart 2026 itibarıyla 23.11.0 sürümüdür. Daha yeni sürümler font eşleştirme algoritmalarını iyileştirir ve ek uyarı türleri ekler. + +Yeni bir konsol uygulaması oluşturun (veya kodu mevcut bir projeye ekleyin) ve tipik `using` yönergelerini ekleyin: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Bu ad alanları, ihtiyacımız olan `Document`, `LoadOptions` ve font‑ile ilgili sınıflara erişim sağlar. + +## Adım 2: LoadOptions ile Font Ayarlarını Yapılandırın + +**aspose font substitution** kontrolünün kalbi `LoadOptions.FontSettings` içinde yer alır. Boş bir `FontSettings` nesnesi sağlayarak Aspose'a varsayılan arama yollarını *ve* herhangi bir değişimi bir uyarı geri çağrısı aracılığıyla raporlamasını söyleriz. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Neden sadece varsayılanlara güvenmeyelim? Çünkü bir uyarı geri çağrısı (sonraki adım) yalnızca `FontSettings` özelliği null olmayan bir durumda çalışır. Bu küçük satır, gerçek font arama davranışını değiştirmeden değişim sürecine bir kanca sağlar. + +## Adım 3: Değişimleri Yakalamak İçin Bir Uyarı Geri Çağrısı Ekleyin + +Aspose.Words, `IWarningCallback` arayüzünü uygular. Eksik bir font gibi dikkat çekici bir şey olduğunda, `Warning` metodumuzu çağırır. `WarningType.FontSubstitution` için filtreleyen ve açıklamayı yazdıran küçük bir işleyici uygulayacağız. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +İşte işleyicinin kendisi: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Neden önemli** – Geri çağrı olmadan, Aspose sessizce fontları değiştirir ve hangi fontun kullanıldığını asla öğrenemezsiniz. Geri çağrı, süreci şeffaf hâle getirir; bu, uyumluluk raporlaması veya düzen sorunlarını ayıklama için esastır. + +## Adım 4: Belgeyi Yapılandırılmış Seçeneklerle Yükleyin + +Şimdi nihayet belgeyi, az önce hazırladığımız `loadOptions` ile yüklüyoruz. Kaynak dosya yüklü olmayan bir fonta referans veriyorsa, işleyicimiz tetiklenecek. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +`YOUR_DIRECTORY` ifadesini `MissingFont.docx` dosyasının bulunduğu gerçek yol ile değiştirin. Programı çalıştırdığınızda aşağıdaki gibi bir çıktı görmelisiniz: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Bu satır, eksik olan fontun ve Aspose'un seçtiği yedek fontun tam olarak hangisi olduğunu size bildirir. + +## Adım 5: (İsteğe Bağlı) Font Arama Yollarını İnce Ayarlayın + +Kurumsal fontların bulunduğu özel bir klasörünüz varsa, Aspose'a sistem fontlarına dönmeden önce nerelere bakacağını söyleyebilirsiniz. Bu, **configure font settings**'in gelişmiş bir kullanım örneğidir: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +`recursive: true` ayarı, Aspose'un alt klasörleri de taramasını sağlar. Böylece kütüphane önce özel fontlarınızı deneyecek ve istenmeyen değişim olasılığını azaltacaktır. + +## Tam Çalışan Örnek + +Her şeyi bir araya getirerek, işte tam ve çalıştırmaya hazır program: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Beklenen çıktı** (eksik bir fontla karşılaşıldığında): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Tüm fontlar mevcutsa, program sessizce çalışır (uyarı yok) ve yine de PDF üretir. + +## Sık Sorulan Sorular & Kenar Durumları + +### Değişimi tamamen *önlemek* istersem ne olur? + +`FontSettings.SubstitutionSettings` özelliğini `null` olarak ayarlayın veya davranışı kontrol etmek için `FontSettings.FontSubstitutionSettings` kullanın. Örneğin: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Artık Aspose, sessizce değiştirmenin yerine bir istisna fırlatacak; bu istisna yakalanıp işlenebilir. + +### Bu, diğer dosya formatlarıyla (ör. .doc, .rtf) çalışır mı? + +Kesinlikle. Aynı `LoadOptions` nesnesi, dosya yolu kabul eden herhangi bir `Document` yapıcısına geçirilebilir. Uyarı geri çağrısı, fontlara bağımlı tüm formatlar için tetiklenecektir. + +### *Tam* yedek font adını yakalayabilir miyim? + +Evet. `info.Description` dizesi hem eksik fontu hem de yerine geçen fontu içerir. Programa göre adı almanız gerekiyorsa, dizeyi ayrıştırabilir veya `FontInfo` nesnesini (yeni sürümlerde mevcut) kullanabilirsiniz. + +### Bu, çok‑iş parçacıklı bir ortamda nasıl davranır? + +`FontSettings` **thread‑safe** değildir. Her iş parçacığı için ayrı bir `LoadOptions` (kendi `FontSettings` ile) oluşturun veya erişimi bir kilitle koruyun. + +## Sonuç + +**aspose font substitution** ve **configure font settings** konularında C# uygulamasında ustalaşmak için gereken her şeyi ele aldık: + +1. Aspose.Words'ı kurun ve gerekli `using` ifadelerini ekleyin. +2. Yeni bir `FontSettings` ile bir `LoadOptions` nesnesi oluşturun. +3. Değişim olaylarını ortaya çıkarmak için özel bir `IWarningCallback` ekleyin. +4. Belgeyi yükleyin, geri çağrının eksik fontları rapor etmesine izin verin. +5. (İsteğe bağlı) Arama yolunu genişletin veya değişimi tamamen devre dışı bırakın. + +Bu desenle donanmış olarak, uyumluluk için eksik fontları kaydedebilir, bir UI'da kullanıcıları uyarabilir veya yayınlamadan önce yedek fontları otomatik olarak gömebilirsiniz. Sonraki adımda **Aspose.Words font substitution policies**'i keşfedebilir veya iş akışını daha büyük bir belge‑işleme hattına entegre edebilirsiniz. + +Kodlamaktan keyif alın, ve belgeleriniz her zaman doğru yazı tipiyle görüntülensin! + +--- + +![Aspose.Words'un bir belgeyi yüklediğini, FontSettings'i çağırdığını, bir uyarı geri çağrısını tetiklediğini ve değişim bilgilerini çıktıladığını gösteren diyagram](image-placeholder.png "aspose font substitution iş akışı") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/vietnamese/net/basic-conversions/_index.md b/words/vietnamese/net/basic-conversions/_index.md index f5a19d54fb..5d8e76bfea 100644 --- a/words/vietnamese/net/basic-conversions/_index.md +++ b/words/vietnamese/net/basic-conversions/_index.md @@ -26,6 +26,7 @@ Basic Conversions hướng dẫn bạn cách chuyển đổi tài liệu cơ b | [Chuyển đổi tệp Word sang PDF](./docx-to-pdf/) Tìm hiểu cách dễ dàng chuyển đổi tệp Word sang PDF bằng Aspose.Words cho .NET với hướng dẫn của chúng tôi. Hoàn hảo cho các nhà phát triển đang tìm kiếm chuyển đổi tài liệu nhanh chóng và đáng tin cậy. | | [Chuyển đổi Word sang PDF trong C# bằng Aspose.Words – Hướng dẫn](./convert-word-to-pdf-in-c-using-aspose-words-guide/) | Hướng dẫn chi tiết cách chuyển đổi tài liệu Word sang PDF trong C# sử dụng Aspose.Words, kèm ví dụ mã nguồn. | | [Lưu Word thành PDF với Aspose.Words – Hướng dẫn C# đầy đủ](./save-word-as-pdf-with-aspose-words-complete-c-guide/) | Hướng dẫn chi tiết cách lưu tài liệu Word thành PDF bằng Aspose.Words trong C#, kèm ví dụ mã nguồn. | +| [Chuyển đổi Word sang PDF với Aspose.Words – Hướng dẫn đầy đủ](./convert-word-to-pdf-with-aspose-words-complete-guide/) | Hướng dẫn chi tiết cách chuyển đổi tài liệu Word sang PDF bằng Aspose.Words, bao gồm ví dụ mã nguồn đầy đủ. | | [Chuyển đổi Docx sang Byte](./docx-to-byte/) | Tìm hiểu cách chuyển đổi Docx sang mảng byte trong .NET bằng Aspose.Words để xử lý tài liệu hiệu quả. Có kèm hướng dẫn từng bước. | | [Chuyển đổi Docx sang Epub](./docx-to-epub/) | Chuyển đổi DOCX sang EPUB dễ dàng với Aspose.Words cho .NET. Làm theo hướng dẫn của chúng tôi để tích hợp liền mạch vào các ứng dụng .NET của bạn. | | [Chuyển đổi Docx sang Mhtml và gửi Email](./docx-to-mhtml-and-sending-email/) | Tìm hiểu cách chuyển đổi DOCX sang MHTML và gửi email bằng Aspose.Words cho .NET trong hướng dẫn từng bước này. Tăng năng suất của bạn với tính năng tự động hóa dễ dàng. | diff --git a/words/vietnamese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md b/words/vietnamese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md new file mode 100644 index 0000000000..a827ea8582 --- /dev/null +++ b/words/vietnamese/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-03-27 +description: Chuyển đổi Word sang PDF nhanh chóng bằng Aspose.Words. Tìm hiểu cách + lưu Word dưới dạng PDF, xuất docx sang PDF và tạo PDF có khả năng truy cập trong + C#. +draft: false +keywords: +- convert word to pdf +- save word as pdf +- export docx to pdf +- generate accessible pdf +- save document as pdf +language: vi +og_description: Chuyển đổi Word sang PDF trong C# bằng Aspose.Words. Hướng dẫn này + chỉ cách lưu Word dưới dạng PDF, xuất docx sang PDF và tạo PDF có khả năng truy + cập. +og_title: Chuyển đổi Word sang PDF bằng Aspose.Words – Từng bước +tags: +- Aspose.Words +- C# +- PDF conversion +title: Chuyển đổi Word sang PDF với Aspose.Words – Hướng dẫn đầy đủ +url: /vi/net/basic-conversions/convert-word-to-pdf-with-aspose-words-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Chuyển đổi Word sang PDF với Aspose.Words – Hướng dẫn toàn diện + +Bạn đã bao giờ tự hỏi cách **chuyển đổi Word sang PDF** mà không cần dùng các công cụ web của bên thứ ba chưa? Có thể bạn đang xây dựng một engine báo cáo tự động và cần một cách đáng tin cậy để *save word as pdf* ngay trong quá trình chạy. Tin tốt là Aspose.Words làm cho toàn bộ quá trình trở nên đơn giản, và bạn thậm chí có thể tạo ra một tệp **PDF/UA‑2** tuân thủ – hoàn hảo cho các yêu cầu về khả năng truy cập. + +Trong tutorial này, chúng ta sẽ đi qua mọi thứ bạn cần: tải một tệp `.docx`, cấu hình các tùy chọn PDF để bạn có thể *export docx to pdf* với tuân thủ PDF/UA, và cuối cùng lưu kết quả dưới dạng PDF có thể truy cập. Khi kết thúc, bạn sẽ có một đoạn mã tự chứa, sẵn sàng cho môi trường production mà bạn có thể chèn vào bất kỳ dự án .NET nào. + +![Chuyển đổi Word sang PDF bằng Aspose.Words](convert-word-to-pdf.png) + +## Những gì bạn sẽ học + +- **Tại sao Aspose.Words** là lựa chọn vững chắc cho các kịch bản *generate accessible pdf*. +- Các bước chính để *save document as pdf* với tuân thủ PDF/UA‑2. +- Cách xử lý các trường hợp biên thường gặp như thiếu phông chữ hoặc tệp nguồn được bảo vệ bằng mật khẩu. +- Một số mẹo nhanh để debug đầu ra và xác minh tuân thủ khả năng truy cập. + +### Yêu cầu trước + +- .NET 6 hoặc mới hơn (API cũng hoạt động trên .NET Framework 4.6+). +- Một giấy phép Aspose.Words for .NET hợp lệ (bản dùng thử miễn phí đủ cho việc đánh giá). +- Kiến thức cơ bản về C#—không cần các mẫu phức tạp. + +Nếu bạn đã đáp ứng các yêu cầu trên, hãy bắt đầu. + +--- + +## Chuyển đổi Word sang PDF – Thực hiện từng bước + +Chúng ta sẽ chia giải pháp thành năm bước rõ ràng. Mỗi bước có tiêu đề, một đoạn mã ngắn, và giải thích *tại sao* đoạn mã quan trọng. + +### Bước 1: Tải tài liệu Word cần chuyển đổi + +Điều đầu tiên bạn cần là một đối tượng `Document` đại diện cho tệp nguồn. Aspose.Words hỗ trợ đọc **.docx**, **.doc**, **.rtf**, và nhiều định dạng khác, vì vậy bạn có thể *save word as pdf* bất kể tệp được tạo ra bằng cách nào. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// Replace with the actual path to your source file +string inputPath = @"C:\MyFiles\input.docx"; + +try +{ + // Load the Word document into memory + Document doc = new Document(inputPath); +} +catch (FileNotFoundException ex) +{ + Console.Error.WriteLine($"❌ The file '{inputPath}' could not be found: {ex.Message}"); + throw; +} +catch (InvalidFormatException ex) +{ + Console.Error.WriteLine($"❌ The file format is not supported or the file is corrupted: {ex.Message}"); + throw; +} +``` + +**Tại sao điều này quan trọng:** +- Việc tải tệp sớm giúp bạn phát hiện lỗi thiếu tệp trước khi tiêu tốn tài nguyên CPU. +- Lớp `Document` ẩn đi cấu trúc nội bộ của tệp Word, cung cấp một mô hình đối tượng sạch sẽ để làm việc. + +### Bước 2: Cấu hình tùy chọn lưu PDF cho khả năng truy cập + +Nếu bạn cần *generate accessible pdf*, bạn phải yêu cầu Aspose.Words tạo ra tài liệu tuân thủ PDF/UA‑2. Lớp `PdfSaveOptions` cho phép bạn kiểm soát chi tiết đầu ra. + +```csharp +// Prepare PDF save options with PDF/UA‑2 compliance +PdfSaveOptions saveOptions = new PdfSaveOptions +{ + // This flag ensures the PDF follows the PDF/UA (Universal Accessibility) standard + Compliance = PdfCompliance.PdfUa2, + + // Optional: embed all fonts to avoid missing‑glyph issues on other machines + EmbedFullFonts = true, + + // Optional: set the document title for better accessibility metadata + Title = "Converted from input.docx" +}; +``` + +**Tại sao điều này quan trọng:** +- `PdfCompliance.PdfUa2` chỉ cho thư viện thêm các thẻ, thông tin cấu trúc và metadata cần thiết cho các trình đọc màn hình. +- Nhúng phông chữ (`EmbedFullFonts = true`) ngăn các cảnh báo “font not found” khi PDF được mở trên hệ điều hành khác. +- Đặt `Title` giúp công nghệ hỗ trợ thông báo đúng tên tài liệu. + +### Bước 3: Lưu tài liệu dưới dạng PDF + +Khi nguồn đã được tải và tùy chọn đã được thiết lập, việc chuyển đổi thực sự chỉ là một dòng lệnh. Đây là nơi bạn *export docx to pdf*. + +```csharp +// Destination path for the PDF file +string outputPath = @"C:\MyFiles\output.pdf"; + +try +{ + // Perform the conversion + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ Successfully converted '{inputPath}' to '{outputPath}'."); +} +catch (Exception ex) +{ + Console.Error.WriteLine($"❌ Failed to save PDF: {ex.Message}"); + throw; +} +``` + +**Tại sao điều này quan trọng:** +- Phương thức `Save` tuân theo `PdfSaveOptions` mà chúng ta đã cấu hình, đảm bảo các tính năng truy cập được tích hợp. +- Bao bọc lời gọi trong khối `try/catch` cho phép bạn ghi log hoặc thông báo các lỗi giấy phép hoặc quyền truy cập thường gặp với người mới. + +### Bước 4: Xác minh tuân thủ PDF/UA (Tùy chọn nhưng Được khuyến nghị) + +Mặc dù Aspose.Words thực hiện phần lớn công việc, việc kiểm tra lại đầu ra luôn là thói quen tốt, đặc biệt khi bạn cung cấp tài liệu cho các cơ quan chính phủ hoặc các thực thể có quy định. + +```csharp +using Aspose.Pdf; // Requires Aspose.PDF for deeper inspection + +// Load the generated PDF +Document pdfDoc = new Document(outputPath); + +// Check if the PDF is tagged (a quick indicator of PDF/UA compliance) +bool isTagged = pdfDoc.IsTagged; +Console.WriteLine(isTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – you may need to revisit the save options."); +``` + +**Tại sao điều này quan trọng:** +- `IsTagged` là một kiểm tra nhanh; việc xác thực đầy đủ PDF/UA đòi hỏi một công cụ validator riêng, nhưng hầu hết các vấn đề tuân thủ xuất hiện dưới dạng thiếu thẻ. +- Nếu cờ trả về `false`, bạn có thể xem lại `PdfSaveOptions`—có thể bạn quên đặt `Compliance` hoặc tài liệu nguồn thiếu các kiểu heading phù hợp. + +### Bước 5: Những lỗi thường gặp & Mẹo chuyên nghiệp + +| Lỗi thường gặp | Điều gì xảy ra | Cách khắc phục | +|----------------|----------------|----------------| +| **Thiếu phông chữ** | Văn bản hiển thị dưới dạng hộp trong PDF. | Đặt `EmbedFullFonts = true` **hoặc** cài đặt các phông chữ thiếu trên máy chủ. | +| **Thư viện chưa được cấp phép** | Aspose thêm watermark vào mỗi trang. | Thêm tệp giấy phép (`Aspose.Words.lic`) sớm trong ứng dụng (ví dụ: `License license = new License(); license.SetLicense("Aspose.Words.lic");`). | +| **Nguồn được bảo vệ bằng mật khẩu** | `InvalidOperationException` khi `new Document(path)`. | Sử dụng overload `new Document(path, new LoadOptions { Password = "secret" })`. | +| **Tài liệu lớn gây OOM** | Ngoại lệ out‑of‑memory trên các tệp khổng lồ. | Bật `MemoryOptimization` trong `PdfSaveOptions` (`saveOptions.MemoryOptimization = true`). | +| **Thiếu thẻ truy cập** | Kiểm tra PDF/UA thất bại. | Đảm bảo tệp Word nguồn sử dụng đúng kiểu heading (`Heading 1`, `Heading 2`, …) — Aspose sẽ tự động ánh xạ chúng thành các thẻ PDF. | + +**Mẹo chuyên nghiệp:** Nếu bạn chuyển đổi nhiều tài liệu trong một batch, hãy tái sử dụng một thể hiện `PdfSaveOptions` duy nhất. Tạo một lần sẽ giảm chi phí cấp phát và giữ dung lượng bộ nhớ thấp. + +--- + +## Ví dụ hoàn chỉnh (Sẵn sàng sao chép) + +Dưới đây là chương trình đầy đủ kết hợp mọi thứ lại. Lưu dưới tên `Program.cs`, thêm các gói NuGet Aspose.Words và Aspose.PDF, rồi chạy. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; +using Aspose.Pdf; // For optional verification + +class Program +{ + static void Main() + { + // 1️⃣ Set up paths + string inputPath = @"C:\MyFiles\input.docx"; + string outputPath = @"C:\MyFiles\output.pdf"; + + // 2️⃣ Load the Word document + Document doc; + try + { + doc = new Document(inputPath); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Unable to load '{inputPath}': {ex.Message}"); + return; + } + + // 3️⃣ Configure PDF options for accessibility + PdfSaveOptions saveOptions = new PdfSaveOptions + { + Compliance = PdfCompliance.PdfUa2, + EmbedFullFonts = true, + Title = "Converted from input.docx" + }; + + // 4️⃣ Save as PDF + try + { + doc.Save(outputPath, saveOptions); + Console.WriteLine($"✅ File saved to '{outputPath}'."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Conversion failed: {ex.Message}"); + return; + } + + // 5️⃣ (Optional) Verify PDF/UA tagging + try + { + Document pdfDoc = new Document(outputPath); + Console.WriteLine(pdfDoc.IsTagged + ? "🔍 PDF is tagged – accessibility metadata present." + : "⚠️ PDF is NOT tagged – review your options."); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Could not open generated PDF: {ex.Message}"); + } + } +} +``` + +**Kết quả mong đợi:** +Một tệp có tên `output.pdf` sẽ xuất hiện trong `C:\MyFiles`. Mở nó bằng Adobe Acrobat sẽ hiển thị “PDF/A‑2b, PDF/UA‑1” trong bảng tuân thủ, xác nhận rằng bạn đã thành công *convert word to pdf*. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/vietnamese/net/programming-with-markdownsaveoptions/_index.md b/words/vietnamese/net/programming-with-markdownsaveoptions/_index.md index ec576d7f37..4536ef23f9 100644 --- a/words/vietnamese/net/programming-with-markdownsaveoptions/_index.md +++ b/words/vietnamese/net/programming-with-markdownsaveoptions/_index.md @@ -32,6 +32,9 @@ Words Processing with MarkdownSaveOptions là một nguồn tài nguyên chuyên | [Lưu docx thành markdown – Hướng dẫn đầy đủ C# với trích xuất hình ảnh](./save-docx-as-markdown-full-c-guide-with-image-extraction/) | Hướng dẫn chi tiết cách lưu file docx thành markdown và trích xuất hình ảnh bằng C# và Aspose.Words. | | [Xuất Markdown từ Word – Hướng dẫn đầy đủ C#](./how-to-export-markdown-from-word-complete-c-guide/) | Hướng dẫn chi tiết cách xuất tài liệu Word sang định dạng Markdown bằng C# và Aspose.Words, bao gồm các tùy chọn và ví dụ thực tế. | | [Xuất Markdown từ DOCX – Hướng dẫn đầy đủ](./how-to-export-markdown-from-docx-complete-guide/) | Hướng dẫn chi tiết cách xuất file DOCX sang Markdown bằng C# và Aspose.Words, bao gồm các tùy chọn và ví dụ thực tế. | +| [Cách xuất LaTeX từ Word – Chuyển DOCX sang Markdown](./how-to-export-latex-from-word-convert-docx-to-markdown/) | Hướng dẫn xuất công thức LaTeX từ tài liệu Word sang Markdown bằng Aspose.Words cho .NET. | +| [Cách xuất LaTeX từ DOCX – Chuyển sang Markdown](./how-to-export-latex-from-docx-convert-to-markdown/) | Hướng dẫn xuất công thức LaTeX từ file DOCX sang Markdown bằng Aspose.Words cho .NET. | +| [Tạo markdown từ Word – Hướng dẫn đầy đủ C#](./create-markdown-from-word-full-c-guide/) | Hướng dẫn chi tiết cách tạo markdown từ tài liệu Word bằng C# và Aspose.Words, bao gồm các tùy chọn và ví dụ thực tế. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/vietnamese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md b/words/vietnamese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md new file mode 100644 index 0000000000..247c944523 --- /dev/null +++ b/words/vietnamese/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/_index.md @@ -0,0 +1,253 @@ +--- +category: general +date: 2026-03-27 +description: Tạo markdown từ Word bằng Aspose.Words C#. Học cách chuyển đổi docx sang + markdown, trích xuất hình ảnh từ Word và cách sử dụng callback trong một hướng dẫn + duy nhất. +draft: false +keywords: +- create markdown from word +- convert docx to markdown +- extract images from word +- how to extract images +- how to use callback +language: vi +og_description: Tạo markdown từ Word bằng Aspose.Words. Hướng dẫn này cho thấy cách + chuyển đổi docx sang markdown, trích xuất hình ảnh từ Word và sử dụng callback để + xử lý tài nguyên. +og_title: Tạo markdown từ Word – Hướng dẫn C# hoàn chỉnh +tags: +- Aspose.Words +- C# +- Markdown +- Word +title: Tạo markdown từ Word – Hướng dẫn C# đầy đủ +url: /vi/net/programming-with-markdownsaveoptions/create-markdown-from-word-full-c-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Tạo markdown từ Word – Hướng dẫn C# đầy đủ + +Bạn đã bao giờ cần **tạo markdown từ Word** nhưng không chắc bắt đầu từ đâu? Bạn không cô đơn; nhiều nhà phát triển gặp khó khăn này khi họ cố gắng chuyển nội dung từ tệp .docx sang một trình tạo trang tĩnh hoặc kho tài liệu. Tin tốt? Với Aspose.Words bạn có thể **chuyển đổi docx sang markdown**, lấy mọi hình ảnh ra khỏi tệp gốc, và kiểm soát chính xác nơi các tài nguyên này được lưu — tất cả bằng một callback đơn giản. + +Trong hướng dẫn này, chúng tôi sẽ đi qua một ví dụ thực tế cho thấy cách trích xuất hình ảnh từ Word, cách sử dụng callback để lưu chúng, và tại sao cách tiếp cận này là đáng tin cậy nhất cho các pipeline tự động. Khi hoàn thành, bạn sẽ có một chương trình C# sẵn sàng chạy, tạo ra một tệp `.md` sạch sẽ và một thư mục chứa các hình ảnh đã trích xuất. + +> **Mẹo chuyên nghiệp:** Nếu bạn đã có một mẫu Word bao gồm ảnh chụp màn hình, sơ đồ hoặc logo, phương pháp này sẽ giữ nguyên mọi yếu tố hình ảnh mà không cần bạn sao chép‑dán thủ công. + +--- + +## Những gì bạn cần + +- **.NET 6+** (hoặc .NET Framework 4.6+). Mã nguồn hoạt động trên bất kỳ runtime hiện đại nào. +- **Aspose.Words for .NET** (gói NuGet `Aspose.Words`). Bản dùng thử miễn phí đáp ứng hầu hết các kịch bản. +- Một **tài liệu Word** (`input.docx`) chứa văn bản và ít nhất một hình ảnh. +- Kiến thức cơ bản về C# và Visual Studio (hoặc IDE yêu thích của bạn). + +Không cần thư viện bổ sung — mọi thứ khác đều được Aspose.Words xử lý. + +--- + +## Bước 1: Thiết lập dự án và cài đặt Aspose.Words + +Để giữ mọi thứ gọn gàng, bắt đầu một dự án console mới: + +```bash +dotnet new console -n WordToMarkdown +cd WordToMarkdown +dotnet add package Aspose.Words +``` + +> **Tại sao bước này quan trọng:** Cài đặt gói NuGet đảm bảo bạn có API mới nhất, bao gồm lớp `MarkdownSaveOptions` được giới thiệu trong phiên bản 22.9. Nếu không có nó, bạn sẽ phải tự viết bộ chuyển đổi tùy chỉnh. + +--- + +## Bước 2: Tải tài liệu Word nguồn + +Dòng mã đầu tiên mở tệp `.docx` bạn muốn chuyển đổi. Thay thế `YOUR_DIRECTORY` bằng đường dẫn thực tế trên máy của bạn. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +// Load the source Word document that contains images +Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); +``` + +> **Đang xảy ra gì?** `Document` phân tích tệp, xây dựng DOM nội bộ và cho phép truy cập mọi đoạn văn, bảng và hình ảnh. Nếu tệp không tồn tại, Aspose sẽ ném ra `FileNotFoundException` rõ ràng, bạn có thể bắt để hiển thị giao diện người dùng mềm mại hơn. + +--- + +## Bước 3: Cấu hình Markdown Save Options với Callback lưu tài nguyên + +Đây là nơi phép thuật của **how to use callback** xuất hiện. Callback cho phép bạn quyết định nơi mỗi hình ảnh được trích xuất sẽ được lưu. + +```csharp +// Prepare Markdown save options and attach a custom resource‑saving callback +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + ResourceSavingCallback = new MyResourceSaver() +}; +``` + +> **Tại sao cần callback?** Mặc định Aspose sẽ nhúng hình ảnh dưới dạng chuỗi base‑64 trong markdown — một cơn ác mộng cho hệ thống kiểm soát phiên bản. Callback cho bạn toàn quyền kiểm soát tên tệp và cấu trúc thư mục. + +--- + +## Bước 4: Lưu tài liệu dưới dạng Markdown + +Bây giờ chúng ta thực sự tạo ra tệp `.md`. Tất cả hình ảnh sẽ được chuyển cho callback được định nghĩa ở bước tiếp theo. + +```csharp +// Save the document as Markdown; images will be processed by the callback +sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); +``` + +Nếu mọi thứ diễn ra suôn sẻ, bạn sẽ thấy `Document.md` trong thư mục đích và một thư mục con tên `Resources` chứa mọi hình ảnh đã được trích xuất từ tệp Word gốc. + +--- + +## Bước 5: Triển khai Callback lưu từng hình ảnh đã trích xuất + +Dưới đây là triển khai đầy đủ của `MyResourceSaver`. Nó tạo thư mục `Resources` (nếu chưa tồn tại), tạo tên tệp duy nhất cho mỗi hình ảnh và ghi luồng hình ảnh ra đĩa. + +```csharp +// Define the callback that stores each extracted image in a sub‑folder +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // 1️⃣ Ensure the resources folder exists + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + // 2️⃣ Build a unique file name for each image (e.g., img_0.png) + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + + // 3️⃣ Provide a stream that writes the image to the target file + string fullPath = Path.Combine(resourceFolder, imageFileName); + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; // close the stream after saving + } +} +``` + +> **Giải thích các đối số:** +> - `args.Index` – bộ đếm bắt đầu từ 0, đảm bảo tính duy nhất. +> - `args.FileName` – tên tệp gốc mà Aspose đề xuất (thường là `image001.png`). +> - `args.Stream` – luồng đầu ra nơi các byte hình ảnh được ghi. +> - `args.KeepResourceStreamOpen` – đặt `false` để Aspose tự động giải phóng luồng, ngăn rò rỉ handle tệp. + +--- + +## Ví dụ hoàn chỉnh hoạt động + +Kết hợp mọi thứ lại, đây là một tệp duy nhất bạn có thể sao chép‑dán vào `Program.cs`. Nhớ thay `YOUR_DIRECTORY` bằng đường dẫn tuyệt đối hoặc tương đối phù hợp với môi trường của bạn. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; +using System.IO; + +namespace WordToMarkdown +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source docx + Document sourceDocument = new Document("YOUR_DIRECTORY/input.docx"); + + // 2️⃣ Set up markdown options with our callback + MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions + { + ResourceSavingCallback = new MyResourceSaver() + }; + + // 3️⃣ Save as markdown – images will be extracted automatically + sourceDocument.Save("YOUR_DIRECTORY/Document.md", markdownOptions); + + System.Console.WriteLine("✅ Conversion complete! Check the Resources folder for images."); + } + } + + // 4️⃣ Callback implementation (see detailed version above) + class MyResourceSaver : IResourceSavingCallback + { + public void ResourceSaving(ResourceSavingArgs args) + { + string resourceFolder = "YOUR_DIRECTORY/Resources"; + Directory.CreateDirectory(resourceFolder); + + string imageFileName = $"img_{args.Index}{Path.GetExtension(args.FileName)}"; + string fullPath = Path.Combine(resourceFolder, imageFileName); + + args.Stream = new FileStream(fullPath, FileMode.Create); + args.KeepResourceStreamOpen = false; + } + } +} +``` + +### Kết quả mong đợi + +- `YOUR_DIRECTORY/Document.md` – tệp markdown với các liên kết hình ảnh chuẩn, ví dụ: + + ```markdown + ![Image 1](Resources/img_0.png) + ``` + +- `YOUR_DIRECTORY/Resources/` – chứa `img_0.png`, `img_1.jpg`, v.v., theo thứ tự chúng xuất hiện trong tài liệu Word gốc. + +Chạy chương trình sẽ in ra một thông báo xác nhận thân thiện, cho biết quá trình đã thành công. + +--- + +## Câu hỏi thường gặp (FAQ) + +### Làm sao để trích xuất hình ảnh từ Word mà không mất chất lượng? + +Callback ghi trực tiếp luồng nhị phân gốc vào tệp, giữ nguyên độ phân giải ban đầu. Không có quá trình chuyển đổi hay nén nào xảy ra trừ khi bạn tự thêm logic xử lý ảnh trong `ResourceSaving`. + +### Tôi có thể thay đổi định dạng ảnh (ví dụ PNG → JPEG) khi trích xuất không? + +Chắc chắn. Trong `ResourceSaving` bạn có thể kiểm tra `args.FileName` hoặc `args.Stream`, tải ảnh bằng `System.Drawing` hoặc `ImageSharp`, sau đó mã hóa lại trước khi ghi. Đừng quên cập nhật phần mở rộng trong liên kết markdown cho phù hợp. + +### Nếu tôi muốn các tệp markdown tham chiếu tới CDN thay vì thư mục cục bộ thì sao? + +Sửa callback để thêm URL cơ sở vào liên kết markdown. Bạn có thể thực hiện bằng cách đặt `args.FileName` thành URL đầy đủ sau khi tải ảnh lên CDN của mình. + +### Phương pháp này có hoạt động với bảng, chú thích chân trang hoặc các tính năng Word nâng cao khác không? + +Có. Aspose.Words chuyển đổi hầu hết các cấu trúc Word sang các tương đương markdown. Bảng trở thành bảng markdown, chú thích chân trang thành liên kết tham chiếu, và ngay cả danh sách lồng nhau cũng được xử lý một cách mượt mà. Nếu có gì không ổn, hãy kiểm tra ghi chú phát hành mới nhất — Aspose luôn cải thiện độ chính xác chuyển đổi. + +### Làm sao chuyển đổi docx sang markdown trong pipeline CI/CD? + +Chỉ cần thêm tệp `.exe` đã biên dịch vào các bước build, chỉ định nó tới các tệp `.docx` được tạo ra, và đẩy các tệp `.md` và thư mục `Resources/` vào kho site tĩnh của bạn. Vì quá trình hoàn toàn quyết định được, nó hoạt động tốt trong môi trường tự động. + +--- + +## Kết luận + +Chúng ta vừa minh họa cách **tạo markdown từ Word** bằng Aspose.Words, bao quát toàn bộ quy trình **convert docx to markdown**, và trình bày cách thực tiễn để **extract images from Word** với một triển khai **how to use callback** tùy chỉnh. Kết quả là một tệp markdown sạch sẽ kèm theo thư mục chứa các hình ảnh gốc — hoàn hảo cho các trang tài liệu, blog tĩnh, hoặc bất kỳ quy trình nào ưu tiên định dạng văn bản thuần. + +Các bước tiếp theo bạn có thể cân nhắc: + +- **Xử lý hàng loạt** nhiều tệp `.docx` trong một thư mục (vòng lặp `Directory.GetFiles`). +- **Lược đồ đặt tên tùy chỉnh** cho ảnh (ví dụ, dùng văn bản chú thích gốc). +- **Xử lý hậu kỳ** markdown để thay thế liên kết ảnh bằng URL CDN. +- Khám phá **các định dạng xuất khẩu Aspose khác** như HTML, PDF, hoặc EPUB cho việc xuất bản đa kênh. + +Có thêm câu hỏi hoặc tệp Word khó chịu không chuyển đổi? Hãy để lại bình luận bên dưới, chúng ta sẽ cùng giải quyết. Chúc lập trình vui vẻ và tận hưởng sự đơn giản khi biến Word thành markdown! + +--- + +![Sơ đồ cho quá trình chuyển đổi Word sang Markdown](image.png "Sơ đồ tạo markdown từ Word") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/vietnamese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md b/words/vietnamese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md new file mode 100644 index 0000000000..ac2a90e1d3 --- /dev/null +++ b/words/vietnamese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/_index.md @@ -0,0 +1,265 @@ +--- +category: general +date: 2026-03-27 +description: Cách xuất LaTeX từ DOCX bằng Aspose.Words. Tìm hiểu cách chuyển DOCX + sang Markdown, thiết lập DPI và bật chế độ khôi phục trong C#. +draft: false +keywords: +- how to export latex +- convert docx to markdown +- how to convert docx +- how to set dpi +- how to enable recovery +language: vi +og_description: Cách xuất LaTeX từ DOCX bằng Aspose.Words. Hướng dẫn này trình bày + quá trình chuyển đổi sang Markdown từng bước, kiểm soát DPI và chế độ khôi phục. +og_title: Cách xuất LaTeX từ DOCX – Chuyển sang Markdown +tags: +- Aspose.Words +- C# +- Document Conversion +title: Cách xuất LaTeX từ DOCX – Chuyển sang Markdown +url: /vi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-docx-convert-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách Xuất LaTeX từ DOCX – Chuyển Đổi Sang Markdown + +Bạn đã bao giờ tự hỏi **cách xuất LaTeX** từ một tệp DOCX mà không làm mất đi vẻ đẹp của các công thức chưa? Bạn không phải là người duy nhất. Theo kinh nghiệm của tôi, vấn đề khó nhất là đưa các đối tượng OfficeMath vào một định dạng sạch, có thể di động cho các trình tạo site tĩnh hoặc blog khoa học. + +Trong hướng dẫn này, chúng ta sẽ đi qua quy trình chuyển DOCX sang Markdown bằng Aspose.Words, đồng thời chỉ ra **cách đặt DPI**, **cách bật chế độ phục hồi**, và một vài mẹo hữu ích để có một pipeline vững chắc. Khi kết thúc, bạn sẽ có một chương trình C# duy nhất tạo ra tệp Markdown chứa các công thức LaTeX, hình ảnh độ phân giải cao và xử lý siêu liên kết đúng cách. + +## Những Gì Bạn Cần Chuẩn Bị + +- **.NET 6+** (hoặc .NET Framework 4.7.2 – API hoạt động tương tự) +- **Aspose.Words for .NET** (phiên bản ổn định mới nhất tính đến tháng 3 2026) +- Một tệp DOCX có chứa công thức, hình ảnh và liên kết +- Visual Studio, VS Code, hoặc bất kỳ trình soạn thảo nào bạn thích + +Không cần thêm gói NuGet nào ngoài Aspose.Words, nhưng hãy chắc chắn bạn có giấy phép hợp lệ nếu không dùng bản dùng thử. + +## Bước 1 – Tải DOCX với Chế Độ Phục Hồi Nghiêm Ngặt + +Trước khi nghĩ tới việc xuất, chúng ta phải chắc chắn tài liệu nguồn không ẩn lỗi hỏng. Đó là lúc **cách bật chế độ phục hồi** trở nên quan trọng. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// LoadOptions lets us control the recovery behavior +LoadOptions loadOptions = new LoadOptions +{ + // Strict mode will throw an exception the moment the file is malformed. + // This “fail fast” approach prevents silent data loss. + RecoveryMode = RecoveryMode.Strict +}; + +Document doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); +``` + +**Tại sao lại dùng chế độ phục hồi nghiêm ngặt?** +Nếu để Aspose tự động sửa lỗi, bạn có thể gặp trường hợp mất đoạn văn hoặc hình ảnh bị hỏng — điều mà không ai muốn khi xuất LaTeX. Bằng cách dừng ngay khi gặp lỗi, bạn có thể phát hiện sớm và quyết định sửa DOCX nguồn hoặc ghi lại vấn đề để xử lý sau. + +### Mẹo chuyên nghiệp +Bao bọc lệnh tải trong khối `try/catch` và ghi lại `DocumentLoadingException`. Nhờ vậy pipeline CI của bạn có thể đánh dấu các tệp có vấn đề mà không làm dừng toàn bộ quá trình build. + +## Bước 2 – Chuẩn Bị Các Tùy Chọn Xuất Markdown + +Bây giờ tài liệu đã an toàn trong bộ nhớ, chúng ta cấu hình cách lưu. Đây là phần cốt lõi của **cách xuất latex** và cũng bao gồm **cách đặt DPI** cho các hình ảnh nhúng. + +```csharp +// Custom resource saver – we’ll explain it in Step 3 +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + // Save each resource (image, video, etc.) to a folder called "resources" + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string fileName = Path.Combine(folder, args.ResourceFileName); + args.Stream.CopyTo(File.Create(fileName)); + // Update the link in the Markdown to point to the saved file + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +// Configure MarkdownSaveOptions +MarkdownSaveOptions markdownOptions = new MarkdownSaveOptions +{ + // Export OfficeMath objects as LaTeX – the core of “how to export latex” + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Render all images at 300 dpi – satisfies “how to set dpi” + ImageResolution = 300, + + // Hook in our custom resource saver + ResourceSavingCallback = new MyResourceSaver(), + + // Empty paragraphs become empty lines – keeps Markdown tidy + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + + // Hyperlinks are written as reference-style links (easier to read) + LinkExportMode = LinkExportMode.AsReference +}; +``` + +**Mô tả từng tùy chọn** + +| Tùy chọn | Lý do | Mối quan hệ với từ khóa | +|----------|-------|--------------------------| +| `OfficeMathExportMode = LaTeX` | Trực tiếp trả lời **cách xuất latex** từ các công thức. | Từ khóa chính | +| `ImageResolution = 300` | Điều chỉnh chất lượng hình ảnh – đáp án cho **cách đặt dpi**. | Phụ | +| `ResourceSavingCallback` | Lưu các tệp nhúng vào đĩa, nhu cầu phổ biến khi **convert docx to markdown**. | Phụ | +| `EmptyParagraphExportMode` | Đảm bảo đầu ra Markdown sạch sẽ, tránh các thẻ HTML lẻ. | Cải thiện chất lượng chuyển đổi tổng thể | +| `LinkExportMode = AsReference` | Giúp các liên kết dễ đọc và chỉnh sửa, một lợi thế khác cho **convert docx to markdown**. | + +## Bước 3 – Triển Khai Bộ Lưu Trữ Tài Nguyên Tùy Chỉnh (Tùy Chọn nhưng Hữu Ích) + +Khi bạn chuyển DOCX sang Markdown, hình ảnh và các tài nguyên nhị phân khác cần một vị trí trên hệ thống tệp. Aspose cho phép bạn kiểm soát điều này bằng `IResourceSavingCallback`. Đoạn mã trên đã minh họa một triển khai tối thiểu, nhưng hãy cùng phân tích: + +```csharp +public void ResourceSaving(ResourceSavingArgs args) +{ + // 1️⃣ Build a safe folder path + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + + // 2️⃣ Combine folder + original file name + string filePath = Path.Combine(folder, args.ResourceFileName); + + // 3️⃣ Write the stream to disk + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + + // 4️⃣ Update the Markdown link to the relative path + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); +} +``` + +**Tại sao lại cần?** +Nếu bỏ qua bước này, Aspose sẽ nhúng hình ảnh dưới dạng chuỗi base‑64, làm tăng kích thước tệp Markdown và gây khó khăn cho việc kiểm soát phiên bản. Bằng cách lưu tài nguyên vào thư mục riêng, bạn giữ Markdown nhẹ và thân thiện với các trình tạo site tĩnh như Hugo hoặc Jekyll. + +## Bước 4 – Lưu Tài Liệu Dưới Dạng Markdown + +Mọi công việc nặng đã xong. Chỉ còn một dòng lệnh để ghi tệp cuối cùng. + +```csharp +doc.Save("YOUR_DIRECTORY/output.md", markdownOptions); +Console.WriteLine("✅ Conversion complete! Check YOUR_DIRECTORY/output.md"); +``` + +Mở `output.md` và bạn sẽ thấy: + +- Các công thức được hiển thị dưới dạng khối LaTeX `$…$` +- Hình ảnh được tham chiếu như `![Alt text](resources/image001.png)` với độ phân giải 300 dpi +- Siêu liên kết chuyển thành dạng tham chiếu: + ```markdown + Here is a link to the [Aspose site][1]. + + [1]: https://www.aspose.com + ``` + +Đó là toàn bộ quy trình **cách chuyển docx** trong một cái nhìn tổng quan. + +## Các Câu Hỏi Thường Gặp & Trường Hợp Đặc Biệt + +### 1️⃣ Nếu DOCX chứa các đối tượng không được hỗ trợ thì sao? +Aspose.Words sẽ ném ra `FeatureNotSupportedException`. Vì chúng ta đã dùng **cách bật chế độ phục hồi** ở chế độ nghiêm ngặt, ngoại lệ sẽ xuất hiện ngay lập tức. Bạn có thể: + +- Chuyển `RecoveryMode` sang `RecoveryMode.Default` để thực hiện chuyển đổi cố gắng hết mức, **hoặc** +- Tiền xử lý DOCX (ví dụ, loại bỏ SmartArt không hỗ trợ) trước khi chạy bộ chuyển đổi. + +### 2️⃣ Có thể thay đổi DPI cho từng hình ảnh không? +Cài đặt `ImageResolution` là toàn cục. Để kiểm soát từng hình, hãy triển khai một `ImageSavingCallback` tùy chỉnh tương tự `MyResourceSaver` và điều chỉnh `args.ImageResolution` dựa trên `args.ImageFileName` hoặc siêu dữ liệu. + +### 3️⃣ Làm sao nhúng LaTeX đã tạo vào site Jekyll? +Jekyll có hỗ trợ MathJax tích hợp sẵn, hoạt động ngay. Chỉ cần chắc chắn layout của bạn bao gồm script MathJax và các khối LaTeX được bao quanh bởi `$$` cho công thức hiển thị hoặc `$` cho dạng nội tuyến. + +### 4️⃣ Có tương thích với .NET Core trên Linux không? +Hoàn toàn có. Aspose.Words đa nền tảng. Chỉ cần đảm bảo đường dẫn `YOUR_DIRECTORY` tuân theo quy tắc Linux (ví dụ, `/home/user/docs`). + +## Ví Dụ Hoàn Chỉnh Hoạt Động + +Dưới đây là chương trình sẵn sàng sao chép‑dán. Thay `YOUR_DIRECTORY` bằng đường dẫn thực tế trên máy của bạn. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class MyResourceSaver : IResourceSavingCallback +{ + public void ResourceSaving(ResourceSavingArgs args) + { + string folder = Path.Combine("YOUR_DIRECTORY", "resources"); + Directory.CreateDirectory(folder); + string filePath = Path.Combine(folder, args.ResourceFileName); + using (FileStream file = File.Create(filePath)) + args.Stream.CopyTo(file); + args.ResourceFileName = Path.Combine("resources", args.ResourceFileName); + } +} + +class Program +{ + static void Main() + { + // 1️⃣ Load with strict recovery – how to enable recovery + LoadOptions loadOptions = new LoadOptions { RecoveryMode = RecoveryMode.Strict }; + Document doc; + try + { + doc = new Document("YOUR_DIRECTORY/input.docx", loadOptions); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Failed to load DOCX: {ex.Message}"); + return; + } + + // 2️⃣ Configure export – how to export latex, how to set dpi + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ImageResolution = 300, + ResourceSavingCallback = new MyResourceSaver(), + EmptyParagraphExportMode = MarkdownEmptyParagraphExportMode.EmptyLine, + LinkExportMode = LinkExportMode.AsReference + }; + + // 3️⃣ Save – how to convert docx to markdown + string outputPath = Path.Combine("YOUR_DIRECTORY", "output.md"); + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown saved to {outputPath}"); + } +} +``` + +**Kết quả mong đợi** – mở `output.md` và bạn sẽ thấy nội dung tương tự: + +```markdown +# Sample Document + +This is a paragraph with an equation: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ + +![Chart](resources/image001.png) + +Here is a link to the [Aspose site][1]. + +[1]: https://www.aspose.com +``` + +Nếu bạn mở tệp trong trình xem Markdown hỗ trợ MathJax, tích phân sẽ được hiển thị đúng. + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/vietnamese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md b/words/vietnamese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md new file mode 100644 index 0000000000..d466dbd1f8 --- /dev/null +++ b/words/vietnamese/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-03-27 +description: Cách xuất LaTeX từ tài liệu Word bằng Aspose.Words – chuyển DOCX sang + Markdown với các phương trình dưới dạng LaTeX. +draft: false +keywords: +- how to export latex +- convert word to markdown +- how to convert docx +- save word as markdown +- export equations as latex +language: vi +og_description: Cách xuất LaTeX từ tài liệu Word được giải thích trong câu đầu tiên, + cho bạn thấy cách chuyển DOCX sang Markdown với các phương trình dưới dạng LaTeX. +og_title: Cách xuất LaTeX từ Word – Hướng dẫn đầy đủ +tags: +- Aspose.Words +- C# +- Markdown +- LaTeX +title: Cách xuất LaTeX từ Word – Chuyển DOCX sang Markdown +url: /vi/net/programming-with-markdownsaveoptions/how-to-export-latex-from-word-convert-docx-to-markdown/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách Xuất LaTeX từ Word – Chuyển DOCX sang Markdown + +Bạn đã bao giờ tự hỏi **cách xuất LaTeX** từ một tệp Word mà không nhận được một loạt các PNG chưa? Bạn không phải là người duy nhất; các nhà phát triển thường gặp khó khăn này khi cần các công thức sạch, có thể chỉnh sửa cho các trang tĩnh hoặc blog khoa học. Tin tốt là gì? Với Aspose.Words bạn có thể **chuyển Word sang Markdown** và giữ mọi đối tượng OfficeMath dưới dạng LaTeX gốc—không cần xử lý hậu kỳ. + +Trong hướng dẫn này, chúng ta sẽ đi qua toàn bộ quy trình **lưu tài liệu Word dưới dạng Markdown** đồng thời **xuất công thức dưới dạng LaTeX**. Khi kết thúc, bạn sẽ có một đoạn mã C# có thể chạy, giải thích rõ ràng từng tùy chọn, và các mẹo xử lý các trường hợp đặc biệt như công thức phức tạp hoặc nội dung hỗn hợp. Không cần công cụ bên ngoài, chỉ một gói NuGet và vài dòng mã. + +## Những Điều Bạn Cần Có + +- .NET 6+ (hoặc .NET Framework 4.7.2 trở lên) – môi trường runtime mới nhất hoạt động tốt nhất. +- Visual Studio 2022 hoặc bất kỳ trình soạn thảo nào có thể biên dịch dự án C#. +- Giấy phép Aspose.Words for .NET (bản dùng thử miễn phí đủ cho việc thử nghiệm). +- Một tệp DOCX chứa ít nhất một công thức (OfficeMath). + +Nếu bạn đã có những thứ trên, tuyệt vời—hãy bắt đầu. + +## Cách Xuất LaTeX từ Word – Tổng Quan + +Dưới đây là cái nhìn tổng thể về các bước thực hiện: + +1. **Cài đặt** gói NuGet Aspose.Words. +2. **Tải** tệp `.docx` nguồn chứa các công thức của bạn. +3. **Cấu hình** `MarkdownSaveOptions` sao cho `OfficeMathExportMode` được đặt thành `LaTeX`. +4. **Lưu** tài liệu dưới dạng tệp `.md`. +5. **Xác minh** rằng Markdown đã tạo chứa các khối LaTeX (`$$…$$`). + +Mỗi bước sẽ được giải thích chi tiết trong các phần sau. + +![Biểu đồ mô tả luồng chuyển đổi từ DOCX sang Markdown với các công thức LaTeX](how-to-export-latex.png){alt="Biểu đồ cách xuất latex từ Word"} + +## Bước 1 – Cài Đặt Aspose.Words cho .NET (chuyển word sang markdown) + +Điều đầu tiên cần làm: bạn cần thư viện thực hiện công việc nặng. Mở terminal (hoặc Package Manager Console) và chạy: + +```bash +dotnet add package Aspose.Words --version 24.10 +``` + +> **Mẹo:** Nếu bạn đang dùng Visual Studio, nhấp chuột phải vào dự án → *Manage NuGet Packages* → tìm “Aspose.Words” và cài đặt phiên bản ổn định mới nhất. + +Tại sao lại quan trọng: Aspose.Words trừu tượng hoá định dạng Open XML, cung cấp API sạch để thao tác tài liệu Word mà không phải lo về XML cấp thấp. Nó cũng tích hợp sẵn hỗ trợ chuyển OfficeMath sang LaTeX, đây là trọng tâm của yêu cầu **xuất công thức dưới dạng LaTeX** của chúng ta. + +## Bước 2 – Tải DOCX (cách chuyển đổi docx) + +Bây giờ gói đã sẵn sàng, hãy tải tệp bạn muốn chuyển đổi. Thay `YOUR_DIRECTORY` bằng đường dẫn tới thư mục chứa `.docx` của bạn: + +```csharp +using Aspose.Words; + +// Step 2: Load the source Word document containing equations +Document doc = new Document(@"C:\Projects\MyDocs\input.docx"); +``` + +> **Tại sao lại tải theo cách này?** Hàm khởi tạo `Document` phân tích toàn bộ tệp thành mô hình đối tượng, cho bạn truy cập ngay vào các đoạn văn, bảng và—quan trọng nhất—các đối tượng OfficeMath. Nếu tệp bị thiếu hoặc hỏng, Aspose sẽ ném ra ngoại lệ `FileNotFoundException` mô tả chi tiết, bạn có thể bắt để xử lý lỗi một cách nhẹ nhàng. + +## Bước 3 – Cấu Hình MarkdownSaveOptions (xuất công thức dưới dạng latex) + +Phép màu xảy ra trong đối tượng `MarkdownSaveOptions`. Mặc định Aspose sẽ render công thức dưới dạng ảnh PNG, nhưng chúng ta muốn LaTeX. Đặt `OfficeMathExportMode` thành `LaTeX`: + +```csharp +using Aspose.Words.Saving; + +// Step 3: Configure Markdown save options to export OfficeMath as LaTeX +MarkdownSaveOptions mdOptions = new MarkdownSaveOptions +{ + // Export equations as LaTeX instead of images + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: keep original line breaks for better diff‑friendly output + ExportImagesAsBase64 = false, + ExportHeadersFooters = true +}; +``` + +Một lưu ý nhanh về các cờ tùy chọn: `ExportImagesAsBase64` báo cho Aspose không nhúng dữ liệu nhị phân, giúp Markdown sạch hơn. `ExportHeadersFooters` đảm bảo bạn không mất bất kỳ ngữ cảnh nào nằm trong phần đầu/footer—hữu ích khi header chứa tiêu đề hoặc tên tác giả. + +## Bước 4 – Lưu Tài Liệu (lưu word dưới dạng markdown) + +Cuối cùng, ghi nội dung đã chuyển đổi vào tệp `.md`: + +```csharp +// Step 4: Save the document as a Markdown file using the configured options +doc.Save(@"C:\Projects\MyDocs\output.md", mdOptions); +``` + +Sau khi dòng lệnh này chạy, bạn sẽ thấy `output.md` nằm cạnh tệp nguồn. Mở nó bằng bất kỳ trình soạn thảo văn bản nào và bạn sẽ thấy các khối LaTeX trông như sau: + +```markdown +Here is an inline equation $E = mc^2$. + +And a displayed formula: + +$$ +\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} +$$ +``` + +Đó là phần **lưu word dưới dạng markdown** đã hoàn thành—không cần bước chuyển đổi bổ sung. + +## Bước 5 – Xác Minh Kết Quả (xuất công thức dưới dạng latex) + +Dễ dàng bỏ qua việc xác minh, nhưng một kiểm tra nhanh sẽ tiết kiệm hàng giờ sau này. Chạy một script đơn giản đọc tệp đã tạo và in ra khối LaTeX đầu tiên: + +```csharp +string markdown = File.ReadAllText(@"C:\Projects\MyDocs\output.md"); +var firstLatex = System.Text.RegularExpressions.Regex.Match(markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); +Console.WriteLine(firstLatex.Success ? $"First LaTeX block: {firstLatex.Value}" : "No LaTeX found."); +``` + +Nếu bạn thấy `First LaTeX block: $$ … $$` được in ra, bạn đã **xuất LaTeX** từ Word thành công. Nếu không, hãy kiểm tra lại tài liệu nguồn xem có thực sự chứa các đối tượng OfficeMath không; các công thức dạng văn bản thường sẽ không được chuyển đổi. + +## Xử Lý Các Trường Hợp Đặc Biệt Thường Gặp + +| Kịch bản | Điều Cần Lưu Ý | Giải Pháp Đề Xuất | +|----------|-------------------|-----------------| +| **Hỗn hợp ảnh & công thức** | Aspose có thể vẫn nhúng ảnh cho các đồ họa không phải OfficeMath. | Đặt `ExportImagesAsBase64 = false` và giữ ảnh dưới dạng tệp riêng, sau đó tham chiếu chúng thủ công trong Markdown. | +| **Công thức lồng nhau phức tạp** | Độ sâu lồng nhau quá lớn có thể tạo ra LaTeX cần chỉnh sửa thủ công. | Tiền xử lý khối bằng bộ định dạng LaTeX (ví dụ `latexindent`) hoặc điều chỉnh `mdOptions` → `ExportMathAsDisplay = true`. | +| **Tài liệu lớn** | Tiêu thụ bộ nhớ tăng mạnh khi tải các `.docx` khổng lồ. | Sử dụng `LoadOptions` với `LoadFormat.Docx` và bật streaming trong `LoadOptions` nếu có. | +| **Thiếu giấy phép** | Bản dùng thử miễn phí sẽ thêm chú thích watermark vào đầu ra. | Áp dụng giấy phép hợp lệ bằng `License license = new License(); license.SetLicense("Aspose.Words.lic");`. | + +Những mẹo này giúp quy trình của bạn ổn định, đặc biệt khi **chuyển word sang markdown** trong các pipeline sản xuất. + +## Ví Dụ Hoàn Chỉnh (Tất Cả Các Bước Trong Một File) + +Dưới đây là một ứng dụng console tự chứa mà bạn có thể sao chép‑dán vào dự án .NET mới và chạy ngay lập tức. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +namespace WordToMarkdownLaTeX +{ + class Program + { + static void Main() + { + // Optional: apply your Aspose.Words license here + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // 1️⃣ Load the DOCX that contains equations + string inputPath = @"C:\Projects\MyDocs\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure save options – this is where we **export equations as LaTeX** + MarkdownSaveOptions mdOptions = new MarkdownSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + ExportImagesAsBase64 = false, + ExportHeadersFooters = true + }; + + // 3️⃣ Save as Markdown + string outputPath = @"C:\Projects\MyDocs\output.md"; + doc.Save(outputPath, mdOptions); + Console.WriteLine($"✅ Markdown with LaTeX saved to: {outputPath}"); + + // 4️⃣ Quick verification – show the first LaTeX block + string markdown = File.ReadAllText(outputPath); + var match = System.Text.RegularExpressions.Regex.Match( + markdown, @"\$\$(.*?)\$\$", System.Text.RegularExpressions.RegexOptions.Singleline); + Console.WriteLine(match.Success + ? $"First LaTeX block found:\n{match.Value}" + : "No LaTeX blocks detected."); + } + } +} +``` + +Chạy chương trình, mở `output.md`, và bạn sẽ thấy các công thức được render dưới dạng LaTeX sạch sẽ. Đó là câu trả lời đầy đủ cho **cách xuất latex** từ tài liệu Word. + +## Kết Luận + +Chúng ta đã đi qua **cách xuất LaTeX** từ Word từng bước, cho bạn biết cách **chuyển Word sang markdown**, **lưu word dưới dạng markdown**, và **xuất công thức dưới dạng LaTeX** bằng Aspose.Words. Ý tưởng cốt lõi rất đơn giản: tải DOCX, tinh chỉnh `MarkdownSaveOptions`, và để thư viện thực hiện phần còn lại. + +Nếu bạn muốn tự động hoá quy trình tài liệu, hãy thử kết hợp đoạn mã này với một static‑site generator như Hugo hoặc Jekyll—chỉ cần đẩy các tệp `.md` đã tạo lên repo và để site tự build lại. Để đọc thêm, khám phá hướng dẫn “Export to LaTeX” của Aspose, thử nghiệm `HtmlSaveOptions` để xem trước trên web, hoặc tìm hiểu API `DocumentVisitor` để tùy biến chuyển đổi. + +Có câu hỏi về các trường hợp đặc biệt, giấy phép, hoặc tích hợp vào CI/CD? Hãy để lại bình luận bên dưới, và chúc bạn coding vui vẻ! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/vietnamese/net/programming-with-pdfsaveoptions/_index.md b/words/vietnamese/net/programming-with-pdfsaveoptions/_index.md index bb947111d1..cded470acf 100644 --- a/words/vietnamese/net/programming-with-pdfsaveoptions/_index.md +++ b/words/vietnamese/net/programming-with-pdfsaveoptions/_index.md @@ -45,6 +45,7 @@ Cho dù bạn muốn chuyển đổi tài liệu Word sang PDF để phân phố | [Cập nhật Thuộc tính được In Lần cuối trong Tài liệu PDF](./update-last-printed-property/) | Tìm hiểu cách cập nhật thuộc tính in cuối cùng trong tài liệu PDF bằng Aspose.Words cho .NET với hướng dẫn từng bước của chúng tôi. | | [Kết xuất 3D DML 3DEffects trong Tài liệu PDF](./dml-3deffects-rendering/) | Tìm hiểu cách tạo hiệu ứng DML 3D tuyệt đẹp trong tài liệu PDF bằng Aspose.Words cho .NET với hướng dẫn từng bước toàn diện này. | | [Chèn hình ảnh vào tài liệu PDF](./interpolate-images/) | Tìm hiểu cách chèn hình ảnh vào tài liệu PDF bằng Aspose.Words cho .NET với hướng dẫn từng bước của chúng tôi. Cải thiện chất lượng hình ảnh PDF của bạn một cách dễ dàng. | +| [Cách lưu PDF từ DOCX bằng Aspose.Words – Hướng dẫn từng bước](./how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/) | Hướng dẫn chi tiết cách chuyển đổi tài liệu DOCX sang PDF bằng Aspose.Words cho .NET qua các bước thực tế. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/vietnamese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md b/words/vietnamese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md new file mode 100644 index 0000000000..c2e1d145a5 --- /dev/null +++ b/words/vietnamese/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-03-27 +description: Tìm hiểu cách lưu PDF từ tệp DOCX bằng Aspose.Words. Bao gồm chuyển đổi + DOCX sang PDF, lưu PDF với các tùy chọn và xử lý các hình dạng nổi. +draft: false +keywords: +- how to save pdf +- convert docx to pdf +- how to convert docx +- convert word document pdf +- save pdf with options +language: vi +og_description: Cách lưu PDF từ tệp DOCX bằng Aspose.Words. Hướng dẫn này cho thấy + cách chuyển DOCX sang PDF, lưu PDF với các tùy chọn và xử lý các hình dạng nổi. +og_title: Cách lưu PDF từ DOCX – Hướng dẫn đầy đủ Aspose.Words +tags: +- Aspose.Words +- C# +- PDF conversion +title: Cách lưu PDF từ DOCX bằng Aspose.Words – Hướng dẫn từng bước +url: /vi/net/programming-with-pdfsaveoptions/how-to-save-pdf-from-docx-with-aspose-words-step-by-step-gui/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách Lưu PDF từ DOCX bằng Aspose.Words – Hướng Dẫn Đầy Đủ + +Bạn đã bao giờ tự hỏi **cách lưu PDF** từ một tài liệu Word mà không làm mất bố cục của các hình dạng nổi chưa? Bạn không phải là người duy nhất. Trong nhiều dự án—trình tạo hoá đơn, xuất báo cáo, hoặc lưu trữ tài liệu đơn giản—các nhà phát triển cần một cách đáng tin cậy để chuyển đổi DOCX sang PDF đồng thời giữ mọi thứ trông giống hệt như trong Word. + +Trong hướng dẫn này, chúng ta sẽ đi qua quy trình chuyển đổi tệp DOCX sang PDF **bằng Aspose.Words for .NET**, chỉ cho bạn **cách chuyển docx sang pdf** với các tùy chọn lưu tùy chỉnh, và giải thích tại sao cờ `ExportFloatingShapesAsInlineTag` lại quan trọng. Khi kết thúc, bạn sẽ có một đoạn mã sẵn sàng chạy để lưu PDF với các tùy chọn bạn kiểm soát. + +## Những Điều Bạn Sẽ Học + +- Các bước chính xác để **chuyển đổi word document pdf** bằng Aspose.Words. +- Cách cấu hình `PdfSaveOptions` để xử lý các hình dạng nổi như các thẻ inline. +- Những bẫy thường gặp khi làm việc với các đối tượng nổi và cách tránh chúng. +- Một chương trình C# hoàn chỉnh, có thể chạy được mà bạn có thể đưa vào bất kỳ dự án .NET nào. + +> **Yêu cầu trước:** Bạn cần có giấy phép Aspose.Words for .NET (hoặc bản đánh giá miễn phí) và môi trường phát triển .NET (Visual Studio, Rider, hoặc CLI `dotnet`). + +## Bước 1: Thiết Lập Dự Án và Thêm Aspose.Words + +Đầu tiên, tạo một ứng dụng console mới (hoặc thêm vào một dự án hiện có) và tham chiếu gói NuGet Aspose.Words. + +```bash +dotnet new console -n DocxToPdfDemo +cd DocxToPdfDemo +dotnet add package Aspose.Words +``` + +> **Mẹo chuyên nghiệp:** Nếu bạn đang chạy trên máy CI, hãy cố định phiên bản gói (`Aspose.Words --version 24.10`) để đảm bảo các bản dựng có thể tái tạo được. + +## Bước 2: Tải DOCX Chứa Các Hình Nổi + +Các hình ảnh, hộp văn bản, hoặc SmartArt nổi có thể gây dịch chuyển bố cục khi chuyển đổi. Việc tải tài liệu rất đơn giản, nhưng chúng ta cũng sẽ kiểm tra xem tệp có tồn tại hay không để tránh `FileNotFoundException` lúc chạy. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); +``` + +Lưu ý các câu lệnh `Console.WriteLine`—chúng cung cấp phản hồi nhanh khi bạn chạy ứng dụng từ terminal. + +## Bước 3: Cấu Hình Tùy Chọn Lưu PDF (Save PDF with Options) + +Đây là nơi phép thuật xảy ra. Mặc định, Aspose.Words cố gắng giữ nguyên các đối tượng nổi như chúng xuất hiện, điều này có thể làm hỏng bố cục trong PDF kết quả. Đặt `ExportFloatingShapesAsInlineTag` thành `true` sẽ yêu cầu thư viện xử lý các hình dạng đó như các thẻ inline, đảm bảo chúng được neo vào văn bản xung quanh. + +```csharp + // Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true, + // Optional: you can also tweak image quality or compliance level here + // ImageCompression = PdfImageCompression.Jpeg, + // Compliance = PdfCompliance.PdfA1b + }; + Console.WriteLine("⚙️ PDF save options configured."); +``` + +Tại sao điều này lại quan trọng? Hãy tưởng tượng một hộp văn bản lơ lửng trên một đoạn văn. Nếu không chuyển đổi sang thẻ inline, PDF có thể đẩy đoạn văn xuống hoặc cắt bỏ hoàn toàn hộp. Cờ này giữ nguyên mối quan hệ trực quan—một chi tiết tinh tế nhưng then chốt cho các báo cáo chuyên nghiệp. + +## Bước 4: Lưu Tài Liệu dưới Dạng PDF + +Bây giờ chúng ta thực sự ghi tệp PDF. Phương thức `Save` nhận cả đường dẫn đầu ra và các tùy chọn mà chúng ta vừa thiết lập. + +```csharp + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +Chạy chương trình sẽ tạo ra `output.pdf` trong cùng thư mục với tệp DOCX nguồn của bạn. Mở nó bằng bất kỳ trình xem PDF nào và bạn sẽ thấy tất cả các hình dạng nổi được hiển thị đúng vị trí của chúng. + +## Ví Dụ Hoàn Chỉnh + +Dưới đây là toàn bộ chương trình trong một khối. Sao chép‑dán vào `Program.cs` (hoặc bất kỳ tệp C# nào) và nhấn **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + string inputPath = @"YOUR_DIRECTORY\input.docx"; + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + + // Verify input file exists + if (!File.Exists(inputPath)) + { + Console.WriteLine($"❌ Input file not found: {inputPath}"); + return; + } + + // Step 1: Load the DOCX file that contains floating shapes + Document document = new Document(inputPath); + Console.WriteLine("✅ Document loaded successfully."); + + // Step 2: Create PDF save options and configure them to treat floating shapes as inline tags + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions + { + ExportFloatingShapesAsInlineTag = true + }; + Console.WriteLine("⚙️ PDF save options configured."); + + // Step 3: Save the document as a PDF using the configured options + document.Save(outputPath, pdfSaveOptions); + Console.WriteLine($"✅ PDF saved successfully to: {outputPath}"); + } +} +``` + +### Kết Quả Mong Đợi + +- **Tệp được tạo:** `output.pdf` trong thư mục đích. +- **Độ trung thực bố cục:** Các hình dạng nổi (hình ảnh, hộp văn bản, SmartArt) xuất hiện inline với văn bản xung quanh. +- **Không có ngoại lệ:** Chương trình kết thúc một cách êm ái, in các thông báo trạng thái ra console. + +## Câu Hỏi Thường Gặp & Các Trường Hợp Đặc Biệt + +| Câu hỏi | Trả lời | +|----------|--------| +| **Nếu tôi cần chất lượng hình ảnh cao hơn thì sao?** | Đặt `pdfSaveOptions.ImageCompression = PdfImageCompression.Jpeg; pdfSaveOptions.JpegQuality = 100;` | +| **Có thể chuyển đổi nhiều tệp DOCX cùng lúc không?** | Đặt logic tải/lưu trong vòng lặp `foreach (var file in Directory.GetFiles(..., "*.docx"))`. Hãy nhớ tái sử dụng một thể hiện `PdfSaveOptions` duy nhất để tăng hiệu suất. | +| **Điều này có hoạt động với .NET Core không?** | Hoàn toàn có. Aspose.Words 24.x hỗ trợ .NET Standard 2.0+, vì vậy bạn có thể chạy cùng một đoạn mã trên Windows, Linux hoặc macOS. | +| **Còn các tệp DOCX được bảo vệ bằng mật khẩu thì sao?** | Tải bằng `new Document(inputPath, new LoadOptions { Password = "mySecret" })`. Các `PdfSaveOptions` vẫn được áp dụng khi lưu. | +| **Việc chuyển đổi sang thẻ inline có an toàn với các bảng phức tạp không?** | Nói chung có, nhưng các bố cục bảng rất phức tạp với các hình dạng chồng lên nhau có thể vẫn cần điều chỉnh thủ công. Hãy thử nghiệm trên một mẫu đại diện trước khi thực hiện chuyển đổi hàng loạt. | + +## Mẹo Cho Các Dự Án Thực Tế + +- **Ghi log, không chỉ `Console.WriteLine`** – Trong môi trường production, thay thế đầu ra console bằng một framework ghi log (Serilog, NLog) để nắm bắt lỗi. +- **Giải phóng tài nguyên** – `Document` triển khai `IDisposable`. Bao nó trong khối `using` nếu bạn xử lý nhiều tệp để giải phóng bộ nhớ kịp thời. +- **Xác thực PDF** – Sử dụng công cụ kiểm tra PDF (ví dụ: bộ kiểm tra tuân thủ PDF/A) nếu bạn cần các tệp PDF chuẩn lưu trữ. +- **Xử lý song song** – Đối với khối lượng công việc lớn, cân nhắc `Parallel.ForEach` với `PdfSaveOptions` an toàn với luồng (tạo bản sao cho mỗi luồng) để tăng tốc chuyển đổi. + +## Kết Luận + +Chúng ta đã khám phá **cách lưu PDF** từ tệp DOCX bằng Aspose.Words, trình bày **cách chuyển docx sang pdf** với các tùy chọn tùy chỉnh, và giải thích tác động của `ExportFloatingShapesAsInlineTag`. Ví dụ hoàn chỉnh, có thể chạy được cho thấy bạn có thể **chuyển đổi word document pdf** chỉ trong vài dòng mã, và giờ bạn đã biết cách **lưu pdf với các tùy chọn** phù hợp với yêu cầu chất lượng và tuân thủ của dự án. + +Sẵn sàng cho thử thách tiếp theo? Hãy thử xuất sang các định dạng khác (ví dụ: HTML, EPUB) bằng `document.Save("output.html")`, hoặc thử nghiệm tuân thủ PDF/A cho việc lưu trữ lâu dài. Các nguyên tắc—tải, cấu hình tùy chọn, lưu—đều áp dụng cho mọi định dạng. + +Chúc lập trình vui vẻ, và hy vọng các PDF của bạn luôn hiển thị đúng như mong muốn! + +![Diagram illustrating how a DOCX file is loaded, options are applied, and a PDF is produced – how to save pdf](https://example.com/images/how-to-save-pdf-diagram.png "sơ đồ cách lưu pdf") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/vietnamese/net/programming-with-shapes/_index.md b/words/vietnamese/net/programming-with-shapes/_index.md index ce20cd8208..ba18459085 100644 --- a/words/vietnamese/net/programming-with-shapes/_index.md +++ b/words/vietnamese/net/programming-with-shapes/_index.md @@ -34,6 +34,7 @@ Bằng cách sử dụng Aspose.Words cho .NET và làm theo các hướng dẫn | [Phát hiện hình dạng nghệ thuật thông minh](./detect-smart-art-shape/) | Tìm hiểu cách phát hiện hình dạng SmartArt trong tài liệu Word bằng Aspose.Words cho .NET với hướng dẫn toàn diện này. Hoàn hảo để tự động hóa quy trình làm việc tài liệu của bạn. | | [Cập nhật Bản vẽ nghệ thuật thông minh](./update-smart-art-drawing/) | Tìm hiểu cách cập nhật bản vẽ Smart Art trong tài liệu Word bằng Aspose.Words cho .NET với hướng dẫn từng bước này. Đảm bảo hình ảnh của bạn luôn chính xác. | | [Tạo hình chữ nhật trong Word bằng Aspose.Words – Hướng dẫn từng bước](./create-rectangle-shape-in-word-with-aspose-words-step-by-ste/) | Tìm hiểu cách tạo hình chữ nhật trong tài liệu Word bằng Aspose.Words cho .NET qua hướng dẫn chi tiết từng bước. | +| [Tạo tài liệu Word C# – Thêm hình dạng có bóng](./create-word-document-c-add-shape-with-shadow/) | Tìm hiểu cách thêm hình dạng có bóng vào tài liệu Word bằng Aspose.Words cho .NET với hướng dẫn từng bước. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/vietnamese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md b/words/vietnamese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md new file mode 100644 index 0000000000..36fd623b62 --- /dev/null +++ b/words/vietnamese/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-03-27 +description: Tạo tài liệu Word bằng C# và học cách thêm hình dạng, áp dụng bóng cho + hình dạng và thiết lập khoảng cách bóng. Hướng dẫn chi tiết từng bước cho Aspose.Words. +draft: false +keywords: +- create word document c# +- how to add shape +- apply shadow to shape +- how to create rectangle +- set shadow distance +language: vi +og_description: Tạo tài liệu Word bằng C# với hình chữ nhật và bóng tùy chỉnh. Theo + dõi hướng dẫn đầy đủ này để thiết lập khoảng cách và kiểu bóng. +og_title: Tạo tài liệu Word C# – Thêm hình dạng có bóng +tags: +- Aspose.Words +- C# +- Document Automation +title: Tạo tài liệu Word C# – Thêm hình dạng có bóng +url: /vi/net/programming-with-shapes/create-word-document-c-add-shape-with-shadow/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Tạo tài liệu Word C# – Thêm hình dạng có bóng + +Bạn đã bao giờ cần **create word document c#** chứa một hình chữ nhật được thiết kế đẹp mắt chưa? Có thể bạn đang xây dựng một mẫu báo cáo và muốn có một bóng đổ nhẹ để làm nổi bật bố cục. Trong hướng dẫn này, chúng ta sẽ đi qua cách thêm hình dạng, áp dụng bóng cho hình dạng, và thậm chí tinh chỉnh khoảng cách bóng bằng Aspose.Words. + +Chúng ta sẽ bắt đầu với một tài liệu trống, chèn một hình chữ nhật, áp dụng bóng preset, và cuối cùng lưu file. Khi hoàn thành, bạn sẽ có một file .docx sẵn sàng, mở trong Word và ngay lập tức thấy hiệu ứng. Không cần công cụ bên ngoài, chỉ cần mã C# thuần. + +## Yêu cầu trước + +- .NET 6 (hoặc bất kỳ .NET Framework hiện đại nào) đã được cài đặt. +- Visual Studio 2022 hoặc VS Code với extension C#. +- Gói NuGet Aspose.Words for .NET (`Aspose.Words` phiên bản 23.12 trở lên). + Bạn có thể thêm nó qua Package Manager Console: + + ```powershell + Install-Package Aspose.Words + ``` + +Đó là tất cả – không cần DLL hay COM interop bổ sung. + +## Bước 1: Khởi tạo Tài liệu và Builder mới – *create word document c#* Cơ bản + +Đầu tiên chúng ta cần một đối tượng `Document` đại diện cho file Word và một `DocumentBuilder` để chỉnh sửa nó. + +```csharp +using Aspose.Words; +using Aspose.Words.Drawing; +using System.Drawing; + +// Create a blank Word document +Document document = new Document(); + +// DocumentBuilder lets us add content programmatically +DocumentBuilder builder = new DocumentBuilder(document); +``` + +> **Tại sao bước này quan trọng:** Lớp `Document` là container cho tất cả các phần của Word (trang, style, hình ảnh). Builder là API cấp cao trừu tượng hoá việc thao tác node cấp thấp, giúp bạn **create word document c#** mà không phải làm việc trực tiếp với XML. + +## Bước 2: Chèn hình chữ nhật – *how to create rectangle* + +Bây giờ chúng ta sẽ đặt một hình chữ nhật lên trang. Kích thước được biểu thị bằng điểm (1 pt ≈ 1/72 in). + +```csharp +// Insert a rectangle 200 pt wide and 100 pt tall +Shape rectangleShape = builder.InsertShape(ShapeType.Rectangle, 200, 100); + +// Give the rectangle a light‑blue fill so we can see it clearly +rectangleShape.FillColor = Color.LightBlue; +``` + +> **Mẹo chuyên nghiệp:** Nếu bạn cần một hình dạng khác, chỉ cần thay `ShapeType.Rectangle` bằng `ShapeType.Ellipse`, `ShapeType.Triangle`, v.v. Cùng một đoạn mã hoạt động cho **how to add shape** bất kỳ loại nào. + +## Bước 3: Áp dụng bóng preset và tinh chỉnh – *apply shadow to shape* + +Aspose.Words cung cấp một số định dạng bóng preset. Chúng ta sẽ dùng `Preset1` rồi tùy chỉnh khoảng cách, độ mờ, độ trong suốt và màu sắc. + +```csharp +// Choose a predefined shadow style +rectangleShape.Shadow.Format = ShadowFormat.Preset1; + +// Adjust the shadow distance – this is the offset from the shape +rectangleShape.Shadow.Distance = 5; // measured in points + +// Make the edge of the shadow a little fuzzy +rectangleShape.Shadow.BlurRadius = 3; + +// Set the shadow to be 40 % transparent (0 = opaque, 1 = fully transparent) +rectangleShape.Shadow.Transparency = 0.4; + +// Pick a gray tone for the shadow color +rectangleShape.Shadow.Color = Color.Gray; +``` + +> **Tại sao cần tùy chỉnh bóng?** Thuộc tính `Distance` điều khiển khoảng cách bóng so với hình chữ nhật – giống như “độ nâng” trong render 3‑D. Thay đổi `BlurRadius` làm mềm các cạnh, trong khi `Transparency` cho phép tạo một vẻ ngoài tinh tế, chuyên nghiệp. Điều này đáp ứng yêu cầu **set shadow distance** và cho bạn thấy cách **apply shadow to shape** một cách linh hoạt. + +## Bước 4: Lưu tài liệu – *create word document c#* Hoàn tất + +Cuối cùng, ghi tài liệu ra đĩa. Điều chỉnh đường dẫn tới thư mục bạn có quyền ghi. + +```csharp +// Save the document as a .docx file +string outputPath = @"C:\Temp\ShadowShape.docx"; +document.Save(outputPath); + +Console.WriteLine($"Document saved to {outputPath}"); +``` + +Mở file kết quả trong Microsoft Word, bạn sẽ thấy một hình chữ nhật màu xanh nhạt với bóng xám mềm được dịch chuyển 5 pt. Đó là bằng chứng trực quan rằng bạn đã **create word document c#** thành công với một hình dạng được thiết kế. + +![Create Word Document C# with Shadowed Shape](shadow-example.png){: .img alt="create word document c# example showing rectangle with shadow"} + +## Các biến thể tùy chọn & Trường hợp đặc biệt + +| Kịch bản | Cần thay đổi | Tại sao quan trọng | +|----------|--------------|--------------------| +| **Phong cách bóng khác** | `rectangleShape.Shadow.Format = ShadowFormat.Preset3;` | Mang lại vẻ ngoài ấn tượng hơn mà không cần thêm mã. | +| **Không dùng preset – bóng tùy chỉnh** | Bỏ `Format` và đặt `OffsetX`, `OffsetY` thủ công. | Kiểm soát hoàn toàn hướng và độ sâu. | +| **Nhiều hình dạng** | Gọi `builder.InsertShape` lại trước khi lưu. | Hữu ích cho các mẫu phức tạp có biểu tượng, logo, v.v. | +| **Tương thích với phiên bản Aspose cũ** | Sử dụng lớp `ShadowEffect` (có trong v20.x). | Đảm bảo mã chạy trên các dự án legacy. | +| **Lưu dưới dạng PDF** | `document.Save("ShadowShape.pdf");` | Bóng sẽ được render tương tự trong file PDF. | + +> **Câu hỏi thường gặp:** *Nếu bóng không xuất hiện trong Word thì sao?* +> Đảm bảo bạn đang dùng phiên bản Aspose.Words mới (≥ 22.9). Các phiên bản cũ hơn có hỗ trợ bóng hạn chế. Ngoài ra, kiểm tra rằng tài liệu được mở bằng phiên bản Word mới (2016+). + +## Ví dụ Hoàn chỉnh + +Dưới đây là chương trình đầy đủ, sẵn sàng sao chép‑dán. Bao gồm tất cả các `using` directive, chú thích, và xử lý lỗi để trải nghiệm mượt mà. + +```csharp +using System; +using System.Drawing; +using Aspose.Words; +using Aspose.Words.Drawing; + +namespace ShadowShapeDemo +{ + class Program + { + static void Main() + { + try + { + // 1️⃣ Create a new blank document and a builder + Document doc = new Document(); + DocumentBuilder builder = new DocumentBuilder(doc); + + // 2️⃣ Insert a rectangle (200 pt × 100 pt) and fill it + Shape rect = builder.InsertShape(ShapeType.Rectangle, 200, 100); + rect.FillColor = Color.LightBlue; + + // 3️⃣ Apply a preset shadow and tweak its properties + rect.Shadow.Format = ShadowFormat.Preset1; // predefined style + rect.Shadow.Distance = 5; // set shadow distance + rect.Shadow.BlurRadius = 3; // soften edges + rect.Shadow.Transparency = 0.4; // semi‑transparent + rect.Shadow.Color = Color.Gray; // shadow color + + // 4️⃣ Save the document + string outPath = @"C:\Temp\ShadowShape.docx"; + doc.Save(outPath); + + Console.WriteLine($"✅ Document created successfully at {outPath}"); + } + catch (Exception ex) + { + Console.Error.WriteLine($"❌ Error: {ex.Message}"); + } + } + } +} +``` + +Chạy chương trình, điều hướng tới `C:\Temp\ShadowShape.docx`, và bạn sẽ thấy hình chữ nhật với bóng chính xác như đã cấu hình. + +## Tóm tắt & Các bước tiếp theo + +- Giờ bạn đã biết cách **create word document c#**, chèn hình chữ nhật, và **apply shadow to shape** với **set shadow distance** tùy chỉnh. +- Ví dụ sử dụng Aspose.Words, giúp trừu tượng hoá các phức tạp của OpenXML và đảm bảo render nhất quán trên các phiên bản Word. +- Muốn tiến xa hơn? Hãy thử kết hợp nhiều hình dạng, thêm văn bản vào trong hình chữ nhật, hoặc xuất cùng tài liệu dưới dạng PDF để xem bóng được chuyển đổi như thế nào. + +### Các chủ đề liên quan bạn có thể khám phá + +- **How to add shape** vào header/footer để branding. +- Sử dụng **Aspose.Words** để chèn biểu đồ và bảng một cách lập trình. +- Tùy chỉnh **shadow effects** trên ảnh thay vì hình vector. +- Tự động tạo hàng loạt tài liệu cho hoá đơn hoặc chứng chỉ. + +Hãy thoải mái thử nghiệm, phá vỡ mã, rồi xây dựng lại – đó là cách nhanh nhất để nắm vững các khái niệm. Nếu gặp khó khăn, để lại bình luận bên dưới hoặc tham khảo tài liệu chính thức của Aspose.Words để hiểu sâu hơn về API. + +Chúc lập trình vui vẻ, và chúc các file Word của bạn trở nên tinh tế hơn! + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/vietnamese/net/programming-with-txtsaveoptions/_index.md b/words/vietnamese/net/programming-with-txtsaveoptions/_index.md index d9a57685a5..29dc3a630d 100644 --- a/words/vietnamese/net/programming-with-txtsaveoptions/_index.md +++ b/words/vietnamese/net/programming-with-txtsaveoptions/_index.md @@ -27,7 +27,7 @@ Nhờ các hướng dẫn này, bạn sẽ có thể khai thác đầy đủ cá | [Thêm Dấu Bidi vào Tài liệu Word](./add-bidi-marks/) | Tìm hiểu cách thêm dấu hai chiều (Bidi) vào tài liệu Word bằng Aspose.Words cho .NET với hướng dẫn này. Đảm bảo hướng văn bản phù hợp cho nội dung đa ngôn ngữ. | | [Sử dụng ký tự Tab cho mỗi cấp độ để thụt lề danh sách](./use-tab-character-per-level-for-list-indentation/) | Tìm hiểu cách tạo danh sách nhiều cấp với thụt lề theo tab bằng Aspose.Words cho .NET. Thực hiện theo hướng dẫn này để định dạng danh sách chính xác trong tài liệu của bạn. | | [Sử dụng ký tự khoảng trắng cho mỗi cấp độ để thụt lề danh sách](./use-space-character-per-level-for-list-indentation/) | Tìm hiểu cách tạo danh sách nhiều cấp với thụt lề ký tự khoảng trắng trong Aspose.Words cho .NET. Hướng dẫn từng bước để định dạng tài liệu chính xác. | - +| [Lưu docx thành txt – Hướng dẫn đầy đủ xuất công thức Word sang LaTeX](./save-docx-as-txt-complete-guide-to-exporting-word-equations/) | Tìm hiểu cách lưu tài liệu docx dưới dạng txt và xuất công thức Word sang LaTeX bằng Aspose.Words cho .NET. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/vietnamese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md b/words/vietnamese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md new file mode 100644 index 0000000000..57b68ccf7b --- /dev/null +++ b/words/vietnamese/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-03-27 +description: Lưu file docx thành txt với Aspose.Words và chuyển đổi Word sang LaTeX. + Tìm hiểu cách xuất công thức, giữ nguyên văn bản thuần và nhận mã LaTeX trong vài + phút. +draft: false +keywords: +- save docx as txt +- convert word to latex +- how to export equations +- save word plain text +- export equations to latex +language: vi +og_description: Lưu file docx thành txt bằng Aspose.Words. Hướng dẫn này chỉ ra cách + chuyển Word sang LaTeX, xuất phương trình và giữ tài liệu của bạn ở dạng văn bản + thuần. +og_title: Lưu file docx dưới dạng txt – Xuất các phương trình Word sang LaTeX +tags: +- Aspose.Words +- C# +- LaTeX +- Document Conversion +title: Lưu docx thành txt – Hướng dẫn toàn diện về xuất công thức Word sang LaTeX +url: /vi/net/programming-with-txtsaveoptions/save-docx-as-txt-complete-guide-to-exporting-word-equations/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Lưu docx thành txt – Xuất Phương Trình Word sang LaTeX + +Bạn đã bao giờ cần **save docx as txt** nhưng lo lắng sẽ mất các công thức toán học tinh vi bên trong tệp Word của mình? Bạn không cô đơn. Trong nhiều quy trình khoa học, phiên bản văn bản thuần là bắt buộc, nhưng bạn vẫn muốn các công thức được giữ lại dưới dạng mã LaTeX sạch sẽ. + +Trong hướng dẫn này, chúng tôi sẽ hướng dẫn chi tiết các bước để **convert Word to LaTeX** bằng cách sử dụng Aspose.Words cho .NET, để các công thức của bạn được xuất đúng trong khi phần còn lại của tài liệu trở thành văn bản thuần gọn gàng. Khi kết thúc, bạn sẽ biết cách **export equations to LaTeX**, giữ phần còn lại của tệp dưới dạng văn bản đơn giản, và tránh những cạm bẫy thường gặp đối với người mới. + +## Những Điều Bạn Sẽ Học + +- Cách tải tệp *.docx* chứa Office Math. +- Cài đặt `TxtSaveOptions` phù hợp để Aspose xuất LaTeX cho mọi công thức. +- Lưu kết quả dưới dạng tệp **save word plain text** mà bạn có thể đưa vào hệ thống kiểm soát phiên bản, pipeline CI, hoặc bất kỳ công cụ downstream nào. +- Các trường hợp đặc biệt thường gặp — cách xử lý khi tài liệu kết hợp hình ảnh và công thức, hoặc khi bạn cần giữ nguyên các ký tự Unicode. +- Một mẫu mã hoàn chỉnh, sẵn sàng chạy mà bạn có thể chèn vào một ứng dụng console. + +### Yêu Cầu Trước + +- .NET 6.0 trở lên (mã cũng hoạt động với .NET Framework 4.7+). +- Bản sao có giấy phép của **Aspose.Words for .NET** (bản dùng thử miễn phí đủ cho việc thử nghiệm). +- Visual Studio 2022 hoặc bất kỳ IDE nào có thể biên dịch dự án C#. +- Tài liệu Word (`input.docx`) đã chứa một số đối tượng Office Math. + +> **Mẹo:** Nếu bạn chưa có giấy phép, bạn có thể yêu cầu một khóa tạm thời từ trang web của Aspose — chỉ cần thay thế phần giữ chỗ trong mã bằng khóa của bạn trước khi chạy. + +## Bước 1 – Cài Đặt Aspose.Words qua NuGet + +Điều đầu tiên cần làm: bạn cần thư viện trong dự án của mình. Mở **Package Manager Console** và chạy: + +```powershell +Install-Package Aspose.Words +``` + +Dòng lệnh duy nhất này sẽ kéo về mọi thứ bạn cần, bao gồm không gian tên `Saving` nơi chứa `TxtSaveOptions`. Không có DLL bổ sung, không phụ thuộc gốc—chỉ mã quản lý thuần túy. + +## Bước 2 – Tải Tài Liệu Word Nguồn + +Bây giờ chúng ta thực sự đọc tệp chứa các công thức. Lớp `Document` trừu tượng hoá toàn bộ cấu trúc *.docx*, vì vậy bạn có thể xử lý nó như một mô hình đối tượng cấp cao. + +```csharp +using Aspose.Words; +using Aspose.Words.Saving; + +// If you have a license file, load it here +// var license = new License(); +// license.SetLicense("Aspose.Words.lic"); + +// Step 2: Load the source Word document that contains equations +Document document = new Document(@"C:\MyProjects\Docs\input.docx"); + +// Quick sanity check – make sure the document actually has Office Math +if (document.GetChildNodes(NodeType.OfficeMath, true).Count == 0) +{ + Console.WriteLine("Warning: No equations found. The output will be plain text only."); +} +``` + +**Tại sao điều này quan trọng:** Việc tải tài liệu sớm cho phép bạn kiểm tra cây nút của nó. Nếu bạn bỏ qua kiểm tra và tệp không có công thức, bạn vẫn sẽ nhận được tệp txt sạch—but bạn sẽ không biết tại sao đầu ra LaTeX lại trống. + +## Bước 3 – Cấu Hình TxtSaveOptions cho Xuất LaTeX + +Aspose cung cấp cho bạn khả năng kiểm soát chi tiết cách Office Math được hiển thị. Bằng cách đặt `OfficeMathExportMode` thành `LaTeX`, mọi công thức sẽ được chuyển thành dạng LaTeX tương ứng thay vì bị loại bỏ hoặc chuyển thành hình ảnh. + +```csharp +// Step 3: Create text save options and set Office Math export mode to LaTeX +TxtSaveOptions txtSaveOptions = new TxtSaveOptions +{ + // This tells Aspose to emit LaTeX markup for each equation + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + + // Optional: preserve Unicode characters (useful for symbols like α, β, etc.) + Encoding = Encoding.UTF8, + + // Optional: add a line break after each paragraph for readability + AddBidiMarks = false +}; +``` + +**Tại sao điều này quan trọng:** Chế độ xuất mặc định sẽ loại bỏ hoàn toàn các công thức. Chuyển sang `LaTeX` giữ lại ý định toán học, chính xác những gì bạn cần khi sau này đưa tệp vào trình biên dịch LaTeX hoặc bộ xử lý markdown hiểu cú pháp `$…$`. + +## Bước 4 – Lưu Tài Liệu dưới Dạng Văn Bản Thuần + +Với các tùy chọn đã cấu hình, việc lưu tệp chỉ cần một dòng lệnh. Đầu ra sẽ là tệp `.txt` trong đó mỗi công thức xuất hiện dưới dạng mã LaTeX được bao quanh bởi dấu `$` (bạn có thể thay đổi sau nếu muốn khối `\[` … `\]`). + +```csharp +// Step 4: Save the document as a plain‑text file; equations are exported as LaTeX markup +string outputPath = @"C:\MyProjects\Docs\output.txt"; +document.Save(outputPath, txtSaveOptions); + +Console.WriteLine($"Success! The file has been saved to {outputPath}"); +``` + +### Kết Quả Mong Đợi + +Mở `output.txt` trong bất kỳ trình soạn thảo nào và bạn sẽ thấy một thứ gì đó như: + +``` +This is a sample paragraph with an equation. + +$E = mc^2$ + +Another paragraph follows the equation. + +$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $ +``` + +Chú ý cách văn bản thường giữ nguyên như cũ, trong khi các công thức giờ là các chuỗi LaTeX thuần túy. Bạn có thể sao chép‑dán chúng trực tiếp vào tài liệu LaTeX, notebook Jupyter, hoặc bất kỳ công cụ nào hiển thị toán học. + +## Bước 5 – Xử Lý Các Trường Hợp Đặc Biệt + +### Nội Dung Hỗn Hợp (Hình Ảnh + Công Thức) + +Nếu tệp Word của bạn cũng chứa hình ảnh, Aspose sẽ bỏ qua chúng khi bạn sử dụng `TxtSaveOptions`. Thông thường điều này ổn cho quy trình **save word plain text**, nhưng nếu bạn cần hình ảnh làm chỗ giữ, bạn có thể: + +1. Xuất tài liệu sang HTML trước (`HtmlSaveOptions`) để ghi lại hình ảnh dưới dạng thẻ ``. +2. Thực hiện một lượt xử lý thứ hai với `TxtSaveOptions` để lấy các công thức LaTeX. +3. Kết hợp hai kết quả thủ công hoặc bằng một script nhỏ. + +### Ký Tự Unicode + +Một số công thức sử dụng ký tự Unicode đặc biệt (ví dụ, chữ cái Hy Lạp). Đặt `Encoding = Encoding.UTF8` trong `TxtSaveOptions` (như đã chỉ ra ở Bước 3) sẽ đảm bảo các ký tự này được giữ lại sau quá trình chuyển đổi. + +### Tài Liệu Lớn + +Đối với các tệp khổng lồ (> 100 MB), hãy cân nhắc truyền dữ liệu khi lưu: + +```csharp +using (FileStream fs = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) +{ + document.Save(fs, txtSaveOptions); +} +``` + +Truyền dữ liệu giúp tránh tải toàn bộ đầu ra vào bộ nhớ, điều này có thể cứu sống khi làm việc trên các máy build bộ nhớ thấp. + +## Ví Dụ Hoàn Chỉnh Hoạt Động + +Dưới đây là chương trình hoàn chỉnh, sẵn sàng sao chép‑dán, kết nối mọi thứ lại với nhau. Chỉ cần thay thế các đường dẫn tệp và, nếu có, dòng giấy phép. + +```csharp +using System; +using System.Text; +using Aspose.Words; +using Aspose.Words.Saving; + +class Program +{ + static void Main() + { + // ------------------------------------------------- + // OPTIONAL: Load your Aspose.Words license here + // ------------------------------------------------- + // var license = new License(); + // license.SetLicense("Aspose.Words.lic"); + + // ------------------------------------------------- + // Step 1: Load the source document + // ------------------------------------------------- + string inputPath = @"C:\MyProjects\Docs\input.docx"; + Document doc = new Document(inputPath); + + // ------------------------------------------------- + // Step 2: Verify that the document contains equations + // ------------------------------------------------- + int equationCount = doc.GetChildNodes(NodeType.OfficeMath, true).Count; + if (equationCount == 0) + { + Console.WriteLine("No Office Math found – the output will be plain text only."); + } + + // ------------------------------------------------- + // Step 3: Configure TxtSaveOptions for LaTeX export + // ------------------------------------------------- + TxtSaveOptions options = new TxtSaveOptions + { + OfficeMathExportMode = OfficeMathExportMode.LaTeX, + Encoding = Encoding.UTF8, + AddBidiMarks = false + }; + + // ------------------------------------------------- + // Step 4: Save as .txt (plain text + LaTeX equations) + // ------------------------------------------------- + string outputPath = @"C:\MyProjects\Docs\output.txt"; + doc.Save(outputPath, options); + + Console.WriteLine($"File saved successfully to: {outputPath}"); + } +} +``` + +Chạy chương trình (`dotnet run` nếu bạn đang dùng dự án console) và kiểm tra `output.txt`. Bạn vừa **saved docx as txt** trong khi giữ nguyên mọi công thức dưới dạng LaTeX—không cần sao chép‑dán thủ công. + +## Câu Hỏi Thường Gặp + +**Q: Tôi có thể đổi dấu phân cách từ `$…$` sang `\(...\)` không?** +A: Có. Sau khi lưu, chạy một lệnh thay thế đơn giản trên tệp: `output = output.Replace("$", @"\(").Replace("$", @"\)");` — chỉ cần cẩn thận không thay thế các ký tự `$` nội tuyến thuộc về văn bản gốc. + +**Q: Điều này có hoạt động với các tệp Word 2007‑2019 không?** +A: Hoàn toàn có. Aspose.Words hỗ trợ `.doc`, `.docx`, `.docm`, và thậm chí các định dạng mới hơn `.dotx`. Mã giống nhau hoạt động trên mọi phiên bản. + +**Q: Nếu tôi cần giữ nguyên định dạng đoạn văn gốc (tab, nhiều khoảng trắng) thì sao?** +A: Đặt `txtSaveOptions.PreserveTableLayout = true;` và `txtSaveOptions.PreserveSpace = true;` để giữ nguyên khoảng trắng. + +## Kết Luận + +Chúng tôi đã trình bày mọi thứ bạn cần để **save docx as txt** đồng thời **export equations to LaTeX** bằng Aspose.Words. Các bước chính là tải tài liệu, cấu hình `TxtSaveOptions` với `OfficeMathExportMode.LaTeX`, và lưu kết quả. Với ba dòng mã này, bạn có thể tin cậy **convert word to latex**, giữ tài liệu của mình dưới dạng **save word plain text**, và tránh mất các ký hiệu toán học. + +Sẵn sàng cho thử thách tiếp theo? Hãy thử nối chuỗi quy trình này với một trình tạo markdown để tạo tệp `.md` đầy đủ bao gồm cả văn bản và LaTeX—hoàn hảo cho tài liệu dựa trên Git hoặc các trình tạo site tĩnh. Hoặc khám phá `PdfSaveOptions` của Aspose để có phiên bản PDF bên cạnh tệp văn bản thuần. + +Nếu bạn gặp bất kỳ vấn đề nào, hãy để lại bình luận bên dưới. Chúc lập trình vui vẻ, và tận hưởng sự đơn giản khi biến các công thức Word thành LaTeX sạch sẽ! + +![Illustration of saving a DOCX as TXT with LaTeX equations](placeholder-image.png "save docx as txt example") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/vietnamese/net/working-with-fonts/_index.md b/words/vietnamese/net/working-with-fonts/_index.md index 3ff7c6370a..5fffdadba9 100644 --- a/words/vietnamese/net/working-with-fonts/_index.md +++ b/words/vietnamese/net/working-with-fonts/_index.md @@ -48,6 +48,7 @@ Cho dù bạn muốn định dạng văn bản bằng các phông chữ khác nh | [Nhận thông báo cảnh báo](./receive-warning-notification/) Tìm hiểu cách nhận thông báo cảnh báo khi sử dụng Aspose.Words cho .NET và quản lý mọi sự cố hoặc cảnh báo trong tài liệu của bạn. | | [Nguồn Phông chữ Steam Ví dụ](./resource-steam-font-source-example/) | Tìm hiểu cách sử dụng Resource Stream Font Source để tải phông chữ tùy chỉnh vào Aspose.Words cho .NET. | | [Nhận thay thế không có hậu tố](./get-substitution-without-suffixes/) | Trong hướng dẫn này, hãy tìm hiểu cách ghi đè không có hậu tố trong tài liệu Word bằng Aspose.Words cho .NET. | +| [Thay thế phông chữ Aspose – Cách cấu hình cài đặt phông chữ trong C#](./aspose-font-substitution-how-to-configure-font-settings-in-c/) | Tìm hiểu cách cấu hình cài đặt phông chữ trong Aspose.Words cho .NET bằng C#. | {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/words/vietnamese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md b/words/vietnamese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md new file mode 100644 index 0000000000..3e80f4e3b8 --- /dev/null +++ b/words/vietnamese/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/_index.md @@ -0,0 +1,237 @@ +--- +category: general +date: 2026-03-27 +description: 'Thay thế phông chữ Aspose trở nên dễ dàng: học cách cấu hình cài đặt + phông chữ, ghi lại cảnh báo và xử lý các phông chữ thiếu trong ứng dụng .NET của + bạn.' +draft: false +keywords: +- aspose font substitution +- configure font settings +- Aspose.Words warning callback +- FontSubstitutionWarningHandler +- LoadOptions example +language: vi +og_description: Thành thạo việc thay thế phông chữ Aspose bằng cách cấu hình cài đặt + phông chữ và xử lý các phông chữ thiếu bằng callback cảnh báo. Hướng dẫn C# đầy + đủ. +og_title: Thay thế phông chữ Aspose – Cấu hình cài đặt phông chữ trong C# +tags: +- Aspose.Words +- C# +- Font Management +title: Thay thế phông chữ Aspose – Cách cấu hình cài đặt phông chữ trong C# +url: /vi/net/working-with-fonts/aspose-font-substitution-how-to-configure-font-settings-in-c/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Thay Thế Phông Chữ Aspose – Hướng Dẫn Toàn Diện Để Cấu Hình Cài Đặt Phông + +Bạn đã bao giờ gặp phải một tài liệu đột nhiên thay đổi phông chữ tùy chỉnh của mình thành một phông chữ chung chung chưa? Đó là **aspose font substitution** đang thực hiện công việc của nó — thay thế các phông chữ bị thiếu bằng phông chữ gần nhất mà nó có thể tìm thấy. Điều này tiện lợi, nhưng nếu bạn cần biết *chính xác* phông chữ nào đã được thay thế, bạn phải truy cập vào hệ thống cảnh báo của thư viện và tự cấu hình cài đặt phông chữ. + +Trong hướng dẫn này, chúng ta sẽ đi qua một kịch bản thực tế: tải một tệp DOCX tham chiếu đến một phông chữ mà bạn không có, bắt sự kiện thay thế, và in một thông báo thân thiện ra console. Khi kết thúc, bạn sẽ quen thuộc với **configure font settings**, thiết lập một **Aspose.Words warning callback**, và mở rộng mẫu để phù hợp với bất kỳ quy trình làm việc nào. + +> **Bạn sẽ cần** +> • .NET 6+ (hoặc .NET Framework 4.7.2+) +> • Aspose.Words cho .NET (phiên bản NuGet mới nhất) +> • Một tệp DOCX tham chiếu đến một phông chữ bị thiếu (chúng tôi sẽ gọi nó là `MissingFont.docx`) + +Hãy bắt đầu. + +--- + +## Bước 1: Cài Đặt Aspose.Words và Chuẩn Bị Dự Án + +Trước khi chúng ta viết bất kỳ mã nào, hãy chắc chắn rằng gói Aspose.Words đã được tham chiếu: + +```bash +dotnet add package Aspose.Words +``` + +> **Mẹo chuyên nghiệp:** Sử dụng phiên bản ổn định mới nhất; tính đến tháng 3 2026, phiên bản là 23.11.0. Các bản phát hành mới hơn cải thiện thuật toán khớp phông và thêm các loại cảnh báo bổ sung. + +Tạo một ứng dụng console mới (hoặc chèn mã vào dự án hiện có) và thêm các chỉ thị `using` thông thường: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; +``` + +Các không gian tên này cho phép chúng ta truy cập vào `Document`, `LoadOptions`, và các lớp liên quan đến phông chữ mà chúng ta sẽ cần. + +## Bước 2: Cấu Hình Cài Đặt Phông Chữ với LoadOptions + +Trung tâm của việc kiểm soát **aspose font substitution** nằm trong `LoadOptions.FontSettings`. Bằng cách cung cấp một đối tượng `FontSettings` rỗng, chúng ta nói với Aspose sử dụng các đường dẫn tìm kiếm mặc định *và* báo cáo bất kỳ sự thay thế nào thông qua một callback cảnh báo. + +```csharp +// Step 2: Prepare LoadOptions with a fresh FontSettings instance +LoadOptions loadOptions = new LoadOptions +{ + FontSettings = new FontSettings() +}; +``` + +Tại sao không chỉ dựa vào mặc định? Bởi vì việc gắn một callback cảnh báo (bước tiếp theo) chỉ hoạt động khi thuộc tính `FontSettings` không phải là null. Dòng mã nhỏ này cung cấp cho chúng ta một điểm nối vào quá trình thay thế mà không thay đổi hành vi tìm kiếm phông chữ thực tế. + +## Bước 3: Gắn Callback Cảnh Báo để Bắt Lại Các Sự Thay Thế + +Aspose.Words triển khai giao diện `IWarningCallback`. Bất cứ khi nào có điều gì đáng chú ý xảy ra — chẳng hạn như một phông chữ bị thiếu — nó sẽ gọi phương thức `Warning` của chúng ta. Chúng ta sẽ triển khai một trình xử lý nhỏ để lọc `WarningType.FontSubstitution` và in mô tả. + +```csharp +// Step 3: Register the warning handler +loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); +``` + +Và đây là phần xử lý thực tế: + +```csharp +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + // Filter only font‑substitution warnings + if (info.WarningType == WarningType.FontSubstitution) + { + // Step 4: Output information about the substituted font + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +> **Tại sao điều này quan trọng** – Nếu không có callback, Aspose sẽ thay thế phông chữ một cách im lặng, và bạn sẽ không bao giờ biết phông chữ nào đã được sử dụng. Callback làm cho quá trình này trở nên trong suốt, điều này rất cần thiết cho việc báo cáo tuân thủ hoặc gỡ lỗi các vấn đề bố cục. + +## Bước 4: Tải Tài Liệu Sử Dụng Các Tùy Chọn Đã Cấu Hình + +Bây giờ chúng ta cuối cùng tải tài liệu, truyền `loadOptions` mà chúng ta vừa chuẩn bị. Nếu tệp nguồn tham chiếu đến một phông chữ chưa được cài đặt, trình xử lý của chúng ta sẽ được kích hoạt. + +```csharp +// Step 4: Load the document with the custom LoadOptions +Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); +``` + +Thay thế `YOUR_DIRECTORY` bằng đường dẫn thực tế nơi chứa `MissingFont.docx`. Khi bạn chạy chương trình, bạn sẽ thấy đầu ra tương tự như: + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +``` + +Dòng này cho bạn biết chính xác phông chữ nào bị thiếu và phông chữ thay thế nào mà Aspose đã chọn. + +## Bước 5: (Tùy Chọn) Tinh Chỉnh Đường Dẫn Tìm Kiếm Phông Chữ + +Nếu bạn có một thư mục riêng chứa các phông chữ công ty, bạn có thể chỉ định cho Aspose nơi tìm kiếm trước khi nó quay lại các phông chữ hệ thống. Đây là một cách sử dụng nâng cao của **configure font settings**: + +```csharp +// Optional: Add a custom folder to the font search collection +loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", recursive: true); +``` + +Cài đặt `recursive: true` khiến Aspose quét cả các thư mục con. Bây giờ thư viện sẽ thử các phông chữ riêng của bạn trước, giảm khả năng xảy ra sự thay thế không mong muốn. + +## Ví Dụ Hoàn Chỉnh Hoạt Động + +Kết hợp mọi thứ lại, dưới đây là chương trình hoàn chỉnh, sẵn sàng để chạy: + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Fonts; + +class Program +{ + static void Main() + { + // 1️⃣ Prepare FontSettings inside LoadOptions + LoadOptions loadOptions = new LoadOptions + { + FontSettings = new FontSettings() + }; + + // 2️⃣ Hook our warning handler + loadOptions.WarningCallback = new FontSubstitutionWarningHandler(); + + // 3️⃣ (Optional) Add a custom font folder + // loadOptions.FontSettings.SetFontsFolder(@"C:\Company\Fonts", true); + + // 4️⃣ Load the document – triggers warnings if needed + Document doc = new Document("YOUR_DIRECTORY/MissingFont.docx", loadOptions); + + // 5️⃣ Do something with the document – e.g., save as PDF + doc.Save("Output.pdf"); + Console.WriteLine("Document processed and saved as Output.pdf"); + } +} + +// Warning handler that prints substitution details +class FontSubstitutionWarningHandler : IWarningCallback +{ + public void Warning(WarningInfo info) + { + if (info.WarningType == WarningType.FontSubstitution) + { + Console.WriteLine($"Font substitution detected: {info.Description}"); + } + } +} +``` + +**Kết quả mong đợi** (khi gặp phông chữ bị thiếu): + +``` +Font substitution detected: Font "MyCustomFont" was not found. Substituted with "Arial". +Document processed and saved as Output.pdf +``` + +Nếu tất cả các phông chữ đều có, chương trình sẽ chạy im lặng (không có cảnh báo) và vẫn tạo ra file PDF. + +## Các Câu Hỏi Thường Gặp & Trường Hợp Đặc Biệt + +### Nếu tôi muốn *ngăn* việc thay thế hoàn toàn thì sao? + +Đặt `FontSettings.SubstitutionSettings` thành `null` hoặc sử dụng `FontSettings.FontSubstitutionSettings` để kiểm soát hành vi. Ví dụ: + +```csharp +loadOptions.FontSettings.SubstitutionSettings.DefaultFontSubstitution = false; +``` + +Bây giờ Aspose sẽ ném ra một ngoại lệ thay vì thay thế im lặng, ngoại lệ này có thể được bắt và xử lý. + +### Điều này có hoạt động với các định dạng tệp khác (ví dụ: .doc, .rtf) không? + +Chắc chắn rồi. Đối tượng `LoadOptions` giống nhau có thể được truyền vào bất kỳ hàm khởi tạo `Document` nào chấp nhận đường dẫn tệp. Callback cảnh báo sẽ được kích hoạt cho tất cả các định dạng dựa vào phông chữ. + +### Tôi có thể bắt được tên phông chữ thay thế *chính xác* không? + +Có. Chuỗi `info.Description` chứa cả phông chữ bị thiếu và phông chữ thay thế. Nếu bạn cần tên này trong mã, bạn có thể phân tích chuỗi hoặc sử dụng đối tượng `FontInfo` (có sẵn trong các phiên bản mới hơn). + +### Điều này hoạt động như thế nào trong môi trường đa luồng? + +`FontSettings` **không** an toàn với đa luồng. Tạo một `LoadOptions` riêng (với `FontSettings` riêng) cho mỗi luồng, hoặc bảo vệ truy cập bằng một lock. + +## Kết Luận + +Chúng tôi đã bao phủ mọi thứ bạn cần để thành thạo **aspose font substitution** và **configure font settings** trong một ứng dụng C#: + +1. Cài đặt Aspose.Words và thêm các chỉ thị `using` cần thiết. +2. Tạo một đối tượng `LoadOptions` với một `FontSettings` mới. +3. Gắn một `IWarningCallback` tùy chỉnh để hiển thị các sự kiện thay thế. +4. Tải tài liệu, cho phép callback báo cáo bất kỳ phông chữ nào bị thiếu. +5. (Tùy chọn) Mở rộng đường dẫn tìm kiếm hoặc vô hiệu hoá hoàn toàn việc thay thế. + +Với mẫu này, bạn có thể ghi lại các phông chữ bị thiếu để tuân thủ, cảnh báo người dùng trong giao diện UI, hoặc tự động nhúng các phông chữ thay thế trước khi xuất bản. Tiếp theo, bạn có thể khám phá **chính sách thay thế phông chữ Aspose.Words** hoặc tích hợp quy trình này vào một pipeline xử lý tài liệu lớn hơn. + +Chúc lập trình vui vẻ, và mong tài liệu của bạn luôn hiển thị đúng phông chữ! + +--- + +![Sơ đồ cho thấy Aspose.Words tải một tài liệu, gọi FontSettings, kích hoạt một callback cảnh báo, và xuất thông tin thay thế](image-placeholder.png "aspose font substitution workflow") + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file