Source

ააშენეთ ხელსაწყოები

შეიტყვეთ, თუ როგორ გამოიყენოთ Bootstrap-ის თანდართული npm სკრიპტები ჩვენი დოკუმენტაციის შესაქმნელად, წყაროს კოდის შედგენისთვის, ტესტების გასაშვებად და სხვა.

ხელსაწყოების დაყენება

Bootstrap იყენებს npm სკრიპტებს თავისი build სისტემისთვის. ჩვენი package.json მოიცავს ფრეიმვორთან მუშაობის მოსახერხებელ მეთოდებს, მათ შორის კოდის შედგენას, ტესტების გაშვებას და სხვა.

ჩვენი build სისტემის გამოსაყენებლად და ჩვენი დოკუმენტაციის ადგილობრივად გასაშვებად, დაგჭირდებათ Bootstrap-ის წყარო ფაილების და Node-ის ასლი. მიჰყევით ამ ნაბიჯებს და მზად უნდა იყოთ როკისთვის:

  1. ჩამოტვირთეთ და დააინსტალირეთ Node.js , რომელსაც ვიყენებთ ჩვენი დამოკიდებულებების სამართავად.
  2. გადადით root /bootstrapდირექტორიაში და npm installდააინსტალირეთ ჩვენი ადგილობრივი დამოკიდებულებები, რომლებიც ჩამოთვლილია package.json- ში .
  3. დააინსტალირეთ Ruby , დააინსტალირეთ Bundler ერთად gem install bundlerდა ბოლოს გაუშვით bundle install. ეს დააინსტალირებს რუბის ყველა დამოკიდებულებას, როგორიცაა ჯეკილი და დანამატები.

დასრულების შემდეგ, თქვენ შეძლებთ ბრძანების ხაზიდან მოწოდებული სხვადასხვა ბრძანებების გაშვებას.

npm სკრიპტების გამოყენება

ჩვენი package.json მოიცავს შემდეგ ბრძანებებს და დავალებებს:

დავალება აღწერა
npm run dist npm run distქმნის /dist/დირექტორიას კომპილირებული ფაილებით. იყენებს Sass , Autoprefixer და UglifyJS .
npm test იგივეა, რაც npm run distპლუს ის ატარებს ტესტებს ადგილობრივად
npm run docs აშენებს და ათავსებს CSS-ს და JavaScript-ს დოკუმენტებისთვის. შემდეგ შეგიძლიათ გაუშვათ დოკუმენტაცია ადგილობრივად npm run docs-serve.

გაუშვით npm runყველა npm სკრიპტის სანახავად.

ავტოპრეფიქსერი

Bootstrap იყენებს Autoprefixer-ს (ჩართულია ჩვენს შექმნის პროცესში), რათა ავტომატურად დაამატოს გამყიდველის პრეფიქსები ზოგიერთ CSS თვისებას აშენების დროს. ამით დაზოგავთ დროსა და კოდს, რაც საშუალებას გვაძლევს დავწეროთ ჩვენი CSS-ის ძირითადი ნაწილები ერთჯერადად, ამასთან ერთად აღმოვფხვრათ გამყიდველის მიქსების საჭიროება, როგორიცაა v3-ში.

ჩვენ ვინახავთ ბრაუზერების სიას, რომლებიც მხარდაჭერილია Autoprefixer-ის მეშვეობით, ცალკე ფაილში ჩვენს GitHub საცავში. იხილეთ .browserslistrc დეტალებისთვის.

ადგილობრივი დოკუმენტაცია

ჩვენი დოკუმენტაციის ლოკალურად გაშვება მოითხოვს Jekyll-ის გამოყენებას, ღირსეულად მოქნილი სტატიკური საიტის გენერატორის, რომელიც გვაწვდის: ძირითადი მოიცავს, Markdown-ზე დაფუძნებულ ფაილებს, შაბლონებს და სხვა. აი, როგორ უნდა დაიწყოთ:

  1. გაიარეთ ზემოთ მოყვანილი ხელსაწყოების დაყენება , რათა დააინსტალიროთ Jekyll (საიტის შემქმნელი) და სხვა Ruby დამოკიდებულებები bundle install.
  2. root /bootstrapდირექტორიადან, გაუშვით npm run docs-serveბრძანების სტრიქონში.
  3. გახსენით http://localhost:9001თქვენს ბრაუზერში და voilà.

შეიტყვეთ მეტი ჯეკილის გამოყენების შესახებ მისი დოკუმენტაციის წაკითხვით .

Დიაგნოსტიკა

თუ დამოკიდებულებების დაყენებისას პრობლემები შეგექმნათ, წაშალეთ დამოკიდებულების ყველა წინა ვერსია (გლობალური და ადგილობრივი). შემდეგ, ხელახლა გაუშვით npm install.