~strahinja/slweb

Simple static website generator

c7d49f1 lib/make{date,version}: Make version use last commit if ahead of tag

5 days ago

34d244e lib/makedate: Export LC_ALL

6 days ago
slweb
=====

slweb is a static website generator which aims at being simplistic. It
transforms custom Markdown-like syntax into HTML.


Q&A
---

Q: Is this suckless?
A: No. SGML, and by extension, HTML, isn't suckless.

Q: Why do you call it "simple" then?
A: Because one is not the synonym for the other.

Q: Why not make a website generator as a shell script?
A: slweb was a shell script in its conception (check its history of commits in
   git). However, I wanted to implement Markdown links with link ids
   [like][this]. This requires multiple passes by the parser and is better
   implemented as a full-blown program in C anyway. The other reason was that
   sed and awk have limits, which some of my pages hit.

   [this]: https://some.site

Q: My static website generator is "truly simple", this is not simple!
A: Good for you. By the way, that is a statement and not a question.


Install
-------

See the file INSTALL in this repository.


Examples
--------

See the examples/ directory in this repository.


License
-------

slweb - Simple static website generator.
Copyright (C) 2020-2024  Страхиња Радић

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 <https://www.gnu.org/licenses/>.