Open fititnt opened 3 years ago
Humm... que interessante. Até que primeiro rascunho demorou muito menos do que eu imaginava.
Com a adição de um estágio de construção intermediário (isto é, que converte _data/schemam.yml => _data/expandendum/schemam.json
), menos linhas de código são necessárias em Ruby (e de quebra, em teoria, os arquivos principais do Hapi ficam "mais portáveis" caso no futuro tenha que ser parcialmente re-escrito em outras linguagens de programação, porém creio que teríamos que ter MUITOs dados para precisar migrar para NodeJS por questões de performance).
Outro ponto é que o arquivo _data/schemam.yml
usa informações do _data/referens.yml
para recomendações adicionais de como ele expande em muito mais páginas de entrada.
Creio que vou procurar pelo menos estabilizar e depois documento essa parte nova.
No momento as páginas de entrada dos esquemas de dados ainda vão exibir informações meio brutas.
1.
Que lindo <3! O Hapi::ArchivumSimplex (_plugins/jekyll_hapi_schemam.rb
), já está conseguindo gerar arqivos simples (isto é, traduzindo arquivos que não são HTML final, o que inicialmente pode ser JSON, SQL, GraphQL, mas depois pode ate mesmo ser build scripts ou pequenos snipeets de codigo) como parte da geração dos esquemas de dados.
Creio que até podemos por os OpenAPI agora como um subprojeto dos schemas (e dai as páginas de API usam).
Parte do que estamos fazendo é próximo do OpenAPI generator (https://github.com/OpenAPITools/openapi-generator) porém nosso foco é tradução extraída de planilhas HXL (vide Convenção de tags HXL em conjunto de dados para armazenar Memória de Tradução (eng: HXL translation memory TM) #58
Tópico sobre Produto Mínimo Viável (em inglês: MVP) de gerar a página de entrada de cada esquema de dados.
Referencia inicial
Atualmente tivemos que criar um plugin Jekyll para poder 'expandir' os arquivos YAML, por exemplo:
Gera o seguinte sitemap
O que, idealmente, deveria ser feito
Como a ideia é facilitar para deixar o máximo de trabalho para pessoas tradutoras, inicialmente temos que pelo menos replicar o que é feito com as páginas HTML da API, mas agora para schemas.
Porém os arquivos YAML de API são um pouco repetitivos. Isso quer dizer que a nova versão dessa logica em ruby precisa implementar algumas melhorias.
Isso vai dar trabalho. Porém vale a pena fazer isso antes de expandir o projeto.