- Node.js > 18
- Node.js 18 버전 이상부터 발생하는
ERR_OSSL_EVP_UNSUPPORTED
이슈를 회피하기 위해 NODE_OPTIONS=--openssl-legacy-provider
옵션이 적용되어 있습니다.
- 가급적 Node.js 버전 18 이상에서 테스트하기를 권장하며 가급적
.nvmrc
에 기재된 Node.js 버전 사용을 권고합니다.
# fork to your github account & git cloning your forked repository
npm install
- asset/
- component/
- pages/
index.html
을 렌더링하기 위한 하나의 페이지 뿐이다.
- payload/
- Payload 데이터 변경만으로 개인 웹 이력서를 뽑아낼 수 있다.
- 이력서 렌더링에 필요한 데이터가 포함된다.
- 하단의 Payload Detail 참고
- docs/
npm run export (next export)
를 실행하면 Static HTML 이 렌더링되어 docs
디렉토리 하단에 생성된다.
- Github Pages 의 master branch 의
docs/
디렉토리를 지정하여 Github Pages 호스팅을 할 수 있는데, 이를 위해 export 디렉토리 이름을 docs 로 명명했다.
docs/typedoc/
에는 TypeDoc HTML 이 포함되지만 npm run export
로는 생성하지 않는다. npm run typedoc
으로 TypeDoc 을 생성할 수 있다.
/docs
하위에 Static HTML 리소스가 생성된다.
- Sub Path 가지는 도메인 구조일 경우 (ex. https://uyu423.github.io/resume 로 호스팅)
package.json
내의 homepage
필드 값을 호스팅 원하는 도메인으로 변경한다.
homepage
필드에 pathname
이 있을 경우 next.config.js
의 assetPrefix
추가하는 로직이 있음
- Options - Github Pages - Source - master branch /docs folder 를 선택
npm run export
를 실행하여 docs
내 Static HTML 을 갱신한다.
- 외부 도메인이 있는 경우 Custom Domain 항목에 기입한다.
- Github Pages Hosting 에 필요한
docs/CNAME
파일은 npm run export
과정에서 자동으로 생성됩니다.
docs/CNAME
파일 생성에는 package.json
내 homepage
필드를 참고합니다. Custom Domain 사용시 homepage 값을 수정해주세요.
package.json
내 homepage
필드가 *.github.io/*
로 추정될 경우 Custom Domain 을 사용하지 않는 것으로 간주하고 docs/CNAME
을 생성하지 않습니다.
- 외부 도메인에 대한 자세한 내용은 help.github.com 를 참고한다.
*.github.io
도메인을 그대로 사용하는 경우 http://{username}.github.io/{repository_name}
접속하면 웹 이력서가 나타난다.
- If you want additional features, please pull request. Always open.
- production 빌드에서 이미지가 깨지는 경우
- Section 의 순서는 어떻게 조절하나요?
- 현재는
pages/index.tsx
에서 직접 렌더링 순서를 변경하는 수 밖에 없습니다.
- 데이터나
_global
payload 로 핸들링하는 방법을 고민 중입니다.
- index.html 에서 이미지, CSS가 404 발생하는 경우