main
commit
af2c64ede6
|
@ -0,0 +1,2 @@
|
|||
dist/*
|
||||
!/dist/.gitkeep
|
|
@ -0,0 +1,17 @@
|
|||
Copyright 2020
|
||||
|
||||
We're no strangers to love. You know the rules and so do I. A full
|
||||
commitment's what I'm thinking of. You wouldn't get this from any other
|
||||
guy. I just wanna tell you how I'm feeling. Gotta make you understand:
|
||||
|
||||
1. Never gonna give you up
|
||||
2. Never gonna let you down
|
||||
3. Never gonna run around and desert you
|
||||
4. Never gonna make you cry
|
||||
5. Never gonna say goodbye
|
||||
6. Never gonna tell a lie and hurt you
|
||||
|
||||
WE'VE KNOWN EACH OTHER FOR SO LONG. YOUR HEART'S BEEN ACHING BUT YOU'RE
|
||||
TOO SHY TO SAY IT. INSIDE WE BOTH KNOW WHAT'S BEEN GOING ON. WE KNOW THE
|
||||
GAME AND WE'RE GONNA PLAY IT. AND IF YOU ASK ME HOW I'M FEELING. DON'T
|
||||
TELL ME YOU'RE TOO BLIND TO SEE.
|
|
@ -0,0 +1,31 @@
|
|||
# gemrec
|
||||
|
||||
This is a little recfile database that produces a gemlog
|
||||
|
||||
## GETTING STARTED
|
||||
|
||||
1. read the man page (`gemrec.1`).
|
||||
or `gemlog.1.scd` which is the scdoc[1] source file,
|
||||
which is markdown (kinda) that generates the manpage.
|
||||
|
||||
2. read `gemrec`.
|
||||
you'll need to edit some stuff in there anyway.
|
||||
the globals and the templates.
|
||||
|
||||
[1] https://git.sr.ht/~sircmpwn/scdoc/
|
||||
|
||||
## REQUIREMENTS
|
||||
|
||||
- GNU recutils 1.9
|
||||
- awk version 20240311
|
||||
- and other stuff too
|
||||
|
||||
## INSTALL
|
||||
|
||||
1. copy `gemrec` somewhere in your path.
|
||||
maybe `~/bin`?
|
||||
|
||||
2. copy `gemrec.1` to where your man pages are.
|
||||
maybe `ls /usr/local/share/man/man1`?
|
||||
|
||||
|
|
@ -0,0 +1,20 @@
|
|||
%rec: gemlog
|
||||
%doc: a gemlog entry
|
||||
%key: id
|
||||
%type: id int
|
||||
%auto: id created updated
|
||||
%sort: id
|
||||
%type: created,updated date
|
||||
%type: title,tags line
|
||||
%type: flags enum draft published unlisted
|
||||
%unique: title
|
||||
%mandatory: id title created updated body
|
||||
%allowed: id title created updated tags flags body
|
||||
|
||||
id: 1
|
||||
title: First Impressions of Gemini
|
||||
updated: 2024-08-10T18:18:40-06:00
|
||||
created: 2020-06-14T00:00:00-06:00
|
||||
tags: gemini
|
||||
flags: published
|
||||
body: Boy oh boy, it's hecking cool! I can't believe it.
|
|
@ -0,0 +1,376 @@
|
|||
#!/bin/zsh
|
||||
# GEMREC!
|
||||
# It's a gemlog powered by recutils
|
||||
# author: dozens <dozens@tilde.team>
|
||||
# created: 2024-08-10
|
||||
# updated: 2024-08-10
|
||||
# version: Albatross.0
|
||||
|
||||
#############
|
||||
## GLOBALS ##
|
||||
#############
|
||||
|
||||
url="gemini://tilde.town/~dozens/gemlog" # where is your gemlog deployed
|
||||
author="dozens <dozens@tilde.team>" # used basically just for metadata
|
||||
db="db/db.rec" # the database file
|
||||
outdir="dist" # build directory
|
||||
feed="atom.xml" # name of your gemlog feed
|
||||
remote="tilde:public_gemini" # where to upload your gemlog?
|
||||
|
||||
###############
|
||||
## TEMPLATES ##
|
||||
###############
|
||||
# Templates are near the top of the file
|
||||
# instead of near where they are used
|
||||
# so you don't have to go searching so hard
|
||||
# if/when you want to change them :)
|
||||
|
||||
### Header of the gemlog index page
|
||||
TMPL_INDEXHEADER=$(
|
||||
cat<<EOF
|
||||
# Dozens Gemlog 💎
|
||||
|
||||
One of my goals here is to make new friends and interact with people on gemini. For this reason, I also keep a gem log here to record my thoughts and to reply to other geminauts.
|
||||
EOF
|
||||
)
|
||||
|
||||
### A list item on the gemlog index page
|
||||
TMPL_INDEXITEM()(
|
||||
updated=$1
|
||||
cat<<EOF
|
||||
=> {{id}}.gmi $updated - {{title}}
|
||||
EOF
|
||||
)
|
||||
|
||||
### the gemlog index page footer
|
||||
TMPL_INDEXFOOTER=$(
|
||||
cat<<EOF
|
||||
|
||||
---
|
||||
|
||||
=> atom.xml Atom Feed
|
||||
=> gemini://tilde.town/~dozens/ Home
|
||||
EOF
|
||||
)
|
||||
|
||||
### A metadata block that goes on each gemlog page
|
||||
TMPL_METADATA()(
|
||||
cat<<EOF
|
||||
|
||||
\`\`\`metadata
|
||||
title: {{title}}
|
||||
author: $author
|
||||
url: $url/{{id}}.gmi
|
||||
created: {{created}}
|
||||
updated: {{updated}}
|
||||
tags: {{tags}}
|
||||
\`\`\`
|
||||
EOF
|
||||
)
|
||||
|
||||
### A feed item
|
||||
TMPL_FEEDITEM(){
|
||||
Timestamp=$1
|
||||
cat<<EOF
|
||||
<entry>
|
||||
<id>$url/{{id}}.gmi</id>
|
||||
<title>{{title}}</title>
|
||||
<updated>$Timestamp</updated>
|
||||
<link href='$url/{{id}}.gmi' />
|
||||
<content type="text/plain">
|
||||
<![CDATA[
|
||||
{{body}}
|
||||
]]>
|
||||
</content>
|
||||
</entry>
|
||||
EOF
|
||||
}
|
||||
|
||||
### Header for the feed
|
||||
TMPL_FEEDHEADER=$(
|
||||
# feed updated always equals the updated field
|
||||
# of the most recently updated log page
|
||||
UPDATED=$(recsel $db -P updated -C | sort | tail -n 1)
|
||||
cat<<EOF
|
||||
<?xml version='1.0' encoding='UTF-8'?>
|
||||
<feed xmlns="http://www.w3.org/2005/Atom">
|
||||
<id>$url</id>
|
||||
<title>dozens gemlog</title>
|
||||
<updated>$UPDATED</updated>
|
||||
<author>
|
||||
<name>dozens</name>
|
||||
<email>dozens@tilde.team</email>
|
||||
</author>
|
||||
<link href="$url/$feed" rel="self"/>
|
||||
EOF
|
||||
)
|
||||
|
||||
################
|
||||
## BUILD FUNS ##
|
||||
################
|
||||
|
||||
### Build gemlogs
|
||||
Build_gemlogs()(
|
||||
Do_build()(
|
||||
echo "Building $id.."
|
||||
exec > $outdir/$id.gmi
|
||||
echo "#" $(recsel $db -e id=$id -P title) "\n"
|
||||
recsel $db -e id=$id -P body
|
||||
echo "\n:wq\n"
|
||||
echo "Thoughts? Comments? Let me know at dozens@tilde.team"
|
||||
echo "\nTags:"
|
||||
recsel $db -P tags -e id=$id \
|
||||
| awk '{while(i++<NF){print "=> tags/" $i ".gmi " $i}}'
|
||||
echo "=> tags/index.gmi All tags"
|
||||
recsel $db -e id=$id | recfmt "$(TMPL_METADATA)"
|
||||
)
|
||||
for id in $(recsel $db -e 'flags="published"' -P id)
|
||||
do
|
||||
if [ ! -f $outdir/$id.gmi ]
|
||||
then
|
||||
touch $outdir/$id.gmi && Do_build
|
||||
else
|
||||
file_updated=$(stat -f "%m" $outdir/$id.gmi)
|
||||
rec_updated=$(recsel $db -P updated -e id=$id)
|
||||
rec_epoch=$(gdate -d"$rec_updated" +'%s')
|
||||
if [ $file_updated -lt $rec_epoch ]
|
||||
then
|
||||
Do_build
|
||||
else
|
||||
echo "Skipping $id"
|
||||
fi
|
||||
fi
|
||||
done
|
||||
)
|
||||
|
||||
### build gemlog index
|
||||
Build_gemindex()(
|
||||
exec > $outdir/index.gmi
|
||||
printf "%s\n\n" $TMPL_INDEXHEADER
|
||||
for id in $(recsel $db -e 'flags="published"' -P id | sort -nr)
|
||||
do
|
||||
_date=$(gdate -d"$(recsel $db -e id=$id -P updated)" +'%Y-%m-%d')
|
||||
recsel $db -e id=$id | recfmt "$(TMPL_INDEXITEM $_date)"
|
||||
echo
|
||||
done
|
||||
echo $TMPL_INDEXFOOTER
|
||||
)
|
||||
|
||||
### Build feed
|
||||
Build_feed()(
|
||||
exec > $outdir/$feed
|
||||
echo $TMPL_FEEDHEADER
|
||||
ids=$(recsel db/db.rec -e 'flags="published"' -P id -C)
|
||||
for id in $ids
|
||||
do
|
||||
dateorig=$(recsel $db -e id=$id -P updated)
|
||||
datenew=$(gdate -Iseconds -d"$dateorig")
|
||||
recsel $db -e id=$id | recfmt "$(TMPL_FEEDITEM $datenew)"
|
||||
done
|
||||
echo "</feed>"
|
||||
)
|
||||
|
||||
### Build tag index
|
||||
Build_tagindex()(
|
||||
if [ ! -d $outdir/tags ]
|
||||
then
|
||||
mkdir -r $outdir/tags
|
||||
fi
|
||||
exec > $outdir/tags/index.gmi
|
||||
echo "# Tags"
|
||||
recsel $db -p id,title,tags | recfmt "{{id}} {{tags}}
|
||||
" | awk '
|
||||
{
|
||||
for(i=2;i<=NF;i++){
|
||||
tags[$i]=tags[$i] " " $1;
|
||||
}
|
||||
}
|
||||
END {
|
||||
for (t in tags) {
|
||||
print t tags[t]
|
||||
}
|
||||
}'| sort | awk -v url="$url" -v db="$db" '
|
||||
{
|
||||
printf "\n## %s\n",$1
|
||||
for(i=2;i<=NF;i++){
|
||||
cmd="recsel " db " -P title -e id=" $i
|
||||
cmd | getline title
|
||||
close(cmd)
|
||||
printf "=> %s/%s.gmi %s\n",
|
||||
url,$i,title
|
||||
}
|
||||
print ""
|
||||
}'
|
||||
)
|
||||
|
||||
### build tag pages
|
||||
Build_tagpages()(
|
||||
# be warned this is terribly hacky
|
||||
recsel $db -p id,title,tags \
|
||||
| recfmt '{{tags}}@@{{id}}@{{title}}
|
||||
' | awk -v outdir="$outdir" '{
|
||||
split($0,a,"@@")
|
||||
taglist=a[1]
|
||||
id_and_title=a[2]
|
||||
split(id_and_title,b,"@")
|
||||
id=b[1]
|
||||
title=b[2]
|
||||
split(taglist,tags," ")
|
||||
for (t in tags) {
|
||||
tagdict[tags[t]] = (length(tagdict[tags[t]])==0) ? tagdict[tags[t]]=id_and_title : tagdict[tags[t]] "@@" id_and_title
|
||||
}
|
||||
}
|
||||
END {
|
||||
for (t in tagdict) {
|
||||
cmd="echo \"# " t "\\n\" > " outdir "/tags/" t ".gmi"
|
||||
system(cmd)
|
||||
split(tagdict[t],parts,"@@")
|
||||
for (part in parts) {
|
||||
split(parts[part],a,"@")
|
||||
id=a[1];title=a[2]
|
||||
link="echo \"=> ../" id ".gmi " title "\" >> " outdir "/tags/" t ".gmi"
|
||||
system(link)
|
||||
}
|
||||
link="echo \"\n=> index.gmi All tags\" >> " outdir "/tags/" t ".gmi"
|
||||
system(link)
|
||||
}
|
||||
}
|
||||
'
|
||||
)
|
||||
|
||||
##################
|
||||
## EDITING FUNS ##
|
||||
##################
|
||||
|
||||
### create new gemlog
|
||||
Edit_newlog()(
|
||||
read -p "Title?> " Title
|
||||
tmp=$(mktemp)
|
||||
$EDITOR "$tmp"
|
||||
Body=$(< "$tmp")
|
||||
rm $tmp
|
||||
read -p "[p]ublish or [d]raft?> " Flags
|
||||
read -p "tags?> " Tags
|
||||
case "$Flags" in
|
||||
"d") Flags="draft";;
|
||||
"p") Flags="published";;
|
||||
*) echo "Unknown type!"; exit 1;;
|
||||
esac
|
||||
recins --verbose db/db.rec -t gemlog \
|
||||
-f title -v "$Title" \
|
||||
-f flags -v "$Flags" \
|
||||
-f tags -v "$Tags" \
|
||||
-f body -v "$Body"
|
||||
created="recsel db/db.rec -e 'title=\"$Title\"' -P id"
|
||||
echo "Created $(eval $created)"
|
||||
)
|
||||
|
||||
### update existing gemlog
|
||||
Edit_updatelog()(
|
||||
recsel $db -p id,flags,title | recfmt "{{id}}. [{{flags}}] {{title}}
|
||||
"
|
||||
printf "Enter a number to edit: "
|
||||
read myid
|
||||
grep -w -q $myid <(recsel $db -P id -C)
|
||||
if [ ! "$?" = 0 ]
|
||||
then
|
||||
echo "\nERROR: id does not exist, try again\n"
|
||||
Edit_updatelog
|
||||
else
|
||||
tmpmeta=$(mktemp)
|
||||
tmpbody=$(mktemp)
|
||||
recsel $db -e id=$myid -p title,tags,flags > $tmpmeta
|
||||
recsel $db -e id=$myid -P body > $tmpbody
|
||||
$EDITOR "$tmpmeta"
|
||||
$EDITOR "$tmpbody"
|
||||
Meta=$(< "$tmpmeta")
|
||||
Body=$(< "$tmpbody")
|
||||
recset --verbose $db -e id=$myid -f body -s $Body
|
||||
awk -v db="$db" -v id="$myid" '
|
||||
BEGIN {FS=": "}
|
||||
{
|
||||
for(i=2;i<=NF;i++){
|
||||
if(length(rec[$1]) == 0){
|
||||
rec[$1] = $i
|
||||
} else {
|
||||
rec[$1] = " " $i
|
||||
}
|
||||
}
|
||||
}
|
||||
END {
|
||||
for(r in rec){
|
||||
cmd = "recset " db " -e id=" id " -f " r " -s \"" rec[r] "\""
|
||||
print time
|
||||
system(cmd)
|
||||
}
|
||||
"gdate -Iseconds" | getline time
|
||||
cmd = "recset " db " -e id=" id " -f updated -s \"" time "\""
|
||||
system(cmd)
|
||||
}
|
||||
' $tmpmeta
|
||||
rm $tmpmeta
|
||||
rm $tmpbody
|
||||
fi
|
||||
)
|
||||
|
||||
###########
|
||||
## TASKS ##
|
||||
###########
|
||||
|
||||
### copy static assets to out dir
|
||||
Task_copyassets()(
|
||||
rsync -vurp static/* $outdir
|
||||
)
|
||||
### upload log to remote server
|
||||
Task_upload()(
|
||||
rsync -azP --exclude=.git dist/* $remote
|
||||
)
|
||||
|
||||
##########
|
||||
## MAIN ##
|
||||
##########
|
||||
|
||||
### Show help
|
||||
Show_help()(
|
||||
echo "Usage: gemrec <options>"
|
||||
echo "Options:"
|
||||
echo " b|build: [f|feed t|tags g|gem|gemlog] defaults to all"
|
||||
echo " n|new: create a new post"
|
||||
echo " u|update: update an existing post"
|
||||
echo " s|static: copy static files to output"
|
||||
echo " u|up|upload: upload to remote server"
|
||||
)
|
||||
|
||||
case "$1" in
|
||||
"b"|"build")
|
||||
case "$2" in
|
||||
"f"|"feed")
|
||||
echo "Build feed"
|
||||
Build_feed
|
||||
;;
|
||||
"t"|"tags"|"tag")
|
||||
echo "Build tags"
|
||||
Build_tagindex
|
||||
Build_tagpages
|
||||
;;
|
||||
"g"|"gem"|"gemlog")
|
||||
echo "Build gemlog"
|
||||
Build_gemindex
|
||||
Build_gemlogs
|
||||
;;
|
||||
*)
|
||||
echo "Build all"
|
||||
Build_feed
|
||||
Build_tagindex
|
||||
Build_tagpages
|
||||
Build_gemindex
|
||||
Build_gemlogs
|
||||
;;
|
||||
esac
|
||||
;;
|
||||
"n"|"new") Edit_newlog;;
|
||||
"e"|"edit") Edit_updatelog;;
|
||||
"s"|"static") Task_copyassets;;
|
||||
"u"|"up"|"upload") Task_upload;;
|
||||
*) Show_help;;
|
||||
esac
|
|
@ -0,0 +1,83 @@
|
|||
.\" 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>
|
|
@ -0,0 +1,69 @@
|
|||
GEMREC(1)
|
||||
|
||||
# NAME
|
||||
|
||||
gemrec - a gemlog powered by recutils
|
||||
|
||||
# SYNOPSIS
|
||||
|
||||
gemrec [options]
|
||||
|
||||
# DESCRIPTION
|
||||
|
||||
gemrec
|
||||
is a wrapper for GNU recutils
|
||||
that turns a recfile database full of posts
|
||||
into a gemlog.
|
||||
|
||||
Features include:
|
||||
|
||||
- All posts and metadata centrally located
|
||||
in a single rec database
|
||||
- Gemlog posts, each with a metadata block and tags
|
||||
- A gemsub compatible index of posts
|
||||
- A page for each tag,
|
||||
linking back to each tagged page,
|
||||
and an index of tags
|
||||
- An atom feed
|
||||
|
||||
# OPTIONS
|
||||
|
||||
## gemrec build|b
|
||||
Buid all: feed, gemlog (and index), and tags (and index)
|
||||
|
||||
## gemrec b|build f|feed
|
||||
Build feed
|
||||
|
||||
## gemrec b|build g|gemlog
|
||||
Build gemlog pages that are older than the record's _updated_ value. And the index.
|
||||
|
||||
## gemrec b|build t|tag|tags
|
||||
Build tag pages, and the index.
|
||||
|
||||
## 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.
|
||||
|
||||
## gemrec n|new
|
||||
Create a new post
|
||||
|
||||
## gemrec s|static
|
||||
Copy static files
|
||||
(images, static pages, etc)
|
||||
from _/static_
|
||||
to the build dir.
|
||||
|
||||
## gemrec u|up|upload
|
||||
Upload to a remote server.
|
||||
|
||||
# SEE ALSO
|
||||
|
||||
_gemrec(5)_ _recsel_(1) _recset_(1)
|
||||
|
||||
# AUTHORS
|
||||
|
||||
dozens <dozens@tilde.team>
|
Binary file not shown.
After Width: | Height: | Size: 57 KiB |
Loading…
Reference in New Issue