Almost-minimal filesystem based blog.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Brennen Bearnes 83a484492b iso_date(): test with a regex instead of specific string 3 months ago
bin testing: get_date(), rendering util, mock file writes 3 months ago
example EntryStore: Add methods for further slicing entry list 5 months ago
lib/App iso_date(): test with a regex instead of specific string 3 months ago
t iso_date(): test with a regex instead of specific string 3 months ago
.gitignore .gitignore: add pod2htmd.tmp 6 months ago
.travis.yml mv travis.yml .travis.yml 3 years ago
Build.PL v6.0.0: expand EntryStore, test more, cache harder 5 months ago
COPYING add a copy of the gpl and a LICENSE section 1 year ago
Changes iso_date(): test with a regex instead of specific string 3 months ago
README.md replace README.pod with README.md; remove Travis link 4 months ago
benchmark.pl Merging in newer Wala stuff. 11 years ago

README.md

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:

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/