1. Προϊόντα
  2.   Επεξεργασίας κειμένου
  3.   Ruby
  4.   Sablon
 
  

Ανοιχτής Πηγής Ruby Βιβλιοθήκη για τη Δημιουργία Αρχείων Word DOCX

Μια Ισχυρή Δωρεάν Ruby API που Επιτρέπει στους Προγραμματιστές Λογισμικού να Δημιουργούν Έγγραφα Word DOCX με ευκολία. Επιτρέπει το Σχεδιασμό του Εγγράφου's Layout, Apply Styles, and Use Mail Merge Fields as Placeholders for Dynamic Content.

Τι είναι η Βιβλιοθήκη Sablon;

Στον κόσμο της ανάπτυξης λογισμικού, η δημιουργία δυναμικών εγγράφων όπως αναφορές, τιμολόγια ή επιστολές είναι μια κοινή απαίτηση. Ενώ πολλές βιβλιοθήκες μπορούν να δημιουργήσουν έγγραφα από το μηδέν, συχνά απαιτούν έντονη καμπύλη εκμάθησης και επίπονο προγραμματισμό για να πετύχετε τη σωστή μορφοποίηση. Εδώ έρχεται το Sablon, μια ισχυρή ανοιχτού κώδικα Ruby βιβλιοθήκη, για να σώσει την κατάσταση. Το Sablon επαναπροσδιορίζει τη δημιουργία εγγράφων αξιοποιώντας την εξοικειωμένη χρήση του Microsoft Word και τη δύναμη της Ruby, επιτρέποντας τη δημιουργία σύνθετων και όμορφα μορφοποιημένων εγγράφων με ελάχιστη προσπάθεια. Υποστηρίζει λειτουργίες όπως η δημιουργία Word Docx, η εισαγωγή περιεχομένου μέσω πεδίων MailMerge, η προχωρημένη υποστήριξη μορφοποίησης, η προσθήκη σχολίων στα πρότυπα, η παραμετροποιήσιμη μετατροπή HTML & CSS και πολλά άλλα.

Στην ουσία, το Sablon είναι ένας επεξεργαστής προτύπων εγγράφων για αρχεία .docx. Χρησιμοποιεί την ενσωματωμένη λειτουργία Mail Merge του Word, επιτρέποντάς σας να δημιουργήσετε πρότυπα σε ένα οικείο περιβάλλον. Μπορείτε να σχεδιάσετε τη διάταξη του εγγράφου, να εφαρμόσετε στυλ και να χρησιμοποιήσετε πεδία Mail Merge ως δεσμευτικά θέσης για δυναμικό περιεχόμενο. Το Sablon παίρνει αυτό το πρότυπο και ένα πλαίσιο δεδομένων (ένα Ruby hash) για να παράγει ένα τελικό έγγραφο Word γεμάτο δεδομένα. Αυτή η προσέγγιση διαχωρίζει το επίπεδο παρουσίασης (το πρότυπο Word) από το επίπεδο δεδομένων (τον κώδικα Ruby), καθιστώντας τη διαδικασία δημιουργίας εγγράφων καθαρή και διαχειρίσιμη. Η σύνταξή του είναι διαισθητική για όποιον γνωρίζει Ruby και γλώσσες προτύπων. Είναι φιλική προς το σχεδιαστή, το περιεχόμενο και ο σχεδιασμός είναι εντελώς χωριστά. Οι σχεδιαστές μπορούν να δουλεύουν απευθείας στο Word χωρίς να αγγίζουν κώδικα.

Previous Next

Ξεκινώντας με το Sablon

Ο συνιστώμενος τρόπος εγκατάστασης του Sablon είναι η χρήση του RubyGems. Παρακαλώ χρησιμοποιήστε την παρακάτω εντολή για ομαλή εγκατάσταση.

Εγκατάσταση Εγγράφων μέσω RubyGems


gem 'sablon'
You can also download it directly from GitHub.

Εισαγωγή Περιεχομένου με Πεδία Word μέσω Ruby

Η πιο βασική λειτουργία είναι η εισαγωγή δυναμικού περιεχομένου. Η ανοιχτού κώδικα Ruby βιβλιοθήκη Sablon χρησιμοποιεί τη σύνταξη πεδίων του Word για τον ορισμό δεσμευτικών θέσεων. Στο πρότυπο Word σας, εισάγετε έναν κώδικα πεδίου όπου θέλετε να εμφανιστεί το δυναμικό περιεχόμενο. Το Sablon θα αντικαταστήσει αυτό το πεδίο με την τιμή σας. Το ακόλουθο παράδειγμα δείχνει πώς οι προγραμματιστές λογισμικού μπορούν να εισάγουν δυναμικά ένα κομμάτι περιεχομένου για να χαιρετήσουν έναν χρήστη.

Πώς να Εισάγετε Δυναμικά Περιεχόμενο Κειμένου σε Αρχείο Word Docs μέσω Ruby;

require 'sablon'

template = Sablon.template(File.expand_path('~/template.docx'))
context = {
  name: "Sarah Connor"
}

template.render_to_file(File.expand_path('~/output.docx'), context)

Template:

Hello, «name»! Welcome to our platform.

Output:
Hello, Sarah Connor! Welcome to our platform.

Μετατροπή HTML σε WordML

Ένα από τα χαρακτηριστικά που ξεχωρίζουν του Sablon είναι η ικανότητά του να μετατρέπει HTML σε WordProcessingML (τη μορφή XML που χρησιμοποιείται από αρχεία .docx). Αυτό είναι εξαιρετικά χρήσιμο όταν χρειάζεται να εισάγετε πλούσιο κειμενικό περιεχόμενο, όπως μορφοποιημένες παραγράφους, λίστες ή πίνακες, από μια βάση δεδομένων ή έναν πλούσιο επεξεργαστή κειμένου. Το Sablon θα μετατρέψει τη σειρά HTML σε μια σωστά μορφοποιημένη ενότητα στο έγγραφο Word, διατηρώντας τις επικεφαλίδες, το έντονο και πλάγιο κείμενο, καθώς και τη μορφοποίηση λιστών. Εδώ είναι ένα απλό παράδειγμα που δείχνει πώς να φορτώσετε ένα υπάρχον πρότυπο και να μετατρέψετε το περιεχόμενο HTML σε αρχείο Word Docx μέσα σε εφαρμογές Ruby.

Πώς να Μετατρέψετε Περιεχόμενο HTML σε Αρχείο Word Docx μέσω της Ruby Βιβλιοθήκης;

require "sablon"

template = Sablon.template(File.expand_path("template.docx"))

html_content = "
Αυτή είναι μια Υποεπικεφαλίδα
Αυτή είναι μια παράγραφος με έντονο και πλάγιο κείμενο.
  • Πρώτο στοιχείο
  • Δεύτερο στοιχείο
"

context = {
  article_content: Sablon.content(:html, html_content)
}

template.render_to_file(File.expand_path("output.docx"), context)

Conditional Rendering

Δυναμική Εισαγωγή Εικόνας μέσω Ruby

Η ανοιχτού κώδικα βιβλιοθήκη Sablon περιλαμβάνει μια χρήσιμη λειτουργία για τη δυναμική εισαγωγή εικόνων μέσα σε έγγραφα Word Docx χρησιμοποιώντας τη Ruby βιβλιοθήκη. Με μόνο λίγες γραμμές κώδικα, οι προγραμματιστές μπορούν να εισάγουν δυναμικά εικόνες στα έγγραφα τους. Μπορείτε να καθορίσετε ένα αρχείο εικόνας και το Sablon θα το ενσωματώσει στο έγγραφο. Το παρακάτω παράδειγμα δείχνει πώς να επιτύχετε δυναμική εισαγωγή εικόνας σε έγγραφα Word.

Πώς να Εισάγετε Δυναμικά Εικόνα σε Word Docx μέσω της Ruby Βιβλιοθήκης;


// You would have a placeholder image in your template with a special filename like «=company_logo».

context = {
  company_logo: Sablon.content(:image, "path/to/your/logo.png")
}

Απόδοση με Συνθήκες μέσω Ruby

Η βιβλιοθήκη Sablon υποστηρίζει μπλοκ υπό συνθήκες, επιτρέποντας στους χρήστες να εμφανίζουν ή να κρύβουν τμήματα του εγγράφου Word βάσει της παρουσίας ή της τιμής μιας μεταβλητής. Αυτό είναι ιδανικό για την προσαρμογή εγγράφων βάσει συγκεκριμένων συνθηκών. Για παράδειγμα, το παρακάτω παράδειγμα δείχνει πώς οι χρήστες μπορούν να θέσουν εντολές για απόκρυψη ή εμφάνιση συγκεκριμένων πληροφοριών μέσα σε ένα έγγραφο Word. Εάν η μεταβλητή show_extra_info είναι αληθής, το περιεχόμενο μεταξύ των ετικετών if και endIf θα συμπεριληφθεί στο τελικό έγγραφο. Εάν είναι ψευδής ή nil, το περιεχόμενο θα αφαιρεθεί.

Πώς να Προβάλετε ή Να Κρύψετε Μέρη των Εγγράφων Word Docx χρησιμοποιώντας Ruby;


context = {
  show_extra_info: true # or false
}
 Ελληνικά