1. Tuotteet
  2.   Tekstinkäsittely
  3.   Ruby
  4.   Caracal
 
  

Ilmainen Ruby API Word DOCX:n luomiseen ja käsittelyyn 

Avoimen lähdekoodin Ruby-kirjasto, joka antaa ohjelmoijille mahdollisuuden tehdä ammattimaisia Office Word -asiakirjoja, muokata DOCX-tiedostoja, lisätä sivun marginaaleja ja lisätä sisäkkäisiä taulukoita HTML-kaltaisella syntaksilla.

Caracal-kirjasto antaa Ruby-kehittäjille mahdollisuuden luoda ammattimaisia Office Word -asiakirjoja omissa sovelluksissaan HTML-kaltaisella syntaksilla. Kirjasto tekee kehittäjien työstä helppoa mahdollistamalla joidenkin yksinkertaisten komentojen avulla luoda ja hallita Office Open XML:ää (OOXML). Kirjasto on avoimen lähdekoodin ja on saatavilla MIT-lisenssillä.

Kirjasto on erittäin hyvin suunniteltu ja se erottaa dokumenttien jäsentämisohjeet käsittelyohjeista. Tämä strategia antaa renderöintiprosessille paljon joustavuutta. Kirjastossa on useita tärkeitä Word-asiakirjojen käsittelyyn liittyviä ominaisuuksia, kuten Word-dokumenttien luonti, sivun koon asettaminen, sivumarginaalien tuki, sivunvaihto, sivunumerot, fonttituki, tyyli- ja muotoilutuki, kappaleen lisääminen, linkkien ja kirjanmerkkien käyttö, lisäys taulukot, sisäkkäisten taulukoiden tuki, kuvien tuki ja paljon muuta.

Previous Next

Caracalin käytön aloittaminen

Lisää seuraavan komentosovelluksen Gemfile kirjaston sujuvaa käyttöä varten.

Asenna Caracal lisäämällä koodi sovelluksen Gemfile-tiedostoon

 gem 'caracal'

Asenna Caracal lisäämällä koodi sovelluksen Gemfile-tiedostoon

bundle install

Word Docx -tiedostojen luominen Rubylla

Avoimen lähdekoodin Caracal-kirjaston avulla Ruby-kehittäjät voivat luoda DOCX-tiedostoja sovelluksiensa sisällä Ruby-koodin avulla. DOCX-tiedostomuoto on pakattu kokoelma XML-dokumentteja, ja se on luotu OOXML-standardia käyttäen. Kirjasto auttaa ohjelmoijia luomalla asiakirjan koko rakenteen ja pakkaamalla sen tulosteet. Kirjasto tukee olemassa olevien tiedostojen muokkaamista, sivun koon säätämistä, marginaalien asettelua, tyylien käyttöä ja paljon muuta.

Luo Word-asiakirjoja Ruby Caracal -kirjaston kautta

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

Lisää taulukoita ja sisäkkäisiä taulukoita Word-tiedostoihin

Ilmaisen Caracal-kirjaston avulla ohjelmistokehittäjät voivat lisätä ja muokata taulukoita Word-asiakirjaansa vain parilla Ruby-koodirivillä. Kirjastossa on useita tärkeitä taulukoiden hallintaan liittyviä toimintoja, kuten otsikon lisääminen, uusien sarakkeiden ja rivien lisääminen, ylä-, ala- tai vasemman- ja oikeanpuoleisen tyylin muokkaaminen, tyylin käyttäminen tietyssä solussa, solujen yhdistäminen tai jakaminen ja paljon muuta. Kirjasto sisälsi myös tuen sisäkkäisille taulukoille.

Käytä Word-asiakirjojen luetteloita

Avoimen lähdekoodin Caracal-kirjastossa on tuki DOCX-tiedostojen sisällä olevien luetteloiden käyttämiselle Ruby-komentojen avulla. Kirjasto mahdollistaa sekä järjestetyn että järjestämättömän luettelon lisäämisen Word-asiakirjoihin. Se tukee myös syviä sisäkkäisiä listoja ja sekoittamista muissa yhdistelmissä. Voit määrittää luetteloille helposti tyylit. Kirjasto tukee 9 tasoa oletustyyliä sekä järjestetyille että järjestämättömille listoille.

Listojen käyttäminen Word-asiakirjojen sisällä Ruby-kirjaston kautta

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

Lisää kappale ja kirjanmerkit DOCX-tiedostoon

Caracal-kirjasto on tarjonnut toiminnot kappaleiden lisäämiseen Word-asiakirjoihin helposti. Kirjastossa on useita kappaleiden käsittelyyn liittyviä toimintoja, kuten tekstin tasaus, fonttien valinta, fontin värin ja fonttikoon asettamisen taustaväri, pystytasauksen soveltaminen ja niin edelleen. Se tukee myös kirjanmerkkien lisäämistä suoraan asiakirjaan tai kappalelohkojen sisään helposti.

Lisää kirjanmerkkejä Word-asiakirjoihin Ruby-kirjaston kautta

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