rename again to ics2tsv, more conventional naming for a converter - ics2txt - convert icalendar .ics file to plain text HTML git clone git://bitreich.org/ics2txt git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/ics2txt DIR Log DIR Files DIR Refs DIR Tags DIR README --- DIR commit 8efe5091a1a26fb47aea4f1582bcc7ffbfc736ea DIR parent 6cf4653e13a04cb1e05d69d94a616e0f76b1236e HTML Author: Josuah Demangeon <me@josuah.net> Date: Thu, 5 Mar 2020 01:28:46 +0100 rename again to ics2tsv, more conventional naming for a converter Diffstat: M Makefile | 4 ++-- M README | 8 ++++---- R tical-ics-tsv -> ics2tsv | 0 A ics2tsv.1 | 103 +++++++++++++++++++++++++++++++ A tcal.5 | 57 +++++++++++++++++++++++++++++++ R tical-txt-tsv -> tcal2tsv | 0 D tical.1 | 104 ------------------------------- R tical-tsv-ics -> tsv2ics | 0 R tical-tsv-txt -> tsv2tcal | 0 9 files changed, 166 insertions(+), 110 deletions(-) --- DIR diff --git a/Makefile b/Makefile @@ -1,6 +1,6 @@ PREFIX = /usr/local -BIN = tical-* -MAN1 = tical.1 +BIN = ics2tsv tsv2tcal tcal2tsv tsv2ics ics2txt +MAN1 = ics2tsv.1 all: DIR diff --git a/README b/README @@ -4,10 +4,10 @@ NAME tical – convert ics file to simpler tsv or txt formats SYNOPSIS - tical-tsv <file.ics >file.tsv - tical-ics <file.tsv >file.ics - tical-txt <file.tsv >file.txt - tical-back <file.txt >file.tsv + ics2tsv <file.ics >file.tsv + tsv2tcal <file.tsv >file.txt + tcal2tsv <file.txt >file.tsv + tsv2ics <file.tsv >file.ics DESCRIPTION tical is set of awk scripts to deal with iCal (.ics) format to publish, DIR diff --git a/tical-ics-tsv b/ics2tsv DIR diff --git a/ics2tsv.1 b/ics2tsv.1 @@ -0,0 +1,103 @@ +.Dd $Mdocdate: Mar 1 2020$ +.Dt ICS2TSV 1 +.Os +. +. +.Sh NAME +. +.Nm ics2tsv +.Nd convert ics file to simpler tsv or txt formats +. +. +.Sh SYNOPSIS +. +.Nm ics2tsv Ar <file.ics >file.tsv +.Nm tsv2tcal Ar <file.tsv >file.txt +.Nm tcal2tsv Ar <file.txt >file.tsv +.Nm tsv2ics Ar <file.tsv >file.ics +. +.Sh DESCRIPTION +. +.Nm +is set of awk scripts to deal with iCal +.Pq Pa .ics +format to publish, display and convert *.ics files, though a simple +central TSV format. +.Pp +They all read from either stdin or the file passed as argument, and +write to stdout. +. +.Pp +.The +.Pa file.tsv +files have one line per event, all with the following fields, +separated by one tab: +. +.Bl -offset 1n -width 1n -enum -compact +. +.It +Begining (epoch) +. +.It +End (epoch) +. +.It +Category +. +.It +Location +. +.It +Summary +. +.It +Description +. +.El +. +. +.Sh EXAMPLES +. +Convert a calendar from HTTP +.Pa .ics +to custom +.Pa .txt +sorted by beginning date: +.Dl curl "$url.ics" | ics2tsv | sort -n -k 1,1 | tsv2txt +. +.Pp +Convert a custom +.Pa .txt +format back to an +.Pa .ics +file and publish it: +.Dl tcal2tsv cal.txt | tsv2ics | ssh "www@$host" 'cat >/var/www/cal.ics' +. +.Pp +Split an +.ics +file according to the category, saved as +.Pa .tsv : +.Dl tcal2tsv cal.txt | awk -F '\et' '{ f = $3".tsv"; print >>f }' +. +. +.Sh SEE ALSO +. +.Xr cal 1 , +.Xr calendar 1 , +.Xr date 1 , +.Xr sort 1 +. +.Sh STANDARDS +. +.Rs +.%A Desruisseaux +.%D September 2009 +.%T Internet Calendaring and Scheduling Core Object Specification (iCalendar) +.%R RFC 5545 +.Re +. +. +.Sh AUTHORS +. +.An Josuah Demangeon Aq Mt me@josuah.net DIR diff --git a/tcal.5 b/tcal.5 @@ -0,0 +1,57 @@ +.Dd $Mdocdate: March 05 2020$ +.Dt TCAL 5 +.Os +. +. +.Sh NAME +. +.Nm tcal +.Nd plaintext calendar event notation format +. +. +.Sh SYNOPSIS +. +TZ+0300 +. +. +.Sh DESCRIPTION +. +The +.Nm +utility +. +. +. +.Sh FILES +. +. +. +.Sh EXAMPLES +. +. +. +.Sh SEE ALSO +. +.Xr foobar 1 +. +. +.Sh STANDARDS +. +. +. +.Sh HISTORY +. +. +. +.Sh AUTHORS +. +.An <author-name> +.Aq Mt <author-email> +. +. +.Sh CAVEATS +. +. +. +.Sh BUGS +. DIR diff --git a/tical-txt-tsv b/tcal2tsv DIR diff --git a/tical.1 b/tical.1 @@ -1,104 +0,0 @@ -.Dd $Mdocdate: Mar 1 2020$ -.Dt TICAL 1 -.Os -. -. -.Sh NAME -. -.Nm tical -.Nd convert ics file to simpler tsv or txt formats -. -. -.Sh SYNOPSIS -. -.Nm tical-tsv Ar <file.ics >file.tsv -.Nm tical-ics Ar <file.tsv >file.ics -.Nm tical-txt Ar <file.tsv >file.txt -.Nm tical-back Ar <file.txt >file.tsv -. -.Sh DESCRIPTION -. -.Nm -is set of awk scripts to deal with iCal -.Pq Pa .ics -format to publish, display and convert *.ics files, though a simple -central TSV format. -.Pp -They all read from either stdin or the file passed as argument, and -write to stdout. -. -.Pp -.The -.Pa file.tsv -files have one line per event, all with the following fields, -separated by one tab: -. -.Bl -offset 1n -width 1n -enum -compact -. -.It -Begining (epoch) -. -.It -End (epoch) -. -.It -Category -. -.It -Location -. -.It -Summary -. -.It -Description -. -.El -. -. -.Sh EXAMPLES -. -Convert a calendar from HTTP -.Pa .ics -to custom -.Pa .txt -sorted by beginning: -.Dl curl "$url.ics" | tical-tsv | sort -n -k 1,1 | tcal-txt -. -.Pp -Convert a custom -.Pa .txt -format back to an -.Pa .ics -file and publish it: -.Dl tical-back cal.txt | tcal-ics | ssh "www@$host" 'cat >/var/www/cal.ics' -. -.Pp -Split an -.ics -file according to the category, saved as -.Pa .tsv : -.Dl tical-tsv cal.txt | awk -F '\et' '{ f = $3".tsv"; print >>f }' -. -. -.Sh SEE ALSO -. -.Xr cal 1 , -.Xr calendar 1 , -.Xr date 1 , -.Xr sort 1 -. -. -.Sh STANDARDS -. -.Rs -.%A Desruisseaux -.%D September 2009 -.%T Internet Calendaring and Scheduling Core Object Specification (iCalendar) -.%R RFC 5545 -.Re -. -. -.Sh AUTHORS -. -.An Josuah Demangeon Aq Mt me@josuah.net DIR diff --git a/tical-tsv-ics b/tsv2ics DIR diff --git a/tical-tsv-txt b/tsv2tcal