{"record":{"id":"b6971fd0bf85e305","repo":"HandyOrg/HandyControl","slug":"warning-exturl-and-extlink-tag-will-not-longer-be-supported","errorCode":null,"errorMessage":"WARNING: `exturl` and `extlink` tag will not longer be supported. More info here: https://theme-next.org/docs/theme-settings/seo#ExtURL","messagePattern":"WARNING: `exturl` and `extlink` tag will not longer be supported\\. More info here: https://theme-next\\.org/docs/theme-settings/seo#ExtURL","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"doc/themes/next/scripts/tags/exturl.js","lineNumber":57,"sourceCode":"  }\n\n  // Delete link URL and text from arguments\n  args = args.slice(i + 1);\n\n  // If any arguments exists, collect the last text as the link title,\n  // if not, set title as url.\n  if (args.length) {\n    title = args.join(' ');\n  } else {\n    title = item;\n  }\n\n  var attrs = {\n    class     : exturl,\n    'data-url': url,\n    title     : title\n  };\n  hexo.log.warn('WARNING: `exturl` and `extlink` tag will not longer be supported. More info here: https://theme-next.org/docs/theme-settings/seo#ExtURL');\n  return htmlTag('span', attrs, text.join(' ') + '<i class=\"fa fa-external-link\"></i>');\n}\n\nhexo.extend.tag.register('exturl', extURL, {ends: false});\nhexo.extend.tag.register('extlink', extURL, {ends: false});\n","sourceCodeStart":39,"sourceCodeEnd":63,"githubUrl":"https://github.com/HandyOrg/HandyControl/blob/2c0875ebd67326e0c67282967e3e809c69282fee/doc/themes/next/scripts/tags/exturl.js#L39-L63","documentation":"The exturl/extlink Hexo tag in the Next theme emits a deprecation warning via hexo.log.warn when the tag is used, and renders the external-link span anyway. The tags are deprecated in favor of the theme's exturl setting (SEO config); the message points to theme-next.org docs.","triggerScenarios":"Any post using {% exturl %} or {% extlink %} triggers the warning during site generation.","commonSituations":"Old posts written for legacy Next versions; after upgrading the theme, previously valid exturl tags now emit this warning on every build.","solutions":["Replace {% exturl Text | https://url %} usages with plain Markdown links and enable the theme's exturl option in _config.next.yml (seo / exturl setting).","Grep posts: grep -rn 'exturl\\|extlink' source/ to locate all affected tags.","Update to the recommended external-link mechanism documented at theme-next.org/docs/theme-settings/seo#ExtURL.","Ignore the warning short-term — it is non-fatal — but plan migration before tag removal in a future theme release."],"exampleFix":"// before (markdown)\n{% exturl Example | https://example.com %}\n// after (with theme exturl option enabled)\n[Example](https://example.com)","handlingStrategy":"fallback","validationCode":"// CI check for deprecated tags\nconst re = /{%\\s*(exturl|extlink)\\b/;\nif (re.test(content)) console.warn('Deprecated tag found:', path);","typeGuard":null,"tryCatchPattern":"// not applicable — deprecation warning only; no exception is thrown","preventionTips":["Migrate exturl/extlink tags to standard Markdown links with the theme's exturl option enabled.","Add a grep-based CI check to fail builds when deprecated tags are introduced.","Read the theme changelog after upgrading Next to catch newly deprecated tags early."],"tags":["hexo","deprecation","theme"],"backgroundTag":"deprecated-api-usage","analyzedSha":"2c0875ebd67326e0c67282967e3e809c69282fee","analyzedAt":"2026-09-14T14:45:29.754Z","contentChangedAt":"2026-09-14T14:45:29.754Z","schemaVersion":2},"datasetVersion":"2026-09-16T09:17:16.951Z"}