Από το Hugo στο MkDocs

Πρώτη δημοσίευση: 2024-12-01

Δεν θυμάμαι για πόσον καιρό αναφερόμουν ή διάβαζα για static site generators και το μυαλό μου αυτόματα πήγαινε στο Hugo.

Σίγουρα για πολύ καιρό.

Από πολύ νωρίς με είχε κερδίσει η ταχύτητα του Hugo. Επίσης, ανέκαθεν εκτιμούσα την διαθεσιμότητα σε themes. Προσωπικά, για ένα site που στηρίζεται κυρίως στο περιεχόμενο με τη μορφή απλού κειμένου, πάντα κοιτάζω προς τα λιτά themes. Κι επειδή μ' αρέσει και το retro look, η προηγούμενη εκδοχή του kolderson-net βασιζόταν στο συνδυασμό Hugo και no-style-please.

Κάτι πάντως που δεν μ' ενθουσιάζει με τα themes του Hugo, είναι ότι η ανάπτυξη/συντήρησή τους φορές σταματά. Εδώ που τα λέμε, αυτό δεν συμβαίνει μόνο με τα themes του Hugo. Κι αν γνώριζα περί CSS, theme design και τέτοια, πιθανώς να μη μ' απασχολούσε καν το τι (δεν) κάνει ο developer του όποιου theme μ' αρέσει ή έχω ήδη επιλέξει. Αλλά δεν γνωρίζω περί CSS, theme design και τέτοια -- και μεταξύ μας δεν προβλέπεται να μαθαίνω σύντομα.

Από την άλλη, στη nine-to-five έχουμε ένα public-facing documentation site, το οποίο βασίζεται στο MkDocs. Σε σύκγριση με το Hugo (βασίζεται στη Go), το MkDocs (βασίζεται στην Python) είναι λίγο πιο αργό, διαθέτει λιγότερα themes, αλλά την ίδια στιγμή είναι και σαφώς πιο εύκολο όσον αφορά στη διαμόρφωση ενός site.

Ομολογώ ότι αυτή η ευκολία δεν με αφήνει ασυγκίνητο. Το μόνο που με προβλημάτισε, όταν για πρώτη φορά σκέφτηκα να φέρω το kolderson-net στην πλατφόρμα του MkDocs, ήταν ότι το τελευταίο είναι προσανατολισμένο για τη δημιουργία documentation sites. Κοίταξα πάντως στη λίστα με τα 3rd-party themes, και πολύ γρήγορα την προσοχή μου κέρδισε το Terminal for MkDocs.

Προφανώς, το απλό, όμορφο και retro "terminal" look, ήταν αυτό που μ' έκανε να σταθώ στο συγκεκριμένο theme. Ξεκάθαρα, και αυτό προορίζεται για documentation site. Σκέφτηκα, όμως, ότι θα μπορούσα να το χρησιμοποιήσω και για ένα blog -- έστω και με το ζόρι.

Δεν έμεινα μόνο στη σκέψη. Χωρίς καμία καθυστέρηση το εγκατέστησα και γρήγορα-γρήγορα δημιούργησα μια κάποια δομή που να ταιριάζει σε site για blogging. Στη συνέχεια μετέφερα όλες τις δημοσιεύσεις από το "παλιό" kolderson-net, και το αποτέλεσμα είναι αυτό που βλέπετε.

Θέλω να πιστεύω ότι ο συνδυασμός MkDocs και Terminal for Docs θα αντέξει στο χρόνο, ακόμη κι όταν αρχίσω να υλοποιώ κάποιες δυνατότητες/χαρακτηριστικά που ξεφεύγουν από το "απλό" blogging. Προς το παρόν δεν λέω κάτι συγκεκριμένο, γιατί έχω αρχίσει να πιστεύω στη γρουσουζιά (όχι ακριβώς, αλλά το αφήνω εδώ).

Τι λέτε κι εσείς; Πώς σας φαίνεται η νέα όψη του kolderson-net; Θα χαρώ να διαβάσω ό,τι έχετε να γράψετε για το όλο θέμα και, γιατί, όχι, αν μπορώ να βοηθήσω κιόλας σε κάποιο σχετικό πρότζεκτ που σας απασχολεί.