Go to file
Marton Szasz d6dd6c3133
auto publish github pages
Squashed commit of the following:

amend: removed push trigger, because it doesn't work, and I don't know
why. You may only want to publish manually anyway.

commit 9339b3999809ef0631dbed43333facdb6adb7264
Author: Marton Szasz <szaszm@apache.org>
Date:   Mon May 20 17:48:58 2024 +0200

    hardcode output path

    because no variables are available in the publish context

commit a6c320d1ff366f3d1f352295f132376e3b0d486d
Author: Marton Szasz <szaszm@apache.org>
Date:   Mon May 20 17:46:01 2024 +0200

    add missing packages

commit 4cefbe602444968e1210863ca443dbebda33cd9d
Author: Marton Szasz <szaszm@apache.org>
Date:   Mon May 20 17:36:49 2024 +0200

    attempting to fix git describe error during publish

commit e4453320bb9e0878e635cf763dee6eec3bcefd02
Author: Marton Szasz <szaszm@apache.org>
Date:   Mon May 20 17:29:01 2024 +0200

    add xsltproc + debug

commit 1be4323e822f6df67d58ed090dbb9a38971d551a
Author: Marton Szasz <szaszm@apache.org>
Date:   Mon May 20 17:24:06 2024 +0200

    try gh pages publish with actions
2024-05-20 17:59:57 +02:00
.github/workflows auto publish github pages 2024-05-20 17:59:57 +02:00
appendices Update to thunderbird-115.8.0 (Security Update). 2024-02-21 07:21:30 -06:00
book Added <application> tags for xml in book/ 2024-05-18 07:14:55 -06:00
images Added new images, rm'd server as its unneeded, and modified css files 2024-05-14 16:53:45 -06:00
introduction Added <application> tags for xml in introduction/ 2024-05-18 07:27:38 -06:00
multilib pain 2024-05-14 07:02:30 -06:00
shareddeps Prepare for the first, albeit very rough, release 2024-05-17 08:39:35 -06:00
steam Added another mention of apps in steamtrblshoot 2024-05-18 06:14:48 -06:00
stylesheets Made link colors for dark mode look more pleasant 2024-05-18 05:38:00 -06:00
template template: Clean up 2024-03-14 22:03:46 +08:00
wine Prepare for the first, albeit very rough, release 2024-05-17 08:39:35 -06:00
xincludes Readded xincludes, changed blfs target to blfs-next, moved two xml files to where they should be, and finished Networking section for the Steam chapter 2024-04-24 22:21:32 -06:00
.gitattributes Add mechanism for cron job $Date$ handling 2021-04-15 17:33:01 +08:00
.gitignore Revert "Makefile: use a "by-the-book" way to detect build environment change" 2023-01-25 09:51:58 +08:00
expand_date Add mechanism for cron job $Date$ handling 2021-04-15 17:33:01 +08:00
general.ent Prepare for r12.1-rel-05182024 release 2024-05-18 08:03:20 -06:00
git-version.sh auto publish github pages 2024-05-20 17:59:57 +02:00
gnome.ent Update to gnome-weather-46.0 2024-04-04 16:34:29 -05:00
index.xml Added and mostly finished GNAT, started MinGW-w64 2024-04-27 02:13:48 -06:00
INSTALL.md Make README and INSTALL Markdown 2024-05-11 08:59:51 -06:00
Makefile Changed blfs mentions in Makefile to GLFS, changed filenames to follow suite, added pdf build option, and edited INSTALL to let users know pdf build option exists 2024-04-28 21:29:39 -06:00
obfuscate.sh clean up unused SVN prop entries 2021-04-20 19:12:02 +08:00
packages.ent Added X11, added sdl2. Required deps done 2024-05-16 16:19:20 -06:00
pdf-fixups.sh Changed blfs mentions in Makefile to GLFS, changed filenames to follow suite, added pdf build option, and edited INSTALL to let users know pdf build option exists 2024-04-28 21:29:39 -06:00
README.md Fixed README typo 2024-05-18 06:59:23 -06:00
switch-theme.sh Added gfxapi, audio, and connectnet. Added dark theme 2024-05-13 01:36:27 -06:00
tidy.conf Output the book in utf-8 encoding 2024-01-15 09:47:56 +01:00

Gaming Linux From Scatch (GLFS)

Gaming Linux From Scratch is a book that covers how to install packages like Steam and Wine after the Linux From Scratch book.

Where to Read and How

The HTML files aren't hosted anywhere yet, except for the GitHub releases. Go to https://github.com/Zeckmathederg/glfs/releases and go the the newest release. Chunked means the book is seperated into multiple HTML files. Nochunked means the book is just one big HTML file. PDF is a big PDF file of the book.

Chunked:

Point your browser or HTML reader to index.html

Nochunked:

Point your browser or HTML reader to glfs.html

PDF

Point your browser or PDF reader to glfs.pdf

Installation

How do I convert these XML files to HTML? You need to have some software installed that deal with these conversions. Please read the INSTALL.md file to determine what programs you need to install and where to get instructions to install that software.

After that, you can build the html with a simple make command. The default target builds the html in $(HOME)/public_html/glfs.

For all targets, setting the parameter REV=systemd is needed to build the systemd version of the book.

Furthermore, the dark theme is the default, but you can switch the theme by running switch-theme.sh with the parameter light or dark.

Other Makefile targets are: pdf, nochunks, validate, and glfs-patch-list.

pdf: builds GLFS as a PDF file.

nochunks: builds GLFS in one huge file.

validate: does an extensive check for xml errors in the book.

glfs-patch-list: generates a list of all GLFS controlled patches in the book.