Wieloliniowe stringi w YAML: | i > wyjaśnione z podglądem na żywo
Wieloliniowe stringi w YAML
Wieloliniowe stringi w YAML: | vs > oraz chomping - i + | We.Inc
Zobacz dokładnie, co dają style blokowe | i > w YAML oraz wskaźniki chomping -, clip i +. Wpisz własny tekst i obserwuj, jak wynikowy string zmienia się na żywo.
YAML zapisuje długi tekst za pomocą skalarów blokowych. Pionowa kreska (|) zachowuje każde złamanie linii dokładnie tak, jak zostało wpisane; znak większości (>) zamienia pojedyncze złamania linii na spacje. Wskaźnik chomping decyduje następnie o zakończeniu: - usuwa końcowy znak nowej linii, brak wskaźnika zostawia jeden, a + zachowuje dodatkowo wszystkie końcowe puste linie.
Sześć nagłówków skalarów blokowych i co dają
- Nagłówek
- Złamania linii w środku
- Koniec stringa
- Zachowane
- Jeden znak nowej linii
- Zachowane
- Bez znaku nowej linii
- Zachowane
- Znak nowej linii plus wszystkie końcowe puste linie
- Pojedyncze złamania stają się spacjami
- Jeden znak nowej linii
- Pojedyncze złamania stają się spacjami
- Bez znaku nowej linii
- Pojedyncze złamania stają się spacjami
- Znak nowej linii plus wszystkie końcowe puste linie
Linia nagłówka po kluczu ma najwyżej dwa znaki, a jednak decyduje o tym, co otrzyma Twój program. Wybierz styl i wskaźnik chomping w podglądzie, wpisz tekst, a dokładny string pojawi się poniżej w notacji JSON, dzięki czemu każdy znak nowej linii jest widoczny jako \n.
- Wpisz lub wklej tekst, który chcesz zapisać. Każda linia w polu staje się jedną linią treści bloku.
- Wybierz literal (|) lub folded (>), a potem strip (-), clip (domyślnie) lub keep (+).
- Ustaw, ile pustych linii następuje po bloku, aby zobaczyć, co robi z nimi keep.
- Skopiuj YAML po lewej. Po prawej jest string, który parser YAML 1.2 przekazuje do Twojego kodu.
- Używaj |- dla wartości porównywanych jako dokładne stringi, takich jak tokeny lub certyfikaty wklejane do konfiguracji, aby nie wkradł się zbędny znak nowej linii.
- Używaj > dla długiej prozy, która w programie ma być jednym akapitem, ale w pliku ładnie się zawijać.
- Kroki powłoki w plikach CI zwykle wymagają |, bo każde polecenie musi pozostać w osobnej linii.
- Wcinaj treść głębiej niż klucz. Pierwsza niepusta linia ustala wcięcie dla całego bloku.
Najczęściej zadawane pytania
Jaka jest różnica między | a > w YAML?
Pionowa kreska rozpoczyna blok literalny: każde wpisane złamanie linii pozostaje w wartości. Znak większości rozpoczyna blok zwijany: pojedyncze złamanie między dwiema zwykłymi liniami zamienia się w spację, a puste linie stają się znakami nowej linii.
Co oznacza minus w |-?
To wskaźnik chomping strip. Końcowe złamanie linii i wszystkie puste linie po tekście są usuwane, więc wartość kończy się na ostatnim widocznym znaku.
Co robi + po | lub >?
To wskaźnik keep. Końcowe złamanie linii i każda końcowa pusta linia stają się częścią wartości. Bez żadnego wskaźnika YAML stosuje clip: zachowuje jeden końcowy znak nowej linii i usuwa puste linie.
Dlaczego niektóre linie w moim bloku > nie są zwijane?
Linie zaczynające się od dodatkowego wcięcia to linie bardziej wcięte. Zwijanie nigdy ich nie łączy, więc złamania wokół nich są zachowane. Dzięki temu możesz trzymać przykład kodu lub listę wewnątrz zwijanej prozy.
Czy mogę napisać wieloliniowy string bez skalarów blokowych?
Tak. String w podwójnych cudzysłowach może zawierać sekwencje \n, a skalary w cudzysłowach lub zwykłe mogą ciągnąć się przez kilka linii, przy czym każde pojedyncze złamanie zamienia się w spację. Gdy tekst robi się długi, skalary blokowe łatwiej czytać.
Jak naprawdę działa zwijanie
- Zwijanie łączy tylko dwie sąsiednie linie, które obie zaczynają się na poziomie wcięcia bloku. Jedno złamanie między nimi staje się spacją. Jeśli zostawisz jedną pustą linię, wartość dostaje zamiast tego jeden znak nowej linii i tak właśnie zapisuje się akapity.
- Linia zaczynająca się od dodatkowych spacji zostaje bez zmian, podobnie jak złamania po obu jej stronach. Tę właśnie regułę stosuje podgląd, więc spróbuj wciąć jedną linię i zobacz, co się stanie.
Wskaźniki wcięcia
- Jeśli pierwsza linia treści musi zaczynać się od spacji, YAML nie zgadnie wcięcia. Dodaj cyfrę do nagłówka, na przykład |2, aby określić, o ile spacji blok jest wcięty względem rodzica.
- Cyfrę i znak chomping można łączyć w dowolnej kolejności, na przykład |2- lub |-2.
Skalary blokowe w prawdziwych plikach
Polecenia powłoki w kroku CI
Styl literalny zachowuje każde polecenie w osobnej linii, czego potrzebuje powłoka.
Długi opis zwinięty w jeden akapit
Zwinięty i obcięty: wartość to jedna linia tekstu bez znaku nowej linii na końcu.
Zachowanie końcowych pustych linii
Z + pusta linia po tekście pozostaje w wartości, więc sparsowany string kończy się dwoma znakami nowej linii.
Podgląd skalara blokowego
Wpisz tekst, wybierz styl i wskaźnik chomping, a zobaczysz YAML, który byś napisał, obok dokładnego stringa zwracanego przez parser.
Tekst do zapisania
Styl bloku
Literal |
Folded >
Wskaźnik chomping
Strip -
Clip (domyślnie)
Keep +
Puste linie po bloku
YAML
Wynikowy string (notacja JSON)
Znaki: {n}, złamania linii: {b}
Dziękujemy za zamówienie. Wysyłka w ciągu dwóch dni. Pytania? Odpowiedz na tego e-maila. Nr zamówienia: 10442
Zacznij za darmo · Bez karty kredytowej
Powiązane: Poradniki
- YAML vs JSON
- 401 vs 403
- Przykłady stron 404
- E-maile o porzuconym koszyku
- SMS o porzuconym koszyku
- Przykłady strony „O nas”
- Jak przyjmować płatności na stronie internetowej
- Zgodność strony z ADA dla małych firm (poradnik 2026)
Produkt
Dla kogo
- Dla agencji
- Dla freelancerów
- Dla firm hostingowych
- Dla platform SaaS
- Dla startupów
- Usługi finansowe
- Rozwiązania dla ochrony zdrowia
Funkcje
Zasoby
- Blog
- Centrum pomocy
- Darmowe narzędzia dla firm
- Free UI Components
- Szablony
- Kolekcje szablonów
- Przykłady stron
- Poradniki
- Porównania
- Alternatywy
- Najlepsze
- Recenzje
- Przewodniki po cenach
- Zastosowania
- Słownik i poradniki
- Integracje
- Dla programistów
- Benchmark
- Windows App