Alstre
Išbandyti
08 · Dokumentų šablonai

Šablono kodo redagavimas

Išeitinio kodo rodinys nestandartiniams dokumentams: savi stiliai, išdėstymai ir skyriai, kurių nėra tarp blokų. Rašome, kada iš tiesų verta juo naudotis ir ką riboja spausdinimo variklis.

Kur tai įjungti

Virš redagavimo lauko yra perjungiklis Vizualiai / HTML. Pirmasis variantas rodo dokumentą tokį, koks jis atrodo; antrasis – jo išeitinį kodą.

Tai ne tas pats kaip išplėstinis režimas
Perjungiklis Pagrindinis / Išplėstinis lemia ką kita: ar be blokų galima įterpti kintamuosius. Išeitinį kodą atveria tik čia aprašytas perjungiklis HTML.

Vizualiame rodinyje blokai ir kintamieji matomi kaip įterpti elementai – formuojant spaudinį jie bus užpildyti turiniu.

Kada verta

Rečiau, nei atrodo. Prieš imdamiesi kodo, patikrinkite, ar reikiamo elemento dar nėra blokų bibliotekoje: blokai prižiūrimi kartu su sistema ir patys neatsilieka nuo sutarties pakeitimų.

Kodas prasmingas trimis atvejais:

  • Atitiktis prekės ženklo knygai – konkrečios spalvos, tarpai ir šriftai, kurių nenustatysite perjungikliais.
  • Skyrius, kurio nėra tarp blokų – pavyzdžiui, savos prekybos sąlygos arba parduotuvės taisyklės.
  • Išdėstymo pataisa – stulpelių plotis pozicijų lentelėje, tarpai prieš parašus, priverstinis puslapio lūžis.

Ką galima padaryti kode

  • Stiliai, užrašyti tiesiai elemente, pavyzdžiui, <div style="color:#005bbb">
  • Lentelės struktūros, spalvų ir tarpų keitimas
  • Savi skyriai ir pastraipos už blokų ribų
  • Kintamieji bet kurioje vietoje, pavyzdžiui, {{customer_name}}
  • Blokai kaip tušti žymenys <div data-block="..."> – turinys įrašomas spausdinant
Sąlygos nerašomos ranka
Nuo pirkėjo rūšies priklausantis fragmentas įterpiamas sąlyginiu bloku – ir šiame režime. Įrašas, pavyzdžiui, {{#if}}, neveiks: jis bus išspausdintas pažodžiui, kartu su skliaustais.

Ko nepadarys spausdinimo variklis

Šablonas patenka į naršyklę, kuri sugeneruoja PDF, todėl stiliai elgiasi taip pat kaip tinklalapyje. Vis dėlto keturi dalykai veikia kitaip:

Be JavaScript
Dokumentas statiškas. Niekas neperskaičiuojama ir neanimuojama.
Stiliai tik viduje
Iš išorinių adresų įkeliami stilių failai gali neįsikelti. Viską užrašykite elementuose arba stilių bloke šablono tekste.
Paveikslėliai su visu adresu
Grafika turi turėti visą adresą arba būti iš failų, įkeltų įmonės nustatymuose. Santykinis kelias neveiks.
Puslapių lūžiai
Jie valdomi per page-break-before: always ir page-break-inside: avoid. Antrąjį verta taikyti pozicijų lentelei, kad eilutė nesuskiltų tarp puslapių.

Dokumentas spausdinamas A4 formatu, išlaikant fono spalvas. Antraštė ir poraštė – atskiros šablono dalys; variklis pats apskaičiuoja joms paraštę, todėl jos spėlioti nereikia.

Kaip dirbti saugiai

  • Po kiekvieno pakeitimo tikrinkite peržiūrą. Vienas neuždarytas žymuo gali išardyti visą tolesnę dokumento dalį.
  • Peržiūrėkite abu scenarijus – privatų asmenį ir įmonę.
  • Bandomai išspausdinkite į PDF. Peržiūra ekrane nerodo skaidymo į puslapius.
  • Keitimus darykite šablono kopijoje. Naujas šablonas iš to paties atspirties taško užtrunka akimirką, bet leidžia grįžti prie veikusios versijos.
Vienas šablonas kode, kiti – iš blokų
Ranka redaguojamas šablonas nebegauna patobulinimų, kuriuos diegiame blokuose. Kode verta laikyti tik tą dokumentą, kuriam to tikrai reikia, o kitus palikti blokams.