slw2gmi

slw2gmi is a converter from slweb to Gemini format. Although both are similar to Markdown, the two formats differ enough to warrant a full converter.

Manual

See https://strahinja.srht.site/man/slw2gmi/slw2gmi.1.html.

Prerequisites

C compiler - defaults in config.mk

Optional dependencies

git (for {git-log})

Install

$ git clone https://git.sr.ht/~strahinja/slw2gmi
$ cd slw2gmi
$ su
# make install

With got:

$ got clone https://git.sr.ht/~strahinja/slw2gmi
$ got checkout slw2gmi.git
$ cd slw2gmi
$ su
# make install

Persistent build configuration file

The file config.mk will be sourced when building targets which also accept configuration through environment variables. For example, CPPFLAGS and PREFIX are specified in config.mk.

OpenBSD

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

TODO (checklist)

See the file TODO for more information.

Bugs and limitations

Bugs can be reported using the ticket tracker. See the manpage (man slw2gmi) after installing slw2gmi for more information.

License

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

Previous commit: index.slw 90d6fb1 2024-11-03 15:28:19 +0000 (Страхиња Радић) (HEAD -> master, origin/master, origin/HEAD)