gitea2rss/README.adoc

92 lines
2.2 KiB
Plaintext
Raw Normal View History

2019-04-17 00:17:26 +02:00
= gitea2rss
2019-04-20 07:43:23 +02:00
*gitea2rss* Generates RSS feeds from https://gitea.io[Gitea] releases or tags.
2019-04-17 04:36:16 +02:00
2019-04-17 18:52:51 +02:00
https://rss.schlomp.space/?repo=tastytea/gitea2rss[Subscribe to gitea2rss releases].
2019-04-17 05:07:56 +02:00
2019-04-17 04:36:16 +02:00
== Usage
See https://schlomp.space/tastytea/gitea2rss/src/branch/master/gitea2rss.1.adoc[manpage].
== Install
=== Gentoo
Add my https://schlomp.space/tastytea/overlay[repository] and install it from
there.
[source,shellsession]
----
eselect repository enable tastytea
echo "dev-util/gitea2rss ~amd64" >> /etc/portage/package.accept_keywords/gitea2rss
emaint sync -r tastytea
emerge -a dev-util/gitea2rss
----
=== 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-04-17 04:36:16 +02:00
* https://cmake.org/[cmake] (at least: 3.6)
* https://pkgconfig.freedesktop.org/wiki/[pkgconfig] (tested: 0.29)
* http://www.curlpp.org/[curlpp] (tested: 0.8)
* https://github.com/open-source-parsers/jsoncpp[jsoncpp] (tested: 1.8)
2019-04-17 07:27:05 +02:00
* Optional:
** Manpage: http://asciidoc.org/[asciidoc] (tested: 8.6)
2019-04-17 04:36:16 +02:00
===== Debian stretch
[source,shellsession]
----
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 libjsoncpp-dev asciidoc
apt-get install -t sid libcurlpp-dev
export CXX="g++-6"
----
2019-04-17 04:36:16 +02:00
==== Get sourcecode
===== Releases
Download the current release at
https://schlomp.space/tastytea/gitea2rss/releases[schlomp.space].
===== Development version
[source,shellsession]
----
git clone https://schlomp.space/tastytea/gitea2rss.git
----
==== Compile
[source,shellsession]
----
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.
2019-04-17 04:36:16 +02:00
You can run the tests with `ctest` inside the build directory. Install with
`make install`.
2019-04-17 04:36:16 +02:00
== 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.
----