1. Prodotti
  2.   Elaborazione di testi
  3.   Ruby
  4.   Caracal
 
  

API Ruby gratuita per la creazione e l'elaborazione di Word DOCX 

Libreria Ruby open source che offre ai programmatori la possibilità di creare documenti Office Word professionali, modificare file DOCX, aggiungere margini di pagina, inserire tabelle nidificate utilizzando una sintassi simile a HTML.

La libreria Caracal offre agli sviluppatori Ruby la capacità di generare documenti Office Word professionali all'interno delle proprie applicazioni utilizzando una sintassi simile a HTML. La libreria semplifica il lavoro degli sviluppatori consentendo loro di utilizzare alcuni semplici comandi per creare e gestire Office Open XML (OOXML). La libreria è open source ed è disponibile con licenza MIT.

La libreria è molto ben progettata e separa le istruzioni per l'analisi dei documenti dalle istruzioni per l'elaborazione. Questa strategia offre al processo di rendering una grande flessibilità. La libreria ha incorporato diverse importanti funzionalità relative all'elaborazione di documenti di Word come la creazione di documenti di Word, l'impostazione della dimensione della pagina, il supporto dei margini di pagina, l'interruzione di pagina, i numeri di pagina, il supporto dei caratteri, gli stili e il supporto della formattazione, l'aggiunta di un paragrafo, l'utilizzo di collegamenti e segnalibri, l'inserimento tabelle, supporto per tabelle nidificate, supporto per immagini e molti altri.

Previous Next

Iniziare con Caracal

Si prega di aggiungere il Gemfile della seguente applicazione di comando per un uso regolare della libreria.

Installa Caracal aggiungendo il codice al Gemfile dell'applicazione

 gem 'caracal'

Installa Caracal aggiungendo il codice al Gemfile dell'applicazione

bundle install

Creazione di file Word Docx utilizzando Ruby

La libreria Caracal open source consente agli sviluppatori Ruby di generare file DOCX all'interno delle loro app utilizzando il codice Ruby. Il formato file DOCX è una raccolta zippata di documenti XML e viene creato utilizzando lo standard OOXML. La libreria aiuta i programmatori creando l'intera struttura del documento e zippando i documenti di output. La libreria supporta la modifica dei file esistenti, la regolazione delle dimensioni della pagina, l'impostazione dei margini, l'applicazione di stili e molto altro.

Creare documenti di 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

Aggiungi tabelle e tabelle nidificate nei file di Word

La libreria gratuita Caracal consente agli sviluppatori di software di aggiungere e modificare tabelle al proprio documento Word con solo un paio di righe di codice Ruby. La libreria ha incluso diverse importanti funzioni relative alla gestione delle tabelle come aggiungere titolo, aggiungere nuove colonne e righe, applicare lo stile in alto, in basso o a sinistra e a destra, applicare lo stile a una cella specifica, unire o dividere celle e molto altro. La libreria includeva anche il supporto per le tabelle nidificate.

Usa gli elenchi all'interno dei documenti di Word

La libreria Caracal open source ha incluso il supporto per l'utilizzo di elenchi all'interno di file DOCX utilizzando i comandi Ruby. La libreria consente di aggiungere elenchi ordinati e non ordinati all'interno di documenti Word. Supporta anche elenchi nidificati profondi e la miscelazione in altre combinazioni. È possibile definire facilmente gli stili per le liste. La libreria supporta 9 livelli di stili predefiniti sia per gli elenchi ordinati che per quelli non ordinati.

Come usare liste all'interno di documenti 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

Inserisci paragrafo e segnalibri nel file DOCX

La libreria Caracal ha fornito funzionalità per aggiungere facilmente paragrafi ai propri documenti di Word. La libreria ha incluso diverse funzioni relative alla gestione dei paragrafi, come l'allineamento del testo, la selezione dei caratteri, la definizione del colore del carattere e l'impostazione della dimensione del carattere del colore di sfondo, l'applicazione dell'allineamento verticale e così via. Fornisce inoltre supporto per inserire facilmente segnalibri direttamente nel documento o all'interno di blocchi di paragrafo.

Aggiungi segnalibri ai documenti di 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
 Italiano