TAL Chameleon (static site generator)
Project description
talqual
TAL Chameleon static site generator.
Simple structure: templates + data -> output html
Installation
Install from PyPI:
pip install talqual
Developing
Install requirement and launch tests:
pip install -r requirements-dev.txt pytest tests
Usage
talqual templates_dir
talqual templates_dir output_html –data data.yaml
python -m talqual templates_dir output_html –data data.yaml
or from code:
from talqual.main import run run(templates_dir, html_dir, data_yaml_file)
Features
Template elements: Folder, File, TalTemplate/Html, NoView, TalCommand Data elements: Python objects, yaml files
Define a data.yaml file
Define a templates directory
A folder in the templates is created to the html directory
A file (pdf, image, css, js, etc.) in the templates is copied to the html directory
A no view element (file or directory starting by _) in the templates is not created to the html directory
A TAL template in the templates gets rendered to the html directory
It can reference data from the data directory or from python objects
It can be:
a static .html or .htm (with no templating)
a simple template .html .htm or .pt (with TAL templating)
a template with macros .html .htm or .pt (with TAL and METAL templating)
A TAL Command gets executed and rendered to the html directory
a template with NAME.tal_repeat_VARIABLE.pt gets repeated by data[VARIABLE] (it must be an iterable). Results in NAME.0.html, NAME.1.html, NAME.2.html, etc.
a template with NAME.tal_batch_VARIABLE_PAGESIZE.pt gets rendered by a Batch of PAGESIZE for data[VARIABLE] (it must be an iterable). Results in NAME.html, NAME.2.html, NAME.3.html, etc.
License
talqual is offered under the GPLv3 license.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
CHANGES
0.0.1 (2020-2-2)
Initial release.
Template structure + yaml data file = output html structure
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.