jmmasw

Apenas me faça um site estático

O JMMASW é uma ferramenta simples para um problema simples: sites estáticos.

Operação

1. Carregue todos os arquivos com a extensão ".html" ou ".tmpl"
2. Analisar cada arquivo em um modelo Go
3. Carregue o arquivo de dados ("./data.json" por padrão)
4. Execute todos os modelos com um nome que termina em ".html"
5. Escreva a saída para os arquivos, a menos que esteja vazio

Uso

JMMASW aceita os seguintes parâmetros de linha de comando:

• data - Localização do arquivo de dados
• dir - Localização do projeto, o padrão é o diretório atual
• Diretório de saída static-out , o padrão é ./jasw-out (para "apenas um site estático")
• ignore-no-data -Padrões para true. Se definido como false, um arquivo de dados ausente resulta no término do programa

Prédio

O JMMASW é construído usando o GO1.8, então você deve, no mínimo

Para instalar, basta executar os seguintes comandos:

 go get go.rls.moe/jmmasw
go install go.rls.moe/jmmasw

Modelos

Para obter informações sobre o formato do modelo, consulte as entradas GODOC no html/template e text/template .

Os modelos são definidos pelo nome do arquivo, mas se você definido manualmente, os modelos isso não se aplica.

Somente modelos com um nome que termina em ".html" serão renderizados ". Os arquivos .tmpl" serão analisados ​​e se destinam à funcionalidade comum.

Funções de modelo

• file aceita uma única string como parâmetro e tenta ler o arquivo especificado do sistema de arquivos
• json analisa uma determinada sequência no formato JSON, a estrutura de nível superior deve ser um mapa, matrizes simples não são permitidas
• markdown renderiza uma determinada string no HTML usando processadores de marcação sem qualquer higienização (não use nas entradas do usuário!)
• dict aceita qualquer número de pares de valor-chave com uma chave tipada de string e retorna o resultado. Isso permite combinar várias variáveis ​​em um único pipeline

Roteiro

• Inclua o analisador de Markdown e o carregador de arquivos de Markdown
• Função para analisar arquivos .json adicionais dentro dos modelos
• Método para ignorar diretórios específicos
• Função para produzir arquivos que não estão presentes como modelos
  • Exemplo: Index.html Gera index-en-en.html e index-de-de.html em vez de index.html

Espere o quê?

Se você está se perguntando por que essa ferramenta existe: eu o fiz para que eu possa gerar meu site para vários idiomas sem ter que copiar metade do site o tempo todo.

Eu considerei Hugo, que é um excelente gerador de páginas estáticas, mas também é muito complicado para este aplicativo. O JMMASW trabalha com modelos HTML "RAW" e não assume o seu site.

Você pode pegar seu site como está agora e, desde que não contenha código de templos internos inválidos, ele será lançado no outro extremo do JMMASW sem uma alteração.