gitea2rss/README.adoc

78 lines
1.8 KiB
Plaintext
Raw Permalink Normal View History

2019-04-17 00:17:26 +02:00
= gitea2rss
2021-04-21 11:13:20 +02:00
*gitea2rss* Generates RSS feeds from https://gitea.io[Gitea] releases, tags and
commits.
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
2019-08-09 23:07:45 +02:00
See https://schlomp.space/tastytea/gitea2rss/src/branch/master/man/gitea2rss.1.adoc[manpage].
For an example nginx configuration file, see https://schlomp.space/tastytea/gitea2rss/src/branch/master/doc/nginx-example.conf[nginx-example.conf].
2019-04-17 04:36:16 +02:00
== Install
2021-05-17 23:56:25 +02:00
[alt="Packaging status" link=https://repology.org/project/gitea2rss/versions]
image::https://repology.org/badge/vertical-allrepos/gitea2rss.svg[]
2019-04-17 04:36:16 +02:00
=== Gentoo
2019-08-09 22:38:28 +02:00
[source,shell]
2019-04-17 04:36:16 +02:00
----
eselect repository enable guru
echo 'www-misc/gitea2rss' >> /etc/portage/package.accept_keywords/gitea2rss
emaint sync -r guru
emerge -a www-misc/gitea2rss
2019-04-17 04:36:16 +02:00
----
=== From source
==== Dependencies
* Tested OS: Linux
2021-04-21 11:13:20 +02:00
* C++ compiler (tested: https://gcc.gnu.org/[gcc] 8/9/10,
2020-10-24 17:14:18 +02:00
https://llvm.org/[clang] 7)
2020-10-27 12:06:37 +01:00
* https://cmake.org/[cmake] (at least: 3.12)
2020-10-24 16:59:41 +02:00
* https://curl.haxx.se/libcurl/[libcurl] (at least: 7.56)
2019-04-17 04:36:16 +02:00
* 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
2019-08-09 22:38:28 +02:00
[source,shell]
----
2020-10-24 18:35:04 +02:00
apt install build-essential cmake libcurl4-openssl-dev libjsoncpp-dev asciidoc
----
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
2019-08-09 22:38:28 +02:00
[source,shell]
2019-04-17 04:36:16 +02:00
----
git clone https://schlomp.space/tastytea/gitea2rss.git
----
==== Compile
2019-08-09 22:38:28 +02:00
[source,shell]
2019-04-17 04:36:16 +02:00
----
2020-10-24 18:35:04 +02:00
mkdir build && cd build
2019-04-17 04:36:16 +02:00
cmake ..
cmake --build .
----
.cmake options:
* `-DCMAKE_BUILD_TYPE=Debug` for a debug build.
* `-DWITH_MAN=NO` to not compile the manpage.
2021-05-20 01:11:29 +02:00
* `-DWITH_TESTS=YES` to compile the tests.
2019-04-17 04:36:16 +02:00
2020-10-24 18:35:04 +02:00
You can run the tests with `ctest` inside `build/tests`. Install with `make
install`.