Nemokama Ruby API, skirta Word DOCX kūrimui ir apdorojimui
Atvirojo kodo „Ruby“ biblioteka, suteikianti programuotojams galimybę kurti profesionalius „Office Word“ dokumentus, modifikuoti DOCX failus, pridėti puslapio paraštes, įterpti įdėtas lenteles naudojant į HTML panašią sintaksę.
Caracal biblioteka suteikia Ruby kūrėjams galimybę generuoti profesionalius Office Word dokumentus savo programose naudojant į HTML panašią sintaksę. Biblioteka palengvina kūrėjų darbus, nes jie gali naudoti keletą paprastų komandų, skirtų kurti ir valdyti „Office Open XML“ (OOXML). Biblioteka yra atvirojo kodo ir yra prieinama pagal MIT licenciją.
Biblioteka yra labai gerai suprojektuota ir atskiria dokumentų analizavimo instrukcijas nuo apdorojimo instrukcijų. Ši strategija suteikia atvaizdavimo procesui daug lankstumo. Bibliotekoje yra keletas svarbių funkcijų, susijusių su Word dokumentų apdorojimu, pvz., Word dokumentų kūrimas, puslapio dydžio nustatymas, puslapio paraščių palaikymas, puslapio lūžis, puslapių numeriai, šriftų palaikymas, stilių ir formatavimo palaikymas, pastraipos pridėjimas, nuorodų ir žymių naudojimas, įterpimas. lentelės, įdėtųjų lentelių palaikymas, vaizdų palaikymas ir daug daugiau.
Darbo su Caracal pradžia
Norėdami sklandžiai naudotis biblioteka, pridėkite šios komandos programos Gemfile.
Įdiekite Caracal pridėdami kodą prie programos „Gemfile“.
gem 'caracal'
Įdiekite Caracal pridėdami kodą prie programos „Gemfile“.
bundle install
„Word Docx“ failų kūrimas naudojant „Ruby“.
Atvirojo kodo Caracal biblioteka leidžia Ruby kūrėjams generuoti DOCX failus savo programose naudojant Ruby kodą. DOCX failo formatas yra XML dokumentų rinkinys, sukurtas naudojant OOXML standartą. Biblioteka padeda programuotojams sukurti visą dokumento struktūrą ir supakuoti išvesties dokumentus. Biblioteka palaiko esamų failų modifikavimą, puslapio dydžio reguliavimą, paraščių nustatymą, stilių taikymą ir dar daugiau.
Kurkite „Word“ dokumentus naudodami Ruby Caracal biblioteką
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
Pridėkite lenteles ir įdėtas lenteles „Word“ failuose
Nemokama Caracal biblioteka leidžia programinės įrangos kūrėjams pridėti ir modifikuoti lenteles į savo Word dokumentą naudojant tik kelias Ruby kodo eilutes. Bibliotekoje yra keletas svarbių funkcijų, susijusių su lentelių valdymu, pvz., pavadinimo pridėjimas, naujų stulpelių ir eilučių pridėjimas, viršutinės, apatinės arba kairės ir dešinės pusės stiliaus kūrimas, stiliaus pritaikymas konkrečiam langeliui, langelių sujungimas arba padalijimas ir daug daugiau. Biblioteka taip pat apėmė įdėtųjų lentelių palaikymą.
Naudokite sąrašus Word dokumentuose
Atvirojo kodo „Caracal“ bibliotekoje buvo palaikomas sąrašų naudojimas DOCX failuose naudojant „Ruby“ komandas. Biblioteka leidžia į Word dokumentus įtraukti sutvarkytus ir netvarkingus sąrašus. Jis taip pat palaiko gilius įdėtus sąrašus ir maišymą kitais deriniais. Galite lengvai apibrėžti sąrašų stilius. Biblioteka palaiko 9 numatytųjų stilių lygius tiek sutvarkytiems, tiek netvarkingiems sąrašams.
Kaip naudoti sąrašus Word dokumentuose per Ruby biblioteką
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
Įdėkite pastraipą ir žymes į DOCX failą
„Caracal“ biblioteka suteikė galimybę lengvai pridėti pastraipas į „Word“ dokumentus. Bibliotekoje yra keletas funkcijų, susijusių su pastraipų tvarkymu, pvz., teksto lygiavimas, šriftų pasirinkimas, šrifto spalvos ir šrifto dydžio nustatymo fono spalvos nustatymas, vertikalaus lygiavimo taikymas ir pan. Ji taip pat padeda lengvai įterpti žymes tiesiai į dokumentą arba pastraipų blokuose.
Pridėkite žymes prie „Word“ dokumentų per „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