Skip to content

Commit 0a0ebd4

Browse files
author
Orta Therox
authored
Merge pull request #826 from Leonardogrtt/leonardogrtt-ptbr-translation
[PT-BR] translating 'rootDir.md' tsconfig-reference file
2 parents d7aa5ff + b40c317 commit 0a0ebd4

File tree

1 file changed

+65
-0
lines changed
  • packages/tsconfig-reference/copy/pt/options

1 file changed

+65
-0
lines changed
Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
display: "Diretório Raiz"
3+
oneline: "Define o diretório raiz dos seus arquivos fonte"
4+
---
5+
6+
**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`.
7+
8+
Quando TypeScript compila os arquivos, ele mantém a estrutura dos diretório de saída igual a dos diretório de entrada.
9+
10+
Por exemplo, suponhamos que você tenha alguns arquivos de entrada:
11+
12+
```
13+
MeuProj
14+
├── tsconfig.json
15+
├── core
16+
│ ├── a.ts
17+
│ ├── b.ts
18+
│ ├── sub
19+
│ │ ├── c.ts
20+
├── types.d.ts
21+
```
22+
23+
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/`.
24+
25+
Se o seu `outDir` fosse `dist`, TypeScript escreveria esta árvore:
26+
27+
```
28+
MeuProj
29+
├── dist
30+
│ ├── a.ts
31+
│ ├── b.ts
32+
│ ├── sub
33+
│ │ ├── c.ts
34+
```
35+
36+
Contudo, você pode ter a intenção de que `core` seja parte da estrutura do diretório de saída.
37+
Ao definir `rootDir: "."` em `tsconfig.json`, TypeScript escreveria esta árvore:
38+
39+
```
40+
MeuProj
41+
├── dist
42+
│ ├── core
43+
│ │ ├── a.js
44+
│ │ ├── b.js
45+
│ │ ├── sub
46+
│ │ │ ├── c.js
47+
```
48+
49+
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`.
50+
51+
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.
52+
Por este motivo, `rootDir` também impõe que todos arquivos que precisam ser emitidos estejam abaixo do caminho `rootDir`.
53+
54+
Por exemplo, digamos que você tivesse esta árvore:
55+
56+
```
57+
MeuProj
58+
├── tsconfig.json
59+
├── core
60+
│ ├── a.ts
61+
│ ├── b.ts
62+
├── ajudantes.ts
63+
```
64+
65+
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`).

0 commit comments

Comments
 (0)