Back to the catalog

Files

Bundle OKF 0.2 · 5 conceitos · arunendapally/arunendapally.github.io

Open source Repository Open in the app JSON README (API)

About

# Files

- [Quickstart](quickstart.md) - Orientation for this blog repository, covering what it is, how the site is assembled, and which wiki page to read for each common task from writing a post to upgrading the theme.

# Directories

- [architecture](architecture/)
- [operations](operations/)
- [tools](tools/)
- [workflows](workflows/)

Details

Kind
OKF bundles
Topic
Files & documents
Publisher
arunendapally
Origin
okf_github
Category
dados
Version
0.2
Last push
2026-08-28T08:47:17Z
Repository state
ativo
Language
HTML
License
MIT
Added
2026-09-08 02:18:52
Updated
2026-09-08 02:18:52
Origin id
arunendapally/arunendapally.github.io:openwiki/index.md

README

# arunendapally.com

Source for [arunendapally.com](https://arunendapally.com) — a technical blog on software architecture, cloud, and applying AI in engineering. Built with [Jekyll](https://jekyllrb.com/) and the [Chirpy](https://github.com/cotes2020/jekyll-theme-chirpy) theme.

## Local development

Requires Ruby 3.1+ and Bundler.

```shell
bundle install   # resolves deps from the Gemfile
bundle exec jekyll serve   # http://localhost:4000
```

`Gemfile.lock` is **not** committed. A lock generated on Windows pins mingw-only builds of
`google-protobuf` and `sass-embedded`, which the Linux CI runner cannot install; regenerating
it on Windows pulls gem versions (`json`) that fail to build locally. CI resolves fresh
against the `Gemfile`, which is why `jekyll-theme-chirpy` carries an explicit version
constraint there.

`--livereload` and `--detach` do not work on Windows: the first needs eventmachine's
native extension, the second needs `fork`. Plain `serve` still rebuilds on save, so
just reload the browser.

## Verification

- **Build**: `bundle exec jekyll build`
- **CI**: `.github/workflows/pages-deploy.yml` builds on Ruby 3.4, then runs `html-proofer` (external links disabled) on the `_site` output.

## Intentional customizations (re-diff when upgrading the Chirpy theme)

- `assets/css/jekyll-theme-chirpy.scss` — widens content to 1600px and fixes the back-to-top button position.
- `_includes/post-sharing.html` — adds the post's SEO description to share links.
- `_plugins/posts-lastmod-hook.rb` — the Chirpy last-modified plugin (from the starter). It needs `fetch-depth: 0` in CI, which the workflow sets.

## Deploy

GitHub Pages via the `pages-deploy` workflow on `main` (Source: GitHub Actions).

## License

Blog content © Arun Endapally. Theme under [MIT](https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/LICENSE).

More