English | العربية | বাংলা | Bosanski | Deutsch | Español | Français | हिन्दी | Italiano | 日本語 | 한국어 | मराठी | Português | Русский | Kiswahili | தமிழ் | తెలుగు | Türkçe | اردو | Tiếng Việt | 中文

# అనువాద హెచ్చరిక

ఈ పత్రాన్ని స్వయంచాలకంగా అనువదించారు. అనువాద దోషాలు ఉంటే దయచేసి ప్రాజెక్ట్‌లో పుల్ రిక్వెస్ట్ తెరవండి మరియు అనువదించిన ఫైల్‌ను docs/{ISO 639-1 Code}.mdకి జోడించండి.

• పరిచయం
  • ఉదాహరణ
• వినియోగం (లారవెల్ లేకుండా)
  • MJML రెండరింగ్
  • MJML ధృవీకరణ
  • MJML ధృవీకరణ
  • కాన్ఫిగరేషన్
  • ఫాంట్లు
  • వ్యాఖ్యలు
  • ఇగ్నోర్ ఇన్క్లూడ్స్
  • బ్యూటిఫై
  • మినిఫై
  • వాలిడేషన్ లెవెల్
  • ఫైల్ పాత్
  • జ్యూస్

🔗పరిచయం

MJML అనేది ప్రతిస్పందించే ఇమెయిల్స్ కోడింగ్ ప్రక్రియను సరళతరం చేయడానికి ప్రత్యేకంగా రూపొందించిన ఒక మార్కప్ భాష. దాని సేమాంటిక్ సింటాక్స్ సులభతరం మరియు సరళతరం చేస్తుంది, మరియు దాని విస్తృతమైన ప్రామాణిక భాగాల గ్రంథాలయం అభివృద్ధిని వేగవంతం చేస్తుంది మరియు మీ ఇమెయిల్ కోడ్‌బేస్ యొక్క సంక్లిష్టతను తగ్గిస్తుంది. MJML యొక్క ఓపెన్-సోర్స్ ఇంజిన్ ఉత్తమ పద్ధతులకు అనుగుణంగా ఉన్న అధిక-నాణ్యత, ప్రతిస్పందించే HTMLని ఉత్పత్తి చేస్తుంది. మీరు Outlookతో పని చేసే సమయంలో ఎదురయ్యే నిరాశలను అనుభవించినట్లయితే, ఈ ప్యాకేజీ మీ కోసం రూపొందించబడింది.

మా MJML అమలు అధికారిక MJML APIకి ఒక రాపర్‌గా పనిచేస్తుంది. ఇది MJMLని PHPలో నేరుగా HTMLగా సౌకర్యవంతంగా కంపైల్ చేయడానికి అనుమతిస్తుంది, NodeJS అవసరం లేకుండా. ఈ ప్యాకేజీ NodeJS మరియు MJML CLIని ఇన్‌స్టాల్ చేయడం యొక్క ఇబ్బందిని లేకుండా MJMLని చేర్చుకోవాలనుకునే PHP అప్లికేషన్లకు అనుకూలంగా ఉంటుంది.

🔗ఉదాహరణ

// లారావెల్ లేకుండా
(new MJML)->render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);
 
// మినిఫైడ్ HTML
(new MJML)->minify()->render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);
 
// లారావెల్‌తో
MJML::render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);
 
// లారావెల్ మరియు మినిఫైడ్ HTMLతో
MJML::minify()->render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);

# ఇన్‌స్టాలేషన్

1. ముందుగా మీ composer.json ఫైల్‌లో క్రింది కోడ్‌ను జోడించండి, తద్వారా మా ప్యాకేజీ ఇన్‌స్టాల్ చేసినప్పుడు మీ ఆపరేటింగ్ సిస్టమ్‌కు సరైన బైనరీలను పొందుతుంది. మీరు install, update, లేదా dump-autoload నడిపిన తర్వాత బైనరీలు డౌన్‌లోడ్ అవుతాయి.

   {
       "post-autoload-dump": ["DefectiveCode\\MJML\\PullBinary::all"]
   }

   MJML బైనరీ మా CDN నుండి పొందబడుతుంది మరియు కంపోజర్ యొక్క ఇన్‌స్టాలేషన్ లేదా అప్‌డేట్ సమయంలో ఈ ప్యాకేజీ యొక్క "bin" ఫోల్డర్‌లో సేవ్ చేయబడుతుంది. మీ స్థానిక మరియు ప్రొడక్షన్ వాతావరణాల కోసం అవసరమైన బైనరీలు లోడ్ చేయబడ్డాయని నిర్ధారించుకోండి.

   డిఫాల్ట్‌గా, all మేము మద్దతు ఇచ్చే అన్ని బైనరీలను పొందుతుంది. బ్యాండ్‌విడ్త్ మరియు ఇన్‌స్టాలేషన్ సమయాలను ఆదా చేయడానికి మీరు అవసరమైన ఆపరేటింగ్ మరియు ఆర్కిటెక్చర్ సిస్టమ్‌లకు దీన్ని పరిమితం చేయాలని మేము సిఫార్సు చేస్తున్నాము. క్రింది బైనరీలు అందుబాటులో ఉన్నాయి.

   ఆపరేటింగ్ సిస్టమ్	ఆర్కిటెక్చర్	కంపోజర్ పోస్ట్ అప్‌డేట్ కమాండ్
   అన్ని	అన్ని	DefectiveCode\MJML\PullBinary::all
   డార్విన్ (మాకోస్)	arm64	DefectiveCode\MJML\PullBinary::darwin-arm64
   డార్విన్ (మాకోస్)	x64	DefectiveCode\MJML\PullBinary::darwin-x64
   లినక్స్	arm64	DefectiveCode\MJML\PullBinary::linux-arm64
   లినక్స్	x64	DefectiveCode\MJML\PullBinary::linux-x64

2. తదుపరి, క్రింది కంపోజర్ కమాండ్ నడిపి PHP ప్యాకేజీని ఇన్‌స్టాల్ చేయండి:

   composer require defectivecode/mjml

3. అంతే! లారావెల్ ఉపయోగిస్తుంటే, మా ప్యాకేజీ లారావెల్ యొక్క ప్యాకేజీ డిస్కవరీని ఉపయోగించి ఆటోమేటిక్‌గా ఇన్‌స్టాల్ అవుతుంది.

   🔗వినియోగం (లారవెల్ లేకుండా)

మీరు లారవెల్ ఉపయోగిస్తుంటే, క్రింద లారవెల్ తో వినియోగం చూడండి.

🔗MJML రెండరింగ్

MJML ను రెండర్ చేయడానికి, మీ MJML స్ట్రింగ్ ను render పద్ధతికి పాస్ చేయండి:

use DefectiveCode\MJML;
 
$html = (new MJML)->render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);

🔗MJML ధృవీకరణ

MJML ను ధృవీకరించడానికి, మీ MJML స్ట్రింగ్ ను isValid పద్ధతికి పాస్ చేయండి:

use DefectiveCode\MJML;
 
$isValid = (new MJML)->isValid(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);

# వినియోగం (లారావెల్ తో)
 
## MJML రెండరింగ్
 
MJML ను రెండర్ చేయడానికి, మీ MJML స్ట్రింగ్ ను MJML ఫసాడ్ లోని `render` కు పాస్ చేయండి:
 
```php
use DefectiveCode\MJML\Facades\MJML;
 
$html = MJML::render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);

🔗MJML ధృవీకరణ

MJML ను ధృవీకరించడానికి, మీ MJML స్ట్రింగ్ ను MJML ఫసాడ్ లోని isValid పద్ధతికి పాస్ చేయండి:

use DefectiveCode\MJML\Facades\MJML;
 
$isValid = MJML::isValid(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);

🔗కాన్ఫిగరేషన్

మీరు క్రింది ఆదేశాన్ని ఉపయోగించి కాన్ఫిగరేషన్ ఫైల్ ను ప్రచురించవచ్చు:

php artisan vendor:publish --provider="DefectiveCode\MJML\MJMLServiceProvider"

ఇది మీ config ఫోల్డర్ లో mjml.php కాన్ఫిగరేషన్ ఫైల్ ను సృష్టిస్తుంది. కాన్ఫిగరేషన్ ఫైల్ లో జాబితా చేయబడిన అన్ని ఎంపికలు మీరు MJML ఫసాడ్ ను ఉపయోగించినప్పుడు config ఆబ్జెక్ట్ కు పాస్ చేయబడతాయి.

# కాన్ఫిగరేషన్
 
అన్ని కాన్ఫిగరేషన్ ఎంపికలను MJML ఆబ్జెక్ట్ పై నేరుగా ఈ క్రింది పద్ధతులను పిలిచి సెట్ చేయవచ్చు.
 
```php
use DefectiveCode\MJML;
 
$html = (new MJML)
    ->setMinify(true)
    ->setBeautify(false)
    ->render(
        '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
    );

మా ప్యాకేజీ అధికారిక MJML ప్యాకేజీతో అదే కాన్ఫిగరేషన్ ను అనుసరిస్తుంది కానీ ఈ క్రింది వాటిని మినహాయించి:

• preprocessors - ఈ ఎంపిక అందుబాటులో లేదు. మీరు ఈ ఎంపికను జోడించాలనుకుంటే దయచేసి ఒక పుల్ రిక్వెస్ట్ తెరవండి.
• minifyOptions - మేము html-minifier-terser ను ఉపయోగిస్తాము, అధికారిక ప్యాకేజీ html-minifier ను మినిఫికేషన్ కోసం ఉపయోగిస్తుంది. మేము ప్రాసెసర్ ను మార్చాలని నిర్ణయించుకున్నాము ఎందుకంటే html-minifier ఇకపై నిర్వహించబడదు మరియు దానికి కొన్ని భద్రతా సమస్యలు ఉన్నాయి.

🔗ఫాంట్లు

మా ప్యాకేజీ డిఫాల్ట్ గా ఈ క్రింది ఫాంట్లను ఉపయోగిస్తుంది:

• Open Sans: 'https://fonts.googleapis.com/css?family=Open+Sans:300,400,500,700
• Droid Sans: 'https://fonts.googleapis.com/css?family=Droid+Sans:300,400,500,700
• Lato: https://fonts.googleapis.com/css?family=Lato:300,400,500,700
• Roboto: https://fonts.googleapis.com/css?family=Roboto:300,400,500,700
• Ubuntu: https://fonts.googleapis.com/css?family=Ubuntu:300,400,500,700

మీరు ఈ క్రింది పద్ధతులను ఉపయోగించి ఫాంట్లను మార్చవచ్చు:

• addFont(string $font, string $url) - ఫాంట్ల జాబితాకు ఒక ఫాంట్ ను జోడించండి.
• removeFont(string$font) - ఫాంట్ల జాబితా నుండి ఒక ఫాంట్ ను తీసివేయండి.
• setFonts(array $fonts) - ఫాంట్ల జాబితాను సెట్ చేయండి. మీరు ఈ ఫార్మాట్ లో ఫాంట్ల యొక్క ఒక శ్రేణిని అందించాలి: ['font-name' => 'font-url'].

🔗వ్యాఖ్యలు

వ్యాఖ్యలు డిఫాల్ట్ గా ఉంచబడతాయి. మీరు వ్యాఖ్యలను తీసివేయాలనుకుంటే, మీరు removeComments() పద్ధతిని ఉపయోగించవచ్చు.

మీరు removeComments() ను తిరిగి పిలిచి keepComments() పద్ధతిని పిలవవచ్చు.

🔗ఇగ్నోర్ ఇన్క్లూడ్స్

డిఫాల్ట్ గా, మా ప్యాకేజీ ఏదైనా mj-include ట్యాగ్ లను చేర్చుతుంది. మీరు ఈ ప్రవర్తనను ignoreIncludes(bool $ignore) పద్ధతిని పిలిచి సర్దుబాటు చేయవచ్చు.

🔗బ్యూటిఫై

మా ప్యాకేజీ ఈ క్రింది డిఫాల్ట్ ఎంపికలతో js-beautify ను ఉపయోగించి HTML ను అందంగా చేస్తుంది:

• indentSize: 2
• wrapAttributesIndentSize: 2
• maxPreserveNewline: 0
• preserveNewlines: false

js-beautify ఎంపికలను అందించడానికి snake_case ను ఉపయోగిస్తుంది, కానీ మీరు మా ప్యాకేజీని ఉపయోగించినప్పుడు camelCase ను ఉపయోగించాలి. మేము మా ప్యాకేజీని మిగతా కాన్ఫిగరేషన్ ఎంపికలతో సజావుగా ఉంచడానికి ఈ ఎంపికను చేసాము. మా ప్యాకేజీ camelCase ఎంపికలను snake_case కు స్వయంచాలకంగా మార్చుతుంది.

మీరు ఈ ఎంపికలలో ఏదైనా js-beautify కాన్ఫిగరేషన్ ను అందించి సవరించవచ్చు:

• setBeautifyOptions(array $options) - js-beautify ఎంపికలను సెట్ చేయండి.
• addBeautifyOption(string $option, mixed $value) - ఒక js-beautify ఎంపికను జోడించండి.
• removeBeautifyOption(string $option) - ఒక js-beautify ఎంపికను తీసివేయండి.

🔗మినిఫై

మా ప్యాకేజీ ఈ క్రింది డిఫాల్ట్ ఎంపికలతో html-minifier-terser ను ఉపయోగించి HTML ను మినిఫై చేస్తుంది:

• collapseWhitespace: true
• minifyCSS: false
• caseSensitive: true
• removeEmptyAttributes: true

మీరు ఈ ఎంపికలలో ఏదైనా html-minifier-terser కాన్ఫిగరేషన్ ను అందించి సవరించవచ్చు:

• setMinifyOptions(array $options) - html-minifier-terser ఎంపికలను సెట్ చేయండి.
• addMinifyOption(string $option, mixed $value) - ఒక html-minifier-terser ఎంపికను జోడించండి.
• removeMinifyOption(string $option) - ఒక html-minifier-terser ఎంపికను తీసివేయండి.

🔗వాలిడేషన్ లెవెల్

మా ప్యాకేజీ డిఫాల్ట్ గా soft వాలిడేషన్ లెవెల్ ను ఉపయోగించి MJML ను వాలిడేట్ చేస్తుంది. మీరు ఈ క్రింది పద్ధతిని ఉపయోగించి దీన్ని మార్చవచ్చు: validationLevel(ValidationLevel $validationLevel). ఈ క్రింది వాలిడేషన్ లెవెల్స్ అందుబాటులో ఉన్నాయి:

• strict - మీ డాక్యుమెంట్ వాలిడేషన్ ద్వారా వెళ్తుంది మరియు దానిలో ఏదైనా లోపం ఉంటే అది రెండర్ చేయబడదు
• soft - మీ డాక్యుమెంట్ వాలిడేషన్ ద్వారా వెళ్తుంది మరియు లోపాలు ఉన్నప్పటికీ రెండర్ చేయబడుతుంది
• skip - మీ డాక్యుమెంట్ వాలిడేషన్ ద్వారా వెళ్ళకుండా రెండర్ చేయబడుతుంది.

🔗ఫైల్ పాత్

మా ప్యాకేజీ డిఫాల్ట్ గా . డైరెక్టరీని ఉపయోగిస్తుంది. మీరు ఈ క్రింది పద్ధతిని పిలిచి దీన్ని మార్చవచ్చు: filePath(string $path).

🔗జ్యూస్

మేము డిఫాల్ట్ గా ఏ జ్యూస్ ఎంపికలను అందించము. మీరు ఈ క్రింది పద్ధతులను ఉపయోగించి జ్యూస్ ఎంపికలను జోడించవచ్చు:

• setJuiceOptions(array $options) - జ్యూస్ ఎంపికలను సెట్ చేయండి.
• addJuiceOption(string $option, mixed $value) - ఒక జ్యూస్ ఎంపికను జోడించండి.
• removeJuiceOption(string $option) - ఒక జ్యూస్ ఎంపికను తీసివేయండి.
• setJuicePreserveTags(array $tags) - జ్యూస్ ప్రిజర్వ్ ట్యాగ్ లను సెట్ చేయండి.
• addJuicePreserveTag(string $tag, mixed $value) - ఒక జ్యూస్ ప్రిజర్వ్ ట్యాగ్ ను జోడించండి.
• removeJuicePreserveTag(string $tag) - ఒక జ్యూస్ ప్రిజర్వ్ ట్యాగ్ ను తీసివేయండి.

# మద్దతు మార్గదర్శకాలు
 
మా ఓపెన్ సోర్స్ ప్యాకేజీని ఎంచుకున్నందుకు ధన్యవాదాలు! దయచేసి ఈ మద్దతు మార్గదర్శకాలను చూడటానికి ఒక క్షణం తీసుకోండి. ఇవి మా ప్రాజెక్ట్ నుండి మీకు ఎక్కువ ప్రయోజనం పొందడంలో సహాయపడతాయి.
 
## కమ్యూనిటీ ఆధారిత మద్దతు
 
మా ఓపెన్ సోర్స్ ప్రాజెక్ట్ మా అద్భుతమైన కమ్యూనిటీ ద్వారా నడపబడుతుంది. మీకు ప్రశ్నలు లేదా సహాయం అవసరమైతే, StackOverflow మరియు ఇతర ఆన్‌లైన్ వనరులు మీకు ఉత్తమ ఎంపికలు.
 
## బగ్స్ మరియు ఫీచర్ ప్రాధాన్యత
 
ఓపెన్ సోర్స్ ప్రాజెక్ట్‌ను నిర్వహించడం అంటే ప్రతి నివేదించబడిన బగ్ లేదా ఫీచర్ అభ్యర్థనను తక్షణమే పరిష్కరించలేమని వాస్తవం. మేము సమస్యలను కింది క్రమంలో ప్రాధాన్యత ఇస్తాము:
 
### 1. మా చెల్లింపు ఉత్పత్తులను ప్రభావితం చేసే బగ్స్
 
మా చెల్లింపు ఉత్పత్తులను ప్రభావితం చేసే బగ్స్ ఎల్లప్పుడూ మా అత్యంత ప్రాధాన్యతగా ఉంటాయి. కొన్ని సందర్భాల్లో, మేము మమ్మల్ని నేరుగా ప్రభావితం చేసే బగ్‌లను మాత్రమే పరిష్కరిస్తాము.
 
### 2. కమ్యూనిటీ పుల్ రిక్వెస్టులు
 
మీరు బగ్‌ను గుర్తించి దానికి పరిష్కారం కనుగొంటే, దయచేసి పుల్ రిక్వెస్ట్‌ను సమర్పించండి. మా ఉత్పత్తులను ప్రభావితం చేసే సమస్యల తర్వాత, ఈ కమ్యూనిటీ ఆధారిత పరిష్కారాలకు మేము తదుపరి అత్యధిక ప్రాధాన్యత ఇస్తాము. సమీక్షించి ఆమోదించిన తర్వాత, మేము మీ పరిష్కారాన్ని విలీనం చేసి మీ సహకారానికి క్రెడిట్ ఇస్తాము.
 
### 3. ఆర్థిక మద్దతు
 
పైన పేర్కొన్న వర్గాల వెలుపల ఉన్న సమస్యల కోసం, మీరు వాటి పరిష్కారానికి నిధులు సమకూర్చుకోవచ్చు. ప్రతి ఓపెన్ ఇష్యూ ఆర్డర్ ఫారమ్‌కు లింక్ చేయబడింది, మీరు ఆర్థికంగా సహకరించవచ్చు. మేము అందించిన నిధి మొత్తాన్ని బట్టి ఈ సమస్యలకు ప్రాధాన్యత ఇస్తాము.
 
### కమ్యూనిటీ సహకారాలు
 
కమ్యూనిటీ చురుకుగా ఉన్నప్పుడు ఓపెన్ సోర్స్ వికసిస్తుంది. మీరు బగ్‌లను పరిష్కరించకపోయినా, కోడ్ మెరుగుదలలు, డాక్యుమెంటేషన్ నవీకరణలు, ట్యుటోరియల్స్ లేదా కమ్యూనిటీ ఛానెల్‌లలో ఇతరులకు సహాయం చేయడం ద్వారా సహకరించడానికి పరిగణించండి. ఓపెన్ సోర్స్ పనిని మద్దతు ఇవ్వడానికి మేము అందరినీ, కమ్యూనిటీగా, బలంగా ప్రోత్సహిస్తున్నాము.
 
_మళ్ళీ చెప్పాలంటే, DefectiveCode మా చెల్లింపు ఉత్పత్తులను, కమ్యూనిటీ పుల్ రిక్వెస్టులను మరియు సమస్యల కోసం అందుకున్న ఆర్థిక మద్దతును బట్టి బగ్‌లకు ప్రాధాన్యత ఇస్తుంది._

# లైసెన్స్ - MIT లైసెన్స్
 
కాపీరైట్ © డిఫెక్టివ్ కోడ్, LLC. అన్ని హక్కులు రిజర్వ్ చేయబడ్డాయి
 
ఈ సాఫ్ట్‌వేర్ మరియు సంబంధిత డాక్యుమెంటేషన్ ఫైళ్ల (సాఫ్ట్‌వేర్) యొక్క కాపీని పొందిన ఏ వ్యక్తికైనా, ఈ సాఫ్ట్‌వేర్‌ను పరిమితి లేకుండా ఉపయోగించడానికి, కాపీ చేయడానికి, సవరించడానికి, విలీనం చేయడానికి, ప్రచురించడానికి, పంపిణీ చేయడానికి, సబ్‌లైసెన్స్ ఇవ్వడానికి మరియు/లేదా సాఫ్ట్‌వేర్ కాపీలను అమ్మడానికి మరియు సాఫ్ట్‌వేర్ అందించబడిన వ్యక్తులను ఈ క్రింది షరతులకు లోబడి చేయడానికి అనుమతి ఉచితంగా ఇవ్వబడింది:
 
**పై కాపీరైట్ నోటీసు మరియు ఈ అనుమతి నోటీసు సాఫ్ట్‌వేర్ యొక్క అన్ని కాపీలలో లేదా ముఖ్యమైన భాగాలలో చేర్చబడాలి.**
 
సాఫ్ట్‌వేర్ "అలానే" అందించబడుతుంది, ఎటువంటి రకాల వారంటీ లేకుండా, వ్యక్తంగా లేదా సూచనాత్మకంగా, కానీ పరిమితం చేయకుండా, విక్రయయోగ్యత, నిర్దిష్ట ప్రయోజనానికి తగినదిగా మరియు ఉల్లంఘనకు సంబంధించిన వారంటీలను కూడా కలిగి ఉంటుంది. ఏదైనా సంఘటనలో రచయితలు లేదా కాపీరైట్ హోల్డర్లు ఏదైనా క్లెయిమ్, నష్టాలు లేదా ఇతర బాధ్యతకు బాధ్యులు కారు, ఒప్పందం, టార్ట్ లేదా వేరే విధంగా, సాఫ్ట్‌వేర్ నుండి లేదా సాఫ్ట్‌వేర్ ఉపయోగం లేదా ఇతర లావాదేవీలలో ఉత్పన్నమయ్యే.