ვებსაიტი არის სტატიკურად გენერირებული 11ty-ის დახმარებით.
თუ გსურთ წიგნში რაიმე ხარვეზების ჩასწორება ან ახალი თავების დამატება, შეგიძლიათ
დაფორკოთ ეს რეპოზიტორია და გამოგზავნოთ pull request-ები. თქვენი სახელი
და ლინკი (სურვილისამებრ) დაამატეთ კონტრიბუტორების სიაში (src/articles/misc/contributors.md).
თითოეულ თავს გააჩნია თავისი ფოლდერი src/articles-ში, სადაც შესაძლებელია ფაილების ქვეთავებად განაწილება.
რათა ახალი სტატიები სარჩევში გამოჩნდეს, საჭიროა მისი სათანადო ფაილების მისამართების მითითება
src/includes/partials/summary.md-ში (.html დაბოლოებებით, .md-ს მაგივრად).
გაითვალისწინეთ, რომ პროექტი იყენებს PNPM-ს პაკეტების მენეჯმენტისთვის და არა NPM-ს.
დიაგრამებისთვის ```mermaid ბლოკს ვიყენებთ. ის ბილდის დროს SVG-დ
რენდერება (util/mermaid.js), ანუ mermaid-ის ბიბლიოთეკა ბრაუზერში არ
იტვირთება და დიაგრამები მუშაობს ჯავასკრიპტის გარეშეც და ბეჭდვისასაც.
თითოეული დიაგრამა ორჯერ რენდერება — ბნელი და ნათელი თემისთვის — და გვერდზე ორივე ვარიანტი ხვდება; საიტი შესაბამის CSS აჩენს.
- დიაგრამის კოდში
themeანthemeVariablesარ მიუთითოთ (%%{init: ...}%%), თორემ ორივე ვარიანტი ერთნაირი გამოვა. ფერებიsrc/styles/tokens.css-იდან მოდის ავტომატურად. - თუ დიაგრამის სინტაქსი მცდარია, ბილდი ჩავარდება და ხარვეზიან ფაილზე მიგვითითებს.
დარენდერებული SVG-ები diagrams/ ფოლდერშია და რეპოზიტორიაშივე ინახება.
ეს აუცილებელია: საიტი Cloudflare-ზე ბილდდება, სადაც Chromium არ არსებობს,
ანუ დეპლოის ბილდს დიაგრამის დახატვა არ შეუძლია — მხოლოდ უკვე დახატულის
გამოყენება.
pnpm run diagrams
პროექტის მხარდაჭერა შეგიძლიათ ფულადი შემოწირულობით.
This work is licensed under a Creative Commons Attribution 4.0 International License.
