2.3 KiB
wrt
wrt (WRiting Tool) is a static site / blog generator and some related utilities.
This project can be thought of as both a format for storing blog entries and other writing in folders and files, as well as the utilities for rendering them to a full-fledged web site. It's particularly well-suited to collections of blog entries organized by date.
wrt can be found at:
- metacpan.org as App::WRT - latest CPAN release
- https://code.p1k3.com/gitea/brennen/wrt - latest code
I have been using some version of this code to publish p1k3 since 2001, and have written various posts about it over the years.
installation and use
You'll need a Unix / Linux, and a relatively recent Perl installation. In practice I know that Debian Jessie or later (or Ubuntu 16.04 or later) and Perl 5.26.1 work.
The short version, git edition:
$ git clone https://code.p1k3.com/gitea/brennen/wrt.git
$ cd wrt
$ perl Build.PL
$ ./Build installdeps
$ ./Build test
$ ./Build install
The short version, CPAN edition:
$ cpan -i App::WRT
Starting a new site once installed:
# Set up some defaults:
$ mkdir project && cd project
$ wrt init
# Edit an entry for January 1, 2019:
$ mkdir -p archives/2019/1/
$ nano archives/2019/1/1
# Publish HTML to project/public/
$ wrt render-all
Please see the App::WRT listing on MetaCPAN or the POD documentation in lib/App/WRT.pm in this repository for detailed instructions.
copying
wrt is copyright 2001-2019 Brennen Bearnes.
wrt 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 2 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 http://www.gnu.org/licenses/