🔖 Release v2.5.0

.github/workflows/stale.yml

@@ -10,7 +10,7 @@ jobs:
       issues: write
       pull-requests: write
     steps:
-      - uses: actions/stale@v6
+      - uses: actions/stale@v7
         with:
           days-before-stale: 30
           days-before-close: 14

CHANGELOG.md

@@ -6,6 +6,41 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+## [2.5.0] - 2023-01-17
+
+### Added
+
+- Support for icons in menus including support for links styled as an icon by itself or an icon with text
+- Search and appearance switcher links can now be fully customised and positioned anywhere in the menu
+- Front matter support for specifying article thumbnails, covers and featured image details (including filename pattern, alt text and caption)
+- Two new colour schemes - `cherry` and `sapphire`
+- Support for SVG assets as article thumbnails, covers and featured images
+- Front matter keywords support on a per article basis
+- Indonesian translation ([#398](https://github.com/jpanther/congo/pull/398))
+- Mastodon sharing links ([#405](https://github.com/jpanther/congo/pull/405))
+- `homepage.recentLimit` parameter to adjust the maximum number of recent items listed on the homepage ([#411](https://github.com/jpanther/congo/pull/411))
+
+### Changed
+
+- Images smaller than the article width are no longer resized to fill the content area and will now simply align centre ([#394](https://github.com/jpanther/congo/pull/394))
+- Upgrade to KaTeX v0.16.4 ([#414](https://github.com/jpanther/congo/pull/414))
+- Upgrade to Mermaid v9.3.0 ([#419](https://github.com/jpanther/congo/pull/419))
+- Upgrade to Chart.js v4.1.2 ([#420](https://github.com/jpanther/congo/pull/420), [#434](https://github.com/jpanther/congo/pull/434))
+- Upgrade to Typography v0.5.9 ([#437](https://github.com/jpanther/congo/pull/437))
+
+### Fixed
+
+- `mainSections` parameter is language dependent and is not referenced from `params.toml` ([#376](https://github.com/jpanther/congo/pull/376))
+- Code highlight background cut off in Google Chrome when overflowing content area ([#383](https://github.com/jpanther/congo/pull/383))
+- Social icons shift position during CSS transition when hovered in Safari ([#396](https://github.com/jpanther/congo/pull/396))
+- Hamburger navigation menu is misaligned in mobile browsers ([#399](https://github.com/jpanther/congo/pull/399))
+- Error when attempting to resize SVG assets in page bundles ([#427](https://github.com/jpanther/congo/pull/427))
+- Appearance switcher missing `aria-label` ([#438](https://github.com/jpanther/congo/pull/438))
+- Article links missing `alt` text and `aria-label` ([#439](https://github.com/jpanther/congo/pull/439))
+- Line height in article tag list would cause overlap when wrapping to a new line ([#444](https://github.com/jpanther/congo/pull/444))
+- Figure shortcode would not apply `class` or `href` attribtues in some cases
+- Charts displaying with incorrect theme colours
+
 ## [2.4.2] - 2022-11-22
 
 ### Added
@@ -570,7 +605,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Advanced customisation using simple Tailwind colour definitions and styles
 - Fully documented
 
-[unreleased]: https://github.com/jpanther/congo/compare/v2.4.2...HEAD
+[Unreleased]: https://github.com/jpanther/congo/compare/v2.5.0...HEAD
+[2.5.0]: https://github.com/jpanther/congo/compare/v2.4.2...v2.5.0
 [2.4.2]: https://github.com/jpanther/congo/compare/v2.4.1...v2.4.2
 [2.4.1]: https://github.com/jpanther/congo/compare/v2.4.0...v2.4.1
 [2.4.0]: https://github.com/jpanther/congo/compare/v2.3.1...v2.4.0

assets/css/compiled/main.css

@@ -1,4 +1,4 @@
-/*! Congo v2.4.2 | MIT License | https://github.com/jpanther/congo */
+/*! Congo v2.5.0 | MIT License | https://github.com/jpanther/congo */
 
 /*! tailwindcss v3.2.4 | MIT License | https://tailwindcss.com */
 
@@ -518,6 +518,11 @@ video {
   max-width: 65ch;
 }
 
+.prose :where(p):not(:where([class~="not-prose"] *)) {
+  margin-top: 1.25em;
+  margin-bottom: 1.25em;
+}
+
 .prose :where([class~="lead"]):not(:where([class~="not-prose"] *)) {
   color: var(--tw-prose-lead);
   font-size: 1.25em;
@@ -878,11 +883,6 @@ video {
   line-height: 1.75;
 }
 
-.prose :where(p):not(:where([class~="not-prose"] *)) {
-  margin-top: 1.25em;
-  margin-bottom: 1.25em;
-}
-
 .prose :where(video):not(:where([class~="not-prose"] *)) {
   margin-top: 2em;
   margin-bottom: 2em;
@@ -1020,6 +1020,7 @@ body button {
 /* Hamburger menu */
 
 body:has(#menu-controller:checked) {
+  position: fixed;
   overflow-y: hidden;
 }
 
@@ -1173,64 +1174,37 @@ body:has(#menu-controller:checked) {
 
 /* Background */
 
-.prose .chroma {
-  position: static;
+.chroma {
   border-radius: 0.375rem;
   --tw-bg-opacity: 1;
   background-color: rgba(var(--color-neutral-50), var(--tw-bg-opacity));
+  padding-top: 0.75rem;
+  padding-bottom: 0.75rem;
   --tw-text-opacity: 1;
   color: rgba(var(--color-neutral-700), var(--tw-text-opacity));
 }
 
-.dark .prose .chroma {
+.dark .chroma {
   --tw-bg-opacity: 1;
   background-color: rgba(var(--color-neutral-700), var(--tw-bg-opacity));
   --tw-text-opacity: 1;
   color: rgba(var(--color-neutral-200), var(--tw-text-opacity));
 }
 
-/* LineTableTD */
-
-.chroma .lntd,
-.chroma .lntd pre {
+.chroma pre {
   margin: 0px;
-  overflow: hidden;
-  border-style: none;
   padding: 0px;
-  vertical-align: top;
 }
 
 /* LineTable */
 
 .chroma .lntable {
+  margin: 0px;
   display: block;
   width: auto;
-  overflow-x: auto;
-  padding-top: 0.75rem;
-  padding-bottom: 0.75rem;
+  overflow: auto;
   font-size: 1rem;
   line-height: 1.5rem;
-  border-spacing: 0;
-}
-
-/* LineTable Line */
-
-.chroma .lntable .line {
-  padding-right: 1rem;
-}
-
-/* LineHighlight */
-
-.chroma .hl {
-  display: block;
-  width: auto;
-  --tw-bg-opacity: 1;
-  background-color: rgba(var(--color-primary-100), var(--tw-bg-opacity));
-}
-
-.dark .chroma .hl {
-  --tw-bg-opacity: 1;
-  background-color: rgba(var(--color-primary-900), var(--tw-bg-opacity));
 }
 
 /* LineNumbersTable */
@@ -1239,11 +1213,9 @@ body:has(#menu-controller:checked) {
 
 .chroma .lnt,
 .chroma .ln {
-  margin-right: 0.4em;
-  padding-left: 0.4em;
-  padding-right: 0.4em;
-  padding-top: 0px;
-  padding-bottom: 0px;
+  margin-right: 0.5rem;
+  padding-left: 0.5rem;
+  padding-right: 0.5rem;
   --tw-text-opacity: 1;
   color: rgba(var(--color-neutral-600), var(--tw-text-opacity));
 }
@@ -1254,6 +1226,29 @@ body:has(#menu-controller:checked) {
   color: rgba(var(--color-neutral-300), var(--tw-text-opacity));
 }
 
+.chroma .lntd {
+  padding: 0px;
+  vertical-align: top;
+}
+
+.chroma .lntd:last-of-type {
+  width: 100%;
+}
+
+/* LineHighlight */
+
+.chroma .hl {
+  display: block;
+  width: 100%;
+  --tw-bg-opacity: 1;
+  background-color: rgba(var(--color-primary-100), var(--tw-bg-opacity));
+}
+
+.dark .chroma .hl {
+  --tw-bg-opacity: 1;
+  background-color: rgba(var(--color-primary-900), var(--tw-bg-opacity));
+}
+
 /* Keyword */
 
 /* KeywordDeclaration */
@@ -1803,6 +1798,10 @@ body:has(#menu-controller:checked) {
   margin-top: -1rem;
 }
 
+.-mt-3 {
+  margin-top: -0.75rem;
+}
+
 .mr-2 {
   margin-right: 0.5rem;
 }
@@ -1891,6 +1890,10 @@ body:has(#menu-controller:checked) {
   height: 9rem;
 }
 
+.max-h-\[4\.5rem\] {
+  max-height: 4.5rem;
+}
+
 .max-h-\[10rem\] {
   max-height: 10rem;
 }
@@ -1951,6 +1954,10 @@ body:has(#menu-controller:checked) {
   max-width: 65ch;
 }
 
+.max-w-\[6rem\] {
+  max-width: 6rem;
+}
+
 .max-w-\[10rem\] {
   max-width: 10rem;
 }
@@ -2343,6 +2350,10 @@ body:has(#menu-controller:checked) {
   line-height: 1.75rem;
 }
 
+.leading-relaxed {
+  line-height: 1.625;
+}
+
 .leading-6 {
   line-height: 1.5rem;
 }
@@ -2441,6 +2452,12 @@ body:has(#menu-controller:checked) {
   transition-duration: 150ms;
 }
 
+.transition-colors {
+  transition-property: color, background-color, border-color, text-decoration-color, fill, stroke;
+  transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+  transition-duration: 150ms;
+}
+
 .transition-opacity {
   transition-property: opacity;
   transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
@@ -2568,6 +2585,14 @@ body:has(#menu-controller:checked) {
   text-decoration-color: rgba(var(--color-primary-500), 1);
 }
 
+.group:hover .group-hover\:decoration-2 {
+  text-decoration-thickness: 2px;
+}
+
+.group:hover .group-hover\:underline-offset-2 {
+  text-underline-offset: 2px;
+}
+
 .group:hover .group-hover\:opacity-100 {
   opacity: 1;
 }
@@ -2692,6 +2717,10 @@ body:has(#menu-controller:checked) {
   text-align: left;
 }
 
+.dark .dark\:inline {
+  display: inline;
+}
+
 .dark .dark\:flex {
   display: flex;
 }
@@ -2884,6 +2913,10 @@ body:has(#menu-controller:checked) {
     display: none;
   }
 
+  .sm\:max-h-\[7\.5rem\] {
+    max-height: 7.5rem;
+  }
+
   .sm\:w-1\/2 {
     width: 50%;
   }
@@ -2892,6 +2925,10 @@ body:has(#menu-controller:checked) {
     width: 10rem;
   }
 
+  .sm\:max-w-\[10rem\] {
+    max-width: 10rem;
+  }
+
   .sm\:flex-row {
     flex-direction: row;
   }

assets/css/main.css

@@ -1,4 +1,4 @@
-/*! Congo v2.4.2 | MIT License | https://github.com/jpanther/congo */
+/*! Congo v2.5.0 | MIT License | https://github.com/jpanther/congo */
 
 @tailwind base;
 @tailwind components;
@@ -23,7 +23,7 @@ body button {
 
 /* Hamburger menu */
 body:has(#menu-controller:checked) {
-  @apply overflow-y-hidden;
+  @apply fixed overflow-y-hidden;
 }
 #menu-button:has(#menu-controller:checked) {
   @apply invisible;
@@ -98,32 +98,31 @@ body:has(#menu-controller:checked) {
 
 /* -- Chroma Highlight -- */
 /* Background */
-.prose .chroma {
-  @apply static rounded-md bg-neutral-50 text-neutral-700 dark:bg-neutral-700 dark:text-neutral-200;
+.chroma {
+  @apply py-3 rounded-md bg-neutral-50 text-neutral-700 dark:bg-neutral-700 dark:text-neutral-200;
 }
-/* LineTableTD */
-.chroma .lntd,
-.chroma .lntd pre {
-  @apply p-0 m-0 overflow-hidden align-top border-none;
+.chroma pre {
+  @apply p-0 m-0;
 }
 /* LineTable */
 .chroma .lntable {
-  @apply block w-auto py-3 overflow-x-auto text-base;
-  border-spacing: 0;
-}
-/* LineTable Line */
-.chroma .lntable .line {
-  @apply pr-4;
-}
-/* LineHighlight */
-.chroma .hl {
-  @apply block w-auto bg-primary-100 dark:bg-primary-900;
+  @apply block w-auto m-0 overflow-auto text-base;
 }
 /* LineNumbersTable */
 /* LineNumbers */
 .chroma .lnt,
 .chroma .ln {
-  @apply mr-[0.4em] px-[0.4em] py-0 text-neutral-600 dark:text-neutral-300;
+  @apply px-2 mr-2 text-neutral-600 dark:text-neutral-300;
+}
+.chroma .lntd {
+  @apply p-0 align-top;
+}
+.chroma .lntd:last-of-type {
+  @apply w-full;
+}
+/* LineHighlight */
+.chroma .hl {
+  @apply block w-full bg-primary-100 dark:bg-primary-900;
 }
 /* Keyword */
 /* KeywordDeclaration */