Skip to content

Commit b6daddb

Browse files
ortaorta
committed
Initial commit
1 parent dbc4bf2 commit b6daddb

749 files changed

Lines changed: 39487 additions & 0 deletions

File tree

Some content is hidden

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

‎.gitignore‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,3 +102,6 @@ dist
102102

103103
# TernJS port file
104104
.tern-port
105+
106+
# Related to @oss-docs/sync
107+
docs/**/en

‎README.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,24 @@
1+
# TypeScript Website Localizations
2+
3+
A repo for handling localized versions of the TypeScript website content
4+
5+
### How this works
6+
7+
```sh
8+
git clone https://github.com/microsoft/TypeScript-Website-Localizations
9+
cd TypeScript-Website-Localizations
10+
11+
# Setup
12+
yarn
13+
14+
# Optional: Grab the English files
15+
yarn pull-en
16+
```
17+
18+
That's it, you've got a copy of all the documentation and now can write documentation which follows the existing patterns.
19+
20+
More docs to come.
21+
122

223
# Contributing
324

‎docs/documentation/id/Nightly Builds.md‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
title: Nightly Builds
3+
layout: docs
4+
permalink: /id/docs/handbook/nightly-builds.html
5+
oneline: Cara menggunakan nightly build TypeScript
6+
translatable: true
7+
---
8+
9+
_Nightly build_ dari _branch_ [master TypeScript](https://github.com/Microsoft/TypeScript/tree/master) diterbitkan pada tengah malam, di zona waktu PST ke npm.
10+
Berikut adalah cara untuk mendapatkan versi ini dan cara menggunakannya.
11+
12+
## Menggunakan npm
13+
14+
```shell
15+
npm install -g typescript@next
16+
```
17+
18+
## Memperbarui IDE-mu untuk menggunakan _nightly builds_
19+
20+
Anda juga dapat memperbarui IDE-mu untuk menggunakan _nightly_ drop.
21+
Pertama, Anda akan perlu untuk memasang package melalui npm.
22+
Anda juga dapat memasang npm _package_ secara global atau pada direktori `node_modules` di dalam proyekmu.
23+
24+
Pada tahap ini diasumsikan bahwa `typescript@next` sudah dipasang.
25+
26+
### Visual Studio Code
27+
28+
Perbarui `.vscode/settings.json` dengan cara berikut:
29+
30+
```json
31+
"typescript.tsdk": "<path ke folder-mu>/node_modules/typescript/lib"
32+
```
33+
34+
Informasi lebih lanjut ada di [Dokumentasi VSCode](https://code.visualstudio.com/Docs/languages/typescript#_using-newer-typescript-versions).
35+
36+
### Sublime Text
37+
38+
Perbarui berkas `Settings - User` dengan cara berikut:
39+
40+
```json
41+
"typescript_tsdk": "<path ke direktorimu>/node_modules/typescript/lib"
42+
```
43+
44+
Informasi lebih lanjut ada di [Dokumentasi pemasangan _Plugin_ TypeScript untuk Sublime Text](https://github.com/Microsoft/TypeScript-Sublime-Plugin#installation).
45+
46+
### Visual Studio 2013 dan 2015
47+
48+
> Catatan: Sebagian besar perubahan tidak mengharuskan anda untuk memasang versi terbaru dari _plugin_ VS TypeScript.
49+
50+
Saat ini, _Nightly build_ tidak menyertakan _plugin_ secara lengkap, tapi kami sedang mengupayakan untuk menerbitkan sebuah _installer_ di _nightly_.
51+
52+
1. Unduh kode [VSDevMode.ps1](https://github.com/Microsoft/TypeScript/blob/master/scripts/VSDevMode.ps1) kode.
53+
54+
> Lihat juga halaman wiki kami di [menggunakan berkas custom language service](https://github.com/Microsoft/TypeScript/wiki/Dev-Mode-in-Visual-Studio#using-a-custom-language-service-file).
55+
56+
2. Melalui perintah PowerShell, jalankan:
57+
58+
Untuk VS 2015:
59+
60+
```posh
61+
VSDevMode.ps1 14 -tsScript <path ke direktorimu>/node_modules/typescript/lib
62+
```
63+
64+
Untuk VS 2013:
65+
66+
```posh
67+
VSDevMode.ps1 12 -tsScript <path ke folder-mu>/node_modules/typescript/lib
68+
```
69+
70+
### IntelliJ IDEA (Mac)
71+
72+
Masuk ke `Preferences` > `Languages & Frameworks` > `TypeScript`:
73+
74+
> Versi TypeScript: Jika anda memasangnya dengan npm, maka akan ada di `/usr/local/lib/node_modules/typescript/lib`
75+
76+
### IntelliJ IDEA (Windows)
77+
78+
Masuk ke `File` > `Settings` > `Languages & Frameworks` > `TypeScript`:
79+
80+
> Versi TypeScript: Jika anda memasangnya dengan npm, maka akan ada di `C:\Users\USERNAME\AppData\Roaming\npm\node_modules\typescript\lib`

‎docs/documentation/id/javascript/Creating DTS files From JS.md‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
title: Membuat Berkas .d.ts dari berkas .js
3+
layout: docs
4+
permalink: /id/docs/handbook/declaration-files/dts-from-js.html
5+
oneline: "Bagaimana cara menambahkan hasil d.ts ke proyek JavaScript"
6+
translatable: true
7+
---
8+
9+
[Dengan TypeScript 3.7](/docs/handbook/release-notes/typescript-3-7.html#--declaration-and---allowjs), TypeScript menambahkan dukungan untuk menghasilkan berkas .d.ts dari JavaScript menggunakan sintaks JSDoc.
10+
11+
Pengaturan ini berarti Anda memiliki _editor_ yang mendukung TypeScript tanpa memindahkan proyek anda ke TypeScript, atau harus memelihara berkas .d.ts di basis kodemu.
12+
TypeScript mendukung sebagian besar tag JSDoc, Anda bisa menemukannya [di referensi ini](/docs/handbook/type-checking-javascript-files.html#supported-jsdoc).
13+
14+
## Menyiapkan proyekmu untuk menggunakan berkas .d.ts
15+
16+
Untuk menambahkan pembuatan berkas .d.ts di proyekmu, Anda perlu melakukan empat langkah berikut:
17+
18+
- Tambahkan TypeScript ke dependensi _dev_ Anda
19+
- Tambahkan `tsconfig.json` untuk mengkonfigurasi TypeScript
20+
- Jalankan kompilator TypeScript untuk menghasilkan berkas d.ts yang sesuai untuk berkas JS
21+
- (_opsional_) Sunting package.json Anda untuk mereferensikan tipe
22+
23+
### Menambahkan TypeScript
24+
25+
Anda bisa mempelajari cara melakukan ini di [halaman instalasi](/download) kami.
26+
27+
### TSConfig
28+
29+
TSConfig adalah berkas jsonc yang mengkonfigurasi kedua _flag_ kompilator Anda, dan menyatakan di mana mencari berkas.
30+
Dalam kasus ini, Anda menginginkan berkas seperti berikut:
31+
32+
```json5
33+
{
34+
// Ubah ini agar sesuai dengan proyek Anda
35+
include: ["src/**/*"],
36+
37+
compilerOptions: {
38+
// Memberi tahu TypeScript untuk membaca berkas JS,
39+
// karena biasanya berkas tersebut diabaikan sebagai berkas sumber
40+
allowJs: true,
41+
// Hasilkan berkas d.ts
42+
declaration: true,
43+
// Proses kompilator ini seharusnya
44+
// hanya mengeluarkan berkas d.ts
45+
emitDeclarationOnly: true,
46+
// Tipe harus masuk ke direktori ini.
47+
// Menghapus ini akan menempatkan berkas .d.ts
48+
// di sebelah berkas .js
49+
outDir: "dist",
50+
},
51+
}
52+
```
53+
54+
Anda dapat mempelajari lebih lanjut tentang opsi di [referensi tsconfig](/reference).
55+
Alternatif untuk menggunakan berkas TSConfig adalah CLI, ini adalah perilaku yang sama seperti perintah CLI.
56+
57+
```sh
58+
npx typescript src/**/*.js --declaration --allowJs --emitDeclarationOnly --outDir types
59+
```
60+
61+
## Menjalankan kompilator
62+
63+
Anda bisa mempelajari bagaimana melakukan ini di [halaman pemasangan](/download) TypeScript kami.
64+
Anda perlu memastikan berkas-berkas ini disertakan dalam package Anda jika Anda memiliki berkas dalam `gitignore` proyek Anda.
65+
66+
## Menyunting berkas package.json
67+
68+
TypeScript mereplikasi resolusi _node_ untuk modul di `package.json`, dengan langkah tambahan untuk menemukan berkas .d.ts.
69+
Secara garis besar, Pertama-tama resolusi akan memeriksa bagian `"types"` yang opsional, kemudian bidang `"main"`, dan terakhir akan mencoba `index.d.ts` di _root_.
70+
71+
| Package.json | Location of default .d.ts |
72+
| :------------------------ | :----------------------------- |
73+
| No "types" field | checks "main", then index.d.ts |
74+
| "types": "main.d.ts" | main.d.ts |
75+
| "types": "./dist/main.js" | ./main/main.d.ts |
76+
77+
Jika tidak ada, maka "main" akan digunakan
78+
79+
| Package.json | Location of default .d.ts |
80+
| :----------------------- | :------------------------ |
81+
| No "main" field | index.d.ts |
82+
| "main":"index.js" | index.d.ts |
83+
| "main":"./dist/index.js" | ./dist/index.d.ts |
84+
85+
## Tips
86+
87+
Jika kamu suka menulis tes untuk berkas .d.ts, coba [tsd](https://github.com/SamVerschueren/tsd).

‎docs/documentation/id/javascript/Intro to JS with TS.md‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: Memanfaatkan Typescript pada Proyek JS
3+
layout: docs
4+
permalink: /id/docs/handbook/intro-to-js-ts.html
5+
oneline: Cara menambahkan pemeriksaan tipe data pada berkas JavaScript menggunakan TypeScript
6+
translatable: true
7+
---
8+
9+
Sistem tipe data di TypeScript memiliki tingkat keketatan yang berbeda saat bekerja dengan basis kode:
10+
11+
- Sistem tipe data yang hanya berdasarkan pada inferensi dengan kode JavaScript
12+
- Pengetikkan secara bertahap di JavaScript [melalui JSDoc](/docs/handbook/jsdoc-supported-types.html)
13+
- Menggunakan `// @ts-check` di berkas JavaScript
14+
- Kode TypeScript
15+
- TypeScript dengan [`strict`](/tsconfig#strict) diaktifkan
16+
17+
Setiap langkah mewakili tahapan sistem tipe yang lebih aman, tetapi tidak setiap proyek membutuhkan tingkat verifikasi seperti itu.
18+
19+
## TypeScript dengan JavaScript
20+
21+
Ini ketika _editor_-mu yang menggunakan TypeScript untuk menyediakan _tool_, seperti _auto-complete_, _jump to symbol_, dan _refactoring_, misalnya penamaan ulang.
22+
Di [Homepage](/) tersedia daftar _editor_ yang memiliki plugin TypeScript.
23+
24+
## Menyediakan Type Hints di JS melalui JSDoc
25+
26+
Di berkas `.js`, tipe sering kali dapat diketahui. Namun ketika tipe tidak diketahui, mereka bisa ditentukan menggunakan sintaks JSDoc.
27+
28+
Anotasi JSDoc diletakkan sebelum mendeklarasikan suatu hal. Seperti contoh berikut:
29+
30+
```js twoslash
31+
/** @type {number} */
32+
var x;
33+
34+
x = 0; // OK
35+
x = false; // OK?!
36+
```
37+
38+
Anda dapat menemukan daftar lengkap mengenai dukungan pola JSDoc [di Tipe-tipe yang didukung JSDoc](/docs/handbook/jsdoc-supported-types.html)
39+
40+
## `@ts-check`
41+
42+
Baris terakhir dari contoh kode sebelumnya akan menimbulkan kesalahan dalam TypeScript, tetapi tidak secara bawaan dalam proyek JS.
43+
Untuk mengaktifkan galat dalam berkas JavaScript-mu, tambahkan: `// @ ts-check` ke baris pertama dalam berkas`.js` Anda agar TypeScript dapat memeriksa kesalahan.
44+
45+
```js twoslash
46+
// @ts-check
47+
// @errors: 2322
48+
/** @type {number} */
49+
var x;
50+
51+
x = 0; // OK
52+
x = false; // Not OK
53+
```
54+
55+
Jika anda memiliki banyak berkas JavaScript yang ingin ditambahkan pemeriksaan galatnya, Anda bisa beralhir menggunakan [`jsconfig.json`](/docs/handbook/tsconfig-json.html).
56+
Dengan begitu, Anda tidak perlu menambahkan `// @ts-nocheck` di tiap berkasnya.
57+
58+
TypeScript mungkin memberikan galat yang Anda tidak sepakati. Pada kasus tersebut, Anda bisa membiarkan galat itu spesifik dibaris manapun dengan menambahkan `// @ts-ignore` atau `// @ts-expect-error`.
59+
60+
```js twoslash
61+
// @ts-check
62+
/** @type {number} */
63+
var x;
64+
65+
x = 0; // OK
66+
// @ts-expect-error
67+
x = false; // Not OK
68+
```
69+
70+
Untuk mempelajari lebih lanjut bagaimana JavaScript diinterpretasi oleh TypeScript, Anda dapat membaca [Bagaimana TS Type Memeriksa JS](/docs/handbook/type-checking-javascript-files.html)

0 commit comments

Comments
 (0)