Skip to content

Commit

Permalink
style: fix all supported markdownlint violations
Browse files Browse the repository at this point in the history
  • Loading branch information
César Román committed Sep 24, 2021
1 parent 165404e commit 14236c4
Show file tree
Hide file tree
Showing 22 changed files with 195 additions and 124 deletions.
2 changes: 1 addition & 1 deletion _posts/2020-08-30-init.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ tags: [general]

```python
print("Hello World!")
```
```
54 changes: 35 additions & 19 deletions _posts/2020-08-31-welcome.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ I learned about [GitHub Pages](https://pages.github.com/){:target="_blank"} back
So here is a guide on how I got myself started using GitHub pages.

### Table of Contents

1. [Assumptions](#assumptions)
1. [Getting started with GitHub pages](#getting-started-with-github-pages)
1. [Getting rbenv set up on macOS](#getting-rbenv-set-up-on-macos)
Expand Down Expand Up @@ -42,34 +43,45 @@ Just follow these steps:

1. Install Command Line Tools for Xcode ([link](https://developer.apple.com/download/more/?=xcode){:target="_blank"})
1. Install Homebrew

```bash
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
```

1. Install rbenv

```bash
$ brew install rbenv
brew install rbenv
```

1. Set up rbenv integration with your shell

```bash
$ rbenv init
rbenv init
```

1. Add it to your bash profile

```bash
$ echo 'eval "$(rbenv init -)"' >> ~/.zshrc
echo 'eval "$(rbenv init -)"' >> ~/.zshrc
```

1. Restart your shell so the path changes take effect

```bash
$ exec "$SHELL"
exec "$SHELL"
```

1. Check your rbenv installation

```bash
$ curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash
```

### Installing a ruby version and setting a global version with rbenv

1. List stable versions

```bash
$ rbenv install --list
2.5.8
Expand All @@ -81,25 +93,28 @@ Just follow these steps:
rbx-5.0
truffleruby-20.2.0
truffleruby+graalvm-20.2.0
Only latest stable releases for each Ruby implementation are shown.
Use 'rbenv install --list-all' to show all local versions.
```

1. Install your desired version.

```bash
$ rbenv install 2.7.2
rbenv install 2.7.2
```

1. Once installed, list all versions

```bash
$ rbenv versions
rbenv versions
```

1. Select your desired version

```bash
$ rbenv global 2.7.2
$ rbenv rehash
rbenv global 2.7.2
rbenv rehash
```

And you're all set!
Expand All @@ -114,14 +129,14 @@ As of this writing, the latest version for Jekyll is 4.1.1, which is not yet su
To Install Jekyll we need to run the following commands:
```bash
$ gem install bundler
$ gem install jekyll -v 3.9.0
gem install bundler
gem install jekyll -v 3.9.0
```
To verify, run the following commands:
```bash
$ which jekyll
$ which jekyll
/Users/thecesrom/.rbenv/shims/jekyll
$ bundle exec jekyll --version
jekyll 3.9.0
Expand All @@ -138,7 +153,7 @@ The instructions are straightforward; found [here](https://github.com/daattali/b
Once you get it set up, open a Terminal session in your blog's root directory and run the following command:

```bash
$ bundle install
bundle install
```

This will install all necessary dependencies and get you one step closer.
Expand All @@ -148,13 +163,14 @@ This will install all necessary dependencies and get you one step closer.
I am using [Visual Studio Code](https://code.visualstudio.com/){:target="_blank"} for editing my site, but you may use another text editor or IDE out there.

And after some customization I just run:

```bash
$ bundle exec jekyll serve
bundle exec jekyll serve
```

![vscode]({{ site.url }}/assets/img/vscode.png)

And my site is now live at http://127.0.0.1:4000/
And my site is now live at <http://127.0.0.1:4000/>

And this is the final product:

Expand All @@ -170,7 +186,7 @@ Here are a few links and extensions that you might find useful:

- [A Guide To Using GitHub Pages](https://www.thinkful.com/learn/a-guide-to-using-github-pages/){:target="_blank"}. *Thinkful Programming Guides*
- Visual Studio Code extensions:
- docs-markdown ([link](https://marketplace.visualstudio.com/items?itemName=docsmsft.docs-markdown){:target="_blank"})
- docs-preview ([link](https://marketplace.visualstudio.com/items?itemName=docsmsft.docs-preview){:target="_blank"})
- docs-markdown ([link](https://marketplace.visualstudio.com/items?itemName=docsmsft.docs-markdown){:target="_blank"})
- docs-preview ([link](https://marketplace.visualstudio.com/items?itemName=docsmsft.docs-preview){:target="_blank"})

Thanks for reading!
4 changes: 2 additions & 2 deletions _posts/2020-09-04-jekyll-compose-a-must-have-plugin.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,12 @@ end
After successfully installing it, just by typing the following command I get a new drat under the `_drafts` folder:

```bash
$ bundle exec jekyll draft "New Draft"
bundle exec jekyll draft "New Draft"
```

And `jekyll-compose` takes care of properly naming the file, so you can take care of the important stuff.

### Summary:
### Summary

1. Add `jekyll-compose` to your `Gemfile`
1. Execute `bundle` command
Expand Down
2 changes: 1 addition & 1 deletion _posts/2020-09-14-my-journey-into-python.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,4 +65,4 @@ When I started using Python in Ignition, I was only using it for the code behind

Now I have created some packages shared across multiple installations and applied [OOP](https://realpython.com/python3-object-oriented-programming/){:target="_blank"} principles by creating supporting classes in my projects. And in the last four years since I started working with Python, I've learned so much and will continue learning.

I am happy to be writing in Python, and I look forward to many more years.
I am happy to be writing in Python, and I look forward to many more years.
6 changes: 4 additions & 2 deletions _posts/2020-09-16-creating-a-bootable-installer-for-macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,11 @@ And these are the instructions:

1. Download [macOS Catalina](https://apps.apple.com/us/app/macos-catalina/id1466841314?mt=12){:target="_blank"} from the Mac App Store
1. Once downloaded run the following command:

```bash
$ sudo /Applications/Install\ macOS\ Catalina.app/Contents/Resources/createinstallmedia --volume /Volumes/INSTALLER
sudo /Applications/Install\ macOS\ Catalina.app/Contents/Resources/createinstallmedia --volume /Volumes/INSTALLER
```

1. Restart your Mac and press the alt-option key as soon as it restarts, so you are prompted to select a Startup Disk
1. Select the **macOS Catalina Installer**
1. Select **Disk Utility** and click **Continue**
Expand All @@ -41,4 +43,4 @@ And these are the instructions:

Once the installation is done, you'll be asked to configure your Mac.
And that's it! You'll have a "brand new" Mac!
And that's it! You'll have a "brand new" Mac!
38 changes: 24 additions & 14 deletions _posts/2020-09-21-working-with-pyenv-on-macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,26 +12,30 @@ date: 2020-09-21 13:02 -0700
last-updated: 2021-06-07 20:49 -0700
---
## Table of Contents

- [Introduction](#introduction)
- [Pre-requisites](#pre-requisites)
- [Why pyenv?](#why-pyenv)
- [Installing pyenv](#installing-pyenv)
- [Installing Python 3.9](#installing-python-39)
- [Installing Python 2.7](#installing-python-27)
- [Setting a global version of Python](#setting-a-global-version-of-python)
- [Installing Python 3.9](#installing-python-39)
- [Installing Python 2.7](#installing-python-27)
- [Setting a global version of Python](#setting-a-global-version-of-python)
- [Success!](#success)
- [Further reading](#further-reading)
- [Sources](#sources)

## Introduction

This is not meant to be a detailed guide on the many ways you could install Homebrew, and pyenv, but a look into what I did to get my environment set up for my personal projects.

## Pre-requisites

Xcode Command Line Tools ([link](https://developer.apple.com/download/more/?=xcode){:target="_blank"})

Homebrew

```bash
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
```

Let's begin.
Expand All @@ -49,33 +53,38 @@ Before [breathing new life into my MacBook Air]({{ page.previous.url | relative_
## Installing pyenv

Install dependencies

```bash
$ brew install openssl readline sqlite3 xz zlib
brew install openssl readline sqlite3 xz zlib
```

Install pyenv

```bash
$ brew install pyenv
brew install pyenv
```

Load `pyenv` automatically by running the following command to add it to your shell

{: .box-note}
Starting with `pyenv` [v2.0.0](https://github.com/pyenv/pyenv/releases/tag/v2.0.0){:target="_blank"} the `pyenv init` command has changed.

```bash
$ echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init --path)"\nfi' >> ~/.zshrc
echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init --path)"\nfi' >> ~/.zshrc
```

Restart shell

```bash
$ exec "$SHELL"
exec "$SHELL"
```

Next, I'll install specific Python versions.

### Installing Python 3.9

First, let's get a list of all 3.9 versions:

```bash
$ pyenv install --list | grep " 3\.9"
3.9.0
Expand All @@ -90,7 +99,7 @@ $ pyenv install --list | grep " 3\.9"
Installing the latest 3.9 release.

```bash
$ pyenv install 3.9.5
pyenv install 3.9.5
```

### Installing Python 2.7
Expand All @@ -100,7 +109,6 @@ For the [Ignition](https://github.com/thecesrom/Ignition/){:target="_blank"} pro

So, first, I will install Python 2.7.18.


```bash
$ pyenv install --list | grep " 2\.7"
2.7.0
Expand Down Expand Up @@ -131,7 +139,7 @@ Python 2.7 reached its EOL on January 1, 2020. See: [Sunsetting Python 2](https:
Installing the final 2.7 version:

```bash
$ pyenv install 2.7.18
pyenv install 2.7.18
```

### Setting a global version of Python
Expand All @@ -148,7 +156,7 @@ $ pyenv versions
Run `pyenv global <version>` to set the global version of Python to be used in all shells.

```bash
$ pyenv global 3.9.5
pyenv global 3.9.5
```

Verify your selection by running `pyenv versions`.
Expand All @@ -162,15 +170,17 @@ $ pyenv versions

Alternatively, you could [specify multiple versions as global at once](https://github.com/pyenv/pyenv/blob/master/COMMANDS.md#pyenv-global-advanced){:target="_blank"}.

## Success!
## Success

And by doing all of the above I have completed setting up my computer for working on my projects.

Happy coding!

## Further reading

1. pyenv :: Modern Python Developer's Toolkit - [https://pycon.switowski.com/02-packages/pyenv/](https://pycon.switowski.com/02-packages/pyenv/){:target="_blank"}

## Sources

[^1]: pyenv/pyenv: Simple Python version management - [https://github.com/pyenv/pyenv](https://github.com/pyenv/pyenv){:target="_blank"}
[^2]: Managing Multiple Python Versions With pyenv - [https://realpython.com/intro-to-pyenv/](https://realpython.com/intro-to-pyenv/){:target="_blank"}
[^2]: Managing Multiple Python Versions With pyenv - [https://realpython.com/intro-to-pyenv/](https://realpython.com/intro-to-pyenv/){:target="_blank"}
Loading

0 comments on commit 14236c4

Please sign in to comment.