API Ruby Open Source para Criar Documentos Word DOCX
Uma Biblioteca Ruby Gratuita de Destaque que Permite a Desenvolvedores Criar Documentos Word, Adicionar & Personalizar Tabelas, Inserir Imagens, Aplicar Quebra de Linha e Formatação de Texto em Documentos Word dentro de Aplicativos Ruby.
O que é a Biblioteca PureDocx?
No mundo acelerado do desenvolvimento de software, eficiência e simplicidade são essenciais. A geração de documentos é uma tarefa comum, e ao converter conteúdo HTML para documentos Microsoft Word, os desenvolvedores frequentemente buscam soluções confiáveis e diretas. É aí que entra o Sablon, uma poderosa biblioteca Ruby de código aberto. O Sablon revoluciona a geração de documentos ao aproveitar a familiaridade do Microsoft Word e o poder do Ruby, permitindo criar documentos complexos e belamente formatados com esforço mínimo. Ele suporta recursos como criação de Word Docx, inserção de conteúdo via campos MailMerge, suporte avançado de formatação, adição de anotações em templates, conversão configurável de HTML & CSS e muito mais.
Na sua essência, o Sablon é um processador de templates de documentos para arquivos .docx. Ele utiliza a funcionalidade incorporada de Mail Merge do Word, permitindo criar templates em um ambiente familiar. Você pode projetar o layout do documento, aplicar estilos e usar campos Mail Merge como placeholders para conteúdo dinâmico. O Sablon então pega esse template e um contexto de dados (um hash Ruby) para produzir um documento Word final, preenchido com dados. Essa abordagem separa a camada de apresentação (o template Word) da camada de dados (seu código Ruby), tornando o processo de geração de documentos limpo e fácil de manter. Sua sintaxe é intuitiva para quem conhece Ruby e linguagens de templates. É amigável ao designer; o conteúdo e o design estão totalmente separados. Designers podem trabalhar diretamente no Word sem tocar no código.
Começando com PureDocx
A forma recomendada de instalar o PureDocx é usando RubyGems. Por favor, use o comando a seguir para uma instalação tranquila.
Instalar Documentação via RubyGems
$ gem 'puredocx
// Or install it yourself as
$ gem install PureDocx
Criação de Documentos Word via Ruby
A biblioteca open source PureDocx inclui suporte completo para criar e gerenciar documentos Word dentro de aplicações Ruby. Em sua essência, o PureDocx permite definir um documento com cabeçalho e conteúdo. O cabeçalho aparecerá em cada página do documento, enquanto o conteúdo fluirá de uma página para a outra. Desenvolvedores podem aplicar vários tipos de formatação, adicionar tabelas e imagens e inserir conteúdo com facilidade. Aqui está um exemplo básico que mostra como criar um documento Word usando comandos Ruby.
Como Criar um Documento Word dentro de Aplicativos Ruby?
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
Aplicar Formatação de Texto em Documentos via Ruby
A biblioteca Ruby PureDocx facilita para os desenvolvedores criar e aplicar vários tipos de estilos e formatações ao conteúdo dentro de documentos Word. A biblioteca oferece uma variedade de opções para formatar texto, incluindo estilos negrito ou itálico, definição do tamanho da fonte, alinhamento do texto à esquerda, centro ou direita, entre outros. Aqui está um exemplo simples que demonstra como os desenvolvedores podem aplicar diferentes opções de formatação ao texto dentro de um documento Word.
Como Aplicar Formatação de Texto em Documentos Word via API Ruby?
Criar & Personalizar Tabelas em Arquivos Word via Ruby
As tabelas são uma forma poderosa de organizar e exibir dados dentro dos seus documentos. A biblioteca PureDocx facilita a criação de tabelas com estilo personalizado dentro de documentos Word via biblioteca Ruby. Os desenvolvedores também podem personalizar a aparência de suas tabelas com diversas opções, como definir a largura da tabela, definir o preenchimento superior e esquerdo das células, especificar quais lados da tabela não devem ter borda, definir a largura de colunas individuais, especificar quais lados da tabela devem ter borda em negrito, etc. O exemplo a seguir mostra como criar uma tabela simples dentro de aplicações Ruby.
Como Criar uma Tabela Simples dentro de Aplicativos Ruby?
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)
Como Personalizar uma Tabela com Estilo Customizado via API Ruby?
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)
Aplicar Paginação, Quebra de Linha & Novas Páginas via Ruby
A biblioteca open source PureDocx oferece várias opções para lidar com documentos de trabalho dentro de aplicação Ruby. A biblioteca permite adicionar números de página aos seus documentos com facilidade. Você pode especificar a posição dos números de página no rodapé como 'esquerda', 'direita' ou 'centro'. Você pode usar o método brake para inserir uma quebra de linha e o método new_page para iniciar uma nova página. O exemplo a seguir mostra como aplicar quebras de linha e adicionar novas páginas em documentos Word.
Como Aplicar Quebras de Linha e Adicionar Novas Páginas via Ruby?
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.')
