docknot
Generador de sitios web estáticos creado en torno a un lenguaje de macros llamado thread, con soporte especial para gestionar versiones de software. Además de crear un sitio web, puede generar archivos tar para distribución y documentación de paquetes.
Estructura básica de un proyecto de software llamado mi-proyecto. La estructura de directorios podría ser:
$ tree mi_proyecto
mi-proyecto/
├── docknot.yaml
├── templates/
│ └── main.thread
├── docs/
│ └── index.md
└── versions/
├── v1.0.yaml
└── v2.0.yaml
El archivo docknot.yaml contiene la configuración principal del proyecto. Un ejemplo simple podría ser:
project_name: "Mi Proyecto"
version: "1.0"
author: "Tu Nombre"
description: "Descripción de mi proyecto."
El archivo de Versión v1.0.yaml para una versión específica podría verse así:
version: "1.0"
release_date: "2023-01-01"
features:
- Funcionalidad 1
- Funcionalidad 2
La plantilla main.thread podría definir cómo se verá el contenido del sitio. Un ejemplo simple:
Copiar
<html>
<head>
<title>{{ project_name }}</title>
</head>
<body>
<h1>{{ project_name }}</h1>
<p>{{ description }}</p>
</body>
</html>
Finalmente, para generar el sitio, ejecutar en la terminal desde el directorio del proyecto:
$ docknot build
$ docknot package