Udostępnij za pośrednictwem

Aktualizowanie metadanych

  • Artykuł

Nazwa rozszerzenia

Pakiet Learn Authoring Pack, Visual Studio Code meta extension składa się z wielu rozszerzeń podrzędnych. Ta funkcja jest uwzględniona w rozszerzeniu Learn Markdown . Rozszerzenie Learn Markdown jest częścią pakietu Learn Authoring Pack. Nie trzeba go instalować oddzielnie.

Podsumowanie

W pliku Markdown (*.md) istnieją dwa kontekstowe elementy menu specyficzne dla metadanych. Po kliknięciu prawym przyciskiem myszy dowolnego miejsca w edytorze tekstów zobaczysz coś podobnego do następujących elementów menu:

Aktualizowanie menu kontekstowego metadanych

Aktualizowanie ms.date wartości metadanych

Wybranie opcji Aktualizuj ms.date wartość metadanych spowoduje ustawienie bieżącej wartości plików ms.date markdown na datę bieżącą. Jeśli dokument nie ma ms.date pola metadanych, nie zostanie podjęta żadna akcja.

Aktualizowanie niejawnych wartości metadanych

Wybranie opcji Aktualizuj niejawne wartości metadanych spowoduje znalezienie i zastąpienie wszystkich możliwych wartości metadanych, które mogą być niejawnie określone. Wartości metadanych są niejawnie określone w pliku docfx.json w węźle build/fileMetadata . Każda para wartości klucza w węźle fileMetadata reprezentuje wartości domyślne metadanych. Na przykład plik Markdown w katalogu najwyższego poziomu/podfolderu , który pomija ms.author wartość metadanych, może niejawnie określić wartość domyślną do użycia w węźle fileMetadata .

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

W takim przypadku wszystkie pliki markdown niejawnie przyjmują ms.author: dapine wartość metadanych. Funkcja działa na tych niejawnych ustawieniach znalezionych w pliku docfx.json . Jeśli plik Markdown zawiera metadane z wartościami, które są jawnie ustawione na coś innego niż niejawne wartości, są one zastępowane.

Rozważ następujące metadane pliku Markdown, w których ten plik Markdown znajduje się w folderze najwyższego poziomu/podfolderze/includes/example.md:

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

# Content

Jeśli opcja Aktualizuj niejawne wartości metadanych została wykonana w tym pliku, z zakładaną zawartością docfx.json z powyższej wartości metadanych zostanie zaktualizowana do ms.author: dapine.

---
ms.author: dapine
---

# Content

W akcji

Poniżej przedstawiono krótką demonstrację tej funkcji.

Aktualizacja pokazu metadanych