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.

5 Likes

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
6 Likes

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…
2 Likes

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.