README.md

Linux Console Fonts site

Source code for the site Linux Console Fonts Screenshots.

Build prerequisites

https://www.docsy.dev/docs/get-started/docsy-as-module/installation-prerequisites/

• An Archlinux VM (only tested on a Linode VM)
• Ansible
• Hugo Extended >=v0.73.0.
• Go >=v1.12
• Recent NodeJS
  • Install from nodesource, the version that is in the Ubuntu 20.04 repository is too old (version 10 or something).
• PostCSS (NPM module)

  cd hugo-site
  npm install -D autoprefixer
  npm install -D postcss-cli
  npm install -D postcss
  

Generating the screenshots

1. Create a Linode VM:
   • Size: Nanode 1GB
   • 1 CPU core
   • 25 GB storage
2. CD into the ansible directory.
3. Update the inventory file.
   Copy host.example to hosts and edit it.
4. Run the playbook.yml playbook.

   ansible-playbook playbook.yml
   

Developing the website (serving locally)

Do steps 1 to 3 above and use the dev-server.sh command to serve the site locally.

./dev-server.sh

Generating/updating the site

1. Generate the site.

   ./generate-site.sh
   

2. Create a PR or push to the main branch.

Docsy customizations

• Installed lazysizes in static/scripts/lazysizes.min.js.
• Loaded lazysizes in /layouts/partials/hooks/head-end.html (documentation).
• Created a screenshots shortcode in /layouts/shortcodes/screenshots.html.

To do

Playbook:

• Update tarball, host it in static.
• Download files automatically instead of the commands documented above.
• Download/update Readme files automatically. * Would need a data file and a shortcode, just like screenshots. * Alternative: https://discourse.gohugo.io/t/list-files-in-a-directory/21258/3

Site:

• Figure out hosting and domain name. * GitHub pages?
• Edit GitHub repo URL.
• Set up Matomo site. * [X] Add Matomo code in head-end.html.
• Edit Introduction with description of my process.
• Update Link to the Python script.
• Customized socials in footer.
• Test and update GitHub repo link.
• Migrate Readme files from my static site to this site.
• Add a link back to my blog.
• Redirect old URL from my blog to the new site.
• Update link on Archlinux wiki.

Repository:

• Create Ansible playbook. * Install required packages: fbdump, netpbm, libpng.
• Create a shortcode and use YAML data

Script:

• Fix error in the script.
• Modernize the script. * Use argparse. * Break out nested code blocks into separate functions.
• Investigate fonts screenshots that come out weird. * solar24x32.psfu * latarcyrheb-sun32.psfu * It's currently not possible to change the GLISH console resolution.
  https://www.linode.com/community/questions/11069/glish-resolution