Estrutura e Interpretação de Programas de Computador

Adaptação em JavaScript

Tradução em pt-br de Structure and Interpretation of Computer Programs — JavaScript Adaptation

📚 Sobre o Projeto

Este é um projeto colaborativo de tradução para português brasileiro do livro SICP (Structure and Interpretation of Computer Programs) - JavaScript Adaptation. O SICP é um dos livros mais influentes sobre ciência da computação e programação, originalmente escrito por Harold Abelson e Gerald Jay Sussman.

🎯 Objetivos

• Traduzir todo o conteúdo do SICP.js para português brasileiro
• Tornar este conhecimento fundamental acessível para a comunidade de língua portuguesa
• Manter a qualidade técnica e didática do material original

🚀 Como Contribuir

Contribuições são muito bem-vindas! Você pode ajudar traduzindo novas seções, revisando traduções existentes ou melhorando a infraestrutura do projeto.

Configuração Rápida

# 1. Clone o repositório
git clone https://github.com/ibrahimcesar/estrutura-e-interpretacao-de-programas-de-computador-javascript.git
cd estrutura-e-interpretacao-de-programas-de-computador-javascript

# 2. Instale as dependências
make install

# 3. Execute os testes de qualidade
make check

Comandos Disponíveis

make help              # Mostra todos os comandos disponíveis
make lint              # Verifica formatação Markdown
make spell-check       # Verifica ortografia em português
make link-check        # Verifica links quebrados
make check             # Executa todas as verificações
make format            # Formata arquivos Markdown
make translation-status # Mostra progresso da tradução

Guia de Tradução

Para informações detalhadas sobre o processo de tradução, convenções de estilo, glossário de termos técnicos e melhores práticas, consulte o Guia de Tradução.

📖 Estrutura do Projeto

00/    # Prefácios e introdução
01/    # Capítulo 1: Construindo Abstrações com Funções
02/    # Capítulo 2: (em andamento)
...

🛠️ Tecnologias

• Markdown - Formato dos documentos
• markdownlint - Verificação de formatação
• pyspelling - Verificação ortográfica em português
• GitHub Actions - CI/CD

📋 Status da Tradução

Progresso Geral

Tradução: 🟢 Em Andamento
Capítulos Concluídos: 3/5
Progresso Estimado: ~60%

Detalhamento por Capítulo

📖 Capítulo 0: Prefácios e Introdução

• ✅ Prefácio de 1984 (foreword84.md)
• ✅ Prefácio de 1996 (prefaces96.md)
• ✅ Prefácio de 2003 (prefaces03.md)

Status: ✅ Completo (3/3)

---

📖 Capítulo 1: Construindo Abstrações com Funções

1.0 Introdução

• ✅ 1.0.md

1.1 Os Elementos da Programação

• ✅ 1.1.md (Introdução da seção)
• ✅ 1.1.1 Expressões
• ✅ 1.1.2 Nomenclatura e o Ambiente
• ✅ 1.1.3 Avaliando Combinações de Operadores
• ✅ 1.1.4 Funções Compostas
• ✅ 1.1.5 O Modelo de Substituição para Aplicação de Função
• ✅ 1.1.6 Expressões Condicionais e Predicados
• ✅ 1.1.7 Exemplo: Raiz Quadrada pelo Método de Newton
• ✅ 1.1.8 Funções como Abstrações de Caixa Preta

1.2 Funções e os Processos que Geram

• ✅ 1.2.md (Introdução da seção)
• ✅ 1.2.1 Recursão Linear e Iteração
• ✅ 1.2.2 Recursão em Árvore
• ✅ 1.2.3 Ordens de Crescimento
• ✅ 1.2.4 Exponenciação
• ✅ 1.2.5 Máximo Divisor Comum
• ✅ 1.2.6 Exemplo: Testando Primalidade

1.3 Formulação de Abstrações com Funções de Ordem Superior

• ✅ 1.3.mdx (Introdução da seção)
• ✅ 1.3.1 Funções como Argumentos
• ✅ 1.3.2 Construindo Funções Usando Expressões Lambda
• ✅ 1.3.3 Funções como Métodos Gerais
• ✅ 1.3.4 Funções como Retorno

Status: ✅ Completo (22/22 - 100%)

---

📖 Capítulo 2: Construindo Abstrações com Dados

2.0 Introdução

• ✅ 2.0.md

2.1 Introdução à Abstração de Dados

• ✅ 2.1.md (Introdução da seção)
• ✅ 2.1.1 Exemplo: Operações Aritméticas para Números Racionais
• ✅ 2.1.2 Barreiras de Abstração
• ✅ 2.1.3 O Que Se Entende por Dados?
• ✅ 2.1.4 Exercício Estendido: Aritmética de Intervalos

2.2 Dados Hierárquicos e a Propriedade de Closure

• ✅ 2.2.md (Introdução da seção)
• ✅ 2.2.1 Representando Sequências
• ✅ 2.2.2 Estruturas Hierárquicas
• ✅ 2.2.3 Sequências como Interfaces Convencionais
• ✅ 2.2.4 Exemplo: Uma Linguagem de Imagens

2.3 Dados Simbólicos

• ✅ 2.3.md (Introdução da seção)
• ✅ 2.3.1 Strings como Objetos de Dados
• ✅ 2.3.2 Exemplo: Diferenciação Simbólica
• ✅ 2.3.3 Exemplo: Representando Conjuntos
• ✅ 2.3.4 Exemplo: Árvores de Codificação de Huffman

2.4 Múltiplas Representações para Dados Abstratos

• ✅ 2.4.md (Introdução da seção)
• ✅ 2.4.1 Representações para Números Complexos
• ✅ 2.4.2 Dados Etiquetados
• ✅ 2.4.3 Programação Orientada a Dados e Aditividade

2.5 Sistemas com Operações Genéricas

• ✅ 2.5.md (Introdução da seção)
• ✅ 2.5.1 Operações Aritméticas Genéricas
• ✅ 2.5.2 Combinando Dados de Diferentes Tipos
• ✅ 2.5.3 Exemplo: Álgebra Simbólica

Status: ✅ Completo (24/24 - 100%)

---

📖 Capítulo 3: Modularidade, Objetos e Estado

3.0 Introdução

• ✅ 3.0.md

3.1 Atribuição e Estado Local

• ✅ 3.1.md (Introdução da seção)
• ✅ 3.1.1 Variáveis de Estado Local
• ✅ 3.1.2 Os Benefícios de Introduzir Atribuição
• ✅ 3.1.3 Os Custos de Introduzir Atribuição

3.2 O Modelo de Ambiente de Avaliação

• ✅ 3.2.md (Introdução da seção)
• ✅ 3.2.1 As Regras para Avaliação
• ✅ 3.2.2 Aplicando Funções Simples
• ✅ 3.2.3 Quadros como Repositório de Estado Local
• ✅ 3.2.4 Declarações Internas
• ✅ 3.2.5 Máquina CSE

3.3 Modelando com Dados Mutáveis

• ✅ 3.3.md (Introdução da seção)
• ✅ 3.3.1 Estrutura de Lista Mutável
• ✅ 3.3.2 Representando Filas
• ✅ 3.3.3 Representando Tabelas
• ✅ 3.3.4 Um Simulador para Circuitos Digitais
• ✅ 3.3.5 Propagação de Restrições

3.4 Concorrência: Tempo é da Essência

• ✅ 3.4.md (Introdução da seção)
• ✅ 3.4.1 A Natureza do Tempo em Sistemas Concorrentes
• ✅ 3.4.2 Mecanismos para Controlar Concorrência

3.5 Streams

• ✅ 3.5.md (Introdução da seção)
• ✅ 3.5.1 Streams São Listas Atrasadas
• ✅ 3.5.2 Streams Infinitos
• ✅ 3.5.3 Explorando o Paradigma de Streams
• ✅ 3.5.4 Streams e Avaliação Atrasada
• ✅ 3.5.5 Modularidade de Programas Funcionais e Modularidade de Objetos

Status: ✅ Completo (26/26 - 100%)

---

📖 Capítulo 4: Abstração Metalinguística

4.1 O Avaliador Metacircular

• ⬜ 4.1.md (Introdução da seção)
• ⬜ Todas as subseções

4.2 Variações sobre um Scheme - Avaliação Preguiçosa

• ⬜ 4.2.md (Introdução da seção)
• ⬜ Todas as subseções

4.3 Variações sobre um Scheme - Computação Não-Determinística

• ⬜ 4.3.md (Introdução da seção)
• ⬜ Todas as subseções

4.4 Programação Lógica

• ⬜ 4.4.md (Introdução da seção)
• ⬜ Todas as subseções

Status: ⬜ Não Iniciado (0/~20)

---

📖 Capítulo 5: Computação com Máquinas de Registradores

5.1 Projetando Máquinas de Registradores

• ⬜ 5.1.md (Introdução da seção)
• ⬜ Todas as subseções

5.2 Um Simulador de Máquina de Registradores

• ⬜ 5.2.md (Introdução da seção)
• ⬜ Todas as subseções

5.3 Alocação de Armazenamento e Coleta de Lixo

• ⬜ 5.3.md (Introdução da seção)
• ⬜ Todas as subseções

5.4 O Avaliador Explícito-Control

• ⬜ 5.4.md (Introdução da seção)
• ⬜ Todas as subseções

5.5 Compilação

• ⬜ 5.5.md (Introdução da seção)
• ⬜ Todas as subseções

Status: ⬜ Não Iniciado (0/~25)

---

🎯 Próximas Prioridades de Tradução

1. Capítulo 4 - Abstração Metalinguística

   • Iniciar tradução completa de todas as seções
   • Aproximadamente 20 seções a serem traduzidas

2. Capítulo 5 - Computação com Máquinas de Registradores

   • Próximo após conclusão do Capítulo 4

📊 Como Acompanhar o Progresso

Para ver o status detalhado da tradução, execute:

make translation-status

🔗 Fonte Original

Toda tradução é baseada no repositório oficial: Source Academy SICP

🤝 Código de Conduta

Este projeto adota o Contributor Covenant. Ao participar, você concorda em seguir seus termos.

📝 Licença

Veja o arquivo LICENSE para detalhes.

🙏 Agradecimentos

Agradecemos a todos os contribuidores que dedicam seu tempo para tornar este conhecimento acessível em português!

🔗 Links Úteis

• SICP.js Original (inglês)
• Repositório Source Academy SICP (GitHub)
• SICP Original (Scheme)
• Guia de Tradução
• Como Contribuir
• Perguntas Frequentes (FAQ)
• Histórico de Mudanças (CHANGELOG)

🌍 Translations to Other Languages

Would you like to see SICP.js translated into another language? We encourage and support the creation of translations into different languages!

How to Add a New Language

If you are interested in creating a translation into another language:

1. Open an issue in this repository describing:

   • The language you want to translate to
   • Your interest and availability to coordinate the project
   • Any previous experience with technical translations

2. We will provide:

   • Guidance on how to structure the translation project
   • Access to the resources and tools we use
   • Support for initial setup
   • Sharing of best practices learned from this project

3. You can create your own repository following the structure and processes we use here

We believe that quality knowledge should be accessible to everyone, regardless of language. We will be happy to help you start a translation into your language!

---

Quer ajudar? Veja as issues abertas ou abra uma nova para reivindicar uma seção para traduzir!