Sobre o projeto
H5P Game Map é um tipo de conteúdo H5P que permite aos alunos selecionarem seus próprios exercícios por meio de uma interface de mapa de jogo.
Expectativas de suporte: o README afirma que o tipo de conteúdo é resultado de um trabalho contratado com requisitos específicos que podem não corresponder às expectativas de outros usuários. O desenvolvedor o disponibilizou abertamente para que possa ser usado gratuitamente, mas não está obrigado a fornecer suporte gratuito, aceitar solicitações de recursos ou aceitar pull requests; ele pode continuar trabalhando nele por conta própria.
Fluxo de trabalho de construção conforme documentado:
- Clone o repositório com git e faça o checkout do branch de interesse.
- Execute npm install para instalar os módulos necessários.
- Execute npm run build para construir o projeto, ou npm run watch para ter tudo reconstruído continuamente enquanto edita.
- Sempre execute npm run build antes de colocar o código em produção.
- Execute npm run lint para verificar violações do guia de estilo de codificação.
- O processo de construção transpila ES6 para versões anteriores para melhorar a compatibilidade com navegadores mais antigos; funções não suportadas por alguns navegadores requerem um polyfill.
- O processo de construção também move os arquivos de origem para um único arquivo de distribuição e minifica o código.
Solução alternativa para tamanho de semântica: integrações comuns de H5P usam bancos de dados mySQL nos quais o campo semantics da tabela h5p_libraries é do tipo text, armazenando até 64 KB de dados. O semantics.json do GameMap excede esse limite, então o projeto mantém semantics_src.json e o minifica, o que é feito por npm run build_semantics. O README observa que isso não é ideal porque deve ser executado quando as semânticas mudam, e que npm run build e npm run watch também constroem as semânticas minificadas.
Empacotamento: o README recomenda instalar a ferramenta de linha de comando H5P em vez de compactar tudo manualmente, porque essa ferramenta lida com várias coisas automaticamente. Em casos simples, executar h5p pack seguido do diretório do repositório e um nome de arquivo de destino é suficiente. Para mais informações sobre o uso dos arquivos de distribuição no H5P, o README aponta para um vídeo introdutório e o guia de desenvolvimento de H5P em h5p.org/library-development.
O README fornecido aqui não contém termos de licença, informações de versão, lista de recursos ou documentação de uso para o usuário final além dessas notas de construção, semântica e empacotamento.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.