Fix formatting on all pages

Author: nabeelio

docs/acars/customization.md

@@ -26,7 +26,11 @@ resized down to fit. Fill in the URLs to your logos. They should be PNG format
 
 ## Discord Rich Presence
 
-:::tip This requires the ACARS Premium Addon :::
+:::tip
+
+This requires the ACARS Premium Addon
+
+:::
 
 To customize the "Rich Presence" dialog in Discord, you need to create a new
 Application in Discord. You'll then enter the provided `Application ID` into the

docs/acars/install-server.md

@@ -5,9 +5,6 @@ title: Installation (Server)
 
 ## 1. Module Installation
 
-:::info The latest [dev](http://downloads.phpvms.net/phpvms-7.0.0-dev.tar.gz)
-versions of phpVMS are currently required :::
-
 For the server-side installation, extract the ACARS zip file, open the `Web`
 folder and copy the `VMSAcars` into your `phpvms/modules` folder:
 

docs/acars/user-guide.md

@@ -7,32 +7,23 @@ title: User Guide
 
 ---
 
-## .NET 6.0 Runtime
-
-If you don't have this installed, ACARS will prompt you to download it. But if
-you want to download ahead of time, visit the
-[Download Page from Microsoft](https://dotnet.microsoft.com/en-us/download/dotnet/6.0/runtime),
-and select the x64 version for Desktop apps
-
-![](img/runtime-path-dn6.png)
-
 ## ACARS Client
 
 After downloading the zip, just extract the client into a folder (e.g, on your
 desktop into a folder called `ACARS`). Then you can create a desktop shortcut
 from the `acars.exe` for easier access.
 
-:::caution vmsACARS files should NOT be placed in OneDrive synced
-locations/folders, if you have OneDrive installed and enabled please use another
-location other than your desktop or documents folders for acars extraction. :::
+:::danger
 
----
+vmsACARS files should **NOT** be placed in OneDrive synced locations/folders, if
+you have OneDrive installed and enabled please use another location other than
+your desktop or documents folders for acars extraction.
 
-## Simulator Configuration
+:::
 
 ---
 
-### FSX/Prepar3d Configuration
+## FSX/Prepar3d Configuration
 
 To use FSX/Prepar3d, you need to install:
 
@@ -42,7 +33,7 @@ To use FSX/Prepar3d, you need to install:
 After installing both, run `MakeRwys`. `MakeRwys` also needs to be re-run
 whenever there are scenery changes (if you want gates/runways to be updated).
 
-### X-Plane Configuration
+## X-Plane Configuration
 
 X-Plane uses a custom plugin. Open the `X-Plane` folder, and copy the
 `AcarsConnect` folder into your `Resources\plugins` folder.
@@ -55,9 +46,9 @@ selecting your X-Plane root/main folder.
 
 ![](img/xplane_button.png)
 
-### MSFS Configuration
+## MSFS Configuration
 
-#### WASM Module
+### WASM Module
 
 If you're using Microsoft Flight Simulator, to read the LVars from the sim you
 need the `FSUIPC WASM Module (Version)` from [FSUIPC](https://www.fsuipc.com/) ,
@@ -66,23 +57,12 @@ folder.
 
 ![](img/fsuipc_lvar.png)
 
-Also it is possible to install the WASM Module with FSUIPC main installer. While
-installing or updating it, be sure you have the WASM Module option enabled.
+Also, it is possible to install the WASM Module with FSUIPC main installer.
+While installing or updating it, be sure you have the WASM Module option
+enabled.
 
 ![](img/fsuipc_install.png)
 
-#### Scenery
-
-:::caution Due to an MSFS limitation, sceneries purchased through the MSFS store
-can't be scanned because they're encrypted. Only sceneries purchased outside of
-the store and manually placed in the `Community` directory can be scanned :::
-
-To use MSFS, select "Microsoft Flight Simulator" from the simulator list and you
-will have two options:
-
-    - "Native" - this will try to scan all of the scenery folders and BGL files.
-    - "MakeRwys" - this will use the MakeRwys output (same as P3D). The files output by `MakeRwys` need to be placed in the root of the `Community` folder
-
 #### Permission Denied Errors
 
 If you're getting a permission denied error, see
@@ -118,10 +98,14 @@ configuration/settings page:
 After entering your URL and API key, select the simulator, and then select the
 path to the simulator's root folder (for Fs9/FsX/Prepar3d or X-Plane)
 
-:::info FSX/Prepar3d requires the `MakeRwys.exe` file, which can be downloaded
-from the [FSUIPC Page](http://fsuipc.simflight.com/beta/MakeRwys.zip). It needs
-to be placed in the same directory as FSX/Prepar3d, and it will create the
-required files needed to scan. :::
+:::info
+
+FSX/Prepar3d requires the `MakeRwys.exe` file, which can be downloaded from the
+[FSUIPC Page](http://fsuipc.simflight.com/beta/MakeRwys.zip). It needs to be
+placed in the same directory as FSX/Prepar3d, and it will create the required
+files needed to scan.
+
+:::
 
 After selecting the directory, click `Re-Scan Scenery`. This will load the
 scenery database into ACARS for it to run/load later
@@ -148,8 +132,12 @@ Then click "Open In Guest", and you can follow the above instructions for then
 installing the plugin. Then, in ACARS, properly set the "Scenery Path" and IP to
 your Mac machine:
 
-:::info If you configure it to point to the X-Plane root, the default share path
-for VMWare Fusion would be `\\vmware-host\Shared Folders\X-Plane 11`. :::
+:::info
+
+If you configure it to point to the X-Plane root, the default share path for
+VMWare Fusion would be `\\vmware-host\Shared Folders\X-Plane 11`.
+
+:::
 
 ![](img/vmware-acars-config.png)
 

docs/config/backups.md

@@ -11,7 +11,11 @@ it if you want to create backups of your files and database.
 Backups are scheduled nightly, and an older backup is removed, ensuring you have
 multiple backups available (e.g., last night's, the one before, etc.).
 
-:::caution Backups can consume up to 5GB of disk space. :::
+:::warning
+
+Backups can consume a large amount of data and disk space
+
+:::
 
 ## Basic Configuration
 

docs/config/email.md

@@ -18,9 +18,12 @@ These services are supported by Laravel natively;
 - [Amazon SES](https://aws.amazon.com/ses/) - Super cheap, free if you're using
   EC2
 
-> [!IMPORTANT]  
-> Do not forget cleaning application cache after editing `.env` variables.
-> Otherwise settings you defined/altered will not be loaded.
+:::warning
+
+Do not forget cleaning application cache after editing `.env` variables.
+Otherwise, settings you defined/altered will not be loaded.
+
+:::
 
 ---
 

docs/config/files.md

@@ -20,8 +20,12 @@ mail, and select configs from the `/config` directory. This file is used as an
 override (in the previous version of phpVMS, the `local.config.php` file is the
 same concept).
 
-:::caution Don't change the files in the `/config` directory; instead, edit the
-`.env` file. This file will not be overwritten on an update. :::
+:::caution
+
+Don't change the files in the `/config` directory; instead, edit the `.env`
+file. This file will not be overwritten on an update.
+
+:::
 
 See [Laravel configuration files](https://laravel.com/docs/9.x/configuration)
 for additional documentation.

docs/config/language.md

@@ -4,17 +4,16 @@ title: Config Language
 sidebar_title: Config Language
 ---
 
-# Change phpVMS Language
-
 It is possible to change the system language from one of the available
-languages.
-
-To do this, consult the directory `phpvms/resources/lang/` to see the name of
-the available ones.
+languages. To do this, consult the directory `phpvms/resources/lang/` to see the
+name of the available ones.
 
 Example: We want portuguese from brazil, We check that it is there
 `phpvms/resources/lang/pt-br`
 
-Edit the `.env` file with your desire language name, pt-br in our example.
+Edit the `.env` file with your desire language name, `pt-br` in our example,
+add:
 
-## `APP_LOCALE=pt-br`
+```
+APP_LOCALE=pt-br
+```

docs/config/optimizing.md

@@ -58,7 +58,11 @@ DEBUG_TOOLBAR=false
 Sessions store the logged in users and other information. By default, they're
 stored on disk.
 
-:::info The Redis store is recommended if you have access to it :::
+:::info
+
+The Redis store is recommended if you have access to it
+
+:::
 
 #### Redis
 

docs/customize/layouts.md

@@ -14,10 +14,14 @@ All of the themes are stored in the `resources/views/layouts/` folder. There is
 a base theme file, `app.blade.php`, which is then used by the templates. It has
 several required sections:
 
-:::info See the `resources/views/layouts/default/app.blade.php` as an example
-template, since there are several sections of code which are required in any
-custom templates, including some Javascript and CSS. I've tried to make notes
-and outline those sections in the `default/app.blade.php` file itself. :::
+:::info
+
+See the `resources/views/layouts/default/app.blade.php` as an example template,
+since there are several sections of code which are required in any custom
+templates, including some Javascript and CSS. I've tried to make notes and
+outline those sections in the `default/app.blade.php` file itself.
+
+:::
 
 - `@section('title')` is the page title, and shows up in the title bar
 - `@section('content')` is the main content for the page

docs/customize/theming.md

@@ -36,7 +36,11 @@ know what you've modified).
 
 ### New Theme from Scratch
 
-:::tip You can use `theme:create` command to bootstrap these steps :::
+:::tip
+
+You can use `theme:create` command to bootstrap these steps
+
+:::
 
 Into the root of the `resources/views/layouts/` path, create a new folder, with
 a `theme.json` file. This JSON file serves as the manifest for your theme

docs/developers/building-assets.md

@@ -45,10 +45,14 @@ Each of those folders have a `js` and `css` folder, and the respective assets
 are placed in those folders. After building those assets, the files are placed
 into there.
 
-:::caution On an update, the files in `public/assets/*` will be overwritten, so
-be careful when updating to make sure those files aren't overwritten. You can do
-a diff against the original JS files in `resources/js` and then rebuild, to make
-sure your changes are included :::
+:::caution
+
+On an update, the files in `public/assets/*` will be overwritten, so be careful
+when updating to make sure those files aren't overwritten. You can do a diff
+against the original JS files in `resources/js` and then rebuild, to make sure
+your changes are included
+
+:::
 
 ---
 

docs/developers/environment.md

@@ -7,26 +7,32 @@ title: Environment Configuration
 
 This is for running a local configuration, for running unit-tests, etc.
 
-:::info This is just how I work on phpVMS, to quickly reset the database and
+:::note
+
+This is just how I work on phpVMS, to quickly reset the database and
 test/develop items locally, without having to transfer files anywhere. I mainly
 use the Docker Compose setup
 
 If you're on Windows, I highly recommend installing WSL with your distro of
 choice (I use Ubuntu). If you don't have `make` available, open the `Makefile`
 and look for the commands to run for the individual commands of what you're
-trying to run. :::
-
-:::info You may want to disable caching during development phases to ensure your
-changes are applied correctly, as caching cna prevent changes from taking
-effect. To do this, set `CACHE_DRIVER=null` in your `.env` file.
+trying to run.
 
 :::
 
-:::info We strongly recommend reading the
+### Disable Caching
+
+You may want to disable caching during development phases to ensure your changes
+are applied correctly, as caching cna prevent changes from taking effect. To do
+this, set `CACHE_DRIVER=null` in your `.env` file.
+
+### Laravel Documentation
+
+We strongly recommend reading the
 [Laravel Documentation](https://laravel.com/docs/10.x), as it's more detailed
 and up-to-date. Since phpVMS is based on Laravel, the installation process is
 the same. In addition, you can simply use the `php artisan phpvms:dev-install`
-command to set up a development database. :::
+command to set up a development database.
 
 ## Creating and Resetting the Environment with docker
 

docs/help.md

@@ -7,8 +7,12 @@ This guide details the requirements for getting help with phpVMS or vmsACARS.
 
 ## How to ask for help
 
-:::info Before asking for help, try to reproduce on the
-[demo site](https://demo.phpvms.net), and with the `default` skin :::
+:::info
+
+Before asking for help, try to reproduce on the
+[demo site](https://demo.phpvms.net), and with the `default` skin
+
+:::
 
 Without a lot of this information, it will be difficult to provide help.
 

docs/installation/cron.md

@@ -10,19 +10,23 @@ Some of the features that rely on cronjobs include:
 - Finances
 - vaCentral features
 
-:::note If you can't run it once a minute, the lowest interval possible is fine,
-but should be in 5 minute increments, since there are tasks that run at 5,15,
-and 30 minute intervals. :::
-
-:::tip Info about "Shared Hosting" Many hosts limit the usage of cron, either by
-limiting it directly or limiting php extensions needed by cron. So if you are
-planning to use a "Shared Hosting", better to focus on cron and email settings
-first (specially if they offer a money back quarantee), if cron is failing and
-you can not get it working properly consider finding a different service
-provider. Even some hosts limit WebCron services, be advised, without a working
-cron you will not get the best of phpVMS v7. :::
+:::note
 
----
+If you can't run it once a minute, the lowest interval possible is fine, but
+should be in 5 minute increments, since there are tasks that run at 5,15, and 30
+minute intervals.
+
+:::
+
+## Info about "Shared Hosting"
+
+Many hosts limit the usage of cron, either by limiting it directly or limiting
+php extensions needed by cron. So if you are planning to use a "Shared Hosting",
+better to focus on cron and email settings first (specially if they offer a
+money back quarantee), if cron is failing and you can not get it working
+properly consider finding a different service provider. Even some hosts limit
+WebCron services, be advised, without a working cron you will not get the best
+of phpVMS v7.
 
 ## Configuration on a Server
 
@@ -52,9 +56,13 @@ phpVMS, in the admin panel, can suggest a cron path/command for you, under
 `Admin -> Maintenance`. However, before trying that, try setting it up according
 to your host's instructions.
 
-:::tip Note the "Domain Specific Example" Many hosts offer multiple PHP
-versions, make sure to use the path to the PHP 7.x version in the cronjob.
-Contact your host! Point them to this page. The example below uses PHP 7.4. :::
+:::tip
+
+Note the "Domain Specific Example" Many hosts offer multiple PHP versions, make
+sure to use the path to the PHP 7.x version in the cronjob. Contact your host!
+Point them to this page. The example below uses PHP 7.4.
+
+:::
 
 With cPanel, select "Once Per Minute" under "Common Settings", and you can use a
 similar command.