🌱 Raizcode

A linguagem de programação brasileira, feita para quem pensa em português.

Simples para começar. Poderosa para evoluir. Brasileira desde a raiz.

Sobre o projeto

O Raizcode é uma linguagem de programação em português que transforma código .rc em JavaScript.

Ela foi criada para reduzir a barreira de entrada na programação, usando comandos fáceis de ler, sem exigir chaves {} ou ponto e vírgula ;.

mostrar "Olá, mundo!"

Resultado:

Olá, mundo!

Pacote no npm: raizcode-ofc
Comando no terminal: raizcode

Instalação

É necessário ter o Node.js e o npm instalados.

Windows, Linux e macOS

npm install -g raizcode-ofc

No PowerShell, caso o comando npm seja bloqueado, use:

npm.cmd install -g raizcode-ofc

Confira a instalação:

raizcode --version

Atualizar para a versão mais recente:

npm install -g raizcode-ofc@latest

Primeiro programa

Crie um arquivo chamado teste.rc:

mostrar "Iniciando sistema Raizcode..."

variavel criador = "Riquefla"

se 10 > 5
    mostrar "O criador é " + criador
fim

Execute:

raizcode teste.rc

Saída esperada:

Iniciando sistema Raizcode...
O criador é Riquefla

Instalação no Termux

Instale o Node.js:

pkg update
pkg install nodejs

Instale o Raizcode:

npm install -g raizcode-ofc

Crie uma pasta para testar:

mkdir -p ~/raizcode
cd ~/raizcode

Crie o arquivo com várias linhas:

cat > teste.rc <<'EOF'
mostrar "Iniciando sistema Raizcode..."

variavel criador = "Riquefla"

se 10 > 5
    mostrar "O criador é " + criador
fim
EOF

Confira as linhas:

cat -n teste.rc

Execute:

raizcode teste.rc

Para abrir projetos web no Termux sem tentar iniciar o navegador automaticamente:

raizcode app.rc --no-open

Depois acesse no navegador:

http://127.0.0.1:3000

Sintaxe básica

Variáveis

variavel nome = "Rique"
variavel idade = 35

mostrar nome
mostrar idade

Também é aceito sem o sinal =:

variavel nome "Rique"

Constantes

constante PAIS = "Brasil"
mostrar PAIS

Alterar um valor

variavel pontos = 10
definir pontos = 25

mostrar pontos

Condições

variavel idade = 18

se idade >= 18
    mostrar "Maior de idade"
senao
    mostrar "Menor de idade"
fim

Com mais de uma condição:

variavel nota = 8

se nota >= 9
    mostrar "Excelente"
senaose nota >= 7
    mostrar "Aprovado"
senao
    mostrar "Reprovado"
fim

Valores lógicos

variavel ativo = verdadeiro
variavel bloqueado = falso

se ativo e nao bloqueado
    mostrar "Acesso permitido"
fim

Palavras disponíveis:

| Raizcode | Significado | |---|---| | verdadeiro | verdadeiro | | falso | falso | | nulo | valor vazio | | e | condição AND | | ou | condição OR | | nao | negação |

Repetições

repetir 3 vezes
    mostrar "Raizcode!"
fim

variavel contador = 0

enquanto contador < 3
    mostrar contador
    definir contador = contador + 1
fim

Listas

lista linguagens = ["Raizcode", "JavaScript", "Python"]

para cada linguagem em linguagens
    mostrar linguagem
fim

Funções

funcao somar(a, b)
    retornar a + b
fim

mostrar somar(5, 7)

Comentários

// Esta linha é um comentário
mostrar "Esta linha será executada"

Comandos disponíveis

| Comando | Exemplo | |---|---| | Mostrar no terminal | mostrar "Olá" | | Criar variável | variavel nome = "Rique" | | Criar constante | constante PI = 3.14 | | Alterar valor | definir pontos = 20 | | Criar lista | lista nomes = ["Ana", "Rique"] | | Condição | se idade >= 18 | | Condição alternativa | senaose nota >= 7 | | Alternativa final | senao | | Repetição | repetir 5 vezes | | Enquanto | enquanto contador < 10 | | Percorrer lista | para cada item em lista | | Criar função | funcao somar(a, b) | | Retornar valor | retornar resultado | | Parar repetição | parar | | Continuar repetição | continuar | | Fechar bloco | fim |

Criando páginas web

O Raizcode usa três arquivos com o mesmo nome:

meu-site/
├── app.rc     # lógica
├── app.rcx    # estrutura
└── app.rcc    # estilo

1. Estrutura — app.rcx

titulo "Meu primeiro site com Raizcode"
subtitulo "Programação em português"
texto "Clique no botão para testar."

botao "Clique aqui" id "botaoTeste"
botao "Aguardando clique..." id "resultado"

2. Estilo — app.rcc

estilo corpo
    fundo: #0d0d0d
    cor-texto: branco
fim

estilo raiz
    largura-maxima: 700px
    margem-interna: 32px
    arredondado: 16px
fim

ao-passar-mouse elemento button
    opacidade: 0.8
fim

3. Lógica — app.rc

pagina "Meu primeiro site"

ao_clicar "botaoTeste"
    mostrar_tela "Raizcode funcionando!" em "resultado"
fim

Execute:

raizcode app.rc

O Raizcode gera app.html, inicia um servidor local e mostra o endereço:

http://127.0.0.1:3000

Usar outra porta:

raizcode app.rc 4000

Não abrir o navegador automaticamente:

raizcode app.rc --no-open

Estrutura visual .rcx

| Comando | Exemplo | |---|---| | Título | titulo "Minha página" | | Subtítulo | subtitulo "Bem-vindo" | | Texto | texto "Conteúdo da página" | | Link | link "Visitar" url "https://exemplo.com" | | Imagem | imagem "imagem.png" | | Botão | botao "Entrar" id "botaoEntrar" | | Entrada | entrada id "nome" dica "Digite seu nome" | | Caixa | caixa "cartao" | | Fechar caixa | fim |

Exemplo com caixa:

caixa "cartao"
    titulo "Raizcode"
    texto "Código em português."
fim

Estilos .rcc

Seletores disponíveis:

estilo corpo
fim

estilo raiz
fim

estilo classe cartao
fim

estilo id botaoEntrar
fim

estilo elemento button
fim

Algumas propriedades em português:

| Raizcode | CSS gerado | |---|---| | fundo | background | | cor-texto | color | | tamanho-texto | font-size | | familia-fonte | font-family | | peso-fonte | font-weight | | margem | margin | | margem-interna | padding | | borda | border | | arredondado | border-radius | | largura | width | | altura | height | | exibir | display | | alinhar-itens | align-items | | justificar | justify-content | | espaco | gap | | sombra | box-shadow | | opacidade | opacity | | transicao | transition |

Cores nomeadas:

preto
branco
cinza
vermelho
verde
azul
transparente
verde-neon
amarelo-neon
azul-neon
vermelho-neon

Integração com VS Code

Instale o suporte aos arquivos .rc, .rcx e .rcc:

raizcode --setup

Depois reinicie o VS Code.

A extensão adiciona:

• Reconhecimento dos arquivos Raizcode.
• Destaque de sintaxe disponível no pacote.
• Tema de ícones do Raizcode.

Opções da linha de comando

raizcode arquivo.rc
raizcode arquivo.rc 3000
raizcode arquivo.rc --no-open
raizcode arquivo.rc --estrito
raizcode arquivo.rc --permitir-js
raizcode --setup
raizcode --version
raizcode --help

Modo estrito

Recusa comandos que não fazem parte da linguagem:

raizcode teste.rc --estrito

JavaScript avançado

Para usar uma linha de JavaScript explicitamente:

js console.log("Executado pelo JavaScript");

O modo abaixo permite JavaScript puro sem o prefixo js, sendo recomendado apenas para testes:

raizcode teste.rc --permitir-js

Solução de problemas

raizcode: command not found

Reinstale globalmente:

npm install -g raizcode-ofc

No Termux, atualize os comandos disponíveis:

hash -r

PowerShell bloqueia o npm

Use:

npm.cmd install -g raizcode-ofc

Arquivo não encontrado

Entre na pasta correta:

cd caminho/do/projeto
raizcode teste.rc

Ou use o caminho completo:

raizcode /sdcard/raizcode/teste.rc

SyntaxError: missing ) after argument list

Confira se cada comando está em uma linha separada:

cat -n teste.rc

O arquivo deve aparecer assim:

1  mostrar "Iniciando..."
2  variavel criador = "Riquefla"
3  mostrar criador

Filosofia

O Raizcode nasceu no Brasil para mostrar que programação também pode ser ensinada e escrita na nossa língua.

Nossa missão é criar uma linguagem:

• Fácil para quem está começando.
• Útil para projetos reais.
• Aberta para estudantes e desenvolvedores.
• Preparada para web, aplicativos e jogos.
• Capaz de representar a tecnologia brasileira no mundo.

Próximos passos

• [ ] Parser e árvore de sintaxe próprios.
• [ ] Mensagens de erro ainda mais inteligentes.
• [ ] Formatador automático.
• [ ] Autocomplete no VS Code.
• [ ] Playground online.
• [ ] Gerenciador de pacotes.
• [ ] Ferramentas para aplicativos e jogos.
• [ ] Documentação em outros idiomas.

Contribuindo

Sugestões, correções e novas ideias são bem-vindas.

Antes de enviar uma alteração:

npm test

Ao relatar um erro, informe:

1. Sistema operacional.
2. Versão do Node.js.
3. Versão do Raizcode.
4. Código .rc usado.
5. Mensagem completa do erro.

Confira as versões:

node --version
raizcode --version

Licença

Distribuído sob a licença MIT.

🌱 Raizcode

Programe do seu jeito. Pense na sua língua.

Criado no Brasil por Riquefla.