Gratis Ruby API voor het maken en verwerken van Word DOCX 

Open source Ruby-bibliotheek die programmeurs de mogelijkheid geeft om professionele Office Word-documenten te maken, DOCX-bestanden aan te passen, paginamarges toe te voegen en geneste tabellen in te voegen met behulp van HTML-achtige syntaxis.

De Caracal-bibliotheek geeft Ruby-ontwikkelaars de mogelijkheid om professionele Office Word-documenten in hun eigen toepassingen te genereren met behulp van HTML-achtige syntaxis. De bibliotheek maakt het werk van ontwikkelaars gemakkelijk doordat ze enkele eenvoudige opdrachten kunnen gebruiken om Office Open XML (OOXML) te maken en te beheren. De bibliotheek is open source en is beschikbaar onder de MIT-licentie.

De bibliotheek is zeer goed ontworpen en scheidt de instructie voor het ontleden van documenten van de verwerkingsinstructies. Deze strategie geeft het weergaveproces een grote mate van flexibiliteit. De bibliotheek heeft verschillende belangrijke functies opgenomen met betrekking tot de verwerking van Word-documenten, zoals het maken van Word-documenten, het instellen van paginagrootte, ondersteuning van paginamarges, pagina-einde, paginanummers, ondersteuning van lettertypen, stijlen en opmaakondersteuning, het toevoegen van een alinea, het gebruik van koppelingen en bladwijzers, invoegen tabellen, ondersteuning voor geneste tabellen, ondersteuning voor afbeeldingen en nog veel meer.

Previous Next

Aan de slag met Caracal

Voeg de Gemfile van de volgende opdrachttoepassing toe voor een soepel gebruik van de bibliotheek.

Installeer Caracal door code toe te voegen aan Gemfile van de applicatie

 gem 'caracal'

Installeer Caracal door code toe te voegen aan Gemfile van de applicatie

bundle install

Word Docx-bestanden maken met Ruby

De open source Caracal-bibliotheek stelt Ruby-ontwikkelaars in staat om DOCX-bestanden in hun apps te genereren met behulp van Ruby-code. Het DOCX-bestandsformaat is een gecomprimeerde verzameling XML-documenten en is gemaakt met behulp van de OOXML-standaard. De bibliotheek helpt programmeurs door de volledige structuur van het document te maken en de uitvoerdocumenten te zippen. De bibliotheek ondersteunt het wijzigen van de bestaande bestanden, het aanpassen van de paginagrootte, het instellen van marges, het toepassen van stijlen en nog veel meer.

Vertaling:

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

Tabellen en geneste tabellen toevoegen in Word-bestanden

Met de gratis Caracal-bibliotheek kunnen softwareontwikkelaars tabellen toevoegen en wijzigen aan hun Word-document met slechts een paar regels Ruby-code. De bibliotheek heeft verschillende belangrijke functies met betrekking tot tabellenbeheer, zoals titel toevoegen, nieuwe kolommen en rijen toevoegen, boven, onder of links en rechts opmaken, stijl toepassen op een specifieke cel, cellen samenvoegen of splitsen en nog veel meer. De bibliotheek bevatte ook ondersteuning voor geneste tabellen.

Lijsten gebruiken in Word-documenten

De open source Caracal-bibliotheek biedt ondersteuning voor het gebruik van lijsten in DOCX-bestanden met behulp van Ruby-opdrachten. Met de bibliotheek kunnen zowel geordende als ongeordende lijsten in Word-documenten worden toegevoegd. Het ondersteunt ook diep geneste lijsten en mixen in andere combinaties. U kunt eenvoudig stijlen voor de lijsten definiëren. De bibliotheek ondersteunt 9 niveaus van standaardstijlen voor zowel geordende als ongeordende lijsten.

Hoe je Lists in Woord Documenten gebruikt via de bibliotheek

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

Alinea en bladwijzers invoegen in DOCX-bestand

De Caracal-bibliotheek heeft functionaliteit geboden om gemakkelijk alinea's aan hun Word-documenten toe te voegen. De bibliotheek heeft verschillende functies met betrekking tot het verwerken van alinea's, zoals tekstuitlijning, lettertypeselectie, het definiëren van de letterkleur en het instellen van de achtergrondkleur van de lettergrootte, het toepassen van verticale uitlijning enzovoort. Het biedt ook ondersteuning voor het gemakkelijk rechtstreeks invoegen van bladwijzers in het document of in alineablokken.

Voeg Bookmarks toe aan Woord Documenten via Ruby Bibliotheek

# 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
 Dutch