Ce dossier explore, dans une perspective historique, les relations entre les arts vivants et l’économie du XVIIe au XXe siècle. Les contributions analysent les pratiques de divers agents confronté...

YouTube video by Johnny Game Over

Announcing the public release of BSSG, a Bash Static Site Generator born from a personal journey away from complex dynamic CMS. Discover a simple, portable alternative for your blog.

CEO at Prodottoinrete, creator of FediMeteo and BSSG. Founder of BSD Cafe & illumos Cafe. Speaker at EuroBSDCon, BSDCan, DevConf. Self-hosting, *BSD, and the Unix philosophy since 1996.

YouTube video by Adam Mockler

YouTube video by Adam Mockler

Ce dossier propose une lecture sociohistorique des mondes intellectuels beyrouthins entre les années 1950 et 1980, période au cours de laquelle Beyrouth s’est affirmée comme l’une des capitales cu...

Figure 1 Crédits : © Christophe Maître, INRAE. Si la préparation des repas est un travail domestique, moins valorisé que beaucoup d’autres activités (du travail rémunéré aux activités culturelles ...

Introduction Dans Mon oncle d’Amérique, film d’Alain Resnais sorti en 1980, le réalisateur français nous invite à suivre trois parcours de vie entrecroisés, dont celui de Jean Le Gall, ancien élève...

Bruce-Browne was officially appointed Mayor of Ipswich at the first meeting of Ipswich Borough Council on 20 May

Comments

Figure 1 Crédits : Arthur Hacot. La cuisine gastronomique occupe, dans le contexte français, une place particulière. Branche la plus prestigieuse de l’hôtellerie-restauration, sa construction remo...

I enjoy blogging. I blog on my own personal site (this blog), and I also have a blog for my work site, decoded.legal. In 2023, I moved my blog to a static site generated by hugo. I've been reasonably pleased with hugo, and it does the job, but I find it complex. In short, if an update broke my site, I am not 100% convinced that I would be able to fix it. I don't need much in the way of complexity; I have a simple, predominantly text, blog, and all I want is to be able to write posts in markdown, generate a static html site from it, andrsync it to a webserver, along with an RSS feed. I am using a Raspberry Pi 4 as my webserver, and this works fine, given my lightweight, low complexity, sites. ## Enter BSSG On the fediverse, I saw Stefano Marinelli discussing his own static site generator - the Bash Static Site Generator, also called "BSSG" - and I was keen to give it a try. I guess that I am simply more confident that, if there was a problem, I'd be more confident about fixing something written in bash. ## Installing BSSG I am running hugo (and now BSSG) on my Raspberry Pi 4 webserver. I could install it on something beefier, like my laptop, and then just rsync the output files to the webserver, but, again for simplicity, it makes sense to me to run the static site generator on the webserver itself. I don't have anything particular to note about the basic installation. ## Configuring BSSG I wanted to make quite a few changes to the default configuration, so I decided that the simplest thing to do was to copy the whole config file from the BSSG installation directory into my site directory, and then amend it. Here is my configuration file. (I have a separate file, in the same directory, for my .onion site; this is much the same, but referencing the .onion URL instead, and with a separate output directory.) ## Customising the theme I was happy with how my old blog looked, and, for the work blog, I wanted it to remain consistent with the main website. I started with the BSSG "minimal" theme, and then made the changes that I wanted to support "dark mode", remove transitions/transformations, and to generally get to the look that I wanted. Here is the resulting css. ## Adding fediverse stuff to the header Once can also have site-specific templates, so I copied the templates directory from the BSSG directory into my site directory, and made changes there. In particular, in the header template, I: * added an inline svg for the icon, in lieu of a favicon file * added a link for fediverse verification (`<link rel="me" href="https://mastodon.neilzone.co.uk/@neil"/>`) * added a link for "fediverse:creator", so that post previews in Mastodon link to my Mastodon account (`<meta name="fediverse:creator" content="@neil@mastodon.neilzone.co.uk" />`) * adjusted some of the OpenGraph (fedi previews) stuff, to use a static image, since I do not use header images (or, really, any images at all) Here is the header file. In the footer, I amended the copyright information, and, on the work blog, added a short disclaimer. (My footer.) ## Migrating content from my hugo blog There is a significant (but not total) overlap between the header material of blogposts for hugo and blogposts for BSSG. I'm not entirely sure that I needed to do anything at all, aside from copying the raw markdown files into BSSG's `src` directory, but I used a few regexes to align the header material anyway: # Change the date format sed -r -i 's/(^date: ".*)(T)(.*)(\+)(.*)(:)(.*$)/\1 \3 +\5\7/g' *.md # Change the date format in the "publishdate" field, and change the field name to "lastmod" sed -r -i 's/(^publishdate: ".*)(T)(.*)(\+)(.*)(:)(.*$)/\1 \3 +\5\7/g' *.md sed -r -i 's/publishdate/lastmod/g' *.md # Remove the year and month lead-in to the slug, and change the name to "slug" sed -r -i 's/(^url: )(.{8})(.*)/\1\3/g' *.md sed -r -i 's/^url/slug/' *.md # Remove the brackets from the tags, remove the quotation marks, and remove spaces sed -r -i 's/(^tags: )(\[)(.*)(\]$)/\1\3/' *.md sed -r -i '/^tags/ s/"//g' *.md sed -r -i '/^tags/ s/, /,/g' *.md (Yes, there might be shorter / cleaner / faster etc. ways of doing this. This worked for me.) I also found - thanks to an error message when I first tried to build the BSSG content - that BSSG does not like src files with spaces in the names. I did not have many (although one was enough), so I fixed that: rename 's/ /-/g' *.md One thing that I did not do with hugo is have descriptions for my posts. I think that I'd prefer not to have descriptions displayed at all, but I've yet to find a way to suppress them in BSSG without editing the underlying scripts, which (for ease of updating), I am loathe to do. ## Adding new content and building the blog I am not using BSSG's editing tool, or its command line tools for adding new posts (although I might need to use it for deleting posts). Instead, I prefer to write markdown in vim, and then upload that to the webserver and then build the site. I have a small shell script on my laptop and phone, which generates a text file (with a .md extension) with the correct header material, and it pre-populates the date and time in the correct format. I then have a separate script which I use to push the new blogpost to the webserver, and then, via ssh, runs a script in the relevant BSSG site directory to build the site and rsync it into place. Here is that build script. (Although "build script" makes it sound fancier than it is.) ## Initial thoughts It is early days, so these are little more than my immediate notes. I'd like to find a way to remove the descriptions from the index page. But, other than that, I am very happy with BSSG, and I am very grateful to Stefano for making it available. Building this blog on a Raspberry Pi 4, even using the (newly-fixed; thanks, Stefano!) "ram" mode, is not exactly rapid, but that is not a particular concern for me. I am very pleased. And, if you can read this - my first new blogpost since adopting BSSG - then everything is going well :)

Ce dossier explore, dans une perspective historique, les relations entre les arts vivants et l’économie du XVIIe au XXe siècle. Les contributions analysent les pratiques de divers agents confronté...