* Batch update service apis
* final check and add zh/ja docs
* add temporary redirects for changed api links embedded in the product
* Restore original operationIds to preserve SDK compatibility
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* complete the missing descriptions
* correct the human input terminology
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: remove href from language blocks to preserve page on language switch
Mintlify's language switcher navigates to the explicit href when set,
instead of doing smart path prefix replacement. Removing href lets the
switcher stay on the current page when switching languages.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* Revert "fix: remove href from language blocks to preserve page on language switch"
This reverts commit b74b1b8291.
* fix: restructure navigation from versions>languages to languages>versions
Mintlify's language switcher only preserves the current page when
languages are the top-level navigation partition. Previously, versions
were the top level with languages nested inside, causing the switcher
to redirect to the introduction page instead of the same page in the
target language.
Also removes explicit href from language blocks and fixes ja having
default=true incorrectly in the 3.2.x version config.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: align zh/ja API spec operationIds with en for language switching
Mintlify generates page URL slugs from operationId. When operationIds
differ between languages (e.g., en: sendChatMessage vs zh:
sendBasicChatMessageCn), the language switcher can't find the
equivalent page and falls back to the introduction page.
This aligns all zh/ja operationIds to match en for endpoints that
share the same HTTP method and path.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: align OpenAPI tags across languages for consistent URL slugs
Mintlify uses OpenAPI tags to generate URL category paths (e.g., tag
"Chat" → /chat/). When zh uses "对话消息" and ja uses "チャットメッセージ",
the generated URLs differ from en's, breaking language switching.
This aligns all zh/ja OpenAPI spec tags to match en, ensuring
identical URL structures across languages.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: add x-displayName to preserve translated tag names in sidebar
Tags use English names for URL slug generation (consistent across
languages) but x-displayName holds the translated names for display
in the sidebar, so Chinese/Japanese users still see localized labels.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: use x-mint href to align API reference URLs across languages
Mintlify generates API page URLs from the tag name + summary, both of
which are translated in zh/ja specs. This produces different URL slugs
(e.g., en: /chat/send-chat-message vs zh: /对话消息/发送对话消息),
making language switching impossible.
Instead of changing the visible content (tags, summaries), this adds
x-mint: { href: ... } to each endpoint in zh/ja specs, explicitly
setting the URL path to match en. All translated content (tags,
summaries, descriptions) is preserved as-is for readers.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: add language prefix to x-mint href to prevent cross-language conflicts
Without the language prefix, zh/ja endpoints claimed the same absolute
URL as en (e.g., /api-reference/chat/send-chat-message), causing ja
content to appear on en pages. Now each language has its own prefixed
href (e.g., /zh/api-reference/chat/send-chat-message), keeping content
correctly scoped while enabling language switching.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* revert: remove all API spec changes (x-mint href, operationId, tag alignment)
These changes are breaking and need careful coordination with the dev
team before implementation. Only the navigation restructure
(versions>languages → languages>versions) is kept for this PR.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* remove all enterprise versions
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* docs(self-host): supplement missing `workflow_based_app_execution` queue for Worker service in local startup docs
Update Chinese, English and Japanese versions of self-hosted documentation by adding the missing `workflow_based_app_execution` queue to the Celery worker startup command.
* add missing `dataset_summary` and `retention` queues to worker startup command
* add missing `dataset_summary` and `retention` queues to worker startup command
* add missing `dataset_summary` and `retention` queues to worker startup command
---------
Co-authored-by: Riskey <36894937+RiskeyL@users.noreply.github.com>
* Add text-autospace CSS for CJK/Latin spacing
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* correct the css file name and remove it from docs.json
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* draft
* revise based on hands-on testing
* modify based on feedback
* add zh and ja translation
* Update tip for referencing text output variable
Clarify the default behavior of the reasoning model output.
* Add translation note
Added a note about AI translation accuracy and referenced the English version for discrepancies.
* Update human-input.mdx with translation note
Add a note about AI translation accuracy and reference to the English version.
* Apply suggestion from @Copilot
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update wording for clarity on model output display
---------
Co-authored-by: Riskey <riskey47@dify.ai>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* 🌐 Initial translations for PR #665
Auto-generated translations for documentation changes in PR #665.
Last-Processed-Commit: fe61cffd6d
Original-PR: #665
Languages: Chinese (zh), Japanese (ja)
🤖 Generated with GitHub Actions
* 🔄 Update translations for commit fe61cffd
Auto-generated translations for changes in commit fe61cffd6d.
Last-Processed-Commit: fe61cffd6d
Original-PR: #665
Languages: Chinese (zh), Japanese (ja)
🤖 Generated with GitHub Actions
* 🔄 Update translations for commit d37bc6b5
Auto-generated translations for changes in commit d37bc6b5589e629eac03feb0b7278cba6e75bb0f.
Last-Processed-Commit: d37bc6b5589e629eac03feb0b7278cba6e75bb0f
Original-PR: #665
Languages: Chinese (zh), Japanese (ja)
🤖 Generated with GitHub Actions
* fix the zh link
* fix ja links
* align with en doc
* align with en doc
Remove unnecessary URLs and email addresses for better text cleaning.
* Fix formatting for URL and email removal section
* Fix formatting for URL and email removal section
* align the doc title
---------
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Riskey <36894937+RiskeyL@users.noreply.github.com>
Co-authored-by: RiskeyL <7a8y@163.com>
* feat: summary index for knowledge.
* feat: summary index for knowledge.
* align terminology
* add zh and ja translation
---------
Co-authored-by: Riskey <riskey47@dify.ai>
* draft: add content related to summary index
* refine the chunking configurations page
* Revise based on hands-on testing
* Apply suggestions from code review
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Fix formatting for URL and email removal section
---------
Co-authored-by: Riskey <riskey47@dify.ai>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update environment variable docs for OceanBase and SeekDB
Expanded supported DB_TYPE values to include 'oceanbase' and 'seekdb' in `environments.mdx`. Clarified that OceanBase vector database settings also apply to seekdb, and replaced placeholder/English-only Japanese and Chinese docs with full, auto-translated content including all environment variable explanations.
* Remove ja and zh docs
---------
Co-authored-by: Riskey <riskey47@dify.ai>
* fix the broken link for the en user input node
* replace the legacy link prefix for ja and zh introduction
* remove the redundant zh pages
---------
Co-authored-by: Riskey <riskey47@dify.ai>
Auto-generated translations for documentation changes in PR #659.
Last-Processed-Commit: c4cf03ba17
Original-PR: #659
Languages: Chinese (zh), Japanese (ja)
🤖 Generated with GitHub Actions
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
* fix(translation): Include command for removing orphaned files for Chinese
Add command to remove orphaned files from OpenDAL storage for Chinese.
* Fix malformed code fence syntax
* adjust indent
---------
Co-authored-by: Riskey <riskey47@dify.ai>
Auto-generated translations for documentation changes in PR #654.
Last-Processed-Commit: 63f964a0074f467f781dfb80ac00dba830626a68
Original-PR: #654
Languages: Chinese (zh), Japanese (ja)
🤖 Generated with GitHub Actions
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
* create 3.4.x navigation
* add content related to multi-credential management and load balancing for 3-5-x
* add content related to knowledge pipeline for 3-6-x
* add content related to trigger, multimodal embedding, and json object for 3-7-x
* changes upon review
* remove unnecessary links
---------
Co-authored-by: Riskey <riskey47@dify.ai>
Auto-generated translations for documentation changes in PR #642.
Last-Processed-Commit: 99de3f4787
Original-PR: #642
Languages: Chinese (zh), Japanese (ja)
🤖 Generated with GitHub Actions
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
* Update content for boolean, boolean array, and object data type support; refine user input page
* correct format descriptions
---------
Co-authored-by: Riskey <riskey47@dify.ai>
* 🌐 Initial translations for PR #636
Auto-generated translations for documentation changes in PR #636.
Last-Processed-Commit: 3f204fbd9d
Original-PR: #636
Languages: Chinese (zh), Japanese (ja)
🤖 Generated with GitHub Actions
* 🔄 Update translations for commit 623b346a
Auto-generated translations for changes in commit 623b346a77.
Last-Processed-Commit: 623b346a77
Original-PR: #636
Languages: Chinese (zh), Japanese (ja)
🤖 Generated with GitHub Actions
* Fix pricing link for batch upload information
Updated the link for the paid plan pricing page.
* Update maintain-knowledge-documents.mdx
* Update link text for knowledge base creation
* Update pricing link in readme for batch upload
* Update setting-indexing-methods.mdx
* Update knowledge-retrieval.mdx
---------
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Riskey <36894937+RiskeyL@users.noreply.github.com>
* Fix stale PR translation revert issue
When PR A is created before PR B but PR B merges first, the translation
workflow for PR A was reverting all of PR B's changes. This happened because
the translation workflow used PR A's working directory state (which is a
snapshot from before PR B existed) rather than applying only PR A's changes.
Root cause:
- setup_translation_branch() for new branches did:
checkout -b branch → reset --soft origin/main → reset
This kept PR's working directory which could be stale
- For incremental branches, merge_docs_json_for_incremental_update() took
the English section from PR HEAD, which was also stale for old PRs
Fix:
- For NEW branches: Create branch directly from origin/main (not from PR's
working directory). This ensures we start with the latest state including
all changes from PRs merged after this PR was created.
- For EXISTING branches: Merge main's docs.json structure with our
translations (instead of taking EN section from stale PR)
- For BOTH: Selectively checkout only the files that the PR actually changed
from PR's head, rather than bringing in the entire working directory.
This prevents overwriting files from other PRs.
Example issue (PR #593):
- PR #593 only added one file
- Translation PR #611 tried to delete 11 files and revert massive docs.json changes
- This was because it used PR #593's stale state from before other PRs merged
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Fix: Use PR's docs.json for finding file positions in navigation
The initial fix had a side effect: since we start from main's docs.json,
and PR's new files aren't in main's English section yet, sync_docs_json_incremental()
couldn't find where to place new files in the translation navigation.
Fix: Add `reference_sha` parameter to sync_docs_json_incremental() that loads
PR's docs.json for finding file positions, while still modifying main's
translation sections. This ensures:
1. Main's docs.json structure is preserved (no reverts)
2. New files are found in PR's docs.json
3. Translations are added at the correct positions
This also removes the unused _apply_pr_english_section_to_main() method.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Fix EN section not updated when using reference_sha
When the translation branch starts from main, the PR's docs.json
structural changes (new file entries in EN section) were not being
incorporated. This caused the translation PR to have mismatched
navigation entries.
The fix now also updates the EN section of the working directory's
docs.json when processing added files found in the reference
docs.json (from the PR).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Also remove deleted files from EN section in stale PR scenario
When processing deleted files, the sync now also removes them from the
EN section of docs.json. This is needed when the translation branch
starts from main, which may still have the deleted file entries.
Verified with comprehensive local testing covering 10 scenarios:
- Basic stale PR, multiple files, modifications, deletions
- Nested groups, new dropdowns, mixed operations
- Backward compatibility, incremental syncs, structure changes
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* Add ignore_files config to exclude specific files from translation
Adds ability to specify source language files that should not be translated:
- New `ignore_files` array in config.json
- Validation ensures paths start with source dir, have valid extension, no traversal
- Filtering applied in PRAnalyzer.categorize_files() and SyncPlanGenerator.generate_sync_plan()
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* update config
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
- Remove workflow_dispatch trigger (was for testing)
- Remove manual trigger handling code
- Uncomment fork/author/reviewer checks
- Workflow now only triggers on actual PR approvals
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Closes the gap where first-time contributor PRs require maintainer
approval, but approval events don't trigger the translation workflow.
New workflow: sync_docs_on_approval.yml
- Listens to pull_request_review (submitted, approved)
- Re-runs the most recent Analyze workflow for the PR
- This triggers the existing Execute chain with fresh artifacts
- Posts "approval received" comment before starting
Note: Fork/author/reviewer checks are commented out for testing.
Search for "TODO: UNCOMMENT" to restore after testing.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
