Add improved "How to install" help page

app/flatpages/help.md

@@ -10,6 +10,7 @@ toc: False
 ## General Help
 
 * [Frequently Asked Questions](faq/)
+* [Installing content](installing/)
 * [Content Ratings and Flags](content_flags/)
 * [Non-free Licenses](non_free/)
 * [Why WTFPL is a terrible license](wtfpl/)

app/flatpages/help/faq.md

@@ -54,6 +54,10 @@ You should read
 [the official Minetest Modding Book](https://rubenwardy.com/minetest_modding_book/)
 for a guide to making mods and games using Minetest.
 
+### How do I install something from here?
+
+See [Installing content](/help/installing/).
+
 
 ## How do I get help?
 

app/flatpages/help/installing.md

@@ -0,0 +1,89 @@
+title: How to install mods, games, and texture packs
+description: A guide to installing mods, games, and texture packs in Minetest.
+
+## Installing from the main menu (recommended)
+
+### Install
+
+1. Open the mainmenu
+2. Go to the Content tab and click "Browse online content".
+   If you don't see this, then you need to update Minetest to v5.
+3. Search for the package you want to install, and click "Install". 
+4. When installing a mod, you may be shown a dialog about dependencies here.
+   Make sure the base game dropdown box is correct, and then click "Install".
+
+<div class="row mt-5">
+  <div class="col-md-6">
+    <figure>
+      <a href="/static/installing_content_tab.png">
+        <img class="w-100" src="/static/installing_content_tab.png" alt="Screenshot of the content tab in minetest">
+      </a>
+      <figcaption class="text-muted ps-1">
+        1. Click Browser Online Content in the content tab.
+      </figcaption>
+    </figure>
+  </div>
+  <div class="col-md-6">
+    <figure>
+      <a href="/static/installing_cdb_dialog.png">
+        <img class="w-100" src="/static/installing_cdb_dialog.png" alt="Screenshot of the content tab in minetest">
+      </a>
+      <figcaption class="text-muted ps-1">
+        2. Search for the package and click "Install".
+      </figcaption>
+    </figure>
+  </div>
+</div>
+
+Troubleshooting:
+
+* I can't find it in the ContentDB dialog (Browse online content)
+    * Make sure that you're on the latest version of Minetest.
+    * Are you using Android? Packages with content warnings are hidden by default on android,
+      you can show them by removing `android_default` from the `contentdb_flag_blacklist` setting.
+    * Does the webpage show "Non-free" warnings? Non-free content is hidden by default from all clients,
+      you can show them by removing `nonfree` from the `contentdb_flag_blacklist` setting.
+* It says "required dependencies could not be found"
+    * Make sure you're using the correct "Base Game". A lot of packages only work with certain games, you can look
+      at "Compatible Games" on the web page to see which.
+
+### Enable in Select Mods
+
+1. Mods: Enable the content using "Select Mods" when selecting a world.
+2. Games: choose a game when making a world.
+3. Texture packs: Content > Select pack > Click enable.   
+
+
+<div class="row mt-5">
+  <div class="col-md-6">
+    <figure>
+      <a href="/static/installing_select_mods.png">
+        <img class="w-100" src="/static/installing_select_mods.png" alt="Screenshot of Select Mods in Minetest">
+      </a>
+      <figcaption class="text-muted ps-1">
+        Enable mods using the Select Mods dialog.
+      </figcaption>
+    </figure>
+  </div>
+</div>
+
+## Installing using the command line
+
+### Git clone
+
+1. Install git
+2. Find the package on ContentDB and copy "source" link.
+3. Find the user data directory.
+   In 5.4.0 and above, you can click "Open user data directory" in the Credits tab.
+   Otherwise:
+     * Windows: whereever you extracted or installed Minetest to.
+     * Linux: usually `~/.minetest/`
+4. Open or create the folder for the type of content (`mods`, `games`, or `textures`)
+5. Git clone there
+6. For mods, make sure to install any required dependencies.
+
+### Enable
+
+* Mods: Edit world.mt in the world's folder to contain `load_file_MODNAME = true`
+* Games: Use `--game` or edit game_id in world.mt.
+* Texture packs: change the `texture_path` setting to the texture pack absolute path.

app/templates/packages/view.html

@@ -53,18 +53,8 @@
 			{% endif %}
 		</a>
 
-		{% if package.type == package.type.MOD %}
-			{% set installing_url = "https://wiki.minetest.net/Installing_Mods" %}
-		{% elif package.type == package.type.GAME %}
-			{% set installing_url = "https://wiki.minetest.net/Games#Installing_games" %}
-		{% elif package.type == package.type.TXP %}
-			{% set installing_url = "https://wiki.minetest.net/Installing_Texture_Packs" %}
-		{% else %}
-			{{ 0 / 0 }}
-		{% endif %}
-
 		<p class="text-center mt-1 mb-4">
-			<a href="{{ installing_url }}">
+			<a href="{{ url_for('flatpage', path='help/installing') }}">
 				<small>
 					<i class="fas fa-question-circle me-1"></i>
 					{{ _("How do I install this?") }}