help-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: New style sheet for Texinfo 7.x


From: Luis Felipe
Subject: Re: New style sheet for Texinfo 7.x
Date: Mon, 06 Mar 2023 13:34:27 +0000

Hi Gavin,


On Sunday, March 5th, 2023 at 18:48, Gavin Smith <gavinsmith0123@gmail.com> 
wrote:

> This looks great, thanks for posting!

Glad you like it :)


> CSS can really help with making a manual look approachable, especially
> with adjusting the text block width.

I agree.


> Could I suggest that the node navigation header would look better if
> it wasn't surrounded in white space?

I agree. The reason it is the way it is is that I didn't find the HTML 
structure that convenient to lay out the navigation differently. So I decided 
to wait until the HTML was updated to HTML 5's semantic elements. For example, 
I'd expect a structure more or less like this

BODY
  NAV
  ARTICLE or MAIN
  FOOTER

That way the padding of the ARTICLE wouldn't affect the style of the NAV.

But I might take another look and see if I can relocate the navigation using 
the current structure. Also, I'm working on a project called Guile Document√°, 
where I want to explore rendering the Texinfo tree with a custom HTML structure 
(not public yet, though).


> I found the example with a nested @def* block interesting:
> 

> https://luis-felipe.gitlab.io/texinfo-css/Elements.html#Definitions
> 

> It reminded me of this thread:
> 

> https://lists.gnu.org/archive/html/bug-texinfo/2022-02/msg00000.html
> 

> Nested @def* could be a good way to define parameters, return values, and
> so on. With the new @defline facility the user could define macros like
> @param that expanded to "@defline Parameter".

That would be nice because I think those kinds of nested definitions make it 
easier to find the information you're looking for compared to defining 
parameters within the paragraphs that explain a given command, procedure, etc.

Attachment: publickey - luis.felipe.la@protonmail.com - 0x12DE1598.asc
Description: application/pgp-keys

Attachment: signature.asc
Description: OpenPGP digital signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]