Adding Brazilian Portuguese translation (#137)

Author: edgarberlinck

README-pt_BR.md

@@ -421,12 +421,18 @@ class Animal {
     constructor(public name: string) {}
 }
 class Dog extends Animal {
-    constructor(public name: string, public bark: () => void) {
+    constructor(
+        public name: string,
+        public bark: () => void
+    ) {
         super(name);
     }
 }
 class Cat extends Animal {
-    constructor(public name: string, public meow: () => void) {
+    constructor(
+        public name: string,
+        public meow: () => void
+    ) {
         super(name);
     }
 }
@@ -1996,9 +2002,9 @@ TypeScript 中的相等缩小通过检查变量是否等于特定值来相应缩
 const checkStatus = (status: 'success' | 'error') => {
     switch (status) {
         case 'success':
-            return true
+            return true;
         case 'error':
-            return null
+            return null;
     }
 };
 ```

README-zh_CN.md

@@ -2,7 +2,8 @@ export enum Language {
     en_EN = 'en_EN',
     zh_CN = 'zh_CN',
     it_IT = 'it_IT',
+    pt_BR = 'pt_BR',
 }
-export type Languages = [Language.en_EN, Language.zh_CN, Language.it_IT]
+export type Languages = [Language.en_EN, Language.zh_CN, Language.it_IT, Language.pt_BR]
 
-export const languages: Languages = [Language.en_EN, Language.zh_CN, Language.it_IT]
+export const languages: Languages = [Language.en_EN, Language.zh_CN, Language.it_IT, Language.pt_BR]

tools/i18n.ts

@@ -7,15 +7,18 @@ DIR_DOWNLOADS="downloads"
 INPUT_EN="README"
 INPUT_CN="README-zh_CN"
 INPUT_IT="README-it_IT"
+INPUT_PT="README-pt_BR"
 
 OUTPUT_EN="typescript-book"
 OUTPUT_CN="typescript-book-zh_CN"
 OUTPUT_IT="typescript-book-it_IT"
+OUTPUT_PT="typescript-book-pt_BR"
 
 AUTHOR="Simone Poggiali"
 TITLE_EN="The Concise TypeScript Book"
 TITLE_CN="# 简洁的TypeScript之书"
 TITLE_IT="The Concise TypeScript Book"
+TITLE_PT="The Concise TypeScript Book"
 
 cd ../
 
@@ -45,15 +48,18 @@ fi
 pandoc -o $DIR_DOWNLOADS/$OUTPUT_EN.epub --metadata title="$TITLE_EN" --metadata author="$AUTHOR" -s $INPUT_EN.md
 pandoc -o $DIR_DOWNLOADS/$OUTPUT_CN.epub --metadata title="$TITLE_CN" --metadata author="$AUTHOR" -s $INPUT_CN.md
 pandoc -o $DIR_DOWNLOADS/$OUTPUT_IT.epub --metadata title="$TITLE_IT" --metadata author="$AUTHOR" -s $INPUT_IT.md
+pandoc -o $DIR_DOWNLOADS/$OUTPUT_PT.epub --metadata title="$TITLE_PT" --metadata author="$AUTHOR" -s $INPUT_PT.md
 
 # Validate eBooks
-epubcheck $DIR_DOWNLOADS/$OUTPUT_CN.epub
+epubcheck $DIR_DOWNLOADS/$OUTPUT_EN.epub
 epubcheck $DIR_DOWNLOADS/$OUTPUT_CN.epub
 epubcheck $DIR_DOWNLOADS/$OUTPUT_IT.epub
+epubcheck $DIR_DOWNLOADS/$OUTPUT_PT.epub
 
 # Generate PDFs
 ebook-convert $DIR_DOWNLOADS/$OUTPUT_EN.epub $DIR_DOWNLOADS/$OUTPUT_EN.pdf --pdf-page-numbers
 ebook-convert $DIR_DOWNLOADS/$OUTPUT_CN.epub $DIR_DOWNLOADS/$OUTPUT_CN.pdf --pdf-page-numbers
 ebook-convert $DIR_DOWNLOADS/$OUTPUT_IT.epub $DIR_DOWNLOADS/$OUTPUT_IT.pdf --pdf-page-numbers
+ebook-convert $DIR_DOWNLOADS/$OUTPUT_PT.epub $DIR_DOWNLOADS/$OUTPUT_PT.pdf --pdf-page-numbers
 
 echo "Books were created. Please commit!"

tools/make-books.sh

@@ -41,6 +41,10 @@ export default defineConfig({
                     label: 'Italiano',
                     lang: 'it-IT',
                 },
+                "pt-br": {
+                    label: "Português (Brasil)",
+                    lang: "pt-BR"
+                }
             },
             sidebar: [
                 {

website/astro.config.mjs

@@ -12,3 +12,4 @@ This book has been translated into several language versions, including:
 
 [Italian](https://github.com/gibbok/typescript-book/blob/main/README-it_IT.md)
 
+[Português (Brasil)](https://github.com/gibbok/typescript-book/blob/main/README-pt_BR.md)

website/src/content/docs/book/translations.md

@@ -12,3 +12,4 @@ Questo libro è stato tradotto in diverse lingue, tra cui:
 
 [Italiano](https://github.com/gibbok/typescript-book/blob/main/README-it_IT.md)
 
+[Português (Brasil)](https://github.com/gibbok/typescript-book/blob/main/README-pt_BR.md)

website/src/content/docs/it-it/book/translations.md

@@ -0,0 +1,17 @@
+---
+title: Sobre o Autor
+sidebar:
+  order: 6
+  label: 6. Sobre o Autor
+---
+
+
+Simone Poggiali é um experiente Staff Engineer com uma paixão por escrever código de nível profissional desde os anos 90. Ao longo de sua carreira internacional, ele contribuiu para numerosos projetos para uma ampla gama de clientes, desde startups até grandes organizações. Empresas notáveis como HelloFresh, Siemens, O2, Leroy Merlin e Snowplow se beneficiaram de sua expertise e dedicação.
+
+Você pode entrar em contato com Simone Poggiali nas seguintes plataformas:
+
+* LinkedIn: [https://www.linkedin.com/in/simone-poggiali](https://www.linkedin.com/in/simone-poggiali)
+* GitHub: [https://github.com/gibbok](https://github.com/gibbok)
+* X.com: [https://x.com/gibbok_coding](https://x.com/gibbok_coding)
+* Email: gibbok.coding📧gmail.com
+

website/src/content/docs/pt-br/book/about-the-author.md

@@ -0,0 +1,22 @@
+---
+title: Tipo Any
+sidebar:
+  order: 44
+  label: 44. Tipo Any
+---
+
+
+O tipo `any` é um tipo especial (supertipo universal) que pode ser usado para representar qualquer tipo de valor (primitivos, objetos, arrays, funções, erros, símbolos). Ele é frequentemente usado em situações onde o tipo de um valor não é conhecido em tempo de compilação, ou ao trabalhar com valores de APIs externas ou bibliotecas que não possuem tipagens TypeScript.
+
+Ao utilizar o tipo `any`, você está indicando ao compilador TypeScript que os valores devem ser representados sem quaisquer limitações. Para maximizar a segurança de tipos em seu código, considere o seguinte:
+
+* Limite o uso de `any` a casos específicos onde o tipo é verdadeiramente desconhecido.
+* Não retorne tipos `any` de uma função, pois você perderá a segurança de tipos no código que usa essa função, enfraquecendo sua segurança de tipos.
+* Em vez de `any`, use `@ts-ignore` se você precisar silenciar o compilador.
+
+```typescript
+let value: any;
+value = true; // Válido
+value = 7; // Válido
+```
+

website/src/content/docs/pt-br/book/any-type.md

@@ -0,0 +1,22 @@
+---
+title: Atribuições
+sidebar:
+  order: 21
+  label: 21. Atribuições
+---
+
+
+O narrowing do TypeScript usando atribuições é uma maneira de estreitar o tipo de uma variável com base no valor atribuído a ela. Quando uma variável recebe um valor, o TypeScript infere seu tipo com base no valor atribuído e estreita o tipo da variável para corresponder ao tipo inferido.
+
+```typescript
+let value: string | number;
+value = 'hello';
+if (typeof value === 'string') {
+    console.log(value.toUpperCase());
+}
+value = 42;
+if (typeof value === 'number') {
+    console.log(value.toFixed(2));
+}
+```
+