https://github.com/rami-sabbagh/rami-sabbagh.github.io
The source-files of my personal blog.
https://github.com/rami-sabbagh/rami-sabbagh.github.io
blog engineering hugo-eureka programming
Last synced: 3 months ago
JSON representation
The source-files of my personal blog.
- Host: GitHub
- URL: https://github.com/rami-sabbagh/rami-sabbagh.github.io
- Owner: Rami-Sabbagh
- Created: 2021-12-10T22:51:47.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-14T21:47:05.000Z (6 months ago)
- Last Synced: 2025-01-20T15:34:15.554Z (5 months ago)
- Topics: blog, engineering, hugo-eureka, programming
- Homepage: https://rami-sabbagh.com
- Size: 5.59 MB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# https://rami-sabbagh.com/
Welcome to the source-files of my personal blog 👋
The website is statically generated using [HUGO](https://gohugo.io/) with the nice [Blowfish](https://blowfish.page/) theme.
## Fix file permissions changes in `blowfish` sub-modules on Windows
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:
```txt
old mode 100755
new mode 100644
```
To prevent those changes from being picked up by git, run the following within the same previous directory:
```pwsh
git config core.fileMode false
```
## CLI Recipes
- Clone with submodules: `git clone --recurse-submodules `.
- 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`.
## Writing Tips
- Check [Shortcodes](https://blowfish.page/docs/shortcodes/) for enhancing content within posts.
- There's one for [GitHub Repository Card](https://blowfish.page/docs/shortcodes/#github-card), good for fancy display of repositories.
- There's a fancy [`timeline`] shortcode for listing events!
- For typewriter effect on text: [`typeit`](https://blowfish.page/docs/shortcodes/#typeit).
- For lightweight embedding of YT content: [`youtubeLite`](https://blowfish.page/docs/shortcodes/#youtube-lite).
- [Lead](https://blowfish.page/docs/shortcodes/#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 `lead` shortcode.
- For Arabic/RTL content, there's a short-code to switch direction within the post: [`rtl`](https://blowfish.page/docs/shortcodes/#ltrrtl).
- For including Markdown fragments from external sources, use [`mdimporter`](https://blowfish.page/docs/shortcodes/#markdown-importer).
- For color palettes, theres [`swatches`](https://blowfish.page/docs/shortcodes/#swatches).
- It's possible to link posts on other blogging platforms, and published research articles by defining [externalUrl](https://blowfish.page/docs/content-examples/#external-links) in the front-matter.
- When there's a series of posts, they better be [defined as so](https://blowfish.page/docs/series/#series-behavior) in Blowfish.
- It's possible to override theme parameters for posts within a directory using the [`cascade`](https://blowfish.page/docs/content-examples/#list-pages) parameter within the front-matter of the `_index.md` for that directory.
## Theme Documentation Links
- [Blowfish Content Samples](https://blowfish.page/samples/).
- [Blowfish Front-matter](https://blowfish.page/docs/front-matter/).
- [Blowfish Multi-authors](https://blowfish.page/docs/multi-author/).
- [Blowfish Advanced Customization](https://blowfish.page/docs/advanced-customisation/).