Skip to content

[PT-BR] translating 'rootDir.md' tsconfig-reference file #826

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 2 commits into from
Jul 31, 2020
Merged
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
65 changes: 65 additions & 0 deletions packages/tsconfig-reference/copy/pt/options/rootDir.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
display: "Diretório Raiz"
oneline: "Define o diretório raiz dos seus arquivos fonte"
---

**Padrão**: O caminho mais longo em comum entre todos os arquivos que não são de declaração. Se `composite` está definido, o padrão será o diretório contendo o arquivo `tsconfig.json`.

Quando TypeScript compila os arquivos, ele mantém a estrutura dos diretório de saída igual a dos diretório de entrada.

Por exemplo, suponhamos que você tenha alguns arquivos de entrada:

```
MeuProj
├── tsconfig.json
├── core
│ ├── a.ts
│ ├── b.ts
│ ├── sub
│ │ ├── c.ts
├── types.d.ts
```

O valor inferido para `rootDir` é o caminho mais longo em comum entre todos os arquivos que não são de declaração, que neste caso é `core/`.

Se o seu `outDir` fosse `dist`, TypeScript escreveria esta árvore:

```
MeuProj
├── dist
│ ├── a.ts
│ ├── b.ts
│ ├── sub
│ │ ├── c.ts
```

Contudo, você pode ter a intenção de que `core` seja parte da estrutura do diretório de saída.
Ao definir `rootDir: "."` em `tsconfig.json`, TypeScript escreveria esta árvore:

```
MeuProj
├── dist
│ ├── core
│ │ ├── a.js
│ │ ├── b.js
│ │ ├── sub
│ │ │ ├── c.js
```

Importante, a opção `rootDir` **não altera quais arquivos se tornam parte da compilação**, pois não há interação com `include`, `exclude`, ou com a propriedade `files` em `tsconfig.json`.

Note que TypeScript nunca irá escrever um arquivo de saída em um diretório fora de `outDir`, e nunca irá pular a emissão de um arquivo.
Por este motivo, `rootDir` também impõe que todos arquivos que precisam ser emitidos estejam abaixo do caminho `rootDir`.

Por exemplo, digamos que você tivesse esta árvore:

```
MeuProj
├── tsconfig.json
├── core
│ ├── a.ts
│ ├── b.ts
├── ajudantes.ts
```

Seria um erro especificar `rootDir` como `core` _e_ `include` como `*`, porque estaria sendo criado um arquivo (`ajudantes.ts`) que precisaria ser emitido _fora_ do `outDir` (i.e. `../ajudantes.js`).