minimal

최소한의 테마

Minimal은 GitHub 페이지의 Jekyll 테마입니다. 테마를 미리 보고 어떤 모양인지 확인하거나 지금 사용해 볼 수도 있습니다.

용법

최소 테마를 사용하려면:

1. 사이트의 _config.yml 에 다음을 추가하세요.

    remote_theme : pages-themes/[email protected]
   plugins :
   - jekyll-remote-theme # add this line to the plugins list if you already have one

2. 선택적으로 컴퓨터에서 사이트를 미리 보려면 사이트의 Gemfile 에 다음을 추가하세요.

    gem "github-pages" , group : :jekyll_plugins 

커스터마이징

구성 변수

Minimal은 사이트의 _config.yml 에 설정된 경우 다음 변수를 존중합니다.

 title : [The title of your site]
description : [A short description of your site's purpose]

또한 다음과 같은 선택적 변수를 설정하도록 선택할 수도 있습니다.

 show_downloads : ["true" or "false" (unquoted) to indicate whether to provide a download URL]
google_analytics : [Your Google Analytics tracking ID]

스타일시트

나만의 맞춤 스타일을 추가하려면 다음 단계를 따르세요.

1. 사이트에 /assets/css/style.scss 라는 파일을 만듭니다.
2. 표시된 대로 정확하게 파일 상단에 다음 콘텐츠를 추가합니다.

   ---
   ---
   
   @import " {{ site.theme }} " ;

3. @import 줄 바로 뒤에 원하는 사용자 정의 CSS(또는 가져오기를 포함한 Sass)를 추가하세요.

참고: 테마의 Sass 변수를 변경하려면 스타일시트의 @import 줄 앞에 새 값을 설정해야 합니다.

레이아웃

테마의 HTML 레이아웃을 변경하려면 다음 단계를 따르세요.

1. 사용자 정의 favicon 과 같은 일부 변경 사항의 경우 로컬 _includes 폴더에 사용자 정의 파일을 추가할 수 있습니다. 테마와 함께 제공되는 파일은 시작점을 제공하며 원본 레이아웃 템플릿에 포함됩니다.
2. 보다 광범위한 변경을 위해서는 테마 저장소에서 원본 템플릿을 복사하세요.
   ( 프로 팁: 복사를 더 쉽게 하려면 "raw"를 클릭하세요 )
3. 사이트에 /_layouts/default.html 이라는 파일을 만듭니다.
4. 첫 번째 단계에서 복사한 기본 레이아웃 내용을 붙여넣습니다.
5. 원하는 대로 레이아웃을 맞춤설정하세요.

Google Analytics 코드 사용자 정의

Google은 이 테마가 처음 만들어진 이후 수년에 걸쳐 Google Analytics 코드에 대한 여러 반복을 출시했습니다. 최신 코드를 활용하려면 Jekyll 사이트의 _includes/head-custom-google-analytics.html 에 코드를 붙여넣으세요.

GitHub에서 생성된 URL 재정의

템플릿은 저장소 링크나 프로젝트 다운로드 링크와 같이 GitHub에서 제공하는 URL에 의존하는 경우가 많습니다. 하나 이상의 기본 URL을 재정의하려면 다음 단계를 따르세요.

1. 변수 이름을 확인하려면 템플릿 소스를 살펴보세요. {{ site.github.zip_url }} 형식입니다.
2. 사이트의 _config.yml 에서 템플릿이 사용할 URL을 지정하세요. 예를 들어 변수가 site.github.url 인 경우 다음을 추가합니다.

    github :
     zip_url : http://example.com/download.zip
     another_url : another value

3. 귀하의 사이트가 구축되면 Jekyll은 GitHub에서 제공하는 기본 URL 대신 귀하가 지정한 URL을 사용할 것입니다.

참고: site. 접두사, 그리고 각 변수 이름( github. 뒤)은 github: 아래에 두 개의 공백으로 들여쓰기되어야 합니다.

자세한 내용은 Jekyll 변수 문서를 참조하세요.

로드맵

제안된 기능(및 알려진 문제) 목록은 공개 문제를 참조하세요.

프로젝트 철학

Minimal 테마는 GitHub 페이지 사용자가 첫 번째(또는 100번째) 웹사이트를 빠르고 쉽게 만들 수 있도록 고안되었습니다. 테마는 유연성보다는 단순성을 중시하여 대부분의 사용자 요구 사항을 기본적으로 충족해야 하며 사용자에게 특정 요구 사항이 있거나 경험을 추가로 사용자 정의하려는 경우 추가적인 복잡성을 선택할 수 있는 기회를 제공해야 합니다. (예: 사용자 정의 CSS 추가 또는 기본 레이아웃 수정) 그것은 또한 멋져 보일 것입니다. 그러나 그것은 말할 필요도 없습니다.

기여

Minimal에 기여하는 데 관심이 있으신가요? 우리는 당신의 도움을 환영합니다. Minimal은 오픈 소스 프로젝트로, 여러분과 같은 사용자가 한 번에 하나의 기여를 구축했습니다. 기여 방법에 대한 지침은 CONTRIBUTING 파일을 참조하세요.

로컬에서 테마 미리보기

테마를 로컬에서 미리 보려면(예: 변경 제안 프로세스 중) 다음 단계를 따르세요.

1. 테마 저장소를 복제합니다( git clone https://github.com/pages-themes/minimal ).
2. 테마 디렉토리로 cd
3. script/bootstrap 실행하여 필요한 종속성을 설치합니다.
4. bundle exec jekyll serve 실행하여 미리보기 서버를 시작하세요.
5. 테마를 미리 보려면 브라우저에서 localhost:4000 방문하세요.

테스트 실행

테마에는 해당 테마가 있는 사이트가 성공적으로 구축되는지 확인하기 위한 최소한의 테스트 모음이 포함되어 있습니다. 테스트를 실행하려면 script/cibuild 실행하면 됩니다. 테스트 스크립트가 작동하려면 먼저 script/bootstrap 한 번 실행해야 합니다.