کتابخانهٔ رایگان Swift برای خواندن و نوشتن اسناد DOCX
API Swift منبع باز که به توسعهدهندگان iOS و macOS امکان خواندن، نوشتن و مدیریت فایلهای .docx را با مدیریت هوشمند فونتها و پشتیبانی از پاراگرافها و عناوین میدهد.
کتابخانه DOCX چیست؟
در دنیای توسعهٔ پرسرعت امروز، توانایی تبدیل یکپارچه محتوا بین فرمتها یک توان فوقالعاده است. مارکداون به دلیل سادگیاش به زبان جهانی برای نوشتن مستندات، پستهای وبلاگی و فایلهای README تبدیل شده است. تبدیل فایلهای مارکداون به فرمت Microsoft Word برای توسعهدهندگان Swift هیچگاه آسانتر نشده بود. کتابخانهٔ MarkdownToDocx یک راهحل قدرتمند و انعطافپذیر برای تبدیل اسناد متنی سادهٔ مارکداون به فایلهای DOCX با قالببندی حرفهای ارائه میدهد. این راهنمای جامع تمام آنچه برای دانستن دربارهٔ این کتابخانهٔ ضروری Swift نیاز دارید را بررسی میکند. فراتر از قالببندی پایه، کتابخانه ویژگیهای پیچیدهتر مارکداون را نیز پردازش میکند. متن خطخورده با قالببندی صحیح رندر میشود، نقلقولهای بلوکی با استایل متمایزی نمایش داده میشوند و جداول با حفظ کامل ساختار شامل سرعنوانها و سلولهای داده تبدیل میشوند.
API Swift DOCX منبع باز به توسعهدهندگان Swift این امکان را میدهد که تولید سند Word را بهصورت مستقیم در برنامههای خود ادغام کنند. این API چندین مزیت از جمله سازگاری跨平台 swift، سبک وزن و بدون وابستگی، تولید آفلاین DOCX و موارد دیگر را فراهم میکند. یکی از مزایای کلیدی API Swift DOCX منبع باز، ماهیت منبع باز آن است که به این معنی است که توسعهدهندگان دسترسی کامل به کد منبع دارند و میتوانند آن را بر حسب نیازهای خاص خود تغییر دهند. این سطح از سفارشیسازی به توسعهدهندگان اجازه میدهد API را بهطور دقیق با نیازهای منحصر به فرد خود سازگار کنند و اطمینان حاصل کنند که برنامههایشان دارای ویژگیها و تواناییهای لازم برای برجسته شدن در بازار رقابتی هستند. با این API، کاربران میتوانند بهسادگی فایلهای DOCX را بخوانند، بنویسند و مدیریت کنند و به محتویات اسناد با دقت و انعطافپذیری دسترسی پیدا کنند و آنها را تغییر دهند.
شروع کار با DOCX
روش پیشنهادی برای افزودن DOCX به پروژه شما استفاده از GitHub است. لطفاً برای نصب روان، دستور زیر را استفاده کنید.
نصب کتابخانه DOCX از طریق CocoaPods
Install DOCX via GitHub نصب DOCX از طریق GitHub
go get github.com/shinjukunian/DocX.git ایجاد اسناد DOCX از ابتدا
با کتابخانهٔ DocX Swift منبع باز، توسعهدهندگان نرمافزار میتوانند بهصورت آسان فایلهای .docx را از صفر تولید کنند. این شامل افزودن پاراگرافها، عناوین، تصویر، استایلها و عناصر متنی درونخطی است. توسعهدهندگان میتوانند بهراحتی ساختار محتوا را با یک API بصری و بومی Swift تعریف کنند. مثال کد زیر نشان میدهد چگونه یک سند Word جدید ایجاد کرده و یک پاراگراف ساده با متن «سلام از DocX Swift!» را در داخل برنامههای Swift اضافه میکند.
چگونه سند Word جدیدی با پاراگراف ساده با استفاده از Swift API ایجاد کنیم؟
import DocX
let doc = Document()
let p = Paragraph()
p.appendChild(Text("Hello from DocX Swift!"))
doc.appendChild(p)
try doc.save(to: URL(fileURLWithPath: "MyDocument.docx"))
مدیریت هوشمند فونتها و کنترل چیدمان صفحه
برای اطمینان از سازگاری跨平台، توسعهدهندگان میتوانند DocX را طوری پیکربندی کنند که از فونتهای استاندارد پردازش Word استفاده کند بهجای قرار دادن نامهای خاص فونت. این از بروز مشکلاتی که سند در ماشینی که فونت اصلی نصب نشده متفاوت به نظر میرسد، جلوگیری میکند. علاوه بر این، با PageDefinition میتوانید اندازه صفحه و حاشیههای سند خود را تعیین کنید. کتابخانه پیشتنظیماتی برای اندازههای استاندارد مانند A4 و US Letter دارد، اما همچنین اجازه میدهد ابعاد و حاشیههای کاملاً سفارشی تعیین کنید و کنترل دقیقی بر طراحی نهایی داشته باشید. در اینجا یک مثال ساده نشان میدهد چگونه یک اندازه صفحه سفارشی را در برنامههای Swift تعریف کنیم.
چگونه اندازه صفحه سفارشی را با استفاده از Swift API تعریف کنیم؟
import Foundation
// 1. Your attributed string
let string = NSAttributedString(string: "This content will be on a custom-sized page.")
// 2. Define a custom page layout
let customPage = PageDefinition(
pageSize: .init(
width: Measurement(value: 8, unit: .inches),
height: Measurement(value: 5, unit: .inches)
),
pageMargins: .init(
top: .init(value: 0.5, unit: .inches),
bottom: .init(value: 0.5, unit: .inches),
left: .init(value: 1, unit: .inches),
right: .init(value: 1, unit: .inches)
)
)
// 3. Apply the page definition via DocXOptions
var options = DocXOptions()
options.pageDefinition = customPage
// 4. Write the document
let url = URL(fileURLWithPath: "/path/to/your/CustomPage.docx")
try string.writeDocX(to: url, options: options)
پشتیبانی جامع از ویژگیها
کتابخانهٔ Swift DocX از طیف گستردهای از ویژگیهای متنی پشتیبانی میکند و اطمینان میدهد که متن غنی و دقیقاً طراحی شدهٔ شما بهدرستی در فایل نهایی .docx بازنمایی شود. این شامل فونتها و رنگها، سبکهای پاراگراف، سبکهای کاراکتر، افزودن تصاویر و موارد دیگر است. همچنین از ویژگیهای Furigana (یادداشتهای Ruby) پشتیبانی میکند که برای توسعهدهندگانی که با متن ژاپنی کار میکنند، ویژگی برجستهای است، زیرا راهنمای صوتی را بهدرستی رندر میکند.
