Welcome to the source-files of my personal blog 👋
The website is statically generated using HUGO with the nice Blowfish theme.
If file changes appear within the blowfish submodule with no content changes, it's most likely permissions changes due to Windows filesystem.
You can verify so by opening a terminal in theme/blowfish and running git diff.
If the output contains something like:
old mode 100755
new mode 100644To prevent those changes from being picked up by git, run the following within the same previous directory:
git config core.fileMode false- Clone with submodules:
git clone --recurse-submodules <repo-origin>. - Start local server with live reload and drafts enabled:
hugo serve -D. - Build site for publishing:
hugo. - Create new post:
hugo new content posts/YYYY-MM-DD-my-new-post.md.
- Check Shortcodes for enhancing content within posts.
- There's one for GitHub Repository Card, good for fancy display of repositories.
- There's a fancy [
timeline] shortcode for listing events! - For typewriter effect on text:
typeit. - For lightweight embedding of YT content:
youtubeLite. - Lead: used to bring emphasis to the start of an article. It can be used to style an introduction, or to call out an important piece of information. Simply wrap any Markdown content in the
leadshortcode. - For Arabic/RTL content, there's a short-code to switch direction within the post:
rtl. - For including Markdown fragments from external sources, use
mdimporter. - For color palettes, theres
swatches.
- It's possible to link posts on other blogging platforms, and published research articles by defining externalUrl in the front-matter.
- When there's a series of posts, they better be defined as so in Blowfish.
- It's possible to override theme parameters for posts within a directory using the
cascadeparameter within the front-matter of the_index.mdfor that directory.