README.md

salvatorelaisa.blog

Personal blog built on top of the Nuxt framework and exported as a static website.

Hosting and Continous Deployment is based on Github Pages & Actions.

The contents are my own personal thoughts and opinions. Images and videos that aren't of my own or made by me are always linked/embedded from external sources.

Built on top of

• Nuxt 3 - main application framework based on Vue 3
  • @nuxt/content - module to easily integrate content from markdown files
  • @nuxt/google-fonts - module to easily integrate Google Fonts
  • @nuxt/studio - module to enable the integration with the Nuxt Studio editing UI
• vanilla CSS - every style has been written using regular CSS syntax, leveraging Vue's CSS Module support
• remark-reading-time - Medium's like reading time estimation
• rss - utility to help create the RSS .xml file
• sitemap - utility to help create the sitemap .xml file

I'm also integrating with Nuxt Studio to play a bit with visual editing, which comes pretty handy when editing/writing content from devices like the iPad Mini.

Creating a new post

With an NPM script:

$ npm run new "post title"

or manually:

• go in the content folder
• clone the _template.md file
• edit the cloned file with your content

Customizations

I've added some small new features over the starting Nuxt template to handle some more blog-specific functionalities

• light/dark mode switcher (client side)
• live textual search for posts (by title only)
• "comments" to post through Threads or check the source markdown file on Github
• filter posts by tag
• "posts by year" page template, available at /post/year
• "Buy me a coffee" tip button
• "reading time" for posts
• "old post warning" for 2+ years old content
• "personal devices timeline" section
• CSS themes support (at the moment only an "xmas" one is included)

Can I use this to bootstrap my new Nuxt blog?

Sure you can! But this repo is not structured as a template for new projects so you will need to delete all of my content (which is not free to use) and references and add your own. It's not difficult but just a bit tedious, have fun!

License

Code released under the MIT license.