Vejledningen er en gennemgang af DDB CMS’ overordnede struktur og redaktionelle funktioner. Den er rettet mod medarbejdere, der fungerer som redaktører eller andre typer af indholdsproducenter på sitet. Vejledningen introducerer også forskellige værktøjer, der anvendes til at strukturere indhold og administrative/tekniske funktioner (f.eks. brugeradministration), som kan være relevante for både redaktører og webmastere..
Manualen er lavet i Jekyll og er hostet på GitHub Pages. Jekyll-temaet Minimal Mistakes er anvendt og tilknyttet som "remote theme".
Der er lavet små "hacks" til Minimal Mistakes.
- Der er indsat autogenereret menu i sidebar på sider der tilhører collections. Det er gjort ved at tilrette
sidebar.html
Søgefeltet i manualen virker med Algolia søgemotor. Der er oprettet et Github Action workflow der sætter reindeksering i gang ved hvert Github Pages rebuild.
Når du laver ændringer til manualen i en branch på GitHub bliver der automatisk bygget en version af sitet hvor du kan se resultatet. Du kan tilgå forhåndsvisningen på følgende måder:
- Klik på navnet på branchen i listen over environments til højre på repositoriets forside og klik på "View deployment"
- Under et pull request for branchen klik på "View deployment"