improve document css

Author: binary-husky

docs/en/installation.md

@@ -126,7 +126,25 @@ AgentJet supports multiple backbones, you can choose any of them depending on yo
 | vLLM Version   | 0.10.0 |     0.10.0         |
 
 
+## Deploy with docker
 
+The docker solution is recommanded when you are using **AgentJet Swarm** mode!
+
+Simply run:
+
+```bash
+docker run --rm -it \
+  -v /path/to/host/Qwen/Qwen2.5-7B-Instruct:/Qwen/Qwen2.5-7B-Instruct \
+  -v ./swarmlog:/workspace/log \
+  -v ./swarmexp:/workspace/saved_experiments \
+  -p 10086:10086 \
+  --gpus=all \
+  --shm-size=32GB \
+  ghcr.io/modelscope/agentjet:main \
+  bash -c "(ajet-swarm overwatch) & (NO_COLOR=1 LOGURU_COLORIZE=NO ajet-swarm start &>/workspace/log/swarm_server.log)"
+```
+
+to start the swarm server. For more details and explainations, please refer to [this document](./ajet-swarm-docker.md).
 
 
 ## Next Steps

docs/en/intro.md

@@ -30,16 +30,17 @@ article ul>li {
 a[data-sidebar="menu-button"] {
     font-size: 17px;
     font-weight: 300;
-    margin-bottom: 12px;
+    margin-bottom: 6px;
 }
 
 .pr-2 {
     font-size: 20px;
 }
 
 .text-muted-foreground {
-    font-size: 15px;
+    font-size: 17px;
     color: var(--color-muted-foreground);
+    margin-bottom: 12px;
 }
 
 article .typography h2 {
@@ -60,6 +61,12 @@ article .typography h2 {
     white-space: nowrap !important;
 }
 
+/* 如果你可以添加自定义类 */
+[data-slot="sidebar-menu"] {
+  padding-left: 10px;
+}
+
+
 /* 方法3：如果上面不生效，使用更具体的选择器 */
 div[data-slot="sidebar-content"].no-scrollbar {
     scrollbar-width: thin !important;

docs/stylesheets/responsive.css

@@ -17,7 +17,8 @@
 
 article table,
 .prose table,
-.md-typeset table:not([class]) {
+.md-typeset table:not([class]),
+table {
   width: 100%;
   border-collapse: separate;
   border-spacing: 0;
@@ -27,6 +28,7 @@ article table,
   overflow: hidden;
   border: 1px solid var(--border, #e5e7eb);
   border-radius: var(--radius-lg, 0.5rem);
+  table-layout: auto;
 }
 
 /* ========================================
@@ -48,7 +50,11 @@ article table th,
   text-align: left;
   color: var(--foreground, #111827);
   border-bottom: 1px solid var(--border, #e5e7eb);
-  white-space: nowrap;
+  white-space: normal !important;
+  word-wrap: break-word !important;
+  word-break: break-word !important;
+  max-width: 400px;
+  overflow-wrap: break-word;
 }
 
 /* First header cell - round top-left corner */
@@ -77,6 +83,11 @@ article table td,
   color: var(--foreground, #374151);
   border-bottom: 1px solid var(--border, #e5e7eb);
   line-height: 1.5;
+  white-space: normal !important;
+  word-wrap: break-word !important;
+  word-break: break-word !important;
+  max-width: 400px;
+  overflow-wrap: break-word;
 }
 
 /* Remove border from last row */
@@ -310,7 +321,6 @@ article table.wide,
   .md-typeset table:not([class]) th,
   .md-typeset table:not([class]) td {
     padding: 0.625rem 0.75rem;
-    white-space: nowrap;
   }
 
   article table th,
@@ -319,3 +329,28 @@ article table.wide,
     font-size: 0.8125rem;
   }
 }
+
+/* ========================================
+   强制文本换行 - 覆盖所有可能的样式
+   ======================================== */
+
+table th,
+table td {
+  white-space: normal !important;
+  word-wrap: break-word !important;
+  word-break: break-word !important;
+  overflow-wrap: break-word !important;
+}
+
+/* 为中文长文本优化 */
+table td {
+  max-width: 400px;
+  min-width: 120px;
+}
+
+/* 第一列（特性列）可以窄一些 */
+table td:first-child,
+table th:first-child {
+  max-width: 150px;
+  min-width: 100px;
+}

docs/stylesheets/table-enhancements.css

@@ -0,0 +1,58 @@
+/* 
+ * 表格文本自动换行
+ * 此文件专门解决表格单元格文本溢出问题
+ * 使用最高优先级确保生效
+ */
+
+/* 全局表格设置 */
+table {
+  table-layout: auto !important;
+  width: 100% !important;
+}
+
+/* 所有表格单元格强制换行 */
+table th,
+table thead th,
+table tbody th,
+table td,
+table tbody td,
+article table th,
+article table td,
+.prose table th,
+.prose table td,
+.md-typeset table th,
+.md-typeset table td,
+.md-content table th,
+.md-content table td,
+div[class*="prose"] table th,
+div[class*="prose"] table td {
+  white-space: normal !important;
+  word-wrap: break-word !important;
+  word-break: break-word !important;
+  overflow-wrap: break-word !important;
+  hyphens: auto !important;
+  max-width: 400px !important;
+}
+
+/* 第一列可以窄一些 */
+table th:first-child,
+table td:first-child {
+  max-width: 150px !important;
+  min-width: 100px !important;
+}
+
+/* 确保表格容器不溢出 */
+.md-content__inner,
+.prose,
+article {
+  overflow-x: auto !important;
+}
+
+/* 移动端优化 */
+@media (max-width: 768px) {
+  table th,
+  table td {
+    max-width: 200px !important;
+    font-size: 0.875rem !important;
+  }
+}

docs/stylesheets/table-word-wrap.css

@@ -24,38 +24,37 @@ theme:
 nav:
   - Overview: index.md
 
-  - Tutorial:
-      - Introduction: en/intro.md
+  - • Tutorial:
       - Installation: en/installation.md
       - Quick Start: en/quickstart.md
       - Tune Your First Agent: en/tune_your_first_agent.md
       - Agentic Frameworks: en/agent_framework_support.md
       - Swarm Training: en/swarm_intro_blog_english.md
 
-  - Examples:
+  - • Classic Examples:
       - Math Agent: en/example_math_agent.md
       - AppWorld Agent: en/example_app_world.md
       - Werewolves Game: en/example_werewolves.md
       - Learning to Ask: en/example_learning_to_ask.md
       - Frozen Lake: en/example_frozenlake.md
       - Countdown Game: en/example_countdown.md
 
-  - Swarm Examples:
+  - • Swarm Examples:
       - Best Practice: en/swarm_best_practice.md
       - Swarm Vibe Coding: en/swarm_vibe_coding.md
 
-  - Components:
+  - • Components:
       - Workflow: en/workflow.md
       - Data Pipeline: en/data_pipeline.md
       - Task Judger: en/task_judger.md
 
-  - Supported Frameworks:
+  - • With Frameworks:
+      - OpenAI SDK: en/support_oaisdk.md
       - AgentScope: en/support_agentscope.md
       - Langchain: en/support_langchain.md
-      - OpenAI SDK: en/support_oaisdk.md
       - Raw HTTP: en/support_http.md
 
-  - Deep Dive:
+  - • Deep Dive:
       - Configuration: en/configuration.md
       - Visualization: en/visualization.md
       - Beast Logger: en/beast_logger.md
@@ -64,7 +63,7 @@ nav:
       - Timeline Processing: en/context_timeline.md
       - Platform Comparison: en/platform_comparison.md
 
-  - Blogs:
+  - • Blogs:
       - Swarm Intro (ZH): en/swarm_intro_blog_zh.md
       - Swarm Intro (EN): en/swarm_intro_blog_en.md
 
@@ -125,6 +124,7 @@ extra_css:
   - stylesheets/mermaid.css
   - stylesheets/mkdocstrings.css
   - stylesheets/responsive.css
+  - stylesheets/table-word-wrap.css
 
 extra_javascript:
   - javascripts/tabbed-code.js