> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ko/tex-latex-1/08-pdfinclusionerrorlevel.md).

# \pdfinclusionerrorlevel

`\pdfinclusionerrorlevel[=]` *정수*

이 명령은 지정된 버전보다 더 최신 버전의 PDF 파일이 포함될 때 TEX 엔진의 동작을 제어하는 데 사용됩니다 [`\pdfminorversion`](/latex/ko/tex-latex-1/09-pdfminorversion.md).

* “`[=]`”은 등호가 선택 사항임을 의미합니다.

**사용 예**

* `\pdfinclusionerrorlevel=-1` (또는 그 밖의 무엇이든 $$<0$$): 진단 정보를 제공하지 않습니다.
* `\pdfinclusionerrorlevel=0` (기본값): TEX 엔진이 경고를 표시합니다.
* `\pdfinclusionerrorlevel=1`: TEX 엔진이 오류를 발생시킵니다.

#### \pdfinclusionerrorlevel: 배경 정보

1990년대에 처음 출판된 이후, [PDF 파일 형식](https://en.wikipedia.org/wiki/PDF) 수많은 개정과 개선을 거치며 주기적으로 공식 PDF 사양의 새 버전이 발표되어 왔습니다. 그 결과 TEX 엔진이 생성한 파일을 포함한 모든 PDF 파일은 PDF 1.4, 1.5 등과 같은 특정 버전의 PDF 사양을 따르게 됩니다. 모든 PDF 파일에는 해당 파일이 어떤 버전의 PDF 사양을 따르는지를 식별하는 데이터가 포함되어 있어, PDF 파일을 “소비”하려는 모든 응용 프로그램(예: 가져오기, 처리 등)이 그 파일에 어떤 PDF 기능 집합이 들어 있을 가능성이 높은지 알 수 있습니다.

TEX 문서가 PDF 형식의 그래픽을 가져오는 경우, 예를 들어 `\includegraphics`, 그 그래픽 파일은 TeX 엔진이 자체적으로 출력하는 PDF 파일이 지원하는 버전보다 더 최신(나중)인 PDF 사양을 따를 수 있습니다. 분명히 이는 TEX 엔진이 생성한 PDF 버전과 가져온 그래픽 중 하나가 사용하는 PDF 버전 사이에 “충돌”을 일으킬 가능성이 있습니다. 예를 들어, TEX 엔진이 조판한 문서는 PDF 버전 1.4를 따르지만 가져온 그래픽은 예를 들어 PDF 1.5를 따를 수 있습니다. 그런 가져온 그래픽을 추가 조치 없이 단순히 삽입하면, TEX이 생성한 PDF 출력 파일은 이제 PDF 1.5 사양에 기반한 그래픽 콘텐츠를 포함하게 되므로 더 이상 PDF 1.4를 따르지 않게 됩니다. 그 `\pdfinclusionerrorlevel` 명령은 이를 관리하는 데 도움이 됩니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ko/tex-latex-1/08-pdfinclusionerrorlevel.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.