Merge pull request #41 from NeWiBi/master

macOS ISO instructions & other small tweaks.
This commit is contained in:
Joshua Strobl 2017-05-15 05:38:42 +03:00 committed by GitHub
commit 427429c018
12 changed files with 129 additions and 30 deletions

View File

@ -1,10 +1,10 @@
+++
title = "Configuring Date and time"
title = "Configuring Date and Time"
+++
# Configuring Date and time
You can configure the date and time of your system by going to the Budgie Menu, opening the Settings app then going to the Date & Time section.
You can configure the date and time of your system by going to the Budgie Menu, opening the Settings app and then going to the Date & Time section.
{{< altimg "configuring-date-and-time.jpg" "help-center/configuration/configuring-date-and-time/" >}}
You will be presented with the following window. This window provides you the ability to enable / disable automatic date & time, automatic time zone changing, and the time format.
You will be presented with the following window. This window provides you with the ability to enable / disable automatic date & time, automatic time zone changing, and the time format.

View File

@ -9,7 +9,7 @@ Upon entering the Details section, go to Default Applications.
{{< altimg "configuring-default-applications.jpg" "help-center/configuration/configuring-default-applications/" >}}
*Note: In the image above, we've changed the Music player and Video player.*
*Note: In the image above, we've changed the Web browser and Photo viewer.*
You can change default applications for:
@ -18,4 +18,4 @@ You can change default applications for:
- Music player
- Photo viewer
- Video player
- Web browser
- Web browser

View File

@ -19,6 +19,6 @@ After choosing the keyboard layout, click Done. You will be brought back to the
{{< altimg "region-and-languages-newlang.jpg" "help-center/configuration/configuring-keyboard-layout/" >}}
You can remove a keyboard layout by click on one of the items, for instance Swedish, then clicking the `-` button.
You can remove a keyboard layout by clicking on one of the items, for instance Swedish, then clicking the `-` button.
If you wish to use multiple keyboard layouts, you can switch to them by using: `Windows key + Space` or by adding the Keyboard Layout Indicator applet to your Budgie panel.
If you wish to use multiple keyboard layouts, you can switch between them by using: `Windows key + Space` or by adding the Keyboard Layout Indicator applet to your Budgie panel.

View File

@ -3,7 +3,7 @@ title = "Configuring Mouse and Touchpad"
+++
# Configuring Mouse and Touchpad
You can configure the settings of your mouse and/or touchpad by going to the Budgie Menu, opening the Settings app, then clicking the Mouse & Touchpad section. You will be either one of the following windows, depending on the device.
You can configure the settings of your mouse and/or touchpad by going to the Budgie Menu, opening the Settings app, then clicking the Mouse & Touchpad section. You will see either one of the following windows, depending on the device.
## Mouse
@ -29,4 +29,4 @@ For touchpads, you can set:
## Testing
You can test your settings by clicking the Test Your Settings button in the top right of the window.
You can test your settings by clicking the Test Your Settings button in the top right of the window.

View File

@ -6,9 +6,9 @@ title = "Managing Users"
To add and remove users on your Solus system, go to the Budgie Menu, open the Settings app, then go to Users.
{{< altimg "settings-users.jpg" "help-center/configuration/managing-users/" >}}
*Your window should look fairly similar to the one below.*
*Your window should look fairly similar to the one above.*
To manage your or others accounts, you first need to authenticate. Click the Unlock button in the top right corner and type your password. Note that you are required to be an administrator. If you're the only user on
To manage your own or other accounts, you first need to authenticate. Click the Unlock button in the top right corner and type your password. Note that you are required to be an administrator. If you're the only user on
the system, then your account is an administrator by default.
In the event it is correct, the Unlock button will change to Lock and the Add / Remove buttons will be clickable.
@ -23,6 +23,6 @@ To add a user, click the `+` button in the bottom left corner of the Users windo
To remove a user, select the user under the “Other Accounts” section and click the `-` button.
Upon clicking the remove the user, you will be brought to the following window. In this window, you have the option to keep their files, delete the files, or cancel the removal of the users account.
Upon clicking to remove the user, you will be brought to the following window. In this window, you have the option to keep their files, delete their files, or cancel the removal of the users account.
{{< altimg "keep-files-prompt.jpg" "help-center/configuration/managing-users/" >}}
{{< altimg "keep-files-prompt.jpg" "help-center/configuration/managing-users/" >}}

View File

@ -11,11 +11,11 @@ You may view community guidelines [here](/articles/contributing/community-guidel
## Community Forums
With so many new users joining, there are always more people needing help. A great way to help us out, would be to help out our users on the [Solus Project Forums](https://solus-project.com/forums/)
With so many new users joining, there are always more people needing help. A great way to help us out, would be to help out our users on the [Solus Project Forums](https://solus-project.com/forums/).
## Improving Documentation
Our Help Center improves when the documentation improves. If there is articles that you think would be valuable to add, get involved by submitting pull requests to our [Help Center Docs](https://github.com/solus-project/help-center-docs) repo!
Our Help Center improves when the documentation improves. If there are articles that you think would be valuable to add, get involved by submitting pull requests to our [Help Center Docs](https://github.com/solus-project/help-center-docs) repo!
## IRC

View File

@ -20,7 +20,7 @@ You can further check by:
2. Rebooting.
3. Running the following command: `sudo ideviceinfo -q com.apple.mobile.iTunes -k DBVersion` **while your iOS device is plugged in**.
What this command does is queries the device to obtain the version of its database. If the version is **greater than 4**, your device is not capable of synchronizing music and video. You may notice it appear in Files / Nautilus as
What this command does is query the device to obtain the version of its database. If the version is **greater than 4**, your device is not capable of synchronizing music and video. You may notice it appear in Files / Nautilus as
"Documents of DeviceName", however this typically only provides a limited set of data from applications.
## Mounting in Nautilus

Binary file not shown.

Before

Width:  |  Height:  |  Size: 286 KiB

After

Width:  |  Height:  |  Size: 186 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

View File

@ -3,7 +3,7 @@ title = "Preparing to install"
+++
# Preparing to install
The first step to installing Solus is acquiring the correct media. The Solus Project provides ISO images, which contain the contents of the Solus for installing.
The first step to installing Solus is acquiring the correct media. The Solus Project provides ISO images, which contain the contents of Solus for installing.
## Getting the ISO
@ -13,7 +13,7 @@ You can download a Solus ISO by going to our [Download page](/download).
## Getting the Right Tool
There is a multitude of tools enable the writing of our ISO image to DVDs or USB thumb drives. Below, we break it apart across Linux and Windows.
There is a multitude of tools which enable the writing of our ISO image to DVDs or USB thumb drives. Below, we break it apart across Linux, Windows and macOS.
### Linux
@ -41,6 +41,22 @@ You can easily burn an ISO image to a DVD, on Windows 7 and newer, by using Wind
You can easily burn an ISO image to a USB by using graphical tool [Rufus](https://rufus.akeo.ie/).
### macOS
#### DVD
On a Mac, burn an ISO image to a DVD by using the macOS “Finder” file manager, right-clicking on the ISO image file, and clicking “Burn Disk Image”.
#### USB
##### Graphical Tool
One of the easiest ways to burn an ISO image to a USB thumb drive is by using a graphical tool called [Etcher](https://etcher.io/).
##### Command-Line
For those comfortable with the macOS Terminal app, we will walk you through using `dd`.
---
## Writing the ISO
@ -49,7 +65,7 @@ To write the ISO, you will need:
1. Either a blank DVD or a USB drive larger than 1GB.
2. If using a USB, the ability to boot from the USB.
3. ISO from the Getting the ISO section
3. ISO from the "Getting the ISO" section.
### Linux
@ -73,11 +89,11 @@ Upon opening Gnome MultiWriter, you will likely be shown a window similar to the
If your USB drive is not plugged, you will be prompted with an image indicating to plug it in.
Next, click the Start Copying button, and you will be prompted to select the ISO. Choose the ISO you downloaded in the Getting the ISO section. The USB will automatically be written to.
Next, click the "Start Copying" button, and you will be prompted to select the ISO. Choose the ISO you downloaded in the "Getting the ISO" section. The USB will automatically be written to.
{{< altimg "writing.jpg" "help-center/installation/preparing-to-install/" >}}
Upon completion, you will be prompted will the following dialog and your USB is now ready for use.
Upon completion, you will be prompted with the following dialog and your USB is now ready for use.
{{< altimg "done.jpg" "help-center/installation/preparing-to-install/" >}}
@ -85,7 +101,7 @@ Upon completion, you will be prompted will the following dialog and your USB is
Please follow the steps below, which guide you through installation using the utility `dd`:
First, insert your USB drive in your computer and open your Terminal. Proceed to type `lsblk` into your Terminal. It should output something along the lines of:
First, insert the USB drive into your computer and open your Terminal. Proceed to type `lsblk` into your Terminal. It should output something along the lines of:
``` bash
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
@ -106,7 +122,7 @@ If it is **not** in your Downloads folder, use `cd` to navigate to the correct s
**Dangerous Below**
This is where we overwrite the contents of your USB drive so please ensure you identified the current drive in lsblk stage above. My command is below, however you may need to replace sdb with the drive we located above:
This is where we overwrite the contents of your USB drive so please ensure you identified the current drive in the `lsblk` stage above. My command is below, however you may need to replace `sdb` with the drive we located above:
``` bash
sudo dd if=Solus-2017.04.18.0.iso of=/dev/sdb bs=1M;sudo sync;sudo eject /dev/sdb
@ -119,7 +135,7 @@ This will write the contents of the ISO to the thumb drive so you can boot it an
#### DVD
1. Open Window's built-in file manager (Explorer).
2. Right click on the ISO image file and clicking Burn disk image.
2. Right click on the ISO image file and click Burn disk image.
3. Select the correct Disc burner.
4. Click Burn.
@ -133,10 +149,93 @@ This will write the contents of the ISO to the thumb drive so you can boot it an
{{< altimg "rufus.jpg" "help-center/installation/preparing-to-install/" >}}
### macOS
#### DVD
Since OS X El Capitan (10.11), the easiest way to burn a DVD is -
1. Insert your DVD and open Finder.
2. Right click on the ISO image.
3. Click on “Burn Disk Image Solus-2017.04.18.0-Budgie.iso to Disc…”
4. Then click “Burn”.
{{< altimg "mac-burn-dvd.jpg" "help-center/installation/preparing-to-install/" >}}
#### USB
##### Graphical Tool
1. Open Etcher.
2. Click on “Select image” and then select the ISO and click “Open”.
3. Etcher will automatically select your USB drive. If it has selected the wrong one, click “Change” and select the correct one.
4. Click “Flash!”.
5. You may be prompted for your macOS user password.
{{< altimg "mac-etcher.jpg" "help-center/installation/preparing-to-install/" >}}
6. Once Etcher has finished it is safe to remove the USB drive.
You may see a message stating “The disk you inserted was not readable by this computer.” once Etcher finishes, this can be ignored.
##### Command Line
1. First, insert the USB drive into your computer and open Terminal (found in Applications/Utilities).
2. You need to identify your USB drive by listing your storage devices with the following command -
``` bash
diskutil list
```
You should see output similar to this -
``` bash
/dev/disk0 (internal, physical):
#: TYPE NAME SIZE IDENTIFIER
0: GUID_partition_scheme *1.0 TB disk0
1: EFI EFI 209.7 MB disk0s1
2: Apple_HFS Macintosh HD 999.3 GB disk0s2
3: Apple_Boot Recovery HD 650.0 MB disk0s3
/dev/disk1 (external, physical):
#: TYPE NAME SIZE IDENTIFIER
0: GUID_partition_scheme *15.6 GB disk1
1: EFI EFI 209.7 MB disk1s1
2: Apple_HFS Ultra 15.3 GB disk1s2
```
From this output, we can see the USB drive is listed as - `/dev/disk1 (external, physical)`. In this example, the IDENTIFIER is `disk1`. Please note, your USB drive may have a different identifier. You should be able to tell which is your USB drive by checking the name and size.
3. macOS usually auto-mounts USB drives so youll need to unmount it first before proceeding. Use the following command and replace `IDENTIFIER` with the correct identifier we found in step 2.
``` bash
diskutil unmountDisk /dev/IDENTIFIER
```
4. Now navigate to the folder that has the downloaded ISO. This could be your Macs Downloads folder. The following command will get you there -
``` bash
cd ~/Downloads
```
5. **This step is dangerous. Using the wrong drive identifier could result in data loss.** We will use the `dd` command to write the contents of the ISO to the thumb drive. Replace `IDENTIFIER` in the command below with your drive identifier from step 2. Note the extra `r` before the identifier (i.e `rdisk1`). This is for raw mode, which along with bs=1m, makes the transfer faster.
``` bash
sudo dd if=Solus-2017.04.18.0-Budgie.iso of=/dev/rIDENTIFIER bs=1m
```
6. Be patient! After a few minutes youll receive a message saying how much data was transferred. You can now safely eject the usb drive.
``` bash
diskutil eject /dev/IDENTIFIER
```
---
## Boot the Image
Now it is time to restart your computer to boot the DVD or ISO. Most computers will automatically boot from DVDs and USB, however if you experience issues booting the media, you may need to select to boot from DVD or ISO.
Now it is time to restart your computer to boot the DVD or USB. Most computers will automatically boot from DVDs and USB, however if you experience issues booting the media, you may need to select to boot from DVD or USB.
This is usually accessible by pressing `F9` or `F12` while your computer is booting. On some devices it may also be `ESC`.
This is usually accessible by pressing `F9` or `F12` while your computer is booting. On some devices it may also be `ESC`.
Macs will boot to the "Startup Manager" by holding down the Option (Alt) key. The DVD or USB drive will most likely show up as "EFI Boot".

View File

@ -26,12 +26,12 @@ Now, download the [Guest Additions](http://download.virtualbox.org/virtualbox/)
sudo reboot
```
**Note:** For each kernel update you will need to rebuild the Virtualbox Modules. So simply remount the ISO and run the instructions again.
**Note:** For each kernel update you will need to rebuild the VirtualBox Modules. So simply remount the ISO and run the instructions again.
### Clipboard Sharing, Copy&Paste, Drag&Drop
By default, the virtualbox modules for those virtualbox features are not loaded/enabled, therefore the features simply do not work if selected in the Guest.
If you want that this features to work properly automatically, without starting the corresponding VBoxClient yourself, you can use xdg to autostart VBoxClient enabling the features.
By default, the VirtualBox modules for those VirtualBox features are not loaded/enabled, therefore the features simply do not work if selected in the Guest.
If you want that these features do work properly automatically, without starting the corresponding VBoxClient yourself, you can use xdg to autostart VBoxClient thus enabling the features.
/usr/bin/VBoxClient-all:
``` bash
@ -106,4 +106,4 @@ sudo eopkg it linux-lts-headers
sudo sh ~/Downloads/VirtualBox-5.1.22-115126-Linux_amd64.run
```
Replace version number of file with the one you download.
Replace the version number of the file with the one you downloaded.