fix: update documentation links for various components to support localization (#21048)

web/app/components/app/create-app-modal/index.tsx

@@ -314,7 +314,10 @@ function AppPreview({ mode }: { mode: AppMode }) {
     'advanced-chat': {
       title: t('app.types.advanced'),
       description: t('app.newApp.advancedUserDescription'),
-      link: docLink('/guides/workflow/readme'),
+      link: docLink('/guides/workflow/README', {
+        'zh-Hans': '/guides/workflow/readme',
+        'ja-JP': '/guides/workflow/concepts',
+      }),
     },
     'agent-chat': {
       title: t('app.types.agent'),
@@ -324,13 +327,18 @@ function AppPreview({ mode }: { mode: AppMode }) {
     'completion': {
       title: t('app.newApp.completeApp'),
       description: t('app.newApp.completionUserDescription'),
-      link: docLink('/guides/application-orchestrate/text-generator',
+      link: docLink('/guides/application-orchestrate/text-generator', {
-        { 'zh-Hans': '/guides/application-orchestrate/readme' }),
+        'zh-Hans': '/guides/application-orchestrate/readme',
+        'ja-JP': '/guides/application-orchestrate/README',
+      }),
     },
     'workflow': {
       title: t('app.types.workflow'),
       description: t('app.newApp.workflowUserDescription'),
-      link: docLink('/guides/workflow/readme'),
+      link: docLink('/guides/workflow/README', {
+        'zh-Hans': '/guides/workflow/readme',
+        'ja-JP': '/guides/workflow/concepts',
+      }),
     },
   }
   const previewInfo = modeToPreviewInfoMap[mode]

web/app/components/app/overview/settings/index.tsx

@@ -237,7 +237,9 @@ const SettingsModal: FC<ISettingsModalProps> = ({
           </div>
           <div className='system-xs-regular mt-0.5 text-text-tertiary'>
             <span>{t(`${prefixSettings}.modalTip`)}</span>
-            <Link href={docLink('/guides/application-publishing/launch-your-webapp-quickly/README')}
+            <Link href={docLink('/guides/application-publishing/launch-your-webapp-quickly/README', {
+              'zh-Hans': '/guides/application-publishing/launch-your-webapp-quickly/readme',
+            })}
               target='_blank' rel='noopener noreferrer' className='text-text-accent'>{t('common.operation.learnMore')}</Link>
           </div>
         </div>

web/app/components/datasets/external-api/external-api-modal/Form.tsx

@@ -59,7 +59,7 @@ const Form: FC<FormProps> = React.memo(({
           </label>
           {variable === 'endpoint' && (
             <a
-              href={docLink('/guides/knowledge-base/external-knowledge-api-documentation') || '/'}
+              href={docLink('/guides/knowledge-base/connect-external-knowledge-base') || '/'}
               target='_blank'
               rel='noopener noreferrer'
               className='body-xs-regular flex items-center text-text-accent'

web/app/components/datasets/external-api/external-api-panel/index.tsx

@@ -53,7 +53,7 @@ const ExternalAPIPanel: React.FC<ExternalAPIPanelProps> = ({ onClose }) => {
             <div className='system-xl-semibold self-stretch text-text-primary'>{t('dataset.externalAPIPanelTitle')}</div>
             <div className='body-xs-regular self-stretch text-text-tertiary'>{t('dataset.externalAPIPanelDescription')}</div>
             <a className='flex cursor-pointer items-center justify-center gap-1 self-stretch'
-               href={docLink('/guides/knowledge-base/external-knowledge-api-documentation')} target='_blank'>
+              href={docLink('/guides/knowledge-base/connect-external-knowledge-base')} target='_blank'>
               <RiBookOpenLine className='h-3 w-3 text-text-accent' />
               <div className='body-xs-regular grow text-text-accent'>{t('dataset.externalAPIPanelDocumentation')}</div>
             </a>

web/app/components/datasets/hit-testing/modify-retrieval-modal.tsx

@@ -74,7 +74,10 @@ const ModifyRetrievalModal: FC<Props> = ({
             <a
               target='_blank'
               rel='noopener noreferrer'
-              href={docLink('/guides/knowledge-base/create-knowledge-and-upload-documents#id-4-retrieval-settings')}
+              href={docLink('/guides/knowledge-base/retrieval-test-and-citation#modify-text-retrieval-setting', {
+                'zh-Hans': '/guides/knowledge-base/retrieval-test-and-citation#修改文本检索方式',
+                'ja-JP': '/guides/knowledge-base/retrieval-test-and-citation',
+              })}
               className='text-text-accent'
             >
               {t('datasetSettings.form.retrievalSetting.learnMore')}

web/app/components/datasets/settings/form/index.tsx

@@ -310,7 +310,16 @@ const Form = () => {
                 <div>
                   <div className='system-sm-semibold text-text-secondary'>{t('datasetSettings.form.retrievalSetting.title')}</div>
                   <div className='body-xs-regular text-text-tertiary'>
-                    <a target='_blank' rel='noopener noreferrer' href={docLink('/guides/knowledge-base/create-knowledge-and-upload-documents#id-4-retrieval-settings')} className='text-text-accent'>{t('datasetSettings.form.retrievalSetting.learnMore')}</a>
+                    <a
+                      target='_blank'
+                      rel='noopener noreferrer'
+                      href={docLink('/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods#setting-the-retrieval-setting', {
+                        'zh-Hans': '/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods#指定检索方式',
+                        'ja-JP': '/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods#検索方法の指定',
+                      })}
+                      className='text-text-accent'>
+                      {t('datasetSettings.form.retrievalSetting.learnMore')}
+                    </a>
                     {t('datasetSettings.form.retrievalSetting.description')}
                   </div>
                 </div>

web/app/components/workflow/nodes/_base/components/agent-strategy.tsx

@@ -222,7 +222,8 @@ export const AgentStrategy = memo((props: AgentStrategyProps) => {
           description={<div className='text-xs text-text-tertiary'>
             {t('workflow.nodes.agent.strategy.configureTipDesc')} <br />
             <Link href={docLink('/guides/workflow/node/agent#select-an-agent-strategy', {
-              'zh-Hans': '/guides/workflow/node/agent#xuan-ze-agent-ce-le',
+              'zh-Hans': '/guides/workflow/node/agent#选择-agent-策略',
+              'ja-JP': '/guides/workflow/node/agent#エージェント戦略の選択',
             })}
               className='text-text-accent-secondary' target='_blank'>
               {t('workflow.nodes.agent.learnMore')}

web/app/components/workflow/nodes/_base/components/error-handle/default-value.tsx

@@ -36,7 +36,9 @@ const DefaultValue = ({
         {t('workflow.nodes.common.errorHandle.defaultValue.desc')}
          
         <a
-          href={docLink('/guides/workflow/error-handling/README')}
+          href={docLink('/guides/workflow/error-handling/README', {
+            'zh-Hans': '/guides/workflow/error-handling/readme',
+          })}
           target='_blank'
           className='text-text-accent'
         >

web/app/components/workflow/nodes/_base/components/variable/var-reference-popup.tsx

@@ -44,8 +44,11 @@ const VarReferencePopup: FC<Props> = ({
               description={<div className='system-xs-regular text-text-tertiary'>
                 {t('workflow.variableReference.assignedVarsDescription')}
                 <a target='_blank' rel='noopener noreferrer'
-                   className='text-text-accent-secondary'
+                  className='text-text-accent-secondary'
-                   href={docLink('/guides/workflow/variables#conversation-variables', { 'zh-Hans': '/guides/workflow/variables#hui-hua-bian-liang' })}>
+                  href={docLink('/guides/workflow/variables#conversation-variables', {
+                    'zh-Hans': '/guides/workflow/variables#会话变量',
+                    'ja-JP': '/guides/workflow/variables#会話変数',
+                  })}>
                   {t('workflow.variableReference.conversationVars')}
                 </a>
               </div>}

web/app/components/workflow/panel/chat-variable-panel/index.tsx

@@ -138,10 +138,13 @@ const ChatVariablePanel = () => {
             <div className='system-sm-regular mb-4 mt-1 text-text-secondary'>
               {t('workflow.chatVariable.panelDescription')}
               <a target='_blank' rel='noopener noreferrer' className='text-text-accent'
-                 href={docLink('/guides/workflow/variables#conversation-variables', { 'zh-Hans': '/guides/workflow/variables#hui-hua-bian-liang' })}>
+                href={docLink('/guides/workflow/variables#conversation-variables', {
+                  'zh-Hans': '/guides/workflow/variables#会话变量',
+                  'ja-JP': '/guides/workflow/variables#会話変数',
+                })}>
                 {t('workflow.chatVariable.docLink')}
               </a>
-          </div>
+            </div>
             <div className='flex items-center gap-2'>
               <div className='radius-lg flex flex-col border border-workflow-block-border bg-workflow-block-bg p-3 pb-4 shadow-md'>
                 <BubbleX className='mb-1 h-4 w-4 shrink-0 text-util-colors-teal-teal-700' />
@@ -167,7 +170,7 @@ const ChatVariablePanel = () => {
                 </div>
               </div>
             </div>
-            <div className='absolute right-[38px] top-[-4px] z-10 h-3 w-3 rotate-45 bg-background-section-burn'/>
+            <div className='absolute right-[38px] top-[-4px] z-10 h-3 w-3 rotate-45 bg-background-section-burn' />
           </div>
         </div>
       )}

web/context/i18n.ts

@@ -24,11 +24,6 @@ export const useGetLanguage = () => {
 
   return getLanguage(locale)
 }
-export const useGetDocLanguage = () => {
-  const { locale } = useI18N()
-
-  return getDocLanguage(locale)
-}
 export const useGetPricingPageLanguage = () => {
   const { locale } = useI18N()
 
@@ -37,15 +32,15 @@ export const useGetPricingPageLanguage = () => {
 
 const defaultDocBaseUrl = 'https://docs.dify.ai'
 export const useDocLink = (baseUrl?: string): ((path?: string, pathMap?: { [index: string]: string }) => string) => {
-    let baseDocUrl = baseUrl || defaultDocBaseUrl
+  let baseDocUrl = baseUrl || defaultDocBaseUrl
-    baseDocUrl = (baseDocUrl.endsWith('/')) ? baseDocUrl.slice(0, -1) : baseDocUrl
+  baseDocUrl = (baseDocUrl.endsWith('/')) ? baseDocUrl.slice(0, -1) : baseDocUrl
-    const { locale } = useI18N()
+  const { locale } = useI18N()
-    const docLanguage = getDocLanguage(locale)
+  const docLanguage = getDocLanguage(locale)
-    return (path?: string, pathMap?: { [index: string]: string }): string => {
+  return (path?: string, pathMap?: { [index: string]: string }): string => {
-        const pathUrl = path || ''
+    const pathUrl = path || ''
-        let targetPath = (pathMap) ? pathMap[locale] || pathUrl : pathUrl
+    let targetPath = (pathMap) ? pathMap[locale] || pathUrl : pathUrl
-        targetPath = (targetPath.startsWith('/')) ? targetPath.slice(0, -1) : targetPath
+    targetPath = (targetPath.startsWith('/')) ? targetPath.slice(1) : targetPath
-        return `${baseDocUrl}/${docLanguage}/${targetPath}`
+    return `${baseDocUrl}/${docLanguage}/${targetPath}`
-    }
+  }
 }
 export default I18NContext