Eenvoudig inhoud schrijven in Hugo: integratie van Google Docs naar Markdown

Doelstelling

Ik hou van statische websites, ze zijn razendsnel en met mijn cloud dev-vaardigheden kan ik tegenwoordig gemakkelijk integraties maken waardoor het iets minder statisch is ;-) Terwijl ik bezig was met het opzetten van mijn learnportal voor testautomation kwam ik erachter dat het instellen van blogs in Hugo omslachtig is bij het opzetten van blogs in Hugo. Daarom heb ik geïnvesteerd in een eenvoudige oplossing voor het maken van inhoud, waarin ik eenvoudig blogs kan genereren in Google Docs en deze kan converteren naar Hugo, en dit naar gitlab kan publiceren voor productie

Om onze workflow voor blogpublicaties te verbeteren door schrijvers in staat te stellen inhoud te publiceren zonder dat ze rechtstreeks hoeven te communiceren met Hugo’s opmaaktaal of de onderliggende technische complexiteit van ons contentbeheersysteem.

Overzicht van de oplossing

We hebben een gebruiksvriendelijke interface geïntegreerd in ons interne learnautomatedtesting-portaal waarmee schrijvers blogposts kunnen indienen voor publicatie. Deze interface is ontworpen om de technische aspecten van blogpublicatie te abstraheren, met name het gebruik van Hugo-markup-definities, waardoor het proces toegankelijker wordt voor alle teamleden, ongeacht hun technische expertise.

HOE het werkt

Stap 1: De publicatie-interface openen

Schrijvers hebben rechtstreeks toegang tot de publicatie-interface via het interne portaal. Deze speciale interface is intuïtief en vereist geen voorkennis van Hugo of opmaaktalen.

Stap 2: Inhoud verzenden

Schrijvers voeren de inhoud en gegevens van hun blogpost in via eenvoudige formuliervelden, waaronder:

• Titel
• Inhoud (met een RTF-editor voor opmaak)
• Categorie en tags (geselecteerd uit vooraf gedefinieerde dropdowns)
• Publicatiedatum (indien planning vereist is)

De interface ondersteunt RTF-invoer, waardoor eenvoudige opmaak mogelijk is (bijvoorbeeld vet of cursief) zonder directe markup-interactie.

Stap 3: Geautomatiseerde conversie

Na indiening converteert het systeem de ingevoerde inhoud automatisch naar het juiste formaat dat door Hugo wordt vereist, inclusief het invoegen van de nodige markup-definities. Dit proces is transparant voor de gebruiker.

Stap 4: Beoordeling en publicatie

• De inhoud wordt vervolgens verplaatst naar een testomgeving waar deze kan worden beoordeeld en goedgekeurd door aangewezen beoordelaars.
• Na goedkeuring wordt de blogpost automatisch gepubliceerd op de live site, volgens een bepaald schema.

Belangrijkste voordelen

• Gebruiksgemak: schrijvers kunnen inhoud publiceren zonder Hugo’s opmaaktaal te hoeven leren.
• Efficiëntie: stroomlijnt het publicatieproces, waardoor de tijd tussen het creëren van inhoud tot de live publicatie wordt verkort.
• Kwaliteitscontrole: Handhaaft een beoordelingsproces om de kwaliteit van de inhoud te waarborgen en tegelijkertijd het proces voor het indienen van inhoud voor schrijvers te vereenvoudigen.

Conclusie

Deze geïntegreerde publicatie-interface is nu voor 80 procent klaar en vereenvoudigt het proces voor onze schrijvers aanzienlijk, waardoor ze zich kunnen concentreren op het creëren van hoogwaardige inhoud. Door de complexiteit van ons contentbeheersysteem te abstraheren, zorgen we voor een soepele, efficiënte workflow die zowel onze makers van inhoud als ons publiek ten goede komt.

Voor meer informatie of ondersteuning worden schrijvers aangemoedigd om contact op te nemen met ons contentmanagementteam.

Gebruikte tools: AWS API-gateway, AWS lambda S3, beeldconversie, Google appscript-add-on, gitlab ci