slweb

Једноставни генератор статичких веб страна
git clone https://git.sr.ht/~strahinja/slweb
Дневник | Датотеке | Референце | ПРОЧИТАЈМЕ | ЛИЦЕНЦА

README (1746B)


      1 
      2 slweb
      3 =====
      4 
      5 slweb is a static website generator which aims at being simplistic. It
      6 transforms custom Markdown-like syntax into HTML.
      7 
      8 
      9 Q&A
     10 ---
     11 
     12 Q: Is this suckless?
     13 A: No. SGML, and by extension, HTML, isn't suckless.
     14 
     15 Q: Why do you call it "simple" then?
     16 A: Because one is not the synonym for the other.
     17 
     18 Q: Why not make a website generator as a shell script?
     19 A: slweb was a shell script in its conception (check its history of commits in
     20    git). However, I wanted to implement Markdown links with link ids
     21    [like][this]. This requires multiple passes by the parser and is better
     22    implemented as a full-blown program in C anyway. The other reason was that
     23    sed and awk have limits, which some of my pages hit.
     24 
     25    [this]: https://some.site
     26 
     27 Q: My static website generator is "truly simple", this is not simple!
     28 A: Good for you. By the way, that is a statement and not a question.
     29 
     30 
     31 Install
     32 -------
     33 
     34 See the file INSTALL in this repository.
     35 
     36 
     37 Examples
     38 --------
     39 
     40 See the examples/ directory in this repository.
     41 
     42 
     43 License
     44 -------
     45 
     46 slweb - Simple static website generator.
     47 Copyright (C) 2020-2026  Страхиња Радић
     48 
     49 This program is free software: you can redistribute it and/or modify it under
     50 the terms of the GNU General Public License as published by the Free Software
     51 Foundation, either version 3 of the License, or (at your option) any later
     52 version.
     53 
     54 This program is distributed in the hope that it will be useful, but WITHOUT ANY
     55 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
     56 PARTICULAR PURPOSE.  See the GNU General Public License for more details.
     57 
     58 You should have received a copy of the GNU General Public License along with
     59 this program.  If not, see <https://www.gnu.org/licenses/>.