remwharead/remwharead.1.adoc

136 lines
3.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-19 04:56:35 +02:00
:Date: 2019-05-19
2019-05-11 02:52:33 +02:00
:Revision: 0.0.0
:man source: remwharead
:man manual: General Commands Manual
== NAME
2019-05-16 13:18:16 +02:00
remwharead - Saves URIs of things you want to remember in a database
2019-05-11 02:52:33 +02:00
== SYNOPSIS
2019-05-16 08:36:35 +02:00
*remwharead* [*-t* _tags_] _URI_
2019-05-19 13:03:53 +02:00
*remwharead* *-e* _format_ [*-f* _file_] [*-S* _start_,_end_] [[*-s*|*--search-all*] _expression_]
2019-05-11 02:52:33 +02:00
== DESCRIPTION
2019-05-16 13:18:16 +02:00
*remwharead* saves URIs of things you want to remember in a database along with
an URI 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_::
2019-05-16 08:36:35 +02:00
Add tags to _URI_, delimited by commas.
2019-05-13 02:17:25 +02:00
*-e* _format_, *--export* _format_::
2019-05-16 03:56:17 +02:00
Export to _format_. Possible values are _csv_ and _asciidoc_. See _FORMATS_.
2019-05-13 02:17:25 +02:00
*-f* _file_, *--file* _file_::
Save output to _file_. Default is stdout.
*-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_
2019-05-16 07:54:56 +02:00
are date and time representations according to ISO 8601
(YYYY-MM-DDThh:mm:ss). Time zones are ignored.
Example: `--span 2019-01-01,2019-02-10T12:30`.
*-s* _expression_, *--search-tags* _expression_::
Search in tags. Format: _tag1 AND tag2 OR tag3_. See _SEARCH EXPRESSIONS_.
*--search-all* _expression_::
2019-05-19 11:53:18 +02:00
Search in tags, title, description and full text.
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-19 04:56:35 +02:00
.Save a thing into the database, with tags.
====
2019-05-13 02:17:25 +02:00
`remwharead -t tag1,tag2 https://example.com/article.html`
2019-05-19 04:56:35 +02:00
====
2019-05-19 04:56:35 +02:00
.Export all things between and including 2019-04-01 and 2019-05-31 to a file.
====
`remwharead -e asciidoc -f out.adoc -S 2019-04-01,2019-05-31`
====
2019-05-19 04:56:35 +02:00
.Export all things to an HTML file.
====
2019-05-13 02:17:25 +02:00
`remwharead -e asciidoc | asciidoctor --backend=html5 --out-file=out.html -`
2019-05-19 04:56:35 +02:00
====
.Export all things about GRUB the boot-loader, but nothing about caterpillars.
====
2019-05-19 09:52:39 +02:00
`remwharead -e csv -s "grub AND boot"`
====
2019-05-16 03:56:17 +02:00
== FORMATS
2019-05-19 13:46:47 +02:00
=== csv
2019-05-16 03:56:17 +02:00
CSV is short for comma separated values. All fields are quoted and delimited by
commas. Line breaks in the full text are converted to "\n". Our CSV
implementation follows RFC 4180 and the full MIME media type is
`text/csv;charset=utf-8;header=present`.
2019-05-19 13:46:47 +02:00
=== asciidoc
2019-05-16 08:37:50 +02:00
AsciiDoc is a markup language that can be read as plain text or converted to
HTML, PDF and many other formats.
== SEARCH EXPRESSIONS
A search expression is either a single term, or several terms separated by _AND_
or _OR_. _AND_ takes precedence. The expression _Mountain AND Big OR Vegetable_
2019-05-19 15:46:07 +02:00
finds all things that have either Mountain and Big, or Vegetable in them. You can
use _||_ instead of _OR_ and _&&_ instead of _AND_. Note that *--search-tags*
2019-05-19 15:46:07 +02:00
only matches whole tags, Pill does not match Pillow.
== PROTOCOL SUPPORT
Since remwharead is built on libcurl, it supports the same protocols. See
*curl*(1), section _DESCRIPTION_. Titles and descriptions are currently only extracted
when using HTTP(S).
== ENVIRONMENT
You can use proxy servers with the same environment variables as curl. See
*curl*(1), section _ENVIRONMENT_.
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
2019-05-18 13:51:58 +02:00
== ERROR CODES
[options="header",cols=">,<"]
|==================================================
| Code | Explanation
| 1 | Missing options / Argument not understood.
| 2 | Database connection failed.
| 3 | File could not be opened.
| 4 | Could not fetch URI.
|==================================================
== SEE ALSO
*curl*(1)
2019-05-11 02:52:33 +02:00
== REPORTING BUGS
Bugtracker: https://schlomp.space/tastytea/remwharead/issues
E-mail: tastytea@tastytea.de