Installing Ruby & VS Code
Or: Adding PDF Support for AsciiDoc Files.

Thank you for reading this post.
My name is Brian and I'm a developer from New Zealand. I've been interested in computers since the early 1990s. My first language was QBASIC. (Things have changed since the days of MS-DOS.)
I am the managing director of a one-man startup called Digital Core (NZ) Limited. I have accepted the "12 Startups in 12 Months" challenge so that DigitalCore will have income-generating products by April 2024.
This blog will follow the "12 Startups" project during its design, development, and deployment, cover the Agile principles and the DevOps philosophy that is used by the "12 Startups" project, and delve into the world of AI, machine learning, deep learning, prompt engineering, and large language models.
I hope you enjoyed this post and, if you did, I encourage you to explore some others I've written. And remember: The best technologies bring people together.
Abstract.
I document my process for installing Ruby and Visual Studio Code on my Ubuntu Desktop system. I cover the prerequisite system update, the installation commands, and the VS Code extensions and settings I rely on for my daily development workflow.
Attributions:
None for this post.
An Introduction.
I maintain Ubuntu Desktop as my primary development environment. As part of my setup, I install Ruby — a language I use for scripting and system tasks — alongside Visual Studio Code, my preferred editor. This post captures exactly how I set up the tools so I that I have a consistent, and repeatable process for new and re-imaged Ubuntu systems.
The Big Picture.
Ruby gives me a flexible, expressive scripting language that integrates well with my Linux environment, and VS Code provides a lightweight but powerful editor with rich extension support. Together they form the core of my daily toolchain. By laying out every step here, I avoid forgetting a crucial setting or extension when I need to rebuild my environment.
Prerequisites.
Ubuntu Desktop 22.04 LTS or later,
A
sudo-enabled terminal.
Updating my Base System.
- From the terminal, I update my system:
sudo apt clean && \
sudo apt update && \
sudo apt dist-upgrade -y && \
sudo apt --fix-broken install && \
sudo apt autoclean && \
sudo apt autoremove -y
Installing Ruby & VS Code.
- From the terminal, I install Ruby:
sudo apt install -y ruby-full
- I install the AsciiDoctor PDF Gem:
sudo gem install asciidoctor-pdf
- I install VS Code:
sudo snap install code --classic
- I can refresh VS Code, if required:
sudo snap refresh code --classic
Within VS Code, I install the following extensions:
AsciiDoc from AsciiDoctor
Code Spell Checker from Street Side Software
In the Settings for VS Code, I set:
Files: Auto SavetoafterDelayFiles: Auto Save Delayto0(where each change to a file automatically results in that change being saved)Asciidoc › Pdf: Enginetoasciidoctor-pdfAsciidoc › Pdf: Asciidoctor Pdf Command Pathto/usr/local/bin/asciidoctor-pdfC Spell: Languagetoen-GBEditor: Word Wraptoon
The following VS Code settings are OPPOSITE to BEST PRACTICE:
Security › Workspace › Trust: BannertoneverSecurity › Workspace › Trust: Empty Windowtoun-tickSecurity › Workspace › Trust: Enabledtoun-tickSecurity › Workspace › Trust: Startup PrompttoneverSecurity › Workspace › Trust: Untrusted Filestoopen
The Results.
After I run these steps, my system has Ruby and VS Code installed and configured exactly as I need them. The asciidoctor-pdf gem lets me render AsciiDoc documents to PDF directly from within VS Code. My chosen extensions and settings — auto-save with zero delay, the correct PDF engine path, British English spell-checking, and word wrap — make my editing experience smooth and productive. I disable the workspace trust prompts because they interrupt my flow on my own machine.
In Conclusion.
I now have a repeatable, documented procedure for getting Ruby and VS Code onto any fresh, or re-imaged, Ubuntu Desktop. By committing this process to my blog, I save myself the hassle of rediscovering each setting every time. The process is straightforward, and the result is a consistent development environment I can rely on.
Until next time: Be safe, be kind, be awesome, kia kaha!!
Document Details.
The following information is the metadata for this post.
Hash Tags.
#Ruby #VS-Code #Ubuntu #Development-Environment #AsciiDoctor #Linux-Setup #My-Workflow
SEO Title (60 Characters).
Install Ruby & VS Code on Ubuntu Desktop | Setup Guide
SEO Description (150 Characters).
I document installing Ruby and Visual Studio Code on my Ubuntu Desktop system — covering the prerequisite system update, installation commands, and the VS Code extensions and settings I use for my daily development workflow.





