{"id":13707722,"url":"https://github.com/brennanbrown/enjoyment-work","last_synced_at":"2025-09-07T10:12:03.022Z","repository":{"id":40000823,"uuid":"313525411","full_name":"brennanbrown/enjoyment-work","owner":"brennanbrown","description":"🗃️ A Digital Garden: Capturing my daily thoughts and progress, as well as curated ideas with unique synthesis—a personal zettelkasten. Built on Simply Jekyll by Raghuveer S.","archived":false,"fork":false,"pushed_at":"2025-08-20T22:37:20.000Z","size":2779,"stargazers_count":107,"open_issues_count":3,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-21T00:25:56.257Z","etag":null,"topics":["digital-garden","jekyll","obsidian"],"latest_commit_sha":null,"homepage":"https://enjoyment-work.netlify.app","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brennanbrown.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"ko_fi":"brennan"}},"created_at":"2020-11-17T06:18:31.000Z","updated_at":"2025-08-20T22:37:23.000Z","dependencies_parsed_at":"2025-03-24T04:21:55.754Z","dependency_job_id":"56c6cc1f-5a91-45eb-9bb3-22606d006491","html_url":"https://github.com/brennanbrown/enjoyment-work","commit_stats":null,"previous_names":[],"tags_count":1,"template":true,"template_full_name":null,"purl":"pkg:github/brennanbrown/enjoyment-work","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brennanbrown%2Fenjoyment-work","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brennanbrown%2Fenjoyment-work/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brennanbrown%2Fenjoyment-work/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brennanbrown%2Fenjoyment-work/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brennanbrown","download_url":"https://codeload.github.com/brennanbrown/enjoyment-work/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brennanbrown%2Fenjoyment-work/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274022682,"owners_count":25209033,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["digital-garden","jekyll","obsidian"],"created_at":"2024-08-02T22:01:41.250Z","updated_at":"2025-09-07T10:12:02.999Z","avatar_url":"https://github.com/brennanbrown.png","language":"HTML","funding_links":["https://ko-fi.com/brennan"],"categories":["jekyll","HTML"],"sub_categories":[],"readme":"\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/brennanbrown/enjoyment-work\"\u003e\n    \u003cimg src=\"/assets/img/profile.png\" alt=\"Logo\" width=\"120\" height=\"120\"\u003e\n  \u003c/a\u003e\n\n  \u003ch3 align=\"center\"\u003eEnjoyment Work: Theme for Jekyll\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    An extensive Jekyll theme designed to have similar functionality to Roam Research.\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/brennanbrown/enjoyment-work\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003cstrong\u003e\u003ca href=\"https://enjoyment-work.netlify.app\"\u003eView Demo\u003c/a\u003e\u003c/strong\u003e\n    ·\n    \u003ca href=\"https://github.com/brennanbrown/enjoyment-work/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/brennanbrown/enjoyment-work/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\u003c!-- BADGES --\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://app.netlify.com/start/deploy?repository=https://github.com/brennanbrown/enjoyment-work\"\u003e\u003cimg alt=\"Deploy to Netlify\" src=\"https://www.netlify.com/img/deploy/button.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"Netlify Status\" src=\"https://api.netlify.com/api/v1/badges/3cc0e6e6-1ec8-4af8-ad0e-aced073231c4/deploy-status\"\u003e\n\u003ca href=\"https://github.com/brennanbrown/enjoyment-work/actions/workflows/ci.yml\"\u003e\u003cimg alt=\"CI\" src=\"https://github.com/brennanbrown/enjoyment-work/actions/workflows/ci.yml/badge.svg\"\u003e\u003c/a\u003e\n\u003cimg alt=\"GitHub code size in bytes\" src=\"https://img.shields.io/github/languages/code-size/brennanbrown/enjoyment-work\"\u003e \n\u003cimg alt=\"GitHub repo size\" src=\"https://img.shields.io/github/repo-size/brennanbrown/enjoyment-work\"\u003e \n\u003ca href=\"https://github.com/brennanbrown/enjoyment-work/search?l=html\"\u003e\u003cimg alt=\"GitHub top language\" src=\"https://img.shields.io/github/languages/top/brennanbrown/enjoyment-work\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/brennanbrown/enjoyment-work/issues\"\u003e\u003cimg alt=\"GitHub issues\" src=\"https://img.shields.io/github/issues/brennanbrown/enjoyment-work\"\u003e\u003c/a\u003e \n\u003ca href=\"https://github.com/brennanbrown/enjoyment-work/commits/main\"\u003e\u003cimg alt=\"GitHub last commit\" src=\"https://img.shields.io/github/last-commit/brennanbrown/enjoyment-work\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/brennanbrown/enjoyment-work/blob/main/LICENSE\"\u003e\u003cimg alt=\"GitHub license\" src=\"https://img.shields.io/github/license/brennanbrown/enjoyment-work\"\u003e\u003c/a\u003e \n\u003cbr /\u003e\n\u003ca href=\"https://github.com/brennanbrown?tab=followers\"\u003e\u003cimg alt=\"GitHub followers\" src=\"https://img.shields.io/github/followers/brennanbrown?label=Follow%20Me%21\u0026style=social\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/brennanbrown/enjoyment-work/watchers\"\u003e\u003cimg alt=\"GitHub watchers\" src=\"https://img.shields.io/github/watchers/brennanbrown/enjoyment-work?label=Watch%21\u0026style=social\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/brennanbrown/enjoyment-work/stargazers\"\u003e\u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/brennanbrown/enjoyment-work?label=Star%21\u0026style=social\"\u003e \u003c/a\u003e\n\u003ca href=\"https://github.com/brennanbrown/enjoyment-work/network/members\"\u003e\u003cimg alt=\"GitHub forks\" src=\"https://img.shields.io/github/forks/brennanbrown/enjoyment-work?label=Fork%21\u0026style=social\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e Note: A new update was released in 2025. See the detailed changes in the [Changelog](./CHANGELOG.md).\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n\n## About The Project\n\n**Enjoyment Work** is an academic / research-focused theme that provides extensive features for note-taking and personal growth. It is based off of the [Digital Garden](https://github.com/MaggieAppleton/digital-gardeners) philosophy, which you can read more about on the [**demo site**](https://enjoyment-work.netlify.app)\n\nThe next step for Enjoyment Work is to properly configure the syntax required to work with [**Obsidian**](https://obsidian.md/), a powerful knowledge base that works on top of a local folder of plain text Markdown files. Which would ultimately allow somebody to turn their Obsidian notes into an online blog by simply using the `_notes` directory.\n\nThere are several other planned features in the [Roadmap](#roadmap) ahead, as the project is far from perfect. It is currently using the Bootstrap 4 framework, which although is powerful and extensive, does slow thing down, along with the rather large `style.css` file which needs to be trimmed down and converted into SASS.\n\nIf you like the idea of being able to use Jekyll as a free alternative to Roam Research, Notion, etc. then please feel free to [**use this template**](https://github.com/brennanbrown/enjoyment-work/generate), or even better, contribute to this project by [submitting a pull request](https://github.com/brennanbrown/enjoyment-work/pulls) or [creating an issue](https://github.com/brennanbrown/enjoyment-work/issues)! First-time contributors are definitely welcomed!\n\nIn addition, I have created three other free Jekyll themes that you might be interested in:\n\n- :potable_water: [**Watery**](https://github.com/brennanbrown/watery): A minimalist, bare-bones theme for Jekyll only using the Water.css framework while still following the best practices for accessibility and search-engine optimization.\n- :notebook_with_decorative_cover: [**Purelog**](https://github.com/brennanbrown/purelog): A responsive sidebar Jekyll theme using the Pure.css framework, designed for writers and bloggers of all kinds.\n- [**Classic Spirits**](https://github.com/brennanbrown/classic-spirit): A classic sidebar Jekyll theme for old-school blogging, created with the Bulma framework. Built on Soot Spirits by Abhishek Nagekar.\n\n![Enjoyment-Work Screen Shot](/assets/img/end_result.jpg)\n\n### Features\n\nHere are a few interesting features of this Jekyll theme:\n\n- A fully customizable and empty `_BLANK_config.yml` to make getting up-and-running easy.\n- A speedy, on-site search function using [Simply Jekyll Search](https://github.com/christian-fei/Simple-Jekyll-Search).\n- Custom collections for different types of material (note-taking, journal writing, etc.)\n- An auto-generating `/archive` page that displays all entries from _all_ collections.\n- Auto-generating `/tags` and `/categories` pages.\n- Breadcrumbs for improved navigation and SEO.\n- Having a `_pages` collection for easier organization.\n- An author bio at the end of each post. (Located in `_inclues/author.html`)\n- Full Rouge support for [syntax highlighting](https://spsarolkar.github.io/rouge-theme-preview/). (Currently using `base16.dark`)\n- Auto-generated RSS feed, sitemap, accessibility features, and search-engine optimization.\n- Creates backlinks to other notes automatically\n- Context menu on feed to instantly see related posts and backlinks\n- Supports Roam-style double bracket link syntax to other notes\n- On hover page previews\n- Features a simple and responsive design\n- Supports Markdown or HTML notes\n\n## Installation\n\n### Prerequisites\n\nJekyll requires the following:\n\n- Ruby version **2.5.0** or higher\n- RubyGems\n- GCC and Make\n\nSee [Requirements](https://jekyllrb.com/docs/installation/#requirements) for guides and details.\n\n### Instructions\n\n1. Install all [prerequisites](https://jekyllrb.com/docs/installation/).\n2. Install the jekyll and bundler [gems](https://jekyllrb.com/docs/ruby-101/#gems).\n\n```\ngem install jekyll bundler\n```\n\n3. Clone this repository.\n\n```\ngit clone https://github.com/brennanbrown/enjoyment-work.git\n```\n\n4. Change into your new directory.\n\n```\ncd enjoyment-work\n```\n\n5. Install gems from the `Gemfile`.\n\n```\nbundle install\n```\n\n6. Build the site and make it available on a local server.\n\n```\nbundle exec jekyll serve\n```\n\n7. Browse to [http://localhost:4000](http://localhost:4000)\n\nIf you encounter any errors during this process, check that you have installed all the prerequisites in [Requirements](https://jekyllrb.com/docs/installation/#requirements).\n\nIf you still have issues, see [Troubleshooting](https://jekyllrb.com/docs/troubleshooting/#configuration-problems).\n\n### Continuous Integration\n\nThis repo includes a GitHub Actions workflow (`.github/workflows/ci.yml`) that builds the site and runs HTMLProofer checks on PRs and pushes. Ensure you run `bundle install` locally after pulling to install the `html-proofer` gem.\n\n## Getting Started\n\nOnce you have Jekyll up-and-running, there are only a few steps needed to make this theme your own:\n\n1. Fill out the `_BLANK_config.yml` configuration file and replace the current `_config.yml`\n2. Remove the `example_posts` folder in `_posts`, `_notes`, `_journals` and start writing your own!\n3. Modify or remove the pages in `_pages` to however you see fit.\n4. _(Optional)_ Modify or remove this `README.md` with information about your own project or blog.\n5. _(Optional)_ Modify the CSS files in the `assets` folder to customize the site.\n\n\u003c!-- ROADMAP --\u003e\n\n## Roadmap\n\nThere are several features that I'm still planning to create and integrate, including:\n\n- Optimize and minify stylesheets and design. (SCSS pipeline added; continue trimming legacy CSS, consider reducing Bootstrap.)\n- Configure to work with Obsidian out-of-the-box. (Wikilinks supported; add image/file embeds and edge cases.)\n- Create a [Theme Gem](https://jekyllrb.com/docs/themes/#publishing-your-theme).\n- \"Deploy to Netlify\" button. (Done.)\n- Continuous integration with GitHub Actions + HTMLProofer. (Done.)\n- Additional documentation for custom collections and auto-generated pages.\n- More example posts and articles.\n\nSee the [open issues](https://github.com/brennanbrown/enjoyment-work/issues) for a list of proposed features (and known issues).\n\n\u003c!-- CONTRIBUTING --\u003e\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003c!-- LICENSE --\u003e\n\n## License\n\nDistributed under the MIT License. You can use this project however you see fit without needing to give attribution.\n\nSee `LICENSE` for more information.\n\n## Resources\n\nWhile creating this theme, I came across a lot of helpful and hard-to-find resources. If you'd like to dive deeper into Jekyll, check them out:\n\n- Jumping Into Jekyll: https://dev.to/brennan/jumping-into-jekyll-4o9h\n- Jekyll Cheatsheet: https://devhints.io/jekyll\n- Course on Jekyll: https://learn-the-web.algonquindesign.ca/topics/jekyll/\n- Jekyll for Designers: http://simpleprimate.com/jekyll-for-designers/index.html\n- Dynamic Copyright on Jekyll: https://michaelsoolee.com/jekyll-copyright/\n- Creating breadcrumbs in Jekyll: https://jekyllcodex.org/without-plugin/breadcrumbs/\n- Display all items from ALL collections: https://stackoverflow.com/questions/31171041/listing-all-collections-in-jekyll\n\n### Other Resources\n\n- For markdown previews: https://jaspervdj.be/lorem-markdownum/\n- Case Study on webfont performance: https://www.keycdn.com/blog/web-font-performance\n- An extensive `.gitignore`: https://miguelmota.com/bytes/extensive-gitignore/\n\n## Credit\n\n[**Simply Jekyll**](https://github.com/raghuveerdotnet/simply-jekyll) was created by [Raghuveer S.](https://github.com/raghuveerdotnet)\n\n[**Simple Jekyll Search**](https://github.com/christian-fei/Simple-Jekyll-Search) was created by [Christian Fei](https://github.com/christian-fei).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrennanbrown%2Fenjoyment-work","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrennanbrown%2Fenjoyment-work","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrennanbrown%2Fenjoyment-work/lists"}