Tclssg

Difference between version 53 and 54 - Previous - Next
&| What | '''Tclssg''' |&
&| Where | https://github.com/tclssg/tclssg |&
&| Description | A [Tcl] [static site generator] that uses [Markdown] for content markup and HTML with embedded Tcl code for page templates.  Supports [Bootstrap] 3 themes.  Generates [sitemap%|%sitemaps].  Can deploy websites over [FTP], [SCP], etc.  Modular and extensible. |&
&| Platforms | Linux, Windows XP/7/8.x/10, macOS, FreeBSD, OpenBSD, NetBSD. |&
&| Prerequisites | Tcl 8.5 or newer, [Tcllib], [SQLite3] bindings for Tcl.  Also available as a self-contained [Starpack] for Windows, Linux and macOS. |&
&| Updated | 2020-04-10 (v2.0.0) |&
&| License | MIT |&
&| Screenshot | [Tclssg screenshot] |&

** Example sites, users **

   * https://core.tcl-lang.org/akupries/
   * https://www.magicsplat.com/
   * http://www.eventuallabs.com/blog/
   * https://www.tcl.tk/community/tcl2015/ through https://www.tcl.tk/community/tcl2019/
   * https://core.tcl-lang.org/
   * https://nuk-svk.ru/
   * http://www.bawt.tcl3d.org/
   * http://www.eurotcl.eu/   * https://mpcjanssen.nl/ 
   * Others? More?

** Discussion **

[escargo] 2014-07-16: It would be nice if you described supported platforms and prerequisites here.

[dbohdan] 2014-07-17: Thanks for the suggestion! I added platforms and prerequisites to the project summary above. A more detailed guide on how to install Tclssg can be found in the [https://github.com/dbohdan/tclssg/blob/master/README.md#getting-started%|%"Getting started" section] of the README.

[APN] Nice! How hard would it be to replace the Perl markdown with a Tcl extension?

[dbohdan] 2014-10-02: It shouldn't be hard at all; all Markdown-related functionality is isolated in the proc `::tclssg::templating::markdown-to-html` that calls an external Markdown processor of your choice (set in `::tclssg::config(markdownProcessor)`). Using a Tcl extension would be a matter of replacing this procedure. `Markdown.pl` is included so that the generator can work out of the box on *nix without the user having to compile any C code. 

[dbohdan] 2014-12-04: Version 0.15.2 removes the Perl dependency and replaces Markdown.pl with the Markdown package from [Caius].

[JM] 2014-12-05: good job.<<br>>
I think the markdown package is inserting an extra indentation level from the 2nd line of the code you want to post.<<br>>
Example:<<br>>
(The pattern on first line is OK, starting from the 2nd line, however, every line has an extra indentation level)<<br>>
[markdownCodeBlock]

[dbohdan] 2014-12-05: Thanks, JM. I'll look into the indentation problem. Would you mind filing an issue at https://github.com/dbohdan/tclssg/issues and pasting the Markdown input file that causes the problem and the corresponding HTML output there? Either that, or paste both here in a code block.

[JM] let me try here first:
the input:
 code block post example:

     4 spaces leading this line
       6 spaces leading this line
     4 spaces leading this line

 **the end**

the output:
        <p>code block post example:</p>

        <pre><code>4 spaces leading this line
          6 spaces leading this line
        4 spaces leading this line</code></pre>

        <p><strong>the end</strong></p>

looks like the generated code being indented from the 2nd line and beyond is just being treated as expected and shown as is.

[dbohdan] 2014-12-07: Fixed the issue in v0.16.1.

[HJG] 2016-02-23: Is there an example of a picture-gallery done with Tclssg ?
As in, several dozen photos, with thumbnails linking to bigger pictures (with descriptions), 
and generated links for next/prev, etc. ?


** See also **

   * [DustMote with Snit], Tclssg's embedded web server
   * [https://wiki.tcl-lang.org/page/tmpl%5Fparser#45b3a964f420ee74c949cace94523c9d538cffb6c69bb656d3f44fefa4d3561e%|%tmpl_parser implementation used by Tclssg]

<<categories>>Application | CMS | Internet | Web