From 6b742c459266b18e2b375b35205ce8a6c02f0452 Mon Sep 17 00:00:00 2001 From: Bradley Taunt Date: Thu, 6 Jun 2024 08:05:12 -0400 Subject: Initial commit --- build/windows/index.html | 107 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 107 insertions(+) create mode 100644 build/windows/index.html (limited to 'build/windows') diff --git a/build/windows/index.html b/build/windows/index.html new file mode 100644 index 0000000..215ecce --- /dev/null +++ b/build/windows/index.html @@ -0,0 +1,107 @@ + + + + + + + Setting Up Jekyll on Windows + + + + + + +
+

Setting Up Jekyll on Windows

+

+2022-09-02 + +I've recently been playing around with using Windows 10 as my daily operating system. So far, it has been going fairly well. Nothing will probably ever feel as "optimized" as running a Linux-based system but it works well for my current needs. Getting a Jekyll development environment setup was a different story though... + +One of the first issues with using Windows 10 is the need to run a few of my open source projects that are built off Jekyll locally. This process initially seemed a like complex process to get things running smoothly but in the end was very straightforward. The main issue came from needing to bounce around through a handful of separate tutorials to get everything running smoothly. + +So, I thought I would make this quick write-up to help those in the same situation (or even for my future self the need arises). Let's get into it. + +

+

WSL

+

+The first step involves installing WSL in order to run Linux alongside the main Windows OS. The documentation is well written and will get you up-and-running in no time. For quick reference, it essentially comes down to: +

+ +
    +
  1. Opening PowerShell or Command Prompt as an administrator
    2. +
  2. Installing via the command: wsl --install
    3. +
  3. Restarting your machine after the install completes
    4. +
  4. Creating your UNIX username and password
    5. +
+

+

+

Installing Ruby & Dependencies

+

+Once logged into your UNIX terminal session (with your created user) you can begin installing everything we need for Jekyll to work properly. The first step is to installing rvm and the official project documentation does a very good job of walking you through this. +

+ + +

+ +

+
sudo apt-add-repository -y ppa:rael-gc/rvm
+sudo apt-get update
+sudo apt-get install rvm
+
+

+

+ + +

+You will need to close and restart your session to your Ubuntu system for these changes to take. After that, we can use rvm to install the latest version (at this time of writing) of ruby: + + +

+
rvm install 3.1.2
+
+

+ +That's it! + +

+

Jekyll - Finally!

+

+The final step is to update our gems and install Jekyll: + + +

+
gem update
+gem install jekyll bundler
+
+

+ +Once complete you can now run your Jekyll projects locally through WSL! Nothing ground-breaking but still pretty helpful for first-time users. And best of all, at least I have a good reference point in the future if I ever run into this issue again!

+ \ No newline at end of file -- cgit v1.2.3-54-g00ecf