메타데이터 업데이트

확장 이름

Learn Authoring Pack, Visual Studio Code 메타 확장은 여러 하위 확장으로 구성됩니다. 이 기능은 Learn Markdown 확장에 포함되어 있습니다. Learn Markdown 확장은 Learn Authoring Pack의 일부이므로 별도로 설치할 필요가 없습니다.

요약

Markdown(*.md) 파일에는 메타데이터와 관련된 두 개의 상황에 맞는 메뉴 항목이 있습니다. 텍스트 편집기의 아무 곳이나 마우스 오른쪽 단추로 클릭하면 다음과 유사한 메뉴 항목이 표시됩니다.

ms.date 메타데이터 값 업데이트

ms.date 메타데이터 값 업데이트 옵션을 선택하면 현재 Markdown 파일 ms.date 값이 오늘 날짜로 설정됩니다. 문서에 ms.date 메타데이터 필드가 없으면 아무 작업도 수행되지 않습니다.

암시적 메타데이터 값 업데이트

암시적 메타데이터 값 업데이트 옵션을 선택하면 암시적으로 지정할 수 있는 모든 가능한 메타데이터 값을 찾아 바꿉니다. 메타데이터 값은 docfx.json 파일의 build/fileMetadata 노드에서 암시적으로 지정됩니다. fileMetadata 노드에 있는 각각의 키 값 쌍은 메타데이터 기본값을 나타냅니다. 예를 들어 ms.author 메타데이터 값을 생략하는 top-level/sub-folder 디렉터리의 Markdown 파일은 fileMetadata 노드에 사용할 기본값을 암시적으로 지정할 수 있습니다.

{
    "build": {
        "fileMetadata": {
            "ms.author": {
                "top-level/sub-folder/**/**.md": "dapine"
            }
        }
    }
}

이 경우 모든 Markdown 파일이 ms.author: dapine 메타데이터 값을 암시적으로 허용합니다. 이 기능은 docfx.json 파일에 있는 이러한 암시적 설정에 적용됩니다. Markdown 파일에 암시적 값이 아닌 값으로 명시적으로 설정된 값을 사용하는 메타데이터가 있는 경우 해당 값은 재정의됩니다.

다음 Markdown 파일 메타데이터를 살펴보세요. 이 Markdown 파일은 top-level/sub-folder/includes/example.md에 있습니다.

---
ms.author: someone-else
---

# Content

이 파일에서 암시적 메타데이터 값 업데이트 옵션이 실행된 경우 위의 docfx.json 콘텐츠를 사용하는 것으로 가정하면 메타데이터 값이 ms.author: dapine로 업데이트됩니다.

---
ms.author: dapine
---

# Content

예제

다음은 이 기능에 대한 간단한 데모입니다.