README.md

OpenStack 실습 데모 페이지 with Quarto

Quarto를 이용한 OpenStack Korea Community 웹사이트 프로젝트입니다.

프로젝트 구조

.
├── _quarto.yml     # Quarto 설정 파일
├── index.qmd       # 메인 페이지
├── guides/         # 실습 가이드
│   ├── basic.qmd   # 기본 실습
│   └── advanced.qmd # 고급 실습
├── lectures/       # 강의 자료
│   └── index.qmd
├── community.qmd   # 커뮤니티 페이지
├── styles.css      # 커스텀 스타일
└── docs/          # 빌드된 사이트 (자동 생성)

시작하기

1. Quarto 설치

# 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

2. 의존성 설치

npm install

페이지 작성 가이드

새 페이지 추가

1. .qmd 파일 생성

---
title: "페이지 제목"
---

# 내용 작성

2. _quarto.yml에 네비게이션 추가

website:
  navbar:
    left:
      - text: "새 메뉴"
        file: path/to/new.qmd

실습 가이드 작성

실습 가이드는 guides/ 디렉토리에 작성합니다. 기본 템플릿:

---
title: "실습 제목"
---

# 개요

## 준비사항

## 실습 단계

## 문제해결

강의 자료 추가

1. PDF 파일을 materials/ 디렉토리에 저장
2. lectures/index.qmd에 링크 추가

사이트 빌드 및 배포

로컬 프리뷰

quarto preview

사이트 빌드

quarto render

빌드된 파일은 docs/ 디렉토리에 생성됩니다.

GitHub Pages 배포

1. docs/ 디렉토리를 Git에 커밋
2. GitHub 저장소 설정에서 GitHub Pages 소스를 docs/ 폴더로 설정

다국어 지원

한글 콘텐츠 작성을 위해 _quarto.yml에 다음 설정이 되어있습니다:

format:
  html:
    lang: ko

기여하기

1. 이 저장소를 Fork합니다
2. 새로운 브랜치를 생성합니다
3. 변경사항을 커밋합니다
4. Pull Request를 생성합니다

문서 스타일 가이드

• 제목은 #부터 시작
• 코드 블록은 ``` 사용
• 이미지는 images/ 디렉토리에 저장
• 링크는 상대 경로 사용

도움말

• Quarto 공식 문서
• GitHub Discussions
• Slack 채널

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.