jmmasw

Solo hazme un sitio web estático

JMMASW es ​​una herramienta simple para un problema simple: los sitios web estáticos.

Operación

1. Cargue todos los archivos con la extensión ".html" o ".tmpl"
2. Analice cada archivo en una plantilla de GO
3. Cargue el archivo de datos ("./data.json" por predeterminado)
4. Ejecute todas las plantillas con un nombre que termina en ".html"
5. Escriba la salida a los archivos a menos que esté vacío

Uso

JMMASW acepta los siguientes parámetros de línea de comandos:

• data : ubicación del archivo de datos
• dir : ubicación del proyecto, predeterminado es el directorio actual
• Directorio de salida static-out , predeterminado es ./jasw-out (para "solo un sitio web estático")
• ignore-no-data : predeterminado es verdadero. Si se establece en falso, entonces un archivo de datos faltante da como resultado la terminación del programa

Edificio

JMMASW se construye usando GO1.8, por lo que, al instalar mínimo, GO1.8 para que esto funcione, pero las versiones más antiguas también pueden funcionar (pero no hay promesas)

Para instalar simplemente ejecute los siguientes comandos:

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

Plantillas

Para obtener información sobre el formato de plantilla, consulte las entradas GIdoc en html/template y text/template .

Las plantillas se definen por su nombre de archivo, pero si definió manualmente las plantillas, esto no se aplica.

Solo las plantillas con un nombre que termine en ".html" se representarán ", los archivos .tmpl" solo se analizarán y están destinados a una funcionalidad común.

Funciones de plantilla

• file acepta una sola cadena como parámetro e intenta leer el formulario de archivo especificado en el sistema de archivos
• json analiza una cadena dada en formato JSON, la estructura de nivel superior debe ser un mapa, no se permiten matrices simples
• markdown representa una cadena dada en HTML usando procesadores de Markdown sin desinfectación (¡no se use en las entradas del usuario!)
• dict acepta cualquier número de pares de valor clave con una tecla tipo cadena y devuelve el resultado. Esto permite combinar varias variables en una sola tubería.

Hoja de ruta

• Incluye el analizador de markdown y el cargador de archivos de Markdown
• Función para analizar archivos .json adicionales desde las plantillas
• Método para ignorar directorios específicos
• Funcionar para emitir archivos que no están presentes como plantillas
  • Ejemplo: index.html genera index-en.html y index-de.html en lugar de index.html

Esperar que?

Si se pregunta por qué existe esta herramienta: la hice para poder generar mi sitio web para varios idiomas sin tener que copiar pastas la mitad del sitio web todo el tiempo.

Consideré Hugo, que es un excelente generador de páginas estáticas, pero también es demasiado complicado para esta aplicación. JMMASW funciona con plantillas HTML "crudas" y no supone sobre su sitio web.

Puede tomar su sitio web como está ahora y siempre que no contenga un código de templatura inválido, saldrá al otro extremo de JMMASW sin un cambio.