remwharead/README.adoc

104 lines
3.0 KiB
Plaintext
Raw Normal View History

2019-05-11 02:52:33 +02:00
= remwharead
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
2019-05-18 05:09:56 +02:00
.AsciiDoc export formatted with Asciidoctor.
2019-05-18 03:28:40 +02:00
====
image::https://doc.schlomp.space/remwharead/example_dates.png[Dates view, width=400, link="https://doc.schlomp.space/remwharead/example_dates.png", role=left]
image::https://doc.schlomp.space/remwharead/example_tags.png[Tags view, width=400, link="https://doc.schlomp.space/remwharead/example_tags.png"]
====
2019-05-11 02:52:33 +02:00
== Usage
2019-05-13 02:43:27 +02:00
See https://schlomp.space/tastytea/remwharead/src/branch/main/remwharead.1.adoc[manpage].
2019-05-11 02:52:33 +02:00
== Install
=== Gentoo
Add my https://schlomp.space/tastytea/overlay[repository] and install it from
there.
2019-05-13 03:44:47 +02:00
[source,zsh]
2019-05-11 02:52:33 +02:00
----
eselect repository enable tastytea
echo "www-misc/remwharead ~amd64" >> /etc/portage/package.accept_keywords/remwharead
emaint sync -r tastytea
emerge -a www-misc/remwharead
----
=== From source
==== Dependencies
* Tested OS: Linux
* C++ compiler (tested: https://gcc.gnu.org/[gcc] 5/6/7/8,
https://llvm.org/[clang] 3/5/6)
2019-05-12 21:39:01 +02:00
* https://cmake.org/[cmake] (at least: 3.2)
2019-05-11 02:52:33 +02:00
* https://pkgconfig.freedesktop.org/wiki/[pkgconfig] (tested: 0.29)
2019-05-17 01:00:41 +02:00
* https://github.com/badaix/popl[popl] (tested: 1.2)
2019-05-12 21:39:01 +02:00
* http://repo.or.cz/w/libxdg-basedir.git[libxdg-basedir] (tested: 1.2)
* http://vsqlite.virtuosic-bytes.com/[vsqlite++] (tested: 0.3)
2019-05-11 02:52:33 +02:00
* Optional:
** Manpage: http://asciidoc.org/[asciidoc] (tested: 8.6)
2019-05-16 13:18:16 +02:00
** Tests: https://github.com/catchorg/Catch2[catch] (tested: 2.5 / 1.2)
2019-05-11 02:52:33 +02:00
2019-05-17 00:22:16 +02:00
.Install dependencies in Debian stretch.
2019-05-17 00:39:09 +02:00
====
2019-05-17 00:22:16 +02:00
[source,zsh]
----
echo "APT::Default-Release \"stretch\";" >> /etc/apt/apt.conf.d/00default_release
echo "deb http://deb.debian.org/debian sid main" >> /etc/apt/sources.list.d/sid.list
apt-get update
apt-get install g++-6 cmake pkg-config libcurl4-openssl-dev libxdg-basedir-dev \
libvsqlitepp-dev libboost-system-dev libboost-filesystem-dev asciidoc
apt-get install -t sid libcurlpp-dev
2019-05-17 04:29:55 +02:00
# Inside the source directory:
2019-05-17 00:22:16 +02:00
wget -O src/popl.hpp https://raw.githubusercontent.com/badaix/popl/v1.2.0/include/popl.hpp
2019-05-17 04:29:55 +02:00
export CXX="g++-6"
2019-05-17 00:22:16 +02:00
----
2019-05-17 00:39:09 +02:00
====
2019-05-17 00:22:16 +02:00
2019-05-11 02:52:33 +02:00
==== Get sourcecode
===== Releases
Download the current release at
https://schlomp.space/tastytea/remwharead/releases[schlomp.space].
===== Development version
2019-05-13 03:44:47 +02:00
[source,zsh]
2019-05-11 02:52:33 +02:00
----
git clone https://schlomp.space/tastytea/remwharead.git
----
==== Compile
2019-05-13 03:44:47 +02:00
[source,zsh]
2019-05-11 02:52:33 +02:00
----
mkdir build
cd build/
cmake ..
cmake --build .
----
.cmake options:
* `-DCMAKE_BUILD_TYPE=Debug` for a debug build.
* `-DWITH_MAN=NO` to not compile the manpage.
* `WITH_TESTS=YES` to compile the tests.
You can run the tests with `ctest` inside the build directory. Install with
`make install`.
== Copyright
----
Copyright © 2019 tastytea <tastytea@tastytea.de>.
License GPLv3: GNU GPL version 3 <https://www.gnu.org/licenses/gpl-3.0.html>.
This program comes with ABSOLUTELY NO WARRANTY. This is free software,
and you are welcome to redistribute it under certain conditions.
----