NuGet을 통한 Documentize 설치

NuGet 패키지 관리자 콘솔을 통한 설치 방법

1. 프로젝트 열기:

   • Visual Studio를 실행하고 .NET 응용 프로그램을 엽니다.

2. 패키지 관리자 콘솔에 접근하기:

   • 도구 > NuGet 패키지 관리자 > 패키지 관리자 콘솔로 이동합니다.

3. 패키지 설치하기:

   • 최신 전체 릴리스를 설치하려면 Install-Package Documentize 명령어를 입력합니다.
   • 핫픽스를 포함한 최신 릴리스를 설치하려면 Install-Package Documentize -prerelease을 사용합니다.
   • Enter 키를 눌러 명령을 실행합니다.

NuGet 패키지 관리자 콘솔을 통한 패키지 업데이트 방법

이미 NuGet을 통해 Documentize를 설치했으며 최신 버전으로 업데이트하려면:

1. 프로젝트 열기:

   • Visual Studio를 실행하고 .NET 응용 프로그램을 엽니다.

2. 패키지 관리자 콘솔에 접근하기:

   • 도구 > NuGet 패키지 관리자 > 패키지 관리자 콘솔로 이동합니다.

3. 패키지 업데이트하기:

   • 최신 전체 릴리스로 업데이트하려면 Update-Package Documentize를 입력합니다.
   • 핫픽스를 포함한 최신 릴리스로 업데이트하려면 Update-Package Documentize -prerelease를 사용합니다.
   • Enter 키를 눌러 명령을 실행합니다.

NuGet 패키지 관리자 GUI를 통한 설치 방법

1. 프로젝트 열기:

   • Visual Studio를 실행하고 .NET 응용 프로그램을 엽니다.

2. NuGet 패키지 관리로 이동하기:

   • 프로젝트 메뉴에서 NuGet 패키지 관리를 선택합니다.

3. Documentize 검색하기:

   • 찾아보기 탭으로 이동하여 검색 상자에 Documentize를 입력합니다.

4. 패키지 설치하기:

   • Documentize의 최신 버전 옆에 있는 설치/업데이트를 클릭합니다.
   • 팝업 창에서 수락을 클릭하여 확인합니다.

NuGet 사용의 장점

• 자동 종속성 관리:

  • NuGet은 종속성을 자동으로 처리하여 모든 필요한 라이브러리가 포함되고 올바르게 업데이트되도록 보장합니다. 이는 누락되거나 호환되지 않는 종속성의 위험을 줄입니다.

• 간편한 업데이트:

  • NuGet을 통해 패키지를 업데이트하는 것은 패키지 관리자 콘솔이나 GUI를 통해 간단합니다. 이는 라이브러리를 최신 기능 및 버그 수정으로 쉽게 유지할 수 있게 합니다.

• Visual Studio와 통합:

  • NuGet은 Visual Studio와 매끄럽게 통합되어 개발 환경을 벗어나지 않고도 패키지를 관리할 수 있는 사용자 친화적인 인터페이스를 제공합니다.

• 버전 관리:

  • NuGet을 사용하면 라이브러리의 다양한 버전을 지정하고 관리할 수 있어 이전 버전으로 쉽게 되돌리거나 새로운 릴리스를 테스트할 수 있습니다.

NuGet 사용의 단점

• Visual Studio에 제한됨:

  • NuGet은 주로 Visual Studio 내에서 사용하도록 설계되었습니다. 다른 환경에서도 사용할 수 있지만 Visual Studio에서의 통합이 가장 강력합니다.

• 버전 충돌 가능성:

  • 많은 종속성을 가진 대규모 프로젝트에서는 버전을 관리하고 충돌을 해결하는 것이 복잡해질 수 있습니다. NuGet은 이를 관리할 도구를 제공하지만 신중한 주의가 필요합니다.

• 네트워크 의존성:

  • 패키지를 설치하고 업데이트하려면 인터넷 연결이 필요합니다. 제한된 인터넷 접근이 있는 환경에서 작업하는 경우 오프라인 방법이나 미리 패키지를 다운로드해야 할 수 있습니다.

• 대규모 프로젝트에 대한 복잡성:

  • 종속성 트리가 광범위한 매우 큰 프로젝트의 경우 NuGet을 통한 패키지 관리의 과부하가 번거로워질 수 있습니다. 이러한 경우에는 종속성을 효과적으로 관리하기 위해 추가 도구나 전략이 필요할 수 있습니다.

MSI를 통한 Documentize 설치

MSI 설치 프로그램을 통한 설치 방법

1. MSI 설치 프로그램 다운로드:

   • v24.12 MSI를 클릭하여 최신 버전의 Documentize에 대한 MSI 설치 프로그램을 다운로드합니다.

2. 설치 프로그램 실행:

   • 다운로드한 MSI 파일을 두 번 클릭하여 설치 마법사를 실행합니다.

3. 설치 마법사 따라하기:

   • 설치자가 제공하는 화면의 지침을 따릅니다. 라이선스 계약에 동의하고 설치 옵션을 선택해야 할 수도 있습니다.

4. 설치 완료하기:

   • 설치가 완료되면 Documentize DLL이 시스템의 Global Assembly Cache (GAC) 또는 다른 지정된 위치에 설치됩니다.

5. 설치 확인하기:

   • 지정된 설치 디렉터리나 GAC에서 DLL이 올바르게 설치되었는지 확인합니다.

MSI 설치 프로그램 사용의 장점

• 사용 용이성:

  • MSI 설치 프로그램은 간단하고 안내된 설치 과정을 제공합니다. 필요한 모든 구성 작업을 처리하며 중앙 위치에 DLL을 배치하여 여러 프로젝트에서 Documentize를 쉽게 사용할 수 있습니다.

• 시스템 전체 설치:

  • MSI 방법은 Documentize를 시스템의 Global Assembly Cache (GAC) 또는 다른 중앙 위치에 설치합니다. 이로 인해 시스템의 모든 애플리케이션이 각각의 프로젝트에서 DLL을 개별적으로 참조하지 않고도 사용할 수 있습니다.

• 자동 업데이트:

  • Documentize에서 업데이트된 설치 프로그램을 제공하는 경우, 새 MSI 파일을 실행하여 설치를 쉽게 업데이트할 수 있으며, 일반적으로 업데이트 과정이 원활하게 진행됩니다.

• 일관성:

  • MSI 설치 프로그램을 사용하면 필요한 모든 파일이 올바르게 설치되고 서로 다른 환경에서 일관되게 설치되어 DLL이 누락되거나 잘못 배치될 위험이 줄어듭니다.

MSI 설치 프로그램 사용의 단점

• 제한된 유연성:

  • MSI 설치 프로그램은 Documentize를 시스템 전체 위치에 설치하므로 모든 개발 환경에 적합하지 않을 수 있습니다. 프로젝트별 구성이나 버전을 수용할 유연성이 부족할 수 있습니다.

• 잠재적 오버헤드:

  • GAC에 DLL을 설치하면 여러 버전의 Documentize가 동시에 필요할 수 있는 시나리오에서 오버헤드와 복잡성이 발생할 수 있습니다.

• 수동 제거:

  • Documentize를 제거해야 하는 경우 MSI에서 제공하는 제거 프로그램을 사용해야 하며, 제대로 관리하지 않으면 잔여 파일이나 구성이 남을 수 있습니다.

• 버전 충돌:

  • 시스템 전체 설치는 서로 다른 프로젝트에서 다른 버전의 Documentize를 요구할 경우 버전 충돌을 초래할 수 있습니다. 이러한 충돌을 관리하려면 추가 구성이나 정리가 필요할 수 있습니다.

ZIP을 통한 Documentize 설치

ZIP 아카이브를 통한 설치 방법

1. ZIP 아카이브 다운로드:

   • [[ v24.12 ZIP]]를 클릭하여 Documentize의 최신 버전을 아카이브 형식으로 다운로드합니다.

2. 내용 추출:

   • 다운로드 후 ZIP 파일의 내용을 원하는 디렉터리에 추출하십시오. 이러한 파일을 공유 디렉터리에 보관하거나 프로젝트 구조 내에 두도록 선택할 수 있습니다.

3. 프로젝트에 참조 추가:

   • IDE(예: Visual Studio)에서 프로젝트를 엽니다.
   • 프로젝트 > 참조 추가 > 찾아보기로 이동하여 DLL을 추출한 디렉터리로 이동합니다.
   • 관련 DLL 파일을 선택하고 프로젝트에 참조로 추가합니다.

4. 수동 업데이트:

   • Documentize의 새 버전이 출시되면 업데이트된 ZIP 아카이브를 수동으로 다운로드하고 프로젝트의 오래된 DLL 파일을 새로운 것으로 교체해야 합니다.

ZIP 아카이브 사용의 장점

• 완전한 제어:

  • DLL이 프로젝트에 저장되고 참조되는 위치와 방법을 완전히 제어할 수 있습니다. 이는 맞춤 설정을 선호하거나 수동으로 종속성을 관리해야 하는 경우 유리할 수 있습니다.

• 패키지 관리자에 대한 의존성 없음:

  • NuGet과 달리, 설치를 처리하기 위해 패키지 관리자에 의존하지 않습니다. 이는 패키지 관리자가 사용 불가능하거나 선호되지 않는 환경에서 장점이 될 수 있습니다.

• 휴대성:

  • ZIP 아카이브는 쉽게 공유하고 서로 다른 시스템 간에 이동할 수 있어, 외부 도구에 의존하지 않고 휴대 가능하거나 배포가 필요한 프로젝트에 이상적입니다.

ZIP 아카이브 사용의 단점

• 수동 관리:

  • 업데이트 및 종속성 관리가 자동화된 NuGet과 달리, ZIP 아카이브를 사용하면 업데이트를 수동으로 관리해야 하며 모든 필요한 DLL이 올바르게 참조되도록 해야 합니다.

• 버전 충돌 위험:

  • 여러 프로젝트를 관리하거나 팀에서 작업하는 경우, 서로 다른 프로젝트가 서로 다른 DLL 버전을 사용할 경우 버전 충돌의 위험이 있습니다. 이는 프로젝트 간의 버전을 신중하게 추적해야 함을 의미합니다.

• 자동 업데이트 없음:

  • 새 버전이 출시될 때 자동 업데이트나 알림을 받지 못합니다. 이는 정기적으로 업데이트를 확인하지 않으면 구버전 라이브러리를 사용할 위험이 발생할 수 있습니다.

비 윈도우 환경

비 윈도우 환경에서 .NET Core DLL 작업하기

Documentize for .NET은 .NET Standard 2.0 (.NET Core 2.0) 지원을 제공하므로, 리눅스와 유사한 운영 체제에서 실행되는 Core 애플리케이션에서 사용할 수 있습니다. 우리는 API에서 .NET Core 지원을 개선하기 위해 지속적으로 노력하고 있습니다. 그러나 Documentize for .NET의 기능을 사용할 때 더 나은 결과를 얻기 위해 고객이 수행하기를 권장하는 몇 가지 작업이 있습니다. 다음을 설치해 주시기 바랍니다:

• libgdiplus 패키지
• Microsoft 호환 글꼴 패키지: ttf-mscorefonts-installer (예: sudo apt-get install ttf-mscorefonts-installer). 이 글꼴은 Documentize for .NET이 리눅스 유사 운영 체제에서 이 폴더를 스캔하므로 /usr/share/fonts/truetype/msttcorefonts 디렉토리에 배치해야 합니다. 운영 체제에 글꼴에 대한 다른 기본 폴더/디렉토리가 있는 경우, Documentize를 사용하여 어떤 작업을 수행하기 전에 다음 코드를 사용해야 합니다:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<사용자의 ms 글꼴 경로>"));

v24.12

새 플러그인 추가: PDF to PNG Converter

• 클래스 PngConverter: Documentize.PngConverter 플러그인을 나타냅니다. PDF 문서를 PNG 형식으로 변환하는 데 사용됩니다.
• 클래스 PdfToPngOptions: Documentize.PngConverter 플러그인을 위한 PDF to PNG 변환 옵션을 나타냅니다.

사용 예제:

// PngConverter 만들기
var plugin = new PngConverter();
// 지침을 설정할 PdfToPngOptions 객체 생성
var opt = new PdfToPngOptions();
// 입력 파일 경로 추가
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 출력 파일 경로 설정
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// 프로세스 수행
plugin.Process(opt);

새 플러그인 추가: PDF to TIFF Converter

• 클래스 TiffConverter: Documentize.TiffConverter 플러그인을 나타냅니다. PDF 문서를 TIFF 형식으로 변환하는 데 사용됩니다.
• 클래스 PdfToTiffOptions: Documentize.TiffConverter 플러그인을 위한 PDF to TIFF 변환 옵션을 나타냅니다.

사용 예제:

// TiffConverter 만들기
var plugin = new TiffConverter();
// 지침을 설정할 PdfToTiffOptions 객체 생성
var opt = new PdfToTiffOptions();
// 입력 파일 경로 추가
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 출력 파일 경로 설정
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// 프로세스 수행
plugin.Process(opt);

새 플러그인 추가: PDF Table Generator

• 클래스 TableGenerator: Documentize.TableGenerator 플러그인을 나타냅니다. PDF 문서에 테이블을 추가하는 데 사용됩니다.
• 클래스 TableBuilder: PDF 페이지의 테이블을 위한 빌더를 나타냅니다.
• 클래스 TableRowBuilder: 테이블 행을 위한 빌더를 나타냅니다.
• 클래스 TableCellBuilder: 테이블 셀을 위한 빌더를 나타냅니다.

사용 예제:

// TableGenerator 만들기
var plugin = new TableGenerator();
// 지침을 설정할 TableOptions 객체 생성
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("이름")
            .AddCell().AddParagraph("나이")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// 입력 파일 경로 추가
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 출력 파일 경로 설정
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// 프로세스 수행
plugin.Process(opt);

클래스 PdfDoc의 이름을 DocConverter로 변경

• 클래스 DocConverter: Documentize.DocConverter 플러그인을 나타냅니다. PDF 문서를 DOC/DOCX 형식으로 변환하는 데 사용됩니다.

사용 예제:

// DocConverter 만들기
var plugin = new DocConverter();
// 지침을 설정할 PdfToDocOptions 객체 생성
var opt = new PdfToDocOptions();
// 입력 파일 경로 추가
opt.AddInput(new FileDataSource(inputPath));
// 출력 파일 경로 설정
opt.AddOutput(new FileDataSource(outputPath));
// 프로세스 수행
plugin.Process(opt);

v24.11

새 플러그인 추가: PDF를 JPEG 변환기

• 목적: JpegConverter 클래스는 PDF 문서를 JPEG 형식으로 변환하도록 설계되어, 사용자가 PDF로부터 유도된 이미지를 보다 쉽게 처리하고 공유할 수 있게 합니다.
• 생성자:
  • JpegConverter(): JPEG 변환기의 새 인스턴스를 초기화합니다.

사용 예:

var plugin = new JpegConverter();  
var opt = new PdfToJpegOptions();  
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));  
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));  
plugin.Process(opt);  

• 메서드:
  • Process(PdfToJpegOptions options): 지정된 옵션을 사용하여 JPEG 변환 프로세스를 시작합니다.

추가된 클래스 DirectoryDataSource

• 목적: DirectoryDataSource 클래스는 사용자가 플러그인 내에서 로딩 및 저장 작업을 위한 디렉터리 데이터를 관리할 수 있게 합니다.
• 생성자:
  • DirectoryDataSource(string path): 지정된 경로를 가진 새 디렉터리 데이터 객체를 초기화합니다.

사용 예:

var directorySource = new DirectoryDataSource("path_to_your_directory");  

• 속성:
  • DataType: 데이터 소스의 유형을 가져옵니다.
  • Path: 현재 데이터 디렉터리의 경로를 가져옵니다.

추가된 클래스 PdfToJpegOptions

• 목적: 이 클래스는 JPEG 변환 프로세스를 구성하기 위한 옵션을 담고 있으며, 사용자가 해상도, 페이지 목록 및 이미지 품질을 지정할 수 있게 합니다.
• 생성자:
  • PdfToJpegOptions(): JPEG 변환기를 위한 새 옵션 인스턴스를 초기화합니다.

속성:

• OutputResolution: 결과 JPEG 이미지의 해상도를 지정합니다.
• PageList: PDF에서 변환할 페이지 목록입니다.
• Quality: JPEG 출력의 품질을 설정합니다.

v24.10

새 플러그인 추가: PDF/A 변환기

• 표준 PDF 파일을 PDF/A 호환 문서로 쉽게 변환할 수 있는 새로운 PDF/A 변환 기능이 도입되었습니다.

사용 예시:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

버그 수정

• 잘못된 출력 경로를 초래한 FileResult 클래스와 관련된 문제를 수정했습니다.
• 대용량 파일을 처리할 때 HtmlConverter에 영향을 주었던 사소한 버그를 해결했습니다.

개선 사항

• 더 빠른 처리 시간을 위해 PdfExtractor 및 ImageExtractor의 성능을 향상시켰습니다.
• 추가 회전 각도를 지원하기 위해 RotateOptions 클래스를 업데이트했습니다.

v24.9

출시됨