remwharead/remwharead.1.adoc

70 lines
1.7 KiB
Plaintext
Raw Normal View History

2019-05-11 02:52:33 +02:00
= remwharead(1)
:doctype: manpage
:Author: tastytea
:Email: tastytea@tastytea.de
2019-05-16 00:26:48 +02:00
:Date: 2019-05-16
2019-05-11 02:52:33 +02:00
:Revision: 0.0.0
:man source: remwharead
:man manual: General Commands Manual
== NAME
remwharead - Remember what you read, and when
== SYNOPSIS
*remwharead* [*-t* _tags_] _URL_
2019-05-12 00:02:31 +02:00
*remwharead* *-e* _format_ [*-f* _file_] [*-s* _start_,_end_]
2019-05-11 02:52:33 +02:00
== DESCRIPTION
2019-05-14 20:45:48 +02:00
*remwharead* saves URLs of things you read in a database along with an URL to
the archived version, the current date and time, title, description, the full
text of the page and optional tags.
2019-05-11 02:52:33 +02:00
== OPTIONS
2019-05-13 02:17:25 +02:00
*-t* _tags_, *--tags* _tags_::
Add tags to _URL_, delimited by commas.
2019-05-13 02:17:25 +02:00
*-e* _format_, *--export* _format_::
Export to _format_. Possible values are _csv_ and _asciidoc_.
2019-05-13 02:17:25 +02:00
*-f* _file_, *--file* _file_::
Save output to _file_. Default is stdout.
2019-05-13 02:17:25 +02:00
*-s* _start_,_end_, *--span* _start_,_end_::
2019-05-16 00:26:48 +02:00
Only export entries between and including _start_ and _end_. _start_ and _end_
are date and time representations according to ISO 8601. Time zones are ignored
at the moment. Example: `--span 2019-01-01,2019-02-10T12:30`.
2019-05-14 22:56:58 +02:00
*-S* _attribute_, *--sort* _attribute_::
Sort by _time_, _tag_ or _both_ (default) when exporting to _asciidoc_.
2019-05-12 00:02:31 +02:00
*-h*, *--help*::
Show help message.
*-V*, *--version*::
2019-05-11 02:52:33 +02:00
Print version, copyright and license.
== EXAMPLES
2019-05-13 02:17:25 +02:00
`remwharead -t tag1,tag2 https://example.com/article.html`
2019-05-13 02:17:25 +02:00
`remwharead -e asciidoc -f out.adoc -s 2019-04-01,2019-05-31`
2019-05-13 02:17:25 +02:00
`remwharead -e asciidoc | asciidoctor --backend=html5 --out-file=out.html -`
2019-05-11 02:52:33 +02:00
== FILES
2019-05-14 22:56:58 +02:00
* *Database*: `${XDG_DATA_HOME}/remwharead/database.sqlite`
2019-05-11 02:52:33 +02:00
`${XDG_DATA_HOME}` is usually `~/.local/share`.
2019-05-11 02:52:33 +02:00
== REPORTING BUGS
Bugtracker: https://schlomp.space/tastytea/remwharead/issues
E-mail: tastytea@tastytea.de