From 54229faa10374bd3d4223e02b73211d11f3e8d22 Mon Sep 17 00:00:00 2001 From: Georg Makowski Date: Mon, 4 Dec 2023 12:13:43 +0100 Subject: [PATCH 1/2] Add the Perplex theme for Hugo: 'perplex.md' --- content/theme/perplex.md | 65 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 content/theme/perplex.md diff --git a/content/theme/perplex.md b/content/theme/perplex.md new file mode 100644 index 000000000..b0b04a4ca --- /dev/null +++ b/content/theme/perplex.md @@ -0,0 +1,65 @@ +--- +title: Perplex +github: https://github.com/bowman2001/perplex +demo: https://perplex.desider.at +author: Georg Makowski +date: 2023-12-04 +ssg: + - Hugo +cms: + - No CMS +archetype: + - Blog + - News + - Documentation +description: Advanced Markdown documentation and multi-purpose theme with a fluid-responsive typographic layout. +--- + +# Perplex + +This documentation and multi-purpose theme focuses on good legibility by providing a detailed rich layout. It’s highly optimized for speed by self-hosting resources. No other software is required to start a new project. + +[**The documentation**][doc] is also the **demonstration site**. If you want to get started right away visit the [workflow introduction][intro]. + +## Features + +All kinds of pages are rendered into the same coherent **fluid-responsive layout grid**. The detailed typographic design is based on classic principles and techniques. The theme can generate + +- large documentation with up to three menu levels + +- blog postings + +- a news stream + +- author pages + +- card previews + +The default styling of Markdown content is **optimized for good legibility** and there are many options to further enhance the layout. **Light & dark** modes follow the setting of the OS environment automatically. + +**All navigational elements** to sift through the content as fast as possible are generated from data in the frontmatter: + + - Site menu at the top + + - Sidebar menu for documentation + + - Taxonomies + + - Page-to-page links + + - Breadcrumbs + +Google’s [Material Symbols][ms] and [Simple Icons][si] for brands can be included by their identifiers. Material Symbols automatically show in all navigational elements of the documentation. All icon sets can also be used as Markdown content (using shortcodes). + +The **appearance of images** can be controlled to a large extent. The theme handles their preprocessing and the generation of all the needed variants. They are delivered smoothly with [Lazysizes][ls] and without layout shifts. + +To offer a **full-text search** the theme is prepared to generate and self-host indices with the fast library [Pagefind][pf] (the additional installation of its open-source node package is required). + +Sites built with this theme are **very fast and cost-effective**. Image sets are highly optimized to minimize the needed bandwidth (and loaded lazily), fonts are split into small packages, and icons are embedded inline. + +[doc]: https://perplex.desider.at/doc +[intro]: https://perplex.desider.at/doc/intro/workflow/ +[ms]: https://fonts.google.com/icons +[si]: https://simpleicons.org +[ls]: https://github.com/afarkas/lazysizes +[pf]: https://pagefind.app From 1ea4e40b205c37afb4fd2a654687eadea0d549cd Mon Sep 17 00:00:00 2001 From: Georg Makowski Date: Mon, 4 Dec 2023 12:37:37 +0100 Subject: [PATCH 2/2] Remove 'news' from archetype list. Add 'Multi Purpose' instead. --- content/theme/perplex.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/theme/perplex.md b/content/theme/perplex.md index b0b04a4ca..a7886dfcb 100644 --- a/content/theme/perplex.md +++ b/content/theme/perplex.md @@ -9,9 +9,9 @@ ssg: cms: - No CMS archetype: - - Blog - - News - Documentation + - Blog + - Multi Purpose description: Advanced Markdown documentation and multi-purpose theme with a fluid-responsive typographic layout. ---