inbo / inbo/tutorials

html layout: frame width/alignment and font size

Open
#353 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

🌈 enhancement design
Dominant language
HTML
Stars
24
Forks
10
Avg merge
2d 32m
Merged PRs (30d)
2

Description

I would suggest to update the site settings, namely the width of the main frame and/or font size.
This probably requires wrangling on the Hugo/CSS side.

In desktop computer browsers, tutorials and articles appear shifted to the left side; the frame just covers about half of the screen.
Font size is slightly increased, which leads to the odd situation that there are only 67 characters displayed in code boxes.

Image

I suspect that this is beneficial for mobile compatibility; and large fonts might improve accessibility. However, it is a waste of space on regular computer screens. The font size in code blocks complicates reading code.

For comparison, refer to a plain vanilla quarto html export. I do not think that the main frame is actually that much wider. However, it is centered, and font size is normal. Some websites offer font size adjustment options.

If a general overhaul is required, this might be tackled together with the floating TOC (issue 215).

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by inspecting the Hugo/CSS site settings that control the main frame, alignment, and code-block font size, then compare the desktop rendering with a plain vanilla Quarto HTML export. Done should mean that tutorials use screen space more effectively on desktop, remain usable on mobile, and make code boxes easier to read.

Written by the indexing model from the issue text.

Assessment

Tech stack
css, html, hugo
Domain
frontend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.