diff options
| author | bt <bt@btxx.org> | 2024-06-08 13:22:19 -0400 |
|---|---|---|
| committer | bt <bt@btxx.org> | 2024-06-08 13:22:19 -0400 |
| commit | dcfb172704f3afb68a30425029ec834be2883274 (patch) | |
| tree | 02ac480745db802d7af03f3213a0c568322170e3 /build/windows | |
| parent | e146f8a64c793c337999ce316b16ebe5fe6f2dab (diff) | |
More content porting, on-going markdown changes for lowdown support
Diffstat (limited to 'build/windows')
| -rw-r--r-- | build/windows/index.html | 112 |
1 files changed, 47 insertions, 65 deletions
diff --git a/build/windows/index.html b/build/windows/index.html index 215ecce..fa8e0e6 100644 --- a/build/windows/index.html +++ b/build/windows/index.html @@ -1,89 +1,71 @@ <!doctype html> -<html lang="en" id="top"> +<html lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="icon" href="data:,"> <title>Setting Up Jekyll on Windows
</title> - <link href="https://bt.ht/atom.xml" type="application/atom+xml" rel="alternate" title="Atom feed for blog posts" /> - <style>*{box-sizing:border-box;}body{font-family:sans-serif;margin:0 auto;max-width:650px;padding:1rem;}img{max-width:100%;}pre{overflow:auto;}table{text-align:left;width:100%;}</style> + <link href="/atom.xml" type="application/atom+xml" rel="alternate" title="Atom feed for blog posts" /> + <link href="/rss.xml" type="application/rss+xml" rel="alternate" title="RSS feed for blog posts" /> +<style>*{box-sizing:border-box;}body{font-family:sans-serif;line-height:1.33;margin:0 auto;max-width:650px;padding:1rem;}img{max-width:100%;}pre{border:1px solid;overflow:auto;padding:5px;}table{text-align:left;width:100%;}.footnotes{font-size:90%;}</style> </head> <nav> - <a href="#menu">Menu ↓</a> + <a href="#menu">Menu ↓</a> </nav> <main> -<h1>Setting Up Jekyll on Windows
</h1> -<p>
-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.
-
-</p> -<h2>WSL
</h2> -<p>
-The first step involves installing <a href="https://docs.microsoft.com/en-us/windows/wsl/install">WSL</a> 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:
-
</p> +<h1 id="setting-up-jekyll-on-windows">Setting Up Jekyll on Windows</h1> + +<p>2022-09-02</p> + +<p>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…</p> + +<p>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.</p> + +<p>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.</p> + +<h2 id="wsl">WSL</h2> + +<p>The first step involves installing <a href="https://docs.microsoft.com/en-us/windows/wsl/install">WSL</a> 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:</p> <ol> -<li>Opening PowerShell or Command Prompt as an administrator
</li> -<li>Installing via the command: <code>wsl --install</code>
</li> -<li>Restarting your machine after the install completes
</li> -<li>Creating your UNIX username and password
</li> +<li>Opening PowerShell or Command Prompt as an administrator</li> +<li>Installing via the command: <code>wsl --install</code></li> +<li>Restarting your machine after the install completes</li> +<li>Creating your UNIX username and password</li> </ol> -<p>
-</p> -<h2>Installing Ruby & Dependencies
</h2> -<p>
-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 <code>rvm</code> and the <a href="https://github.com/rvm/ubuntu_rvm">official project documentation</a> does a very good job of walking you through this.
-
</p> -<ul> -<li>Be sure dependencies as installed: <code>sudo apt-get install software-properties-common</code>
</li> -<li>Add the PPA and install the package:
</li> -</ul> -<p>
-
-</p> -<pre><code>sudo apt-add-repository -y ppa:rael-gc/rvm
-sudo apt-get update
-sudo apt-get install rvm
-</code></pre> -<p>
-
</p> +<h2 id="installing-ruby-dependencies">Installing Ruby & Dependencies</h2> + +<p>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 <code>rvm</code> and the <a href="https://github.com/rvm/ubuntu_rvm">official project documentation</a> does a very good job of walking you through this.</p> <ul> -<li>Add your existing user to the <code>rvm</code> group: <code>sudo usermod -a -G rvm $USER</code>
</li> +<li><p>Be sure dependencies as installed: <code>sudo apt-get install software-properties-common</code></p></li> +<li><p>Add the PPA and install the package:</p> + +<p>sudo apt-add-repository -y ppa:rael-gc/rvm +sudo apt-get update +sudo apt-get install rvm</p></li> +<li><p>Add your existing user to the <code>rvm</code> group: <code>sudo usermod -a -G rvm $USER</code></p></li> </ul> -<p>
-You will need to close and restart your session to your Ubuntu system for these changes to take. After that, we can use <code>rvm</code> to install the latest version (at this time of writing) of ruby:
-
-
-</p> -<pre><code>rvm install 3.1.2
+ +<p>You will need to close and restart your session to your Ubuntu system for these changes to take. After that, we can use <code>rvm</code> to install the latest version (at this time of writing) of ruby:</p> + +<pre><code>rvm install 3.1.2 </code></pre> -<p>
-
-That's it!
-
-</p> -<h2>Jekyll - Finally!
</h2> -<p>
-The final step is to update our gems and install Jekyll:
-
-
-</p> -<pre><code>gem update
-gem install jekyll bundler
+ +<p>That’s it!</p> + +<h2 id="jekyll---finally">Jekyll - Finally!</h2> + +<p>The final step is to update our gems and install Jekyll:</p> + +<pre><code>gem update +gem install jekyll bundler </code></pre> -<p>
-
-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!
</p> + +<p>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!</p> <footer role="contentinfo"> <h2>Menu Navigation</h2> <ul id="menu"> |