feat: Sidebar 의 Page 정렬 순서 제어

scripts/confluence_xhtml_to_markdown.py

@@ -1617,6 +1617,7 @@ def _pos(item: dict) -> int:
                 os.makedirs(meta_dir, exist_ok=True)
 
                 entries: List[str] = []
+                order_counter = 1
                 for child in ordered:
                     if not isinstance(child, dict):
                         continue
@@ -1650,7 +1651,8 @@ def _pos(item: dict) -> int:
 
                     key_repr = f"'{slug_key}'"
                     title_repr = (title or '').replace("'", "\\'")
-                    entries.append(f"  {key_repr}: '{title_repr}',")
+                    entries.append(f"  {key_repr}: {{ title: '{title_repr}', order: {order_counter} }},")
+                    order_counter += 1
 
                 if entries:
                     meta_path = os.path.join(meta_dir, '_meta.ts')

src/app/[lang]/layout.tsx

@@ -80,7 +80,32 @@ export default async function RootLayout({ children, params }) {
             content: '',
             labels: '',
           }}
-          sidebar={{ defaultMenuCollapseLevel: 1 }}
+          sidebar={{ 
+            defaultMenuCollapseLevel: 1,
+            // Custom sort function to use order property from _meta.ts files
+            sort: (a, b) => {
+              // Get order from meta data if available
+              const getOrder = (item) => {
+                // Check if item has meta with order property
+                if (item.meta && typeof item.meta.order === 'number') {
+                  return item.meta.order;
+                }
+                // Fallback to 999 for items without order
+                return 999;
+              };
+
+              const orderA = getOrder(a);
+              const orderB = getOrder(b);
+
+              // Sort by order first
+              if (orderA !== orderB) {
+                return orderA - orderB;
+              }
+
+              // If same order, sort alphabetically by title
+              return (a.title || '').localeCompare(b.title || '');
+            }
+          }}
           pageMap={pageMap}
           i18n={[
             { locale: 'en', name: 'English' },

src/content/en/_meta.ts

@@ -5,27 +5,33 @@ export default {
   'querypie-overview': {
     type: 'page',
     title: 'Overview',
+    order: 1,
   },
   'user-manual': {
     type: 'page',
     title: 'User Manual',
+    order: 2,
   },
   'administrator-manual': {
     type: 'page',
     title: 'Administrator Manual',
+    order: 3,
   },
   'release-notes': {
     type: 'page',
     title: 'Release Notes',
+    order: 4,
   },
   aiHubManual: {
     type: 'page',
     title: 'AI Hub Manual',
     href: 'https://aihub-docs.app.querypie.com/en',
+    order: 5,
   },
   contactUs: {
     type: 'page',
     title: 'Contact Us',
     href: 'https://www.querypie.com/company/contact-us',
+    order: 6,
   },
 };

src/content/en/administrator-manual/_meta.ts

@@ -1,9 +1,9 @@
 export default {
-  'general': 'General',
-  'databases': 'Databases',
-  'servers': 'Servers',
-  'kubernetes': 'Kubernetes',
-  'web-apps': 'Web Apps',
-  'audit': 'Audit',
-  'multi-agent-limitations': 'Multi Agent Limitations',
+  'general': { title: 'General', order: 1 },
+  'databases': { title: 'Databases', order: 2 },
+  'servers': { title: 'Servers', order: 3 },
+  'kubernetes': { title: 'Kubernetes', order: 4 },
+  'web-apps': { title: 'Web Apps', order: 5 },
+  'audit': { title: 'Audit', order: 6 },
+  'multi-agent-limitations': { title: 'Multi Agent Limitations', order: 7 },
 };

src/content/en/release-notes/_meta.ts

@@ -1,22 +1,22 @@
 export default {
-  '1120': '11.2.0',
-  '1110-1112': '11.1.0 ~ 11.1.2',
-  '1100': '11.0.0',
-  '1030-1034': '10.3.0 ~ 10.3.4',
-  '1020-10212': '10.2.0 ~ 10.2.12',
-  '1010-10111': '10.1.0 ~ 10.1.11',
-  '1000-1002': '10.0.0 ~ 10.0.2',
-  '9200-9202': '9.20.0 ~ 9.20.2',
-  '9190': '9.19.0 ',
-  '9180-9183': '9.18.0 ~ 9.18.3',
-  '9170-9171': '9.17.0 ~ 9.17.1',
-  '9160-9164': '9.16.0 ~ 9.16.4',
-  '9150-9154': '9.15.0 ~ 9.15.4',
-  '9140-9143': '9.14.0 ~ 9.14.3',
-  '9130-9135': '9.13.0 ~ 9.13.5',
-  '9120-91214': '9.12.0 ~ 9.12.14',
-  '9110-9115': '9.11.0 ~ 9.11.5',
-  '9100-9104': '9.10.0 - 9.10.4',
-  '990-998': '9.9.0 ~ 9.9.8',
-  '980-9812': '9.8.0 ~ 9.8.12',
+  '1120': { title: '11.2.0', order: 1 },
+  '1110-1112': { title: '11.1.0 ~ 11.1.2', order: 2 },
+  '1100': { title: '11.0.0', order: 3 },
+  '9190': { title: '9.19.0', order: 4 },
+  '1030-1034': { title: '10.3.0 ~ 10.3.4', order: 5 },
+  '1020-10212': { title: '10.2.0 ~ 10.2.12', order: 6 },
+  '1010-10111': { title: '10.1.0 ~ 10.1.11', order: 7 },
+  '1000-1002': { title: '10.0.0 ~ 10.0.2', order: 8 },
+  '9200-9202': { title: '9.20.0 ~ 9.20.2', order: 9 },
+  '9180-9183': { title: '9.18.0 ~ 9.18.3', order: 10 },
+  '9170-9171': { title: '9.17.0 ~ 9.17.1', order: 11 },
+  '9160-9164': { title: '9.16.0 ~ 9.16.4', order: 12 },
+  '9150-9154': { title: '9.15.0 ~ 9.15.4', order: 13 },
+  '9140-9143': { title: '9.14.0 ~ 9.14.3', order: 14 },
+  '9130-9135': { title: '9.13.0 ~ 9.13.5', order: 15 },
+  '9120-91214': { title: '9.12.0 ~ 9.12.14', order: 16 },
+  '9110-9115': { title: '9.11.0 ~ 9.11.5', order: 17 },
+  '9100-9104': { title: '9.10.0 - 9.10.4', order: 18 },
+  '990-998': { title: '9.9.0 ~ 9.9.8', order: 19 },
+  '980-9812': { title: '9.8.0 ~ 9.8.12', order: 20 },
 };

src/content/en/user-manual/_meta.ts

@@ -1,11 +1,11 @@
 export default {
-  'my-dashboard': 'My Dashboard',
-  'workflow': 'Workflow',
-  'database-access-control': 'Database Access Control',
-  'server-access-control': 'Server Access Control',
-  'kubernetes-access-control': 'Kubernetes Access Control',
-  'web-access-control': 'Web Access Control',
-  'preferences': 'Preferences',
-  'user-agent': 'User Agent',
-  'multi-agent': 'Multi Agent',
+  'my-dashboard': { title: 'My Dashboard', order: 1 },
+  'workflow': { title: 'Workflow', order: 2 },
+  'database-access-control': { title: 'Database Access Control', order: 3 },
+  'server-access-control': { title: 'Server Access Control', order: 4 },
+  'kubernetes-access-control': { title: 'Kubernetes Access Control', order: 5 },
+  'web-access-control': { title: 'Web Access Control', order: 6 },
+  'preferences': { title: 'Preferences', order: 7 },
+  'user-agent': { title: 'User Agent', order: 8 },
+  'multi-agent': { title: 'Multi Agent', order: 9 },
 };

src/content/ja/_meta.ts

@@ -5,27 +5,33 @@ export default {
   'querypie-overview': {
     type: 'page',
     title: '概要',
+    order: 1,
   },
   'user-manual': {
     type: 'page',
     title: 'ユーザーガイド',
+    order: 2,
   },
   'administrator-manual': {
     type: 'page',
     title: '管理者マニュアル',
+    order: 3,
   },
   'release-notes': {
     type: 'page',
     title: 'リリースノート',
+    order: 4,
   },
   aiHubManual: {
     type: 'page',
     title: 'AI Hub マニュアル',
     href: 'https://aihub-docs.app.querypie.com/ja',
+    order: 5,
   },
   contactUs: {
     type: 'page',
     title: 'お問い合わせ',
     href: 'https://www.querypie.com/company/contact-us',
+    order: 6,
   },
 };

src/content/ja/administrator-manual/_meta.ts

@@ -1,9 +1,9 @@
 export default {
-  'general': 'General',
-  'databases': 'Databases',
-  'servers': 'Servers',
-  'kubernetes': 'Kubernetes',
-  'web-apps': 'Web Apps',
-  'audit': 'Audit',
-  'multi-agent-limitations': 'Multi Agent 制約事項',
+  'general': { title: 'General', order: 1 },
+  'databases': { title: 'Databases', order: 2 },
+  'servers': { title: 'Servers', order: 3 },
+  'kubernetes': { title: 'Kubernetes', order: 4 },
+  'web-apps': { title: 'Web Apps', order: 5 },
+  'audit': { title: 'Audit', order: 6 },
+  'multi-agent-limitations': { title: 'Multi Agent 制約事項', order: 7 },
 };

src/content/ja/release-notes/_meta.ts

@@ -1,22 +1,22 @@
 export default {
-  '1120': '11.2.0',
-  '1110-1112': '11.1.0 ~ 11.1.2',
-  '1100': '11.0.0',
-  '1030-1034': '10.3.0 ~ 10.3.4',
-  '1020-10212': '10.2.0 ~ 10.2.12',
-  '1010-10111': '10.1.0 ~ 10.1.11',
-  '1000-1002': '10.0.0 ~ 10.0.2',
-  '9200-9202': '9.20.0 ~ 9.20.2',
-  '9190': '9.19.0 ',
-  '9180-9183': '9.18.0 ~ 9.18.3',
-  '9170-9171': '9.17.0 ~ 9.17.1',
-  '9160-9164': '9.16.0 ~ 9.16.4',
-  '9150-9154': '9.15.0 ~ 9.15.4',
-  '9140-9143': '9.14.0 ~ 9.14.3',
-  '9130-9135': '9.13.0 ~ 9.13.5',
-  '9120-91214': '9.12.0 ~ 9.12.14',
-  '9110-9115': '9.11.0 ~ 9.11.5',
-  '9100-9104': '9.10.0 - 9.10.4',
-  '990-998': '9.9.0 ~ 9.9.8',
-  '980-9812': '9.8.0 ~ 9.8.12',
+  '1120': { title: '11.2.0', order: 1 },
+  '1110-1112': { title: '11.1.0 ~ 11.1.2', order: 2 },
+  '1100': { title: '11.0.0', order: 3 },
+  '9190': { title: '9.19.0', order: 4 },
+  '1030-1034': { title: '10.3.0 ~ 10.3.4', order: 5 },
+  '1020-10212': { title: '10.2.0 ~ 10.2.12', order: 6 },
+  '1010-10111': { title: '10.1.0 ~ 10.1.11', order: 7 },
+  '1000-1002': { title: '10.0.0 ~ 10.0.2', order: 8 },
+  '9200-9202': { title: '9.20.0 ~ 9.20.2', order: 9 },
+  '9180-9183': { title: '9.18.0 ~ 9.18.3', order: 10 },
+  '9170-9171': { title: '9.17.0 ~ 9.17.1', order: 11 },
+  '9160-9164': { title: '9.16.0 ~ 9.16.4', order: 12 },
+  '9150-9154': { title: '9.15.0 ~ 9.15.4', order: 13 },
+  '9140-9143': { title: '9.14.0 ~ 9.14.3', order: 14 },
+  '9130-9135': { title: '9.13.0 ~ 9.13.5', order: 15 },
+  '9120-91214': { title: '9.12.0 ~ 9.12.14', order: 16 },
+  '9110-9115': { title: '9.11.0 ~ 9.11.5', order: 17 },
+  '9100-9104': { title: '9.10.0 - 9.10.4', order: 18 },
+  '990-998': { title: '9.9.0 ~ 9.9.8', order: 19 },
+  '980-9812': { title: '9.8.0 ~ 9.8.12', order: 20 },
 };

src/content/ja/user-manual/_meta.ts

@@ -1,11 +1,11 @@
 export default {
-  'my-dashboard': 'My Dashboard',
-  'workflow': 'Workflow',
-  'database-access-control': 'Database Access Control',
-  'server-access-control': 'Server Access Control',
-  'kubernetes-access-control': 'Kubernetes Access Control',
-  'web-access-control': 'Web Access Control',
-  'preferences': 'Preferences',
-  'user-agent': 'User Agent',
-  'multi-agent': 'Multi Agent',
+  'my-dashboard': { title: 'My Dashboard', order: 1 },
+  'workflow': { title: 'Workflow', order: 2 },
+  'database-access-control': { title: 'Database Access Control', order: 3 },
+  'server-access-control': { title: 'Server Access Control', order: 4 },
+  'kubernetes-access-control': { title: 'Kubernetes Access Control', order: 5 },
+  'web-access-control': { title: 'Web Access Control', order: 6 },
+  'preferences': { title: 'Preferences', order: 7 },
+  'user-agent': { title: 'User Agent', order: 8 },
+  'multi-agent': { title: 'Multi Agent', order: 9 },
 };

src/content/ko/_meta.ts

@@ -5,27 +5,33 @@ export default {
   'querypie-overview': {
     type: 'page',
     title: 'QueryPie Overview',
+    order: 1,
   },
   'user-manual': {
     type: 'page',
     title: '사용자 매뉴얼',
+    order: 2,
   },
   'administrator-manual': {
     type: 'page',
     title: '관리자 매뉴얼',
+    order: 3,
   },
   'release-notes': {
     type: 'page',
     title: '릴리즈 노트',
+    order: 4,
   },
   aiHubManual: {
     type: 'page',
     title: 'AI Hub 매뉴얼',
     href: 'https://aihub-docs.app.querypie.com/ko',
+    order: 5,
   },
   contactUs: {
     type: 'page',
     title: '문의하기',
     href: 'https://www.querypie.com/company/contact-us',
+    order: 6,
   },
 };

src/content/ko/administrator-manual/_meta.ts

@@ -1,9 +1,9 @@
 export default {
-  'general': 'General',
-  'databases': 'Databases',
-  'servers': 'Servers',
-  'kubernetes': 'Kubernetes',
-  'web-apps': 'Web Apps',
-  'audit': 'Audit',
-  'multi-agent-limitations': 'Multi Agent 제약사항',
+  'general': { title: 'General', order: 1 },
+  'databases': { title: 'Databases', order: 2 },
+  'servers': { title: 'Servers', order: 3 },
+  'kubernetes': { title: 'Kubernetes', order: 4 },
+  'web-apps': { title: 'Web Apps', order: 5 },
+  'audit': { title: 'Audit', order: 6 },
+  'multi-agent-limitations': { title: 'Multi Agent 제약사항', order: 7 },
 };

src/content/ko/administrator-manual/audit/_meta.ts

@@ -1,8 +1,8 @@
 export default {
-  'reports': 'Reports',
-  'general-logs': 'General Logs',
-  'database-logs': 'Database Logs',
-  'server-logs': 'Server Logs',
-  'kubernetes-logs': 'Kubernetes Logs',
-  'web-app-logs': 'Web App Logs',
+  'reports': { title: 'Reports', order: 1 },
+  'general-logs': { title: 'General Logs', order: 2 },
+  'database-logs': { title: 'Database Logs', order: 3 },
+  'server-logs': { title: 'Server Logs', order: 4 },
+  'kubernetes-logs': { title: 'Kubernetes Logs', order: 5 },
+  'web-app-logs': { title: 'Web App Logs', order: 6 },
 };

src/content/ko/administrator-manual/audit/database-logs/_meta.ts

@@ -1,10 +1,10 @@
 export default {
-  'db-access-history': 'DB Access History',
-  'query-audit': 'Query Audit',
-  'running-queries': 'Running Queries',
-  'dml-snapshots': 'DML Snapshots',
-  'account-lock-history': 'Account Lock History',
-  'access-control-logs': 'Access Control Logs',
-  'policy-audit-logs': 'Policy Audit Logs',
-  'policy-exception-logs': 'Policy Exception logs',
+  'db-access-history': { title: 'DB Access History', order: 1 },
+  'query-audit': { title: 'Query Audit', order: 2 },
+  'running-queries': { title: 'Running Queries', order: 3 },
+  'dml-snapshots': { title: 'DML Snapshots', order: 4 },
+  'account-lock-history': { title: 'Account Lock History', order: 5 },
+  'access-control-logs': { title: 'Access Control Logs', order: 6 },
+  'policy-audit-logs': { title: 'Policy Audit Logs', order: 7 },
+  'policy-exception-logs': { title: 'Policy Exception logs', order: 8 },
 };

src/content/ko/administrator-manual/audit/general-logs/_meta.ts

@@ -1,7 +1,7 @@
 export default {
-  'user-access-history': 'User Access History',
-  'activity-logs': 'Activity Logs',
-  'admin-role-history': 'Admin Role History',
-  'workflow-logs': 'Workflow Logs',
-  'reverse-tunnels': 'Reverse Tunnels',
+  'user-access-history': { title: 'User Access History', order: 1 },
+  'activity-logs': { title: 'Activity Logs', order: 2 },
+  'admin-role-history': { title: 'Admin Role History', order: 3 },
+  'workflow-logs': { title: 'Workflow Logs', order: 4 },
+  'reverse-tunnels': { title: 'Reverse Tunnels', order: 5 },
 };

src/content/ko/administrator-manual/audit/general-logs/reverse-tunnels/_meta.ts

@@ -1,5 +1,5 @@
 export default {
-  'communicating-with-servers-through-reverse-tunnel': 'Reverse Tunnel을 통해 서버에 통신하기',
-  'communicating-with-clusters-through-reverse-tunnel': 'Reverse Tunnel을 통해 클러스터에 통신하기',
-  'communicating-with-db-through-reverse-tunnel': 'Reverse Tunnel을 통해 DB에 통신하기',
+  'communicating-with-servers-through-reverse-tunnel': { title: 'Reverse Tunnel을 통해 서버에 통신하기', order: 1 },
+  'communicating-with-clusters-through-reverse-tunnel': { title: 'Reverse Tunnel을 통해 클러스터에 통신하기', order: 2 },
+  'communicating-with-db-through-reverse-tunnel': { title: 'Reverse Tunnel을 통해 DB에 통신하기', order: 3 },
 };

src/content/ko/administrator-manual/audit/kubernetes-logs/_meta.ts

@@ -1,5 +1,5 @@
 export default {
-  'request-audit': 'Request Audit',
-  'pod-session-recordings': 'Pod Session Recordings',
-  'kubernetes-role-history': 'Kubernetes Role History',
+  'request-audit': { title: 'Request Audit', order: 1 },
+  'pod-session-recordings': { title: 'Pod Session Recordings', order: 2 },
+  'kubernetes-role-history': { title: 'Kubernetes Role History', order: 3 },
 };