website
website copied to clipboard
letsencrypt
Markdown table layout for certificates?
Figured I'd give it a try. Thoughts?
(Make sure to look at the fully-formatted output of the file, not just the code.)
I like the idea, but it would take a lot more styling (e.g. vbars between columns, alternating grey/white rows, padding and margins around cell contents, smarter wrapping when the cell contents or entire rows are too wide for their boxes) to be readable. Unfortunately, markdown doesn't easily grant that level of customization.
A full length. Note that the tables do support horizontal scrolling.
Those screenshots appear to be of GitHub's rendering of the markdown. My screenshots are of netlify's deploy-preview, which is what people will see when they visit the site itself: https://deploy-preview-1287--letsencrypt.netlify.app/certificates/
That's... really disappointing. I see what you mean now. I really made a bad WYSIWYG assumption here. ~~Me thinks netlify might want to put forth some serious reconsideration into their styling implementation for tables.~~ The differences are stark here.
It's not netlify's fault -- these markdown files are inputs into hugo, the golang static site generator. It's totally possible to style things (e.g. see //static/css/policy-markdown.css), it just takes more effort than simply changing the contents of this one file.
That makes more sense. So it sounds like the default table styling in hugo is rather basic then. When I read up on netlify, I had assumed for some reason that they had the responsibility for the rendering piece. My fault.
Don't know why I didn't ask this before, but would you be up to me doing the table styling? I'm pretty proficient with CSS3. It'll probably take some trial and error, so I'd need to be able to test things like you did.
Yeah of course, go for it. You should be able to see the netlify deploy preview in the list of checks at the bottom of the PR; it gets auto-generated for every PR.
@aarongable
I've made what I believe are the simplest changes to //static/css/policy-markdown.css to apply the same table styles universally, but they don't seem to be reflected in the netlify preview. Is the preview using the current CSS rather than the proposed CSS?
@GriffinSoftware policy-markdown.css is only applied to policy files (CP/CPS)
Thanks for bringing that to my awareness, @tdelmas. Any idea where the general css styles are located?
@GriffinSoftware They are located in the src/css folder (css files in static/css are used only by some pages)