Re: [PR PATCH] [Updated] [WIP] New package: void-docs-2020.04.18.

[ericonr <ericonr@users.noreply.github.com>]

[-- Attachment #1: Type: text/plain, Size: 1028 bytes --]

There is an updated pull request by ericonr against master on the void-packages repository

https://github.com/ericonr/void-packages void-docs
https://github.com/void-linux/void-packages/pull/21453

[WIP] New package: void-docs-2020.04.18.
So, instead of having versions of void-docs tagged and used here, I thought it'd be better to just select a commit and roll with it. This is totally subject to change, though.

This package stores the docs inside `/usr/share/void-docs/`, for now. It'd be useful for inclusion inside the live images that void ships. In the case this is accepted, it would make sense to include a terminal markdown formatter as well (either mdcat or glow). I also think it would be interesting to inform the user that these pages exist, perhaps as a warning on the motd? I don't know how I'd go about including it.

This is WIP for now, but intends to close https://github.com/void-linux/void-docs/issues/214 !

A patch file from https://github.com/void-linux/void-packages/pull/21453.patch is attached

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: github-pr-void-docs-21453.patch --]
[-- Type: text/x-diff, Size: 1604 bytes --]

From 1311e73e2f3c6289073cfa21e77102cd8a26cfd8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=89rico=20Rolim?= <erico.erc@gmail.com>
Date: Wed, 29 Apr 2020 02:17:02 -0300
Subject: [PATCH] New package: void-docs-2020.04.18.

---
 srcpkgs/void-docs/template | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 srcpkgs/void-docs/template

diff --git a/srcpkgs/void-docs/template b/srcpkgs/void-docs/template
new file mode 100644
index 00000000000..84fa6bbf0e3
--- /dev/null
+++ b/srcpkgs/void-docs/template
@@ -0,0 +1,38 @@
+# Template file for 'void-docs'
+pkgname=void-docs
+version=0.0.0.20200418
+revision=1
+_commit=029fd1683100ae36c87e29227af8de4cadd1095b
+wrksrc="${pkgname}-${_commit}"
+build_style=meta
+hostmakedepends="mdBook fd pandoc"
+short_desc="Documentation for Void Linux"
+maintainer="Érico Nogueira <ericonr@disroot.com>"
+license="CC-BY-SA-4.0"
+homepage="https://docs.voidlinux.org/"
+distfiles="https://github.com/void-linux/void-docs/archive/${_commit}.tar.gz"
+checksum=845e56b88bfa4a27ff42705051b319a92c96b02113122237ede58282f12648e8
+
+do_build() {
+	mdbook build
+
+	mkdir -p mandoc
+	fd -t d "" src/ -x mkdir -p "mandoc/{}"
+	fd "\.md" src/ -x pandoc \
+		-V "title={/.}" -V "section=5" -V "header='Void Docs'" -s \
+		-o "mandoc/{.}.7" "{}"
+}
+
+do_install() {
+	_dest_dir=usr/share/void-docs
+
+	# compiled book
+	vmkdir $_dest_dir/html
+	vcopy book/* $_dest_dir/html
+	# markdown source
+	vmkdir $_dest_dir/markdown
+	vcopy src/* $_dest_dir/markdown
+	# mandoc
+	vmkdir $_dest_dir/mandoc
+	vcopy mandoc/src/* $_dest_dir/mandoc
+}