Reduce padding in some container elements

.github/workflows/CI.yml

@@ -15,6 +15,7 @@ jobs:
       matrix:
         version:
           - '1.0'
+          - '1.6'
           - '1'
           - 'nightly'
         os:

.github/workflows/linkcheck.yml

@@ -14,7 +14,7 @@ jobs:
       - uses: actions/checkout@v2
       - uses: julia-actions/setup-julia@latest
         with:
-          version: '1.5'
+          version: '1.6'
       - name: Run online linkcheck tests
         run: julia --color=yes test/run_docchecks.jl
   manual_linkcheck:
@@ -24,7 +24,7 @@ jobs:
       - uses: actions/checkout@v2
       - uses: julia-actions/setup-julia@latest
         with:
-          version: '1.5'
+          version: '1.6'
       - name: Install dependencies
         run: julia --color=yes --project=docs/ -e 'using Pkg; Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate()'
       - name: Build and check documentation

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 
+* ![Enhancement][badge-enhancement] The padding of the various container elements in the HTML style has been reduced, to improve the look of the generated HTML pages. ([#1814][github-1814], [#1818][github-1818])
 * ![Bugfix][badge-bugfix] Build failures now only show fatal errors, rather than all errors. ([#1816][github-1816])
 
 ## Version `v0.27.17`
@@ -1028,7 +1029,9 @@
 [github-1807]: https://github.com/JuliaDocs/Documenter.jl/pull/1807
 [github-1810]: https://github.com/JuliaDocs/Documenter.jl/issues/1810
 [github-1811]: https://github.com/JuliaDocs/Documenter.jl/pull/1811
+[github-1814]: https://github.com/JuliaDocs/Documenter.jl/issues/1814
 [github-1816]: https://github.com/JuliaDocs/Documenter.jl/pull/1816
+[github-1818]: https://github.com/JuliaDocs/Documenter.jl/pull/1818
 <!-- end of issue link definitions -->
 
 [julia-38079]: https://github.com/JuliaLang/julia/issues/38079

assets/html/scss/documenter/_elements.scss

@@ -39,17 +39,17 @@ pre {
   overflow: hidden;
 
   code, code.hljs {
-    padding: 0 0.5rem !important;
+    padding: 0 $documenter-container-left-padding !important;
     overflow: auto;
     display: block;
   }
 
   code:first-of-type, code.hljs:first-of-type {
-    padding-top: 0.7rem !important;
+    padding-top: 0.5rem !important;
   }
 
   code:last-of-type, code.hljs:last-of-type {
-    padding-bottom: 0.7rem !important;
+    padding-bottom: 0.5rem !important;
   }
 
   .copy-button {

assets/html/scss/documenter/_variables.scss

@@ -79,10 +79,13 @@ $documenter-main-padding: 1rem !default;
 // to be in px, hence the unit conversion.
 $desktop: round($body-size * ($documenter-max-width + $documenter-sidebar-width + $documenter-sidebar-main-gap + $documenter-main-padding-right - 5rem)/1rem) !default;
 
-// Admonitions
-$message-header-padding: 0.75em;
-$message-body-padding: 1em 1.25em;
-// Docstrings
-$card-content-padding-v: 1rem;
-$card-content-padding-h: 1.25rem;
-$card-content-padding: $card-content-padding-v $card-content-padding-h;
+// Padding for admonitions and docstrings.
+// We'll try to keep the left padding consistent between the various container
+// elements:
+$documenter-container-left-padding: 0.75rem;
+$documenter-admonition-header-padding: 0.5rem $documenter-container-left-padding;
+$documenter-admonition-body-padding: 0.5rem $documenter-container-left-padding;
+$documenter-docstring-header-padding: 0.5rem $documenter-container-left-padding;
+$documenter-docstring-body-padding-h: $documenter-container-left-padding;
+$documenter-docstring-body-padding-v: 0.75rem;
+$documenter-docstring-body-padding: $documenter-docstring-body-padding-v $documenter-docstring-body-padding-h;

assets/html/scss/documenter/components/_admonition.scss

@@ -81,19 +81,19 @@ $admonition-header-color: () !default;
   font-weight: $message-header-weight;
   justify-content: space-between;
   line-height: 1.25;
-  padding: $message-header-padding;
+  padding: $documenter-admonition-header-padding;
   position: relative;
 
   &:before {
     @include font-awesome;
-    margin-right: $message-header-padding;
+    margin-right: $documenter-container-left-padding;
     content: "\f06a";
   }
 }
 
 .admonition-body {
   color: $message-body-color;
-  padding: $message-body-padding;
+  padding: $documenter-admonition-body-padding;
 
   pre {
     background-color: $pre-background;

assets/html/scss/documenter/components/_docstring.scss

@@ -10,7 +10,7 @@
     display: flex;
     flex-grow: 1;
     align-items: stretch;
-    padding: $card-header-padding;
+    padding: $documenter-docstring-header-padding;
 
     background-color: $documenter-docstring-header-background;
     box-shadow: $card-header-shadow;
@@ -31,7 +31,7 @@
 
   > section {
     position: relative;
-    padding: $card-content-padding;
+    padding: $documenter-docstring-body-padding;
 
     border-bottom: 1px solid $border;
     &:last-child {
@@ -42,8 +42,8 @@
       transition: opacity 0.3s;
       opacity: 0;
       position: absolute;
-      right: $card-content-padding-h / 2;
-      bottom: $card-content-padding-v / 2;
+      right: $documenter-docstring-body-padding-h / 2;
+      bottom: $documenter-docstring-body-padding-v / 2;
       @extend .tag;
       @extend .is-primary;
       @extend .is-size-7;

docs/Project.toml

@@ -3,4 +3,4 @@ Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 DocumenterTools = "35a29f4d-8980-5a13-9543-d66fff28ecb8"
 
 [compat]
-DocumenterTools = "=0.1.12"
+DocumenterTools = "=0.1.14"