The Graphics Programming Blog - A collection of technical articles, project posts and show cases.
Fork the repo
Clone your fork
Write the technical article or project post by placing the file in the right directory inside blog/
I think a good folder structure is the following
a folder per year and inside a folder with a timestamp in form of yyyy-MM-dd and a short description of your blog entry, perhaps the slug of your post
yyyy/yyyy-MM-dd-short-description/index.md
index.md will be your main entry point and you can put whatever accompanying stuff like images in the same folder and refer to it relative to your article as usual
The second important bit here is the so called 'front matter' of the post, that one defines things like article date, authors, and tags, here is also where you define a slug
Example "front matter" (such a weird term)
---title:'GLSL Development Made Shrimple'slug:'glsl-development-made-shrimple'description:'Tips and tools to make GLSL development easier'date:'2024-10-17'authors:['jaker']tags:['glsl', 'opengl', 'vulkan', 'beginner', 'visual studio', 'visual studio code', 'article']image:'url to image which will be used when you paste the link to the article into social media apps like twitter or discord'---
In this case you can also see how jaker put his article into2024/2024-10-17-glsl-development-made-shrimple/index.md.
Pay attention to theslug value and how its the same value (sans the date) as the folder where you place index.md.
Third important bit is to place a truncate line in your article, so that the generator doesnt take the whole post as the post preview :)
Use a<!-- truncate --> comment to limit blog post size in the list view.
Consider adding your author tag to blog/authors.yml. Simply check how jaker/deccer were added and massage yours accordingly. The key of each entry is also the value which goes into theauthors: ["author_here", "coauthor"] thing.
Try it out locally:You need nodejs/npm installed.
cd blognpm inpm run start
http://localhost:3000 should open automatically