gemrec/gemrec.1

84 lines
1.6 KiB
Groff
Raw Normal View History

2024-08-11 04:30:31 +00:00
.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "GEMREC" "1" "2024-08-11"
.PP
.SH NAME
.PP
gemrec - a gemlog powered by recutils
.PP
.SH SYNOPSIS
.PP
gemrec [options]
.PP
.SH DESCRIPTION
.PP
gemrec
is a wrapper for GNU recutils
that turns a recfile database full of posts
into a gemlog.\&
.PP
Features include:
.PP
.PD 0
.IP \(bu 4
All posts and metadata centrally located
in a single rec database
.IP \(bu 4
Gemlog posts, each with a metadata block and tags
.IP \(bu 4
A gemsub compatible index of posts
.IP \(bu 4
A page for each tag,
linking back to each tagged page,
and an index of tags
.IP \(bu 4
An atom feed
.PD
.PP
.SH OPTIONS
.PP
.SS gemrec build|b
Buid all: feed, gemlog (and index), and tags (and index)
.PP
.SS gemrec b|build f|feed
Build feed
.PP
.SS gemrec b|build g|gemlog
Build gemlog pages that are older than the record'\&s \fIupdated\fR value.\& And the index.\&
.PP
.SS gemrec b|build t|tag|tags
Build tag pages, and the index.\&
.PP
.SS gemrec e|edit
Edit an existing post.\&
The post will be opened in $EDITOR.\&
First the editable metadata.\&
(Title, flags, tags.\&)
And then in a second editor instance,
the post body.\&
.PP
.SS gemrec n|new
Create a new post
.PP
.SS gemrec s|static
Copy static files
(images, static pages, etc)
from \fI/static\fR
to the build dir.\&
.PP
.SS gemrec u|up|upload
Upload to a remote server.\&
.PP
.SH SEE ALSO
.PP
\fIgemrec(5)\fR \fIrecsel\fR(1) \fIrecset\fR(1)
.PP
.SH AUTHORS
.PP
dozens <dozens@tilde.\&team>