{"id":28404998,"url":"https://github.com/crisfeim/theme-hugo-bearnotes","last_synced_at":"2025-06-11T19:04:08.310Z","repository":{"id":46200957,"uuid":"276471613","full_name":"crisfeim/theme-hugo-bearnotes","owner":"crisfeim","description":"🎨 Bear Notes Hugo Theme","archived":false,"fork":false,"pushed_at":"2025-05-25T13:39:45.000Z","size":10577,"stargazers_count":109,"open_issues_count":4,"forks_count":14,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-30T18:33:43.734Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crisfeim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2020-07-01T20:06:03.000Z","updated_at":"2025-05-27T07:02:01.000Z","dependencies_parsed_at":"2023-12-27T16:52:15.528Z","dependency_job_id":null,"html_url":"https://github.com/crisfeim/theme-hugo-bearnotes","commit_stats":null,"previous_names":["crisfeim/zettels"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crisfeim%2Ftheme-hugo-bearnotes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crisfeim%2Ftheme-hugo-bearnotes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crisfeim%2Ftheme-hugo-bearnotes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crisfeim%2Ftheme-hugo-bearnotes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crisfeim","download_url":"https://codeload.github.com/crisfeim/theme-hugo-bearnotes/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crisfeim%2Ftheme-hugo-bearnotes/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":257506639,"owners_count":22555850,"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","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":[],"created_at":"2025-06-01T21:10:10.706Z","updated_at":"2025-06-11T19:04:08.303Z","avatar_url":"https://github.com/crisfeim.png","language":"HTML","funding_links":[],"categories":["HTML"],"sub_categories":[],"readme":"## Bear notes Hugo theme\n\nOnline Zettelkasten/Digital garden [Hugo](https://gohugo.io/) theme. \n\n### Sites using zettels\n\n- https://dilrong.com\n- https://digitalgarden.guidopercu.dev/\n- https://notas.cristian.lat\n\n![Screenshot1](screenshot1.png)\n![Screenshot2](screenshot2.png)\n\n### 💻 Installing \u0026 running\n\nOn your `config.toml`, set the theme as follows: theme = `\"github.com/crisrojas/zettels\"`, alternative you could just `git clone` this repo inside the \"themes\" folder or submodule it with `git submodule`.\n\n```bash\ngit submodule add https://github.com/crisrojas/zettels.git themes/zettels\n```\n\nFrom bear, export your notes as markdown into the content folder.\nYou'll also need to put there an _index.md file. This will be the webiste entry point.\n\nTo make things easier you could use one of this tools:\n\n- [Bear Markdown Export](https://github.com/andymatuschak/Bear-Markdown-Export)\n- [Bhugo](https://github.com/Zach-Johnson/bhugo/blob/master/main.go) (Be aware that native Hugo tags aren't supported yet)\n- [Bear markdown images fixer script](https://gist.github.com/crisrojas/6662f9fc78a99dc56c2c268a713a60ee) (please, make a backup before running the script)\n\nRun with `hugo server --disableFastRender` , this will avoid a weird bug that I've not tracked yet (content being rendered multiple times)\n\n\n### ⚙️ Config file\n\nThis is the `config.toml` [I'm using for publishing my notes](https://notas.cristian.lat). \n\nI'll add more details about usage in the future. For now you can copy-paste and replace the variables to fit your needs.\n\n\n\n```toml\nlanguageCode = \"es-ES\"\ntitle = \"Notas\"\nuglyURLS =  true\n\nrelativeURLs = true\n\npublishDir = \"public\"\npygmentsUseClasses = true\n\nassetDir = \"themes/zettels/assets\"\n\nDefaultContentLanguage = \"es\"\n\ntheme = \"zettels\"\n\n[outputs]\n  home = [\"HTML\", \"JSON\"]\n\n[params]\n    theme = \"duotone-light\" \n    bear = true\n    favicon = \"favicon.ico\"\n    author = \"Cristian Rojas\"\n\n# Enable tags.\n[taxonomies]\n    tag = \"tags\"\n\n\n# Allows rendering the html inside markdown\n[markup.goldmark.renderer]\nunsafe= true\n```\n\n\u003e ℹ bear = true uses filename as a title on the frontend instead the title yaml property.\n\n### 🎨 Themes\n\nOn your config file, pass the chosen theme as a parameter:\n\n```toml\n[params]\n  theme = \"duotone-light\" \n```\n\nYou can chose between *duotone-light* and *red-graphite*.\n\nMore Bear themes will be added in the future.\n\n### 🌎 Language\n\nOn your config file, pass the chosen language as a parameter:\n\n```tom\nDefaultContentLanguage = \"es\"\n```\n\nLanguages available: Spanish (\"es\"), English (\"en\"), French (\"fr\")\n\n### 🔗 Linking notes\n\nLinking is done through double-brackets syntax. \n\nEx.: `[[wikilink]]`, where \"wikilink\" is the filename of the note to be linked.\n\nI'll maybe add a feature to allow choosing linking from note's title instead of filename.\n\n```html\n\u003c!-- Input --\u003e\n[[biology]]\n\u003c!-- Regex looks for markdown file... --\u003e\nbiology.md\n\u003c!-- Output html --\u003e\n\u003ca href=\"biology.html\"\u003ebiology\u003c/a\u003e\n```\n\nSpaces in wikilinks are supported: `[[spaced link]]` outputs `\u003ca href=\"spaced-link.html\"\u003espaced link\u003c/a\u003e`\n\n### 🔙 Backlinks\n\nBacklinks are supported. Example → [here](https://notas.cristian.lat/empieza-haciendo-lo-que-sea-necesario-despu%C3%A9s-haz-lo-que-sea-posible-sin-darte-cuenta-y-al-cabo-de-un-tiempo-estar%C3%A1s-haciendo-lo-imposible.html)\n\n### Nested tags\n\nNested tags inside note content are rendered. Expect some errors on tricky cases.\n\n### UI/UX\n\nIf you're thinking this obviously looks a little too much like Bear, you're right.\n\nThis is not coincidental. The reasons are basically:\n\n- I ❤️ 🐻\n- [I've tried before](https://5fbd3f8577526e0008aeee8b--zkcrisrojas.netlify.app/notes) to implement a good navigational UI for an online zettelkasten. I failed.\n- Bear interface has been already polished from trial and error. No need to reinvent the wheel.\n- I wanted a tool to publish my Bear notes and also wanted to \"feel at home\" when navigating.\n- Not having to worry about design decisions boosts dev speed.\n\n\n### Shortcuts\n\nTo open index/search hit:\n\n- \u003csvg style=\"margin-right:5px\" xmlns=\"http://www.w3.org/2000/svg\" width=\"10\" height=\"10\" viewBox=\"0 0 24 24\"\u003e\u003cpath d=\"M0 12v-8.646l10-1.355v10.001h-10zm11 0h13v-12l-13 1.807v10.193zm-1 1h-10v7.646l10 1.355v-9.001zm1 0v9.194l13 1.806v-11h-13z\"/\u003e\u003c/svg\u003e ` Ctr` + `K` \n-  `Cmd` + `K`\n\n### 🚧 toDo\n\n- Adding more themes\n- Allow custom CSS?\n- Escape wikilinks inside inline code blocks\n- Correct tag regex for special cases and add unit tests for both, wiki-regex and tag-regex.\n- Create quickstart repo and add Netlify deploy button.\n- 🇪🇸 → 🇬🇧: Change \"privado\" tag finder to \"private-note\"\n- Integrate an image zoom library?\n- Side menu: toDos, private notes, tag list, etc...\n- Thumbnails on search component (from now we're loading the first image of each note from the very beginning without any kind of optimization)\n- Lazy load those thumbnails\n- Add support for Hugo tags (yaml)\n- Add [[links to/headings]] support. See [this hugo thread](https://discourse.gohugo.io/t/support-wiki-internal-link-converson-to-relref-shortcode/6074) for an idea of the regex implementation\n- Add Zettels to the [Hugo theme repository](https://github.com/gohugoio/hugoThemes)\n- Integrate [slideout js](https://slideout.js.org)\n\n### Done\n\n- \u003cs\u003eAllow choosing themes from config file\u003c/s\u003e\n- \u003cs\u003eBear highlight regex: `==highlighted==` \u0026\u0026 `::highlighted::`\u003c/s\u003e\n- \u003cs\u003eCode blocks\u003c/s\u003e\n- \u003cs\u003efind a way to localize theme strings.\u003c/s\u003e\n- \u003cs\u003e🐻 Bear alike search sidebar\u003c/s\u003e\n- \u003cs\u003ePolar Markup support?\u003c/s\u003e (Nope → [It will be deprecated](https://www.reddit.com/r/bearapp/comments/n73akc/new_to_bear_markdown_comparability_mode_or_not/gxuj81r?utm_source=share\u0026utm_medium=web2x\u0026context=3))\n\n### Maybe one day/ Nice to have\n\n- Theme selector from the frontend\n- Dark theme detector from OS settings?\n- Obsidian alike nodes graph\n- Bear alike nested tag list\n- Port frontend to a more [SPA alike tech](https://svelte.dev)\n- SSG from Bear SQLite database ([wip?](https://github.com/crisrojas/miyanoSwift.git))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrisfeim%2Ftheme-hugo-bearnotes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrisfeim%2Ftheme-hugo-bearnotes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrisfeim%2Ftheme-hugo-bearnotes/lists"}