From 07aaf8e1a74d04297245daab89bcd2afcfa88cba Mon Sep 17 00:00:00 2001 From: Lucas Rayan Date: Sun, 15 Nov 2026 19:51:53 -0300 Subject: [PATCH] =?UTF-8?q?feat:=20novo=20site=20e=20interface;=20tradu?= =?UTF-8?q?=C3=A7=C3=A3o=20Braille=20no=20navegador=20(1.4.0)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Interface reescrita (design próprio, tema claro/escuro, a11y WCAG 2.2 AA), seções do site e artigo IDEIA @ CSBC 2025. Tradutor portado para JS com paridade 100% contra o Python; sem Tailwind nem axios. Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 24 + README.md | 2 + index.html | 891 +++++++++++++------------- public/index.js | 214 ++++++- public/locales/en.js | 244 ++++--- public/locales/pt_br.js | 244 ++++--- public/locales/zh.js | 244 ++++--- public/modules/braille_data.js | 83 +++ public/modules/converter.js | 151 +++-- public/modules/i18n.js | 60 +- public/modules/pinyin_data.json | 1 + public/modules/stl.js | 102 +-- public/modules/translator.js | 550 ++++++++++++++++ public/modules/ui.js | 61 +- public/preview.js | 45 +- public/style.css | 1064 ++++++++++++++++++++++++------- scripts/gerar-dados-pinyin.py | 46 ++ scripts/paridade-tradutor.mjs | 156 +++++ scripts/paridade-tradutor.py | 29 + 19 files changed, 3193 insertions(+), 1018 deletions(-) create mode 100644 public/modules/braille_data.js create mode 100644 public/modules/pinyin_data.json create mode 100644 public/modules/translator.js create mode 100644 scripts/gerar-dados-pinyin.py create mode 100644 scripts/paridade-tradutor.mjs create mode 100644 scripts/paridade-tradutor.py diff --git a/CHANGELOG.md b/CHANGELOG.md index a19d02f..ebf8003 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,6 +13,30 @@ Everything notable in InBraille is recorded here. The format follows ## [Unreleased] +## [1.4.0] - 2026-11-15 + +### Added + +- New website around the converter: hero with a tactile Braille plate, "How it works", 3D printing + specs and tips, privacy, the peer-reviewed paper (IDEIA @ CSBC 2025, DOI + 10.5753/ideia.2025.9057) with copyable BibTeX and ABNT citations, credits and FAQ. +- Light/dark theme (follows the system, toggle persisted), mobile navigation menu, keyboard + shortcuts (Ctrl/Cmd+Enter converts; arrow keys move between tabs; Esc closes menus), toasts and + screen-reader announcements for conversion and STL generation. +- Text↔Braille translation now runs in the browser (`public/modules/translator.js`, a port of + `src/translation` and `src/domain`, Chinese pinyin data loaded on demand). A parity script + (`scripts/paridade-tradutor.mjs`) checks it against the Python translator: 337,176 cases, 0 + differences. + +### Changed + +- Interface rewritten from scratch: Tailwind CDN and axios removed, own design system + (Atkinson Hyperlegible, embossed-dot motif), WCAG 2.2 AA focus, contrast, targets, reduced + motion and forced colors. All rewritten copy in Portuguese, English and Chinese, plus new + title, description, Open Graph and JSON-LD (including the `ScholarlyArticle`). +- Nothing the user types leaves the browser: conversion, STL generation and preview are local. + The `/api/*` routes stay available for existing integrations. + ## [1.3.3] - 2026-11-02 ### Changed diff --git a/README.md b/README.md index 6305be9..7d3cabd 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,8 @@ In addition to being an accessible and easy-to-use technology, this project has ## Backend Architecture (`src/`) +> Since 1.4.0 the web interface translates and generates STL entirely in the browser (`public/modules/`); the Python API below remains for integrations. + The Python backend is organized into domain-driven subdirectories under `src/`, utilizing **FastAPI** for web routing and **VTK (Visualization Toolkit)** for 3D modeling: ### 1. Domain Model (`src/domain/`) diff --git a/index.html b/index.html index 7103854..6fb27ba 100644 --- a/index.html +++ b/index.html @@ -3,16 +3,17 @@ - InBraille - Conversor de Texto para Braille e Impressão 3D STL | Acessibilidade Tátil - + InBraille: texto para Braille e placas táteis em 3D + - - + + + @@ -28,8 +29,8 @@ - - + + @@ -39,8 +40,8 @@ - - + + @@ -50,14 +51,17 @@ + - + - - -
-
- + + -
-
- - - 🇧🇷 Português - + -
-
-
-
-

Transforme texto em Braille facilmente

-

- O InBraille é uma ferramenta brasileira que converte textos para Braille e os exporta em formato ASCII e STL para impressão 3D, promovendo acessibilidade e inclusão. -

- - Experimente agora - +
+
+
+
+

Tecnologia assistiva gratuita

+

Escreva. Toque. Leia.

+

O InBraille transforma qualquer texto em Braille e em uma placa tátil pronta para a impressora 3D, em segundos e sem sair do navegador.

+ -
- ⠿ +
    +
  • Gratuito e aberto
  • +
  • Roda no seu navegador
  • +
  • Português, inglês e chinês
  • +
+
+
+
+
+

Conversor

-
-

Conversor

- -
- - -
- -
- -
-
- - -
-
- - -
-
- - -
+
+
+ +
- - - -
- -
-
- - - - -
- - 0 caracteres -
-
- -
- - - - -
- - -
-
-
- -
- -
- -
-

Exportar para Impressão 3D

- -
-
-
- +
+ Alfabeto Braille +
+
+ +
-
-

- Atenção: - A exportação para STL utiliza apenas o conteúdo em Braille. O texto original, ou convertido, não é usado para gerar o modelo 3D. Certifique-se de converter seu texto para Braille antes de exportar. -

+
+ + +
+
+ +
+
-
-
-
- -
-
-

- Indicador de orientação: - para você não montar a peça de cabeça para baixo, o modelo inclui uma marca de referência. Com placa, há um ponto maior no canto inferior esquerdo. No modo "apenas os pontos", há uma barrinha na parte de baixo. Mantenha essa marca embaixo/à esquerda ao ler ou colar. -

+ + + +
+
+ + +
+ + 0 caracteres
+

Atalho: Ctrl+Enter converte.

-
-
- -
+ - - -
-
-

- Opções Avançadas -

- -
- -
-
-

Sobre o InBraille

- -
-

- O InBraille é uma ferramenta inovadora, brasileira e pernambucana, que converte textos para Braille e os exporta tanto em formato ASCII quanto em placas STL para impressão 3D. -

- -

- Com essa solução, é possível ampliar a acessibilidade e a inclusão, permitindo que qualquer pessoa possa criar materiais táteis para pessoas com deficiência visual. -

- -

- Além de ser uma tecnologia acessível e de fácil uso, esse projeto tem um impacto social significativo, possibilitando a produção de textos, etiquetas, placas informativas e materiais educacionais em Braille de forma acessível e personalizada. -

- -

- Seja para fins educacionais, profissionais ou do dia a dia, essa ferramenta visa tornar a informação verdadeiramente universal. O objetivo é democratizar o acesso ao Braille por meio da cultura maker e da impressão 3D, proporcionando autonomia e independência para quem precisa. -

+
+
+

Impressão 3D

+

Exportar para Impressão 3D

+
+
+
+ Antes de imprimir +

Atenção: A exportação para STL utiliza apenas o conteúdo em Braille. O texto original, ou convertido, não é usado para gerar o modelo 3D. Certifique-se de converter seu texto para Braille antes de exportar.

+

Indicador de orientação: para você não montar a peça de cabeça para baixo, o modelo inclui uma marca de referência. Com placa, há um ponto maior no canto inferior esquerdo. No modo "apenas os pontos", há uma barrinha na parte de baixo. Mantenha essa marca embaixo/à esquerda ao ler ou colar.

+
-
-
-
-
- +
+ +
-
-

Neurodiversidade na Tecnologia

+
-

- Esta ferramenta foi desenvolvida por Lucas Guerra, um estudante e desenvolvedor autista que transformou sua perspectiva única em soluções tecnológicas inclusivas. O autismo trouxe uma abordagem diferente para a criação deste projeto, com foco intenso em detalhes e padrões que resultaram em uma ferramenta mais acessível e intuitiva. -

- -

- Essa solução é fruto do Laboratório de Tecnologia 3D e Inclusiva do Departamento de Computação da Universidade Federal Rural de Pernambuco (UFRPE), que promove a inclusão e acessibilidade por meio da tecnologia. O laboratório é um espaço de pesquisa e desenvolvimento que busca criar soluções inovadoras para pessoas com deficiência, utilizando impressão 3D e outras tecnologias assistivas. -

+
+
+ +

Converta um texto e toque em Gerar STL para ver a placa em 3D aqui.

+
+ +
+ +
- -
-

- Saiba mais -

-

- Veja mais sobre essa ferramenta na página dela no - - Ciência Embarcada - -

-
-
-

- - Perguntas Frequentes (FAQ) -

+
+
+

Como funciona

+

Do texto à placa em três passos

+
    +
  1. + +

    Escreva

    +

    Digite ou cole o texto e escolha o alfabeto Braille.

    +
  2. +
  3. + +

    Confira o Braille

    +

    Veja o resultado, copie ou salve para usar em outros materiais.

    +
  4. +
  5. + +

    Imprima a placa

    +

    Gere o STL, gire o modelo em 3D e baixe para a sua impressora.

    +
  6. +
+
+
-
-
- - O que é o InBraille e para que serve? - - -

- O InBraille é uma ferramenta brasileira, gratuita e de código aberto voltada para a acessibilidade. Ele converte textos comuns para o sistema Braille e gera automaticamente modelos 3D no formato STL prontos para fatiadores e impressão 3D de placas, sinalizações e etiquetas táteis. -

-
+
+
+

Impressão 3D

+ +

As placas seguem as medidas usuais do Braille para que a leitura tátil seja confortável. Uma marca de orientação mostra qual lado fica para cima.

+
+
Altura do ponto
0,65 mm
+
Distância entre celas
6,6 mm
+
Largura padrão da placa
143,3 mm (22 ⠿)
+
Marca de orientação
Ponto de referência no canto
+
+
+

Dicas de impressão

+
    +
  • Imprima com a face dos pontos para cima.
  • +
  • Use camadas de 0,1 a 0,12 mm para pontos bem definidos.
  • +
  • PLA ou PETG funcionam bem.
  • +
+
+
+
-
- - Como exportar e imprimir Braille em uma impressora 3D? - - -

- Digite seu texto no conversor, clique em Converter e em seguida em Gerar e Visualizar STL. Você pode inspecionar o modelo interativamente em 3D, ajustar parâmetros como espessura da placa e modo "Apenas os Pontos", e clicar em Baixar STL para salvar o arquivo pronto para seu fatiador 3D (como Cura ou PrusaSlicer). -

-
+
+
+ +

Privacidade

+

Seu texto não sai do seu computador

+

Tudo acontece no seu navegador: a conversão para Braille, a geração do STL e a pré-visualização em 3D. Nenhum texto é enviado a servidores nem armazenado.

+
+
-
- - O InBraille é gratuito para escolas, universidades e projetos sociais? - - -

- Sim, 100% gratuito e livre! O projeto foi criado com foco em utilidade pública e impacto social para democratizar a criação de recursos didáticos e sinalização inclusiva por educadores, profissionais e entusiastas da cultura maker. -

-
+
+
+

Publicado no CSBC 2025

+

Pesquisa revisada por pares

+
+

InBraille: Uma Abordagem Tecnológica para a Democratização do Braille através da Impressão 3D

+

Autores Lucas Guerra, Marcos Cardoso, Marcos Castro (UFRPE)

+ +

O InBraille converte textos para Braille e gera placas 3D inclusivas, seguindo os padrões brasileiro e estadunidense. Protótipos validados demonstraram precisão nas medidas e legibilidade tátil.

+
+
Evento
I Workshop de Inovação, Desenvolvimento, Educação e Inclusão com Ações Maker (IDEIA), no CSBC 2025
+
Local
Maceió/AL
+
Páginas
107–116
+
Editora
SBC
+
Publicado em
+
+ +
+
+ + +
+
+
+
@inproceedings{guerra2025inbraille,
+  author = {Lucas Guerra and Marcos Cardoso and Marcos Castro},
+  title = {InBraille: Uma Abordagem Tecnológica para a Democratização do Braille através da Impressão 3D},
+  booktitle = {Anais do I Workshop de Inovação, Desenvolvimento, Educação e Inclusão com Ações Maker (IDEIA)},
+  location = {Maceió/AL}, year = {2025}, pages = {107--116}, publisher = {SBC},
+  address = {Porto Alegre, RS, Brasil}, doi = {10.5753/ideia.2025.9057},
+  url = {https://sol.sbc.org.br/index.php/ideia/article/view/36298}
+}
+
Citação em BibTeX
+
+ +
+ +
+
+
+
-
- - Quais alfabetos Braille são suportados? - - -

- O sistema conta com suporte a três convenções: o Alfabeto Brasileiro (com normas do Ministério da Educação), o Norte-Americano (English Braille) e o Chinês (com suporte a conversão automática de Pinyin numerado e caracteres Hanzi). -

-
+
+
+

Sobre

+

Quem faz o InBraille

+

O InBraille nasceu no Laboratório de Tecnologia 3D e Inclusiva do Departamento de Computação da UFRPE, em Pernambuco, para que escolas, famílias e transcritores produzam material em Braille sem equipamento caro.

+
+
+

Neurodiversidade na Tecnologia

+

Esta ferramenta foi desenvolvida por Lucas Guerra, um estudante e desenvolvedor autista que transformou sua perspectiva única em soluções tecnológicas inclusivas. O autismo trouxe uma abordagem diferente para a criação deste projeto, com foco intenso em detalhes e padrões que resultaram em uma ferramenta mais acessível e intuitiva.

+

Essa solução é fruto do Laboratório de Tecnologia 3D e Inclusiva do Departamento de Computação da Universidade Federal Rural de Pernambuco (UFRPE), que promove a inclusão e a acessibilidade por meio da tecnologia. O laboratório é um espaço de pesquisa e desenvolvimento que busca criar soluções inovadoras para pessoas com deficiência, utilizando impressão 3D.

+
+
+

Créditos

+

Criado por Lucas Guerra, com Marcos Cardoso e Marcos Castro, no Laboratório de Tecnologia 3D e Inclusiva (DC/UFRPE). Mantido por Ciência Embarcada.

+ +
+
+
+
-
- - Por que existe um indicador de orientação na peça 3D? - - -

- Para evitar que a peça tátil seja colada ou lida de cabeça para baixo, cada placa gerada inclui uma marca de referência geométrica no canto inferior esquerdo (ou uma barra inferior no modo apenas pontos). Mantendo essa marca para baixo e à esquerda, garante-se que a leitura do Braille seja perfeitamente fiel. -

-
+
+
+

FAQ

+

Perguntas frequentes

+
+
+ O que é o InBraille e para que serve? +

O InBraille é uma ferramenta brasileira, gratuita e de código aberto voltada para a acessibilidade. Ele converte textos comuns para o sistema Braille e gera automaticamente modelos 3D no formato STL prontos para fatiadores e impressão 3D de placas, sinalizações e etiquetas táteis.

+
+
+ Como exportar e imprimir Braille em uma impressora 3D? +

Digite seu texto no conversor, clique em Converter e em seguida em Gerar e Visualizar STL. Você pode inspecionar o modelo interativamente em 3D, ajustar parâmetros como espessura da placa e modo "Apenas os Pontos", e clicar em Baixar STL para salvar o arquivo pronto para seu fatiador 3D (como Cura ou PrusaSlicer).

+
+
+ O InBraille é gratuito para escolas, universidades e projetos sociais? +

Sim, 100% gratuito e livre! O projeto foi criado com foco em utilidade pública e impacto social para democratizar a criação de recursos didáticos e sinalização inclusiva por educadores, profissionais e entusiastas da cultura maker.

+
+
+ Quais alfabetos Braille são suportados? +

O sistema conta com suporte a três convenções: o Alfabeto Brasileiro (com normas do Ministério da Educação), o Norte-Americano (English Braille) e o Chinês (com suporte a conversão automática de Pinyin numerado e caracteres Hanzi).

+
+
+ Por que existe um indicador de orientação na peça 3D? +

Para evitar que a peça tátil seja colada ou lida de cabeça para baixo, cada placa gerada inclui uma marca de referência geométrica no canto inferior esquerdo (ou uma barra inferior no modo apenas pontos). Mantendo essa marca para baixo e à esquerda, garante-se que a leitura do Braille seja perfeitamente fiel.

+
+
-