diff --git a/docs/mandoc.css b/docs/mandoc.css index 2a57a18f..3394c3b9 100755 --- a/docs/mandoc.css +++ b/docs/mandoc.css @@ -5,7 +5,10 @@ /* Global defaults. */ -html { max-width: 100ex; } +/* This is handled in `rgbds.css` instead + * + * html { max-width: 100ex; } + */ body { font-family: Helvetica,Arial,sans-serif; } table { margin-top: 0em; margin-bottom: 0em; } diff --git a/docs/rgbds.css b/docs/rgbds.css new file mode 100644 index 00000000..67c09fbb --- /dev/null +++ b/docs/rgbds.css @@ -0,0 +1,52 @@ +/* Overrides to default mandoc styling for HTML renders of RGBDS man pages */ + +html { + /* Reduce contrast */ + background-color: #f8f8f8; + color: #222; +} + +body { + /* Improve readability */ + font-size: 16px; + line-height: 1.4; + text-align: justify; + + /* Center body horizontally (requires to span full width) */ + margin: 10px auto; + /* `mandoc.css`'s default, but it's applied to there */ + max-width: 100ex; +} +@media print { + body { + /* Max width doesn't make sense for print */ + max-width: none; + /* Make font slightly smaller for printing */ + font-size: 14px; + } +} + +code, pre { + font-size: smaller; +} + +/* Separate lines in tables */ +table.Bl-column { + border-collapse: collapse; +} +table.Bl-column tr:not(:first-child) > td, +table.Bl-column tr:not(:first-child) > th { + border-top: 1px solid #aaa; +} + +table.Bl-column th { + /* Apply `.Sy` style to table headers */ + font-style: normal; + font-weight: bold; +} + +table.Bl-column td, +table.Bl-column th { + /* Add horizontal spacing between columns */ + padding: 2px 7px 0; +} diff --git a/src/doc_postproc.awk b/src/doc_postproc.awk index 265f7aab..de3d3239 100755 --- a/src/doc_postproc.awk +++ b/src/doc_postproc.awk @@ -1,5 +1,17 @@ #!/usr/bin/awk -f +/") +} + +/^\s+