Skip to content

Commit adf8fb6

Browse files
Use consistent image widths on entire getting started page and some support pages
1 parent 858442d commit adf8fb6

File tree

5 files changed

+43
-43
lines changed

5 files changed

+43
-43
lines changed

documentation/asciidoc/computers/getting-started/configuring.adoc

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,11 @@ First, unplug your Raspberry Pi's power supply to ensure that the Raspberry Pi i
66
If you installed the operating system on a microSD card, you can plug it into your Raspberry Pi's card slot now.
77
If you installed the operating system on any other storage device, you can connect it to your Raspberry Pi now.
88

9-
image::images/peripherals/sd-card.png[alt="Inserting a microSD card into a Raspberry Pi."]
9+
image::images/peripherals/sd-card.png[alt="Inserting a microSD card into a Raspberry Pi.",width="80%"]
1010

1111
Then, plug in any other peripherals, such as your mouse, keyboard, and monitor.
1212

13-
image::images/peripherals/cable-all.png[alt="Attaching the power supply to a Raspberry Pi."]
13+
image::images/peripherals/cable-all.png[alt="Attaching the power supply to a Raspberry Pi.",width="80%"]
1414

1515
Finally, connect the power supply to your Raspberry Pi. You should see the status LED light up when your Pi powers on. If your Pi is connected to a display, you should see the boot screen within minutes.
1616

@@ -26,7 +26,7 @@ If your Raspberry Pi does not boot within 5 minutes, check the status LED. If it
2626

2727
If you chose to skip OS customisation in Imager, your Raspberry Pi will run a configuration wizard on first boot. You need a monitor and keyboard to navigate through the wizard; a mouse is optional.
2828

29-
image::images/initial-setup/start.png[alt="Click Next to get started with configuration."]
29+
image::images/initial-setup/start.png[alt="Click Next to get started with configuration.",width="80%"]
3030

3131
=== Bluetooth
3232

@@ -38,50 +38,50 @@ This process works with built-in or external USB Bluetooth adapters. If you use
3838

3939
This page helps you configure your country, language, and time zone, and keyboard layout.
4040

41-
image::images/initial-setup/locale.png[alt="Adjust country, language, time zone, and keyboard layout."]
41+
image::images/initial-setup/locale.png[alt="Adjust country, language, time zone, and keyboard layout.",width="80%"]
4242

4343
=== User
4444

4545
This page helps you configure the username and password for the default user account.
4646

4747
By default, older versions of Raspberry Pi OS set the username to "pi". If you use the username "pi", avoid the old default password of "raspberry" to keep your Raspberry Pi secure.
4848

49-
image::images/initial-setup/user.png[alt="Create your username and password."]
49+
image::images/initial-setup/user.png[alt="Create your username and password.",width="80%"]
5050

5151
=== Wi-Fi
5252

5353
This page helps you connect to a Wi-Fi network. Choose your preferred network from the list.
5454

55-
image::images/initial-setup/network.png[alt="Selecting a wireless network."]
55+
image::images/initial-setup/network.png[alt="Selecting a wireless network.",width="80%"]
5656

5757
If your network requires a password, you can enter it here.
5858

59-
image::images/initial-setup/network_password.png[alt="Entering a password for a wireless network."]
59+
image::images/initial-setup/network_password.png[alt="Entering a password for a wireless network.",width="80%"]
6060

6161
=== Browser
6262

6363
This page lets you select Firefox or Chromium as your default internet browser. You can optionally uninstall the browser you don't set as default.
6464

65-
image::images/initial-setup/browser.png[alt="The Choose Browser page."]
65+
image::images/initial-setup/browser.png[alt="The Choose Browser page.",width="80%"]
6666

6767
=== Raspberry Pi Connect
6868

6969
This page lets you enable xref:../services/connect.adoc[Raspberry Pi Connect], which provides the ability to access your Raspberry Pi remotely with no manual network configuration.
7070

71-
image::images/initial-setup/connect.png[alt="The Enable Raspberry Pi Connect page."]
71+
image::images/initial-setup/connect.png[alt="The Enable Raspberry Pi Connect page.",width="80%"]
7272

7373
=== Software updates
7474

7575
Once your Raspberry Pi has internet access, this page helps you update your operating system and software to the latest versions. During the software update process, the wizard will remove the non-default browser if you opted to uninstall it in the browser selection step. Downloading updates may take several minutes.
7676

77-
image::images/initial-setup/update.png[alt="You can download the latest software updates during the wizard before you boot for the first time."]
77+
image::images/initial-setup/update.png[alt="You can download the latest software updates during the wizard before you boot for the first time.",width="80%"]
7878

79-
image::images/initial-setup/download.png[alt="You can download the latest software updates during the wizard before you boot for the first time."]
79+
image::images/initial-setup/download.png[alt="You can download the latest software updates during the wizard before you boot for the first time.",width="80%"]
8080

8181
When you see a popup indicating that your system is up to date, click **OK** to proceed to the next step.
8282

8383
=== Finish
8484

8585
At the end of the configuration wizard, click **Restart** to reboot your Raspberry Pi. Your Raspberry Pi will apply your configuration and boot to the desktop.
8686

87-
image::images/initial-setup/restart.png[alt="The Setup Complete dialogue prompts to restart your Raspberry Pi."]
87+
image::images/initial-setup/restart.png[alt="The Setup Complete dialogue prompts to restart your Raspberry Pi.",width="80%"]

documentation/asciidoc/computers/getting-started/install.adoc

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -34,25 +34,25 @@ You can install Imager in the following ways:
3434

3535
Once you've installed Imager, launch the application by clicking the Raspberry Pi Imager icon or running `rpi-imager`.
3636

37-
image::images/imager/welcome.png[alt="Raspberry Pi Imager main window."]
37+
image::images/imager/welcome.png[alt="Raspberry Pi Imager main window.",width="80%"]
3838

3939
Click **Choose device** and select your Raspberry Pi model from the list.
4040

41-
image::images/imager/choose-model.png[alt="Raspberry Pi model selections in Imager."]
41+
image::images/imager/choose-model.png[alt="Raspberry Pi model selections in Imager.",width="80%"]
4242

4343
Next, click **Choose OS** and select an operating system to install. Imager always shows the recommended version of Raspberry Pi OS for your model at the top of the list.
4444

45-
image::images/imager/choose-os.png[alt="Operating system selections in Imager."]
45+
image::images/imager/choose-os.png[alt="Operating system selections in Imager.",width="80%"]
4646

4747
Connect your preferred storage device to your computer. For example, plug a microSD card in using an external or built-in SD card reader. Then, click **Choose storage** and select your storage device.
4848

4949
WARNING: If you have more than one storage device connected to your computer, _be sure to choose the correct device!_ You can often identify storage devices by size. If you're unsure, disconnect other devices until you've identified the device you want to image.
5050

51-
image::images/imager/choose-storage.png[alt="Storage selection options in Imager."]
51+
image::images/imager/choose-storage.png[alt="Storage selection options in Imager.",width="80%"]
5252

5353
Next, click **Next**.
5454

55-
image::images/imager/os-customisation-prompt.png[alt="Imager prompt to open OS customisation menu."]
55+
image::images/imager/os-customisation-prompt.png[alt="Imager prompt to open OS customisation menu.",width="80%"]
5656

5757
In a popup, Imager will ask you to apply OS customisation. We strongly recommend configuring your Raspberry Pi via the OS customisation settings. Click the **Edit Settings** button to open xref:getting-started.adoc#advanced-options[OS customisation].
5858

@@ -80,7 +80,7 @@ The **wireless LAN** option allows you to enter an SSID (name) and password for
8080

8181
The **locale settings** option allows you to define the time zone and default keyboard layout for your Pi.
8282

83-
image::images/imager/os-customisation-general.png[alt="General settings in the OS customisation menu."]
83+
image::images/imager/os-customisation-general.png[alt="General settings in the OS customisation menu.",width="80%"]
8484

8585
The **Services** tab includes settings to help you connect to your Raspberry Pi remotely.
8686

@@ -90,11 +90,11 @@ If you plan to use your Raspberry Pi remotely over your network, check the box n
9090

9191
* Choose **Allow public-key authentication only** to preconfigure your Raspberry Pi for passwordless public-key SSH authentication using a private key from the computer you're currently using. If already have an RSA key in your SSH configuration, Imager uses that public key. If you don't, you can click **Run SSH-keygen** to generate a public/private key pair. Imager will use the newly-generated public key.
9292

93-
image::images/imager/os-customisation-services.png[alt="Services settings in the OS customisation menu."]
93+
image::images/imager/os-customisation-services.png[alt="Services settings in the OS customisation menu.",width="80%"]
9494

9595
OS customisation also includes an **Options** menu that allows you to configure the behaviour of Imager during a write. These options allow you to play a noise when Imager finishes verifying an image, to automatically unmount storage media after verification, and to disable telemetry.
9696

97-
image::images/imager/os-customisation-options.png[alt="Options in the OS customisation menu."]
97+
image::images/imager/os-customisation-options.png[alt="Options in the OS customisation menu.",width="80%"]
9898

9999
==== Write
100100

@@ -104,19 +104,19 @@ Then, click **Yes** to apply OS customisation settings when you write the image
104104

105105
Finally, respond **Yes** to the "Are you sure you want to continue?" popup to begin writing data to the storage device.
106106

107-
image::images/imager/are-you-sure.png[alt="Confirming a reimage of a storage device in Imager."]
107+
image::images/imager/are-you-sure.png[alt="Confirming a reimage of a storage device in Imager.",width="80%"]
108108

109109
If you see an admin prompt asking for permissions to read and write to your storage medium, grant Imager the permissions to proceed.
110110

111111
.Grab a cup of coffee or go for a walk. This could take a few minutes.
112-
image::images/imager/writing.png[alt="Writing an image to a device in Imager."]
112+
image::images/imager/writing.png[alt="Writing an image to a device in Imager.",width="80%"]
113113

114114
.If you want to live especially dangerously, you can click **cancel verify** to skip the verification process.
115-
image::images/imager/stop-ask-verify.png[alt="Verifying an image on a device in Imager."]
115+
image::images/imager/stop-ask-verify.png[alt="Verifying an image on a device in Imager.",width="80%"]
116116

117117
When you see the "Write Successful" popup, your image has been completely written and verified. You're now ready to boot a Raspberry Pi from the storage device!
118118

119-
image::images/imager/finished.png[alt="The screen Imager shows when it finishes writing an image to a storage device."]
119+
image::images/imager/finished.png[alt="The screen Imager shows when it finishes writing an image to a storage device.",width="80%"]
120120

121121
Next, proceed to the xref:getting-started.adoc#configuration-on-first-boot[first boot configuration instructions] to get your Raspberry Pi up and running.
122122

@@ -143,18 +143,18 @@ To launch Network Install, power on your Raspberry Pi _while pressing and holdin
143143
* attached keyboard
144144
* attached compatible storage device, such as an SD card or USB storage
145145

146-
image::images/network-install-1.png[alt="The Network Install screen."]
146+
image::images/network-install-1.png[alt="The Network Install screen.",width="80%"]
147147

148148
If you haven't already connected your Raspberry Pi to the internet, connect it with an Ethernet cable.
149149

150-
image::images/network-install-2.png[alt="Starting Network Install."]
150+
image::images/network-install-2.png[alt="Starting Network Install.",width="80%"]
151151

152152
Once you're connected to the internet, your Raspberry Pi will download Raspberry Pi installer. If the download fails, you can repeat the process to try again.
153153

154-
image::images/network-install-3.png[alt="Downloading Imager using Network Install."]
154+
image::images/network-install-3.png[alt="Downloading Imager using Network Install.",width="80%"]
155155

156156
Once you finish downloading Raspberry Pi Installer, your Raspberry Pi will automatically start Raspberry Pi Imager. For more information about running Raspberry Pi Imager, see xref:getting-started.adoc#installing-the-operating-system[install an operating system].
157157

158-
image::images/network-install-4.png[alt="Choose a storage device."]
158+
image::images/network-install-4.png[alt="Choose a storage device.",width="80%"]
159159

160160
For more information about Network Install configuration, see xref:raspberry-pi.adoc#http-boot[HTTP boot].

documentation/asciidoc/computers/getting-started/setting-up.adoc

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ You can use any high-quality power supply that provides the correct power mode.
5151
|https://www.raspberrypi.com/products/micro-usb-power-supply/[12.5W Micro USB power supply]
5252
|===
5353

54-
image::images/peripherals/cable-power.png[alt="Plugging a power supply into a Raspberry Pi."]
54+
image::images/peripherals/cable-power.png[alt="Plugging a power supply into a Raspberry Pi.",width="80%"]
5555

5656
Plug your power supply into the port marked "POWER IN", "PWR IN", or "PWR". Some Raspberry Pi models, such as the Zero series, have output USB ports with the same form factor as the power port. Be sure to use the correct port on your Raspberry Pi!
5757

@@ -62,7 +62,7 @@ Raspberry Pi models lack onboard storage, so you have to supply it. You can boot
6262

6363
All Raspberry Pi consumer models since the Raspberry Pi 1 Model A+ feature a microSD slot. Your Raspberry Pi automatically boots from the microSD slot when the slot contains a card.
6464

65-
image::images/peripherals/sd-card.png[alt="Inserting a microSD card into a Raspberry Pi."]
65+
image::images/peripherals/sd-card.png[alt="Inserting a microSD card into a Raspberry Pi.",width="80%"]
6666

6767
==== Recommended SD cards
6868

@@ -84,13 +84,13 @@ Other operating systems have different requirements. Check the documentation for
8484

8585
You can use any of the USB ports on your Raspberry Pi to connect a https://www.raspberrypi.com/products/raspberry-pi-keyboard-and-hub/[wired keyboard] or USB Bluetooth receiver.
8686

87-
image:images/peripherals/cable-key.png[alt="Plugging a keyboard into a Raspberry Pi."]
87+
image:images/peripherals/cable-key.png[alt="Plugging a keyboard into a Raspberry Pi.",width="80%"]
8888

8989
=== Mouse
9090

9191
You can use any of the USB ports on your Raspberry Pi to connect a https://www.raspberrypi.com/products/raspberry-pi-mouse/[wired mouse] or USB Bluetooth receiver.
9292

93-
image:images/peripherals/cable-mouse.png[alt="Plugging a mouse into a Raspberry Pi."]
93+
image:images/peripherals/cable-mouse.png[alt="Plugging a mouse into a Raspberry Pi.",width="80%"]
9494

9595
=== Display
9696

@@ -129,7 +129,7 @@ If your Raspberry Pi has more than one HDMI port, plug your primary monitor into
129129

130130
Most displays don't have micro or mini HDMI ports. However, you can use a https://www.raspberrypi.com/products/micro-hdmi-to-standard-hdmi-a-cable/[micro-HDMI-to-HDMI cable] or https://www.raspberrypi.com/products/standard-hdmi-a-male-to-mini-hdmi-c-male-cable/[mini-HDMI-to-HDMI cable] to connect those ports on your Raspberry Pi to any HDMI display. For displays that don't support HDMI, consider an adapter that translates display output from HDMI to a port supported by your display.
131131

132-
image::images/peripherals/cable-hdmi.png[alt="Plugging a micro HDMI cable into a Raspberry Pi."]
132+
image::images/peripherals/cable-hdmi.png[alt="Plugging a micro HDMI cable into a Raspberry Pi.",width="80%"]
133133

134134
=== Audio
135135

@@ -148,4 +148,4 @@ The following Raspberry Pi models come with Wi-Fi and Bluetooth connectivity:
148148

149149
The "Model B" suffix indicates variants with an Ethernet port; "Model A" indicates no Ethernet port. If your Raspberry Pi doesn't have an Ethernet port, you can still connect to a wired internet connection using a USB-to-Ethernet adapter.
150150

151-
image::images/peripherals/cable-net.png[alt="Plugging an Ethernet cable into a Raspberry Pi."]
151+
image::images/peripherals/cable-net.png[alt="Plugging an Ethernet cable into a Raspberry Pi.",width="80%"]

documentation/asciidoc/computers/getting-started/wrapping-up.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Now that your Raspberry Pi is set up and ready to go, what's next?
66

77
Raspberry Pi OS comes with many essential applications pre-installed so you can start using them straight away. If you'd like to take advantage of other applications we find useful, click the raspberry icon in the top left corner of the screen. Select **Preferences > Recommended Software** from the drop-down menu, and you'll find the package manager. You can install a wide variety of recommended software here for free.
88

9-
image::images/recommended-software.png[Opening the package manager GUI in Raspberry Pi OS]
9+
image::images/recommended-software.png[alt="Opening the package manager GUI in Raspberry Pi OS",width="80%"]
1010

1111
For example, if you plan to use your Raspberry Pi as a home computer, you might find LibreOffice useful for writing and editing documents and spreadsheets. You can also make your Raspberry Pi more accessible with apps like a screen magnifier and Orca screen reader, found under Universal Access.
1212

documentation/asciidoc/computers/remote-access/vnc.adoc

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,13 @@ TIP: Once enabled, you can access your WayVNC configuration at `/etc/wayvnc/`.
2525
. Select *Preferences* > *Raspberry Pi Configuration* from the menu.
2626
+
2727
--
28-
image::images/raspberry-pi-configuration.png[Select Raspberry Pi Configuration from the Preferences menu in the system tray]
28+
image::images/raspberry-pi-configuration.png[alt="Select Raspberry Pi Configuration from the Preferences menu in the system tray",width="80%"]
2929
--
3030
. Navigate to the *Interfaces* tab.
3131
. Click the radio button next to *VNC* into the active position.
3232
+
3333
--
34-
image::images/vnc-enable.png[In the Interfaces tab, click the VNC toggle into the active position to enable VNC.]
34+
image::images/vnc-enable.png[alt="In the Interfaces tab, click the VNC toggle into the active position to enable VNC.",width="80%"]
3535
--
3636
. Click the *OK* button to save your configuration changes.
3737

@@ -65,31 +65,31 @@ If you don't know the IP address of your device, see xref:remote-access.adoc#ip-
6565
. In the "VNC server" field, enter the IP address of your Raspberry Pi.
6666
+
6767
--
68-
image::images/vnc-tigervnc-enter-ip.png[Entering the Raspberry Pi's local IP address into TigerVNC,400]
68+
image::images/vnc-tigervnc-enter-ip.png[alt="Entering the Raspberry Pi's local IP address into TigerVNC",width="60%"]
6969
--
7070
. Click the "Options" button. Navigate to the "Input" tab. Check the box next to "Show dot when no cursor" to ensure that you can always see a cursor in TigerVNC.
7171
+
7272
--
73-
image::images/vnc-tigervnc-show-dot.png[TigerVNC option to render the cursor at all times as a dot,400]
73+
image::images/vnc-tigervnc-show-dot.png[alt="TigerVNC option to render the cursor at all times as a dot",width="60%"]
7474
--
7575
. Click the "Connect" button to initiate a connection with the server.
7676
* If TigerVNC warns you that the "Hostname does not match the server certificate", click the "Yes" button to continue.
7777
+
7878
--
79-
image::images/vnc-tigervnc-cert-warning.png[TigerVNC warning about mismatched certificates,400]
79+
image::images/vnc-tigervnc-cert-warning.png[alt=TigerVNC warning about mismatched certificates",width="60%"]
8080
--
8181
* If TigerVNC warns you that the "certificate has been signed by an unknown authority", click the "Yes" button to grant an exception for your Raspberry Pi.
8282
+
8383
--
84-
image::images/vnc-tigervnc-cert-signer-warning.png[TigerVNC warning about certificates signed by an unknown authority,400]
84+
image::images/vnc-tigervnc-cert-signer-warning.png[alt="TigerVNC warning about certificates signed by an unknown authority",width="60%"]
8585
--
8686
. When prompted for a username and password, enter your credentials.
8787
+
8888
--
89-
image::images/vnc-tigervnc-username-password.png[Entering a username and password to authenticate via TigerVNC,400]
89+
image::images/vnc-tigervnc-username-password.png[alt="Entering a username and password to authenticate via TigerVNC",width="60%"]
9090
--
9191
. Click the "OK" button to authenticate with the VNC server. If your credentials are correct, TigerVNC should open a window containing the desktop corresponding to your account on the Raspberry Pi. You should be able to move your mouse and keyboard to input text and interact with the desktop.
9292
+
9393
--
94-
image::images/vnc-tigervnc-desktop.png[The desktop of a Raspberry Pi after successfully authenticating with TigerVNC]
94+
image::images/vnc-tigervnc-desktop.png[alt="The desktop of a Raspberry Pi after successfully authenticating with TigerVNC",width="60%"]
9595
--

0 commit comments

Comments
 (0)