Migrate man pages management to plugin

.gitignore

@@ -3,10 +3,11 @@ _software/*/docs
 _software/_*_repo
 _specs/*/
 !_specs/*.*
-parent-hub/*
+# parent-hub/*
 _site/
 .sass-cache/
 .jekyll-cache/
 .jekyll-metadata
 .DS_Store
-Gemfile.lock
+Gemfile.lock
+.man_pages_cache

Gemfile

@@ -7,6 +7,10 @@ group :jekyll_plugins do
   gem "jekyll-theme-rop"
 end
 
+# For man pages plugin
+gem "rubyzip", "~> 2.3"
+gem "octokit", "~> 6.0"
+
 # Windows does not include zoneinfo files, so bundle the tzinfo-data gem
 gem "tzinfo-data", platforms: [:mingw, :mswin, :x64_mingw, :jruby]
 

_config.yml

@@ -37,7 +37,7 @@ theme: jekyll-theme-rop
 
 parent_hub:
   git_repo_url: https://github.com/riboseinc/open.ribose.com
-  home_url: https://open.ribose.com/
+  home_url: https://www.ribose.com/
 
 includes_dir: '.'
 
@@ -118,6 +118,13 @@ url: https://www.rnpgp.org
 
 github_repo_url: https://github.com/rnpgp/rnpgp.org
 
+# RNP configuration for man pages plugin
+rnp:
+  version: "0.18.0"
+  man_pages:
+    enabled: true
+    cache_duration: 3600
+
 tag_namespaces:
   software:
     writtenin: "Written in"

_man_pages/index.md

@@ -0,0 +1,141 @@
+---
+title: RNP Man Pages
+excerpt: Manual pages for all RNP versions
+layout: docs-index
+---
+
+# RNP Manual Pages
+
+This page provides access to manual pages for all versions of RNP.
+
+## Available Versions
+
+### [RNP v0.18.0](v0.18.0/) 
+Released: 2025-06-19
+
+- [rnp.1](/docs/0.18.0/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.18.0/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.18.0/librnp.3/) - RNP library API
+
+### [RNP v0.17.1](v0.17.1/) 
+Released: 2024-05-14
+
+- [rnp.1](/docs/0.17.1/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.17.1/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.17.1/librnp.3/) - RNP library API
+
+### [RNP v0.17.0](v0.17.0/) 
+Released: 2023-05-02
+
+- [rnp.1](/docs/0.17.0/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.17.0/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.17.0/librnp.3/) - RNP library API
+
+### [RNP v0.16.3](v0.16.3/) 
+Released: 2023-04-13
+
+- [rnp.1](/docs/0.16.3/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.16.3/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.16.3/librnp.3/) - RNP library API
+
+### [RNP v0.16.2](v0.16.2/) 
+Released: 2022-09-22
+
+- [rnp.1](/docs/0.16.2/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.16.2/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.16.2/librnp.3/) - RNP library API
+
+### [RNP v0.16.1](v0.16.1/) 
+Released: 2022-09-12
+
+- [rnp.1](/docs/0.16.1/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.16.1/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.16.1/librnp.3/) - RNP library API
+
+### [RNP v0.16.0](v0.16.0/) 
+Released: 2022-01-27
+
+- [rnp.1](/docs/0.16.0/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.16.0/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.16.0/librnp.3/) - RNP library API
+
+### [RNP v0.15.2](v0.15.2/) 
+Released: 2021-08-06
+
+- [rnp.1](/docs/0.15.2/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.15.2/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.15.2/librnp.3/) - RNP library API
+
+### [RNP v0.15.1](v0.15.1/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.15.1/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.15.1/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.15.1/librnp.3/) - RNP library API
+
+### [RNP v0.15.0](v0.15.0/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.15.0/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.15.0/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.15.0/librnp.3/) - RNP library API
+
+### [RNP v0.14.0](v0.14.0/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.14.0/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.14.0/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.14.0/librnp.3/) - RNP library API
+
+### [RNP v0.13.1](v0.13.1/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.13.1/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.13.1/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.13.1/librnp.3/) - RNP library API
+
+### [RNP v0.13.0](v0.13.0/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.13.0/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.13.0/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.13.0/librnp.3/) - RNP library API
+
+### [RNP v0.12.0](v0.12.0/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.12.0/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.12.0/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.12.0/librnp.3/) - RNP library API
+
+### [RNP v0.11.0](v0.11.0/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.11.0/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.11.0/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.11.0/librnp.3/) - RNP library API
+
+### [RNP v0.10.0](v0.10.0/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.10.0/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.10.0/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.10.0/librnp.3/) - RNP library API
+
+### [RNP v0.9.2](v0.9.2/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.9.2/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.9.2/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.9.2/librnp.3/) - RNP library API
+
+### [RNP v0.9.1](v0.9.1/) 
+Released: 2021-06-02
+
+- [rnp.1](/docs/0.9.1/rnp.1/) - RNP command-line tool
+- [rnpkeys.1](/docs/0.9.1/rnpkeys.1/) - RNP key management tool
+- [librnp.3](/docs/0.9.1/librnp.3/) - RNP library API
+
+## Latest Version
+
+The latest stable version is [RNP v0.18.0](latest/), which is an alias for [v0.18.0](v0.18.0/).

_man_pages/latest

@@ -0,0 +1 @@
+v0.18.0

_man_pages/v0.15.0/librnp.3.adoc

@@ -0,0 +1,92 @@
+---
+title: librnp(3)
+excerpt: man page for librnp(3), version 0.15.0
+version: 0.15.0
+permalink: /docs/0.15.0/librnp.3/
+---
+:release-version: 0.15.0
+:man manual: RNP Manual
+:man source: RNP 0.15.0
+
+== NAME
+
+librnp - OpenPGP implementation, available via FFI interface.
+
+== SYNOPSIS
+
+*#include <rnp/rnp.h>* +
+*#include <rnp/rnp_err.h>*
+
+
+== DESCRIPTION
+
+*librnp* is part of the *RNP* suite and forms the basis for the _rnp(1)_ and _rnpkeys(1)_ command-line utilities.
+
+It provides an FFI interface to functions required for operations needed by the OpenPGP protocol.
+
+Interface to the library is exposed via _<rnp/rnp.h>_ and _<rnp/rnp_err.h>_ headers.
+You will also need to link to _librnp_.
+
+Please see its headers for the full function list and detailed documentation.
+
+== EXAMPLES
+
+A number of examples are provided in *src/examples* folder of the *RNP* suite source tree.
+
+*generate.c*::
+Demonstrates generation of an OpenPGP keypair using the JSON key description mechanism.
+May be used to generate any custom key types that are supported by the *RNP* suite.
+
+*encrypt.c*::
+Demonstrates how to build OpenPGP-encrypted messages.
+A message is encrypted with keys, generated via *./generate*, with a hardcoded password.
+
+*decrypt.c*::
+Demonstrates how to decrypt OpenPGP messages.
+Running this example requires the *./encrypt* example to be first run
+in order to produce the sample encrypted message for decryption.
+
+*sign.c*::
+Demonstrates how to sign OpenPGP messages.
+Running this example requires the *./generate* example to be first run
+in order to generate and write out secret keys.
+
+*verify.c*::
+Demonstrates verify OpenPGP signed messages.
+Again, running this example requires the *./sign* example to be first run
+in order to generate a signed OpenPGP message.
+
+== BUGS
+
+Please report _issues_ via the RNP public issue tracker at:
+https://github.com/rnpgp/rnp/issues.
+
+_Security reports_ or _security-sensitive feedback_ should be reported
+according to the instructions at:
+https://www.rnpgp.org/feedback.
+
+
+== AUTHORS
+
+*RNP* is an open source project led by Ribose and has
+received contributions from numerous individuals and
+organizations.
+
+
+== RESOURCES
+
+*Web site*: https://www.rnpgp.org
+
+*Source repository*: https://github.com/rnpgp/rnp
+
+
+== COPYING
+
+Copyright \(C) 2017-2021 Ribose.
+The RNP software suite is _freely licensed_:
+please refer to the *LICENSE* file for details.
+
+
+== SEE ALSO
+
+*rnp(1)*, *rnpkeys(1)*