ddd

원 장 wrote:

레드마인 텍스트 포맷 Textile → Markdown 전환 계획¶

현황¶

• 현재 레드마인 텍스트 포맷: Textile (jsToolBar 기반)
• 대상 시스템: ****
• 기존 게시물 성격: 텍스트 + 이미지 첨부 위주

---

전환 시 영향 분석¶

문법 차이 비교¶

기능	Textile (현재)	Markdown (변경 후)
굵게	*굵게*	**굵게**
기울임	_기울임_	*기울임*
제목	h1. 제목	# 제목
링크	"링크":http://url	[링크](http://url)
이미지 (인라인)	!파일명!	
인용	??인용??	> 인용
취소선	-취소선-	~~취소선~~

영향 범위 판단¶

• 일반 텍스트: 영향 없음 (Textile/Markdown 모두 그대로 표시)
• 파일 첨부 이미지: 영향 없음
• 인라인 이미지 (!파일명! 문법 사용): 깨짐 발생 가능
• 위키 페이지: 서식 사용 시 깨짐 가능성 높음
• 일감(Issue) 본문: 텍스트+첨부 위주이므로 영향 미미

결론: 기존 게시물이 텍스트+이미지 첨부 위주이므로 전환 시 실질적 피해 낮음

---

전환 절차¶

1단계: 사전 준비¶

• DB 전체 백업
• 위키 페이지 서식 사용 현황 확인 (위험도 높은 항목 파악)
• 레드마인 API 키 발급 (계정 설정 → API 액세스 키)
• 팀 전체 공지 및 일정 협의

2단계: 기존 게시물 일괄 변환 (선택)¶

텍스트+이미지 위주라면 생략 가능. 위키 등 서식이 복잡한 경우 아래 스크립트 방식 활용.

자동 변환 흐름:

1. 레드마인 REST API로 모든 일감 / 위키 본문 가져오기
2. AI(Claude API 등)를 활용해 Textile → Markdown 변환
3. 변환된 내용을 레드마인 API로 PUT 요청하여 저장

# 예시 (Python)
import requests

REDMINE_URL = "https://redmine.k-auction.com/redmine"
API_KEY = "YOUR_API_KEY"

# 일감 목록 가져오기
issues = requests.get(f"{REDMINE_URL}/issues.json", 
    headers={"X-Redmine-API-Key": API_KEY}).json()

for issue in issues["issues"]:
    original = issue["description"]
    # AI로 Textile → Markdown 변환
    converted = convert_with_ai(original)
    # 변환 내용 저장
    requests.put(f"{REDMINE_URL}/issues/{issue['id']}.json",
        headers={"X-Redmine-API-Key": API_KEY},
        json={"issue": {"description": converted}})

3단계: 포맷 설정 변경¶

관리자 계정으로 아래 경로에서 변경:
관리 → 설정 → 일반 → 텍스트 서식 → Textile → Markdown → 저장

4단계: 검증¶

• 주요 일감 본문 표시 확인
• 위키 페이지 표시 확인
• 새 게시물 Markdown 문법 정상 동작 확인
• 팀원 대상 Markdown 문법 간단 안내

---

주의사항¶

• 설정 변경은 전체 레드마인 인스턴스에 적용됨
• 변환 스크립트 실행 전 반드시 백업 필요
• API 요청 횟수 제한(Rate Limit) 고려 필요
• 관리자 권한 필요