English | العربية | বাংলা | Bosanski | Deutsch | Español | Français | हिन्दी | Italiano | 日本語 | 한국어 | मराठी | Português | Русский | Kiswahili | தமிழ் | తెలుగు | Türkçe | اردو | Tiếng Việt | 中文
- மேம்படுத்துதல்
- அறிமுகம்
- நிறுவுதல்
- பயன்பாடு (லரவேல் இல்லாமல்)
- பயன்பாடு (லரவேல் உடன்)
- கட்டமைப்பு
- ஆதரவு வழிகாட்டிகள்
- உரிமம் - MIT உரிமம்
மேம்படுத்துதல்
நீங்கள் முந்தைய பதிப்பில் இருந்து மேம்படுத்துகிறீர்கள் என்றால், உடைந்து போக்குகளை மற்றும் இடமாற்றத்தின் படிகள் பற்றிய மேம்படுத்தல் கையேடு ஐப் பார்வையிடவும்.
அறிமுகம்
MJML என்பது பணி செய்திகளின் அடிப்படையை எளிதாக்குவதற்காக குறிப்பிட்ட திட்டமிடல் மொழியாகும். அதன் அர்த்தமுள்ள வகைபாடு எளிமையும், போதுமானதையும் உறுதிப்படுத்துகிறது, மேலும் அதன் விசாலமான மானிடப் பகுதிகளைப் பயன்படுத்துவது வளர்ச்சி மற்றும் உங்கள் மின்னஞ்சல் குறியீட்டு அடிக்கட் தீர்வு சிக்கல்களை குறைக்கிறது. MJML இன் திறமையான மின்கொண்டு தரமான, பதிலளிக்கும் HTML ஐ உருவாக்குகிறது, இது சிறந்த நடைமுறைகளைச் செயற்கரிக்கிறது. நீங்கள் ஆவணங்களைப் பயன்படுத்துவதில் ஏற்பட்ட பிரச்சினைகளை அனுபவித்திருந்தால், இந்த தொகுப்பு உங்களுக்காக வடிவமைக்கப்பட்டுள்ளது.
எங்கள் 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>');
நிறுவுதல்
-
முதலில், உங்கள்
composer.jsonகோப்பில் கீழ்க்காணும் உள்ளடக்கத்தைச் சேர்க்கவும், இது எங்கள் தொகுப்புக்கு உங்கள் செயல்பாட்டு அமைப்பிற்கான சரியான எண்களைப் பெற்று எமது தொகுப்பை நிறுவும் போது அணைத்து மின்கொண்டு கீழே சேர்க்கும்.install,updateஅல்லதுdump-autoloadஐ இயக்கும் போது எண்கள் பதிவிறக்கம் செய்யப்படும்.{"post-autoload-dump": ["DefectiveCode\\MJML\\PullBinary::all"]}MJML மின்கொண்டு எங்கள் CDN இல் இருந்து பெறப்படும் மற்றும் இந்த தொகுப்பின் "bin" கோப்புறையில் சேமிக்கப்படும், கம்போரர் நிறுவலின் அல்லது அப்டேட்டின் போது. உங்கள் உள்ளூர் மற்றும் உற்பத்தி இடங்களில் தேவையான மின்கொந்துகளை உறுதிசெய்யவும்.
ஏற்கனவே,
allஎங்கள் ஆதரவு தரப்பட்ட அனைத்து மின்கொந்துகளை அமுக்கமாக்கும். bandwidth மற்றும் நிறுவல் நேரங்களில் சேமிக்கும் முறையை ஏற்படுத்த நீங்கள் இது ஒரு முறுகி கட்டுப்படுத்தவேண்டும். கீழ்க்காணும் மின்கொந்துகள் கிடைக்கும்.செயல்பாட்டு அமைப்பு கட்டமைப்பு கம்பெஸர் பிற பதின்முறையாளர் கட்டளை அனைத்தும் அனைத்தும் DefectiveCode\MJML\PullBinary::allடார்வின் (மக்கோஸ்) arm64 DefectiveCode\MJML\PullBinary::darwin-arm64டார்வின் (மக்கோஸ்) x64 DefectiveCode\MJML\PullBinary::darwin-x64லினக்ஸ் (glibc) arm64 DefectiveCode\MJML\PullBinary::linux-arm64லினக்ஸ் (glibc) x64 DefectiveCode\MJML\PullBinary::linux-x64லினக்ஸ் (musl) arm64 DefectiveCode\MJML\PullBinary::linux-arm64-muslலினக்ஸ் (musl) x64 DefectiveCode\MJML\PullBinary::linux-x64-musl -
அடுத்தவையாக, கீழ்க்காணும் கம்பெஸர் கட்டளை அடிப்படையில் PHP தொகுப்பை நிறுவவும்:
composer require defectivecode/mjml -
இதுவே! லரவேல் பயன்படுத்தும் போது, எங்கள் தொகுப்பு லரவேலின் தொகுப்பு கண்டுபிடிப்பைக் கொண்டு தானாகவே நிறுவப்படும்.
பயன்பாடு (லரவேல் இல்லாமல்)
நீங்கள் லரவேல் அர்த்தத்தில் பயரம் பார்க்கப்படுமானால் கீழே லரவேல் உடன் பயன்பாடுகளைப் பார்வையிடுங்கள்.
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 க்கு எளிதாகச் செலுத்தவும்:
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 பொருளின் மீது நேரடியாக கீழ்க்காணும் முறைமைகளை அழைக்கக் செய்து அமைக்கப்படலாம்.
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பதிலாக எங்கள் தொகுப்பு லேசான PHP அடிப்படையாக உள்ள மினிப்பொருளைப் பயன்படுத்துகிறது. மினிப்பொருள் கருத்துக்களை நீக்குகிறது (வெளியீட்டுப் பொருள்களை தவிர), இடைவெளியை அழிக்கிறது, மற்றும் உருப்படிகளுக்கிடையில் இடைவெளிகளை நீக்குகிறது.
மஞ்சள்
எங்கள் தொகுப்பு இயல்பாக கீழ்க்காணும் மஞ்சல்களைப் பயன்படுத்துகிறது:
- ஓபன் சான்: 'https://fonts.googleapis.com/css?family=Open+Sans:300,400,500,700
- ட்ராயிட் சான்: 'https://fonts.googleapis.com/css?family=Droid+Sans:300,400,500,700
- லாட்டோ: https://fonts.googleapis.com/css?family=Lato:300,400,500,700
- ரொபோட்டோ: https://fonts.googleapis.com/css?family=Roboto:300,400,500,700
- உபுண்டு: 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 ஐப் பயன்படுத்த வேண்டும். எங்கள் தொகுப்பின் மற்ற கட்டமைப்பு விருப்பங்களுடன் ஒத்துமொத்தத்தைப் பேணி, இந்த தேர்வுகளை எங்கள் தொகுப்பில் இயற்கை அமைப்பிற்கு மாற்றலாம்.
நீங்கள் கீழ்க்காணும் முறைமைகள் மூலம் எந்த பின்வரிசையையும் மீறலாம்:
setBeautifyOptions(array $options)-js-beautifyவிருப்பங்களை அமைக்கவும்.addBeautifyOption(string $option, mixed $value)-js-beautifyவிருப்பம் சேர்க்கவும்.removeBeautifyOption(string $option)-js-beautifyவிருப்பத்தை அகற்றவும்.
மினிபெயர்க்கவும்
எங்கள் தொகுப்பு மினிபெயர்க்கப்படும்போது HTML output ஐ மினிபெயர்க்க உதவும். மினிபெயர்ப்பு பின்வருமாறு செயல்படுகிறது:
- HTML கருத்துக்களை அகற்றுகிறது (Outlook குறிக்கும் கருத்துக்களைப் பாதுகாக்கிறது, உதாரணமாக
<!--[if mso]>) - உருப்படிகள் இடையிலான பிற நிலைகளைக் கொண்டது
- HTML குறியீடுகளுக்கு இடைவெளியை அகற்றுகிறது
நீங்கள் minify(bool $minify) முறைமையை அழைக்காமல் அல்லது ஆகையால் மினிப்பொருட்காண்க.
ஏன் PHP அடிப்படையிலான மினிப்பொருள்? அதிகாரப்பூர்வ MJML தொகுப்பு மினியாக்கத்திற்காக
html-minifierஐப் பயன்படுத்துகிறது, இது பரந்த ReDoS பாதுகாப்பு உள்ளமைப்பு (CVE-2022-37620) போல நடைமுறையில் பழுதில்லாமல் உள்ளது. அதில் ஒருசெயல்முறைபாட்டுப்போது உறுப்பியார்களுக்கு மறுச்சரித்களைத் தவிர்க்க, PHP க்கு மினிப்பொருள் வழங்கலைச் நகர்த்தினோம் அடிப்படையில் என்று பயன்படுத்திய பாதுகாப்பான செயல்முறை.
சரிபார்ப்பு நிலை
எங்கள் தொகுப்பு இயல்பாக 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. சமூகப் பூல் கோரிக்கைகள்
நீங்கள் ஒரு பிழையை அடையாளம் கண்டு அதை தீர்க்க ஒரு தீர்வு உருவாக்கினால், தயவுசெய்து ஒரு பூல் கோரிக்கையை சமர்ப்பிக்கவும். எமது தயாரிப்புகளை பாதிக்கும் கேள்விகளுக்கு பிறகு, நாங்கள் இந்த சமூக-வழி தீர்வுகளை அடுத்த மேலான முன்னுரிமை அளிக்கிறோம். மதிப்பீடு செய்யப்பட்டு ஒப்புதல் பெற்றவுடன், உங்கள் தீர்வை ஒருங்கிணைப்போம் மற்றும் உங்கள் பங்களிப்புக்கு credits அளிக்கிறோம்.
3. நிதி ஆதரவு
மேற்கொள்ளாத பிரச்சினைகள் வரையறுக்கப்பட்ட வகைகளுக்கு கவனமாக, நீங்கள் அதன் தீர்வுக்கு நிதி உதவியை தேர்வு செய்யலாம். ஒவ்வொரு திறந்த கேள்விக்கும் நீங்கள் நிதி உதவி செய்யலாம். நாங்கள் வழங்கப்பட்ட நிதி அளவூடங்கை அடிப்படையாகக் கொண்டு இந்த பிரச்சினைகளை முன்னுரிமையளிக்கிறோம்.
சமுதாய பங்களிப்புகள்
திறந்த மூல செயல்திறனான பேனையில் அதன் சமுதாயம் செயலில் இருக்க wanneerானபோது வளமாகிறது. நீங்கள் பிழைகளை சரிசெய்யவில்லை எனினும், குறியீட்டு மேம்பாடுகள், ஆவணங்களில் புதுப்பிப்புகள், பயிற்சிகள் அல்லது சமுதாயச் चैनல்களில் மற்றவர்களை ஆதரவளிக்க உதவுவதன் மூலம் பங்களிப்பை சார்ந்துகொள்ள உங்கள் எண்ணங்களை மதியுங்கள். ஐந்தில் நாங்கள் அனைவரையும், சமூகமாக, திறந்த மூல வேலைக்கு அனைத்து அளவிதான் ஆதரிக்கச் சேற்படுத்துகிறோம்.
மீளவேண்டும் என்றால், DefectiveCode எமது கட்டணம் முறையூடான தயாரிப்புகளை பாதிக்கும் பிழைகள், சமூகப் பூல் கோரிக்கைகள் மற்றும் அந்த பிரச்சினைகளுக்கு பெறப்பட்ட நிதி ஆதரவுக்கே முன்பீற்ற அளிக்கும்.
உரிமம் - MIT உரிமம்
காப்புரிமை © Defective Code, LLC. அனைத்து உரிமைகளும் பாதுகாக்கப்பட்டவை
இந்த மென்பொருளுக்கும் அதற்கு உடைய ஆவணக் கோப்புகளுக்கும் (இது "மென்பொருள்") ஒரு நகலைப் பெறும் எந்த நபர்க்கும், கட்டுக்கோப்புகள் இல்லாமல், மென்பொருளில் முகாமை செய்ய அனுமதிக்கப்படுகிறது, இதில் செயல்பாட்டின் உரிமைகள், நகலெடுக்கவும், மாற்றவும், இணைக்கவும், வெளியிடவும், பகிர்வு உரிமம் வழங்கவும் மற்றும்/அல்லது மென்பொருளின் நகல்களை விற்கவும், மற்றும் மென்பொருளின் நகல்களைப் பெறும் நபர்களுக்கு இதைப் செய்ய அனுமதிக்கவும், கீழ்க்காணும் நிலைகளை பின்பற்றுவதற்குப் பண்படுத்தப்படுகிறது:
மேலே குறிப்பிடப்பட்ட காப்புரிமை அறிவிப்பு மற்றும் இந்த அனுமதி அறிவிப்பு அனைத்துப் பிரதிகள் அல்லது முக்கியப் பகுதிகளிலும் உள்ளடக்கப்பட வேண்டும்.
மென்பொருள் "தொலைவிலிருந்து" வழங்கப்படுகிறது, எந்தப் பாலம்ஸ், நடைமுறைகளிலும் ஏதாவது வாக்குறுதி அல்லது குறிப்பிடப்பட்டுள்ளது, ஆனால் வரம்பற்ற வகையில் விற்பனைதிறன், குறிப்பிட்ட ஒரு நோக்கத்திற்கான வசதி மற்றும் உரிமை மீறல் ஆகியவற்றுக்கான வாக்குறுதிகள். எந்த சந்தர்ப்பத்திலும் ஆசிரியர்கள் அல்லது காப்புரிமையாளர்கள் எந்த உரிமையைக் கொண்டாட முடியாது, எந்தக் குற்றத்தை, சேதப்படுத்தல்களை அல்லது பிற பொறுப்புகளை அட/thread-modal/ம், ஒப்பந்தத்தின் ஒரு நடவடிக்கையின்படி, ஆபத்து அல்லது வேறென்னவாக இருந்தாலும், மென்பொருள் அல்லது மென்பொருளைப் பயன்படுத்துவதில் இருந்ததாகவும் உள்ள தேவை/request-modal/ியைக் கொண்டாட முடியாது.