oooo oooo
,88 ,88
,oooo. o8' oooo oo o. ,ooo. o88o.
o8( )p ,88 `88 88 `8 ,88",8 ,88"`8o
`o8o. 88' 88 ,88 ,8 88ooo^ 88' )8
d( )8o o8. . 88o"88,o" 88' . o8. ,8"
`8oo8' `ooo^ `8" `8" `8oo^ `ooo8"
slweb is a static website generator which aims at being simplistic. It transforms custom Markdown-like syntax into HTML.
See
https://strahinja.srht.site/man/slweb/slweb.1.html
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.
$ git clone https://git.sr.ht/~strahinja/slweb $ cd slweb $ su # make install
with
$ got clone https://git.sr.ht/~strahinja/slweb $ got checkout slweb.git $ cd slweb $ su # make install
The file config.mk will be sourced when building targets which also accept configuration through environment variables. For example, CC and PREFIX are specified in config.mk.
Before running make(1), comment the CPPFLAGS definition in config.mk above the line with the “OpenBSD” comment and uncomment the one below it:
#CPPFLAGS = -D_DEFAULT_SOURCE -D_POSIX_C_SOURCE=200809L \ # -D_XOPEN_SOURCE=700 # OpenBSD CPPFLAGS = -D_DEFAULT_SOURCE -D_POSIX_C_SOURCE=200809L \ -D_XOPEN_SOURCE=700 -D_BSD_SOURCE
Also, do the same for MANPREFIX:
#MANPREFIX = $(DESTDIR)$(PREFIX)/share/man # OpenBSD MANPREFIX = $(DESTDIR)$(PREFIX)/man
$ git clone https://aur.archlinux.org/slweb.git $ cd slweb $ makepkg -si
See the examples/ directory in this repository.
Given the file index.slw in the current directory:
---
site-name: Test website
site-desc: My first website in slweb
---
{main}
# Hello world
This is an _example_ of a statically generated HTML.
{/main}
after using the command:
$ slweb index.slw > index.html
file `index.html` contains:
<!DOCTYPE html>
<html lang="en">
<head>
<title>Test website</title>
<meta charset="utf8">
<meta name="description" content="My first website in slweb">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="generator" content="slweb">
</head>
<body>
<main>
<h1>Hello world</h1>
<p>This is an <em>example</em> of a statically generated HTML.</p>
</main>
</body>
</html>
See the file TODO for more information.
Bugs can be reported using the slweb ticket tracker.
See the manpage (man slweb) after installing slweb for more information.
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/.