1. produkty
  2.   Zpracování textu
  3.   Ruby
  4.   PureDocx
 
  

Open Source Ruby API pro vytváření Word DOCX dokumentů

Vedoucí bezplatná Ruby knihovna, která umožňuje vývojářům softwaru vytvářet Word dokumenty, přidávat a přizpůsobovat tabulky, vkládat obrázky, aplikovat konce řádků a formátování textu do Word dokumentů v Ruby aplikacích.

Co je knihovna PureDocx?

Generování dynamických Microsoft Word dokumentů (.docx) z Ruby aplikace může být překvapivě složitý úkol. Můžete potřebovat generovat zprávy, faktury nebo dopisy, které vytvořili netechnické osoby. Ačkoliv existuje mnoho řešení, často vyžadují těžké závislosti jako LibreOffice nebo lokální instalace Wordu. Zde vstupuje Ruby-Docx-Templater, lehký gem, který zvolí odlišný přístup. Umožňuje uživatelům používat standardní .docx soubor jako šablonu, manipulovat s ním kompletně v paměti a vkládat jejich data. To je rychlá, bezpečná a nasazení přátelská volba pro každého Ruby vývojáře.

V jádru je Ruby-Docx-Templater knihovna templating engine speciálně pro .docx soubory. Je to lehký, výkonný Ruby gem navržený k vytváření dynamických Microsoft Word (.docx) dokumentů z předem navržených šablon. Funguje pomocí jednoduchého tagového systému v rámci standardního Word dokumentu. Vytvoříte šablonu ve Wordu, umístíte speciální tagy tam, kde chcete, aby se dynamický obsah objevil, a pak gem nahradí tyto tagy skutečnými daty z vaší Ruby aplikace. Jeho zpracování založené na paměti, podpora složitých struktur tabulek a zachování formátování z něj činí ideální nástroj pro automatizaci obchodních dokumentů.

Previous Next

Začínáme s PureDocx

Doporučený způsob instalace Ruby-Docx-Templater je pomocí RubyGems. Použijte následující příkaz pro hladkou instalaci.

Instalovat dokumentaci pomocí RubyGems

 gem install ruby-docx-templater

Jak vytvořit Word dokument v Ruby aplikacích?

 git clone https://github.com/jawspeak/ruby-docx-templater.git
You can also download it directly from GitHub.

Vytváření Word dokumentů pomocí Ruby

Nejzákladnější funkce Ruby-Docx-Templater je jednoduchá náhrada textu. Můžete umístit zástupné symboly kdekoliv ve vašem Word dokumentu a knihovna je nahradí skutečnými hodnotami. Krása tohoto přístupu je, že formátování zůstává zachováno. Pokud ve šabloně nastavíte $COMPANY_NAME$ tučně a červeně, výstup také bude mít tučný a červený text. To dává designerům plnou kontrolu nad vzhledem dokumentu. Ve vaší Word šabloně definujete klíče pomocí syntaxe $KEY$. Znak dolaru funguje jako oddělovač, čímž je jasné, kde mají být nahrazení provedena.

Jak aplikovat formátování textu ve Word dokumentech pomocí Ruby API?

require 'docx_templater'

# Load your template file
doc = DocxTemplater::TemplateProcessor.new('invoice_template.docx')

# Define your data as a hash
data = {
  'COMPANY_NAME' => 'Acme Corporation',
  'INVOICE_NUMBER' => 'INV-2024-001',
  'INVOICE_DATE' => '2024-11-04',
  'CLIENT_NAME' => 'John Smith',
  'TOTAL_AMOUNT' => '$1,250.00'
}

# Render the document with your data
doc.render(data)

# Save the output
doc.save('output_invoice.docx')

Použít formátování textu v dokumentech pomocí Ruby

Jedna z nejvýkonnějších funkcí je schopnost generovat dynamické tabulky s více řádky. To je nezbytné pro vytváření položkových seznamů na fakturách, produktových katalozích nebo jakékoli zprávě s opakujícími se daty. Definujete oblast smyčky ve své tabulce a knihovna duplikuje vše mezi těmito značkami pro každý položku ve vašem datovém poli. Můžete formátovat každou buňku individuálně ve Wordu. Například můžete zarovnat čísla vpravo, udělat nadpisy tučnými nebo použít konkrétní písma. Veškeré formátování bude zachováno v generovaných řádcích.

Jak vytvořit jednoduchou tabulku v Ruby aplikacích?

require 'docx_templater'

doc = DocxTemplater::TemplateProcessor.new('product_report.docx')

# Define items as an array of hashes
data = {
  'REPORT_TITLE' => 'Monthly Sales Report',
  'REPORT_DATE' => 'November 2024',
  'ITEMS_LIST' => [
    {
      'PRODUCT_NAME' => 'Laptop Pro 15"',
      'QUANTITY' => '5',
      'UNIT_PRICE' => '$1,200.00',
      'TOTAL' => '$6,000.00'
    },
    {
      'PRODUCT_NAME' => 'Wireless Mouse',
      'QUANTITY' => '12',
      'UNIT_PRICE' => '$25.00',
      'TOTAL' => '$300.00'
    },
    {
      'PRODUCT_NAME' => 'USB-C Cable',
      'QUANTITY' => '20',
      'UNIT_PRICE' => '$15.00',
      'TOTAL' => '$300.00'
    }
  ]
}

doc.render(data)
doc.save('output_sales_report.docx')

Vytvářet a přizpůsobovat tabulky ve Word souborech pomocí Ruby

Open source Ruby-Docx-Templater knihovna je velmi snadno ovladatelná a podporuje zpracování v paměti uvnitř Ruby aplikací. Veškerá manipulace s dokumentem probíhá v paměti, což znamená, že vaše citlivá data nikdy během procesu šablonování nedotýkají souborového systému. To je klíčové pro aplikace pracující s důvěrnými informacemi, jako jsou lékařské záznamy, finanční dokumenty nebo osobní data.

Použít stránkování, konce řádků a nové stránky pomocí Ruby

Jedinečná vlastnost Ruby-Docx-Templater je, že někdy musíte ručně upravit podkladové XML vašeho Word dokumentu. Word často vkládá značky formátování, které mohou rozdělit klíče vaší šablony, čímž se přeruší proces náhrady. Když napíšete $CUSTOMER_NAME$ ve Wordu, může se na obrazovce zobrazit správně, ale podkladové XML může vypadat takto.

 Čeština