사용자 정의 태그 이름

소개

오늘날의 디지털 시대에 PDF는 어디에나 있습니다. 보고서에서 매뉴얼에 이르기까지 다양한 산업에서 다양한 용도로 사용됩니다. 그러나 장애가 있는 개인을 포함하여 모든 사람이 이러한 문서에 액세스할 수 있도록 하는 것이 중요합니다. 여기서 태그가 지정된 PDF가 등장합니다. 이를 통해 화면 판독기 및 기타 보조 기술이 문서 콘텐츠를 효과적으로 해석하는 것이 더 쉬워집니다.

필수 조건

코딩에 들어가기 전에 모든 것을 준비했는지 확인하는 것이 중요합니다. 필요한 것은 다음과 같습니다.

  1. Visual Studio - 최신 버전이라면 무엇이든 괜찮지만, 최적의 기능을 위해서는 최신 버전을 사용하는 것이 가장 좋습니다.
  2. .NET용 Aspose.PDF - 최신 버전을 쉽게 다운로드할 수 있습니다.다운로드 링크.
  3. C#에 대한 기본 지식 - C# 프로그래밍의 기본 사항에 대해 잘 알고 있으면 코드를 구현하는 데 도움이 됩니다.

패키지 가져오기

환경이 설정되면 다음 단계는 Aspose.PDF를 사용하는 데 필요한 패키지를 가져오는 것입니다. 프로젝트에 Aspose.PDF 라이브러리를 추가하여 이를 수행할 수 있습니다.

NuGet을 통해 Aspose.PDF 설치

  1. Visual Studio 프로젝트를 엽니다. 아직 프로젝트를 만들지 않았다면 새 프로젝트를 만들어보세요.
  2. NuGet 패키지 관리자에 액세스합니다. 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 “NuGet 패키지 관리"를 선택합니다.
  3. Aspose.PDF 검색: 검색창에 “Aspose.PDF"를 입력합니다.
  4. 패키지 설치: “설치"를 클릭하여 프로젝트에 패키지를 추가합니다. 설치가 완료되면 사용할 수 있습니다!

사용 지침 추가

코드에서 Aspose 기능을 활용하려면 파일 맨 위에 필요한 using 지시문을 추가해야 합니다.

using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

이러한 단계가 완료되면 태그가 지정된 PDF를 만들 준비가 되었습니다!

이제 모든 것이 설정되었으니 주요 작업인 태그가 지정된 PDF 문서 만들기에 들어가 보겠습니다. Aspose.PDF for .NET을 사용하여 이 작업을 수행하는 방법에 대한 단계별 가이드는 다음과 같습니다.

1단계: 문서 디렉토리 정의

먼저, PDF가 저장될 경로를 지정해야 합니다. 여기서 데이터 디렉토리를 정의합니다.

string dataDir = "YOUR DOCUMENT DIRECTORY";

설명: “YOUR DOCUMENT DIRECTORY"를 PDF 파일을 저장하려는 실제 경로로 바꾸세요. 런타임 예외를 피하기 위해 이 디렉토리에 쓰기 권한이 있는 것이 중요합니다.

2단계: 새 PDF 문서 만들기

다음으로, 우리는 인스턴스를 생성할 것입니다Document 수업.

Document document = new Document();

설명: 이 줄은 새 PDF 문서를 초기화합니다. PDF의 내용을 칠할 빈 캔버스를 만드는 것으로 생각하세요.

3단계: 태그가 지정된 콘텐츠 만들기

이제 태그의 핵심으로 들어갈 시간입니다. 문서의 태그가 지정된 콘텐츠를 검색합니다.

ITaggedContent taggedContent = document.TaggedContent;

설명:TaggedContent 객체를 사용하면 콘텐츠를 계층적으로 구성하여 PDF의 논리적 구조와 접근성을 조작할 수 있습니다.

4단계: 제목 및 언어 설정

다음으로, 문서의 제목과 언어 속성을 설정할 수 있습니다. 이렇게 하면 화면 판독기가 문서를 올바르게 처리하는 데 도움이 됩니다.

taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

설명: 여기서는 PDF를 읽는 모든 사람에게 제목과 언어에 대해 알려줍니다. 이는 특히 접근성 도구의 이해를 돕습니다.

5단계: 논리적 구조 요소 만들기

이제 PDF 내에서 구조화된 요소를 만들 차례입니다.

SectElement sect = taggedContent.CreateSectElement();
taggedContent.RootElement.AppendChild(sect);

설명: 이 단계에서는 콘텐츠 추가를 시작할 수 있는 섹션 요소를 소개합니다.RootElement 당신의 본거지입니다.

6단계: 문단 요소 만들기

이제 다양한 문단 요소를 만들고 텍스트 내용을 설정합니다.

ParagraphElement p1 = taggedContent.CreateParagraphElement();
ParagraphElement p2 = taggedContent.CreateParagraphElement();
ParagraphElement p3 = taggedContent.CreateParagraphElement();
ParagraphElement p4 = taggedContent.CreateParagraphElement();
p1.SetText("P1. ");
p2.SetText("P2. ");
p3.SetText("P3. ");
p4.SetText("P4. ");

설명: 각 문단은 스토리 속의 문장과 유사하며, 문서의 배경을 설정하고 의미를 제공합니다.

7단계: 문단에 태그 지정

PDF의 접근성을 위해 각 문단에 적절한 태그를 지정하는 것이 중요합니다.

p1.SetTag("P1");
p2.SetTag("Para");
p3.SetTag("Para");
p4.SetTag("Paragraph");

설명: 태그로 라벨을 지정하면 보조 기술이 콘텐츠의 구조를 이해할 수 있게 됩니다. 마치 영역을 탐색할 수 있는 로드맵을 제공하는 것과 같습니다.

8단계: 섹션에 문단 추가

이제 이 문단을 이전에 만든 섹션에 추가하겠습니다.

sect.AppendChild(p1);
sect.AppendChild(p2);
sect.AppendChild(p3);
sect.AppendChild(p4);

설명: 이 작업은 섹션 내의 문단을 구성하여 흐름을 논리적이고 따라가기 쉽게 만듭니다.

9단계: Span 요소 만들기

문단과 마찬가지로, 스팬은 텍스트 콘텐츠에 세부적인 내용을 추가합니다.

SpanElement span1 = taggedContent.CreateSpanElement();
SpanElement span2 = taggedContent.CreateSpanElement();
SpanElement span3 = taggedContent.CreateSpanElement();
SpanElement span4 = taggedContent.CreateSpanElement();
span1.SetText("Span 1.");
span2.SetText("Span 2.");
span3.SetText("Span 3.");
span4.SetText("Span 4.");

설명: 스팬은 세부 내용을 미세하게 조정하는 것과 같습니다. 스팬은 각 문단에서 전달하려는 내용에 구체성을 더해줍니다.

10단계: Span 요소에 태그 지정

문단에서 했던 것처럼, 이해를 돕기 위해 span 요소에도 태그를 지정해야 합니다.

span1.SetTag("SPAN");
span2.SetTag("Sp");
span3.SetTag("Sp");
span4.SetTag("TheSpan");

설명: span에 태그를 올바르게 지정하면 모든 뉘앙스가 정확하게 표현되어 해당 문서를 접하는 모든 사람에게 풍부한 문서를 제공할 수 있습니다.

11단계: 문단에 Span 추가

이제 span 요소를 해당 문단에 추가해 보겠습니다.

p1.AppendChild(span1);
p2.AppendChild(span2);
p3.AppendChild(span3);
p4.AppendChild(span4);

설명: 이 통합은 더 깊은 이해를 위해 책에 각주를 추가하는 것처럼 추가 정보를 계층화하여 문단을 강화합니다.

12단계: 태그가 지정된 PDF 문서 저장

마침내, 당신의 걸작을 저장할 시간이 왔습니다!

document.Save(dataDir + "CustomTag.pdf");

설명: 이 줄은 태그가 지정된 PDF를 지정된 디렉토리에 저장합니다. 이것으로 태그가 지정된 PDF 문서 생성이 완료되었습니다!

결론

Aspose.PDF for .NET을 사용하여 태그가 지정된 PDF 문서를 만드는 것은 단순히 콘텐츠를 추가하는 것이 아니라 모든 사용자에게 접근 가능한 경험을 만드는 것입니다. 몇 단계만 거치면 모든 사람에게 문서를 전달하여 장벽을 제거하고 이해를 높일 수 있습니다.

자주 묻는 질문

태그가 지정된 PDF란 무엇입니까?

태그가 지정된 PDF에는 문서 내용의 구조와 접근성을 설명하는 추가 메타데이터가 포함되어 있어 보조 기술이 해석하기 쉽습니다.

.NET에 Aspose.PDF가 필요한 이유는 무엇입니까?

.NET용 Aspose.PDF는 개발자가 광범위한 기능을 통해 PDF 문서를 프로그래밍 방식으로 만들고, 수정하고, 조작할 수 있는 강력한 라이브러리입니다.

Aspose.PDF 평가판을 어떻게 받을 수 있나요?

Aspose.PDF의 무료 평가판을 얻으려면 여기를 방문하세요.이 링크.

Aspose.PDF에 대한 지원을 받을 수 있나요?

네, 다음을 통해 지원을 요청할 수 있습니다.Aspose 포럼.

Aspose.PDF에 대한 자세한 문서는 어디에서 찾을 수 있나요?

전체 문서를 찾을 수 있습니다여기.

테이블 요소 생성 그림 구조 요소