in English

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

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

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

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

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

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

When completed, you’ll be able to run the various commands provided from the command line.

Using npm scripts

Our package.json includes the following commands and tasks:

Task Description
npm run dist npm run dist creates the /dist/ directory with compiled files. Uses Sass, Autoprefixer, and terser.
npm test Same as npm run dist plus it runs tests locally
npm run docs Builds and lints CSS and JavaScript for docs. You can then run the documentation locally via npm run docs-serve.

Run npm run to see all the npm scripts.

Autoprefixer

Bootstrap uses Autoprefixer (included in our build process) to automatically add vendor prefixes to some CSS properties at build time. Doing so saves us time and code by allowing us to write key parts of our CSS a single time while eliminating the need for vendor mixins like those found in v3.

We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See .browserslistrc 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. Εκτελέστε την παραπάνω ρύθμιση εργαλείων για να εγκαταστήσετε το Jekyll (το πρόγραμμα δημιουργίας ιστότοπου) και άλλες εξαρτήσεις Ruby με το bundle install.
  2. Από τον ριζικό /bootstrapκατάλογο, εκτελέστε npm run docs-serveτη γραμμή εντολών.
  3. Ανοίξτε http://localhost:9001στο πρόγραμμα περιήγησής σας και voilà.

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

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

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