How The Site Works
The site is written in Hugo because the creator wanted to get more experience in Golang when possible and it’s a good static site generator to host content like blogs, which this functionally is. Content is all in markdown format and needs to be written for or converted to Markdown. Decap CMS is the backend/CMS/admin panel and Netlify hosts the site along with handling DNS for the domain, with a private repo on GitHub acting as the source of truth for all files and the point from which Netlify continuously deploys the site, including bidirectionally with changes from Decap prompting changes in the GitHub repo leading to deploys on Netlify.
Notes on using the site
- You can either contact the maintainer to be added to the Admin panel to work on content directly, send content to the maintainer, or upload through an in-the-works Discord bot living somewhere sometimes.
- For converting content: contact the maintainer, use the bot, use pandoc or one of the many online markdown live editors like StackEdit is a favorite.
- Right now the site is a bit barebones, there’s plenty fun going on under the hood and I’m working out issues as they pop up, mostly around data – schemas, validation, all that fun stuff.
- Tags are meant to be more freeform while Categories will likely have a list to stick to. That makes sense to me to differentiate the two and it feels like there should be both.
- I’m a fan of the styling of the site, especially respecting system preferences for light/dark mode but I don’t like the quotation marks in the font. Maybe that will change, probably not, overall the font is good and readable and “Lorado” feeling to me.
- I don’t really work with content management systems or frontend, so be patient with any quirks or issues.
Bugs / Feature Requests
- New Author syncing: Blogs with new Authors don’t properly sync them,
/authors/will display the author’s name in the list of all authors but/author/{new author name}will not display properly. Fix is to add the Author via. the Admin panel or GitHub. - Some fields aren’t optional that should be, such as Descriptions on Posts. Working on this one, Decap is new to me and where the problem is.