Offline community guides + index

I was looking for a way to keep an offline version of the community guides. Building a .zim archive wasn’t great, so I ended up writing some scripts to download the posts’ content and recompile it in HTML. As a bonus, there is an index page that could be used here?

This is what you get:

I don’t know how to sort them, maybe it should be done manually. So right now:

  • the tags are sorted by “frequent” / “infrequent” / “versions”, then by alphabetical order
  • the topics are sorted by a compound number made by adding the number of posts to the number of likes.

Things to fix or add:

  • No post except the first one of the topic is added

The git repo is hosted on codeberg. And you can download the resulting offline HTML files as an archive : pages.tar.gz (about 4MB).

The index is very basic and a lot of guides don’t have tags. There are 2 options:

  1. I do it on my own side, ignoring the forum’s tags
  2. we do it on the forum, adding missing tags (before that, maybe finding a simple definition of some tags could be good?). But I don’t know if it will change the “last updated” date?

The following post contains an excerpt of the complete index.

Note: The following is just an excerpt of the full list.


Introduction

First, there is a limited number of High quality guides, referred in a subcategory.

Pinned topics

ID Link OP Creation Last edit Likes Posts
45 About the Community Guides category system 2020-07-10 - 0 2

High quality guides

ID Link OP Creation Last edit Likes Posts
9991 Installing Software in Qubes (all methods) deeplow 2022-03-06 2024-08-06 49 38
28117 Workaround to Attach Block and USB Devices to Win Qube(s) Under 4.2 tempmail 2024-08-07 - 11 61

Frequent tags

Tagged “administration”

ID Link OP Creation Last edit Likes Posts
20126 Qubes Salt Beginner’s Guide leo 2023-07-31 2024-11-01 106 60
16992 Fresh installation (shell) script: minimal templates, app qubes, default settings szz9pza 2023-02-23 2023-11-05 15 5
18870 Port forwarding to allow external connections (qvm-portfwd-iptables) taradiddles 2023-05-26 2023-08-14 1 3
18861 Ansible Qubes Rudd-O 2023-05-26 2023-08-14 1 1
18885 Qvm-ls-mermaid: the architecture of an entire Qubes OS system at a glance 3hhh 2023-05-26 2023-08-14 0 1
18873 Simple daemon to react to Qubes OS events (qube started etc.) with configurable commands 3hhh 2023-05-26 2023-08-14 0 1
18869 Tasket’s scripts that help with administration and usage of Qubes OS tasket 2023-05-26 2023-08-14 0 1

Okay, here is maybe the last update about this. I spent too much time on this thing. The code is bigger and uglier than ever :confused:

The v0.2.0 now contains:

  • a custom User-Agent HTTP header, just in case
  • a better way to call the API and thus, to update the HTTP cache
  • a revisions.html page for each topic, containing only the differences between each version, sometimes the reason provided with the edited version.
  • a list of each version for edited topics. I tried to reconstruct the markdown code from Discourse API. I’m not sure if it’s correct…

Mine is outdated, since now it just works out of the box after some dom0 update around v4.2.3, but thanks anyway for your hard work to collect this.