A simple and smooth static site generator and CMS and a Gulp-based build tool for static websites. This tool helps you automate tasks like HTML templating, SCSS compilation, asset optimization, and live browser reloading during development.
Install the tool globally using npm:
npm install -g pyltra
The following commands are available:
Build the project:
pyltra build
This command cleans the dist directory, processes HTML templates, compiles SCSS, optimizes assets, and generates the final output in the dist folder.
Start the development server:
pyltra serve
This command builds the project and starts a development server with live reloading. The server serves files from the dist directory.
Run in production mode:
pyltra build --prod
This command enables production-specific optimizations like minification and sourcemap omission.
Your project must follow this structure for the tool to work correctly:
your-project/
├── src/
│ ├── templates/ # HTML templates (Nunjucks format)
│ │ └── *.html
│ ├── data/ # Data files (YAML, JSON, Markdown)
│ │ ├── shared.yaml # Shared data
│ │ ├── en.pages.yaml # Language-specific pages data
│ │ └── ... # Other data files
│ ├── assets/ # Static assets
│ │ ├── scss/ # SCSS files
│ │ ├── css/ # Plain CSS files
│ │ ├── js/ # JavaScript files
│ │ ├── img/ # Image files
│ │ └── other/ # Other static files
│ └── config.yaml # Configuration file
└── dist/ # Output directory (generated by the tool)
The tool reads configuration from a config.yaml file located in the root of your project. Here’s an example configuration:
languages:
- code: en
- code: fr
dataSources:
shared: data/shared.yaml
pages: data/${lang}.pages.yaml
collections:
articles:
dataFile: data/${lang}.articles.yaml
items:
- file: data/${lang}/article1.md
slug: article1
fallback:
title: "Default Title"
content: "Default Content"
templates:
articles-list: articles-list.html
article-item: article-item.html
bundles:
- bundles/example.html
config.yaml:languages: List of supported languages.dataSources: Paths to shared and language-specific data files.collections: Define collections (e.g., blog posts) with their data files and item templates.bundles: Optional list of additional files to copy directly to the dist folder.This tool uses Nunjucks for HTML templating. Nunjucks is a powerful templating engine that allows you to create dynamic HTML templates with logic, loops, and variables.
src/templates/index.html):<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{{ title }}</title>
</head>
<body>
<h1>{{ title }}</h1>
<p>{{ content }}</p>
{% if nav %}
<ul>
{% for item in nav %}
<li><a href="{{ item.url }}">{{ item.label }}</a></li>
{% endfor %}
</ul>
{% endif %}
</body>
</html>
For more information on Nunjucks syntax and features, visit the official documentation: Nunjucks Documentation
You can download the latest version of this tool from NPM: Your Gulp Tool on NPM
Alternatively, you can clone the source code from GitHub:
git clone https://github.com/nullqube/pyltra.git
Feel free to open issues or submit pull requests on GitHub.
This project is licensed under the MIT License.
1.1.0
Add 'init' to make the new project Update in using gulp tasks
FAQs
A Gulp-based build tool for static websites.
The npm package pyltra receives a total of 7 weekly downloads. As such, pyltra popularity was classified as not popular.
We found that pyltra demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
More than half of CISOs now manage 10+ security areas, often with few legal safeguards and short tenures, yet continue to secure budgets and higher pay.
Security News
Libxml2’s solo maintainer drops embargoed security fixes, highlighting the burden on unpaid volunteers who keep critical open source software secure.
Research
Security News
Socket investigates hidden protestware in npm packages that blocks user interaction and plays the Ukrainian anthem for Russian-language visitors.