diff --git a/configuration/configuring-date-and-time/en.md b/configuration/configuring-date-and-time/en.md index fb0a5d8..83b09f2 100755 --- a/configuration/configuring-date-and-time/en.md +++ b/configuration/configuring-date-and-time/en.md @@ -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. \ No newline at end of file +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. diff --git a/configuration/configuring-default-applications/en.md b/configuration/configuring-default-applications/en.md index 77ab31b..1d00c2f 100755 --- a/configuration/configuring-default-applications/en.md +++ b/configuration/configuring-default-applications/en.md @@ -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 \ No newline at end of file +- Web browser diff --git a/configuration/configuring-keyboard-layout/en.md b/configuration/configuring-keyboard-layout/en.md index 16e7929..eafc622 100755 --- a/configuration/configuring-keyboard-layout/en.md +++ b/configuration/configuring-keyboard-layout/en.md @@ -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. \ No newline at end of file +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. diff --git a/configuration/configuring-mouse-and-touchpad/en.md b/configuration/configuring-mouse-and-touchpad/en.md index f76d7cf..e085021 100755 --- a/configuration/configuring-mouse-and-touchpad/en.md +++ b/configuration/configuring-mouse-and-touchpad/en.md @@ -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. \ No newline at end of file +You can test your settings by clicking the Test Your Settings button in the top right of the window. diff --git a/configuration/managing-users/en.md b/configuration/managing-users/en.md index eda6d82..07561f3 100755 --- a/configuration/managing-users/en.md +++ b/configuration/managing-users/en.md @@ -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 other’s 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 user’s 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 user’s account. -{{< altimg "keep-files-prompt.jpg" "help-center/configuration/managing-users/" >}} \ No newline at end of file +{{< altimg "keep-files-prompt.jpg" "help-center/configuration/managing-users/" >}} diff --git a/contributing/getting-involved/en.md b/contributing/getting-involved/en.md index 7652266..c25a38b 100755 --- a/contributing/getting-involved/en.md +++ b/contributing/getting-involved/en.md @@ -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 diff --git a/hardware/ios-support/en.md b/hardware/ios-support/en.md index 5be5382..0aba216 100644 --- a/hardware/ios-support/en.md +++ b/hardware/ios-support/en.md @@ -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 diff --git a/imgs/common-tasks/browsing-the-web/firefox.jpg b/imgs/common-tasks/browsing-the-web/firefox.jpg index 7579e7e..448d438 100644 Binary files a/imgs/common-tasks/browsing-the-web/firefox.jpg and b/imgs/common-tasks/browsing-the-web/firefox.jpg differ diff --git a/imgs/installation/preparing-to-install/mac-burn-dvd.jpg b/imgs/installation/preparing-to-install/mac-burn-dvd.jpg new file mode 100644 index 0000000..3d3e9da Binary files /dev/null and b/imgs/installation/preparing-to-install/mac-burn-dvd.jpg differ diff --git a/imgs/installation/preparing-to-install/mac-etcher.jpg b/imgs/installation/preparing-to-install/mac-etcher.jpg new file mode 100644 index 0000000..cd2e7b2 Binary files /dev/null and b/imgs/installation/preparing-to-install/mac-etcher.jpg differ diff --git a/installation/preparing-to-install/en.md b/installation/preparing-to-install/en.md index 85f8dcb..a614903 100755 --- a/installation/preparing-to-install/en.md +++ b/installation/preparing-to-install/en.md @@ -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 you’ll 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 Mac’s 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 you’ll 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`. \ No newline at end of file +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". diff --git a/software/virtualbox/en.md b/software/virtualbox/en.md index 9368ef0..f06f1c8 100644 --- a/software/virtualbox/en.md +++ b/software/virtualbox/en.md @@ -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.