Fri, 15 Jul 2022
-pblog
has received its first community patch! By “community” I mean someone other than myself has helped make this blog generator even better. So special thanks to Matthew Graybosch for contributing to this humble project and patching in some solid quality of life improvements.
This is why open source is great: smarter people can help fix your mashed-up spaghetti code!
The Changes
- Both pages and posts now generated Table of Contents by default
- You have the ability to disable this site-wide in the
pblog
config
- You have the ability to disable this site-wide in the
- Ability to disable Pandoc generated syntax highlighting
xsltproc
will now generate HTML5 and include the RSS feed description under the title- See it live on the main RSS XML feed
- New metadata variable (
HTML_LANG
) in thepblog.sh
config - Generated pages and posts now have “Table of Contents” by default
- This can be disabled in individual files with
toc: false
- This can be disabled in individual files with
- Cleaned up redundant find statements
Some Features Left Behind…
Also suggested in this patch was the addition of more advanced image manipulation via ImageMagick
. This additional feature was pretty great from my testing but I felt as though adding an extra dependency and slightly more complex settings to pblog
was moving things further from simplicity.
BUT - that doesn’t mean you can’t take this great feature with you!
Introducing “Tweaks”
I feel that pblog
should always remain as simple as possible at the core. Let people get something up-and-running with the least amount of friction as possible. But I know that some users might want to squeeze just a little bit more out of it. This is where the new Tweaks section comes in.
Feel free to check out the official Tweaks page and don’t be afraid to add your own by opening a patch-set!
That’s all for now, thanks for reading!
– Brad
+pblog
has received its first community patch! By “community” I mean someone other than myself has helped make this blog generator even better. So special thanks to Matthew Graybosch for contributing to this humble project and patching in some solid quality of life improvements.
This is why open source is great: smarter people can help fix your mashed-up spaghetti code!
+The Changes
+-
+
- Both pages and posts now generated Table of Contents by default
+
-
+
- You have the ability to disable this site-wide in the
pblog
config
+
+ - You have the ability to disable this site-wide in the
- Ability to disable Pandoc generated syntax highlighting +
xsltproc
will now generate HTML5 and include the RSS feed description under the title +-
+
- See it live on the main RSS XML feed +
+- New metadata variable (
HTML_LANG
) in thepblog.sh
config
+ - Generated pages and posts now have “Table of Contents” by default
+
-
+
- This can be disabled in individual files with
toc: false
+
+ - This can be disabled in individual files with
- Cleaned up redundant find statements +
Some Features Left Behind…
+Also suggested in this patch was the addition of more advanced image manipulation via ImageMagick
. This additional feature was pretty great from my testing but I felt as though adding an extra dependency and slightly more complex settings to pblog
was moving things further from simplicity.
BUT - that doesn’t mean you can’t take this great feature with you!
+Introducing “Tweaks”
+I feel that pblog
should always remain as simple as possible at the core. Let people get something up-and-running with the least amount of friction as possible. But I know that some users might want to squeeze just a little bit more out of it. This is where the new Tweaks section comes in.
Feel free to check out the official Tweaks page and don’t be afraid to add your own by opening a patch-set!
+That’s all for now, thanks for reading!
+– Brad
Wed, 27 Jul 2022
-If it wasn’t already obvious, this project has received a minor styling overhaul. But looks weren’t the only thing updated with this latest patch.
The total build process time is now two times faster!
Keep reading for more details.
The Default “Theme”
The styling changes aren’t anything ground breaking. They simply center the main content and add a little more visual separation of the content and backdrop. Again, you can customize pblog
as you see fit, but having a sane default is always nice.
New Config Setup
Since updates and performance fixes might continue to come through in the future, I didn’t want to make users play around with their default configuration every single time. Now, all main configuration is handled in the _config.sh
file.
Feels cleaner already, right?
Cutting the Build Time in Half
I must give big kudos to Matthew Graybosch for inspiring this pretty big improvement. After some discussion over emails we both agreed that it seemed overkill to render the blog content twice (once for the XML feed itself and then again for all posts listed under blog
). Performance wasn’t the initial goal when I first launched this project, but now that the dust has settled it seemed appropriate to go back and fix some things.
pblog
now only needs to render the blog posts found in the posts
directory once. It still produces semantic XML and keeps the webview versions of the articles looking solid. Overall I’m pretty happy with this little improvement - it should pretty noticeable on projects rendering many posts.
Far From Perfect
This project is still very much in it’s infancy. So if you notice something odd or broken in your own testing, please don’t hesitate to open a patch or simply bring up the issue!
Thanks for reading,
– Brad
+If it wasn’t already obvious, this project has received a minor styling overhaul. But looks weren’t the only thing updated with this latest patch.
+The total build process time is now two times faster!
+Keep reading for more details.
+The Default “Theme”
+The styling changes aren’t anything ground breaking. They simply center the main content and add a little more visual separation of the content and backdrop. Again, you can customize pblog
as you see fit, but having a sane default is always nice.
New Config Setup
+Since updates and performance fixes might continue to come through in the future, I didn’t want to make users play around with their default configuration every single time. Now, all main configuration is handled in the new _config.sh
file.
Feels cleaner already, right?
+Cutting the Build Time in Half
+I must give big kudos to Matthew Graybosch for inspiring this pretty big improvement. After some discussion over emails we both agreed that it seemed overkill to render the blog content twice (once for the XML feed itself and then again for all posts listed under blog
). Performance wasn’t the initial goal when I first launched this project, but now that the dust has settled it seemed appropriate to go back and fix some things.
pblog
now only needs to render the blog posts found in the posts
directory once. It still produces semantic XML and keeps the webview versions of the articles looking solid. Overall I’m pretty happy with this little improvement - it should pretty noticeable on projects rendering many posts.
Far From Perfect
+This project is still very much in it’s infancy. So if you notice something odd or broken in your own testing, please don’t hesitate to open a patch or simply bring up the issue!
+Thanks for reading,
+– Brad
pblog.xyz
Pandoc static blog generator