Java Labs

Base de conhecimento completa sobre Java para iniciantes em portugues.

Bem-vindo ao Java Labs. Este repositorio foi organizado para ensinar Java de forma clara, pratica e progressiva, combinando notas publicadas com Astro + Starlight, exemplos executaveis e desafios para consolidar o aprendizado.

Sobre o projeto

O Java Labs e uma iniciativa educacional com foco em:

• Conteudo didatico em portugues (pt-BR)
• Explicacoes claras e acessiveis
• Exemplos praticos e funcionais
• Exercicios para fixacao
• Projetos para aplicar os conceitos em contexto real
• Recursos adicionais curados

Estrutura do repositorio

java-labs/
├── src/content/docs/   -> Anotacoes e estudos publicados no site
├── examples/           -> Exemplos de codigo, exercicios e projetos praticos
├── src/styles/         -> Estilos customizados do tema Starlight
└── .github/            -> Workflows, templates e guias de contribuicao

Navegacao rapida

Secao	Descricao	Link
Site	Documentacao publicada	caramelotech.github.io/java-labs
Notas	Conteudos teoricos em Markdown	src/content/docs/
Exemplos	Codigos organizados por topico	examples/README.md
Exercicios	Desafios praticos de estudo	examples/exercises.md
Projetos	Propostas de aplicacao integrada	examples/projects.md
Contribuicao	Guia para contribuir	.github/CONTRIBUTING.md

Como usar

Se voce esta comecando agora, este fluxo funciona bem:

1. Leia Introducao ao Java
2. Continue pelas notas em src/content/docs/ seguindo a ordem numerica
3. Execute o exemplo Hello World
4. Resolva os desafios em examples/exercises.md
5. Escolha um projeto em examples/projects.md
6. Consulte recursos adicionais para aprofundar

Conteudo atual

Notas publicadas

• 01 - Introducao ao Java
• 02 - Sintaxe Java
• 03 - Operadores em Java
• 11 - Programacao Orientada a Objetos
• Recursos adicionais

Exemplos de codigo

• 01-HelloWorld

Pratica guiada

• Exercicios
• Projetos

Rodando localmente

Instale as dependencias e inicie o site Astro:

npm install
npm run dev

O servidor local roda em http://localhost:4321.

Outros comandos uteis:

npm run build
npm run preview

Versao publicada:

https://caramelotech.github.io/java-labs

Executando os exemplos Java

Para compilar e executar um exemplo localmente:

cd examples/01-HelloWorld
javac HelloWorld.java
java HelloWorld

Recomendacao de ambiente:

• JDK 17 LTS ou superior
• java --version
• javac --version

Adicionando notas

Novas anotacoes devem ser criadas em src/content/docs/, podendo usar subpastas quando fizer sentido. Use nomes descritivos com prefixo numerico para manter a ordem no menu lateral.

Exemplo de frontmatter padrao Starlight:

---
title: "Titulo da nota"
description: "Resumo curto explicando o foco da pagina."
lastUpdated: 2026-01-01
sidebar:
  order: 4
tags: ["java", "tema", "iniciante"]
---

Boas praticas:

• Escreva em portugues (pt-BR)
• Comece pelo conceito e depois mostre exemplos
• Mantenha descricoes curtas e objetivas no frontmatter
• Atualize links internos quando criar novas paginas ou subpastas

Objetivos de aprendizado

Ao seguir a trilha do Java Labs, voce deve conseguir:

• Compreender os fundamentos da linguagem Java
• Escrever programas orientados a objetos
• Utilizar estruturas de controle e tipos de dados basicos
• Resolver exercicios progressivos com autonomia
• Criar pequenas aplicacoes Java e evoluir para frameworks mais avancados

Como contribuir

Contribuicoes sao muito bem-vindas. Voce pode ajudar com:

• Melhorias nas notas de src/content/docs/
• Novos exemplos em examples/
• Novos exercicios em examples/exercises.md
• Novos projetos em examples/projects.md
• Curadoria de recursos em src/content/docs/recursos.md

Antes de abrir um PR, leia o Guia de Contribuicao.

Licenca

Este projeto esta sob a licenca definida em LICENSE.