Yapı araçları
Belgelerimizi oluşturmak, kaynak kodu derlemek, testleri çalıştırmak ve daha fazlası için Bootstrap'in içerdiği npm komut dosyalarını nasıl kullanacağınızı öğrenin.
Bootstrap , yapı sistemi için NPM komut dosyalarını kullanır. package.json'umuz , kod derleme, testler çalıştırma ve daha fazlası dahil olmak üzere çerçeveyle çalışmak için uygun yöntemler içerir.
Yapı sistemimizi kullanmak ve belgelerimizi yerel olarak çalıştırmak için Bootstrap'in kaynak dosyalarının ve Node.js dosyasının bir kopyasına ihtiyacınız olacak. Bu adımları izleyin ve sallanmaya hazır olmalısınız:
- Bağımlılıklarımızı yönetmek için kullandığımız Node.js'yi indirip yükleyin .
/bootstrapKök dizine gidin ve package.jsonnpm installiçinde listelenen yerel bağımlılıklarımızı yüklemek için çalıştırın .- Ruby'yi kurun, Bundler'ı kurun
gem install bundlerve son olarak çalıştırınbundle install. Bu, Jekyll ve eklentiler gibi tüm Ruby bağımlılıklarını yükleyecektir.- Windows kullanıcıları: Jekyll'i sorunsuz bir şekilde kurmak ve çalıştırmak için bu kılavuzu okuyun .
Tamamlandığında, komut satırından sağlanan çeşitli komutları çalıştırabileceksiniz.
package.json'umuz aşağıdaki komutları ve görevleri içerir :
| Görev | Tanım |
|---|---|
npm run dist |
npm run dist/distderlenmiş dosyalarla dizini oluşturur . Sass , Autoprefixer ve UglifyJS kullanır . |
npm test |
Artı ile aynı npm run dist, testleri yerel olarak çalıştırır |
npm run docs |
Dokümanlar için CSS ve JavaScript oluşturur ve lintler. Daha sonra belgeleri aracılığıyla yerel olarak çalıştırabilirsiniz npm run docs-serve. |
npm runTüm npm komut dosyalarını görmek için çalıştırın .
Bootstrap, derleme sırasında bazı CSS özelliklerine satıcı öneklerini otomatik olarak eklemek için Autoprefixer'ı (yapı sürecimize dahildir) kullanır. Bunu yapmak, v3'te bulunanlar gibi satıcı karışımlarına olan ihtiyacı ortadan kaldırırken CSS'mizin önemli kısımlarını tek seferde yazmamıza izin vererek zamandan ve koddan tasarruf etmemizi sağlar.
Autoprefixer aracılığıyla desteklenen tarayıcıların listesini GitHub depomuzda ayrı bir dosyada tutuyoruz. Ayrıntılar için /package.json'a bakın .
Belgelerimizi yerel olarak çalıştırmak, bize aşağıdakileri sağlayan oldukça esnek bir statik site üreticisi olan Jekyll'in kullanılmasını gerektirir: temel içerikler, Markdown tabanlı dosyalar, şablonlar ve daha fazlası. Nasıl başlayacağınız aşağıda açıklanmıştır:
- Jekyll'i ( site oluşturucu) ve diğer Ruby bağımlılıklarını
bundle install. - Kök dizinden komut satırında
/bootstrapçalıştırın .npm run docs-serve http://localhost:9001Tarayıcınızda açın ve voilà.
Belgelerini okuyarak Jekyll'i kullanma hakkında daha fazla bilgi edinin .
Bağımlılıkları yüklemeyle ilgili sorunlarla karşılaşırsanız, önceki tüm bağımlılık sürümlerini (genel ve yerel) kaldırın. Ardından, yeniden çalıştırın npm install.