Kristoffer Qvists blogg om allt möjligt

Etikett: Grav

Åter till gammal trotjänare

Bild på datorskärm som visar statistik.

Statistic”. Bild av JuralMin. Licens: CC0

Som ni säkert har noterat på sistone har jag modifierat min hemsida rätt mycket. Jag har testat både databaslösa innehållshanteringssystem och andra med databas också. Misstänker att man av ”gammal vana” återvänder till en gammal trotjänare som man använt sedan tidigare. Därmed inte sagt att nytt är sämre än gammalt och beprövat. Som ny på marknaden gäller det även att komma över vissa bekvämlighetströsklar.

Grav och Bludit

Jag har tidigare provat på databaslösa system, såsom Grav och Bludit. Båda har lite olika approach; Grav är rätt modulärt med flera tillägg som man kan installera. Installationen av tilläggen sker antingen genom att man skriver kommandon i kommandoraden, eller att man laddar ned .zip-filer i rätt katalog. Bludit kommer med rätt mycket färdigt, och man kan vid behov även här installera tillägg. I Bludit kan man enbart ladda ned nya tillägg i rätt katalog.

Vad gäller användargränssnitt är dessa också väldigt annorlunda bland dessa två.  Grav har inte ett administrativt användargränssnitt i grundpaketet. Däremot finns det möjlighet att ladda ned detta från projektets hemsida med baspaketet. Själva administrativa gränssnittet är väldigt rent och snyggt enligt mitt tycke (ja, nu är jag helt och hållet ”objektiv”)*. Bilder och dokumentation finns tydligt framlagt på deras hemsida, så när som på om man vill modifiera lite efter eget tycke.

Bludit kommer från start med ett administrativt gränssnitt. Vissa delar kan man direkt känna igen från WordPress medan andra inställningar kanske inte är lika tydliga. Bludit kan provas på deras demosida.

Båda är bra på sina sätt men i slutändan vinner enkelheten av att använda systemen för mig. Ja, det går att modifiera en sajt så att man är väldigt nöjd med den. För mig når WordPress det väldigt fort medan det tar avsevärt längre tid med Grav och Bludit.

WordPress – min gamla trotjänare

WordPress har sina för- och nackdelar också. Dock så vinner den  genom att det går fort att skapa en sida och även börja skriva med. Det gick även fort med de tidigare två nämnda programmen, men de behövde modifieras efter mitt tycke när jag använde dem. Tiden som gick åt att modifiera dem tog längre tid än att göra samma med WordPress. Det kan också ha att göra att jag faktiskt länge har suttit med WordPress, men det är en annan femma…

*Jag tycker mig vara väldigt tydlig när jag är sarkastisk, men ibland finns det några läsare som tror att jag är gravallvarlig. I meningen var jag sarkastisk – som jag vill förtydliga för dessa läsare.

Lägga till arkivsida i Grav

Eftersom detta är en blogg är det för mig naturligt att man har en så kallad ”arkivsida”. I denna kan man visa då samtliga inlägg skrivna en viss månad eller ett visst år. Det finns ett plugin till Grav som gör detta, men denna är inte automatiskt igång. Det finns förstås färdiga skelett som kommer med mycket färdiggjort, men väljer man däremot att skräddarsy sin sajt med enbart det man behöver bör man ha lite kunskap inom PHP, HTML och Twig.

Mitt inlägg är inspirerat av Bszymans inlägg, som behandlar just detta ämne. Även om pluginet har viss dokumentation på deras Github-sida, är den inte riktigt fullständig. Jag vill också lägga till vissa punkter som jag upplever att båda saknade.

Mål och förklaringar

Målet med detta är att skapa en arkivsida som kan användas i bloggen. Det andra målet är att bloggen skall kunna använda sig av en URL som är mer snarlik en svensk URL än en engelsk. Dock kan man välja att ha kvar de engelska kategorinamnen och ändra arkiv-urlen till engelska om man upplever att det skulle fungera bättre för sin blogg.

Jag använder mig av vissa ord och uttryck i nedan text, nedan finns dessa förklaringar:

  • grav-root Mapp/katalog där Grav är installerat
  • _temanamn Då alla teman heter olika, är det tänkt att detta skall vara samma tema du som läser använder

Välj tema som stödjer arkiv

För att minimera den tid som man behöver skräddarsy sin sajt, rekommenderar jag att man använder ett tema som stödjer arkiv-funktionen. Samtliga teman går att hitta på Gravs hemsida.

Installera och modifiera plugin

Själva pluginet kan installeras via kommandoraden, om man är under grav-root, skriver man bin/gpm install archives i kommandoraden. Pluginet kommer därefter att finnas under grav-root/user/plugins/archives. För att modifiera pluginet ändrar man i grav-root/user/plugins/archives/archives.yaml. Nedan visar jag ett exempel då man vill använda ”blogg” istället för ”blog” som kategori för blogginlägg:

enabled: true
built_in_css: true
date_display_format: 'F Y'
show_count: true
limit: 12
order:
    by: date
    dir: desc
filter_combinator: and
filters:
    category: blogg
taxonomy_names:
    month: archives_month
    year: archives_year

Nu kan man även kopiera arkivinnehållet från plugin till temat. Det gäller att man kopierar filen grav-root/user/plugins/archives/templates/partials/archives.html.twig till grav-root/user/themes/_temanamn/templates/partials/archives.html.twig

Om temat inte har stöd för arkiv, kan nedan kodrad behövas läggas till i grav-root/user/themes/_temanamn/templates/partials/sidebar.html.twig

{% if config.plugins.archives.enabled %}
  <div class="sidebar-content">
    <h6 class="sidebar--heading">Archives</h6>
    <hr class="hr--small">
    {% include 'partials/archives.html.twig' with {'base_url':base_url_relative} %}
  </div>
{% endif %}

Modifiera sidfältet

För att ändra arkivfältet i själva sidfältet, modifiera filen grav-root/user/templates/partials/archives.html.twig. Ändra nedan kodrad

{{ base_url }}/{{ config.plugins... }}

till följande:

{{ base_url }}/arkiv/{{ config.plugins... }}

Modifiera mall och själva arkivsidan

Nu gäller det att dels skapa mallen för arkiv och själva arkivsidan. Först skapas mallen. Skapa filen grav-root/user/themes/_temanamn/templates/arkiv.html.twig. I denna skrivs sidans utseende. Nedan finns ett exempel på hur detta kan se ut:

{% embed 'partials/base.html.twig' %}

    {% block content %}

        <h1>Arkiv</h1>

        <div class="infinite-scroll columns small-12 large-8">
        {% for post in page.collection({'items':{'@taxonomy':{"category": "blogg", "archives_month": uri.param("archives_month")}}}) %}
            {% include 'partials/post-item.html.twig' %}
        {% endfor %}

        {% if config.plugins.pagination.enabled and collection.params.pagination %}
            {% include 'partials/load-more.html.twig' %}
        {% endif %}

        </div>

        <div class="sidebar columns large-4 show-for-large">
            <div class="sidebar--inner">
                {% include 'partials/sidebar.html.twig' with {'blog':page} %}
            </div>
        </div>
    {% endblock %}

{% endembed %}

Mallen säger åt systemet att dels hämta sidans utseende, men också att hämta sidofältet. För att använda mallen i en sida måste denna sida nu skapas. Skapa mappen grav-root/user/pages/arkiv och filen grav-root/user/pages/arkiv/arkiv.md. Fyll i nedan innehåll i filen arkiv.md

---
content:
items:
    "@page.children": "/blogg"
---

Nu bör det finnas en fungerande arkivsida på sajten. Det finns förmodligen sätt att få den sidan ännu bättre, men sidan ser redan nu väldigt bra ut.

Äntligen ombyte!

Jag har tidigare främst använt mig av WordPress som innehållshanteringssystem för min blogg. Det har visserligen fungerat bra ett bra tag för mig, men det har under årens lopp också medfört vissa bekymmer. Dock har jag ändå lärt mig mycket utav detta, dels vikten av att faktiskt ha en god lösning vad gäller cache men också hurpass länge jag kunde använda det systemet med väldigt begränsade resurser. Jag kommer att migrera de flesta inlägg till denna sajt så småningom.

Idag har jag förstås något bättre resurser och (förhoppningsvis) även ett lättare innehållshanteringssystem, vad gäller resursanvändningen. I slutändan handlar det om att kunna göra det man själv vill inom de ramar som man har. Jag själv tycker att det är en rolig utmaning att faktiskt kunna ”klämma ut” så mycket kräm som möjligt ur så få resurser som möjligt.

En gång i tiden var faktiskt denna hemsida i en Raspberry Pi modell B (precis, den innan B+), men det var för ungefär fyra år sedan. Dock är denna inte kvar på den maskinen, som jag för övrigt har kvar. Men med den ”ledig” så kan jag hålla på med andra projekt som jag finner roliga, även om Raspberry Pi modell B version 2 eller senare har fler stödda operativsystem.

Nu är det alltså dags att använda ett system som inte använder en traditionell databas. I stället använder jag mig av vad man i engelskan kallar för ”Flat file database”, vilket betyder att data sparas i textfiler. Den främsta orsaken är att jag driver en mindre blogg som egentligen inte kräver en stor databas med flera användare.

© 2022 qvi.st

Tema av Anders NorenUpp ↑