Zināšanu bāze

Veidnes

Pamatteksts, kas uzrakstīts vienreiz, ar versijām, un nosūtīts daudzkārt: no rakstīšanas loga, no jūsu paša koda vai ar aģenta starpniecību.

Detaļas

Veidne pieder savienojumam, nevis cilvēkam, kurš to uzrakstīja, un tieši tāpēc pirmā šīs funkcijas versija tika aizstāta. Tā bija piesaistīta lietotājam: kolēģa veidne darbvietas API atslēgai nebija redzama, tāpēc integrācija nevarēja nosūtīt to, ko redzēja cilvēks, kurš to iestatīja, un autora konta dzēšana paņēma līdzi arī darbvietas veidnes. Ieraksti tika pārnesti, nevis nomesti.
Divi veidi, kā izveidot pamattekstu. Bloku koks virs @react-email/components komponentēm (Section, Row, Column, Container, Text, Heading, Button, Link, Img, Hr, Markdown, CodeBlock, CodeInline), ko pārbauda jau rakstīšanas laikā, tāpēc slikts mezgls vai nedrošs href tiek noraidīts tajā pašā izsaukumā, kas to ierakstīja, nevis nonāk pie saņēmēja kā salauzta vēstule. Vai arī pašu atveidots marķējums: ja jūsu veidnes jau ir react-email komponentes jūsu paša repozitorijā, atveidojiet tās tur ar @react-email/render un nosūtiet HTML, ko vienreiz attīra brīdī, kad versija tiek publicēta.
Divdesmit trīs sākumpunkti un viens tukšs, izkārtoti galerijā, nevis izvēlnē, jo tās ir lietas, kas pirms izvēles ir jāapskata, tāpēc katrā kartītē ir redzama pati vēstule. Sveiciens un apstiprināšana, čeki un rēķini, sūtījumi un atjaunojumi, apkopojumi un paziņojumi — sakārtoti zem četriem virsrakstiem, un katrs no tiem atveras vizuālajā redaktorā, kur katru daļu var pārvietot, pārveidot un izdzēst. Lai kuru jūs izvēlētos, tas nonāk pie jums kā melnraksts, tāpēc neko nevar nosūtīt, kamēr to neesat publicējis.
Galerija ir vienīgā šīs funkcijas daļa, kas pieejama tikai lietotnē. Izsaucējs, kas veidnēm piekļūst no jūsu paša koda vai no aģenta, nosūta pamattekstu (bloku dokumentu vai jūsu paša marķējumu), nevis nosauc sākumpunktu, tāpēc šīs divdesmit trīs ir vieta, kur sākt, nevis katalogs, no kura kaut ko instalēt.
Nosauktie sloti un nosauktie props ir divu veidu caurumi, ko pamattekstā un tematā raksta kā {{key}}. Slotu aizpilda tas, kurš rediģē veidni, un tam ir noklusējuma vērtība, tāpēc sūtījums, kas nenosauc neko, joprojām tiek atveidots. Prop tiek padots sūtīšanas brīdī, un tāds, kas atzīmēts kā obligāts, noraida sūtījumu, ja tā nav: 422, un neviena vēstule neaiziet. Tieši šī noraidīšana ir iemesls, kāpēc to deklarēt: alternatīva ir ziņojums, kas aiziet ar tukšumu tur, kur vajadzēja būt pasūtījuma numuram, par ko nekas neziņo un ko neviens nevar atsaukt.
Publicēta versija ir iesaldēta. Publicētas veidnes pamatteksta rediģēšana izveido jaunu melnrakstu, nevis pārraksta to, kas ir dzīvē, tāpēc sūtījumi turpina izmantot to pašu, ko izmantoja vakar, līdz kāds publicē, un sūtījums, kas piesaista konkrētu versijas numuru, netiek ietekmēts arī tad. Pamatteksts tiek kompilēts publicēšanas brīdī, un tieši tāpēc veidne, kas neatveidojas, neizdodas tam, kurš to publicē, nevis saņēmējam.
Priekšskatījums atveido tieši to, ko radītu sūtījums, to nenosūtot, un ziņo, kas vēl ir tukšs, tā vietā, lai noraidītu. Veidne, kuru priekšskata, parasti ir veidne, kuru raksta, un autoram, kas aizpilda vienu bloku pēc otra, nevajadzētu apmierināt katru prop, lai redzētu, kas līdz šim ir paveikts.
Katrai veidnei ir savs ieraksts par to, ko tā ir nosūtījusi: cik daudz aizgāja pēdējo septiņu, trīsdesmit vai deviņdesmit dienu laikā, kuras no tām tika atvērtas un kurās tika klikšķināts, sadalījums pa dienām un sadalījums pēc tā, no kurienes katrs sūtījums nāca: no rakstīšanas loga, no jūsu koda, no aģenta vai no rindas. Katrs rādītājs nosauc savu saucēju, nevis aizņemas kādu citu, jo tie patiešām ir atšķirīgi: atvērumus skaita pēc ziņojumiem, kuros bija pikselis, klikšķus — pēc ziņojumiem, kuros bija pārrakstīta saite, un ziņojumā var būt viens bez otra. Priekšskatījumu neieraksta nemaz, bet testa sūtījumu skaita atsevišķi un neiekļauj nevienā skaitlī, jo tas nekad nav aizgājis.
Šis ieraksts ir godīgs par to, ko tas neredz, un tieši tāpēc var uzticēties tai pusei, ko tas redz. Sūtījumu ar tā piegādes ierakstu sasaista pats sūtījums, un tāds ir tikai pastam, kas nosūtīts no jūsu paša koda vai no rindas. Ziņojumam, kas nosūtīts no rakstīšanas loga, no aģenta vai no asistenta, tāda nav. Tāpēc veidne, ko galvenokārt izmanto no rakstīšanas loga, nonāk ar lielāko daļu sūtījumu bez sasaistes, un šo nesasaistīto skaitu rāda kā atsevišķu skaitli, nevis ieskaita kā “neviens to neatvēra”.
Četras virsmas virs viena pakalpojuma, tāpēc jautājumam “ko nozīmē publicēt” ir viena atbilde, nevis trīs, kas šodien sakrīt. Rakstīšanas loga poga Veidnes piedāvā publicētās un AIZSTĀJ ziņojumu ar to, ko izvēlaties, nevis ielīmē to iekšā: sūtījums nosauc veidni, versija tiek piesaistīta brīdī, kad to izvēlaties, un pamatteksts tiek atveidots tur, kur tas tika izveidots, tāpēc publicēšana starp izvēli un klikšķi nevar mainīt to, kas aiziet, un izkārtojums, ko rakstīšanas logs nebūtu spējis noturēt, saglabājas neskarts. Tur jūs aizpildāt vērtības, nevis pamattekstu. /templates ir deviņi galapunkti aiz templates:read un templates:write tvērumiem, ko SDK aptver metodi pa metodei. Lai nosūtītu, papildus veidnes atļaujai vajadzīga arī sūtīšanas atļauja, tāpēc atslēga, kas izsniegta tekstu rakstīšanas rīkam, var veidot un publicēt, bet nevar nevienam nosūtīt pastu. MCP serverī ir pieci rīki: saraksts, lasīšana, priekšskatījums, izveide un sūtīšana. Apzināti nav rīka, ar ko atjaunināt, dzēst vai publicēt jau esošu. Rediģējums izveido melnrakstu, uz kuru nākamais sūtījums neattiektos, un dzēšanu nevar atsaukt. Saglabāta pamatteksta rediģēšana ir ekrāns: /workspace/templates satur bloku audeklu ar paleti un inspektoru, blakus dzīvu priekšskatījumu, un Saglabāt un Publicēt kā atsevišķas darbības — tieši tas padara publicētu versiju par kaut ko, ko var atstāt mierā, kamēr strādājat pie nākamās.
200 veidnes uz vienu savienojumu, bloku dokuments ar ierobežojumu 500 bloki, astoņi ligzdošanas līmeņi, 20 000 rakstzīmju vienā vērtībā, kā arī 100 sloti un 100 props; kā marķējums nosūtīts pamatteksts ir ierobežots ar miljonu rakstzīmju, bet temats — ar 998. Katrs no tiem ir aizsardzība pret izkūlušos skriptu, nevis plāna ierobežojums, katrs noraida ar ziņojumu, kurā nosaukts skaitlis, uz kura tas noraidīja, un nekas no veidnēm nav aiz kāda plāna līmeņa.