/legacy-site

My personal website project (LEGACY)

Primary LanguageCSSOtherNOASSERTION

tobiasbu website

This is my personal website.

Installation instructions

macOS:

Follow the instructions here to install ruby and command-line tools.

Check the CLI commands here;

In summary:

  1. Install basic dependencies:
gem install jekyll bundler
  1. Install npm and ruby dependencies:
npm install
# Install eventmachine for live reload
gem install eventmachine --platform ruby 
# To install project dependencies
bundle install

Windows:

For more information click here and here.

  1. Install Ruby+Devkit. Version must be >= 2.3.

If you want to use the live reload you should download 2.3 without devkit. You must download and install devkit separately.

Use default options for installation.

  1. Run the ridk install step on the last stage of the installation wizard. This is needed for installing gems with native extensions.

  2. After Ruby installation, run in your favorite command prompt the following line to install bundler and jekyll:

gem install jekyll bundler
  1. Check if jekyll is installed
jekyll -v
# or
bundle exec jekyll -v
  1. Install dependencies:
npm install
  1. Install ruby dependencies:
# Install eventmachine for live reload
gem install eventmachine --platform ruby 
# To install project dependencies
bundle install

Fix live-reload issue:

  1. Go to <DISK>:\Ruby<RUBY-VERSION>\lib\ruby\gems\<RUBY-VERSION>\gems\eventmachine-<VERSION>-x64-mingw32\lib
  2. Open eventmachine.rb file.
  3. In the first line write:
require 'em/pure_ruby'

For more details about this issue:

Development

For live-coding, open two command prompts and run:

# terminal 1
npm run jekyll

# terminal 2
npm run css

Ruby Development

After install all gems in the bundle and for better Ruby development in the VSCode, you should install the extension Ruby Solargraph.

Then in the command line run bundle exec yard gems to generate the documentation. This is required for intellisense and other features.

Site update

  1. Add git remote for the website hosting.
# Add a new remote for you local git. *MUST BE* 'release'
git remote add release https://github.com/<USER>/<REPO>.git
# or
git remote add release git@github.com:<USER>/<REPO>.git

# Verify if new remote was added successfully
git remote -v
  1. Then to update:
npm run update