Skip to content

Commit 917423a

Browse files
committed
Add tabs for OS sections
1 parent 30a2a6e commit 917423a

File tree

1 file changed

+27
-9
lines changed
  • articles/tutorials/building_2d_games/02_getting_started

1 file changed

+27
-9
lines changed

articles/tutorials/building_2d_games/02_getting_started/index.md

Lines changed: 27 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -16,27 +16,29 @@ While the environment setup process is similar to the standard setup process for
1616

1717
The first thing we need to do is install the .NET *Software Development Kit* (SDK). At the time of this writing, MonoGame targets the .NET 8.0 SDK. To install it, follow the instructions based on your operating system below
1818

19-
### Windows
19+
### [Windows](#tab/windows)
2020
1. Open a web browser and navigate to https://dotnet.microsoft.com/en-us/download.
2121
2. Click the *Download .NET SDK x64* button to start the download of the .NET SDK Installer.
2222
3. Once the download finishes, run the installer
2323

24-
### macOS
24+
### [macOS](#tab/macos)
2525
1. Open a web browser and navigate to https://dotnet.microsoft.com/en-us/download.
2626
2. Click the *Download .NET SDK x64 (Intel)* button start the download of the .NET SDK Installer
2727
3. Once the download finishes, run the installer.
2828

2929
> [!NOTE]
3030
> For the time being, MonoGame requires that you install the **Intel** version even if you are using an Apple Silicon (M1/M2) Mac. For Apple Silicon Macs, it also requires that [Rosetta](https://support.apple.com/en-us/HT211861) is enabled.
3131
32-
### Linux
32+
### [Linux](#tab/linux)
3333
1. Open a new *Terminal* window
3434
2. Enter the following command to install the .NET SDK
3535

3636
```sh
3737
sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0
3838
```
3939

40+
---
41+
4042
## Install Additional Workloads (Optional)
4143

4244
After installing the .NET SDK, if you intend to target mobile devices such as Android or iOS, you will also need to install the corresponding mobile workloads. To do this, open a *Command Prompt* or *Terminal* window and enter the following commands
@@ -60,23 +62,27 @@ dotnet new install MonoGame.Templates.CSharp
6062

6163
To install VSCode, follow the instructions for your operating system below:
6264

63-
### Windows
65+
### [Windows](#tab/windows)
66+
6467
1. Open a browser and navigate to https://code.visualstudio.com/.
6568
2. Click the *Download for Windows* button to start the download of the installer.
6669
3. Once the download finishes, run the installer.
6770

68-
### macOS
71+
### [macOS](#tab/macos)
6972

7073
1. Open a web browser and navigate to https://code.visualstudio.com/.
7174
2. Click the *Download for macOS* button to start the download of the *.zip* archive.
7275
3. Once the download finishes, double click the *.zip* archive to extract the *Visual Studio Code.app* application package
7376
4. Drag-and-drop the *Visual Studio Code.app* application package into your *Application* directory to make it available in the macOS *LaunchPad*.
7477

75-
### Linux
78+
### [Linux](#tab/linux)
79+
7680
1. Open a web browser and navigate to https://code.visualstudio.com/.
7781
2. Click the *.deb* download button to download the package for Debian based Linux distributions, or the *.rpm* download button for Red Hat based Linux distributions.
7882
3. Once the download finishes, open the package downloaded to install.
7983

84+
---
85+
8086
## Install the C# Dev Kit Extension
8187

8288
For C# development using VSCode, it's recommended to use the official *C# Dev Kit* extension provided by Microsoft. Installing this extension will add additional features to VSCode such as a project system and *Solution Explorer* for C# projects. It also provides code editing features such as syntax highlighting, code completion, code navigation, refactoring, NuGet package management, and debugging tools.
@@ -105,7 +111,13 @@ To install it, with VSCode open:
105111

106112
*Effect* (shader) compilation requires access to DirectX. This means it will not work natively on macOS and Linux systems, but it can be used through [WINE](https://www.winehq.org/). MonoGame provides a setup script that can be executed to setup the WINE environment. Below you can find the steps based on your operating system. To do this, follow the instructions for your operating system below:
107113

108-
### macOS
114+
### [Windows](#tab/windows)
115+
116+
> [!NOTE]
117+
> Setting up WINE for effect compilation is not required for Windows
118+
119+
### [macOS](#tab/macos)
120+
109121
Open a new *Terminal* window and enter execute the following commands:
110122

111123
```sh
@@ -114,7 +126,11 @@ brew install --cask wine-stable
114126
wget -qO- https://monogame.net/downloads/net8_mgfxc_wine_setup.sh | bash
115127
```
116128

117-
### Linux
129+
> [!NOTE]
130+
> After performing these steps, a new directory called *.winemonogame* will be created in your home directory. If you ever wish to undo the setup this script performed, you can just simply delete this directory.
131+
132+
### [Linux](#tab/linux)
133+
118134
Open a new *Terminal* window and execute the following commands:
119135

120136
```sh
@@ -123,7 +139,9 @@ wget -qO- https://monogame.net/downloads/net8_mgfxc_wine_setup.sh | bash
123139
```
124140

125141
> [!NOTE]
126-
> After performing these steps, regardless of macOS or Linux, a new directory called *.winemonogame* will be created in your home directory. If you ever wish to undo the setup this script performed, you can just simply delete this directory.
142+
> After performing these steps, a new directory called *.winemonogame* will be created in your home directory. If you ever wish to undo the setup this script performed, you can just simply delete this directory.
143+
144+
---
127145

128146
## Creating Your First MonoGame Application
129147

0 commit comments

Comments
 (0)