Source

빌드 도구

Bootstrap에 포함된 npm 스크립트를 사용하여 설명서를 작성하고, 소스 코드를 컴파일하고, 테스트를 실행하는 방법을 배우십시오.

툴링 설정

부트스트랩은 빌드 시스템에 NPM 스크립트 를 사용합니다. package.json 에는 코드 컴파일, 테스트 실행 등을 포함하여 프레임워크 작업을 위한 편리한 방법이 포함되어 있습니다.

빌드 시스템을 사용하고 문서를 로컬에서 실행하려면 부트스트랩의 소스 파일과 Node.js의 사본이 필요합니다. 다음 단계를 수행하면 흔들 준비가 된 것입니다.

  1. 종속성을 관리하는 데 사용하는 Node.js를 다운로드하여 설치 합니다.
  2. 루트 /bootstrap디렉토리 로 이동하고 package.jsonnpm install 에 나열된 로컬 종속성을 설치하기 위해 실행합니다 .
  3. Ruby 를 설치 하고 Bundler 를 설치 gem install bundler하고 마지막으로 실행 bundle install합니다. 이것은 Jekyll 및 플러그인과 같은 모든 Ruby 종속성을 설치합니다.
    • 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 속성에 공급업체 접두사를 자동으로 추가합니다. 그렇게 하면 v3에서 볼 수 있는 것과 같은 공급업체 믹스인이 필요하지 않고 CSS의 핵심 부분을 한 번에 작성할 수 있으므로 시간과 코드가 절약됩니다.

Autoprefixer를 통해 지원되는 브라우저 목록을 GitHub 리포지토리 내의 별도 파일에 유지 관리합니다. 자세한 내용은 /.browserslistrc 를 참조하세요.

현지 문서

문서를 로컬에서 실행하려면 기본 포함, 마크다운 기반 파일, 템플릿 등을 제공하는 상당히 유연한 정적 사이트 생성기인 Jekyll을 사용해야 합니다. 시작하는 방법은 다음과 같습니다.

  1. 위의 도구 설정 을 실행하여 Jekyll(사이트 빌더) 및 기타 Ruby 종속성을 bundle install.
  2. 루트 /bootstrap디렉터리 npm run docs-serve에서 명령줄에서 실행합니다.
  3. http://localhost:9001브라우저에서 열고 짜잔.

설명서 를 읽고 Jekyll 사용에 대해 자세히 알아보세요 .

문제 해결

종속성 설치에 문제가 발생하면 모든 이전 종속성 버전(글로벌 및 로컬)을 제거하십시오. 그런 다음 을 다시 실행 npm install하십시오.