Skip to content

docs(i18n-id): Provide Indonesian translation for documentation #1260

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Nov 14, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 80 additions & 0 deletions packages/documentation/copy/id/Nightly Builds.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
---
title: Nightly Builds
layout: docs
permalink: /id/docs/handbook/nightly-builds.html
oneline: Cara menggunakan nightly build TypeScript
translatable: true
---

_Nightly build_ dari _branch_ [master TypeScript](https://github.com/Microsoft/TypeScript/tree/master) diterbitkan pada tengah malam, di zona waktu PST ke npm.
Berikut adalah cara untuk mendapatkan versi ini dan cara menggunakannya.

## Menggunakan npm

```shell
npm install -g typescript@next
```

## Memperbarui IDE-mu untuk menggunakan _nightly builds_

Anda juga dapat memperbarui IDE-mu untuk menggunakan _nightly_ drop.
Pertama, Anda akan perlu untuk memasang package melalui npm.
Anda juga dapat memasang npm _package_ secara global atau pada direktori `node_modules` di dalam proyekmu.

Pada tahap ini diasumsikan bahwa `typescript@next` sudah dipasang.

### Visual Studio Code

Perbarui `.vscode/settings.json` dengan cara berikut:

```json
"typescript.tsdk": "<path ke folder-mu>/node_modules/typescript/lib"
```

Informasi lebih lanjut ada di [Dokumentasi VSCode](https://code.visualstudio.com/Docs/languages/typescript#_using-newer-typescript-versions).

### Sublime Text

Perbarui berkas `Settings - User` dengan cara berikut:

```json
"typescript_tsdk": "<path ke direktorimu>/node_modules/typescript/lib"
```

Informasi lebih lanjut ada di [Dokumentasi pemasangan _Plugin_ TypeScript untuk Sublime Text](https://github.com/Microsoft/TypeScript-Sublime-Plugin#installation).

### Visual Studio 2013 dan 2015

> Catatan: Sebagian besar perubahan tidak mengharuskan anda untuk memasang versi terbaru dari _plugin_ VS TypeScript.

Saat ini, _Nightly build_ tidak menyertakan _plugin_ secara lengkap, tapi kami sedang mengupayakan untuk menerbitkan sebuah _installer_ di _nightly_.

1. Unduh kode [VSDevMode.ps1](https://github.com/Microsoft/TypeScript/blob/master/scripts/VSDevMode.ps1) kode.

> 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).

2. Melalui perintah PowerShell, jalankan:

Untuk VS 2015:

```posh
VSDevMode.ps1 14 -tsScript <path ke direktorimu>/node_modules/typescript/lib
```

Untuk VS 2013:

```posh
VSDevMode.ps1 12 -tsScript <path ke folder-mu>/node_modules/typescript/lib
```

### IntelliJ IDEA (Mac)

Masuk ke `Preferences` > `Languages & Frameworks` > `TypeScript`:

> Versi TypeScript: Jika anda memasangnya dengan npm, maka akan ada di `/usr/local/lib/node_modules/typescript/lib`

### IntelliJ IDEA (Windows)

Masuk ke `File` > `Settings` > `Languages & Frameworks` > `TypeScript`:

> Versi TypeScript: Jika anda memasangnya dengan npm, maka akan ada di `C:\Users\USERNAME\AppData\Roaming\npm\node_modules\typescript\lib`
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
---
title: Membuat Berkas .d.ts dari berkas .js
layout: docs
permalink: /id/docs/handbook/declaration-files/dts-from-js.html
oneline: "Bagaimana cara menambahkan hasil d.ts ke proyek JavaScript"
translatable: true
---

[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.

Pengaturan ini berarti Anda memiliki _editor_ yang mendukung TypeScript tanpa memindahkan proyek anda ke TypeScript, atau harus memelihara berkas .d.ts di basis kodemu.
TypeScript mendukung sebagian besar tag JSDoc, Anda bisa menemukannya [di referensi ini](/docs/handbook/type-checking-javascript-files.html#supported-jsdoc).

## Menyiapkan proyekmu untuk menggunakan berkas .d.ts

Untuk menambahkan pembuatan berkas .d.ts di proyekmu, Anda perlu melakukan empat langkah berikut:

- Tambahkan TypeScript ke dependensi _dev_ Anda
- Tambahkan `tsconfig.json` untuk mengkonfigurasi TypeScript
- Jalankan kompilator TypeScript untuk menghasilkan berkas d.ts yang sesuai untuk berkas JS
- (_opsional_) Sunting package.json Anda untuk mereferensikan tipe

### Menambahkan TypeScript

Anda bisa mempelajari cara melakukan ini di [halaman instalasi](/download) kami.

### TSConfig

TSConfig adalah berkas jsonc yang mengkonfigurasi kedua _flag_ kompilator Anda, dan menyatakan di mana mencari berkas.
Dalam kasus ini, Anda menginginkan berkas seperti berikut:

```json5
{
// Ubah ini agar sesuai dengan proyek Anda
include: ["src/**/*"],

compilerOptions: {
// Memberi tahu TypeScript untuk membaca berkas JS,
// karena biasanya berkas tersebut diabaikan sebagai berkas sumber
allowJs: true,
// Hasilkan berkas d.ts
declaration: true,
// Proses kompilator ini seharusnya
// hanya mengeluarkan berkas d.ts
emitDeclarationOnly: true,
// Tipe harus masuk ke direktori ini.
// Menghapus ini akan menempatkan berkas .d.ts
// di sebelah berkas .js
outDir: "dist",
},
}
```

Anda dapat mempelajari lebih lanjut tentang opsi di [referensi tsconfig](/reference).
Alternatif untuk menggunakan berkas TSConfig adalah CLI, ini adalah perilaku yang sama seperti perintah CLI.

```sh
npx typescript src/**/*.js --declaration --allowJs --emitDeclarationOnly --outDir types
```

## Menjalankan kompilator

Anda bisa mempelajari bagaimana melakukan ini di [halaman pemasangan](/download) TypeScript kami.
Anda perlu memastikan berkas-berkas ini disertakan dalam package Anda jika Anda memiliki berkas dalam `gitignore` proyek Anda.

## Menyunting berkas package.json

TypeScript mereplikasi resolusi _node_ untuk modul di `package.json`, dengan langkah tambahan untuk menemukan berkas .d.ts.
Secara garis besar, Pertama-tama resolusi akan memeriksa bagian `"types"` yang opsional, kemudian bidang `"main"`, dan terakhir akan mencoba `index.d.ts` di _root_.

| Package.json | Location of default .d.ts |
| :------------------------ | :----------------------------- |
| No "types" field | checks "main", then index.d.ts |
| "types": "main.d.ts" | main.d.ts |
| "types": "./dist/main.js" | ./main/main.d.ts |

Jika tidak ada, maka "main" akan digunakan

| Package.json | Location of default .d.ts |
| :----------------------- | :------------------------ |
| No "main" field | index.d.ts |
| "main":"index.js" | index.d.ts |
| "main":"./dist/index.js" | ./dist/index.d.ts |

## Tips

Jika kamu suka menulis tes untuk berkas .d.ts, coba [tsd](https://github.com/SamVerschueren/tsd).
70 changes: 70 additions & 0 deletions packages/documentation/copy/id/javascript/Intro to JS with TS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
---
title: Memanfaatkan Typescript pada Proyek JS
layout: docs
permalink: /id/docs/handbook/intro-to-js-ts.html
oneline: Cara menambahkan pemeriksaan tipe data pada berkas JavaScript menggunakan TypeScript
translatable: true
---

Sistem tipe data di TypeScript memiliki tingkat keketatan yang berbeda saat bekerja dengan basis kode:

- Sistem tipe data yang hanya berdasarkan pada inferensi dengan kode JavaScript
- Pengetikkan secara bertahap di JavaScript [melalui JSDoc](/docs/handbook/jsdoc-supported-types.html)
- Menggunakan `// @ts-check` di berkas JavaScript
- Kode TypeScript
- TypeScript dengan [`strict`](/tsconfig#strict) diaktifkan

Setiap langkah mewakili tahapan sistem tipe yang lebih aman, tetapi tidak setiap proyek membutuhkan tingkat verifikasi seperti itu.

## TypeScript dengan JavaScript

Ini ketika _editor_-mu yang menggunakan TypeScript untuk menyediakan _tool_, seperti _auto-complete_, _jump to symbol_, dan _refactoring_, misalnya penamaan ulang.
Di [Homepage](/) tersedia daftar _editor_ yang memiliki plugin TypeScript.

## Menyediakan Type Hints di JS melalui JSDoc

Di berkas `.js`, tipe sering kali dapat diketahui. Namun ketika tipe tidak diketahui, mereka bisa ditentukan menggunakan sintaks JSDoc.

Anotasi JSDoc diletakkan sebelum mendeklarasikan suatu hal. Seperti contoh berikut:

```js twoslash
/** @type {number} */
var x;

x = 0; // OK
x = false; // OK?!
```

Anda dapat menemukan daftar lengkap mengenai dukungan pola JSDoc [di Tipe-tipe yang didukung JSDoc](/docs/handbook/jsdoc-supported-types.html)

## `@ts-check`

Baris terakhir dari contoh kode sebelumnya akan menimbulkan kesalahan dalam TypeScript, tetapi tidak secara bawaan dalam proyek JS.
Untuk mengaktifkan galat dalam berkas JavaScript-mu, tambahkan: `// @ ts-check` ke baris pertama dalam berkas`.js` Anda agar TypeScript dapat memeriksa kesalahan.

```js twoslash
// @ts-check
// @errors: 2322
/** @type {number} */
var x;

x = 0; // OK
x = false; // Not OK
```

Jika anda memiliki banyak berkas JavaScript yang ingin ditambahkan pemeriksaan galatnya, Anda bisa beralhir menggunakan [`jsconfig.json`](/docs/handbook/tsconfig-json.html).
Dengan begitu, Anda tidak perlu menambahkan `// @ts-nocheck` di tiap berkasnya.

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`.

```js twoslash
// @ts-check
/** @type {number} */
var x;

x = 0; // OK
// @ts-expect-error
x = false; // Not OK
```

Untuk mempelajari lebih lanjut bagaimana JavaScript diinterpretasi oleh TypeScript, Anda dapat membaca [Bagaimana TS Type Memeriksa JS](/docs/handbook/type-checking-javascript-files.html)
Loading