~strahinja/slweb

Simple static website generator

dd3b589 Update TODO

13 days ago

fc3052b index.slw: Add formatting

15 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, 2021  Страхиња Радић

    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/>.