Fix note icon, UL marker size, dot-leader

[wmat]

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

[ved-rivos]

Change codespan font to Jetbrains mono.

[ved-rivos]

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

[ved-rivos]

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: '•'

[wmat]

I'll give that a try.

[wmat]

Didn't seem to work.

[wmat]

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

[ved-rivos]

That looks good. Thanks!

[ved-rivos]

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

[wmat]

Here's what all 3 levels look like:

[ved-rivos]

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

[wmat]

How's this:

[ved-rivos]

Thanks! Looks good!

[wmat]

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

[ved-rivos]

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

[wmat]

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

[ved-rivos]

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

[wmat]

Yes, I'll do that as well.

[wmat]

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?

[ved-rivos]

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

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

[wmat]

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:

[ved-rivos]

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

[wmat]

Looks like this now:

[ved-rivos]

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

[wmat]

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

[wmat]

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.

[ved-rivos]

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

[wmat]

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 https://github.com/riscv-non-isa/riscv-iommu/issues/345#issuecomment-2161457092, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAAN6ZH63XJR7DV2NHSNK23ZG5FEFAVCNFSM6AAAAABI7HY7RGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCNRRGQ2TOMBZGI . You are receiving this because you were mentioned.Message ID: @.***>

[wmat]

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.

[ved-rivos]

That should work.

[ved-rivos]

Thanks! That looked good!

[ved-rivos]

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.

[wmat]

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

[wmat]

i can't get it to change :/

[ved-rivos]

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: ????

[wmat]

that's exactly what I tried.

[ved-rivos]

Maybe U+2022 or U25CF is better?

[ved-rivos]

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