Skip to content

Commit f62f100

Browse files
authored
Merge branch 'microsoft:main' into main
2 parents a4d54e4 + 6b05263 commit f62f100

File tree

146 files changed

+16762
-179
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

146 files changed

+16762
-179
lines changed

.github/CODEOWNERS

+12-5
Original file line numberDiff line numberDiff line change
@@ -29,11 +29,11 @@ docs/typescriptlang/zh.ts @Kingwl [translation] [zh]
2929
docs/documentation/zh/**/*.md @Kingwl [translation] [zh]
3030

3131
# Collaborators for Korean Translation of the Website
32-
docs/playground/ko @Bumkeyy @yeonjuan @guyeol [translation] [ko]
33-
docs/tsconfig/ko/**/*.md @Bumkeyy @yeonjuan @guyeol [translation] [ko]
34-
docs/typescriptlang/ko/**/*.ts @Bumkeyy @yeonjuan @guyeol [translation] [ko]
35-
docs/typescriptlang/ko.ts @Bumkeyy @yeonjuan @guyeol [translation] [ko]
36-
docs/documentation/ko/**/*.md @Bumkeyy @yeonjuan @guyeol [translation] [ko]
32+
docs/playground/ko @Bumkeyy @yeonjuan @guyeol @dvlprsh [translation] [ko]
33+
docs/tsconfig/ko/**/*.md @Bumkeyy @yeonjuan @guyeol @dvlprsh [translation] [ko]
34+
docs/typescriptlang/ko/**/*.ts @Bumkeyy @yeonjuan @guyeol @dvlprsh [translation] [ko]
35+
docs/typescriptlang/ko.ts @Bumkeyy @yeonjuan @guyeol @dvlprsh [translation] [ko]
36+
docs/documentation/ko/**/*.md @Bumkeyy @yeonjuan @guyeol @dvlprsh [translation] [ko]
3737

3838
# Collaborators for Indonesian Translation of the Website
3939
docs/playground/id @jefrydco @nusendra @mazipan @mandaputtra [translation] [id]
@@ -62,3 +62,10 @@ docs/tsconfig/it/**/*.md @Nabster101 @DeltaPy @PyGera [translation] [it]
6262
docs/typescriptlang/it/**/*.ts @Nabster101 @DeltaPy @PyGera [translation] [it]
6363
docs/typescriptlang/it.ts @Nabster101 @DeltaPy @PyGera [translation] [it]
6464
docs/documentation/it/**/*.md @Nabster101 @DeltaPy @PyGera [translation] [it]
65+
66+
# Collaborators for French Translation of the Website
67+
docs/playground/fr @ManuSquall @Ascor8522 [translation] [fr]
68+
docs/tsconfig/fr/**/*.md @ManuSquall @Ascor8522 [translation] [fr]
69+
docs/typescriptlang/fr/**/*.ts @ManuSquall @Ascor8522 [translation] [fr]
70+
docs/typescriptlang/fr.ts @ManuSquall @Ascor8522 [translation] [fr]
71+
docs/documentation/fr/**/*.md @ManuSquall @Ascor8522 [translation] [fr]

.github/workflows/CI.yml

+3
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,9 @@ jobs:
88
steps:
99
- uses: actions/checkout@v1
1010
- uses: actions/setup-node@v1
11+
with:
12+
node-version: "13.x"
13+
1114
- run: yarn
1215
- run: yarn docs-sync validate-against-en
1316

+7-4
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
name: Codeowners merging
22
on:
3-
pull_request_target: { types: [ opened, synchronize, reopened] }
4-
issue_comment: { types: created }
5-
pull_request_review: { types: submitted }
3+
pull_request_target: { types: [opened, synchronize, reopened] }
4+
issue_comment: { types: [created] }
5+
pull_request_review: { types: [submitted] }
66

77
jobs:
8-
build:
8+
merge-check:
99
runs-on: ubuntu-latest
1010

1111
steps:
@@ -14,3 +14,6 @@ jobs:
1414
env:
1515
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
1616
uses: OSS-Docs-Tools/code-owner-self-merge@master
17+
with:
18+
if_no_maintainers_add_label: 'maintainers'
19+
if_no_maintainers_assign: '@orta'

.github/workflows/post-localizations.yml

+3
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,9 @@ jobs:
99
steps:
1010
- uses: actions/checkout@v1
1111
- uses: actions/setup-node@v1
12+
with:
13+
node-version: "13.x"
14+
1215
- run: yarn install
1316

1417
- run: yarn danger ci

.github/workflows/weekly-contributions.yml

-15
This file was deleted.

.gitignore

+3
Original file line numberDiff line numberDiff line change
@@ -105,3 +105,6 @@ dist
105105

106106
# Related to @oss-docs/sync
107107
docs/**/en
108+
109+
# Then you can set this up yourself
110+
.vscode

README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ yarn lint
2020
yarn lint --watch
2121
```
2222

23-
That's it, you've got a copy of all the documentation and now can write documentation which follows the existing patterns.
23+
That's it, you've got a copy of all the documentation and now can write documentation which follows the existing patterns. There's a longer intro [in `welcome.md`](./welcome.md).
2424

2525
### How translations work
2626

attribution.json

+1-1
Large diffs are not rendered by default.
+80
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
title: Nightly Builds
3+
layout: docs
4+
permalink: /fr/docs/handbook/nightly-builds.html
5+
oneline: Comment utiliser une nightly build de TypeScript
6+
translatable: true
7+
---
8+
9+
Une nightly build de la branche [Typescript `main`](https://github.com/Microsoft/TypeScript/tree/main) est publiée avant minuit PST sur npm.
10+
Voici comment vous pouvez l'obtenir et l'utiliser avec vos outils.
11+
12+
## En utilisant npm
13+
14+
```shell
15+
npm install -g typescript@next
16+
```
17+
18+
## Mettre à jour votre IDE pour utiliser les nightly builds
19+
20+
Vous pouvez également mettre à jour votre IDE pour utiliser la nightly build.
21+
Vous devrez d'abord installer le package via npm.
22+
Vous pouvez soit installer le package npm globalement, soit dans un dossier local `node_modules`.
23+
24+
Le reste de cette section suppose que `typescript@next` est déjà installé.
25+
26+
### Visual Studio Code
27+
28+
Mettez à jour `.vscode/settings.json` avec les éléments suivants :
29+
30+
```json
31+
"typescript.tsdk": "<chemin vers votre dossier>/node_modules/typescript/lib"
32+
```
33+
34+
Plus d'informations sont disponibles sur la [documentation VSCode](https://code.visualstudio.com/Docs/languages/typescript#_using-newer-typescript-versions).
35+
36+
37+
### Sublime Text
38+
39+
Mettez à jour le fichier `Paramètres - Utilisateur` avec les éléments suivants :
40+
41+
```json
42+
"typescript_tsdk": "<chemin vers votre dossier>/node_modules/typescript/lib"
43+
```
44+
45+
Plus d'informations sont disponibles dans la [documentation d'installation du plug-in TypeScript pour Sublime Text](https://github.com/Microsoft/TypeScript-Sublime-Plugin#installation).
46+
47+
### Visual Studio 2013 et 2015
48+
49+
> Remarque : La plupart des modifications ne nécessitent pas l'installation d'une nouvelle version du plug-in VS TypeScript.
50+
51+
La nightly build n'inclut actuellement pas la configuration complète du plug-in, mais nous travaillons également à la publication d'un programme d'installation nigthly.
52+
53+
1. Téléchargez le script [VSDevMode.ps1](https://github.com/Microsoft/TypeScript/blob/main/scripts/VSDevMode.ps1).
54+
55+
> Voir également notre page wiki sur [l'utilisation d'un fichier de service de langue personnalisé](https://github.com/Microsoft/TypeScript/wiki/Dev-Mode-in-Visual-Studio#using-a-custom-language-service-file).
56+
57+
2. À partir d'une fenêtre de commande PowerShell, exécutez :
58+
59+
Pour VS 2015:
60+
```posh
61+
VSDevMode.ps1 14 -tsScript <chemin vers votre dossier>/node_modules/typescript/lib
62+
```
63+
64+
Pour VS 2013:
65+
66+
```posh
67+
VSDevMode.ps1 12 -tsScript <chemin vers votre dossier>/node_modules/typescript/lib
68+
```
69+
70+
### IntelliJ IDEA (Mac)
71+
72+
Allez dans `Préférences` > `Langues & Frameworks` > `TypeScript` :
73+
74+
> Version TypeScript : Si vous avez installé avec npm : `/usr/local/lib/node_modules/typescript/lib`
75+
76+
### IntelliJ IDEA (Windows)
77+
78+
Allez dans `Fichier` > `Paramètres` > `Langues & Frameworks` > `TypeScript` :
79+
80+
> Version TypeScript : Si vous avez installé avec npm : `C:\Users\USERNAME\AppData\Roaming\npm\node_modules\typescript\lib`
+14
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
title: Angular
3+
layout: docs
4+
permalink: /fr/docs/handbook/angular.html
5+
oneline: Utiliser Angular avec TypeScript
6+
deprecated: true
7+
---
8+
9+
Angular est un framework moderne entièrement construit en TypeScript et, par conséquent, l'utilisation de TypeScript avec Angular offre une expérience fluide.
10+
11+
La documentation d'Angular ne met pas seulement TypeScript au premier plan, mais l'utilise également comme langage principal.
12+
Dans cet esprit, [le site d'Angular](https://angular.io) sera toujours la référence la plus à jour pour utiliser Angular avec TypeScript.
13+
14+
Consultez le [guide de démarrage rapide ici](https://angular.io/docs/ts/latest/quickstart.html) pour commencer à apprendre Angular maintenant !
+26
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: React
3+
layout: docs
4+
permalink: /fr/docs/handbook/react.html
5+
oneline: Liens pour en savoir plus sur TypeScript et React
6+
translatable: true
7+
---
8+
9+
TypeScript prend en charge [JSX](/docs/handbook/jsx.html) et peut modéliser correctement les conventions utilisées dans les bases de code React comme `useState`.
10+
11+
### Mise en place d'un projet React
12+
13+
Aujourd'hui, il existe de nombreux frameworks qui prennent en charge TypeScript indépendamment: :
14+
15+
- [Create React App](https://create-react-app.dev) - [TS docs](https://create-react-app.dev/docs/adding-typescript/)
16+
- [Next.js](https://nextjs.org) - [TS docs](https://nextjs.org/learn/excel/typescript)
17+
- [Gatsby](https://www.gatsbyjs.org) - [TS Docs](https://www.gatsbyjs.org/docs/typescript/)
18+
19+
Tous ces éléments sont d'excellents points de départ. Nous [utilisons Gatsby](https://www.gatsbyjs.org/blog/2020-01-23-why-typescript-chose-gatsby/#reach-skip-nav) avec TypeScript pour [ce site Web](https://github.com/microsoft/TypeScript-Website/), ce qui peut également être une implémentation de référence utile.
20+
21+
### Documentation
22+
23+
Voici quelques-uns des meilleurs endroits pour trouver des informations à jour sur React et TypeScript :
24+
25+
- [Aide-mémoire de React et TypeScript](https://react-typescript-cheatsheet.netlify.app)
26+
- [React & Redux dans TypeScript](https://github.com/piotrwitek/react-redux-typescript-guide#react--redux-in-typescript---complete-guide)

docs/documentation/id/reference/JSX.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ Anda dapat menetapkan mode ini menggunakan _flag_ baris perintah `--jsx` atau op
3535

3636
> \*Catatan: Anda dapat menentukan fungsi _factory_ JSX yang akan digunakan saat menargetkan react JSX _emit_ dengan opsi `--jsxFactory` (nilai bawaan ke `React.createElement`)
3737
38-
## Opeartor `as`
38+
## Operator `as`
3939

4040
Ingat bagaimana menulis penegasan tipe:
4141

+80
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
title: Nightly Builds
3+
layout: docs
4+
permalink: /ko/docs/handbook/nightly-builds.html
5+
oneline: How to use a nightly build of TypeScript
6+
translatable: true
7+
---
8+
9+
[TypeScript의 `master`](https://github.com/Microsoft/TypeScript/tree/master) 브랜치의 nightly 빌드는 태평양 표준시(PST) 자정까지 NPM에 배포됩니다.
10+
도구를 사용하여 가져오는 방법과 사용하는 방법은 다음과 같습니다.
11+
12+
## npm 사용하기 (Using npm)
13+
14+
```shell
15+
npm install -g typescript@next
16+
```
17+
18+
## nightly 빌드를 사용하도록 IDE 업데이트 (Updating your IDE to use the nightly builds)
19+
20+
nightly drop을 사용하도록 IDE를 업데이트할 수 있습니다.
21+
먼저 npm을 통해 패키지를 설치해야 합니다.
22+
npm 패키지를 전역으로 설치하거나 로컬에 있는 `node_modules` 폴더에 설치할 수 있습니다.
23+
24+
이 섹션의 나머지 부분에서는 `typescript@next`가 이미 설치되어 있다고 가정합니다.
25+
26+
### 비주얼 스튜디오 코드 (Visual Studio Code)
27+
28+
`.vscode/settings.json` 파일을 다음과 같이 업데이트하세요:
29+
30+
```json
31+
"typescript.tsdk": "<path to your folder>/node_modules/typescript/lib"
32+
```
33+
34+
자세한 내용은 [VSCode 문서](https://code.visualstudio.com/Docs/languages/typescript#_using-newer-typescript-versions)를 참조하세요.
35+
36+
### 서브라임 텍스트 (Sublime Text)
37+
38+
`Settings - User` 파일을 다음과 같이 업데이트하세요:
39+
40+
```json
41+
"typescript_tsdk": "<path to your folder>/node_modules/typescript/lib"
42+
```
43+
44+
자세한 내용은 [서브라임 텍스트를 위한 TypeScript 플러그인 설치 문서](https://github.com/Microsoft/TypeScript-Sublime-Plugin#installation)를 참조하세요.
45+
46+
### 비주얼 스튜디오 2013 및 2015 (Visual Studio 2013 and 2015)
47+
48+
> 주의사항: 대부분의 변경 사항에는 새로운 버전의 VS TypeScript 플러그인을 설치할 필요는 없습니다.
49+
50+
현재 nightly 빌드에는 전체 플러그인 설정이 포함되어 있지 않지만 nightly 기반으로 설치 프로그램을 배포하기 위해 노력하고 있습니다.
51+
52+
1. [VSDevMode.ps1](https://github.com/Microsoft/TypeScript/blob/master/scripts/VSDevMode.ps1) 스크립트를 다운로드하세요.
53+
54+
> 또한 [커스텀 언어 서비스 파일 사용](https://github.com/Microsoft/TypeScript/wiki/Dev-Mode-in-Visual-Studio#using-a-custom-language-service-file)에 대한 위키 페이지를 참조하세요.
55+
56+
2. PowerShell 커맨드 라인 창에서 다음을 실행합니다:
57+
58+
VS 2015:
59+
60+
```posh
61+
VSDevMode.ps1 14 -tsScript <path to your folder>/node_modules/typescript/lib
62+
```
63+
64+
VS 2013:
65+
66+
```posh
67+
VSDevMode.ps1 12 -tsScript <path to your folder>/node_modules/typescript/lib
68+
```
69+
70+
### IntelliJ IDEA (Mac)
71+
72+
`Preferences` > `Languages & Frameworks` > `TypeScript`를 선택합니다:
73+
74+
> TypeScript 버전: npm으로 설치한 경우: `/usr/local/lib/node_modules/typescript/lib`
75+
76+
### IntelliJ IDEA (Windows)
77+
78+
`File` > `Settings` > `Languages & Frameworks` > `TypeScript`를 선택합니다:
79+
80+
> TypeScript 버전: npm으로 설치한 경우: `C:\Users\USERNAME\AppData\Roaming\npm\node_modules\typescript\lib`

0 commit comments

Comments
 (0)