CSV do Markdown Frontmatter

Wiersz nagłówka z nazwami pól, po którym następuje jeden wiersz na dokument. Każdy wiersz danych staje się osobnym blokiem frontmatter ---, przy czym nagłówki kolumn stają się kluczami YAML, w kolejności występowania kolumn.

Komórka zawierająca listę rozdzieloną przecinkami (np. tagi) jest konwertowana na prawdziwą tablicę YAML, więc "astro,blog" staje się ["astro", "blog"] zamiast pojedynczego ciągu znaków. Wartość z pojedynczym przecinkiem na końcu, jak "astro,", pozostaje zwykłym ciągiem znaków, tak jak wygląda, zamiast być zgadywana.

Komórka, która jest dokładnie "true" lub "false", staje się prawdziwą wartością logiczną YAML, a zwykła liczba całkowita lub dziesiętna staje się prawdziwą liczbą - obie bez cudzysłowów, dzięki czemu kolejne narzędzia odczytują je jako rzeczywisty typ, a nie tekst. Daty są cytowane jak każdy inny ciąg znaków: to, czy sama data staje się natywnym znacznikiem czasu, zależy od parsera (parser Ruby w Jekyll tak robi, wiele bibliotek YAML w JavaScript nie), więc cytowanie utrzymuje wartość przewidywalną wszędzie zamiast opierać się na domysłach. Liczba z wiodącym zerem, jak kod pocztowy "0755", również pozostaje cytowana, ponieważ niektóre parsery YAML odczytują wiodące zero jako notację ósemkową i mogłyby po cichu zmienić jej wartość.

Wybierz pasujący separator z listy rozwijanej. Wszystko inne - pola w cudzysłowach, przecinki wewnątrz cudzysłowów, dzielenie na listy - działa tak samo niezależnie od tego, jaki separator rozdziela kolumny.

Przełącz listę rozwijaną Znak cudzysłowu na pojedynczy cudzysłów (') przed generowaniem. Parser traktuje wtedy ' tak, jak normalnie traktuje " - do cytowania pola, escapowania osadzonego cudzysłowu przez jego podwojenie oraz zezwalania na przecinki lub podziały wiersza wewnątrz cytowanej wartości.

Tak - ustaw Styl tablicy na "Blok: lista z wcięciem", a komórki rozdzielone przecinkami będą renderowane jako lista "- element" z wcięciem pod ich kluczem zamiast jednej liniowej linii [a, b, c], z wyborem wcięcia 2- lub 4-spacjowego. Oba style parsują się do identycznej wartości tablicowej; to kwestia formatowania, a nie zmiany zachowania.

Narzędzie nadal generuje dla niego blok: wartości nadmiarowe po ostatniej kolumnie są odrzucane, a brakujące wartości są traktowane jako puste, z notatką nad wynikami informującą, których numerów wierszy to dotyczyło, abyś mógł wrócić i poprawić źródłowy CSV, jeśli był to błąd.

Nie - generuje wyłącznie blok frontmatter --- z kolumn CSV. Treść dokumentu nadal trzeba napisać lub wkleić osobno.

Jeden połączony plik frontmatter.md zawierający blok każdego wiersza po kolei, oddzielony własnymi separatorami ---. Jeśli potrzebujesz każdego wiersza jako osobnego pliku, kopiuj bloki pojedynczo i zapisuj je pod osobnymi nazwami.

Tak - wynik to standardowy YAML pomiędzy separatorami ---, ten sam format, którego oczekują wszystkie trzy (i większość innych generatorów statycznych stron) na początku pliku treści. Nic tutaj nie jest specyficzne dla frameworka. Lista rozwijana "Wczytaj przykład" zawiera gotowy CSV dla każdego z Astro, Jekyll, Hugo i Obsidian, wykorzystujący udokumentowane nazwy pól frontmatter danej platformy, dzięki czemu możesz zobaczyć prawdziwe nazwy kolumn, zanim podłączysz własny CSV.

Nie - parsowanie i konwersja odbywają się całkowicie w Twojej przeglądarce. Twoje wiersze CSV nigdy nie są wysyłane na serwer, co oznacza również, że nie ma limitu rozmiaru pliku ani liczby wierszy poza tym, co może obsłużyć Twoja przeglądarka.