From f9ccea7a1e208b80bd7d6e3da62d9f6a9422a0d4 Mon Sep 17 00:00:00 2001
From: Pk11 <epicpkmn11@outlook.com>
Date: Wed, 2 Jun 2021 15:25:14 -0500
Subject: [PATCH] Move hiyaCFW content from dsi.cfw.guide (#18)

* Move hiyaCFW content from dsi.cfw.guide

* Change installing page titles

* Fix links to hiya pages

* Move antivirus notice to alert

* Use colons in headings

* Update troubleshooting.md

Also adjust page title <hr> a bit

* Use liquid comments and minor wording change

* Make sidebar index be separate from page list

* Remove step to uncheck install TWiLight box

* Rename from installing-hiyacfw to installing
---
 _data/en-US/categories.json                   |  9 ++-
 _data/en-US/nav.json                          |  4 +
 _layouts/wiki.html                            | 23 +++---
 assets/css/style.scss                         |  4 +
 pages/_en-US/community/index.md               |  3 +-
 pages/_en-US/gbarunner2/index.md              |  3 +-
 .../custom-splash-screens.md}                 | 14 ++--
 pages/_en-US/hiyacfw/forwarders.md            | 30 +++++++
 pages/_en-US/hiyacfw/index.md                 | 13 +++
 pages/_en-US/hiyacfw/installing.md            | 79 +++++++++++++++++++
 pages/_en-US/hiyacfw/troubleshooting.md       | 32 ++++++++
 pages/_en-US/nds-bootstrap/faq.md             |  1 -
 pages/_en-US/nds-bootstrap/index.md           |  3 +-
 pages/_en-US/nds-bootstrap/testing.md         |  1 -
 pages/_en-US/other/godmode9i.md               |  2 +-
 pages/_en-US/other/index.md                   |  3 +-
 pages/_en-US/twilightmenu/index.md            |  3 +-
 17 files changed, 192 insertions(+), 35 deletions(-)
 rename pages/_en-US/{other/hiyacfw.md => hiyacfw/custom-splash-screens.md} (85%)
 create mode 100644 pages/_en-US/hiyacfw/forwarders.md
 create mode 100644 pages/_en-US/hiyacfw/index.md
 create mode 100644 pages/_en-US/hiyacfw/installing.md
 create mode 100644 pages/_en-US/hiyacfw/troubleshooting.md

diff --git a/_data/en-US/categories.json b/_data/en-US/categories.json
index 578aa42a..982f6687 100644
--- a/_data/en-US/categories.json
+++ b/_data/en-US/categories.json
@@ -36,13 +36,16 @@
 		}
 	],
 	"nds-bootstrap": [
+
+	],
+	"gbarunner2": [
+
+	],
+	"hiyacfw": [
 		{
 			"key": "other",
 			"title": "Other"
 		}
-	],
-	"gbarunner2": [
-
 	],
 	"other": [
 
diff --git a/_data/en-US/nav.json b/_data/en-US/nav.json
index 831393c2..91ac0fa0 100644
--- a/_data/en-US/nav.json
+++ b/_data/en-US/nav.json
@@ -18,6 +18,10 @@
 				"title": "GBARunner2",
 				"url": "/gbarunner2"
 			},
+			{
+				"title": "hiyaCFW",
+				"url": "/hiyacfw"
+			},
 			{
 				"title": "Other Projects",
 				"url": "/other"
diff --git a/_layouts/wiki.html b/_layouts/wiki.html
index 3cbb8c98..fd1cbcbc 100644
--- a/_layouts/wiki.html
+++ b/_layouts/wiki.html
@@ -17,22 +17,23 @@ layout: compress
 				<div class="row mt-3">
 					<div class="col-md-3">
 						<div class="rounded-3 sidebar-container mb-3 p-3">
-							<!-- get category list -->
+							{% comment %} Get category list {% endcomment %}
 							{% assign items = site[page.collection] | where: "section", page.section | sort_natural: "title" %}
+							{% comment %} First do the index {% endcomment %}
+							{% for item in items %}
+								{% if item.url contains "index.html" %}
+									<a class="{% if page.title == item.title %}fw-bold{% endif %}" href="{{ item.url | remove: "index.html" }}">{{ item.title }}</a>
+									<hr class="mt-2 mb-2">
+								{% endif %}
+							{% endfor %}
 							<ul class="list-unstyled">
-								<!-- First do the index -->
-								{% for item in items %}
-									{% if item.url contains "index.html" %}
-										<li class="li-bullet {% if page.title == item.title %}fw-bold{% endif %}"><a href="{{ item.url | remove: "index.html" }}">{{ item.title }}</a></li>
-									{% endif %}
-								{% endfor %}
-								<!-- Then the pages not in categories -->
+								{% comment %} Then the pages not in categories {% endcomment %}
 								{% for item in items %}
 									{% unless item.url contains "index.html" or item.category %}
 										<li class="li-bullet {% if page.title == item.title %}fw-bold{% endif %}"><a href="{{ item.url | remove: ".html" }}">{{ item.title }}</a></li>
 									{% endunless %}
 								{% endfor %}
-								<!-- Finally, the other pages -->
+								{% comment %} Finally, the other pages {% endcomment %}
 								{% for cat in site.data[page.collection].categories[page.section] %}
 									<li>
 										<details {% if page.category == cat.key or page.category.first and page.category contains cat %}open{% endif %}>
@@ -52,8 +53,8 @@ layout: compress
 						</div>
 					</div>
 					<div class="col-md-9">
-						<h1>{{ page.long_title | default: page.title }}</h1>
-						<hr>
+						<h1 class="mb-1">{{ page.long_title | default: page.title }}</h1>
+						<hr class="mt-0">
 						{% include anchor-headings.html html=content anchorBody="<small>#</small>" anchorClass="header-anchor" %}
 						<div class="alert alert-secondary small-alert" role="alert">
 							{{ site.data[page.collection].strings.need-help }}
diff --git a/assets/css/style.scss b/assets/css/style.scss
index 26757dda..6f187807 100644
--- a/assets/css/style.scss
+++ b/assets/css/style.scss
@@ -33,6 +33,10 @@ h2 {
 	border-bottom: 1px solid var(--borders);
 }
 
+hr {
+	opacity: 0.5;
+}
+
 blockquote {
 	color: var(--blockquote-color);
 	margin-bottom: 20px;
diff --git a/pages/_en-US/community/index.md b/pages/_en-US/community/index.md
index dfdd7d2a..81a377d6 100644
--- a/pages/_en-US/community/index.md
+++ b/pages/_en-US/community/index.md
@@ -2,8 +2,7 @@
 lang: en-US
 layout: wiki
 section: community
-title: Home
-long_title: Community
+title: Community
 description: Information about the DS-Homebrew community
 ---
 
diff --git a/pages/_en-US/gbarunner2/index.md b/pages/_en-US/gbarunner2/index.md
index c417851d..f8051add 100644
--- a/pages/_en-US/gbarunner2/index.md
+++ b/pages/_en-US/gbarunner2/index.md
@@ -2,8 +2,7 @@
 lang: en-US
 layout: wiki
 section: gbarunner2
-title: Home
-long_title: GBARunner2
+title: GBARunner2
 description: Information on how to use GBARunner2
 ---
 
diff --git a/pages/_en-US/other/hiyacfw.md b/pages/_en-US/hiyacfw/custom-splash-screens.md
similarity index 85%
rename from pages/_en-US/other/hiyacfw.md
rename to pages/_en-US/hiyacfw/custom-splash-screens.md
index f1bb660e..de580232 100644
--- a/pages/_en-US/other/hiyacfw.md
+++ b/pages/_en-US/hiyacfw/custom-splash-screens.md
@@ -1,21 +1,19 @@
 ---
 lang: en-US
 layout: wiki
-section: other
-title: hiyaCFW
-description: Information about hiyaCFW
+section: hiyacfw
+title: Custom Splash Screens
+category: other
+description: How to use custom splash screens with hiyaCFW
 ---
 
-Information for [hiyaCFW](https://github.com/RocketRobz/hiyaCFW), the world's first CFW for DSi.
-
-### Custom splash screens
 With hiyaCFW you can use custom splashes in either `.bmp` or `.gif` formats. They need to go in the `sd:/hiya` folder and need to be named `splashtop` for the top screen and `splashbottom` for the bottom, with the appropriate file extension, then make sure the splash screen is enabled in the configuration. The images do not need to be the same format, so one can be BMP and the other GIF, GIFs have priority over BMPs. Below are some details on the requirements for your images to work:
 
-#### BMP
+### BMP
 - 16-bit (RGBA 1555, RGB 1555, or RGB 565)
 - 256 x 192 or smaller
 
-#### GIF
+### GIF
 - Simple answer: Most GIFs 256 x 192 or smaller will work
 - They can be animated, but should stay under 1 MiB for ideal performance and must be under around 10 MiB between the two absolute maximum
 - If both loop infinitely then they will be shown for 3 seconds, otherwise they will be shown until both are complete
diff --git a/pages/_en-US/hiyacfw/forwarders.md b/pages/_en-US/hiyacfw/forwarders.md
new file mode 100644
index 00000000..2349c054
--- /dev/null
+++ b/pages/_en-US/hiyacfw/forwarders.md
@@ -0,0 +1,30 @@
+---
+lang: en-US
+layout: wiki
+section: hiyacfw
+title: Forwarders
+category: other
+description: How to use nds-bootstrap forwarders with hiyaCFW
+---
+
+### Requirements
+- A Nintendo DSi with [Unlaunch](https://dsi.cfw.guide/installing-unlaunch), [hiyaCFW](installing), and [TWiLight Menu++](/twilightmenu/installing-dsi) installed
+- The latest release of [MakeForwarder](https://github.com/Ta180m/Make-Forwarder-Dsi/releases)
+
+### Instructions
+1. Extract *the contents of* `MakeForwarder.zip` to the root of your SD card
+1. Launch TWiLight Menu++
+1. Launch the Nintendo DS ROM you want to create a forwarder for
+1. Once the ROM boots, turn off your console
+   - If it does not work, please follow the nds-bootstrap troubleshooting guide
+1. Launch hiyaCFW
+1. Once in the Nintendo DSi Menu, unwrap and launch "Forwarder Maker"
+1. Set your target bootstrap depending on what your application is:
+   - **Retail ROM:** `sd:/_nds/nds-bootstrap-release.nds`
+   - **Homebrew:** `sd:/_nds/nds-bootstrap-hb-release.nds`
+1. Select `create forwarder` and navigate to the location of your ROM
+
+Repeat step 7 and 8 until you have created all desired forwarders.
+- You do not need to reset the target bootstrap if using the same type of ROM
+
+Once you've installed forwarders for all of your ROMs, reboot the system and launch hiyaCFW. They should now appear in gift boxes.
diff --git a/pages/_en-US/hiyacfw/index.md b/pages/_en-US/hiyacfw/index.md
new file mode 100644
index 00000000..92d99711
--- /dev/null
+++ b/pages/_en-US/hiyacfw/index.md
@@ -0,0 +1,13 @@
+---
+lang: en-US
+layout: wiki
+section: hiyacfw
+title: hiyaCFW
+description: Information on how to install and use hiyaCFW
+---
+
+[hiyaCFW](https://github.com/RocketRobz/hiyaCFW) is a custom firmware that will allow you to run your system NAND (internal storage) off of your SD card.
+
+This allows you to install your own apps to the Nintendo DSi Menu without risk of bricking, as they’re installed to the SD card so problems can fixed easily.
+
+It also allows easy installation of homebrew applications to the DSi Menu and displaying a custom splash screen on boot.
diff --git a/pages/_en-US/hiyacfw/installing.md b/pages/_en-US/hiyacfw/installing.md
new file mode 100644
index 00000000..a121d1d3
--- /dev/null
+++ b/pages/_en-US/hiyacfw/installing.md
@@ -0,0 +1,79 @@
+---
+lang: en-US
+layout: wiki
+section: hiyacfw
+title: Installing
+long_title: Installing hiyaCFW
+description: How to install hiyaCFW on the Nintendo DSi
+tabs:
+  - windows: Windows
+    macos: macOS
+    other: Linux
+---
+
+Do not system update after installing hiyaCFW. Doing so will remove hiyaCFW's SD patches.
+{: .alert .alert-danger}
+
+### Requirements
+- A Nintendo DSi with [Unlaunch installed](https://dsi.cfw.guide/installing-unlaunch)
+- A NAND Backup taken from your device using dumpTool
+   - If you don't have one, follow the [Dumping NAND](https://dsi.cfw.guide/dumping-nand) guide on dsi.cfw.guide
+- A Windows, macOS, or Linux device
+
+### Part 1: Preparing your PC for installing hiyaCFW
+{% capture tab-windows %}
+The hiyaCFW Helper is known to cause false positives with Windows Defender and other antivirus programs, please temporarity disable such programs if you have trouble downloading or running it.
+{: .alert .alert-info}
+
+1. Download & install the latest version of [7-Zip](https://www.7-zip.org/download.html)
+   - This will not work with any other archive extractor tool, such as WinRAR, the hiyaCFW helper relies on 7-Zip itself, and not a general archive extractor
+1. Download the latest Windows version of the [hiyaCFW Helper](https://github.com/mondul/HiyaCFW-Helper/releases)
+1. Extract the hiyaCFW Helper archive anywhere on your PC
+{% endcapture %}
+{% assign tab-windows = tab-windows | split: "////////" %}
+
+{% capture tab-macos %}
+1. Download the latest macOS version of the [hiyaCFW Helper](https://github.com/mondul/HiyaCFW-Helper/releases)
+1. Extract the hiyaCFW Helper archive anywhere on your PC
+{% endcapture %}
+{% assign tab-macos = tab-macos | split: "////////" %}
+
+{% capture tab-other %}
+1. Install Python 3 using your package manager if its not already installed
+1. Download the latest Python version of the [hiyaCFW Helper](https://github.com/mondul/HiyaCFW-Helper/releases)
+1. Extract the hiyaCFW Helper archive anywhere on your PC
+1. Make sure the necessary Python packages are installed by running `pip3 install -r requirements.txt` in the directory containing the extracted files
+   - You can install pip by running `python3 -m ensurepip`
+{% endcapture %}
+{% assign tab-other = tab-other | split: "////////" %}
+
+{% assign tabs = tab-windows | concat: tab-macos | concat: tab-other %}
+{% include tabs.html index=0 tabs=tabs %}
+
+### Part 2: Adding hiyaCFW files to your SD card
+![Screenshot of the hiyaCFW Helper](https://image.ibb.co/hhzKRL/Screen-Shot-2018-10-18-at-16-30-18.png)
+
+1. Launch the hiyaCFW Helper
+  - **Windows:** Launch the `HiyaCFW_Helper.exe` file extracted from the hiyaCFW Helper archive (you may need to temporarily disable your antivirus)
+  - **macOS:** Right click the `HiyaCFW_Helper` file extracted from the hiyaCFW Helper archive and choose `Open`
+  - **Linux:** Launch the `HiyaCFW_Helper.py` extracted from the hiyaCFW Helper archive
+1. Click the `...` button in the "NAND file with No$GBA footer" box
+1. Navigate to your NAND backup, and click `Open`
+1. Press `Start`
+1. In the new pop-up window, navigate to the root of your SD card, and press `OK`.
+   - The process may take several minutes
+1. When the application says `Done!`, close out of the hiyaCFW Helper
+1. Close the terminal window
+
+### Part 3: Configuring Unlaunch and hiyaCFW
+1. Power on your Nintendo DSi console while holding <kbd class="face">A</kbd> and <kbd class="face">B</kbd>
+   - This should take you to Unlaunch's file menu
+1. Navigate to `OPTIONS`, then `NO BUTTON`
+1. Select `hiyaCFW` and press <kbd class="face">A</kbd>
+   - This will make the system launch hiyaCFW automatically
+1. Save your settings and restart your console
+1. Hold <kbd>SELECT</kbd> while powering on your Nintendo DSi console to access the hiyaCFW settings
+1. Change the settings to your liking, then press <kbd>START</kbd> to continue
+
+If it shows `An error has occurred`, please see the [troubleshooting](troubleshooting#an-error-has-occurred) page.
+{: .alert .alert-warning}
diff --git a/pages/_en-US/hiyacfw/troubleshooting.md b/pages/_en-US/hiyacfw/troubleshooting.md
new file mode 100644
index 00000000..c306ec94
--- /dev/null
+++ b/pages/_en-US/hiyacfw/troubleshooting.md
@@ -0,0 +1,32 @@
+---
+lang: en-US
+layout: wiki
+section: hiyacfw
+title: Troubleshooting
+category: other
+description: Troubleshooting information for hiyaCFW
+---
+
+## #-2435-8325
+If your Nintendo DSi shows an error in this format when booting, with the # being a number, that means that bootstage 2 thinks something is wrong with your SDNAND. This is usually fixed by [reinstalling hiyaCFW](installing-hiyacfw).
+
+## "An error has occurred"
+When the Nintendo DSi Menu detects a problem it will usually show this generic error message, some of the causes are:
+
+#### The free space bug
+The Nintendo DSi Menu has a bug when checking the free space on large storage devices. While this can't occur on the actual NAND (since the chip is only 256 MiB), it can happen when using an SD card.
+
+What works and what doesn't goes by every other range of two gibibytes. For example, having 0-2 GiB of free space works, but 2-4 GiB doesn't. The same goes for 4-6 GiB vs 6-8 GiB, up until you get to the size of your SD card.
+
+The latest hiyaCFW version can create dummy files to work around this, so make sure that you download the latest version of [hiyaCFW](https://github.com/RocketRobz/hiyaCFW/releases/latest/download/hiyaCFW.7z) and copy `hiya.dsi` from "for SDNAND SD card" to the root of your SD card.
+
+#### Over 39 titles
+The Nintendo DSi Menu has a limit of 39 titles. If you have more than that, delete some from the folders in `sd:/title` or use [TMFH](https://github.com/JeffRuLz/TMFH/releases/latest) to uninstall them.
+
+#### Too much space used by DSiWare
+There is also a limit of 200 blocks (25MB) for DSiWare in the `00030004` folder. This can be worked around by installing as system apps using [TMFH](https://github.com/JeffRuLz/TMFH/releases/latest).
+
+#### Invalid title
+There are several things you need to take into account when adding titles to hiyaCFW:
+- Game card dumps cannot be run without being using a [forwarder](forwarders)
+- Homebrew need to be built correctly using modern tools to work from the Nintendo DSi Menu
diff --git a/pages/_en-US/nds-bootstrap/faq.md b/pages/_en-US/nds-bootstrap/faq.md
index dbd4be04..cee59408 100644
--- a/pages/_en-US/nds-bootstrap/faq.md
+++ b/pages/_en-US/nds-bootstrap/faq.md
@@ -2,7 +2,6 @@
 lang: en-US
 layout: wiki
 section: nds-bootstrap
-category: other
 title: FAQ & Troubleshooting
 long_title: nds-bootstrap FAQ & Troubleshooting
 description: FAQ & Troubleshooting for nds-bootstrap
diff --git a/pages/_en-US/nds-bootstrap/index.md b/pages/_en-US/nds-bootstrap/index.md
index 5c433af5..047ade7a 100644
--- a/pages/_en-US/nds-bootstrap/index.md
+++ b/pages/_en-US/nds-bootstrap/index.md
@@ -2,8 +2,7 @@
 lang: en-US
 layout: wiki
 section: nds-bootstrap
-title: Home
-long_title: nds-bootstrap
+title: nds-bootstrap
 description: Information on how to use nds-bootstrap
 ---
 
diff --git a/pages/_en-US/nds-bootstrap/testing.md b/pages/_en-US/nds-bootstrap/testing.md
index 7b6f5880..b856717d 100644
--- a/pages/_en-US/nds-bootstrap/testing.md
+++ b/pages/_en-US/nds-bootstrap/testing.md
@@ -2,7 +2,6 @@
 lang: en-US
 layout: wiki
 section: nds-bootstrap
-category: other
 title: Compatibility List & Testing Tips
 description: Compatibility list and tips for testing games
 ---
diff --git a/pages/_en-US/other/godmode9i.md b/pages/_en-US/other/godmode9i.md
index 69ebff1a..ff8c9f3e 100644
--- a/pages/_en-US/other/godmode9i.md
+++ b/pages/_en-US/other/godmode9i.md
@@ -11,7 +11,7 @@ Information for [GodMode9i](https://github.com/DS-Homebrew/GodMode9i), a full ac
 ### FAQ & Troubleshooting
 
 #### How do I get past the "mounting drive(s)" screen while starting it up?
-This happens when you launch GodMode9i from [hiyaCFW](https://wiki.ds-homebrew.com/other/hiyacfw). You can hold X while launching GodMode9i to skip NAND mounting. Alternatively, you can launch GodMode9i directly from unlaunch to be able to mount the NAND.
+This happens when you launch GodMode9i from [hiyaCFW](/hiyacfw). You can hold X while launching GodMode9i to skip NAND mounting. Alternatively, you can launch GodMode9i directly from unlaunch to be able to mount the NAND.
 
 #### Why can't I dump games on DSi?
 You need Unlaunch installed in order to be able to dump games onto your SD card. You can install Unlaunch by following [dsi.cfw.guide](https://dsi.cfw.guide/).
diff --git a/pages/_en-US/other/index.md b/pages/_en-US/other/index.md
index 2b218bb6..beaf66ec 100644
--- a/pages/_en-US/other/index.md
+++ b/pages/_en-US/other/index.md
@@ -2,8 +2,7 @@
 lang: en-US
 layout: wiki
 section: other
-title: Home
-long_title: Other
+title: Other Projects
 description: Information about other DS-Homebrew projects
 ---
 
diff --git a/pages/_en-US/twilightmenu/index.md b/pages/_en-US/twilightmenu/index.md
index 748a07ff..d744b815 100644
--- a/pages/_en-US/twilightmenu/index.md
+++ b/pages/_en-US/twilightmenu/index.md
@@ -1,8 +1,7 @@
 ---
 lang: en-US
 section: twilightmenu
-title: Home
-long_title: TWiLight Menu++
+title: TWiLight Menu++
 description: Guides on how to use and customize TWiLight Menu++
 ---