API منبعباز روبی برای ایجاد اسناد Word DOCX
یک کتابخانه رایگان پیشرو روبی که به توسعهدهندگان نرمافزار امکان ایجاد اسناد Word، افزودن و سفارشیسازی جدولها، درج تصاویر، اعمال شکست خط و قالببندی متن به اسناد Word درون برنامههای روبی را میدهد.
کتابخانه PureDocx چیست؟
PureDocx یک کتابخانه قدرتمند و منبعباز روبی است که فرآیند ایجاد فایلهای Microsoft Word با فرمت .docx را درون برنامههای روبی ساده میکند. این کتابخانه راهی واضح و شهودی برای تولید برنامهنویسیمحور اسناد Word فراهم میآورد و بهعنوان ابزار عالی برای توسعهدهندگان نرمافزار که نیاز به ایجاد گزارشها، فاکتورها یا هر نوع سند دیگری بهسرعت دارند، عمل میکند. در اصل، PureDocx به شما اجازه میدهد سندی با سرصفحه و محتوا تعریف کنید. سرصفحه در هر صفحه سند نمایش داده میشود، در حالی که محتوا از یک صفحه به صفحهی بعدی جریان مییابد.
کتابخانه PureDocx برای هر توسعهدهنده روبی که نیاز به تولید فایلهای .docx دارد، کتابخانهای فوقالعاده است. API ساده، ویژگیهای انعطافپذیر و طبیعت منبعباز آن، آن را به گزینهای برتر برای طیف گستردهای از کاربردها تبدیل میکند. API تمیز و شهودی آن به توسعهدهندگان امکان میدهد اسناد پیچیده را با حداقل کد ایجاد کنند. با پشتیبانی از متن، تصاویر و جدولها، PureDocx انعطافپذیری لازم برای تولید انواع مختلف اسناد را فراهم میآورد. DSL زیبا، پشتیبانی از سرصفحهها/پاورقیها، تصاویر و جدولها، و سازگاری با مجموعههای اداری محبوب، آن را گزینهای عالی برای تولید گزارش و خودکارسازی اسناد میسازد.
شروع کار با PureDocx
روش پیشنهادی برای نصب PureDocx استفاده از RubyGems است. لطفاً برای نصب بیدردسر، فرمان زیر را اجرا کنید.
نصب اسناد از طریق RubyGems
$ gem 'puredocx
// Or install it yourself as
$ gem install PureDocx
ایجاد اسناد Word با استفاده از روبی
کتابخانه منبعباز PureDocx پشتیبانی کامل برای ایجاد و مدیریت اسناد Word درون برنامههای روبی را فراهم کرده است. در اصل، PureDocx به شما اجازه میدهد سندی با سرصفحه و محتوا تعریف کنید. سرصفحه در هر صفحه سند ظاهر میشود، در حالی که محتوا از یک صفحه به صفحهی بعدی جریان مییابد. توسعهدهندگان نرمافزار میتوانند انواع مختلف قالببندی را اعمال کرده، جدولها و تصاویر را اضافه کرده و محتوا را بهسادگی وارد کنند. در ادامه یک مثال پایه نشان میدهد چگونه با استفاده از دستورات روبی یک سند Word ایجاد کنیم.
چگونه یک سند Word را درون برنامههای روبی ایجاد کنیم؟
PureDocx.create('my_document.docx') do |doc|
doc.header([
doc.text('My Awesome Document Header')
])
doc.content([
doc.text('This is the main content of my document.')
])
end
اعمال قالببندی متن در اسناد با استفاده از روبی
کتابخانه Ruby PureDocx ایجاد و اعمال انواع مختلف سبکها و قالببندیها بر محتوا درون اسناد Word را برای توسعهدهندگان نرمافزار آسان میکند. این کتابخانه مجموعهای از گزینهها برای قالببندی متن فراهم میآورد، از جمله استایل بولد یا ایتالیک، تنظیم اندازه فونت، تراز متن به چپ، مرکز یا راست و موارد دیگر. در اینجا یک مثال ساده نشان میدهد چگونه توسعهدهندگان میتوانند گزینههای مختلف قالببندی را بر متن داخل سند Word اعمال کنند.
چگونه قالببندی متن را در اسناد Word با API روبی اعمال کنیم؟
ایجاد و سفارشیسازی جدولها در فایلهای Word با روبی
جدولها روشی قدرتمند برای سازماندهی و نمایش دادهها در اسناد شما هستند. کتابخانه PureDocx ایجاد جدولهای با استایل سفارشی درون اسناد Word را از طریق کتابخانه روبی آسان میسازد. توسعهدهندگان میتوانند ظاهر جدولها را با گزینههای متنوعی سفارشی کنند، مانند تنظیم عرض جدول، تعیین فاصلهگذاری بالا و چپ سلولهای جدول، مشخص کردن طرفهای جدول که نباید حاشیه داشته باشند، تنظیم عرض ستونهای جداگانه، تعیین طرفهای جدول که باید حاشیه بولد داشته باشند و غیره. مثال زیر نشان میدهد چگونه میتوانید یک جدول ساده در برنامههای روبی ایجاد کنید.
چگونه یک جدول ساده را درون برنامههای روبی ایجاد کنیم؟
table_data = [
[{ column: [doc.text('Column 1')] }, { column: [doc.text('Column 2')] }],
[{ column: [doc.text('Row 2, Col 1')] }, { column: [doc.text('Row 2, Col 2')] }]
]
doc.table(table_data)
چگونه جدول را با استایل سفارشی از طریق API روبی سفارشیسازی کنیم؟
table_options = {
table_width: 8000,
paddings: { top: 100, left: 100 },
sides_without_border: [:top, :bottom],
bold_sides: [:left, :right],
col_width: [4000, 4000]
}
doc.table(table_data, table_options)
اعمال صفحهبندی، شکست خط و صفحات جدید با روبی
کتابخانه منبعباز PureDocx گزینههای متنوعی برای کار با اسناد درون برنامه روبی فراهم کرده است. این کتابخانه به شما اجازه میدهد شمارههای صفحه را به راحتی به اسناد خود اضافه کنید. میتوانید موقعیت شمارههای صفحه را در پاورقی به صورت «چپ»، «راست» یا «وسط» مشخص کنید. میتوانید از متد brake برای افزودن شکست خط و از متد new_page برای شروع صفحه جدید استفاده کنید. مثال زیر نشان میدهد چگونه شکست خط اعمال کرده و صفحات جدید را در اسناد Word اضافه کنید.
چگونه شکست خط اعمال کرده و صفحات جدید را با روبی اضافه کنیم؟
doc.text('This is the first line.')
doc.brake
doc.text('This is the second line.')
doc.new_page
doc.text('This is on a new page.')
