Source

Κατασκευάστε εργαλεία

Μάθετε πώς να χρησιμοποιείτε τα σενάρια npm που περιλαμβάνονται στο Bootstrap για να δημιουργήσετε την τεκμηρίωσή μας, να μεταγλωττίσετε τον πηγαίο κώδικα, να εκτελέσετε δοκιμές και πολλά άλλα.

Ρύθμιση εργαλείων

Το Bootstrap χρησιμοποιεί σενάρια npm για το σύστημα κατασκευής του. Το package.json μας περιλαμβάνει βολικές μεθόδους για την εργασία με το πλαίσιο, συμπεριλαμβανομένης της μεταγλώττισης κώδικα, της εκτέλεσης δοκιμών και άλλων.

Για να χρησιμοποιήσετε το σύστημα κατασκευής μας και να εκτελέσετε την τεκμηρίωσή μας τοπικά, θα χρειαστείτε ένα αντίγραφο των αρχείων πηγής και του κόμβου του Bootstrap. Ακολουθήστε αυτά τα βήματα και θα πρέπει να είστε έτοιμοι να ροκάρετε:

  1. Κατεβάστε και εγκαταστήστε το Node.js , το οποίο χρησιμοποιούμε για να διαχειριστούμε τις εξαρτήσεις μας.
  2. Μεταβείτε στον ριζικό /bootstrapκατάλογο και εκτελέστε npm installτην εγκατάσταση των τοπικών μας εξαρτήσεων που αναφέρονται στο package.json .
  3. Εγκαταστήστε το Ruby , εγκαταστήστε το Bundler με gem install bundlerκαι, τέλος, εκτελέστε το bundle install. Αυτό θα εγκαταστήσει όλες τις εξαρτήσεις Ruby, όπως το Jekyll και τα πρόσθετα.
    • Χρήστες Windows: Διαβάστε αυτόν τον οδηγό για να θέσετε το Jekyll σε λειτουργία χωρίς προβλήματα.

Όταν ολοκληρωθεί, θα μπορείτε να εκτελέσετε τις διάφορες εντολές που παρέχονται από τη γραμμή εντολών.

Χρήση σεναρίων 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 μας μία φορά, ενώ εξαλείφουμε την ανάγκη για mixins προμηθευτών όπως αυτά που υπάρχουν στο v3.

Διατηρούμε τη λίστα των προγραμμάτων περιήγησης που υποστηρίζονται μέσω του Autoprefixer σε ένα ξεχωριστό αρχείο εντός του αποθετηρίου GitHub. Δείτε το .browserslistrc για λεπτομέρειες.

Τοπική τεκμηρίωση

Για την τοπική εκτέλεση της τεκμηρίωσής μας απαιτείται η χρήση του Jekyll, μιας αξιοπρεπώς ευέλικτης δημιουργίας στατικών τοποθεσιών που μας παρέχει: βασικά στοιχεία, αρχεία που βασίζονται σε Markdown, πρότυπα και πολλά άλλα. Δείτε πώς μπορείτε να το ξεκινήσετε:

  1. Εκτελέστε την παραπάνω ρύθμιση εργαλείων για να εγκαταστήσετε το Jekyll (το πρόγραμμα δημιουργίας ιστότοπου) και άλλες εξαρτήσεις Ruby με το bundle install.
  2. Από τον ριζικό /bootstrapκατάλογο, εκτελέστε npm run docs-serveτη γραμμή εντολών.
  3. Ανοίξτε http://localhost:9001στο πρόγραμμα περιήγησής σας και voilà.

Μάθετε περισσότερα σχετικά με τη χρήση του Jekyll διαβάζοντας την τεκμηρίωσή του .

Αντιμετώπιση προβλημάτων

Εάν αντιμετωπίσετε προβλήματα με την εγκατάσταση εξαρτήσεων, απεγκαταστήστε όλες τις προηγούμενες εκδόσεις εξαρτήσεων (καθολικές και τοπικές). Στη συνέχεια, επανάληψη npm install.