사용자 도구

사이트 도구


wiki:it:wiki:development

개발 문서

이 페이지는 DokuWiki 개발 및 관련 기술 문서들을 모아놓은 곳입니다.

주요 개발 프로젝트

개발 도구 및 환경

API 및 외부 서비스

개발된 플러그인

  • geminidraft: Gemini API 기반 AI 초안 생성 플러그인
    • AI 초안 생성 및 텍스트 수정 기능
    • 사용량 제한 (분당 10회, 일일 500회)
    • 반응형 디자인 지원
  • floatingnewpost: 플로팅 새글 작성 버튼 플러그인

개발 환경 구성

로컬 개발 환경

  • XAMPP: 로컬 웹서버 환경
  • Git: 버전 관리 시스템
  • VS Code: 코드 에디터
  • Cursor AI: AI 기반 개발 도구

서버 배포 환경

  • 라즈베리파이: 서버 호스팅
  • Apache: 웹서버
  • PHP: 서버 사이드 스크립트
  • Git: 자동 동기화

협업 워크플로우

  • PC: 콘텐츠 대량 생산 (AI 활용)
  • 서버: 팀 협업 공간
  • GitHub: 중앙 저장소
  • 자동 동기화: 5분마다 자동 업데이트

기술 스택

백엔드 기술

  • PHP: 서버 사이드 언어
  • DokuWiki: 위키 엔진
  • MySQL: 데이터베이스 (선택사항)
  • Apache: 웹서버

프론트엔드 기술

  • HTML/CSS: 마크업 및 스타일링
  • JavaScript: 클라이언트 사이드 스크립트
  • jQuery: JavaScript 라이브러리
  • AJAX: 비동기 통신

AI 및 외부 서비스

  • Google Gemini API: AI 모델
  • cURL: HTTP 통신
  • JSON: 데이터 형식
  • REST API: API 통신

개발 프로세스

1. 환경 설정

1. **로컬 환경 구축**: XAMPP 설치 및 설정
2. **Git 저장소 초기화**: 버전 관리 시작
3. **GitHub 연결**: 원격 저장소 설정
4. **서버 배포**: 라즈베리파이에 배포

2. 플러그인 개발

1. **요구사항 분석**: 기능 정의 및 설계
2. **플러그인 구조 생성**: 기본 파일 생성
3. **백엔드 로직 구현**: PHP 코드 작성
4. **프론트엔드 개발**: JavaScript/CSS 작성
5. **테스트 및 디버깅**: 기능 검증
6. **배포 및 문서화**: 설치 가이드 작성

3. 콘텐츠 관리

1. **AI 활용 콘텐츠 생성**: Cursor AI로 대량 생성
2. **수동 편집 및 보완**: 팀원들의 추가 작업
3. **자동 동기화**: Git을 통한 실시간 업데이트
4. **백업 및 버전 관리**: 안전한 데이터 관리

문제 해결

일반적인 문제들

  • CSS 스타일링 문제: 우선순위 및 캐시 이슈
  • API 통신 오류: 네트워크 및 인증 문제
  • 플러그인 로딩 실패: 파일 권한 및 구조 문제
  • 동기화 충돌: Git merge 충돌 해결

디버깅 도구

  • 브라우저 개발자 도구: F12 키로 접근
  • PHP 오류 로그: 서버 오류 확인
  • DokuWiki 디버그 모드: 상세 오류 정보
  • Git 로그: 변경사항 추적

최근 업데이트

  • 2024-07-30: Gemini API 연동 플러그인 개발 완료
  • 2024-07-30: Floating New Post 플러그인 개발 완료
  • 2024-07-30: DokuWiki 개발 환경 구축
  • 2024-07-30: CSS 트러블슈팅 가이드 작성
  • 2024-07-30: 협업 워크플로우 구축 완료

관련 링크

wiki/it/wiki/development.txt · 마지막으로 수정됨: 저자 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki