Κατασκευάστε εργαλεία
Μάθετε πώς να χρησιμοποιείτε τα σενάρια npm που περιλαμβάνονται στο Bootstrap για να δημιουργήσετε την τεκμηρίωσή μας, να μεταγλωττίσετε τον πηγαίο κώδικα, να εκτελέσετε δοκιμές και πολλά άλλα.
Το Bootstrap χρησιμοποιεί σενάρια NPM για το σύστημα κατασκευής του. Το package.json μας περιλαμβάνει βολικές μεθόδους για την εργασία με το πλαίσιο, συμπεριλαμβανομένης της μεταγλώττισης κώδικα, της εκτέλεσης δοκιμών και άλλων.
Για να χρησιμοποιήσετε το σύστημα κατασκευής μας και να εκτελέσετε την τεκμηρίωσή μας τοπικά, θα χρειαστείτε ένα αντίγραφο των αρχείων πηγής και του κόμβου του Bootstrap. Ακολουθήστε αυτά τα βήματα και θα πρέπει να είστε έτοιμοι να ροκάρετε:
- Κατεβάστε και εγκαταστήστε το Node.js , το οποίο χρησιμοποιούμε για να διαχειριστούμε τις εξαρτήσεις μας.
- Μεταβείτε στον ριζικό
/bootstrap
κατάλογο και εκτελέστεnpm install
την εγκατάσταση των τοπικών μας εξαρτήσεων που αναφέρονται στο package.json . - Εγκαταστήστε το Ruby , εγκαταστήστε το Bundler με
gem install bundler
και, τέλος, εκτελέστε τοbundle install
. Αυτό θα εγκαταστήσει όλες τις εξαρτήσεις Ruby, όπως το Jekyll και τα πρόσθετα.- Χρήστες Windows: Διαβάστε αυτόν τον οδηγό για να θέσετε το Jekyll σε λειτουργία χωρίς προβλήματα.
Όταν ολοκληρωθεί, θα μπορείτε να εκτελέσετε τις διάφορες εντολές που παρέχονται από τη γραμμή εντολών.
Το 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 μας μία φορά, ενώ εξαλείφουμε την ανάγκη για mixins προμηθευτών όπως αυτά που βρίσκονται στο v3.
We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See /package.json for details.
Running our documentation locally requires the use of Jekyll, a decently flexible static site generator that provides us: basic includes, Markdown-based files, templates, and more. Here’s how to get it started:
- Run through the tooling setup above to install Jekyll (the site builder) and other Ruby dependencies with
bundle install
. - From the root
/bootstrap
directory, runnpm run docs-serve
in the command line. - Open
http://localhost:9001
in your browser, and voilà.
Learn more about using Jekyll by reading its documentation.
Εάν αντιμετωπίσετε προβλήματα με την εγκατάσταση εξαρτήσεων, απεγκαταστήστε όλες τις προηγούμενες εκδόσεις εξαρτήσεων (καθολικές και τοπικές). Στη συνέχεια, επανάληψη npm install
.