कर रहे हैं 5 6 नौ (या 63 *, आप कैसे गिनती निर्भर करता है) YAML में बहु लाइन तार लिखने के लिए अलग अलग तरीकों से।
टी एल; डॉ
आमतौर पर, आप चाहते हैं >
:
key: >
Your long
string here.
यदि आप चाहते हैं कि लाइनब्रेक को \n
स्ट्रिंग में संरक्षित किया जाए (उदाहरण के लिए, पैराग्राफ के साथ एम्बेडेड मार्कडाउन), का उपयोग करें |
।
key: |
### Heading
* Bullet
* Points
उपयोग >-
या |-
इसके बजाय अगर आप अंत में एक लाइनब्रेक संलग्न नहीं करना चाहते हैं।
यदि आपको शब्दों के बीच में रेखाओं को विभाजित करने की आवश्यकता है या शाब्दिक रूप से लाइनब्रेक टाइप \n
करें, तो इसके बजाय दोहरे उद्धरण चिह्नों का उपयोग करें:
key: "Antidisestab\
lishmentarianism.\n\nGet on it."
YAML पागल है।
ब्लॉक अदिश शैलियों ( >
, |
)
ये ऐसे पात्रों की अनुमति देते हैं जैसे कि बचकर \
और "
बिना भाग लिए, और \n
अपनी स्ट्रिंग के अंत में एक नई पंक्ति ( ) जोड़ें ।
>
तह शैली स्ट्रिंग के भीतर एकल newlines निकालती है (लेकिन अंत में एक जोड़ता है, और एकल के लिए डबल newlines कनवर्ट करता है):
Key: >
this is my very very very
long string
→ this is my very very very long string\n
|
लिटरल स्टाइल स्ट्रिंग के भीतर हर न्यूलाइन को शाब्दिक न्यूलाइन में बदल देता है, और अंत में एक जोड़ता है:
Key: |
this is my very very very
long string
→ this is my very very very\nlong string\n
यहाँ YAML कल्पना 1.2 से आधिकारिक परिभाषा है
स्केलर सामग्री को ब्लॉक नोटेशन में लिखा जा सकता है, शाब्दिक शैली का उपयोग करके ("|" द्वारा दर्शाया गया है) जहां सभी लाइन ब्रेक महत्वपूर्ण हैं। वैकल्पिक रूप से, उन्हें तह शैली (">" द्वारा निरूपित) के साथ लिखा जा सकता है, जहां प्रत्येक पंक्ति विराम को एक स्थान पर मोड़ दिया जाता है जब तक कि यह एक खाली या अधिक-इंडेंटेड पंक्ति समाप्त नहीं होती है।
ब्लॉक chomping सूचक के साथ ब्लॉक शैलियों ( >-
, |-
, >+
, |+
)
आप स्ट्रिंग में अंतिम नई लाइन, और ब्लॉक ट्रेलिंग इंडिकेटर कैरेक्टर \n\n
जोड़कर किसी भी ट्रेलिंग ब्लैंक लाइन ( ) को नियंत्रित कर सकते हैं :
>
, |
: "क्लिप": रखने लाइन फ़ीड, अनुगामी रिक्त लाइनों को हटा दें।
>-
, |-
: "पट्टी": लाइन फीड हटानी, अनुगामी रिक्त लाइनों को हटा दें।
>+
, |+
: "रखना": लाइन फ़ीड रखने के लिए, रिक्त लाइनों अनुगामी रहते हैं।
"फ्लो" अदिश शैलियों (
, "
, '
)
इनमें सीमित पलायन होता है, और सिंगल लाइन स्ट्रिंग का निर्माण होता है जिसमें कोई नई लाइन वर्ण नहीं होती है। वे कुंजी के रूप में एक ही लाइन पर शुरू कर सकते हैं, या पहले अतिरिक्त newlines के साथ।
सादे शैली (कोई बच नहीं, कोईसंयोजन#
या:
, पहले चरित्र पर सीमाएं):
Key: this is my very very very
long string
दो-तरफा शैली (\
और इससेबचना"
चाहिए\
, नई कहानियों को शाब्दिक\n
अनुक्रम केसाथ डाला जा सकता है, लाइनों को अनुगामी के साथ रिक्त स्थान के बिना सुधारा जा सकता है\
):
Key: "this is my very very \"very\" loooo\
ng string.\n\nLove, YAML."
→ "this is my very very \"very\" loooong string.\n\nLove, YAML."
एकल-उद्धृत शैली (शाब्दिक'
को दोगुना होना चाहिए, कोई विशेष वर्ण नहीं, संभवतः दोहरे उद्धरण के साथ शुरू होने वाले तार को व्यक्त करने के लिए उपयोगी है):
Key: 'this is my very very "very"
long string, isn''t it.'
→ "this is my very very \"very\" long string, isn't it."
सारांश
इस तालिका में, का _
अर्थ है space character
। \n
"न्यूलाइन वर्ण" ( \n
जावास्क्रिप्ट में), "इन-लाइन न्यूलाइन्स" पंक्ति को छोड़कर, जहां इसका शाब्दिक अर्थ है बैकस्लैश और एन)।
> | " ' >- >+ |- |+
-------------------------|------|-----|-----|-----|------|------|------|------
Trailing spaces | Kept | Kept | | | | Kept | Kept | Kept | Kept
Single newline => | _ | \n | _ | _ | _ | _ | _ | \n | \n
Double newline => | \n | \n\n | \n | \n | \n | \n | \n | \n\n | \n\n
Final newline => | \n | \n | | | | | \n | | \n
Final dbl nl's => | | | | | | | Kept | | Kept
In-line newlines | No | No | No | \n | No | No | No | No | No
Spaceless newlines| No | No | No | \ | No | No | No | No | No
Single quote | ' | ' | ' | ' | '' | ' | ' | ' | '
Double quote | " | " | " | \" | " | " | " | " | "
Backslash | \ | \ | \ | \\ | \ | \ | \ | \ | \
" #", ": " | Ok | Ok | No | Ok | Ok | Ok | Ok | Ok | Ok
Can start on same | No | No | Yes | Yes | Yes | No | No | No | No
line as key |
उदाहरण
"रिक्त स्थान" से पहले लाइन पर अनुगामी रिक्त स्थान पर ध्यान दें।
- >
very "long"
'string' with
paragraph gap, \n and
spaces.
- |
very "long"
'string' with
paragraph gap, \n and
spaces.
- very "long"
'string' with
paragraph gap, \n and
spaces.
- "very \"long\"
'string' with
paragraph gap, \n and
s\
p\
a\
c\
e\
s."
- 'very "long"
''string'' with
paragraph gap, \n and
spaces.'
- >-
very "long"
'string' with
paragraph gap, \n and
spaces.
[
"very \"long\" 'string' with\nparagraph gap, \\n and spaces.\n",
"very \"long\"\n'string' with\n\nparagraph gap, \\n and \nspaces.\n",
"very \"long\" 'string' with\nparagraph gap, \\n and spaces.",
"very \"long\" 'string' with\nparagraph gap, \n and spaces.",
"very \"long\" 'string' with\nparagraph gap, \\n and spaces.",
"very \"long\" 'string' with\nparagraph gap, \\n and spaces."
]
इंडेंटेशन इंडिकेटर्स के साथ ब्लॉक स्टाइल
यदि आपके लिए उपरोक्त पर्याप्त नहीं है, तो आप " ब्लॉक इंडेंटेशन इंडिकेटर " जोड़ सकते हैं (आपके ब्लॉक चॉम्पिंग इंडिकेटर के बाद, यदि आपके पास एक है):
- >8
My long string
starts over here
- |+1
This one
starts here
परिशिष्ट
यदि आप फोल्डेड स्टाइल में नॉट-द-फर्स्ट लाइन्स की शुरुआत में अतिरिक्त स्पेस डालते हैं, तो उन्हें बोनस न्यूलाइन के साथ रखा जाएगा। प्रवाह शैलियों के साथ ऐसा नहीं होता है:
- >
my long
string
- my long
string
→ ["my long\n string\n", "my long string"]
मैं भी नहीं कर सकता।
*
2 ब्लॉक शैली, प्रत्येक में 2 संभव ब्लॉक चोमिंग संकेतक (या कोई नहीं), और 9 संभव इंडेंटेशन संकेतक (या कोई नहीं), 1 सादे शैली और 2 उद्धृत शैलियों के साथ: 2 x (2 + 1) x (9 + 1) + 1 + 2 = 63
इस जानकारी में से कुछ को यहाँ संक्षेप में प्रस्तुत किया गया है ।