Fix note icon, UL marker size, dot-leader

Question

Fix note icon, UL marker size, dot-leader

Closed this issue a month ago · 37 comments

Revert the note admonition icon to the older info circle.
Make unordered lists bullets larger.
Add the TOC dot-leader back in.

Answer 1 · 2024-06-07T20:13:02.000Z

Change codespan font to Jetbrains mono.

Answer 2 · 2024-06-07T20:15:33.000Z

Make page number column in TOC fixed width so the column does not look wavy.
Make Figure number and Table number column in list of figures and list of tables fixed width so that captions line up and dont look wavy. Perhaps something like below:

# List of figures settings
lof:
  label_width: '3em'  # Adjust the width for figure labels
  align: left
  caption:
    indent: '4em'  # Ensure captions align consistently

# List of tables settings
lot:
  label_width: '3em'  # Adjust the width for table labels
  align: left
  caption:
    indent: '4em'  # Ensure captions align consistently

Answer 3 · 2024-06-07T20:42:03.000Z

Bullets could possible be fixed this way:

# List settings
list:
  indent: '$horizontal_rhythm * 1.5'
  item_spacing: '$vertical_rhythm / 2'
  bullet:
    font_size: 'round($base_font_size * 1.5)'
    content: '•'

Answer 4 · 2024-06-07T20:43:27.000Z

I'll give that a try.

Answer 5 · 2024-06-07T20:54:27.000Z

Didn't seem to work.

Answer 6 · 2024-06-10T14:18:30.000Z

I've fixed the bullets. I have it looking like this now:

Answer 7 · 2024-06-10T14:22:12.000Z

That looks good. Thanks!

Answer 8 · 2024-06-10T14:48:09.000Z

how does the level 2 and level 3 sub-bullet look?

Answer 9 · 2024-06-10T15:04:24.000Z

Here's what all 3 levels look like:

Answer 10 · 2024-06-10T15:06:37.000Z

The size and shape look good! Could the second level also have color black instead of white.

Answer 11 · 2024-06-10T15:26:10.000Z

How's this:

Answer 12 · 2024-06-10T15:33:07.000Z

Thanks! Looks good!

Answer 13 · 2024-06-10T17:35:54.000Z

btw, setting the :bibtex-style: apa, which matches the ISA manuals will fix your bibliography alignment issue.

Answer 14 · 2024-06-10T17:39:52.000Z

I think the LaTex ISA manual - before asciidoc coversion - used to use ieee bibtext style. It would be preferred to use ieee style..

Answer 15 · 2024-06-10T17:51:56.000Z

Ah, OK. This is a known issue with the ieee style in asciidoc. I'll see if there's a resolution.

Answer 16 · 2024-06-10T23:29:08.000Z

@wmat - would you be updating the codespan font as well to something like Jetbrains mono?

Answer 17 · 2024-06-10T23:37:48.000Z

Yes, I'll do that as well.

Answer 18 · 2024-06-11T13:55:35.000Z

JetBrainsMono has been added to my docs-resources branch and pointed codespan at it.

As for the Bibliography, it'd be some work to make the ieee formatting match LaTeX. I know this isn't ideal, but I don't think it's warranted right now. Can you live with the layout the way it is?

So what's left for the iommu spec? The alignment of the LoF and LoT?

Answer 19 · 2024-06-11T14:05:08.000Z

Thanks!

As for the Bibliography, it'd be some work to make the ieee formatting match LaTeX. I know this isn't ideal, but I don't think it's warranted right now. Can you live with the layout the way it is?

I think I can live with that.

So what's left for the iommu spec? The alignment of the LoF and LoT?

The two other item I was tracking were

"wavy" numbers column in TOC, LoF, and LoT.
Lining up the caption text to start from same column in LoF and LoT.

Answer 20 · 2024-06-11T17:50:05.000Z

So if I use JetBrainsMono as the font for lists it's slightly approved, at least for text alignment but I can't seem to get the wavy numbering to go away:

Answer 21 · 2024-06-11T18:01:21.000Z

The Jetbrains mono was to help solve the weird ligatures that were being previously produced like this "&". Hopefully updating to Jetbrains fixed that

Answer 22 · 2024-06-11T18:04:50.000Z

Looks like this now:

Answer 23 · 2024-06-11T18:10:01.000Z

Thanks! This looks nice! The older one rendered "&" and "~" using really odd characters.

Answer 24 · 2024-06-11T18:14:07.000Z

OK, great. That screen capture was from my local build btw. I'll make the changes to docs-resources next.

Answer 25 · 2024-06-11T19:16:06.000Z

The GitHub action build is now using all of these fixes in docs-resources. Should probably close this now and open new issues as you find them.

Answer 26 · 2024-06-11T19:23:25.000Z

One thing I noticed is that the text inside tables is much smaller than the main body text. Was that intentional?

Answer 27 · 2024-06-11T19:25:39.000Z

I thought that was fixed. I’ll look shortly. Bill Traynor Documentation Build and Release Engineer RISC-V International Join us in Munich, Germany at RISC-V Summit Europe <https://riscv-europe.org/summit/2024/> from 24-28 June. Be a part of the new wave of European computing innovation!

…

On Tue, Jun 11, 2024 at 3:23 PM Ved Shanbhogue ***@***.***> wrote: One thing I noticed is that the text inside tables is much smaller than the main body text. Was that intentional? — Reply to this email directly, view it on GitHub <#345 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAAN6ZH63XJR7DV2NHSNK23ZG5FEFAVCNFSM6AAAAABI7HY7RGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCNRRGQ2TOMBZGI> . You are receiving this because you were mentioned.Message ID: ***@***.***>

Answer 28 · 2024-06-12T14:43:47.000Z

So table_font_size was changed to 11.5 recently and then overwritten back to 9 with the merging of the two themes. 9 seems a bit small to me. I'm thinking a size of ($base_font_size * 0.9em) would be appropriate. That is the equivalent to 10.35 pt when base font size is 11.5 pt.

Answer 29 · 2024-06-12T14:53:37.000Z

That should work.

Answer 30 · 2024-06-12T15:22:07.000Z

Thanks! That looked good!

Answer 31 · 2024-06-12T17:19:20.000Z

One small nit if its not too hard to fix. I think the bullets are now a bit too big - I believe they are set to 1.5xbase-font - perhaps 1.25xbase-font is more appropriate. I pasted a google doc compared to the current render.

Answer 32 · 2024-06-12T18:23:32.000Z

I actually am just using unicode glyphs. I believe that one is U-26AB. Does this look better? I can hardly see the difference.

Answer 33 · 2024-06-12T18:30:28.000Z

i can't get it to change :/

Answer 34 · 2024-06-12T19:19:15.000Z

Maybe it will respond to a "font-size" tag in ulist?

ulist:
marker:
disc:
content: "\u26ab"
circle:
content: "\u26ab"
square:
content: "\u25a0"
font-family: JetBrainsMono
font-size: ????

Answer 35 · 2024-06-12T19:44:47.000Z

that's exactly what I tried.

Answer 36 · 2024-06-12T19:48:44.000Z

Maybe U+2022 or U25CF is better?

Answer 37 · 2024-06-18T23:47:48.000Z

I tried a bunch of these and seems like what you have currently is the best among all.