https://seagl.org에서 제공되는 웹사이트의 소스코드입니다.
GitHub 페이지와 함께 Jekyll을 정적 사이트 생성기로 사용합니다.
코드가 GitHub의 공유 저장소에 푸시될 때마다 사이트가 자동으로 렌더링됩니다.
기본적으로 사이트를 업데이트하는 단계(예: 새 블로그 게시물 게시)는 다음과 같습니다.
아래에는 각 단계에 대한 지침이 나와 있습니다. 지침에서는 git/GitHub/기술 경험이 적은 사람이 작업을 수행한다고 가정합니다. 경험이 더 많은 사람들은 그에 따라 추정할 수 있습니다. :-)
이 저장소에서 직접 작업 할 수도 있지만 모범 사례는 그렇지 않습니다. 대신 저장소를 포크하거나 복제한 다음 해당 복사본을 변경할 수 있습니다. 이를 통해 변경 사항을 적용하기 전에 테스트할 수 있으며 형식이 잘못되었거나 단어로 작성된 변경 사항이 외부로 유출되는 위험을 줄일 수 있습니다.
저장소를 포크하려면:
짜잔! 그게 전부입니다.
새 블로그 게시물을 추가하는 경우 다음 파일 이름 규칙을 따르십시오.
_posts
디렉터리에 저장하세요.YYYY-MM-DD
형식의 날짜로 파일 이름을 시작합니다. 이는 웹사이트에 블로그 게시물이 표시되는 순서를 제어하므로 매우 중요합니다 .--future
사용하지 않으면 미래 날짜의 게시물이 표시되지 않는다는 의미이기도 합니다. 현재 게시물이 표시되려면 예정된 날짜 또는 그 이후에 사이트 재구축을 실행해야 합니다. 이는 git commit -m 'rebuild pages' --allow-empty && git push origin main
사용하거나 사이트를 실제로 변경하여 수행할 수 있습니다.-
)와 대시로 구분된 게시물 제목을 입력하세요. 이 제목은 표시되지 않습니다. 파일 이름을 지정하는 것뿐입니다. 간단하지만 설명적으로 작성해 주세요..md
파일 이름 확장자를 사용하여 게시물이 Markdown 형식으로 구성되었음을 나타냅니다. (마크다운을 사용해서만 게시물을 작성하세요)이러한 규칙에 따라 2017 CFP 개막을 알리는 블로그 게시물의 파일 이름은 다음과 같습니다.
2017-06-19-CFP-open.md
또한 파일 상단에 다음을 추가하세요.
---
layout: post
title: 'Example Title'
status: publish
type: post
published: true
categories: news
tags: '2013'
---
title
블로그 게시물 제목으로 설정하고 게시물과 관련된 컨퍼런스 연도를 포함하도록 tags
편집하세요(없으면 비어 있음). 나머지 값은 그대로 두십시오.
실제 파일 콘텐츠의 경우 GitHub 웹 인터페이스나 로컬 컴퓨터에서 변경할 수 있습니다.
_posts
)로 이동하세요.Create a new file
클릭하세요.Create a new file
클릭하세요.Commit changes
양식을 사용하여 변경 사항을 커밋합니다.#
)와 문제 번호( #74
)를 사용하세요. 이는 끌어오기 요청에 자동으로 연결되므로 매우 편리합니다.TBD(로컬 머신에서 git을 사용하는 사람들은 이미 이것을 알고 있다고 가정합니다. 나중에 채울 것입니다 )
GitHub에 푸시하기 전에 모든 변경 사항을 로컬에서 테스트해 보세요.
로컬 개발 서버를 시작하면 http://localhost:4000에서 사이트 복사본을 사용할 수 있게 됩니다. 서버를 실행하는 방법에는 몇 가지가 있습니다. 선택하세요!
종속성:
일회성 설정:
bundle install
서버를 시작합니다:
bundle exec jekyll serve --watch
미래 날짜 및 게시되지 않은 게시물을 미리 보려면 위 명령에 --future --unpublished
추가하세요.
종속성:
docker
podman
으로 교체)일회성 설정:
docker build --tag ' seagldev ' ' . '
서버를 시작합니다:
docker run --rm --interactive --tty --publish ' 4000:4000 ' --volume " $PWD :/usr/src/app " ' seagldev '
미래 날짜 및 게시되지 않은 게시물을 미리 보려면 위 명령 끝에 --future --unpublished
추가하세요.
GitHub 인터페이스나 로컬 컴퓨터에서 PR을 보낼 수 있습니다.
Pull requests
탭을 클릭하세요.New pull request button
클릭합니다.Create pull request
클릭합니다.#
)와 문제 번호( #74
)를 사용하세요. 이는 끌어오기 요청에 자동으로 연결되므로 매우 편리합니다.[Allow edits from maintainers](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork)
선택합니다. [Allow edits from maintainers](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork)
필요한 경우 다른 팀 구성원이 편집할 수 있도록 합니다.Create pull request
클릭합니다.TBD(로컬 머신에서 git을 사용하는 사람들은 이미 이것을 알고 있다고 가정합니다. 나중에 채울 것입니다 )
이제 누군가(아마도 리포지토리에 대한 액세스 권한이 있는 경우)가 풀 요청을 검토한 후 병합해야 합니다.
풀 요청이 병합되면 웹사이트에 게시됩니다.
참고 사항 : 병합 자체는 사이트 재구축을 시작하지 않습니다. 사이트를 다시 빌드하려면 다음과 같이 빈 커밋을 푸시해야 합니다.
git commit --allow-empty -m " Rebuild the site, please " && git push
img/posts/
디렉터리에 이미지를 추가한 후 다음 Markdown을 사용하세요.
![ Example description ] ( /img/posts/example.jpg )
팁:
이미지를 측면으로 정렬하려면 align-left
또는 align-right
클래스를 추가하세요.
![ Example description ] ( /img/posts/example.jpg ) {:.align-left}
페이지 로드 시간을 위해 이미지를 게시물에 사용하기 전에 적당한 크기로 조정하세요.
지난 회의는 Jekyll 컬렉션으로 정적으로 보관됩니다.
archive-conferences
archive-sessions
특정 연도의 아카이브를 생성하려면 먼저 일정에서 데이터를 가져옵니다.
bundle exec rake import[2020]
—그런 다음 수정이 필요한 경우 아카이브 파일을 직접 편집합니다.