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

• Onyo wa Tafsiri
• Utangulizi
  • Mfano
• Usanidi
• Matumizi (Bila Laravel)
  • Kurejesha MJML
  • Kuthibitisha MJML
• Matumizi (Na Laravel)
  • Kurejesha MJML
  • Kuthibitisha MJML
  • Usanidi
• Configuration
  • Fonts
  • Maoni
  • Puuza Pamoja
  • Pendeza
  • Punguza
  • Ngazi ya Uhakiki
  • Njia ya Faili
  • Juice
• Mwongozo wa Msaada
  • Msaada Unaotolewa na Jumuiya
  • Mende na Uthamini wa Vipengele
• Leseni - Leseni ya MIT

🔗Onyo wa Tafsiri

Hati hii imefasiriwa kiotomatiki. Ikiwa kuna makosa ya tafsiri tafadhali fungua ombi la kuvuta kwenye mradi na ongeza faili iliyotafsiriwa kwa docs/{ISO 639-1 Code}.md.

🔗Utangulizi

MJML ni lugha ya alama iliyoundwa mahsusi ili kurahisisha mchakato wa kuandika barua pepe zinazoweza kurekebishwa. Muundo wake wa sintaksia una uhakikisho wa urahisi na urahisi, wakati maktaba yake kubwa ya vipengele vya kawaida inaongeza kasi maendeleo na kupunguza ugumu wa msingi wa barua pepe yako. Injini ya wazi ya MJML inazalisha HTML inayoweza kurekebishwa na ubora wa hali ya juu, ambayo inazingatia mazoea bora. Ikiwa umepata changamoto za kufanya kazi na Outlook, hii kifurushi imeundwa mahsusi kwa ajili yako.

Utekelezaji wetu wa MJML unatumika kama kifuniko kwa API rasmi ya MJML. Inawezesha uandishi rahisi wa MJML ndani ya HTML moja kwa moja ndani ya PHP, bila hitaji la NodeJS. Kifurushi hiki ni bora kwa programu za PHP ambazo zinataka kuingiza MJML bila usumbufu wa kusakinisha NodeJS na MJML CLI.

🔗Mfano

// Bila Laravel
(new MJML)->render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);
 
// HTML iliyopunguzwa
(new MJML)->minify()->render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);
 
// Pamoja na Laravel
MJML::render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);
 
// Pamoja na Laravel na HTML iliyopunguzwa
MJML::minify()->render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'
);

🔗Usanidi

1. Kwanza ongeza yafuatayo kwenye faili yako ya composer.json ili kuagiza pakiti yetu kupakua binaries sahihi kwa mfumo wako wa uendeshaji wakati pakiti yetu inasakinishwa. Binaries zitapakuliwa baada ya kukimbia install, update, au dump-autoload.

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

   Binary ya MJML itapokelewa kutoka kwenye CDN yetu na kuokolewa kwenye folda ya "bin" ya pakiti hii wakati wa usakinishaji au sasisho la composer. Hakikisha una binaries muhimu zilizopakia kwa mazingira yako ya ndani na uzalishaji.

   Kwa chaguo-msingi, all itapakua binaries zote tunazounga mkono. Tunapendekeza kupunguza wigo huu kwa mifumo ya uendeshaji na usanifu unayohitaji ili kuokoa upana wa bandari na wakati wa usakinishaji. Hizi ni binaries zinazopatikana.

   Mfumo wa Uendeshaji	Usanifu	Amri ya Baada ya Sasisho ya Composer
   Wote	Wote	DefectiveCode\MJML\PullBinary::all
   Darwin (MacOS)	arm64	DefectiveCode\MJML\PullBinary::darwin-arm64
   Darwin (MacOS)	x64	DefectiveCode\MJML\PullBinary::darwin-x64
   Linux	arm64	DefectiveCode\MJML\PullBinary::linux-arm64
   Linux	x64	DefectiveCode\MJML\PullBinary::linux-x64

2. Kisha, sakinisha pakiti ya PHP kwa kukimbia amri ifuatayo ya composer:

   composer require defectivecode/mjml

3. Hiyo ndiyo yote! Ikiwa unatumia Laravel, pakiti yetu itasakinishwa moja kwa moja kwa kutumia ugunduzi wa pakiti ya Laravel.

🔗Matumizi (Bila Laravel)

Angalia matumizi na Laravel hapo chini ikiwa unatumia Laravel.

🔗Kurejesha MJML

Ili kurejesha MJML, tupe tu neno lako la MJML kwa njia ya render:

tumia DefectiveCode\MJML;
 
$html = (new MJML)->render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Habari Dunia</mj-text></mj-column></mj-section></mj-body></mjml>'
);

🔗Kuthibitisha MJML

Ili kuthibitisha MJML, tupe tu neno lako la MJML kwa njia ya isValid:

tumia DefectiveCode\MJML;
 
$isValid = (new MJML)->isValid(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Habari Dunia</mj-text></mj-column></mj-section></mj-body></mjml>'
);

🔗Matumizi (Na Laravel)

🔗Kurejesha MJML

Ili kurejesha MJML, tupe tu neno lako la MJML kwa render kwenye MJML facade:

tumia DefectiveCode\MJML\Facades\MJML;
 
$html = MJML::render(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Habari Dunia</mj-text></mj-column></mj-section></mj-body></mjml>'
);

🔗Kuthibitisha MJML

Ili kuthibitisha MJML, tupe tu neno lako la MJML kwa njia ya isValid kwenye MJML facade:

tumia DefectiveCode\MJML\Facades\MJML;
 
$isValid = MJML::isValid(
    '<mjml><mj-body><mj-section><mj-column><mj-text>Habari Dunia</mj-text></mj-column></mj-section></mj-body></mjml>'
);

🔗Usanidi

Unaweza kuchapisha faili ya usanidi kwa kutumia amri ifuatayo:

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

Hii itaunda faili ya usanidi ya mjml.php katika folda yako ya config. Chaguo zote zilizoorodheshwa katika faili ya usanidi zimepita kwa kitu cha config unapotumia MJML facade.

🔗Configuration

Chaguo zote za usanidi zinaweza kuwekwa kwa kuita njia zifuatazo moja kwa moja kwenye kifaa cha MJML.

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

Kifurushi chetu kinafuata [usanidi sawa] (https://github.com/mjmlio/mjml/tree/master) kama kifurushi rasmi cha MJML isipokuwa kwa zifuatazo:

• preprocessors - Chaguo hili halipatikani. Tafadhali fungua ombi la kuvuta ikiwa ungependa kuongeza chaguo hili.
• minifyOptions - Tunatumia html-minifier-terser wakati kifurushi rasmi kinatumia html-minifier kwa minification. Tumeamua kubadili processor kwa sababu html-minifer haifanyi kazi tena na ina maswala kadhaa ya usalama yanayohusiana nayo.

🔗Fonts

Kifurushi chetu kinatumia fonts zifuatazo kwa chaguo-msingi:

• 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

Unaweza kubadilisha fonts kwa kutumia njia zifuatazo:

• addFont (herufi ya herufi, url ya herufi) - Ongeza font kwenye orodha ya fonts.
• removeFont (herufi ya herufi) - Ondoa font kutoka kwenye orodha ya fonts.
• setFonts (array $ fonts) - Weka orodha ya fonts. Unapaswa kutoa safu ya fonts katika muundo huu: ['jina la font' => 'url ya font'].

🔗Maoni

Maoni yanabaki kwa chaguo-msingi. Ikiwa unataka kuondoa maoni, unaweza kutumia njia ya removeComments ().

Unaweza pia kurejesha removeComments () kwa kuita njia ya keepComments ().

🔗Puuza Pamoja

Kwa chaguo-msingi, kifurushi chetu kitajumuisha vitambulisho vyovyote vya [mj-include] (https://documentation.mjml.io/#mj-include). Unaweza kurekebisha tabia hii kwa kuita njia ya ignoreIncludes (bool $ ignore).

🔗Pendeza

Kifurushi chetu kitapendezesha HTML kwa kutumia [js-beautify] (https://www.npmjs.com/package/js-beautify) na chaguo-msingi zifuatazo:

• ukubwa wa kuingiza: 2
• wrapAttributesIndentSize: 2
• maxPreserveNewline: 0
• kuweka safu mpya: uwongo

Wakati js-beautify inatumia snake_case kutoa chaguzi, unapaswa kutumia camelCase unapotumia kifurushi chetu. Tumefanya uchaguzi huu kuweka kifurushi chetu thabiti na chaguzi zingine za usanidi. Kifurushi chetu kitaendelea badilisha moja kwa moja chaguzi za camelCase kuwa snake_case.

Unaweza kubadilisha chaguo lolote la haya kwa kutoa usanidi sahihi wa js-beautify kwa kutumia njia zifuatazo:

• setBeautifyOptions (array $ options) - Weka chaguzi za js-beautify.
• addBeautifyOption (chaguo cha herufi, thamani iliyochanganywa) - Ongeza chaguo la js-beautify.
• removeBeautifyOption (chaguo cha herufi) - Ondoa chaguo la js-beautify.

🔗Punguza

Kifurushi chetu kitapunguza HTML kwa kutumia [html-minifier-terser] (https://www.npmjs.com/package/html-minifier-terser) na chaguo-msingi zifuatazo:

• collapseWhitespace: kweli
• minifyCSS: uwongo
• caseSensitive: kweli
• ondoa sifa tupu: kweli

Unaweza kubadilisha chaguo lolote la haya kwa kutoa usanidi sahihi wa [html-minifier-terser] (https://www.npmjs.com/package/html-minifier-terser) kwa kutumia njia zifuatazo:

• setMinifyOptions (array $ options) - Weka chaguzi za html-minifier-terser.
• addMinifyOption (chaguo cha herufi, thamani iliyochanganywa) - Ongeza chaguo la html-minifier-terser.
• removeMinifyOption (chaguo cha herufi) - Ondoa chaguo la html-minifier-terser.

🔗Ngazi ya Uhakiki

Kifurushi chetu kitahakiki MJML kwa kutumia ngazi ya uhakiki ya soft kwa chaguo-msingi. Unaweza kubadilisha hii kwa kutumia njia ya validationLevel (ValidationLevel $ validationLevel). Ngazi za uhakiki zifuatazo zinapatikana:

• strict - Hati yako inapitia uhakiki na haionyeshwi ikiwa ina kosa lolote
• soft - Hati yako inapitia uhakiki na inaonyeshwa, hata ikiwa ina makosa
• kipu - Hati yako inaonyeshwa bila kupitia uhakiki.

🔗Njia ya Faili

Kifurushi chetu kitatumia saraka ya . kwa chaguo-msingi. Unaweza kubadilisha hii kwa kuita njia ya filePath (string $ path).

🔗Juice

Hatutoi chaguo yoyote ya [juice] (https://www.npmjs.com/package/juice) kwa chaguo-msingi. Unaweza kuongeza chaguo za juice kwa kutumia njia zifuatazo:

• setJuiceOptions (array $ options) - Weka chaguzi za juice.
• addJuiceOption (chaguo cha herufi, thamani iliyochanganywa) - Ongeza chaguo la juice.
• removeJuiceOption (chaguo cha herufi) - Ondoa chaguo la juice.
• setJuicePreserveTags (array $ tags) - Weka vitambulisho vya kuhifadhi juice.
• addJuicePreserveTag (chaguo cha herufi, thamani iliyochanganywa) - Ongeza vitambulisho vya kuhifadhi juice.
• removeJuicePreserveTag (chaguo cha herufi) - Ondoa vitambulisho vya kuhifadhi juice.

🔗Mwongozo wa Msaada

Asante kwa kuchagua pakiti yetu ya chanzo wazi! Tafadhali chukua muda wa kusoma mwongozo huu wa msaada. Utakusaidia kupata faida zaidi kutoka kwa mradi wetu.

🔗Msaada Unaotolewa na Jumuiya

Mradi wetu wa chanzo wazi unategemea jumuiya yetu nzuri. Ikiwa una maswali au unahitaji msaada, StackOverflow na rasilimali zingine za mtandaoni ndizo chaguo bora zaidi.

🔗Mende na Uthamini wa Vipengele

Uhalisia wa kusimamia mradi wa chanzo wazi una maana hatuwezi kushughulikia kila mende iliyoripotiwa au ombi la kipengele mara moja. Tunapanga masuala kwa utaratibu ufuatao:

1. Mende Zinazoathiri Bidhaa Zetu za Kulipia

Mende ambazo zinaathiri bidhaa zetu za kulipia daima zitakuwa kipaumbele chetu cha juu. Katika baadhi ya kesi, tunaweza kushughulikia mende ambazo zinaathiri sisi moja kwa moja.

2. Maombi ya Jumuiya ya Kuchangia

Ikiwa umetambua mende na una suluhisho, tafadhali wasilisha ombi la kuchangia. Baada ya masuala yanayoathiri bidhaa zetu, tunatoa kipaumbele cha juu kwa marekebisho haya yaliyotolewa na jumuiya. Baada ya ukaguzi na idhini, tutaunganisha suluhisho lako na kukiri mchango wako.

3. Msaada wa Fedha

Kwa masuala yaliyo nje ya makundi yaliyotajwa, unaweza kuchagua kuchangia kifedha kwa ajili ya ufumbuzi wao. Kila suala wazi linaunganishwa na fomu ya agizo ambapo unaweza kuchangia kifedha. Tunapanga masuala haya kwa kuzingatia kiasi cha fedha kilichotolewa.

Michango ya Jumuiya

Chanzo wazi kinakua wakati jumuiya yake inakuwa hai. Hata kama huwezi kusahihisha mende, tafadhali fikiria kuchangia kupitia marekebisho ya nambari, sasisho za nyaraka, mafunzo, au kwa kusaidia wengine katika njia za jumuiya. Tunahimiza sana kila mtu, kama jumuiya, kusaidia kazi ya chanzo wazi.

Kwa kusisitiza, DefectiveCode itapanga mende kulingana na jinsi zinavyoathiri bidhaa zetu za kulipia, maombi ya jumuiya ya kuchangia, na msaada wa kifedha uliopokelewa kwa masuala.

🔗Leseni - Leseni ya MIT

Haki miliki © Defective Code, LLC. Haki zote zimehifadhiwa.

Hapa kwa hii programu na faili zake zinazohusiana (pamoja na "Programu"), ruhusa inatolewa bure kwa mtu yeyote anayepata nakala ya programu hii na faili za nyaraka zake (pamoja na "Programu"), kushughulika na Programu bila kizuizi, pamoja na bila kikomo haki za kutumia, kunakili, kurekebisha, kuunganisha, kuchapisha, kusambaza, kutoa leseni, na / au kuuza nakala za Programu, na kuruhusu watu ambao Programu imetolewa kufanya hivyo, chini ya masharti yafuatayo:

Hati ya haki miliki hapo juu na hati hii ya ruhusa lazima iwe pamoja na nakala zote au sehemu kubwa ya Programu.

PROGRAMU IMETOLEWA "KAMA ILIVYO", BILA DHAMANA YA AINA YOYOTE, IMESEMA AU IMEIMARISHWA, IKIWA NI PAMOJA NA LAKINI HAIJAZUIWA KWA DHAHABU ZA KUUZWA, KWA MADHUMUNI YA KIUCHUMI, KWA KUFANYA KAZI KWA MADHUMUNI FULANI NA KWA KUFANYA KAZI BILA KUKUFA, KUTOKA KWA AU KATIKA UHUSIANO NA PROGRAMU AU MATUMIZI AU MATUMIZI MENGINE YA PROGRAMU.