1. Táirgí
  2.   Próiseáil Focal
  3.   Ruby
  4.   Caracal
 
  

API saor in aisce Ruby le haghaidh Cruthú & Próiseáil Focal  DOCX 

Leabharlann foinse oscailte Ruby a thugann an cumas do ríomhchláraitheoirí doiciméid Office Word gairmiúla a dhéanamh, comhaid DOCX a mhodhnú, imeall leathanaigh a chur leis, táblaí neadaithe a chur isteach ag baint úsáide as comhréir cosúil le HTML.

Tugann leabharlann Caracal an cumas d'fhorbróirí Ruby doiciméid Word Office gairmiúla a ghiniúint laistigh dá bhfeidhmchláir féin ag baint úsáide as comhréir HTML-mhaith. Déanann an leabharlann poist Fhorbróra éasca trí chur ar a gcumas roinnt orduithe simplí a úsáid chun Oifig Oscailte XML (OOXML) a chruthú agus a bhainistiú. Tá an leabharlann foinse oscailte agus tá sí ar fáil faoin gceadúnas MIT.

Tá an leabharlann deartha go han-mhaith agus scarann sé an treoir um pharsáil doiciméad ó na treoracha próiseála. Tugann an straitéis seo méid mór solúbthachta don phróiseas rindreála. Tá roinnt gnéithe tábhachtacha a bhaineann le próiseáil doiciméad Word ionchorpraithe ag an leabharlann ar nós cruthú doiciméad Word, socrú méid an leathanaigh, tacaíocht imill leathanaigh, briseadh leathanaigh, uimhreacha leathanaigh, tacaíocht clónna, tacaíocht stíleanna agus formáidiú, ag cur alt leis, ag baint úsáide as naisc agus leabharmharcanna, ag cur isteach táblaí, tacaíocht táblaí neadaithe, tacaíocht íomhánna agus go leor eile.

Previous Next

Tús a chur le Caracal

Cuir Gemfile an fheidhmchláir ordaithe seo a leanas leis le do thoil chun go mbeidh an leabharlann in úsáid go réidh.

Suiteáil Caracal trí chód a chur le Gemfile an Fheidhmchláir

 gem 'caracal'

Suiteáil Caracal trí chód a chur le Gemfile an Fheidhmchláir

bundle install

Cruthú Comhaid Word Docx ag baint úsáide as Ruby

Cuireann leabharlann foinse oscailte Caracal ar chumas forbróirí Ruby comhaid DOCX a ghiniúint taobh istigh dá gcuid apps ag baint úsáide as cód Ruby. Is bailiúchán zipped de dhoiciméid XML é formáid comhaid DOCX agus cruthaítear é trí úsáid a bhaint as an gcaighdeán OOXML. Cuidíonn an leabharlann le ríomhchláraitheoirí trí struchtúr iomlán an doiciméid a chruthú agus na doiciméid aschuir a zipped. Tacaíonn an leabharlann leis na comhaid atá ann cheana féin a mhodhnú, méid an leathanaigh a choigeartú, corrlaigh a shocrú, stíleanna a chur i bhfeidhm, agus go leor eile.

Cruthaigh Doiciméid Word trí Leabharlann Ruby Caracal

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

Cuir Táblaí agus Táblaí Neadaithe i gComhaid Word

Cuireann leabharlann Caracal saor in aisce ar chumas forbróirí bogearraí táblaí a chur leis agus a mhodhnú lena ndoiciméad Word le cúpla líne de chód Ruby. Áiríodh sa leabharlann roinnt feidhmeanna tábhachtacha a bhaineann le bainistiú táblaí, mar shampla teideal a chur leis, colúin agus sraitheanna nua a chur leis, an barr, an bun nó an taobh clé agus ar dheis a stíliú, cuir an stíl i bhfeidhm ar chill ar leith, cumasc nó scoilt cealla agus go leor eile. Áiríodh sa leabharlann freisin tacaíocht do bhoird neadaithe.

Úsáid Liostaí taobh istigh de Dhoiciméid Word

Áiríodh sa leabharlann foinse oscailte Caracal tacaíocht chun liostaí a úsáid taobh istigh de chomhaid DOCX ag baint úsáide as orduithe Ruby. Ceadaíonn an leabharlann liostaí ordaithe chomh maith le liostaí neamhordúil a chur taobh istigh de dhoiciméid focal. Tacaíonn sé freisin le liostaí neadaithe domhain agus meascadh i meascán eile. Is féidir leat stíleanna a shainiú go héasca do na liostaí. Tacaíonn an leabharlann le 9 leibhéal de stíleanna réamhshocraithe do liostaí ordaithe agus neamhordaithe.

Conas Liostaí a Úsáid taobh istigh de Dhoiciméid Word trí Leabharlann Ruby

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

Cuir Alt agus Leabharmharcanna isteach i gComhad DOCX

Tá feidhmiúlacht curtha ar fáil ag leabharlann Caracal chun alt a chur lena ndoiciméid Word gan stró. Tá roinnt feidhmeanna san áireamh sa leabharlann a bhaineann le láimhseáil míreanna, mar ailíniú téacs, roghnú clónna, sainmhíniú dath an chló agus socrú méid an chló, dath cúlra a shocrú, ailíniú ingearach a chur i bhfeidhm agus mar sin de. Soláthraíonn sé tacaíocht freisin chun leabharmharcanna a chur isteach go díreach sa doiciméad nó taobh istigh de bhloic ailt gan stró.

Cuir Leabharmharcanna le Doiciméid Word trí Leabharlann Ruby

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