Tclssg

screenshot of Tclssg
tclssg
Bytclssg

Tclssg

A static site generator

GithubLive Demo

Overview

Tclssg is a full-featured extensible static site generator written in Tcl. Its main purpose is to simplify the management of static websites, including optional blogs. The tool is primarily designed for Tcl programmers and is best suited for websites with a page count under 1000. Tclssg utilizes Markdown for content formatting, Bootstrap 3 for layout (with Bootstrap theme support), and Tcl code embedded in HTML for templating. It offers features like footnotes, blog post feeds in various formats (RSS, JSON Feed, and twtxt), SEO and usability enhancements, valid HTML5 and CSS level 3 output, support for external comment engines (e.g., Disqus), relative links in HTML output, and legacy deployment over FTP. Tclssg is reasonably fast and has minimal dependencies. Experimental self-contained binaries are available for Linux, Windows, and Mac.

Features

  • Markdown, Bootstrap themes, and Tcl code for templates: Tclssg supports formatting content using Markdown syntax along with customizable Bootstrap themes. The inclusion of Tcl code in HTML templates allows for flexible customization.
  • Regular pages and blog posts: Tclssg enables the creation of both regular pages and blog posts. Blog posts have a sidebar with tags and links to other blog posts, sorted by recency. The latest blog posts are featured on the blog index, and tag pages are generated to collect blog posts with the same tag.
  • Footnotes: Tclssg provides support for footnotes, allowing users to add additional information or references within their content.
  • New blog post feeds: Tclssg generates feeds for new blog posts in various formats such as RSS, JSON Feed, and twtxt, making it easy for readers to stay updated.
  • SEO and usability features: Tclssg includes built-in features that enhance Search Engine Optimization (SEO) and usability of the generated websites. This includes generating site maps, canonical links, previous/next page links, and noindex tags on collection pages.
  • Valid HTML5 and CSS level 3 output: The output generated by Tclssg adheres to standards-compliant HTML5 and CSS level 3.
  • Legacy deployment over FTP: Tclssg provides support for legacy deployment over FTP, allowing users to easily publish their websites to FTP servers.
  • Deployment over SCP or other protocols: Users can deploy their websites using SCP or other protocols by setting up a custom deployment command.
  • Support for external comment engines: Tclssg integrates with external comment engines, with Disqus being the supported option at present.
  • Relative links in HTML output: The HTML output generated by Tclssg includes relative links, making it suitable for viewing locally over the file:// protocol.
  • Reasonably fast: Tclssg is designed to be reasonably fast and can build websites with a few hundred pages in under a minute on modest hardware.
  • Few dependencies: Tclssg has minimal dependencies, making it easy to set up and use. Experimental self-contained binaries are available for Linux, Windows, and Mac.