From b60aa517b90ae3afee3fe13ee29a0dd75c4f6713 Mon Sep 17 00:00:00 2001
From: sanjeok77-tech <sanjeok77@gmail.com>
Date: Sun, 22 Feb 2026 14:30:22 +0900
Subject: [PATCH] Add GitLab Wiki guide

---
 docs/gitlab-wiki-guide.md | 107 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 107 insertions(+)
 create mode 100644 docs/gitlab-wiki-guide.md

diff --git a/docs/gitlab-wiki-guide.md b/docs/gitlab-wiki-guide.md
new file mode 100644
index 0000000..4e386a8
--- /dev/null
+++ b/docs/gitlab-wiki-guide.md
@@ -0,0 +1,107 @@
+# GitLab Wiki 설정 가이드
+
+## 개요
+
+GitLab Wiki는 저장소와 별도로 관리되며, 마크다운 파일로 작성합니다.
+
+## 시작하기
+
+### 1. Wiki 저장소 클론
+
+```bash
+git clone git@git.webpluss.net:username/project.wiki.git
+cd project.wiki
+```
+
+### 2. 마크다운 파일 작성
+
+```bash
+touch my-page.md
+# 마크다운 작성 후
+git add .
+git commit -m "Add wiki page"
+git push
+```
+
+## SSH 키 설정 (권장)
+
+### 1. SSH 키 생성 (없는 경우)
+
+```bash
+ssh-keygen -t ed25519 -C "your_email@example.com"
+```
+
+### 2. GitLab에 SSH 키 추가
+
+- GitLab → Settings → SSH Keys
+- `~/.ssh/id_ed25519.pub` 내용 복사해서 추가
+
+### 3. remote 설정
+
+```bash
+git remote set-url origin git@git.webpluss.net:username/project.git
+```
+
+## HTTPS 사용 시 (토큰 방식)
+
+### 1. Personal Access Token 생성
+
+- GitLab → Settings → Access Tokens
+- 이름: `git_push`
+- 스코프: `api`
+- 만료일: 적절히 설정
+
+### 2. 토큰으로 푸시
+
+```bash
+git remote set-url origin https://username:TOKEN@git.webpluss.net/username/project.git
+git push -u origin main
+```
+
+### 3. 토큰 숨기기 (보안)
+
+```bash
+# URL에서 토큰 제거
+git remote set-url origin https://username@git.webpluss.net/username/project.git
+
+# credential.helper로 토큰 저장
+git config credential.helper store
+
+# 이후 푸시 시 토큰 자동 입력됨
+git push
+```
+
+## 저장소 내 문서 폴더 방식
+
+Wiki 저장소 접근이 어려운 경우, `docs/` 폴더를 사용할 수 있습니다.
+
+```bash
+mkdir docs
+echo "# 프로젝트 문서" > docs/home.md
+git add docs/
+git commit -m "Add documentation"
+git push
+```
+
+## 마크다운 문법
+
+```markdown
+# 제목
+## 부제목
+
+- 목록 项
+- [링크](url)
+
+**굵게** *기울임*
+
+코드:
+```javascript
+console.log('hello');
+```
+```
+
+## 참고
+
+- GitLab Wiki는 `.md` 파일만 지원
+- 파일명이 페이지 URL이 됨 (home.md → /home)
+- 사이드바는 GitLab이 자동으로 생성