Kodformattering

Att kunna skriva kodexempel och visa kod på den här sidan är ett måste. Som tur är så finns det tillgängligt med Eleventys Syntax Highlight Plugin. Det använder i sin tur Prism för att stila koden.

Att inkludera CSS för ett Prism-tema är sedan nästa steg. Detta följs av dilemmat kring att bli nöjd med helheten, Prism-temat och sidans stilar.
Önskar en fler teman än Prisms standard, så finns Prism themes GitHub repo.

Min tanke för den här sidan är/var att utgå från GitHubs tema och sedan ändra. Vi får se hur det går kan nu se hur det gick.

Installera först pluginet.

npm i @11ty/eleventy-plugin-syntaxhighlight

Pluginet behöver sedan laddas i konfigurationen.

const syntaxHighlight = require('@11ty/eleventy-plugin-syntaxhighlight');

module.exports = function (eleventyConfig) {
    eleventyConfig.addPlugin(syntaxHighlight);
};

Sedan behöver Prisms css laddas, detta kan göras med lokal fil eller från CDN.

<link
    rel="stylesheet"
    href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.23.0/themes/prism.min.css"
    integrity="sha512-tN7Ec6zAFaVSG3TpNAKtk4DOHNpSwKHxxrsiw4GHKESGPs5njn/0sMCUMl2svV4wo4BK/rCP7juYz+zx+l6oeQ=="
    crossorigin="anonymous"
    referrerpolicy="no-referrer"
/>
<!-- eller -->
<link rel="stylesheet" href="/css/prism.css" />

Fontstorleken behöver åtgärdas då den annars blev för stor för kodavsnitt.

.text-small {
    font-size: ms(0) !important;
}

Just fonten flyttade sedan in i ett eget Prism-tema. Koden här nedan formaterar “kod-styckena” i texten.

$code-paths: (
    1: polygon(0 0, 100% 2%, 100% 98%, 0% 100%),
    2: polygon(0 2%, 100% 0, 100% 100%, 0 98%),
);

pre {
    width: 100vw !important;
    margin-left: 50% !important;
    transform: translateX(-50%) !important;
    display: flex;
    align-content: center;
    &:nth-of-type(even) {
        clip-path: map-get($code-paths, 1);
    }
    &:nth-of-type(odd) {
        clip-path: map-get($code-paths, 2);
    }
    code {
        width: 100%;
        display: inline-block;
        margin-left: auto !important;
        margin-right: auto !important;
        padding: ms(1) !important;
        max-width: 45.18rem !important;
    }
}

Detta tog inte direkt hand om temat dock.

Jag provade att skapa ett eget tema med en generator men blev inte så nöjd.
Vad det blev i slutändan syns på sidan och kommer säkert att ändras. Jag utgick från Prism Duotone Space för att få en enkel grund. Sedan ändrade jag på färgerna.

Här kan du titta på CSS-resultatet.