Source

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.

Takım kurulumu

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:

  1. Bağımlılıklarımızı yönetmek için kullandığımız Node.js'yi indirip yükleyin .
  2. /bootstrapKök dizine gidin ve package.jsonnpm install içinde listelenen yerel bağımlılıklarımızı yüklemek için çalıştırın .
  3. Ruby'yi kurun, Bundler'ı kurun gem install bundlerve son olarak çalıştırın bundle 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.

NPM komut dosyalarını kullanma

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 .

otomatik ön ek

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 .

Yerel belgeler

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:

  1. Jekyll'i ( site oluşturucu) ve diğer Ruby bağımlılıklarını bundle install.
  2. Kök dizinden komut satırında /bootstrapçalıştırın .npm run docs-serve
  3. http://localhost:9001Tarayıcınızda açın ve voilà.

Belgelerini okuyarak Jekyll'i kullanma hakkında daha fazla bilgi edinin .

Sorun giderme

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.