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
Selenium
Launch tests with driver option:
pytest tests --driver firefox
Maybe you get the error:
selenium.common.exceptions.WebDriverException: Message: 'geckodriver' executable needs to be in PATH.
Then you need to download the latest geckodriver release from https://github.com/mozilla/geckodriver/releases (such as geckodriver-v0.26.0-linux64.tar.gz) and extract it to the correspongind directory (such as /usr/local/bin/).
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.
- a template with NAME.tal_replace_talqual_scripts.js gets rendered to a javascript file NAME.js with the faceted module.
- A template can include the faceted javascript module. See the portfolio example.
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.2 (2020-4-7)
- Add faceted select features
- Add faceted+batch combination
0.0.1 (2020-2-2)
- Initial release.
- Template structure + yaml data file = output html structure
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.