DOCS : index.qmd, README.md 개선 및 아올다 협업 내용 추가

- index.qmd: 아주대학교 소학회 아올다 협업 소개 섹션 추가
- README.md: 실제 프로젝트 구조 반영, 배포 방식을 GitHub Actions 기준으로 업데이트

Author: ppiyakk2

README.md

@@ -1,114 +1,83 @@
-# OpenStack 실습 데모 페이지 with Quarto
+# OpenStack Korea Community Book
 
-Quarto를 이용한 OpenStack Korea Community 의 Book 컨텐츠 프로젝트입니다.
+OpenInfra Korea User Group과 **아주대학교 소학회 아올다**([aoldacloud.com](http://aoldacloud.com/))가 함께 만드는 오픈스택 학습 자료입니다.
 
-## Quarto를 이용한 Book 프로젝트 구조
+Quarto를 이용해 작성하며, GitHub Actions를 통해 [book.openinfra-kr.org](https://book.openinfra-kr.org)에 자동 배포됩니다.
+
+## 프로젝트 구조
 
 ```
 .
-├── _quarto.yml     # Quarto 설정 파일
-├── index.qmd       # 메인 페이지
-├── lectures/       # 강의 자료
-│   ├── short_lec.qmd   # 단편 강의자료
-│   ├──  long_lec/       # 장편 강의자료
-│   │  └── long_lec1.qmd # 장편 강의자료 속편
-│   └── long_lec.qmd    # 장편 강의자료 메인페이지 (소개, 속편 링크 가이드)
-├── community.qmd   # 커뮤니티 페이지
-├── styles.css      # 커스텀 스타일
-└── docs/          # 빌드된 사이트 (자동 생성)
+├── _quarto.yml          # Quarto 설정 파일
+├── index.qmd            # 메인 페이지
+├── custom.scss          # 커스텀 스타일
+├── _footer.html         # 공통 푸터
+├── lectures/            # 강의 자료
+└── .github/workflows/
+    └── publish.yml      # GitHub Actions 배포 워크플로우
 ```
 
-## 기여 시작하기
+> `docs/`는 빌드 결과물로 git에서 제외됩니다. GitHub Actions가 자동으로 빌드 후 `gh-pages` 브랜치에 배포합니다.
 
-1. Quarto 설치
+## 로컬 개발 환경 설정
 
-```
+### Quarto 설치
+
+```bash
 # macOS
 brew install quarto
 
 # Windows
 choco install quarto
 
 # Linux
-wget https://github.com/quarto-dev/quarto-cli/releases/download/v1.6.0/quarto-1.6.0-linux-amd64.deb
-sudo dpkg -i quarto-1.6.0-linux-amd64.deb
+wget https://github.com/quarto-dev/quarto-cli/releases/latest/download/quarto-linux-amd64.deb
+sudo dpkg -i quarto-linux-amd64.deb
 ```
 
-## 강의 및 실습 가이드 기여 방법
-
-### Github Issue 생성
-
-1. .qmd 파일 생성하기
-
-```
----
-title: "페이지 제목"
----
-
-# 내용 작성
-```
-
-2. `_quarto.yml`에 네비게이션 추가
-
-```
-website:
-  navbar:
-    left:
-      - text: "새 메뉴"
-        file: path/to/new.qmd
-```
-
-
-### 강의 자료 추가
-
-1. PDF 파일을 `media/pdf/` 디렉토리에 저장
-2. `lectures/<lecutre>.qmd`에 링크 추가
-
-## 사이트 빌드 및 배포
-
 ### 로컬 프리뷰
 
-```
+```bash
 quarto preview
 ```
 
-### 사이트 빌드
+### 빌드
 
-```
+```bash
 quarto render
 ```
 
-빌드된 파일은 `docs/` 디렉토리에 생성됩니다.
+## 기여 방법
 
-### GitHub Pages 배포
-
-1. `docs/` 디렉토리를 Git에 커밋
-2. GitHub 저장소 설정에서 GitHub Pages 소스를 `docs/` 폴더로 설정
+### 강의 자료 추가
 
-## 다국어 지원
+1. `lectures/` 아래에 `.qmd` 파일 생성
 
-한글 콘텐츠 작성을 위해 `_quarto.yml`에 다음 설정이 되어있습니다:
+```markdown
+---
+title: "페이지 제목"
+---
 
+# 내용 작성
 ```
-format:
-  html:
-    lang: ko
+
+2. `_quarto.yml`의 `sidebar.contents`에 항목 추가
+
+```yaml
+- text: "새 강의 제목"
+  file: lectures/new_lec.qmd
 ```
 
+3. PR 생성 → 머지되면 자동 배포
 
-## 문서 스타일 가이드
+### 이미지 파일
 
-- 제목은 `#`부터 시작
-- 코드 블록은 ``` 사용
-- 이미지는 `images/` 디렉토리에 저장
-- 링크는 상대 경로 사용
+이미지는 해당 강의 디렉토리의 `images/` 폴더에 저장하고 상대 경로로 참조합니다.
 
-## 도움말
+## 배포
 
-- [Quarto 공식 문서](https://quarto.org/docs/guide/)
-- [GitHub Discussions](https://github.com/openstack-kr/community-site/discussions)
-- [Slack 채널](https://openstack-kr.slack.com)
+`main` 브랜치에 push하면 GitHub Actions가 자동으로 빌드 후 `gh-pages` 브랜치에 배포합니다.
 
 ## 라이선스
 
-이 프로젝트는 MIT 라이선스 하에 배포됩니다.
+이 프로젝트는 MIT 라이선스 하에 배포됩니다.

index.qmd

@@ -6,23 +6,29 @@ title: "OpenStack Korea Community"
 
 OpenStack Korea Community에 오신 것을 환영합니다. 이 사이트는 오픈스택을 학습하는데 필요한 다양한 강의 자료들을 제공합니다.
 
+## 함께 만드는 곳
+
+이 콘텐츠는 **OpenInfra Korea User Group**과 **아주대학교 소학회 아올다**가 함께 만들어가고 있습니다.
+
+[아올다(Aolda)](http://aoldacloud.com/)는 아주대학교의 클라우드 인프라 소학회로, 오픈스택을 비롯한 오픈소스 인프라 기술을 함께 배우고 실습하는 모임입니다.
+
 ## 주요 콘텐츠
 
-### 🎓 기초 학습
+### 기초 학습
 - [오픈스택 개요](lectures/ch1_lec.qmd)
   - 클라우드 컴퓨팅의 기본 개념
   - 오픈스택 프로젝트 소개
   - 주요 컴포넌트 설명
 
-### ⚙️ 설치 가이드
+### 설치 가이드
 - [DevStack 설치 가이드](lectures/ch2/ch2_1_lec.qmd)
   - 개발 및 테스트 환경 구성
   - 단일 노드 설치 방법
 - [Kolla-Ansible 설치 가이드](lectures/ch2/ch2_2_lec.qmd)
   - 프로덕션 환경 구성
   - 멀티 노드 클러스터 구축
 
-### 👥 커뮤니티 활동
+### 커뮤니티 활동
 - [Discord](https://discord.gg/3ZzKMJKtPg)에서 실시간 대화에 참여하세요
 - [커뮤니티 포럼](https://forum.openinfra-kr.org/)에서 질문하고 답변하세요