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.

We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See /package.json for details.

Local documentation

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:

  1. Run through the tooling setup above to install Jekyll (the site builder) and other Ruby dependencies with bundle install.
  2. From the root /bootstrap directory, run npm run docs-serve in the command line.
  3. Open http://localhost:9001 in your browser, and voilà.

Learn more about using Jekyll by reading its documentation.

Troubleshooting

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