Developer Portal Menu Management
개요
이 튜토리얼은 개발자 포털의 탐색 메뉴 구조를 관리하는 방법을 안내합니다. 상단 탐색 바에 대해 다단계 메뉴를 구성하고, 각 항목을 콘텐츠나 URL에 연결하며, 터미널 메뉴 노드에 대한 자세한 HTML 기반 페이지를 작성할 수 있습니다. 이 구조는 최대 3단계 깊이를 지원합니다.
전제 조건
메뉴 관리를 사용하려면:
- 관리자 액세스 권한이 있어야 합니다.
- 다음으로 이동: 관리 > 메뉴 관리
단계별 튜토리얼
단계 1. 메뉴 계층 구조 이해하기
메뉴는 여러 수준으로 구성됩니다:
- 수준 1: 상단 탐색 (예: 제품, 애플리케이션, 문서, 포럼)
- 수준 2: 하위 메뉴 그룹 (예: 모든 API, 펜 테스트)
- 수준 3: 터미널 노드 (예: Ver.1, 가이드), 여기에서 콘텐츠를 추가할 수 있습니다.
수준 3 메뉴만 편집 가능한 콘텐츠 페이지를 가질 수 있습니다.
단계 2. 메뉴 항목 추가 또는 편집
A. 새 메뉴 항목 추가:
- 원하는 상위 메뉴 옆의 + 아이콘을 클릭합니다.
- 메뉴 제목을 입력합니다 (예: 사용자 가이드).
- 가시성을 선택합니다 (표시 / 숨김).
- 등록을 클릭합니다.
B. 기존 항목 편집:
- 메뉴 옆의 연필 아이콘을 클릭합니다.
- 필요에 따라 이름을 변경하거나 순서를 재조정합니다.
- 적용을 위해 저장을 클릭합니다.
단계 3. 메뉴 콘텐츠 작성 또는 편집 (수준 3 전용)
터미널 노드의 콘텐츠를 편집하려면:
- 문서 > Ver.1과 같은 메뉴를 선택합니다.
- 오른쪽 창에 입력합니다:
| Field | Example |
| --- | --- |
| 제목 | Ver. 1
| | 가시성 | 체크됨 | | 콘텐츠 | 리치 텍스트 (HTML 편집기) |
리치 콘텐츠 예시:
# API 온보딩 프로세스
## 1. 애플리케이션 등록
**애플리케이션 > 내 애플리케이션** 섹션에서 애플리케이션에 가입하고 등록합니다.
## 2. IP 리퍼러 설정 및 액세스 요청
IP 참조자를 구성하고 **애플리케이션 > 내 애플리케이션 > API 사용량**을 통해 API 사용 요청을 제출하세요.
## 3. API 테스트 및 사용
승인되면 **테스트** 탭에서 API를 테스트하거나 실제 사용을 시작하세요.
## 4. 팀원 관리
**애플리케이션 > 내 애플리케이션 > 구성원**에서 등록된 애플리케이션에 팀원을 추가하세요.
이미지 또는 파일 추가:
- 이미지 추가 또는 파일 추가 버튼을 사용하세요.
- 업로드된 파일은 편집기 아래에 나타나며 콘텐츠에 첨부할 수 있습니다.
편집기는 헤더, 서식, 링크, 테이블 및 인라인 HTML을 지원합니다.
4단계. 메뉴 콘텐츠 저장
- 편집이 완료되면 콘텐츠 창 하단의 저장 버튼을 클릭하세요.
- 개발자 포털을 방문할 때 콘텐츠가 올바르게 렌더링되는지 확인하세요.
모범 사례
- API 및 가이드를 구성하기 위해 명확하고 계층적인 구조를 사용하세요.
- 도메인 또는 제품 라인별로 API 참조를 그룹화하세요 (예: /AI, /Security, /OpenAPI).
- 메뉴 제목을 간결하게 유지하세요 (가독성을 위해 25자 이하).
- HTML 편집기를 사용하여 헤더, 링크 및 스타일링으로 가독성을 향상시키세요.
- 정기적으로 끊어진 링크나 오래된 콘텐츠를 검토하세요.