C#에서 html2pdf 페이지 나누기 고정 (개발자 튜토리얼)

IronPDF: C# PDF 라이브러리

IronPDF는 개발자, 초보자 또는 전문가에게 PDF를 완전히 조작하고 편집할 수 있는 유연하고 사용하기 쉬우며 고도로 사용자 정의 가능한 C# PDF 라이브러리입니다. HTML, RTF, 이미지 등 여러 형식을 PDF로 변환하고, PDF로 변환할 때 렌더링 방식을 더 편집할 수 있는 다양한 방법을 제공합니다. 또한, IronPDF는 Chrome 렌더링 엔진을 활용하므로 HTML 문자열을 렌더링하는 데 매우 능숙하며, CSS 스타일링을 사용하여 HTML 문서를 더욱 사용자 정의할 수 있어 다른 곳에서는 찾기 힘든 맞춤화와 시각적 표현의 이점을 제공합니다.

라이브러리가 Chrome 렌더링 엔진을 사용하기 때문에 HTML 렌더링 시 보이는 대로 나타나므로, 템플릿과 불일치가 없는 페이지 구분과 같은 템플릿을 만드는 작업에 이상적입니다. PDF로 변환할 때 템플릿을 설계한 그대로입니다.

PDF에 페이지 구분 추가

라이브러리의 유연성과 사용의 용이성을 설명하기 위해, 코드 예제를 사용하여 프로그램적으로 페이지 구분을 추가하는 방법을 보여드리겠습니다.

이 시나리오에서는 입력으로 테이블 기반 PDF를 사용하며, 시각적 명확성을 위해 페이지 구분을 즉시 추가하는 것과 나중에 추가하는 것의 차이점을 보겠습니다.

// Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

// Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

' Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"

using IronPdf; // Import the IronPdf library

// Define the HTML content, including a table and an image
const string html = @"
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>
  <div style='page-break-after: always;'> </div> 
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Create an instance of ChromePdfRenderer
var renderer = new ChromePdfRenderer();

// Render the HTML content into a PDF
var pdf = renderer.RenderHtmlAsPdf(html);

// Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf");

using IronPdf; // Import the IronPdf library

// Define the HTML content, including a table and an image
const string html = @"
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>
  <div style='page-break-after: always;'> </div> 
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Create an instance of ChromePdfRenderer
var renderer = new ChromePdfRenderer();

// Render the HTML content into a PDF
var pdf = renderer.RenderHtmlAsPdf(html);

// Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf");

Imports IronPdf ' Import the IronPdf library

' Define the HTML content, including a table and an image
Const html As String = "
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>
  <div style='page-break-after: always;'> </div> 
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Create an instance of ChromePdfRenderer
Dim renderer As New ChromePdfRenderer()

' Render the HTML content into a PDF
Dim pdf = renderer.RenderHtmlAsPdf(html)

' Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf")

CSS로 페이지 구분 제어

IronPDF는 Chrome 렌더링 엔진을 사용하므로 CSS로 사용자 정의할 수 있으므로 이점을 활용하여 특정 요소에 페이지 구분을 추가하고 그 안에 페이지 구분을 추가하거나, 특정 요소에는 페이지 구분이 없어야 한다고 지정할 수 있습니다.

예를 들어, 위의 이미지에서 페이지 구분은 테이블 뒤에 발생하지만 혼잡으로 인해 테이블 내에서 발생할 때도 있을 수 있습니다.

이를 피하기 위해, 노드에 대해 특정 CSS 스타일링을 사용하고 내부에 페이지 구분을 추가하지 않기를 원한다고 지정할 수 있습니다.

<div style='page-break-inside: avoid'>
 <img src='no-break-me.png'>
</div>

<div style='page-break-inside: avoid'>
 <img src='no-break-me.png'>
</div>

page-break-inside: avoid를 추가하면 요소 내부의 페이지 구분이 방지됩니다. 그러나 이 작업을 수행할 때 이 내용이 요소의 부모 div 노드에 적용되어야 한다는 것을 보장하십시오.

유사한 작업은 페이지-구분-이전 스타일을 추가하려는 요소에 대해서도 사용할 수 있습니다.

<div style="page-break-inside: avoid;">
    <img src="no-break-me.png">
</div>

<div style="page-break-inside: avoid;">
    <img src="no-break-me.png">
</div>

HTML을 활용할 수 있기 때문에, JavaScript의 document.getElementById를 사용하여 ID로 요소를 선택하고 각 노드를 완전히 사용자 정의할 수 있도록 HTML 노드 트리를 탐색하여 노드의 요소를 더 구체화할 수 있습니다.

이미지 품질 및 파일 크기 최적화

페이지 구분 설정은 이미지 품질과도 긴밀하게 관련이 있습니다. 페이지 나누기 설정이 이미지 품질을 축소하거나 다음 페이지에 스케일링함으로써 영향을 미치지 않도록 하고 싶습니다.

이와 같이 우리가 페이지 나누기를 적용할 때 템플릿 전체에서 이미지 품질이 일관되도록 CSS를 사용할 수 있습니다.

<div class="no-break">
    <img src="optimized-image.jpg" alt="Optimized Image" style="width:100%; height:auto;">
</div>

<div class="no-break">
    <img src="optimized-image.jpg" alt="Optimized Image" style="width:100%; height:auto;">
</div>

위의 CSS 스타일링은 페이지 나누기 작업 후에 이미지가 일관되도록 합니다. 우리는 먼저 페이지의 너비를 100%로 설정하고, 높이는 비율을 유지하기 위해 자동 조정 가능합니다.

더욱이 IronPDF는 사용자의 인쇄 설정과 유사한 HTML을 처리할 때 추가 렌더링 옵션을 제공하며, 다운로드 가능한 출력 가능한 PDF 프롬프트에 대해 이러한 옵션이 있습니다. 속성의 전체 목록은 API 문서를 참조하십시오.

JavaScript에서의 대응

Chrome 렌더링 엔진을 사용하는 이점을 가진 IronPDF는 개발자들이 이 강력한 라이브러리를 활용할 수 있도록 다양한 배경의 개발자들을 위한 Node.js 버전도 제공됩니다.

Node.js 변형을 사용하면 개발자는 페이지 구분을 추가하는 데 더 세밀한 제어를 할 수 있습니다. 프로미스 기반 사용 및 메서드, 예를 들어 @onRejected 프로미스 메서드를 디버깅 또는 진행 추적 및 그 중간 함수로 사용할 수 있습니다.

html2pdf와 같은 일반 라이브러리와 비교했을 때 jsPDF 객체의 출력 메소드, IronPDF는 더 유연하며 다국어 지원을 통해 다양한 언어 전문성을 가진 개발자들이 같은 프로젝트에서 작업할 수 있도록 합니다.

결론

페이지 나누기를 사용하는 방법과 CSS가 전체 HTML에 미치는 영향을 이해하는 것은 사용자에게 프레젠테이션 가능하고 시각적으로 매력적인 문서를 만드는 데 중요합니다. 독자들이 정보 과부하 및 혼란을 피하기 위해 읽고 있는 정보를 분리할 수 있도록 허용합니다. 이 기사 전반에 걸쳐 IronPDF가 사용하는 강력한 Chrome 렌더링 엔진을 활용하여 템플릿과 자동화를 위한 페이지 나누기 템플릿을 자동으로 생성하는 방법에 대해 이야기했습니다. 이는 이러한 문서를 만들 때 효율성과 확장성을 간소화하고 인적 오류의 위험을 줄입니다.

IronPDF를 사용해보고 싶은 개발자를 위해, 라이브러리는 $799 및 그 이상을 위한 무료 체험판을 제공합니다.