Admonitions and adoc to md

content/documentation/Accessories/Cases/Model_B_Acrylic_Open_Enclosure.adoc → content/documentation/Accessories/Cases/Model_B_Acrylic_Open_Enclosure.md

@@ -9,34 +9,33 @@ menu:
     weight: 
 ---
 
-The *"Model B" Acrylic Open Enclosure* is a case for "Model B" sized single-board computers sold by PINE64, available from https://pine64.com/product/model-b-acrylic-open-enclosure/[the official store].
+The **"Model B" Acrylic Open Enclosure** is a case for "Model B" sized single-board computers sold by PINE64, available from [the official store](https://pine64.com/product/model-b-acrylic-open-enclosure/).
 
 {{< figure src="/documentation/ROCK64/images/ROCK64_acrylic_open_enclosure.jpg" title="A_ROCK64_mounted_in_the_case,_the_correct_way." >}}
 
-== Installation
+## Installation
 
 To install the SBC inside the case, stick the long screws into the SBC mounting holes from below, place the board such that the screws sit in its mounting holes, and screw on the brass fasteners on top of the SBC.
 
-== Mods
+## Mods
 
-=== 3D-Printable Top With Fan Cutout
+### 3D-Printable Top With Fan Cutout
 
 {{< figure src="/documentation/images/Model_b_open_enclosure_top_cad.png" title="Top_view_of_the_plate" >}}
 {{< figure src="/documentation/images/Model_B_Open_Enclosure_Top_Fan_Mount.jpeg" title="The assembled modified case with a Noctua NF-A4x10 5V PWM mounted to it. The SBC is mounted in the enclosure upside-down." >}}
 
-User:CounterPillow has created an alternate 3D-printable top plate which allows for the mounting of a 40mmx40mmx10mm fan. The STL and STEP files are available free of charge under https://wiki.pine64.org/wiki/File:Model_B_acrylic_case_top_plate_with_fan_cutout.zip[], licensed as CC-BY 4.0.
+User:CounterPillow has created an alternate 3D-printable top plate which allows for the mounting of a 40mmx40mmx10mm fan. The STL and STEP files are available free of charge under [https://wiki.pine64.org/wiki/File:Model_B_acrylic_case_top_plate_with_fan_cutout.zip](https://wiki.pine64.org/wiki/File:Model_B_acrylic_case_top_plate_with_fan_cutout.zip), licensed as CC-BY 4.0.
 
-A fan is mounted to it using self-tapping fan screws usually shipped with computer fans; put the fan on the underside of the plate, and screw in the self-tapping screws from the top side. You can either have the fan exhaust air through the top, or blow it onto the SoC's heatsink. The latter configuration appears to work better, but precise measurements haven't been made yet.
+A fan is mounted to it using self-tapping fan screws usually shipped with computer fans; put the fan on the underside of the plate, and screw in the self-tapping screws from the top side. You can either have the fan exhaust air through the top, or blow it onto the SoC’s heatsink. The latter configuration appears to work better, but precise measurements haven’t been made yet.
 
-Recommended printing material is PETG for its structural rigidity. However, PLA will likely work fine as well, and is easier to print. A 0.6mm nozzle was used for test prints, but any nozzle should work. Depending on the layer height you choose, your print may come out slightly thicker or thinner; this is no problem though. It's recommended to enable the advanced "Detect Thin Walls" option in slic3r to get a cleaner g-code result around the fan holes.
+Recommended printing material is PETG for its structural rigidity. However, PLA will likely work fine as well, and is easier to print. A 0.6mm nozzle was used for test prints, but any nozzle should work. Depending on the layer height you choose, your print may come out slightly thicker or thinner; this is no problem though. It’s recommended to enable the advanced "Detect Thin Walls" option in slic3r to get a cleaner g-code result around the fan holes.
 
 The print will take approximately 7.8 metres of filament, and take in the order of one hour, though this depends on slicer settings and printer model.
 
 The cooling performance with a Noctua NF-A4x10 5V PWM is enough to no longer throttle after a few minutes of cpuburn, but comfortably sitting at below 75°C instead. The memory has no temperature sensor, but will likely be cooled quite a bit as well.
 
 {{< figure src="/documentation/images/Arduino_pwm_thing.png" title="Rough wiring diagram of how to PWM control the fan from a ROCK64 with a helper Arduino" >}}
 
-Since the link:/documentation/ROCK64[ROCK64] has no PWM pins available to control the fan, a slight workaround can be done; with the `gpio-fan` device tree binding, an Arduino can be controlled to soft-PWM a suitable 25 kHz signal for the fan. The ROCK64 uses 3.3V on the GPIO pins, so you'll need to logic level convert it to 5V if you're using a 5V Arduino, and if you're using a 3.3V microcontroller, you'll need to logic level shift the output PWM signal as the 5V fan will be expecting 5V PWM on the PWM pin.
-
-The https://gist.github.com/CounterPillow/34cd7355eb625093e4350c349d2618ea[device tree changes and the Arduino sketch] which User:CounterPillow created for this can be used for any purpose by anyone. It is recommended to play around with the device tree though, to add more trip points for better control over when the fan actually ramps up, and adding more hysteresis as the temperature reading from the ROCK64 is quite jumpy.
+Since the [ROCK64](/documentation/ROCK64) has no PWM pins available to control the fan, a slight workaround can be done; with the `gpio-fan` device tree binding, an Arduino can be controlled to soft-PWM a suitable 25 kHz signal for the fan. The ROCK64 uses 3.3V on the GPIO pins, so you’ll need to logic level convert it to 5V if you’re using a 5V Arduino, and if you’re using a 3.3V microcontroller, you’ll need to logic level shift the output PWM signal as the 5V fan will be expecting 5V PWM on the PWM pin.
 
+The [device tree changes and the Arduino sketch](https://gist.github.com/CounterPillow/34cd7355eb625093e4350c349d2618ea) which User:CounterPillow created for this can be used for any purpose by anyone. It is recommended to play around with the device tree though, to add more trip points for better control over when the fan actually ramps up, and adding more hysteresis as the temperature reading from the ROCK64 is quite jumpy.

content/documentation/Accessories/Cases/NASCase.adoc → content/documentation/Accessories/Cases/NASCase.md

@@ -11,11 +11,11 @@ menu:
 
 The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4mm (Width) x 105.0mm (Height) x 145.2mm (Depth).
 
-An exploded view of the NAS Case, illustrating how all the components come together, can be found http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf[here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
+An exploded view of the NAS Case, illustrating how all the components come together, can be found [here](http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf). Please refer back to this PDF document during assembly to verify correct orientation of individual components.
 
 {{< figure src="/documentation/images/NASCaseMain.png" title="Front View of the PINE64 NAS Case for the ROCKPro64" width="400" >}}
 
-== What does the NAS Case house?
+## What does the NAS Case house?
 
 {{< figure src="/documentation/images/NAS_Case_internals.jpg" title="Internal Layout of the NAS Case" width="200" >}}
 
@@ -27,7 +27,7 @@ The NAS Case can house the following components:
 * A 80mm fan with a Ph 2-Pin connector
 * Up to three SMA antennas, two of which can be attached to the WiFi/ BT module
 
-== What comes in the box?
+## What comes in the box?
 
 When you purchase the NAS Case from the PINE store the following items are shipped to you:
 
@@ -36,9 +36,9 @@ When you purchase the NAS Case from the PINE store the following items are shipp
 * A custom power cable capable of powering two  2.5 inches  inchesr 3.5 inches HDDs /SSDs
 * The required screws, fittings and a LED relay
 
-== What other bare-minimum things do I need for a NAS build?
+## What other bare-minimum things do I need for a NAS build?
 
-You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your ROCKPro64 board. \https://forum.pine64.org/showthread.php?tid=6932. WARNING: this adapter does not work well with two HDDs, see https://forum.pine64.org/showthread.php?tid=6511:
+You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your ROCKPro64 board. <span>https://</span>forum.pine64.org/showthread.php?tid=6932. WARNING: this adapter does not work well with two HDDs, see https://forum.pine64.org/showthread.php?tid=6511:
 
 {{< figure src="/documentation/images/PCIetoSATA.png" width="200" >}}
 
@@ -48,13 +48,13 @@ With the exception of HDDs/SSDs, everything you need for a complete build can be
 
 * A ROCKPro64 2GB or 4GB board
 * A 12V 5A power supply
-* A PCIe to dual SATA adapter: https://forum.pine64.org/showthread.php?tid=6932[*WARNING*, the SATA adapter from PINE64 store is low-quality and] https://forum.pine64.org/showthread.php?tid=6511[will not function well with two SATA HDD].
+* A PCIe to dual SATA adapter: [**WARNING**, the SATA adapter from PINE64 store is low-quality and](https://forum.pine64.org/showthread.php?tid=6932) [will not function well with two SATA HDD](https://forum.pine64.org/showthread.php?tid=6511).
 * One or two 2.5 inche inches/ 3.5 inches HDDs (not sold in the PINE store).
 * A class 10 micro SD card and/or eMMC module.
 
-You can purchase all the aforementioned items in the https://www.pine64.org/?post_type=product[PINE64 store]
+You can purchase all the aforementioned items in the [PINE64 store](https://www.pine64.org/?post_type=product)
 
-== What other things should I consider buying for a NAS build in the NAS Case?
+## What other things should I consider buying for a NAS build in the NAS Case?
 
 There are a few other things which you may wish to consider purchasing for your NAS. These peripherals, while not necessary from an operational standpoint, may contribute to the longevity and stability of your NAS’ operation OR expand it with additional functionality:
 
@@ -65,32 +65,32 @@ There are a few other things which you may wish to consider purchasing for your
 
 (The fan and heatsink are highly recommended)
 
-== Which software should I use?
+## Which software should I use?
 
 {{< figure src="/documentation/images/OMVGUI.png" title="The OMV WebGUI is easy to understand but also very robust. It offers easy installation of plugins, system administration and overview of available services" width="200" >}}
 
-If you are intending to build a home or small company NAS, then we strongly recommend you use link:/documentation/ROCKPro64/Software#openmediavault[Open Media Vault (OMV)]. OMV is an open source NAS solution that makes setting up user accounts, network shares and services a breeze. It also simplifies installing additional features (called plugins), such as: PLEX media server; Remote Desktop; Encryption; RSync; etc.
+If you are intending to build a home or small company NAS, then we strongly recommend you use [Open Media Vault (OMV)](/documentation/ROCKPro64/Software#openmediavault). OMV is an open source NAS solution that makes setting up user accounts, network shares and services a breeze. It also simplifies installing additional features (called plugins), such as: PLEX media server; Remote Desktop; Encryption; RSync; etc.
 
 Its worth noting that Nextcloud, or other similar Cloud storage solutions, can also be easily installed alongside the OMV OS Image.
 
 Administration and monitoring of OMV is done via an advanced WebGUI, which also allows for updating and upgrading the ROCKPro64.
-To learn more about OMV please visit https://www.openmediavault.org/[their website]. 
+To learn more about OMV please visit [their website](https://www.openmediavault.org/). 
 
-To download the latest OMV build OR one of the numerous available Linux Distribution OS Images please visit the link:/documentation/ROCKPro64/Software[ROCKPro64 OS download section].
+To download the latest OMV build OR one of the numerous available Linux Distribution OS Images please visit the [ROCKPro64 OS download section](/documentation/ROCKPro64/Software).
 
-== Step-by-Step Assembly Instructions
+## Step-by-Step Assembly Instructions
 
-If you prefer a video tutorial or just want an overview of the process before you start http://www.youtube.com/watch?v=_UeeklKo0Og[check out this instructional video].
+If you prefer a video tutorial or just want an overview of the process before you start [check out this instructional video](http://www.youtube.com/watch?v=_UeeklKo0Og).
 
-=== Step 1. Preparation of the NAS Case for Installation
+### Step 1. Preparation of the NAS Case for Installation
 
 Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.
 
 The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.
 
 You should now be left with a bare case ready for installation of the necessary components.
 
-=== Step 2. Installing the ROCKPro64 into the NAS Case
+### Step 2. Installing the ROCKPro64 into the NAS Case
 
 {{< figure src="/documentation/images/ROCKPro64inNASCase.jpg" title="Correct Placement of the ROCKPro64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case" width="300" >}}
 
@@ -107,13 +107,13 @@ In the see-through bag you will also find a small semi-opaque plastic cylinder.
 
 If you wish to install an IRx receiver into your case then you should also place it into the IR socket at this stage. It should align with the cutout right above the power (PWR) switch.
 
-=== Step 3 PCIe to SATA adapter and Cabling
+### Step 3 PCIe to SATA adapter and Cabling
 
 {{< figure src="/documentation/images/DC_Location.jpg" title="DC header on the ROCKPro64 for the power cable" width="200" >}}
 
 {{< figure src="/documentation/images/PCIeFittedSATAsockets.png" title="PCIe to SATA installed. Note the SATA connection orientation" width="200" >}}
 
-With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.
+With the board in place it’s time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.
 
 Place the SATA Adapter into the PCIe slot on the ROCKPro64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter; some
 variants of the PCIe dual SATA adapter can be configured for eSATA if need be, and the eSATA ports are accessible in the back of the case. By default, the internal SATA connectors are active on the adapter.
@@ -124,7 +124,7 @@ This is the right time to plug in the SATA and custom power cable. The SATA cabl
 
 Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.
 
-=== Step 4. Installing HDDs / SSDs into the Holding Bracket
+### Step 4. Installing HDDs / SSDs into the Holding Bracket
 
 {{< figure src="/documentation/images/Bracket_Orientation.png" title="Bracket Orientation in the NAS Case" width="300" >}}
 
@@ -138,11 +138,11 @@ Each drive you mount in the holding bracket requires 4x screws which come suppli
 
 Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.
 
-=== Step 5. Installing Extras (eMMC; WiFi BT module + SMA Antennas; 80mm Fan)
+### Step 5. Installing Extras (eMMC; WiFi BT module + SMA Antennas; 80mm Fan)
 
 {{< figure src="/documentation/images/80mmfan.png" title="The 80mm fan is a worthwhile addition to the NAS Case build" width="200" >}}
 
-If you have additional peripherals, such as an eMMC or WiFi/BT module as well as the 80mm fan, then now is the right time to install them. If you have *none of the above*, please *proceed to step 6* of this guide.
+If you have additional peripherals, such as an eMMC or WiFi/BT module as well as the 80mm fan, then now is the right time to install them. If you have **none of the above**, please **proceed to step 6** of this guide.
 
 The eMMC and WiFi/BT modules are fitted into their respective placements on the ROCKPro64 board - please consult the diagram for their correct installation.
 
@@ -152,7 +152,7 @@ The fan should be mounted on the right-hand side of the case. We suggest that th
 The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
 Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.
 
-=== Step 6. Installing the HDD / SSD Bracket and Routing Cables
+### Step 6. Installing the HDD / SSD Bracket and Routing Cables
 
 {{< figure src="/documentation/images/NASCAsewithdrives.jpg" title="Complete assembly of the NAS Case" width="300" >}}
 
@@ -170,13 +170,13 @@ For 3.5 inches HDDs we suggest routing power and SATA cables underneath the driv
 
 For 2.5 inches disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where t inchese 3.5 inches HDDs would reside.
 
-=== Step 7. Closing the NAS Case and Powering On your NAS
+### Step 7. Closing the NAS Case and Powering On your NAS
 
-Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.
+Almost there. All that’s left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.
 
 To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).
 
-== IO accessibility when the NAS Case is assembled
+## IO accessibility when the NAS Case is assembled
 
 When the NAS Case is assembled and screwed shut these ROCKPro64 IO ports remain accessible:
 
@@ -187,4 +187,3 @@ When the NAS Case is assembled and screwed shut these ROCKPro64 IO ports remain
 * The headphone and microphone jack
 * Gigabit Ethernet port
 * HDMI
-