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