1. Produtos
  2.   Processamento de texto
  3.   Ruby
  4.   Caracal
 
  

API Ruby gratuita para Word  Criação e processamento de DOCX 

Biblioteca Ruby de código aberto que oferece aos programadores a capacidade de criar documentos profissionais do Office Word, modificar arquivos DOCX, adicionar margens de página, inserir tabelas aninhadas usando sintaxe semelhante a HTML.

A biblioteca Caracal oferece aos desenvolvedores Ruby a capacidade de gerar documentos profissionais do Office Word dentro de seus próprios aplicativos usando sintaxe semelhante a HTML. A biblioteca facilita o trabalho do desenvolvedor, permitindo que eles usem alguns comandos simples para criar e gerenciar o Office Open XML (OOXML). A biblioteca é de código aberto e está disponível sob a licença do MIT.

A biblioteca é muito bem projetada e separa a instrução de análise de documentos das instruções de processamento. Essa estratégia dá ao processo de renderização uma grande flexibilidade. A biblioteca incorporou vários recursos importantes relacionados ao processamento de documentos do Word, como criação de documentos do Word, configuração do tamanho da página, suporte às margens da página, quebra de página, números de página, suporte a fontes, suporte a estilos e formatação, adição de um parágrafo, uso de links e marcadores, inserção de tabelas, suporte a tabelas aninhadas, suporte a imagens e muito mais.

Previous Next

Introdução ao Caracal

Adicione o Gemfile do aplicativo de comando a seguir para um uso suave da biblioteca.

Instale o Caracal adicionando código ao Gemfile do aplicativo

 gem 'caracal'

Instale o Caracal adicionando código ao Gemfile do aplicativo

bundle install

Criação de arquivos Word Docx usando Ruby

A biblioteca de código aberto Caracal permite que desenvolvedores Ruby gerem arquivos DOCX dentro de seus aplicativos usando código Ruby. O formato de arquivo DOCX é uma coleção compactada de documentos XML e é criada usando o padrão OOXML. A biblioteca ajuda os programadores criando toda a estrutura do documento e compactando os documentos de saída. A biblioteca suporta modificar os arquivos existentes, ajustar o tamanho da página, definir margens, aplicar estilos e muito mais.

Criar documentos do Word via Ruby Caracas Library

Caracal::Document.save 'example.docx' do |docx|
  # page 1
  docx.h1 'Page 1 Header'
  docx.hr
  docx.p
  docx.h2 'Section 1'
  docx.p  'Lorem ipsum dolor....'
  docx.p
  docx.table @my_data, border_size: 4 do
    cell_style rows[0], background: 'cccccc', bold: true
  end
  # page 2
  docx.page
  docx.h1 'Page 2 Header'
  docx.hr
  docx.p
  docx.h2 'Section 2'
  docx.p  'Lorem ipsum dolor....'
  docx.ul do
    li 'Item 1'
    li 'Item 2'
  end
  docx.p
  docx.img 'https://www.example.com/logo.png', width: 500, height: 300
end

Adicionar tabelas e tabelas aninhadas em arquivos do Word

A biblioteca gratuita Caracal permite que desenvolvedores de software adicionem e modifiquem tabelas em seus documentos do Word com apenas algumas linhas de código Ruby. A biblioteca inclui várias funções importantes relacionadas ao gerenciamento de tabelas, como adicionar título, adicionar novas colunas e linhas, estilizar a parte superior, inferior ou esquerda e direita, aplicar estilo a uma célula específica, mesclar ou dividir células e muito mais. A biblioteca também inclui suporte para tabelas aninhadas.

Use listas dentro de documentos do Word

A biblioteca de código aberto Caracal incluiu suporte para usar listas dentro de arquivos DOCX usando comandos Ruby. A biblioteca permite adicionar listas ordenadas e não ordenadas dentro de documentos do Word. Ele também suporta listas aninhadas profundas e mixagem em outras combinações. Você pode definir facilmente estilos para as listas. A biblioteca suporta 9 níveis de estilos padrão para listas ordenadas e não ordenadas.

Como usar listas dentro de documentos do Word via Ruby Library

docx.ol do
  li 'First item'
  li do
    text 'Second item with a '
    link 'link', 'http://www.google.com'
    text '.'
    br
    text 'This sentence follows a line break.'
  end
end

Inserir parágrafo e marcadores no arquivo DOCX

A biblioteca Caracal forneceu funcionalidade para adicionar parágrafos aos documentos do Word com facilidade. A biblioteca incluiu várias funções relacionadas ao tratamento de parágrafos, como alinhamento de texto, seleção de fontes, definição de cor de fonte e tamanho de fonte, configuração de cor de fundo, aplicação de alinhamento vertical e assim por diante. Ele também fornece suporte para inserir marcadores diretamente no documento ou dentro de blocos de parágrafo com facilidade.

Adicionar Bookmarks para Documentos do Word via Ruby Library

# document-level bookmark
dox.bookmark_start id: 's1', name: 'section1'
docx.h2 'Section Heading'
docx.bookmark_end id: 's1'
docx.p  'Section content.'
# pargraph-level bookmark
docx.h2 'Section Heading'
docx.p do
  text 'Pretend this paragraph has a lot of text and we want to bookmark '
  bookmark_start id: 'p1', name: 'phrase1'
  text 'a single phrase'
  bookmark_end id: 'p1'
  text ' inside the larger block.'
end
 Português