Go to file
Zeckma 2a441614a1
Merge pull request #1 from szaszm/trunk
GitHub Actions job to publish the book to GitHub Pages
2024-05-20 10:31:22 -06: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.