Gatsby.js를 기반으로 하는 정적 사이트용 기본 스타터 키트입니다.
개발을 시작하세요.
새 사이트의 디렉토리로 이동하여 시작하십시오.
cd my-site/
gatsby develop
소스 코드를 열고 편집을 시작하세요!
귀하의 사이트는 이제 http://localhost:8000
에서 실행되고 있습니다!
참고: 두 번째 링크인 http://localhost:8000/___graphql
도 표시됩니다. 이는 데이터 쿼리를 실험하는 데 사용할 수 있는 도구입니다. Gatsby 튜토리얼에서 이 도구를 사용하는 방법에 대해 자세히 알아보세요.
선택한 코드 편집기에서 my-site
디렉토리를 열고 src/pages/index.js
편집하세요. 변경 사항을 저장하면 브라우저가 실시간으로 업데이트됩니다!
Gatsby 프로젝트에서 볼 수 있는 최상위 파일과 디렉터리를 간략하게 살펴보세요.
.
├── node_modules
├── src
├── .gitignore
├── .prettierrc
├── gatsby-browser.js
├── gatsby-config.js
├── gatsby-node.js
├── gatsby-ssr.js
├── LICENSE
├── package-lock.json
├── package.json
├── README.md
└── yarn.lock
/node_modules
: 이 디렉터리에는 프로젝트가 의존하는 모든 코드 모듈(npm 패키지)이 자동으로 설치됩니다.
/src
: 이 디렉토리에는 사이트 헤더나 페이지 템플릿과 같이 사이트 프런트 엔드에서 볼 수 있는 내용(브라우저에 표시되는 내용)과 관련된 모든 코드가 포함됩니다. src
"소스 코드"에 대한 규칙입니다.
.gitignore
: 이 파일은 버전 기록을 추적하지 않거나 유지하지 않아야 하는 파일을 git에 알려줍니다.
.prettierrc
: Prettier를 위한 구성 파일입니다. Prettier는 코드 형식을 일관되게 유지하는 데 도움이 되는 도구입니다.
gatsby-browser.js
: 이 파일은 Gatsby가 Gatsby 브라우저 API(있는 경우)의 사용을 찾을 것으로 예상하는 곳입니다. 이를 통해 브라우저에 영향을 미치는 기본 Gatsby 설정을 사용자 정의/확장할 수 있습니다.
gatsby-config.js
: Gatsby 사이트의 기본 구성 파일입니다. 여기에서 사이트 제목 및 설명, 포함할 Gatsby 플러그인 등과 같은 사이트에 대한 정보(메타데이터)를 지정할 수 있습니다. (자세한 내용은 구성 문서를 확인하세요)
gatsby-node.js
: 이 파일은 Gatsby가 Gatsby Node API(있는 경우)의 사용법을 찾을 것으로 예상하는 곳입니다. 이를 통해 사이트 구축 프로세스의 일부에 영향을 미치는 기본 Gatsby 설정을 사용자 정의/확장할 수 있습니다.
gatsby-ssr.js
: 이 파일은 Gatsby가 Gatsby 서버 측 렌더링 API(있는 경우)의 사용을 찾을 것으로 예상하는 곳입니다. 이를 통해 서버 측 렌더링에 영향을 미치는 기본 Gatsby 설정을 사용자 정의할 수 있습니다.
LICENSE
: Gatsby는 MIT 라이센스에 따라 라이센스가 부여됩니다.
package-lock.json
(먼저 아래 package.json
참조). 이는 프로젝트에 설치된 npm 종속성의 정확한 버전을 기반으로 자동 생성된 파일입니다. (이 파일을 직접 변경할 수는 없습니다).
package.json
: 메타데이터(프로젝트 이름, 작성자 등) 등을 포함하는 Node.js 프로젝트용 매니페스트 파일입니다. 이 매니페스트는 npm이 프로젝트에 설치할 패키지를 아는 방법입니다.
README.md
: 프로젝트에 대한 유용한 참조 정보가 포함된 텍스트 파일입니다.
yarn.lock
: Yarn은 npm을 대체하는 패키지 관리자입니다. 모든 Gatsby 문서는 npm을 참조하지만 Yarn이나 npm을 사용할 수 있습니다. 이 파일은 기본적으로 다른 패키지 관리 시스템에 대해서만 package-lock.json
과 동일한 목적으로 사용됩니다.
배포에는 Gitlab CI를 사용할 수 있습니다. 프로젝트에는 두 개의 파일(샘플 .gitlab-ci.yml
및 S3 배포용 .gitlab-ci-s3.yml
이 있습니다.