CINXE.COM

<!DOCTYPE html> <html class="no-js" lang="en" dir="ltr" prefix="og: http://ogp.me/ns#"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <script> document.documentElement.className = document.documentElement.className.replace('no-js', 'has-js'); function downloadJSAtOnload() { var element = document.createElement("script"); element.src = "/WAI/assets/scripts/main.js?1739541174349523255"; document.body.appendChild(element); } window.addEventListener("load", downloadJSAtOnload, false); </script> <link rel="stylesheet" href="/WAI/assets/css/style.css?1739541174349523255"> <title> How to Translate WCAG 2 | Web Accessibility Initiative (WAI) | W3C</title> <meta name="generator" content="Jekyll v4.3.3" /> <meta property="og:title" content="How to Translate WCAG 2" /> <meta name="author" content="W3C Web Accessibility Initiative (WAI)" /> <meta property="og:locale" content="en" /> <meta name="description" content="Technical instructions on translating WCAG" /> <meta property="og:description" content="Technical instructions on translating WCAG" /> <link rel="canonical" href="https://www.w3.org/WAI/about/translating/wcag/" /> <meta property="og:url" content="https://www.w3.org/WAI/about/translating/wcag/" /> <meta property="og:site_name" content="Web Accessibility Initiative (WAI)" /> <meta property="og:image" content="https://www.w3.org/WAI/content-images/about/social-translations.png" /> <meta property="og:type" content="website" /> <meta name="twitter:card" content="summary_large_image" /> <meta property="twitter:image" content="https://www.w3.org/WAI/content-images/about/social-translations.png" /> <meta property="twitter:title" content="How to Translate WCAG 2" /> <meta name="twitter:site" content="@w3c_wai" /> <meta name="twitter:creator" content="@W3C Web Accessibility Initiative (WAI)" /> <script type="application/ld+json"> {"@context":"https://schema.org","@type":"WebPage","author":{"@type":"Person","name":"W3C Web Accessibility Initiative (WAI)"},"description":"Technical instructions on translating WCAG","headline":"How to Translate WCAG 2","image":"https://www.w3.org/WAI/content-images/about/social-translations.png","url":"https://www.w3.org/WAI/about/translating/wcag/"}</script>  <link rel="alternate" type="application/rss+xml" href="/WAI/feed.xml"> </head> <body id="top" class="page-how-to-translate-wcag-2 "> <nav aria-label="Skip Link and Language Selector" id="controls" class="default-grid"> <ul> <li><a href="#main">Skip to Content</a></li> <li class="opt"> <a href="/WAI/meta/customize/">Change Text Size or Colors</a> </li> <li class="opt"> <a href="/WAI/translations/">All Translations <svg focusable="false" aria-hidden="true" class="icon-translations "><use xlink:href="/WAI/assets/images/icons.svg#icon-translations"></use></svg></a> </li> </ul></nav> <header id="site-header" class="default-grid with-gap"> <div class="logos"> <a lang="en" class="home w3c" href="https://www.w3.org/"> <svg role="img" aria-label="W3C" viewBox="0 0 68 34" xmlns="http://www.w3.org/2000/svg"><g><path d="m16.117 1.006 5.759 19.58 5.759-19.58h4.17 11.444v1.946l-5.879 10.128c2.065.663 3.627 1.868 4.686 3.615 1.059 1.748 1.589 3.799 1.589 6.155 0 2.914-.775 5.363-2.324 7.348s-3.555 2.978-6.017 2.978c-1.854 0-3.469-.589-4.845-1.767-1.377-1.178-2.396-2.773-3.058-4.786l3.256-1.35c.477 1.218 1.106 2.178 1.887 2.879.781.702 1.701 1.052 2.76 1.052 1.112 0 2.052-.622 2.82-1.866.768-1.245 1.152-2.74 1.152-4.489 0-1.933-.411-3.429-1.231-4.488-.954-1.244-2.45-1.867-4.489-1.867h-1.588v-1.906l5.56-9.612h-6.712l-.382.65-8.163 27.548h-.397l-5.958-19.937-5.957 19.937h-.397l-9.53-32.168h4.17l5.759 19.58 3.892-13.185-1.906-6.395z"/><path d="m64.92 1.006c-.819 0-1.554.295-2.111.861-.591.6-.92 1.376-.92 2.178s.313 1.545.887 2.128c.583.591 1.334.912 2.145.912.793 0 1.562-.321 2.161-.903.574-.557.887-1.3.887-2.136 0-.811-.321-1.57-.878-2.136-.584-.592-1.344-.904-2.171-.904zm2.643 3.065c0 .701-.271 1.351-.768 1.832-.524.507-1.174.777-1.892.777-.675 0-1.342-.278-1.84-.785s-.777-1.157-.777-1.849.287-1.368.802-1.891c.481-.49 1.131-.751 1.84-.751.726 0 1.376.271 1.883.785.49.489.752 1.147.752 1.882zm-2.559-1.807h-1.3v3.445h.65v-1.469h.642l.701 1.469h.726l-.769-1.57c.498-.102.785-.439.785-.929 0-.625-.472-.946-1.435-.946zm-.118.422c.608 0 .886.169.886.591 0 .405-.278.549-.87.549h-.549v-1.14z"/><path d="m59.807.825.676 4.107-2.391 4.575s-.918-1.941-2.443-3.015c-1.285-.905-2.122-1.102-3.431-.832-1.681.347-3.587 2.357-4.419 4.835-.995 2.965-1.005 4.4-1.04 5.718-.056 2.113.277 3.362.277 3.362s-1.452-2.686-1.438-6.62c.009-2.808.451-5.354 1.75-7.867 1.143-2.209 2.842-3.535 4.35-3.691 1.559-.161 2.791.59 3.743 1.403 1 .854 2.01 2.721 2.01 2.721z"/><path d="m60.102 24.063s-1.057 1.889-1.715 2.617c-.659.728-1.837 2.01-3.292 2.651s-2.218.762-3.656.624c-1.437-.138-2.772-.97-3.24-1.317s-1.664-1.369-2.34-2.322-1.733-2.859-1.733-2.859.589 1.91.958 2.721c.212.467.864 1.894 1.789 3.136.863 1.159 2.539 3.154 5.086 3.604 2.547.451 4.297-.693 4.73-.97s1.346-1.042 1.924-1.66c.603-.645 1.174-1.468 1.49-1.962.231-.36.607-1.092.607-1.092z"/></g></svg> </a> <a lang="en" class="home" href="/WAI/"> <span class="wai"><span class="wa">Web Accessibility</span> <span class="i"><span class="initieative">Initiative</span> <span>WAI</span></span></span> </a> <div class="claim"> <span>Strategies, standards, resources to make the Web accessible to people with disabilities</span> </div> <button class="button button-menu" aria-haspopup="true" aria-expanded="false" id="openmenu"><span><svg focusable="false" aria-hidden="true" class="icon-menu "><use xlink:href="/WAI/assets/images/icons.svg#icon-menu"></use></svg> Menu</span></button> </div> <div class="navigations"> <nav class="metanav" aria-label="Meta & Search" lang="en"> <ul> <li><a href="/WAI/about/participating/">Get Involved</a></li> <li><a href="/WAI/about/">About W3C WAI</a></li> <li> <form action="/WAI/search/" role="search"> <div> <label for="header-search"> <span class="visuallyhidden">Search:</span> <input id="header-search" type="search" name="q" placeholder="Search" aria-label="Search"> </label> <button class="button button-icon button-nobg button-noborder"><span><svg focusable="false" aria-label="Submit Search" class="icon-search "><use xlink:href="/WAI/assets/images/icons.svg#icon-search"></use></svg></span></button> </div> </form> </li> </ul> </nav> </div> </header><nav class="mainnav" aria-label="Main" lang="en"><ul><li><a lang="en" href="/WAI/fundamentals/"><span>Accessibility Fundamentals</span></a></li><li><a lang="en" href="/WAI/planning/"><span>Planning & Policies</span></a></li><li><a lang="en" href="/WAI/design-develop/"><span>Design & Develop</span></a></li><li><a lang="en" href="/WAI/test-evaluate/"><span>Test & Evaluate</span></a></li><li><a lang="en" href="/WAI/teach-advocate/"><span>Teach & Advocate</span></a></li><li><a lang="en" href="/WAI/standards-guidelines/"><span>Standards/<wbr>Guidelines</span></a></li></ul></nav><nav class="default-grid breadcrumb" aria-label="Breadcrumb" lang="en"> <ul style="align-self: center;"> <li><a href="/WAI/" lang="en">Home</a></li><li><a lang="en" href="/WAI/about/"><span>About W3C WAI</span></a></li><li><a lang="en" href="/WAI/about/translating/"><span>Translating</span></a></li><li><a lang="en" href="/WAI/about/translating/wcag/" aria-current="page"><span>Translating WCAG</span></a></li></ul> </nav> <div class="default-grid with-gap leftcol"> <div class="sidenav"><nav class="sn-contents" aria-label="Secondary"> <ul class="sidenav--list"> <li> <a lang="en" href="/WAI/about/" class="page-link"><span>About WAI</span></a></li><li> <a lang="en" href="/WAI/update/" class="page-link"><span>What We're Working On</span></a></li><li> <a lang="en" href="/WAI/about/participating/" class="page-link"><span>Participating</span></a></li><li> <a lang="en" href="/WAI/about/groups/" class="page-link"><span>Groups</span></a><ul><li> <a lang="en" href="/WAI/about/groups/agwg/" class="page-link"><span>AGWG: Accessibility Guidelines <abbr title="Working Group">WG</abbr></span></a><ul><li> <a lang="en" href="https://www.w3.org/WAI/GL/charter" class="page-link"><span>Charter</span></a></li><li> <a lang="en" href="/WAI/about/groups/agwg/task-forces/" class="page-link"><span>Task Forces</span></a></li><li> <a lang="en" href="/WAI/about/groups/agwg/decision-policy/" class="page-link"><span>Decision Policy</span></a></li><li> <a lang="en" href="/WAI/about/groups/agwg/communication/" class="page-link"><span>Communication</span></a></li><li> <a lang="en" href="/WAI/about/groups/agwg/participate/" class="page-link"><span>How to Participate (Join)</span></a></li></ul></li><li> <a lang="en" href="/WAI/about/groups/apawg/" class="page-link"><span>APA: Accessible Platform <abbr title="Working Group">WG</abbr></span></a><ul><li> <a lang="en" href="https://www.w3.org/2023/07/apa-wg-charter" class="page-link"><span>Charter</span></a></li><li> <a lang="en" href="/WAI/about/groups/apawg/task-forces/" class="page-link"><span>Task Forces</span></a></li><li> <a lang="en" href="/WAI/about/groups/apawg/decision-policy/" class="page-link"><span>Decision Policy</span></a></li><li> <a lang="en" href="/WAI/about/groups/apawg/deliverables/" class="page-link"><span>Deliverables and Status</span></a></li><li> <a lang="en" href="/WAI/about/groups/apawg/video-examples/" class="page-link"><span>APA Video Examples</span></a></li><li> <a lang="en" href="/WAI/about/groups/apawg/communication/" class="page-link"><span>Communication</span></a></li><li> <a lang="en" href="/WAI/about/groups/apawg/contribute/" class="page-link"><span>How to Contribute</span></a></li><li> <a lang="en" href="/WAI/about/groups/apawg/participate/" class="page-link"><span>How to Participate (Join)</span></a></li></ul></li><li> <a lang="en" href="/WAI/about/groups/ariawg/" class="page-link"><span>ARIA: Accessible Rich Internet Applications <abbr title="Working Group">WG</abbr></span></a><ul><li> <a lang="en" href="https://www.w3.org/WAI/ARIA/charter" class="page-link"><span>Charter</span></a></li><li> <a lang="en" href="/WAI/about/groups/ariawg/task-forces/" class="page-link"><span>Task Forces</span></a></li><li> <a lang="en" href="/WAI/about/groups/ariawg/decision-policy/" class="page-link"><span>Decision Policy</span></a></li><li> <a lang="en" href="/WAI/about/groups/ariawg/workflow/" class="page-link"><span>Workflow</span></a></li><li> <a lang="en" href="/WAI/about/groups/ariawg/roadmap/" class="page-link"><span>Roadmap</span></a></li><li> <a lang="en" href="/WAI/about/groups/ariawg/planning/" class="page-link"><span>Deliverables and Status</span></a></li><li> <a lang="en" href="/WAI/about/groups/ariawg/communication/" class="page-link"><span>Communication</span></a></li><li> <a lang="en" href="/WAI/about/groups/ariawg/editors/" class="page-link"><span>Editors</span></a></li><li> <a lang="en" href="/WAI/about/groups/ariawg/contribute/" class="page-link"><span>How to Contribute</span></a></li><li> <a lang="en" href="/WAI/about/groups/ariawg/participate/" class="page-link"><span>How to Participate (Join)</span></a></li></ul></li><li> <a lang="en" href="/WAI/about/groups/waiig/" class="page-link"><span>WAI IG: WAI Interest Group</span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/" class="page-link"><span>Group Task Forces</span></a><ul><li> <a lang="en" href="/WAI/about/groups/task-forces/conformance-testing/" class="page-link"><span>ACT: Accessibility Conformance Testing <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/practices/" class="page-link"><span>APG: ARIA Authoring Practices <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/coga/" class="page-link"><span>COGA: Cognitive and Learning Disabilities <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/css-a11y/" class="page-link"><span>CSS A11Y: CSS Accessibility <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/low-vision-a11y-tf/" class="page-link"><span>LVTF: Low Vision Accessibility <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/matf/" class="page-link"><span>MATF: Mobile Accessibility <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/maturity-model/" class="page-link"><span>MMTF: Maturity Model <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/research-questions/" class="page-link"><span>RQTF: Research Question <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/silver/" class="page-link"><span>Silver <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/pronunciation/" class="page-link"><span>Spoken Presentation <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/adapt/" class="page-link"><span>WAI-Adapt <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/wcag2x-backlog/" class="page-link"><span>WCAG 2.x Backlog <abbr title="Task Force">TF</abbr></span></a></li><li> <a lang="en" href="/WAI/about/groups/task-forces/wcag2ict/" class="page-link"><span>WCAG2ICT <abbr title="Task Force">TF</abbr></span></a></li></ul></li></ul></li><li> <a lang="en" href="/WAI/about/translating/" aria-current="location" class="page-link"><span>Translating</span></a><ul><li> <a lang="en" href="/WAI/about/translating/resources/" class="page-link"><span>Translating a WAI Resource</span></a><ul><li> <a lang="en" href="/WAI/about/translating/resources/technical-steps/" class="page-link"><span>Technical Steps</span></a></li><li> <a lang="en" href="/WAI/about/translating/resources/using-github/" class="page-link"><span>Using GitHub</span></a></li><li> <a lang="en" href="/WAI/about/translating/resources/subtitles/" class="page-link"><span>Subtitles/Descriptions</span></a></li><li> <a lang="en" href="/WAI/about/translating/resources/images/" class="page-link"><span>Images</span></a></li><li> <a lang="en" href="/WAI/about/translating/resources/resource-specific-instructions/" class="page-link"><span>Resource-Specific Instructions</span></a></li></ul></li><li> <a lang="en" href="/WAI/about/translating/reviewing/" class="page-link"><span>Reviewing a Translation</span></a></li> <li> <a lang="en" href="/WAI/about/translating/wcag/" aria-current="page" class="page-link"><span>Translating WCAG</span></a><ul><li> <a lang="en" href="/WAI/about/translating/wcag/wcag21-update/" class="page-link"><span>Updating WCAG 2.1 Translations</span></a></li></ul></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/" class="page-link"><span>Translations Sitemaps</span></a><ul><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-ar/" class="page-link"><span>Arabic</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-pt-br/" class="page-link"><span>Brazilian Portuguese</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-zh-hans/" class="page-link"><span>Chinese (Simplified)</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-cs/" class="page-link"><span>Czech</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-fr/" class="page-link"><span>French</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-de/" class="page-link"><span>German</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-el/" class="page-link"><span>Greek</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-id/" class="page-link"><span>Indonesian</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-ja/" class="page-link"><span>Japanese</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-ko/" class="page-link"><span>Korean</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-pl/" class="page-link"><span>Polish</span></a></li><li> <a lang="en" href="/WAI/about/translating/sitemaps/sitemap-es/" class="page-link"><span>Spanish</span></a></li></ul></li></ul></li><li> <a lang="en" href="/WAI/about/sponsoring/" class="page-link"><span>Sponsoring</span></a></li><li> <a lang="en" href="/WAI/about/contacting/" class="page-link"><span>Contacting</span></a></li><li> <a lang="en" href="/WAI/about/projects/" class="page-link"><span>Projects</span></a><ul><li> <a lang="en" href="/WAI/about/projects/wai-coop/" class="page-link"><span>WAI-CooP</span></a><ul><li> <a lang="en" href="/WAI/about/projects/wai-coop/symposium1/" class="page-link"><span>Research Symposium 2021</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-coop/symposium2/" class="page-link"><span>Research Symposium AI</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-coop/symposium3/" class="page-link"><span>Research Symposium Evaluating Accessibility</span></a></li></ul></li><li> <a lang="en" href="/WAI/about/projects/wai-guide/" class="page-link"><span>WAI-Guide</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/" class="page-link"><span>WAI-Tools</span></a><ul><li> <a lang="en" href="/WAI/about/projects/wai-tools/final-open-meeting/" class="page-link"><span>Final Open Meeting</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/session1/" class="page-link"><span>Video Recording 1</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/session2/" class="page-link"><span>Video Recording 2</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/session3/" class="page-link"><span>Video Recording 3</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/session4/" class="page-link"><span>Video Recording 4</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/session5/" class="page-link"><span>Video Recording 5</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/third-open-meeting/" class="page-link"><span>Third Open Meeting</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/second-open-meeting/" class="page-link"><span>Second Open Meeting</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/symposium/" class="page-link"><span>Online Symposium</span></a><ul><li> <a lang="en" href="/WAI/about/projects/wai-tools/symposium/record/" class="page-link"><span>Record</span></a></li></ul></li><li> <a lang="en" href="/WAI/about/projects/wai-tools/first-open-meeting/" class="page-link"><span>First Open Meeting</span></a></li></ul></li><li> <a lang="en" href="/WAI/expand-access/" class="page-link"><span>WAI Expanding Access</span></a></li><li> <a lang="en" href="/WAI/about/projects/easy-reading/" class="page-link"><span>Easy Reading</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-core-2015/" class="page-link"><span>WAI-Core 2015, 2020</span></a></li><li> <a lang="en" href="/WAI/about/projects/wai-core-ford/" class="page-link"><span>WAI-Core Ford</span></a></li></ul></li><li> <a lang="en" href="/WAI/about/accessibility-statement/" class="page-link"><span>Accessibility Statement</span></a></li><li> <a lang="en" href="/WAI/about/using-wai-material/" class="page-link"><span>Using WAI Material</span></a></li></ul></nav> </div> <main id="main" lang="en"> <header> <h1> How to Translate WCAG 2 </h1></header> <aside class="box box-full"><header class="box-h box-h-full"> <h2> Summary </h2></header><div class="box-i"> <p>This page guides you through the technical steps to translate the Web Content Accessibility Guidelines (WCAG) 2.2 and 2.1.</p> <p>For general information on WCAG 2 Translations, see <a href="https://www.w3.org/Consortium/Translation/">Contributing to W3C Translations <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg> </a> and <a href="https://www.w3.org/2005/02/TranslationPolicy.html">Policy for Authorized W3C Translations <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a>.</p> </div></aside> <nav class="box box-simple box-simple" aria-labelledby="tocheading" id="toc"> <header id="tocheading" class="box-h box-h-simple box-h-simple"> Page Contents</header> <div class="box-i"> <ul id="markdown-toc"> <li><a href="#overview" id="markdown-toc-overview">Overview</a></li> <li><a href="#get-source-files" id="markdown-toc-get-source-files">Step 1: Get the source files</a></li> <li><a href="#translate-source-files" id="markdown-toc-translate-source-files">Step 2: Translate WCAG source files</a></li> <li><a href="#preview-export" id="markdown-toc-preview-export">Step 3: Preview your changes and export in HTML</a></li> <li><a href="#edit-html" id="markdown-toc-edit-html">Step 4: Edit the resulting HTML file and complete the translation</a></li> <li><a href="#check" id="markdown-toc-check">Step 5: Check your translation thoroughly</a></li> <li><a href="#deliver-files" id="markdown-toc-deliver-files">Step 6: Deliver the final files to W3C</a></li> </ul> </div> </nav> <h2 id="overview">Overview</h2> <p>Web Content Accessibility Guidelines (WCAG) 2.1/2.2 are currently <a href="/WAI/standards-guidelines/wcag/translations/">available in more than 14 languages</a>!</p> <p>There are 6 main steps to create a new translation:</p> <ol> <li><strong><a href="#get-source-files">Get the source files</a></strong> from <a href="https://github.com/w3c/wcag/"><code class="language-plaintext highlighter-rouge">w3c/wcag/</code> <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a> repository</li> <li><strong><a href="#translate-source-files">Translate WCAG source files</a></strong></li> <li><strong><a href="#preview-export">Export in HTML</a></strong></li> <li><strong><a href="#edit-html">Edit the HTML files</a></strong> to complete the translation</li> <li><strong><a href="#check">Check your translation</a></strong></li> <li><strong><a href="#deliver-files">Deliver the final files to W3C</a></strong></li> </ol> <h2 id="get-source-files">Step 1: Get the source files</h2> <ol> <li>Clone <a href="https://github.com/w3c/wcag/"><code class="language-plaintext highlighter-rouge">w3c/wcag</code> <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a> repository (you can <a href="https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo">fork <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a> it first)</li> <li>Checkout the following tag to get the relevant source files: <ul> <li><a href="https://github.com/w3c/wcag/tree/WCAG22-20231005"><code class="language-plaintext highlighter-rouge">WCAG22-20231005</code> tag <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a> to translate WCAG 2.2 (5 October 2023 version)</li> <li><a href="https://github.com/w3c/wcag/tree/WCAG21-20230921"><code class="language-plaintext highlighter-rouge">WCAG21-20230921</code> tag <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a> to translate WCAG 2.1 (21 September 2023 version)</li> </ul> </li> </ol> <h2 id="translate-source-files">Step 2: Translate WCAG source files</h2> <p>The repository contains numerous folders and files. Only some of them are relevant to your WCAG translation.</p> <p>Translate user-oriented content in:</p> <ul> <li><code class="language-plaintext highlighter-rouge">guidelines/index.html</code></li> <li>All files in <code class="language-plaintext highlighter-rouge">guidelines/sc/</code> folder and subfolders</li> <li>All files in <code class="language-plaintext highlighter-rouge">guidelines/terms/</code> folder and subfolders</li> <li><code class="language-plaintext highlighter-rouge">guidelines/input-purposes.html</code></li> <li><code class="language-plaintext highlighter-rouge">guidelines/relative-luminance.html</code></li> <li><code class="language-plaintext highlighter-rouge">guidelines/respect-config.js</code>: translate Editors list.</li> <li>All files in <code class="language-plaintext highlighter-rouge">acknowledgements/</code> folder</li> </ul> <p>Make sure to follow these guidelines:</p> <ul> <li>Update <html> <code class="language-plaintext highlighter-rouge">lang</code> and <code class="language-plaintext highlighter-rouge">xml:lang</code> attributes in <code class="language-plaintext highlighter-rouge">index.html</code> and <code class="language-plaintext highlighter-rouge">relative-luminance.html</code>.<br /> Use the appropriate “language tag” from the <a href="https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry">Language Subtag Registry <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a></li> <li>Do not add or edit CSS.</li> <li>Do not translate <code class="language-plaintext highlighter-rouge">id</code>s.</li> <li>Add <code class="language-plaintext highlighter-rouge">hreflang="en"</code> to links when needed, and <code class="language-plaintext highlighter-rouge">lang="en"</code> where needed.</li> <li>Follow the guidelines of the <a href="https://www.w3.org/International/">W3C Internationalization Activity <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a>: for example, the proper usage of language tags, encoding declarations, handling bidirectional text, etc.</li> </ul> <h2 id="preview-export">Step 3: Preview your changes and export in HTML</h2> <p>To preview your changes, open the <code class="language-plaintext highlighter-rouge">index.html</code> file in a modern browser, on a local server. Without a server, the success criteria and glossary terms will not be included.</p> <p>Allow the script to compile and format the content.</p> <ol> <li>If your document has “ReSpec” errors or warnings, they will shop up at the top of the page, next to the “ReSpec Menu” link. <ul> <li>Check and resolve (potential) “ReSpec Errors”.</li> <li>Check “ReSpec Warnings”. The original document may contain some warnings. Make sure you do not introduce new ones.</li> </ul> </li> <li>Export in HTML using ReSpec: <ul> <li>Activate the “Respec Menu” link in the top right corner</li> <li>Choose “Export…”, then the “HTML” option.</li> </ul> </li> </ol> <h2 id="edit-html">Step 4: Edit the resulting HTML file and complete the translation</h2> <p>Rename the exported HTML file to <code class="language-plaintext highlighter-rouge">index.html</code> and make the following changes.</p> <h3 id="translation-header">Add the translation header</h3> <p>At the very start of your <code class="language-plaintext highlighter-rouge">body</code> element, add a <a href="https://www.w3.org/2005/02/TranslationPolicy#Disclamier">translation header, based on the provided boilerplate</a>.</p> <p>The text in this disclaimer must be in the target language, except for the original title and the reference to the Lead Translation Organization (LTO) at the top.</p> <h3 id="make-some-edits">Make some edits</h3> <ul> <li>Translate the <code class="language-plaintext highlighter-rouge">.head</code> section</li> <li>In each <code class="language-plaintext highlighter-rouge">dfn-panel</code>, translate “Permalink” and “Referenced in:”</li> <li>Next to each Success Criterion, translate “Understanding” and “How to Meet”</li> <li>Change the ID of the <a href="https://www.w3.org/TR/WCAG22/#conformance">“5. Conformance”</a> <code class="language-plaintext highlighter-rouge"><section></code> to “<code class="language-plaintext highlighter-rouge">conformance</code>”.</li> </ul> <p>Make sure to follow these guidelines:</p> <ul> <li>Do not add or edit CSS.</li> <li>Do not translate <code class="language-plaintext highlighter-rouge">id</code>s.</li> <li>Add <code class="language-plaintext highlighter-rouge">hreflang="en"</code> to links when needed, and <code class="language-plaintext highlighter-rouge">lang="en"</code> where needed.</li> <li>Follow the guidelines of the <a href="https://www.w3.org/International/">W3C Internationalization Activity</a>: for example, the proper usage of language tags, encoding declarations, handling bidirectional text, etc.</li> </ul> <h3 id="translate-the-text-added-by-fixupjs">Translate the text added by <code class="language-plaintext highlighter-rouge">fixup.js</code></h3> <p>The <code class="language-plaintext highlighter-rouge">fixup.js</code> file adds links that allow users to jump to the Table of contents, and to collapse/expand the sidebar.</p> <p>Download <a href="https://www.w3.org/scripts/TR/2021/fixup.js"><code class="language-plaintext highlighter-rouge">fixup.js</code> <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a> and translate the following terms:</p> <ul> <li>“Collapse Sidebar”</li> <li>“Pop Out Sidebar”</li> <li>“Jump to Table of Contents”</li> </ul> <h2 id="check">Step 5: Check your translation thoroughly</h2> <p>Please properly check your files before submission to W3C.</p> <p>In particular, make sure that:</p> <ul> <li>All links are valid. You can use <a href="https://validator.w3.org/checklink">W3C Link Checker</a></li> <li>HTML is valid. You can use <a href="https://validator.w3.org/">W3C Markup Validation Service</a></li> <li>CSS is valid. You can use <a href="https://jigsaw.w3.org/css-validator/">W3C CSS Validation Service</a></li> <li>Pages are internationalization-friendly. You can use <a href="https://validator.w3.org/i18n-checker/">W3C Internationalization Checker</a></li> <li>All relevant content has been properly translated</li> <li>All <code class="language-plaintext highlighter-rouge">id</code>s are in English; that is, they have not been translated. If you have followed <a href="#get-source-files">How to Translate WCAG 2 – Get the source files</a>, this should be fine.</li> <li><code class="language-plaintext highlighter-rouge">lang</code> and <code class="language-plaintext highlighter-rouge">xml:lang</code> attributes of the <code class="language-plaintext highlighter-rouge"><html></code> tag are correct</li> <li><code class="language-plaintext highlighter-rouge">hreflang</code> attribute has been added to links when relevant</li> <li><code class="language-plaintext highlighter-rouge">lang</code> attribute has been used when relevant (especially when some text has been kept in English)</li> <li>The links/anchors of the original and translated versions match.</li> <li>“Jump to table of contents”, “Collapse sidebar” and “Hide sidebar” have been translated.</li> <li>There is no code showing in the rendered page.</li> <li>No custom CSS has been added.</li> <li>(Authorized translation) An errata has been created and is hosted on the Lead Translation Organization (LTO)’s website.</li> </ul> <h2 id="deliver-files">Step 6: Deliver the final files to W3C</h2> <p>In conformance with step 6.3 of the <a href="https://www.w3.org/2005/02/TranslationPolicy.html">Policy for Authorized W3C Translations <svg focusable="false" aria-label="External Site" class="icon-external-link "><use xlink:href="/WAI/assets/images/icons.svg#icon-external-link"></use></svg></a>, deliver the following files to W3C for publication:</p> <ul> <li><code class="language-plaintext highlighter-rouge">index.html</code></li> <li><code class="language-plaintext highlighter-rouge">relative-luminance.html</code></li> <li><code class="language-plaintext highlighter-rouge">fixup.js</code></li> </ul> <p>Make sure these are valid (X)HTML documents with UTF-8 encoding.</p> <aside class="box box-icon box-space-above" id="helpimprove" aria-label="feedback"><header class="box-h box-h-icon box-h-space-above box-h-icon"> <svg focusable="false" aria-hidden="true" class="icon-comments "><use xlink:href="/WAI/assets/images/icons.svg#icon-comments"></use></svg> <h2> Help improve this page </h2></header><div class="box-i"><p>Please share your ideas, suggestions, or comments via e-mail to the publicly-archived list <a href="mailto:wai@w3.org?body=%5Binclude%20a%20relevant%20email%20Subject%5D%0A%0A%5Bput%20comment%20here...%5D%0A%0AI%20give%20permission%20to%20share%20this%20to%20a%20publicly-archived%20e-mail%20list.">wai@w3.org</a> or via GitHub.</p> <div class="button-group"> <a href="mailto:wai@w3.org?body=%5Binclude%20a%20relevant%20email%20Subject%5D%0A%0A%5Bput%20comment%20here...%5D%0A%0AI%20give%20permission%20to%20share%20this%20to%20a%20publicly-archived%20e-mail%20list." class="button"><span>E-mail</span></a><a href=" https://github.com/w3c/wai-website/edit/main/pages/about/translating/wcag.md " class="button"><span>Fork & Edit on GitHub</span></a><a href="https://github.com/w3c/wai-website/issues/new?template=content-issue.yml&wai-resource-id=wai-translation-guidance&wai-url=https://www.w3.org/WAI/about/translating/wcag/" class="button"><span>New GitHub Issue</span></a></div></div></aside> <a class="button button-backtotop" href="#top"><span><svg focusable="false" aria-hidden="true" class="icon-arrow-up "><use xlink:href="/WAI/assets/images/icons.svg#icon-arrow-up"></use></svg> Back to Top</span></a> </main> </div> <footer id="wai-site-footer" class="page-footer default-grid" aria-label="Page"> <div class="inner"><p><strong>Updated:</strong> 22 October 2024.</p><p><strong>Editor:</strong> Rémi Bétin.</p> </div> </footer> <footer class="site-footer grid-4q" aria-label="Site"> <div class="q1-start q3-end about"> <div> <p><a class="largelink" href="https://www.w3.org/WAI/" lang="en" dir="auto" translate="no">W3C Web Accessibility Initiative (WAI)</a></p> <p>Strategies, standards, and supporting resources to make the Web accessible to people with disabilities.</p> </div> <div class="social" lang="en" dir="auto" translate="no"> <ul> <li><a href="https://w3c.social/@wai"><svg focusable="false" aria-hidden="true" class="icon-mastodon "><use xlink:href="/WAI/assets/images/icons.svg#icon-mastodon"></use></svg> Mastodon</a></li> <li><a href="https://www.linkedin.com/company/w3c-wai/"><svg focusable="false" aria-hidden="true" class="icon-linkedin "><use xlink:href="/WAI/assets/images/icons.svg#icon-linkedin"></use></svg> LinkedIn</a></li> <li><a href="https://www.w3.org/WAI/feed.xml"><svg focusable="false" aria-hidden="true" class="icon-rss "><use xlink:href="/WAI/assets/images/icons.svg#icon-rss"></use></svg> Feed</a></li> <li><a href="https://www.youtube.com/channel/UCU6ljj3m1fglIPjSjs2DpRA/playlists/"><svg focusable="false" aria-hidden="true" class="icon-youtube "><use xlink:href="/WAI/assets/images/icons.svg#icon-youtube"></use></svg> YouTube</a></li> <li><a href="https://www.w3.org/WAI/news/subscribe/" class="button">Get News in Email</a></li> </ul> </div> <div lang="en" dir="auto" translate="no"> <p>Copyright © 2025 World Wide Web Consortium (<a href="https://www.w3.org/">W3C</a><sup>®</sup>). See <a href="/WAI/about/using-wai-material/">Permission to Use WAI Material</a>.</p> </div> </div> <div lang="en" dir="auto" translate="no" class="q4-start q4-end"> <ul style="margin-bottom:0"> <li><a href="/WAI/about/contacting/">Contact WAI</a></li> <li><a href="/WAI/sitemap/">Site Map</a></li> <li><a href="/WAI/news/">News</a></li> <li><a href="/WAI/sitemap/#archive">Archive</a></li> <li><a href="/WAI/about/accessibility-statement/">Accessibility Statement</a></li> <li><a href="/WAI/translations/"> Translations</a></li> <li><a href="/WAI/roles/">Resources for Roles</a></li> </ul> </div> </footer> <script src="/WAI/assets/scripts/details4everybody.js?1739541174349523255"></script>  <script src="/WAI/assets/scripts/svg4everybody.js?1739541174349523255"></script> <script> svg4everybody(); </script><script> var translationStrings = {}; </script> </body> </html>