1. 제품
  2.   워드 프로세싱
  3.   Ruby
  4.   Sablon
 
  

Word DOCX 파일을 생성하는 오픈소스 Ruby 라이브러리

소프트웨어 개발자가 손쉽게 Word DOCX 문서를 생성할 수 있도록 돕는 강력한 무료 Ruby API입니다. 문서 설계가 가능합니다.'s Layout, Apply Styles, and Use Mail Merge Fields as Placeholders for Dynamic Content.

Sablon 라이브러리란?

소프트웨어 개발 분야에서는 보고서, 청구서, 서신 등 동적 문서를 생성하는 것이 일반적인 요구사항입니다. 많은 라이브러리가 처음부터 문서를 만들 수 있지만, 원하는 포맷을 맞추기 위해 학습 곡선이 가파르고 복잡한 코딩이 필요합니다. 여기서 강력한 오픈소스 Ruby 라이브러리인 Sablon이 해결책이 됩니다. Sablon은 Microsoft Word에 익숙한 환경과 Ruby의 파워를 활용해 최소한의 노력으로 복잡하고 아름답게 포맷된 문서를 만들 수 있게 문서 생성을 혁신합니다. Word Docx 생성, MailMerge 필드를 통한 콘텐츠 삽입, 고급 포맷 지원, 템플릿에 주석 추가, HTML & CSS 변환 설정 등 다양한 기능을 지원합니다.

핵심은 Sablon이 .docx 파일용 문서 템플릿 프로세서라는 것입니다. Word에 내장된 Mail Merge 기능을 활용하여 익숙한 환경에서 템플릿을 만들 수 있습니다. 문서 레이아웃을 설계하고 스타일을 적용하며, Mail Merge 필드를 동적 콘텐츠의 자리표시자로 사용할 수 있습니다. 그런 다음 Sablon은 이 템플릿과 데이터 컨텍스트(Ruby 해시)를 받아 최종 Word 문서를 생성합니다. 이 접근 방식은 프레젠테이션 계층(Word 템플릿)과 데이터 계층(Ruby 코드)을 분리하여 문서 생성 과정을 깔끔하고 유지보수하기 쉽게 합니다. Ruby와 템플릿 언어에 익숙한 사람이라면 직관적인 문법을 사용할 수 있습니다. 디자이너 친화적으로, 콘텐츠와 디자인이 완전히 분리됩니다. 디자이너는 코드를 건드리지 않고 직접 Word에서 작업할 수 있습니다.

Previous Next

Sablon 시작하기

Sablon 설치는 RubyGems를 사용하는 것이 권장됩니다. 원활한 설치를 위해 다음 명령을 사용하십시오.

RubyGems를 통한 문서 설치


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

Ruby를 통한 Word 필드로 콘텐츠 삽입

가장 기본적인 기능은 동적 콘텐츠 삽입입니다. 오픈소스 Ruby 라이브러리 Sablon은 Word에 내장된 필드 구문을 사용해 자리표시자를 정의합니다. Word 템플릿에 동적 콘텐츠를 삽입하고 싶은 위치에 필드 코드를 넣으면, Sablon이 해당 필드를 값으로 교체합니다. 다음 예시는 개발자가 사용자를 환영하는 콘텐츠를 동적으로 삽입하는 방법을 보여줍니다.

Ruby를 사용해 Word 문서 파일에 텍스트 콘텐츠를 동적으로 삽입하는 방법은?

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(.docx 파일에서 사용되는 XML 포맷)로 변환할 수 있다는 점입니다. 데이터베이스나 리치 텍스트 에디터에서 가져온 서식 있는 단락, 리스트, 테이블 등 풍부한 텍스트 콘텐츠를 삽입할 때 매우 유용합니다. Sablon은 HTML 문자열을 Word 문서의 적절히 포맷된 섹션으로 변환하며, 제목, 굵게 및 기울임 텍스트, 리스트 포맷을 보존합니다. 다음은 기존 템플릿을 로드하고 Ruby 애플리케이션 내에서 HTML 콘텐츠를 Word Docx 파일로 변환하는 간단한 예시입니다.

Ruby 라이브러리를 사용해 HTML 콘텐츠를 Word Docx 파일로 변환하는 방법은?

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 라이브러리는 Ruby를 이용해 Word Docx 문서에 이미지를 동적으로 삽입하는 유용한 기능을 포함하고 있습니다. 몇 줄의 코드만으로 개발자는 문서에 이미지를 동적으로 삽입할 수 있습니다. 이미지 파일을 지정하면 Sablon이 문서에 삽입합니다. 다음 예시는 Word 문서에 동적 이미지 삽입을 구현하는 방법을 보여줍니다.

Ruby 라이브러리를 사용해 Word Docx에 이미지를 동적으로 삽입하는 방법은?


// 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 문서의 일부를 표시하거나 숨길 수 있게 합니다. 이는 특정 조건에 따라 문서를 맞춤화하기에 최적입니다. 예를 들어, 아래 예시는 사용자가 특정 정보를 숨기거나 표시하도록 명령을 설정하는 방법을 보여줍니다. show_extra_info가 true이면 if와 endIf 태그 사이의 내용이 최종 문서에 포함되고, false 또는 nil이면 내용이 제거됩니다.

Ruby를 사용해 Word Docx 문서의 일부를 표시하거나 숨기는 방법은?


context = {
  show_extra_info: true # or false
}
 한국인