1. Des produits
  2.   Traitement de texte
  3.   Ruby
  4.   Caracal
 
  

API Ruby gratuite pour la création et le traitement Word DOCX 

Bibliothèque Ruby open source qui donne aux programmeurs la possibilité de créer des documents Office Word professionnels, de modifier des fichiers DOCX, d'ajouter des marges de page, d'insérer des tableaux imbriqués à l'aide d'une syntaxe de type HTML.

La bibliothèque Caracal donne aux développeurs Ruby la possibilité de générer des documents Office Word professionnels dans leurs propres applications en utilisant une syntaxe de type HTML. La bibliothèque facilite le travail des développeurs en leur permettant d'utiliser des commandes simples pour créer et gérer Office Open XML (OOXML). La bibliothèque est open source et est disponible sous licence MIT.

La bibliothèque est très bien conçue et elle sépare les instructions d'analyse de documents des instructions de traitement. Cette stratégie donne au processus de rendu une grande flexibilité. La bibliothèque a intégré plusieurs fonctionnalités importantes liées au traitement de documents Word, telles que la création de documents Word, la définition de la taille de la page, la prise en charge des marges de page, les sauts de page, les numéros de page, la prise en charge des polices, la prise en charge des styles et de la mise en forme, l'ajout d'un paragraphe, l'utilisation de liens et de signets, l'insertion tables, prise en charge des tables imbriquées, prise en charge des images et bien d'autres.

Previous Next

Démarrer avec Caracal

Veuillez ajouter le Gemfile de l'application de commande suivante pour une utilisation fluide de la bibliothèque.

Installez Caracal en ajoutant du code au Gemfile de l'application

 gem 'caracal'

Installez Caracal en ajoutant du code au Gemfile de l'application

bundle install

Création de fichiers Word Docx avec Ruby

La bibliothèque open source Caracal permet aux développeurs Ruby de générer des fichiers DOCX dans leurs applications à l'aide de code Ruby. Le format de fichier DOCX est une collection compressée de documents XML et est créé à l'aide de la norme OOXML. La bibliothèque aide les programmeurs en créant la structure entière du document et en compressant les documents de sortie. La bibliothèque prend en charge la modification des fichiers existants, l'ajustement de la taille de la page, la définition des marges, l'application de styles, etc.

Créer des documents Word par la bibliothèque Ruby Caracas

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

Ajouter des tableaux et des tableaux imbriqués dans des fichiers Word

La bibliothèque gratuite Caracal permet aux développeurs de logiciels d'ajouter et de modifier des tableaux à leur document Word avec seulement quelques lignes de code Ruby. La bibliothèque comprend plusieurs fonctions importantes liées à la gestion des tableaux, telles que l'ajout d'un titre, l'ajout de nouvelles colonnes et lignes, le style en haut, en bas ou à gauche et à droite, l'application d'un style à une cellule spécifique, la fusion ou la division de cellules et bien d'autres. La bibliothèque incluait également la prise en charge des tables imbriquées.

Utiliser des listes dans des documents Word

La bibliothèque open source Caracal a inclus la prise en charge de l'utilisation de listes dans des fichiers DOCX à l'aide de commandes Ruby. La bibliothèque permet d'ajouter des listes ordonnées et non ordonnées dans des documents Word. Il prend également en charge les listes imbriquées profondes et le mélange dans d'autres combinaisons. Vous pouvez facilement définir des styles pour les listes. La bibliothèque prend en charge 9 niveaux de styles par défaut pour les listes ordonnées et non ordonnées.

Comment utiliser les listes à l'intérieur des documents Word par la bibliothèque en caoutchouc

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

Insérer un paragraphe et des signets dans le fichier DOCX

La bibliothèque Caracal a fourni une fonctionnalité permettant d'ajouter facilement des paragraphes à leurs documents Word. La bibliothèque a inclus plusieurs fonctions liées à la gestion des paragraphes, telles que l'alignement du texte, la sélection des polices, la définition de la couleur et de la taille de la police, la définition de la couleur d'arrière-plan, l'alignement vertical, etc. Il permet également d'insérer facilement des signets directement dans le document ou à l'intérieur de blocs de paragraphes.

Ajouter les documents en format Word par la bibliothèque en caoutchouc

# 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
 Français