René's URL Explorer Experiment


Title: Website Internationalization Roadmap · Issue #100 · microsoft/TypeScript-Website · GitHub

Open Graph Title: Website Internationalization Roadmap · Issue #100 · microsoft/TypeScript-Website

X Title: Website Internationalization Roadmap · Issue #100 · microsoft/TypeScript-Website

Description: As the new website is being built out bit-by-bit, we're adding support for internationalized content on a per-section basis. I've been working with l33t speak under the language "vo" to test out the infra as it is built. I expect there a...

Open Graph Description: As the new website is being built out bit-by-bit, we're adding support for internationalized content on a per-section basis. I've been working with l33t speak under the language "vo" to test out th...

X Description: As the new website is being built out bit-by-bit, we're adding support for internationalized content on a per-section basis. I've been working with l33t speak under the language "vo&qu...

Opengraph URL: https://github.com/microsoft/TypeScript-Website/issues/100

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Website Internationalization Roadmap","articleBody":"As the new website is being built out bit-by-bit, we're adding support for internationalized content on a per-section basis. I've been working with l33t speak under the language \"vo\" to test out the infra as it is built.\r\n\r\nI expect there are (at least) four main components for creating content on a per-language basis:\r\n\r\n- Website copy (navigation bar, index page, community page etc)\r\n- Website (and handbook) content (markdown files mainly)\r\n- Playground examples content, and on-screen copy \r\n- TSConfig reference content, and on-screen copy\r\n\r\nEach one of these needs:\r\n\r\n- Working English documentation as reference\r\n- Infra for supporting the creation of internalized content\r\n- Infra for supporting the presentation of internationalized content\r\n\r\nCurrent state of internationalization:\r\n\r\n- Website copy. \r\n  - [x] English\r\n  - [x] Creation\r\n  - [x] Users\r\n\r\n- Website content (e.g. the handbook). \r\n  - [x] English\r\n  - [x] Creation\r\n  - [x] Users\r\n\r\n- Playground examples:\r\n  - [x] English\r\n  - [x] Creation\r\n  - [x] Users\r\n\r\n- TSConfig:\r\n  - [x] English\r\n  - [x] Creation\r\n  - [x] Users\r\n\r\n## How To Contribute\r\n\r\n1. Join the [TypeScript Discord](https://discord.gg/typescript) - come say hi the [`ts-web-translate`](https://discord.gg/gG7nsGA)\r\n\r\n2. Clone the repo. The work will happen on the [`v2`](https://github.com/microsoft/TypeScript-Website/tree/v2) branch. Deploys of the TS website have this static site set up at http://www.typescriptlang.org/v2/\r\n\r\n  ```sh\r\n  git clone https://github.com/microsoft/TypeScript-Website\r\n  cd TypeScript-Website\r\n\r\n  code .\r\n  code README.md\r\n\r\n  # Follow setup instructions in README\r\n  # then start up the server\r\n  yarn start\r\n  ```\r\n\r\n3. Look below to see the sections, then come back up here\r\n\r\n4. Read this PR to see an example of adding a language: https://github.com/microsoft/TypeScript-Website/pull/181\r\n\r\n5. Pick one of the below sections to start with, it might be easiest to work with samples in the Playground first FWIW.\r\n\r\n#### Website\r\n\r\nThe website supports localization via React-intl, as of today only the navigation bar it translatable, but with time this will grow. The infra just came in with https://github.com/microsoft/TypeScript-Website/pull/180\r\n\r\nThere are a series of keys and values for each language, with a fallback to English if you miss something. The TypeScript compiler will keep it all in check.\r\n\r\n#### Playground\r\n\r\nYou can cover the examples in the dropdown in the playground (and in the site footer on desktops.) [Full docs here](https://github.com/microsoft/TypeScript-Website/tree/v2/packages/playground-examples)\r\n\r\n- Make a subfolder with the code of the language [in the copy folder of the 'playground-examples'](https://github.com/microsoft/TypeScript-Website/tree/v2/packages/playground-examples)\r\n- Ensure the _filename_ are the same as English, (you can provide a different title via the JSON headers in the ts/js files) \r\n\r\n#### TSConfig\r\n\r\nEach TSConfig file is a unique markdown file which can be uniquely handled per language. Any markdown file not found will be replaced with English. [Full docs here](https://github.com/microsoft/TypeScript-Website/tree/v2/packages/tsconfig-reference)\r\n\r\n\r\n-  [Check out this folder](https://github.com/microsoft/TypeScript-Website/tree/v2/packages/tsconfig-reference/)\r\n- Ensure the _filename_ is the same (we can provide a different title via the YML headers in the markdown files) \r\n\r\n---\r\n\r\n## Recommendations\r\n\r\nI'm pretty new to the translation game, but here's some notes from working with people so far on how translations can culturally work in the TS website.\r\n\r\n#### Translate code to be a cultural fit. E.g.\r\n\r\n```ts\r\nconst helloWorld = \"Hi\" \r\n``` \r\n\r\nto\r\n\r\n```ts\r\nconst olaMundo = \"Olá`\r\n```\r\n\r\n####  Translate names in example \r\n\r\n```ts\r\nconst user =  { name: \"John\" }\r\n``` \r\n\r\nto\r\n\r\n```ts\r\nconst usar =  { name: \"João\" }\r\n```\r\n\r\nNote: we aim to have a diverse set of nationalities and genders in our examples, so I'd recommend not changing _all_ of them, but try keep it feeling like it was written with that in mind also.\r\n\r\n#### Translate Technical Terms, but keep English around\r\n\r\nThis one is nuanced, but a term like `Mapped Type` is _the name_ for this:\r\n\r\n```ts\r\ntype MyPartialType\u003cType> = {\r\n  // For every existing property inside the type of Type\r\n  // convert it to be a ?: version\r\n  [Property in keyof Type]?: Type[Property];\r\n};\r\n```\r\n\r\nSo, if you translate it to \"mapeada type\", then provide a reference to the original name the first time it is used: \"mapeada type (Mapped Type em inglês)\" so that readers can know how to find the English resources on a topic.\r\n","author":{"url":"https://github.com/orta","@type":"Person","name":"orta"},"datePublished":"2019-10-27T17:58:45Z","url":"https://github.com/microsoft/TypeScript-Website/issues/100"}

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format)
route-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:b81b98d8-564d-5856-80d2-f25d6b46ac92
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-id83EA:33D24F:2917FFA:34C4459:6B01AFBF
html-safe-noncef4f491b1847dbb29f8ddb9d0d935a2676e9e44d59d511221e2d5f4a2ee3c793d
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4M0VBOjMzRDI0RjoyOTE3RkZBOjM0QzQ0NTk6NkIwMUFGQkYiLCJ2aXNpdG9yX2lkIjoiMzk1OTAxOTA0NDcxMTAxODQzMSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac91998b242133ebc5dedb03fa8a06b0a595620f8b91874aef9cf1dfb996bcff19
hovercard-subject-tagissue:512999500
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/microsoft/TypeScript-Website/100/issue_layout
twitter:imagehttps://opengraph.githubassets.com/817ecd7176293d683ba3ca0bd6d68987bc3da2d0240724fdbec318ad0f667c5d/microsoft/TypeScript-Website/issues/100
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/817ecd7176293d683ba3ca0bd6d68987bc3da2d0240724fdbec318ad0f667c5d/microsoft/TypeScript-Website/issues/100
og:image:altAs the new website is being built out bit-by-bit, we're adding support for internationalized content on a per-section basis. I've been working with l33t speak under the language "vo" to test out th...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameorta
hostnamegithub.com
expected-hostnamegithub.com
Nonecc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c
turbo-cache-controlno-preview
go-importgithub.com/microsoft/TypeScript-Website git https://github.com/microsoft/TypeScript-Website.git
octolytics-dimension-user_id6154722
octolytics-dimension-user_loginmicrosoft
octolytics-dimension-repository_id193992134
octolytics-dimension-repository_nwomicrosoft/TypeScript-Website
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id193992134
octolytics-dimension-repository_network_root_nwomicrosoft/TypeScript-Website
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release8c77c9e8439031ad54c75a250694842892f693e1
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/microsoft/TypeScript-Website/issues/100#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmicrosoft%2FTypeScript-Website%2Fissues%2F100
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmicrosoft%2FTypeScript-Website%2Fissues%2F100
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=microsoft%2FTypeScript-Website
Reloadhttps://github.com/microsoft/TypeScript-Website/issues/100
Reloadhttps://github.com/microsoft/TypeScript-Website/issues/100
Reloadhttps://github.com/microsoft/TypeScript-Website/issues/100
microsofthttps://github.com/microsoft
TypeScript-Websitehttps://github.com/microsoft/TypeScript-Website
Codehttps://github.com/microsoft/TypeScript-Website
Issues58 (58)https://github.com/microsoft/TypeScript-Website/issues
Pull requests164 (164)https://github.com/microsoft/TypeScript-Website/pulls
Actionshttps://github.com/microsoft/TypeScript-Website/actions
Security and qualityhttps://github.com/microsoft/TypeScript-Website/security
Insightshttps://github.com/microsoft/TypeScript-Website/insights
https://github.com/microsoft/TypeScript-Website
New issuehttps://github.com/login?return_to=https://github.com/microsoft/TypeScript-Website/issues/100
New issuehttps://github.com/login?return_to=https://github.com/microsoft/TypeScript-Website/issues/100
vutting4221/TypeScript-Website#3https://github.com/vutting4221/TypeScript-Website/pull/3
Website Internationalization Roadmaphttps://github.com/microsoft/TypeScript-Website/issues/100#top
vutting4221/TypeScript-Website#3https://github.com/vutting4221/TypeScript-Website/pull/3
RoadmapSomething which describes a long term visionhttps://github.com/microsoft/TypeScript-Website/issues?q=state%3Aopen%20label%3A%22Roadmap%22
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Oct 27, 2019https://github.com/microsoft/TypeScript-Website/issues/100#issue-512999500
TypeScript Discordhttps://discord.gg/typescript
ts-web-translatehttps://discord.gg/gG7nsGA
v2https://github.com/microsoft/TypeScript-Website/tree/v2
http://www.typescriptlang.org/v2/http://www.typescriptlang.org/v2/
Create an example PR which shows how to add a language #181https://github.com/microsoft/TypeScript-Website/pull/181
#180https://github.com/microsoft/TypeScript-Website/pull/180
Full docs herehttps://github.com/microsoft/TypeScript-Website/tree/v2/packages/playground-examples
in the copy folder of the 'playground-examples'https://github.com/microsoft/TypeScript-Website/tree/v2/packages/playground-examples
Full docs herehttps://github.com/microsoft/TypeScript-Website/tree/v2/packages/tsconfig-reference
Check out this folderhttps://github.com/microsoft/TypeScript-Website/tree/v2/packages/tsconfig-reference/
Orta Therox (orta)https://github.com/orta
on Nov 13, 2019https://github.com/microsoft/TypeScript-Website/issues/100#event-2793845401
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Nov 13, 2019https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-553235628
Examplehttps://github.com/gatsbyjs/gatsby-pt-BR
Orta Therox (orta)https://github.com/orta
RoadmapSomething which describes a long term visionhttps://github.com/microsoft/TypeScript-Website/issues?q=state%3Aopen%20label%3A%22Roadmap%22
on Nov 13, 2019https://github.com/microsoft/TypeScript-Website/issues/100#event-2795129992
Orta Therox (orta)https://github.com/orta
on Nov 13, 2019https://github.com/microsoft/TypeScript-Website/issues/100#event-2797006731
Orta Therox (orta)https://github.com/orta
on Nov 18, 2019https://github.com/microsoft/TypeScript-Website/issues/100#event-2808434650
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Jan 2, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-570232246
#163https://github.com/microsoft/TypeScript-Website/pull/163
https://github.com/glaucia86
Glaucia Lemos (glaucia86)https://github.com/glaucia86
on Jan 14, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-574418122
Orta Therox (@orta)https://github.com/orta
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Jan 15, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-574667649
https://github.com/Naturalclar
Jesse Katsumata (Naturalclar)https://github.com/Naturalclar
on Jan 16, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-574939369
Orta Therox (@orta)https://github.com/orta
https://github.com/evanSe
Evan Seaward (evanSe)https://github.com/evanSe
on Feb 5, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-582580497
Orta Therox (@orta)https://github.com/orta
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Feb 5, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-582665503
Evan Seaward (@evanSe)https://github.com/evanSe
documentationhttps://www.typescriptlang.org/v2/en/documentation/
codehttps://github.com/microsoft/TypeScript-website/blob/46baa2238c5072ba03792fef993bf09cb843e4c0/packages/typescriptlang-org/src/pages/documentation.en.tsx#L1
the templatehttps://github.com/microsoft/TypeScript-website/blob/46baa2238c5072ba03792fef993bf09cb843e4c0/packages/typescriptlang-org/src/copy/en/nav.ts#L1
english languagehttps://github.com/microsoft/TypeScript-website/blob/46baa2238c5072ba03792fef993bf09cb843e4c0/packages/typescriptlang-org/src/copy/en.ts#L2
the React componenthttps://github.com/microsoft/TypeScript-website/blob/46baa2238c5072ba03792fef993bf09cb843e4c0/packages/typescriptlang-org/src/components/layout/TopNav.tsx#L14-L19
i("key")to get the texthttps://github.com/microsoft/TypeScript-website/blob/46baa2238c5072ba03792fef993bf09cb843e4c0/packages/typescriptlang-org/src/components/layout/TopNav.tsx#L59-L60
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Jul 20, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-661170220
#790https://github.com/microsoft/TypeScript-Website/pull/790
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Jul 23, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-663283280
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Aug 7, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-670612583
#873https://github.com/microsoft/TypeScript-Website/pull/873
https://github.com/KingDarBoja
KingDarBoja (KingDarBoja)https://github.com/KingDarBoja
on Aug 7, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-670614631
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Aug 7, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-670619674
https://github.com/danilofuchs
Danilo Fuchs (danilofuchs)https://github.com/danilofuchs
on Aug 7, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-670773717
https://github.com/khaosdoctor
Lucas Santos (khaosdoctor)https://github.com/khaosdoctor
on Aug 8, 2020https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-670799063
KingDarBoja (@KingDarBoja)https://github.com/KingDarBoja
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Jan 25, 2021https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-766734207
#1480https://github.com/microsoft/TypeScript-Website/issues/1480
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Feb 1, 2021https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-770716222
https://github.com/microsoft/TypeScript-Website-Localizations/https://github.com/microsoft/TypeScript-Website-Localizations/
Orta Therox (orta)https://github.com/orta
on Feb 12, 2021https://github.com/microsoft/TypeScript-Website/issues/100#event-4324887203
https://github.com/orta
Orta Therox (orta)https://github.com/orta
on Jan 12, 2022https://github.com/microsoft/TypeScript-Website/issues/100#issuecomment-1011159539
Orta Therox (orta)https://github.com/orta
completedhttps://github.com/microsoft/TypeScript-Website/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
on Jan 12, 2022https://github.com/microsoft/TypeScript-Website/issues/100#event-5881107086
Sign up for freehttps://github.com/signup?return_to=https://github.com/microsoft/TypeScript-Website/issues/100
Sign in to commenthttps://github.com/login?return_to=https://github.com/microsoft/TypeScript-Website/issues/100
RoadmapSomething which describes a long term visionhttps://github.com/microsoft/TypeScript-Website/issues?q=state%3Aopen%20label%3A%22Roadmap%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.