Keywords 속성

Keywords는 document Information dictionary의 /Keywords entry를 반환합니다 (PDF 1.7 spec section 14.3.3). 이 값은 authoring tool이 쓴 자유 형식 text string이며, 관례적으로 comma 또는 semicolon으로 구분된 tag 목록입니다 — 예: "invoice; 2024; payable; vendor-acme" PDF는 delimiter를 지정하지 않으므로 application은 producer가 쓴 형식(comma, semicolon, line break, space-separated)을 모두 받아들여야 합니다

반환값은 UTF-16으로 디코딩되므로 CJK와 다른 비 ASCII keywords도 올바르게 round-trip됩니다 Active가 False이거나, Info dictionary가 없거나, /Keywords가 지정되지 않았으면 문자열은 비어 있습니다. 많은 현대 authoring tool은 keywords를 pdf:Keywords 또는 dc:subject(RDF literal의 Bag) 아래의 XMP metadata에도 반영합니다. 둘 다 있으면 서로 일치해야 하지만 편집 후 달라질 수 있습니다

Keywords는 Windows Explorer, Spotlight, Adobe Bridge 같은 desktop search indexer와 대부분의 document-management system에 노출됩니다. PDFiumPas는 Info dictionary 사본만 노출합니다 — 같은 값은 PDFium의 generic metadata accessor를 통해 MetaText['Keywords']로 접근하세요

• 이 property는 read-only입니다. keywords를 설정하려면 FPDF_SetMetaText를 “Keywords” tag와 함께 직접 호출하세요
• Some indexing pipelines lower-case keywords for matching — PDFiumPas preserves casing verbatim. Apply whatever normalisation your search layer requires after reading the string.
• 값은 정보용 메타데이터로만 사용하세요. PDF는 keyword의 길이나 내용을 제한하지 않으므로 표시할 때는 신뢰할 수 없는 텍스트로 취급하세요