You are not logged in.

#1 2026-01-10 07:33:41

darenw
Member
From: Trego Montana
Registered: 2008-07-04
Posts: 112
Website

Separation of example file name from contents in wiki

The name of a file and the contents displayed need to be separated for sample files shown in the wiki pages.

I'm looking at the Home_Assistant page in the wiki.  There's a sample YAML file, the contents in a pale blue box.  So scrape the entire contents, paste it into a text file, and try it out. No go!  Syntax error in the YAML: "mapping values are not allowed..." (details are not relevant; the error is erroneous.)   Got nowhere trying to figure this out, and I'm no expert on YAML.

Until I asked Gemini!  It said that the first line appeared to be the file's name.  Aha!  I had scraped the entire contents of the pale blue box.   There's nothing indicating that first line really isn't a first line, but metadata.

Solution:  use a different background color, font, underline, div border, or otherwise visually make the file's name look different, not like the contents of the file below it.


Artist/Physicist, Herder of Pixels, Photons and Electrons

Offline

#2 2026-01-10 08:17:43

cloverskull
Member
Registered: 2018-09-30
Posts: 273

Re: Separation of example file name from contents in wiki

There is a dotted line beneath the filename separating it from the rest of the file contents, did you not notice the dotted line?

Offline

#3 2026-01-10 09:06:08

darenw
Member
From: Trego Montana
Registered: 2008-07-04
Posts: 112
Website

Re: Separation of example file name from contents in wiki

It's close to invisible. Crank up the contrast!


Artist/Physicist, Herder of Pixels, Photons and Electrons

Offline

#4 2026-01-10 10:11:39

seth
Member
From: Don't DM me only for attention
Registered: 2012-09-03
Posts: 72,057

Re: Separation of example file name from contents in wiki

https://github.com/openstyles/stylus probably exists for your browser tongue
I can see how this isn't the best a11y, though - https://gitlab.archlinux.org/archlinux/ … i/-/issues

Offline

#5 2026-01-10 11:43:45

Lone_Wolf
Administrator
From: Netherlands, Europe
Registered: 2005-10-04
Posts: 14,623

Re: Separation of example file name from contents in wiki

The dotted line is indeed not very visible, but the first line is very clearly a filename :

~/homeassistant/docker-compose.yml

C/p something from the internet without understanding it is a bad habit.


Disliking systemd intensely, but not satisfied with alternatives so focusing on taming systemd.

clean chroot building not flexible enough ?
Try clean chroot manager by graysky

Offline

Board footer

Powered by FluxBB