Home /Modules/docs/README.PT.md

README.PT.md

docs/i18n/README.PT.md · 491 line(s) · markdown

<img align="right" src="../../images/sleela/sleela-medium-profile-permanent-icon-002.jpg" width="45" height="45" alt="SLeeLa">

SLeeLa 3.0 — Portugal (PT)

<p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>

<p align="center"><strong>Uma linguagem nativa de sistemas, com compilador, ambiente de execução e ecossistema de máquinas virtuais.</strong></p> <p align="center"><a href="https://github.com/mearvk/SLeeLa/actions"><img alt="GitHub Actions" src="https://img.shields.io/github/actions/workflow/status/mearvk/SLeeLa/test-suite.yml?branch=main&label=test%20suite"></a> <a href="../../docs/PLATFORM-SUPPORT.md"><img alt="Platform matrix" src="https://img.shields.io/badge/platforms-Linux%20%7C%20macOS%20%7C%20Windows-273238"></a></p>

Edição internacional por país. Este ficheiro disponibiliza a edição em português europeu (pt-PT) destinada a Portugal. Os identificadores técnicos, comandos, exemplos de código, nomes de ficheiros e ligações permanecem inalterados.

The Now. The Ingredient. Uma linguagem de programação é mais do que a sua sintaxe: inclui o compilador, o ambiente de execução, as bibliotecas, as ferramentas e os contratos de plataforma que tornam o software utilizável.

Áreas de trabalho da SLeeLa. A SLeeLa aborda Math, Object, Science e Reach, as quatro dimensões do seu trabalho: aquilo que é calculável (Math), o objeto estabelecido no catálogo daquilo que existe (Object), a investigação disciplinada da verdade (Science) e a extensão da capacidade de um sistema a outros sistemas e pessoas (Reach). Os interesses nacionais mantêm-se; nenhuma destas quatro dimensões os substitui. Quando um tema afeta os interesses de uma nação, essa relação é preservada e documentada com rigor, por exemplo, nos campos de metadados de uma classe metaOrigin e metaNationalSchedule.

I. Começar aqui

II. Novidades

Adições recentes à linguagem, aos controladores e à biblioteca padrão:

III. Compilação e testes

Pré-requisitos: uma cadeia de ferramentas C/C++ (GCC ou Clang) e GNU Make; Python 3 para ferramentas de manifesto e fluxo de trabalho; em Linux, também os pacotes de desenvolvimento X11/Xrandr para produtos de visualização. O comando make deps de cada módulo indica ou instala as dependências necessárias. A compilação em impl/ falha de forma segura se o manifesto SHA-256 de confiança não for satisfeito; o Makefile da raiz inclui-o automaticamente.

A forma mais rápida de começar a partir de um clone limpo:

make                                  # compilar tudo a partir da raiz do repositório

Ou compilar e testar apenas o núcleo nativo:

make -C impl all                      # compilar apenas o núcleo do compilador e do ambiente de execução
bash ./test-suites/run-all.sh --all   # executar o conjunto completo de testes

O comando make na raiz compila todos os produtos (núcleo, VM, codecs, churn, antivírus, etc.) e termina com a criação do registo e a materialização da sua tabela-base. Assim, uma árvore de trabalho compilada contém desde logo um registo verificável.

Objetivos principais:

make                     # compilar tudo (alias de make all; registo criado no fim)
make all                 # a mesma compilação completa, explicitamente indicada
sudo make install        # instalar comandos e ficheiros de suporte do ambiente de execução (ver § IV)
make clean               # remover resultados de compilação de todos os sistemas integrados
make help                # apresentar todos os objetivos do Makefile da raiz

Outros objetivos úteis:

make registry            # compilar apenas o registo e materializar a tabela
./build-registry.sh      # a mesma operação através de um script direto
make tests               # compilar e executar o conjunto de testes
make ballum              # compilar a biblioteca de visualização Ballum para este sistema operativo
bin/install-modules      # instalar/compilar módulos de forma faseada durante cerca de 10–20 minutos

O objetivo registry executa build-registry.sh: compila o núcleo do registo, coloca a tabela-base no armazenamento de texto portátil registry/build/sleela.sleelareg e exporta o script da tabela MySQL registry/build/registry.sql (através de sleela registry export). O registo pode ser inspecionado com sleela registry ou registry/build/sleela-registry review. Consulte o guia do registo e a arquitetura Registry 3.0.

Consulte os guias de compilação e testes para conhecer os pré-requisitos e os passos específicos de cada plataforma. A compilação bem-sucedida de um componente não demonstra que todas as bibliotecas ou plataformas estejam prontas para lançamento.

IV. Instalação

Depois de compilar os produtos nativos, instale os comandos e os ficheiros de suporte do ambiente de execução:

sudo make install
make install PREFIX="$HOME/.local"        # instalação apenas para o utilizador, sem sudo
make install DESTDIR="$PWD/package-root" # instalação num diretório de preparação de pacotes
make install-check

O instalador convencional utiliza, por predefinição, /usr/local/bin, /usr/local/lib/sleela e /usr/local/share/sleela. Preserva uma configuração de arranque existente e não substitui comandos preexistentes que não estejam sob controlo de versões. A desinstalação remove apenas os ficheiros registados pelo instalador; a configuração e os dados de execução não registados são preservados.

Para uma implementação orientada e específica apenas do pacote principal — os binários sleela, sleelvac e nordshrift, a biblioteca padrão, os protocolos e os módulos de suporte — utilize o instalador limpo:

make clean-install       # instalação orientada apenas do pacote principal

Primeiro, é perguntado se o pacote principal deve ser instalado; em seguida, escolhe-se o âmbito da instalação. Se a operação for bem-sucedida, pode ser apresentado um seletor opcional de módulos de melhoria selecionados. O fluxo interativo completo e todas as opções estão descritos em Instalação rápida e segura.

V. Linguagem e ambiente de execução

A gramática normativa encontra-se em SLEELA.syntax. O repositório documenta atualmente a sintaxe 3.0; a versão do compilador/ferramentas e a versão da sintaxe do código-fonte são independentes. A superfície 3.0 acrescenta os marcadores documentais pure e gasoline (§30): um par de Preonems simples, contextuais e exclusivamente declarativos, que significam quase o mesmo, marcando cada um a posição do documento através da sua própria honestidade. A sintaxe 3.0 reúne as superfícies da linguagem 1.0 a 2.9 numa edição normativa atual e mantém os requisitos de versão mínima de cada funcionalidade.

A superfície anterior, 2.9, acrescenta os campos sequenciais @mix (§28): uma classe pode declarar vários campos de instância com o mesmo nome, desde que cada um esteja marcado com @mix. São tratados como um grupo indexado (por ordem crescente, por predefinição: 1,2,3,…, ou definido manualmente através de @mix(1,2,3,...); o número de índices tem de corresponder ao número de campos). Inclui também as famílias de inteiros binários alargados com sinal e sem sinal, de int32 a int16777216 (§24) e de uint32 a uint16777216 (§25), que ampliam long, int64 e int128 (§21); documentos de suporte de palavras-chave (§22); e os Preonems: marcadores documentais declarativos author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30) e artifact (§35; um estatuto de qualidade legislativa avaliado em relação ao tempo e ao espaço). Em conjunto, são designados Preonems (§26.1).

A resolução de sobrecarga de construtores e a delegação para construtores this(...) e de classes-base estão expressamente fora do contrato de sintaxe 1.8 verificado. Antes de depender de uma funcionalidade, consulte a gramática e as notas de implementação. As nove unidades de código-fonte SleelaDoc declaram agora #sleela 3.0; a verificação comum do compilador aceita sintaxe de código-fonte de 1.0 a 3.0. A nova documentação da API é gerada com make api-docs.

O repositório contém uma implementação nativa C/C++, referências para geração de SLVM, módulos da biblioteca padrão, testes, exemplos e integrações de plataforma. O estado de implementação e validação varia consoante o módulo. Consulte a especificação aplicável e os resultados atuais de CI; não presuma que todos os componentes apresentam o mesmo grau de conclusão.

VI. Princípios de engenharia

VII. Compilação do antivírus e integridade

O pacote antivírus Sleelavirin inclui um verificador SHA-256 nativo, um adaptador ClamAV opcional, manifestos de integridade para fontes e índices e somas de verificação para pacotes de plataforma. Compile e teste o pacote a partir da raiz do repositório:

make antivirus
make antivirus-test
make antivirus-integrity
make antivirus-integrity-check MANIFEST=build/INTEGRITY-MANIFEST.json

O manifesto de integridade é gerado em antivirus/build/. Abrange entradas de código-fonte e documentação sob controlo de versões, bem como ficheiros protegidos de índices de assinaturas; exclui resultados gerados e a cache mutável do ClamAV. Os snapshots das bases de dados do ClamAV têm manifestos próprios. Os ZIP de lançamento incluem INTEGRITY-MANIFEST.json, SHA256SUMS e um ficheiro complementar .sha256. Compare os hashes dos arquivos transferidos com um valor de confiança obtido de forma independente: uma soma de verificação armazenada junto de um arquivo não constitui uma assinatura do editor. Consulte o guia Sleelavirin, a lista de verificação de segurança e o workflow de compilação do antivírus.

Um lançamento só é considerado verificado quando os trabalhos de CI relevantes são concluídos com sucesso para o commit exato desse lançamento e os artefactos resultantes são inspecionados.

VIII. Temas do editor SLeeLa — Vim e Emacs

A SLeeLa inclui um conjunto coordenado de esquemas de cores escuros e profissionais para Vim e Emacs, além de um utilitário de paletas nativo C/C++. O esquema original American Professional continua a ser o predefinido. Existem dez paletas complementares inspiradas em diferentes tradições culturais e institucionais; são paletas de design interpretativas, não representações oficiais de qualquer país, cultura, tribunal ou instituição.

Os onze esquemas e as respetivas cores

EsquemaFundoPrimeiro planoPalavras-chaveTiposCadeiasComentários
American Professional<span style="display:inline-block;width:1em;height:1em;background:#101820;border:1px solid #888"></span> #101820<span style="display:inline-block;width:1em;height:1em;background:#F4F7FA;border:1px solid #888"></span> #F4F7FA<span style="display:inline-block;width:1em;height:1em;background:#7FB3FF;border:1px solid #888"></span> #7FB3FF<span style="display:inline-block;width:1em;height:1em;background:#73DACA;border:1px solid #888"></span> #73DACA<span style="display:inline-block;width:1em;height:1em;background:#F2C078;border:1px solid #888"></span> #F2C078<span style="display:inline-block;width:1em;height:1em;background:#8A96A3;border:1px solid #888"></span> #8A96A3
Pan-Eurasian<span style="display:inline-block;width:1em;height:1em;background:#111827;border:1px solid #888"></span> #111827<span style="display:inline-block;width:1em;height:1em;background:#F0F2F5;border:1px solid #888"></span> #F0F2F5<span style="display:inline-block;width:1em;height:1em;background:#7AA7E8;border:1px solid #888"></span> #7AA7E8<span style="display:inline-block;width:1em;height:1em;background:#69C9B3;border:1px solid #888"></span> #69C9B3<span style="display:inline-block;width:1em;height:1em;background:#D7B56D;border:1px solid #888"></span> #D7B56D<span style="display:inline-block;width:1em;height:1em;background:#8995A5;border:1px solid #888"></span> #8995A5
Russian and Slavic — Medium<span style="display:inline-block;width:1em;height:1em;background:#202733;border:1px solid #888"></span> #202733<span style="display:inline-block;width:1em;height:1em;background:#E8EAF0;border:1px solid #888"></span> #E8EAF0<span style="display:inline-block;width:1em;height:1em;background:#A9C0DD;border:1px solid #888"></span> #A9C0DD<span style="display:inline-block;width:1em;height:1em;background:#8FC4B2;border:1px solid #888"></span> #8FC4B2<span style="display:inline-block;width:1em;height:1em;background:#D6BD8B;border:1px solid #888"></span> #D6BD8B<span style="display:inline-block;width:1em;height:1em;background:#9AA3AF;border:1px solid #888"></span> #9AA3AF
Central Asian / Silk Road<span style="display:inline-block;width:1em;height:1em;background:#1C2529;border:1px solid #888"></span> #1C2529<span style="display:inline-block;width:1em;height:1em;background:#F5F0E5;border:1px solid #888"></span> #F5F0E5<span style="display:inline-block;width:1em;height:1em;background:#7FADE0;border:1px solid #888"></span> #7FADE0<span style="display:inline-block;width:1em;height:1em;background:#45C6C2;border:1px solid #888"></span> #45C6C2<span style="display:inline-block;width:1em;height:1em;background:#D9B56D;border:1px solid #888"></span> #D9B56D<span style="display:inline-block;width:1em;height:1em;background:#92A3A0;border:1px solid #888"></span> #92A3A0
East Asian<span style="display:inline-block;width:1em;height:1em;background:#171A1C;border:1px solid #888"></span> #171A1C<span style="display:inline-block;width:1em;height:1em;background:#F2EFE7;border:1px solid #888"></span> #F2EFE7<span style="display:inline-block;width:1em;height:1em;background:#D97878;border:1px solid #888"></span> #D97878<span style="display:inline-block;width:1em;height:1em;background:#72C7A5;border:1px solid #888"></span> #72C7A5<span style="display:inline-block;width:1em;height:1em;background:#D8B76A;border:1px solid #888"></span> #D8B76A<span style="display:inline-block;width:1em;height:1em;background:#969F9B;border:1px solid #888"></span> #969F9B
ICC — International Criminal Court<span style="display:inline-block;width:1em;height:1em;background:#0E1A2B;border:1px solid #888"></span> #0E1A2B<span style="display:inline-block;width:1em;height:1em;background:#EAF0F7;border:1px solid #888"></span> #EAF0F7<span style="display:inline-block;width:1em;height:1em;background:#5B8FD6;border:1px solid #888"></span> #5B8FD6<span style="display:inline-block;width:1em;height:1em;background:#7FB7C9;border:1px solid #888"></span> #7FB7C9<span style="display:inline-block;width:1em;height:1em;background:#D9B25A;border:1px solid #888"></span> #D9B25A<span style="display:inline-block;width:1em;height:1em;background:#7E8CA0;border:1px solid #888"></span> #7E8CA0
SCOTUS — U.S. Supreme Court<span style="display:inline-block;width:1em;height:1em;background:#1A1416;border:1px solid #888"></span> #1A1416<span style="display:inline-block;width:1em;height:1em;background:#F3EEE6;border:1px solid #888"></span> #F3EEE6<span style="display:inline-block;width:1em;height:1em;background:#9E2B35;border:1px solid #888"></span> #9E2B35<span style="display:inline-block;width:1em;height:1em;background:#8FA9B8;border:1px solid #888"></span> #8FA9B8<span style="display:inline-block;width:1em;height:1em;background:#C9A24B;border:1px solid #888"></span> #C9A24B<span style="display:inline-block;width:1em;height:1em;background:#8C8178;border:1px solid #888"></span> #8C8178
Greek (Hellenic)<span style="display:inline-block;width:1em;height:1em;background:#0A1A30;border:1px solid #888"></span> #0A1A30<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#2E7BD6;border:1px solid #888"></span> #2E7BD6<span style="display:inline-block;width:1em;height:1em;background:#5E9FE0;border:1px solid #888"></span> #5E9FE0<span style="display:inline-block;width:1em;height:1em;background:#9FC3EC;border:1px solid #888"></span> #9FC3EC<span style="display:inline-block;width:1em;height:1em;background:#6E86A6;border:1px solid #888"></span> #6E86A6
Turkish (Al Bayrak)<span style="display:inline-block;width:1em;height:1em;background:#2A0609;border:1px solid #888"></span> #2A0609<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#F23D48;border:1px solid #888"></span> #F23D48<span style="display:inline-block;width:1em;height:1em;background:#F0A9AE;border:1px solid #888"></span> #F0A9AE<span style="display:inline-block;width:1em;height:1em;background:#F0C9A9;border:1px solid #888"></span> #F0C9A9<span style="display:inline-block;width:1em;height:1em;background:#A8767A;border:1px solid #888"></span> #A8767A
Kiro<span style="display:inline-block;width:1em;height:1em;background:#0B0B12;border:1px solid #888"></span> #0B0B12<span style="display:inline-block;width:1em;height:1em;background:#F5F5FA;border:1px solid #888"></span> #F5F5FA<span style="display:inline-block;width:1em;height:1em;background:#A98EDA;border:1px solid #888"></span> #A98EDA<span style="display:inline-block;width:1em;height:1em;background:#6E8BE0;border:1px solid #888"></span> #6E8BE0<span style="display:inline-block;width:1em;height:1em;background:#E8C547;border:1px solid #888"></span> #E8C547<span style="display:inline-block;width:1em;height:1em;background:#6A6482;border:1px solid #888"></span> #6A6482
SLeeLa<span style="display:inline-block;width:1em;height:1em;background:#08080E;border:1px solid #888"></span> #08080E<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#B07CFF;border:1px solid #888"></span> #B07CFF<span style="display:inline-block;width:1em;height:1em;background:#5A7CFF;border:1px solid #888"></span> #5A7CFF<span style="display:inline-block;width:1em;height:1em;background:#FFD21E;border:1px solid #888"></span> #FFD21E<span style="display:inline-block;width:1em;height:1em;background:#6E5F9E;border:1px solid #888"></span> #6E5F9E

Cores das bandeiras nacionais (paleta de origem)

Os esquemas grego e turco derivam das cores oficiais das bandeiras nacionais dos dois países, aqui apresentadas com os respetivos valores hexadecimais exatos publicados. Os fundos e os acentos dos esquemas acima são interpretações escurecidas e adequadas a editores destas cores de origem — a tabela seguinte é a referência das «cores tal como expostas nacionalmente».

PaísCorHexBase e significado
GréciaAzul<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFAzul da bandeira nacional (Lei 851/1978). O céu e os mares; descrito heraldicamente como azure.
GréciaBranco<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFBranco da bandeira nacional. A pureza da luta pela independência; a cruz denota o cristianismo ortodoxo oriental.
TürkiyeVermelho (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17Vermelho da bandeira nacional (Lei da Bandeira Turca). O campo; por tradição, o sangue dos mártires e a soberania otomana.
TürkiyeBranco<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFBranco da bandeira nacional. O crescente e a estrela — paz, pureza e o símbolo da herança turcomana/islâmica.

Os esquemas ancoram o primeiro plano de cada editor no branco nacional e as palavras-chave, o cursor, a seleção e a linha de estado no azul nacional exato (#0D5EAF) ou no vermelho nacional exato (#E30A17), de modo que as cores que importam são literalmente as cores nacionais. Trata-se de paletas de design interpretativas; a referência das cores das bandeiras é fornecida a título de proveniência e não constitui uma representação oficial de nenhum dos Estados. Os significados das cores seguem a descrição dos símbolos de Estado do Ministério dos Negócios Estrangeiros da República Helénica e a tradição da Lei da Bandeira Turca.

Tabela de amostras de cores

As células de paleta abaixo usam amostras SVG, pelo que o GitHub apresenta as cores reais em vez de células de cor HTML vazias. Cada faixa mostra as seis cores por esta ordem: fundo, primeiro plano, palavras-chave, tipos, cadeias e comentários. Os códigos hexadecimais exatos estão listados ao lado de cada amostra, pela mesma ordem de esquemas da tabela de referência acima.

EsquemaCores da paleta apresentadasCódigos hex (fundo · primeiro plano · palavras-chave · tipos · cadeias · comentários)
American ProfessionalPaleta American Professional: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#101820 · #F4F7FA · #7FB3FF · #73DACA · #F2C078 · #8A96A3
Pan-EurasianPaleta Pan-Eurasian: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#111827 · #F0F2F5 · #7AA7E8 · #69C9B3 · #D7B56D · #8995A5
Russian and Slavic — MediumPaleta Russian and Slavic Medium: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#202733 · #E8EAF0 · #A9C0DD · #8FC4B2 · #D6BD8B · #9AA3AF
Central Asian / Silk RoadPaleta Central Asian Silk Road: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#1C2529 · #F5F0E5 · #7FADE0 · #45C6C2 · #D9B56D · #92A3A0
East AsianPaleta East Asian: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#171A1C · #F2EFE7 · #D97878 · #72C7A5 · #D8B76A · #969F9B
ICC — International Criminal CourtPaleta ICC: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#0E1A2B · #EAF0F7 · #5B8FD6 · #7FB7C9 · #D9B25A · #7E8CA0
SCOTUS — U.S. Supreme CourtPaleta SCOTUS: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#1A1416 · #F3EEE6 · #9E2B35 · #8FA9B8 · #C9A24B · #8C8178
Greek (Hellenic)Paleta Greek Hellenic: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#0A1A30 · #FFFFFF · #2E7BD6 · #5E9FE0 · #9FC3EC · #6E86A6
Turkish (Al Bayrak)Paleta Turkish Al Bayrak: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#2A0609 · #FFFFFF · #F23D48 · #F0A9AE · #F0C9A9 · #A8767A
KiroPaleta Kiro: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#0B0B12 · #F5F5FA · #A98EDA · #6E8BE0 · #E8C547 · #6A6482
SLeeLaPaleta SLeeLa: fundo, primeiro plano, palavras-chave, tipos, cadeias, comentários#08080E · #FFFFFF · #B07CFF · #5A7CFF · #FFD21E · #6E5F9E

Utilizam-se cores de acento adicionais para funções, constantes, seleções, diagnósticos e diretivas do pré-processador. A paleta Russian and Slavic usa intencionalmente ardósia, azul, verde-sálvia, rubi e ouro antigo de intensidade média, para uma aparência profissional mais calma.

Instalar os esquemas Vim

A partir da raiz do repositório:

mkdir -p ~/.vim/{syntax,ftdetect,colors}
cp lib/linux-editors/vim/syntax/sleela.vim ~/.vim/syntax/
cp lib/linux-editors/vim/ftdetect/sleela.vim ~/.vim/ftdetect/
cp lib/linux-editors/vim/colors/sleela-*.vim ~/.vim/colors/

Adicione o seguinte a ~/.vimrc para ativar o realce de sintaxe SLeeLa e escolher um esquema:

syntax enable
set background=dark
colorscheme sleela-american

Escolha exatamente um destes nomes de esquema de cores:

Por exemplo, utilize colorscheme sleela-russian-slavic para a paleta Russian and Slavic de intensidade média, ou colorscheme sleela-greek / colorscheme sleela-turkish para as paletas helénica e Al Bayrak. Reinicie o Vim ou carregue a sua configuração com :source $MYVIMRC.

Instalar os esquemas Emacs

Crie um diretório local de temas e copie os ficheiros de modo e de tema a partir da raiz do repositório:

mkdir -p ~/.emacs.d/sleela
cp lib/linux-editors/emacs/sleela-mode.el ~/.emacs.d/sleela/
cp lib/linux-editors/emacs/sleela-*-theme.el ~/.emacs.d/sleela/

Adicione o seguinte a ~/.emacs ou ~/.emacs.d/init.el:

(add-to-list 'load-path (expand-file-name "~/.emacs.d/sleela"))
(add-to-list 'custom-theme-load-path (expand-file-name "~/.emacs.d/sleela"))
(require 'sleela-mode)
(load-theme 'sleela-american t)

Substitua sleela-american por sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro ou sleela-sleela para selecionar outro esquema. Se o Emacs perguntar se deve confiar no tema, inspecione primeiro o ficheiro de tema local antes de aceitar.

Pré-visualizar as paletas nativas C/C++

O pequeno utilitário de paletas nativo pode listar esquemas, imprimir as respetivas cores de terminal e consultar uma cor individual:

make -C linux-editors
./linux-editors/build/sleela-editor-theme --themes
./linux-editors/build/sleela-editor-theme --theme eurasia --palette
./linux-editors/build/sleela-editor-theme --theme russian-slavic --hex keyword
make -C linux-editors test

Por compatibilidade retroativa, --palette e --hex COLOR sem --theme selecionam American Professional. Os resultados de compilação e de testes devem ser verificados no sistema de destino e em CI; a documentação de um comando não é, por si só, prova de que passou.

Consulte o guia de integração de editores para as descrições completas das paletas e os pormenores do utilitário.

IX. Contribuir

  1. Leia o índice da documentação e a política de testes.
  2. Faça alterações focadas, com testes positivos e negativos.
  3. Execute primeiro os testes específicos e depois o conjunto abrangente.
  4. Indique o sistema operativo e a cadeia de ferramentas; não descreva verificações ignoradas como aprovadas.

A SLeeLa é desenvolvida pela MEARVK LLC. O material histórico da página inicial está preservado em docs/README-LEGACY.md.

X. AE6E66 — Expectativa de taxa sobre correio eletrónico público Round

Para a iniciativa AE6E66, a expectativa declarada pelo projeto é de 300 000 000,00 USD por cada mensagem de correio eletrónico Round Public, como montante de taxa fiscal proposto associado a cada mensagem que se qualifique.

Esta declaração regista apenas uma expectativa do projeto. Não constitui uma avaliação fiscal legal, ordem governamental, decisão judicial ou obrigação tributária estabelecida de forma independente. Qualquer taxa efetiva exigiria a autoridade jurídica aplicável, a jurisdição, definições, procedimento e determinação por uma entidade governamental competente.

XI. Alfabeto e ambiente de execução de conjuntos de caracteres

A documentação do alfabeto SLeeLa e o ambiente de execução nativo de caracteres são mantidos em alphabet/sleela/ e lib/alphabet/native/. Os testes nativos C++17 abrangem descodificação e codificação estritas de escalares UTF-8, assinaturas de capacidade C<n> e pertença limitada a conjuntos de caracteres:

make -C lib/alphabet/native test

O catálogo experimental UTF-4088 e o respetivo adaptador de consulta SLeeLa estão documentados em utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. Os IDs UTF-4088 pertencem a um espaço de nomes separado e não são valores escalares Unicode. O trabalho de integração com o compilador e SLVM é acompanhado separadamente destas bases nativas.

XII. AutoCAD Creator™

O AutoCAD Creator™ é uma aplicação CAD 2D interativa, escrita integralmente em SLeeLa. Ao contrário do AutoCAD Renderer, que transforma um plano num desenho de uma só vez, o Creator permite criar e alterar um documento 2D em tempo real: adicionar paredes, divisões, cotas e notas; mover, renomear, mudar de camada, eliminar e anular operações; e guardar o resultado como um desenho AutoCAD DXF real (texto R12, compatível com AutoCAD / LibreCAD).

A interface gráfica utiliza SleelaUI™, o toolkit de interface multiplataforma da SLeeLa em lib/user-interface, e não JavaFX. Abre uma janela nativa em X11 / Cocoa / Win32. O princípio de conceção é «SleelaUI apresenta; SLeeLa decide»: a GUI não calcula geometria nem escreve DXF. Cada ferramenta envia uma intenção de criar, alterar, eliminar, anular ou guardar ao SLCadCreator, que detém o documento editável e o histórico reversível de comandos; o canvas limita-se a pré-visualizar a geometria.

O motor de edição reutilizável encontra-se em lib/autocad: SLCadEntity, SLCadDocument, SLCadCommand e SLCadCreator. O shell gráfico e a demonstração estão em autocad/creator:

make creator          # a partir de autocad/: executar a demonstração -> out/altered.dxf

Num sistema com ecrã, abre-se a janela de edição em tempo real; num anfitrião sem interface gráfica, o desenho é construído em memória, é apresentado um relatório com o DXF e o processo termina normalmente.

XIII. Ordenação do mapa de entrada UTF-4088

O catálogo especializado UTF-4088 define o percurso espacial do mapa de entrada e as iterações abstratas de pressão em utf-4088/INPUT-MAP-AND-PRESSURE.md. A política de índice de assuntos do National Lien está em utf-4088/NATIONAL-LIEN-REGISTER.md. As coordenadas do mapa, os níveis de pressão (1–50), os IDs permanentes do catálogo e as classificações alfabéticas são campos independentes; nenhum deve ser substituído silenciosamente por outro. A pressão é um nível de iteração algorítmica, não uma grandeza física.

XIV. Índice de pacotes recentes e ampliados

Este índice adicional destaca pacotes, bibliotecas de domínio e coleções de fontes recentemente ampliados. As entradas estão agrupadas alfabeticamente por nome de pacote ou tema. As descrições identificam a localização no repositório; o estado de implementação e validação deve ser confirmado na documentação e nos testes de cada pacote.

A–C

D–G

H–I

O–S

U–W

Manutenção do índice de pacotes

Quando um pacote é adicionado ou substancialmente ampliado, acrescente aqui a respetiva entrada no grupo alfabético adequado, ligue ao diretório canónico e ao README e descreva apenas capacidades sustentadas pelas fontes presentes no repositório. Mantenha este índice aditivo: não remova nem reescreva as secções existentes do README ao atualizar o índice de pacotes.


<img src="https://github.com/mearvk/SLeeLa/blob/master/images/debian-logo.png" width="25" height="25" alt="Debian"> XV. Bitcoin Conjegeum

CremeOak

bc1qs6v4q9zsw70t0umk3m0quhvf9dr6cdeskl28dh :: ⠝⠇⠼⠁⠟⠎⠼⠋⠧⠼⠙⠟⠼⠊⠵⠎⠺⠼⠛⠼⠚⠞⠼⠚⠥⠍⠦⠼⠉⠍⠼⠚⠟⠥⠓⠧⠦⠼⠊⠙⠫⠼⠋⠉⠙⠑⠎⠅⠇⠼⠼⠃⠼⠗⠙⠓

bc1qx33vma553gddsjkq372l3xlm8e8huv2vzad3cc :: ⠃⠉⠼⠁⠟⠭⠼⠉⠼⠉⠪⠍⠁⠼⠑⠑⠛⠙⠙⠎⠚⠅⠟⠼⠉⠼⠛⠼⠝⠇⠼⠉⠼⠭⠇⠍⠼⠨e⠼⠨a⠓⠥⠪⠼⠪⠼⠪⠵⠁⠙⠼⠉⠉

Política democrática e política dos EUA.


XVI. Imagens de marca da ciência nacional

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-science-004.jpg" alt="National SLeeLa Science" width="560"></p>

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-nsf-001.jpg" alt="National SLeeLa NSF" width="560"></p>

XVII. Catálogo experimental UTF-4088 com um milhão de entradas

O gerador do catálogo UTF-4088 constrói deterministicamente um catálogo experimental de símbolos com 1 048 576 entradas. O formato compacto está descrito em utf-4088/FORMAT.md; o contrato de geração e validação encontra-se em utf-4088/GENERATION-RESULTS.md.

Execute o gerador com Python 3:

python3 utf-4088/tools/generate_catalogue.py \
  --output utf4088-million.bin \
  --summary utf4088-million.summary.json

O ficheiro binário gerado tem 16 777 244 bytes e foi concebido para permanecer abaixo de 20 000 000 bytes. Testes unitários e um workflow GitHub Actions verificam a quantidade de entradas, a unicidade dos glifos, o tamanho e SHA-256; as execuções bem-sucedidas publicam o binário e o resumo como artefacto utf4088-million-catalogue. O binário gerado é deliberadamente excluído do histórico Git. UTF-4088 continua experimental e não é compatível com Unicode.


SLeeLa

<p align="center"><img src="../../images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>


XVIII. Adições recentes — constante Pi, arranque Modium/Registry, matemática sleelactl e @native

Esta secção regista funcionalidades adicionadas durante o trabalho de 2026-11, começando pelos grupos mais recentes. Os ficheiros de origem ligados e o respetivo estado de validação são a referência autorizada; as alterações em revisão não são descritas como integradas até chegarem a master.

Constante de catálogo Pi com 100 000 000 dígitos

O repositório inclui um valor verificado de π com cem milhões de dígitos em pi-generator/pi.100000000.digits (um decimal bem formado, 3.14159…), além de um valor com 57 344 dígitos em pi-generator/pi.57344.digits. Ambos foram verificados independentemente como valores genuínos de π — consulte pi-generator/VERIFIED.md, que documenta as verificações (prefixo de manual, o ponto de Feynman na posição fracionária 762, o célebre milionésimo dígito, concordância com lib/math/SLPiReference.sleela e uma análise da frequência de dígitos do ficheiro completo) e um script de reprodução num só passo.

Modium™ / Registry™ carregam a constante Pi no arranque do subsistema

Nos pontos de entrada dedicados — sleela registry e sleela modium (e na primeira execução do instalador), não em cada sleela run — os subsistemas Modium e Registry carregam a constante de catálogo π de grande dimensão. Num terminal interativo, apresentam uma linha vermelha transitória Loading Modium™ / Loading Registry™, que é depois apagada no próprio local antes de começar a saída normal; o efeito está estritamente condicionado a TTY, pelo que a saída canalizada e a dos testes permanecem inalteradas byte a byte. O localizador (não os bytes) é registado como predefinições da chave Math do Registry, piReferenceLargePath e piReferenceLargeDigits, tanto no modelo SLeeLa (lib/registry/SLRegistry.sleela) como no semeador nativo (registry/sleela_registry.c); lib/math/SLPiReference.sleela expõe largePath() / largeDigits(). A constante π é instalada na localização SLeeLa do sistema operativo (<data>/pi/) tanto pelo instalador make padrão como pelo instalador guiado «beautiful». Pormenores: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — o instalador guiado e um domínio math com backend nativo

@native, Native Drive e execução multilinguagem

Uma nova anotação de método @native solicita a compilação nativa antecipada de um método intensivo. O novo comando sleela aot encontra os métodos @native, verifica se cada um está dentro de um subconjunto transferível suportado e emite C/C++ — falhando de forma fechada (recusando, com uma razão precisa) perante qualquer construção que ainda não consiga traduzir, de modo que nunca é produzido um método traduzido pela metade.

sleela aot --list <file.sleela>    # veredito por método: ok / REFUSED (motivo)
sleela aot --emit <file.sleela>    # emitir C/C++ (stdout) para um programa no subconjunto

@native continua a ser um pedido de tratamento AOT, com as construções não suportadas rejeitadas antes da emissão. O Native Drive suporta compilações multiunidade de executáveis e bibliotecas partilhadas C/C++ através de compiladores do anfitrião (incluindo MSVC), saída AOT SLeeLa suportada, inspeção de símbolos face à ABI do carregador nativo, execução de processos sem shell, tratamento de stdin/stdout/stderr, encadeamento em várias fases e delegação XClass ao carregador de produção. O sleelactl expõe os respetivos comandos de compilação/execução e encaminha a inspeção XClass e a renderização/instalação explícita de unidades systemd através de inspect native-drive. A VM possui uma tabela limitada de identificadores de módulos nativos, com autorização obrigatória do anfitrião e identificadores verificados por geração. A sintaxe 3.0 acrescenta agora nativeOpen, nativeCall e nativeClose: o despacho de bytecode aditivo atravessa uma ABI com versão própria para null/bool/int64/double/UTF-8, enquanto arrays, structs e outros valores compostos pertencentes à VM permanecem dentro do interpretador e podem usar o recurso de bytecode com o mesmo nome. Os plugins podem opcionalmente receber uma tabela de callbacks do anfitrião com versão, para invocar funções SLeeLa exatas através de execução aninhada da VM, com raízes de GC para pilhas suspensas, uma lista de permissão explícita de nomes de callbacks do anfitrião e chamadas recursivas à API nativa rejeitadas. O código nativo continua a ser código confiável em processo, não uma sandbox. As anotações de política de processos no código-fonte têm um esquema com versão, mas ainda não são analisadas nem aplicadas. Pormenores, fronteiras de segurança e o registo das sete frentes de trabalho: Native Drive e pi-generator/AT-NATIVE.md.

XIX. Edições internacionais do README

A SLeeLa disponibiliza pontos de entrada README específicos por país para os 50 mercados da edição internacional. Cada país tem um ficheiro README.<CC>.md; quando são relevantes várias línguas, estas são agrupadas no ficheiro desse país.

Política de tradução: estes ficheiros são pontos de entrada localizados e iniciais. As respetivas introduções e títulos de língua estão localizados, enquanto a referência técnica completa permanece no README.md canónico em inglês. Um ficheiro de país não deve ser descrito como tradução completa até que todas as secções tenham sido traduzidas, os identificadores técnicos e as ligações tenham sido verificados e a edição tenha recebido revisão linguística. A cobertura linguística desta primeira fase é representativa e não constitui uma afirmação de que todas as línguas constitucionalmente reconhecidas, regionais, indígenas ou gestuais estejam integralmente traduzidas.


Estado da tradução: secções I–XIX traduzidas para português europeu. Identificadores técnicos, comandos, exemplos de código, nomes de ficheiros, ligações e endereços foram preservados. Recomenda-se revisão final por falantes nativos antes de a edição ser publicada como tradução editorial aprovada.