diff --git a/Gemfile b/Gemfile index a40567be..9eef2199 100644 --- a/Gemfile +++ b/Gemfile @@ -1,3 +1,4 @@ source 'https://rubygems.org' gem 'github-pages', group: :jekyll_plugins gem 'json', '~> 2.0' +gem 'webrick' diff --git a/Makefile b/Makefile index 006f6045..0982ec19 100644 --- a/Makefile +++ b/Makefile @@ -4,4 +4,10 @@ all: clean: $(RM) -r _site -.PHONY: all clean +rootless: + jekyll serve + +rootless-setup: + gem install --user-install github-pages webrick + +.PHONY: all clean rootless rootless-setup diff --git a/README.md b/README.md index d36c15a1..c0d57eee 100644 --- a/README.md +++ b/README.md @@ -56,6 +56,36 @@ Git submodules for content: ## Instructions +### Ruby Gems + +These instructions have been tested on a Fedora 38 qube on QubesOS 4.1 and on the following qubes on QubesOS 4.2: `debian-12-xfce`, `debian-12`, `fedora-40-xfce`, `fedora-40`, `fedora-39-xfce`, `fedora-39`, `fedora-38-xfce`, `fedora-38`. + +1. Install in your template (or standalone): `ruby-devel` (if Fedora-based) or `ruby-all-dev`, `make`, `g++` (if Debian-based) + +2. In your AppVM based on that template (or the same standalone), clone this repo, incl. all submodules, and enter it: + + $ git clone --recursive https://github.com/QubesOS/qubesos.github.io.git + $ cd qubesos.github.io/ + +3. Finish setup in the repo folder (requires internet connection): + + $ make rootless-setup + On Debian-based AppVMs / Standalones, you need to also put the gems on your PATH: + + $ echo "PATH=\$PATH:$(find ~/.local/share/gem/ruby -type d -name bin | tail -n1)" >> ~/.bashrc + $ . ~/.bashrc + +4. This concludes setup; when you want to start the local server which runs the website (offline): + + $ make rootless + +5. Then open your browser and navigate to: + + http://127.0.0.1:4000/ + or + + http://localhost:4000/ + ### Podman Compose These instructions have been tested on a Fedora 33 qube. Podman is not