You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
제목과 작성 폼의 항목을 채웁니다. Discussion 제목이 사이트에서도 글 제목으로 사용됩니다.
본문을 Markdown으로 작성하고, 미리보기에서 제목·링크·이미지·코드가 잘 보이는지 확인합니다.
Discussion을 등록한 뒤 운영진의 검토를 받습니다.
운영진이 blog:published 라벨을 추가하면 사이트에 표시할 글이 됩니다.
블로그 목록과 글 상세 화면에서 내용을 확인합니다.
대표 글로 소개할 때는 blog:featured 라벨을 추가할 수 있습니다. 게시를 취소하려면 blog:published 라벨을 제거합니다. Blog 카테고리에서 다른 카테고리로 옮겨도 사이트의 게시 대상에서 제외됩니다.
이 저장소는 공개 저장소입니다. 사이트 게시 승인을 받기 전에도 Discussion 자체는 GitHub에서 공개됩니다. 개인정보나 비공개 자료는 넣지 말아 주세요.
작성 템플릿 살펴보기
항목
작성 방법
사이트에서 쓰이는 곳
제목
내용을 잘 설명하는 제목을 입력합니다.
카드 제목, 상세 제목, 공유 정보
글 유형
소식 / 개발 / 팀 이야기 중 하나를 선택합니다.
목록의 유형 필터
요약
글의 핵심을 240자 이내로 소개합니다.
카드 설명과 상세 소개
대표 이미지
사용할 이미지의 HTTPS 주소를 입력합니다. 생략할 수 있습니다.
목록 카드와 상세 상단
이미지 설명
대표 이미지가 있다면 그 내용을 설명합니다.
이미지 대체 텍스트
태그
쉼표로 구분합니다. 최대 8개, 하나당 30자 이내입니다.
상세 하단
본문
Markdown으로 글을 작성합니다.
글 상세 본문
작성자 계정과 작성 시각은 GitHub에서 가져옵니다. 읽는 시간은 본문 길이로 계산하므로 따로 입력하지 않습니다.
이 글은 대표 이미지를 비워 두었습니다. 이런 경우 사이트가 kgu developers 공통 커버를 표시합니다. 직접 이미지를 넣을 때는 이미지 주소와 설명을 함께 작성하고, 사용 권한과 출처도 확인해 주세요.
작성 폼 파일은 저장소의 .github/DISCUSSION_TEMPLATE/blog.yml입니다. 폼이 새 글 화면에 보이지 않는다면 해당 파일이 기본 브랜치인 main에 반영되었는지 확인합니다. 이 첫 글은 같은 템플릿이 생성하는 Markdown 형식에 맞춰 등록했습니다.
본문은 Markdown으로 씁니다
소제목은 ##, 더 작은 소제목은 ###를 사용합니다. 목록, 링크, 표, 이미지와 코드 블록도 사용할 수 있습니다.
constmessage='함께 만들고, 배우고, 경험을 나눕니다.';console.log(message);
HTML이나 스크립트, MDX 코드를 실행하는 방식은 지원하지 않습니다. 코드 블록 안에 쓴 코드는 설명용 텍스트로 표시됩니다.
Discussion을 직접 편집할 때는 폼이 만든 글 유형 → 요약 → 대표 이미지 → 이미지 설명 → 태그 → 본문 제목과 순서를 유지해 주세요. 이 항목들이 사이트가 글의 정보를 구분하는 기준입니다. 본문 안에서는 소제목을 자유롭게 작성할 수 있습니다.
Discussion이 블로그가 되는 간단한 흐름
GitHub Discussions의 Blog 카테고리
→ 서버에서 GitHub GraphQL API로 읽기
→ blog:published 라벨 확인
→ 템플릿 항목을 글 데이터로 변환
→ 목록 카드와 글 상세 화면에 표시
서버는 Blog 카테고리의 글을 읽고 게시 라벨을 확인합니다. 이어서 템플릿의 항목을 분리하고 필수 정보와 이미지 주소 등을 검사합니다. 형식이 맞지 않거나 필수 정보가 빠진 글은 사이트에 표시하지 않습니다.
개념만 요약하면 다음과 같습니다. 실제 구현은 템플릿 해석과 데이터 검증도 함께 수행합니다.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
글 유형
개발
요약
kgu developers 블로그의 첫 글입니다. GitHub Discussions에서 글을 작성하고 게시하는 방법, 작성 템플릿의 각 항목, 사이트가 글을 읽어 목록과 상세 화면으로 보여주는 흐름을 소개합니다.
대표 이미지
No response
이미지 설명
No response
태그
블로그, GitHub Discussions, 작성 가이드, Next.js
본문
함께 만들고, 배운 것을 기록합니다
kgu developers 블로그는 경기대학교 개발팀의 소식과 개발 경험, 함께 만드는 과정에서 배운 점을 나누는 공간입니다.
첫 글에서는 이 블로그에 글을 올리는 방법을 소개합니다. 글의 원본은 GitHub Discussions에 두고, 사이트는 게시가 승인된 글을 읽어 블로그 목록과 상세 화면으로 보여줍니다. 글을 고치기 위해 사이트 코드를 수정할 필요는 없습니다.
글 하나를 게시하는 순서
대표 글로 소개할 때는 blog:featured 라벨을 추가할 수 있습니다. 게시를 취소하려면 blog:published 라벨을 제거합니다. Blog 카테고리에서 다른 카테고리로 옮겨도 사이트의 게시 대상에서 제외됩니다.
작성 템플릿 살펴보기
작성자 계정과 작성 시각은 GitHub에서 가져옵니다. 읽는 시간은 본문 길이로 계산하므로 따로 입력하지 않습니다.
이 글은 대표 이미지를 비워 두었습니다. 이런 경우 사이트가 kgu developers 공통 커버를 표시합니다. 직접 이미지를 넣을 때는 이미지 주소와 설명을 함께 작성하고, 사용 권한과 출처도 확인해 주세요.
작성 폼 파일은 저장소의
.github/DISCUSSION_TEMPLATE/blog.yml입니다. 폼이 새 글 화면에 보이지 않는다면 해당 파일이 기본 브랜치인main에 반영되었는지 확인합니다. 이 첫 글은 같은 템플릿이 생성하는 Markdown 형식에 맞춰 등록했습니다.본문은 Markdown으로 씁니다
소제목은
##, 더 작은 소제목은###를 사용합니다. 목록, 링크, 표, 이미지와 코드 블록도 사용할 수 있습니다.HTML이나 스크립트, MDX 코드를 실행하는 방식은 지원하지 않습니다. 코드 블록 안에 쓴 코드는 설명용 텍스트로 표시됩니다.
Discussion을 직접 편집할 때는 폼이 만든 글 유형 → 요약 → 대표 이미지 → 이미지 설명 → 태그 → 본문 제목과 순서를 유지해 주세요. 이 항목들이 사이트가 글의 정보를 구분하는 기준입니다. 본문 안에서는 소제목을 자유롭게 작성할 수 있습니다.
Discussion이 블로그가 되는 간단한 흐름
서버는 Blog 카테고리의 글을 읽고 게시 라벨을 확인합니다. 이어서 템플릿의 항목을 분리하고 필수 정보와 이미지 주소 등을 검사합니다. 형식이 맞지 않거나 필수 정보가 빠진 글은 사이트에 표시하지 않습니다.
개념만 요약하면 다음과 같습니다. 실제 구현은 템플릿 해석과 데이터 검증도 함께 수행합니다.
목록은 기본적으로 최신 글부터 표시하고, 유형별 필터와 페이지 이동을 제공합니다. 상세 주소는 /blog/Discussion번호 형태입니다. 제목을 수정해도 같은 Discussion의 주소는 유지됩니다.
GitHub에 접근하는 토큰은 서버에서만 사용합니다. 방문자의 브라우저가 토큰을 받아 GitHub API를 직접 호출하는 구조는 아닙니다.
수정했는데 바로 보이지 않을 때
정상적으로 읽은 글은 서버에서 5분간 캐시합니다. 캐시가 만료된 뒤 요청이 들어오면 갱신하므로, 글 수정이나 게시 라벨 변경이 화면에 반영되기까지 시간이 걸릴 수 있습니다. GitHub API 장애가 있을 때는 마지막 정상 결과가 남아 있을 수도 있습니다.
글이 보이지 않으면 아래 순서로 확인해 주세요.
게시 라벨 제거는 GitHub 원문이나 이미지를 삭제하는 작업과는 다릅니다. 긴급히 내려야 하는 내용은 원문과 첨부 파일, 사이트 캐시까지 함께 확인해야 합니다.
다음 이야기를 기다립니다
작은 문제를 해결한 과정, 함께 작업하며 배운 점, 프로젝트를 돌아본 기록 모두 좋은 출발점이 됩니다.
템플릿을 채우고, 동료와 검토하고, 경험을 나눠 주세요. 이 블로그에 우리의 다음 이야기를 차곡차곡 쌓아가겠습니다.
All reactions