가장 간단한 Jekyll
GH 페이지의 최소 Jekyll 기반 사이트, 테마가있는 콘텐츠 한 페이지로 축소되었습니다.
시사
에 대한
이것은 템플릿 및 라이브 데모 프로젝트입니다. GH 페이지에서 jekyll 사이트를 얻기 위해 설정해야 할 시간이 적습니다.
- index.md
- 홈페이지의 경우 -이 경우 유일한 페이지입니다.
- If you leave out this page, then
README.md
will be used as your homepage.
- _config.yml
- 테마 설정 - 레이아웃과 스타일을 처리합니다.
- jekyll siteemap 플러그인 활성화 - gemfile에서 활성화하는 것만으로는 충분하지 않습니다. 옵션 프론트 매스터와 같은 다른 플러그인이 활성화됩니다.
- Other standard values like
baseurl
, title
and description
have been left out of the config. GH 페이지를 구축 할 때 GH 페이지 보석에 의해 유추됩니다.
- 보석
- 이것은 실제로 GH 페이지에서 사용되지 않지만 Bundler를 사용하여 로컬로 Jekyll 테마를 설치할 수 있습니다.
- Use a single gem
github-pages
if you want to match all the gems on GH Pages (which can be heavy to install). - 로컬로 사이트를 실행할 필요가없는 경우이 파일을 삭제하십시오.
게시물, 보석, 레이아웃 등이있는 다중 페이지 사이트의 본격적인 예제를 원한다면 Jekyll-Blog-Demo Repo를 확인하십시오. 템플릿 및 데모 사이트로도 사용할 수 있습니다.
이 프로젝트를 사용하는 방법
설정
- Click Use This Template to create a new repo in your own account. You can leave the name as
simplest-jekyll
. - Repo 설정에서 GitHub 페이지를 활성화하십시오. Choose to serve from
master
branch and the /
path option. - Check your repo's environment tab to see when the deploy is done.
- Click View deployment to see the live site. 예 : https://michaelcurrin.github.io/simplest-jekyll/
Note that /simplest-jekyll/index.html
is available immediately but it takes a few minutes until Github Pages makes /simplest-jekyll/
available.
사용자 정의하십시오
- Update the
README.md
with your own details. 이것은 실제로 배포 된 사이트에서 사용되지 않지만 로컬 및 Github에서 볼 수 있습니다. - 테마
- 다른 테마를 원한다면 _config.yml에서 테마를 편집하십시오.
- REPO 설정의 GitHub 페이지 섹션을 사용하여 시각적으로 미리 보기도 할 수도 있습니다.
- Note only themes supported by Github Pages are covered (about 10) but if you use the remote_theme field in your config you can reference more themes.
- 로컬로 설치하고 실행하려면 Gemfile이 구성에 사용 된 테마를 포함해야합니다.
- 대부분의 Jekyll 사이트와 마찬가지로 Index.md는 홈페이지로 사용됩니다.
- 상단에 전면 물질이 있으므로 액체가 적용됩니다.
- Edit your
index.md
file with your own content as HTML or markdown. - You can rename it to
index.html
if you only want plain HTML. - 상단의 전면 물질을 제거하여 액체 형식과 테마를 제거 할 수 있습니다.
- If you want to, add more pages at the root and break out any common HTMl such as header or head or navbar into
_includes
folder or _layouts
folder (neither are covered in the scope of this project but are common for Jekyll projects). - 자세한 내용은 Jekyll 사이트의 문서 및 튜토리얼을 참조하십시오.
- 선택적으로 Jekyll을 로컬로 실행하십시오.
- Ruby와 Bundler를 설치하십시오.
- 프로젝트 보석 -Jekyll 및 테마 보석을 설치하십시오.
- Jekyll Dev 서버를 실행하십시오.
- 전체 지침은 Jekyll 블로그 데모의 문서를 참조하십시오. You'll need to add a
Makefile
as well to match those commands.
관련 프로젝트
- -Jekyll Cli로 생성 된 기본 블로그. 테마, 컨텐츠, 스타일 설정, 보석 및 Makefile을 사용합니다.
- -Jekyll 4, 테마, GitHub 액션 및 GitHub 페이지를 사용합니다.
- - 테마가 있지만 보석이없는 최소 Jekyll 사이트.
특허
@michaelcurrin에 의해 MIT 아래에 출시되었습니다.