{"id":13472258,"url":"https://github.com/ayushnix/kangae","last_synced_at":"2025-03-26T15:31:43.766Z","repository":{"id":133168154,"uuid":"487523407","full_name":"ayushnix/kangae","owner":"ayushnix","description":"a lightweight microblog theme for zola","archived":false,"fork":false,"pushed_at":"2023-06-21T01:32:09.000Z","size":1263,"stargazers_count":10,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-30T04:13:24.551Z","etag":null,"topics":["html5-css3","indieweb","microblog","no-javascript","zola","zola-theme"],"latest_commit_sha":null,"homepage":"https://kangae.ayushnix.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"ncsa","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ayushnix.png","metadata":{"files":{"readme":"README.md","changelog":null,"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},"funding":{"github":"ayushnix","ko_fi":"ayushnix"}},"created_at":"2022-05-01T11:48:52.000Z","updated_at":"2024-02-18T17:59:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"139ebad5-100a-49a5-b997-08b05b625657","html_url":"https://github.com/ayushnix/kangae","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayushnix%2Fkangae","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayushnix%2Fkangae/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayushnix%2Fkangae/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayushnix%2Fkangae/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ayushnix","download_url":"https://codeload.github.com/ayushnix/kangae/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245681360,"owners_count":20655177,"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":["html5-css3","indieweb","microblog","no-javascript","zola","zola-theme"],"created_at":"2024-07-31T16:00:53.354Z","updated_at":"2025-03-26T15:31:43.166Z","avatar_url":"https://github.com/ayushnix.png","language":"HTML","funding_links":["https://github.com/sponsors/ayushnix","https://ko-fi.com/ayushnix","https://www.buymeacoffee.com/ayushnix'","https://cdn.buymeacoffee.com/buttons/default-blue.png'","https://ko-fi.com/O5O64SQ4C'"],"categories":["HTML"],"sub_categories":[],"readme":"# kangae (考え, idea or thought)\n\n[kangae][1] is a lightweight microblog theme for [zola][2].\n\n\u003cdetails\u003e\n  \u003csummary\u003ekangae screenshots on desktop and mobile\u003c/summary\u003e\n\n  ![kangae screenshot light mode on desktop](static/images/kangae-desktop-light.webp)\n  ![kangae screenshot dark mode on desktop](static/images/kangae-desktop-dark.webp)\n  ![kangae screenshot light mode on mobile](static/images/kangae-mobile-light.webp)\n  ![kangae screenshot dark mode on mobile](static/images/kangae-mobile-dark.webp)\n\u003c/details\u003e\n\nI've created kangae from scratch and it is not based on any other theme. However, I was inspired to\ncreate kangae after I came across [Wolfgang Müller's microblog][3]. Thanks Wolf!\n\nkangae is licensed under the [NCSA license][5], which is quite similar to the BSD-3-Clause license.\nUnlike BSD-3-Clause, NCSA also covers documentation of a project.\n\n# Showcase\n\nHere's a list of websites using the kangae theme\n\n- [ayushnix microblog][4]\n\nIf you want to mention your website in this section, please raise a pull request.\n\n# Installation\n\nBefore using this theme, [install zola][6]. After you've installed zola,\n\n```\n$ zola init microblog\n\u003e What is the URL of your site? (https://example.com):\n\u003e Do you want to enable Sass compilation? [Y/n]:\n\u003e Do you want to enable syntax highlighting? [y/N]:\n\u003e Do you want to build a search index of the content? [y/N]:\n$ cd microblog/\n```\n\nkangae doesn't use Sass or syntax highlighting so if you don't want to use custom Sass code or\nenable syntax highlighting, answer the 2nd and 3rd question with a 'no'. kangae also doesn't use any\nJavaScript library to search content. If you don't intend to install a JavaScript library to enable\nsearch on your microblog, answer 'no' to the last question as well.\n\nIf you intend to publish your microblog on a forge like GitHub, initialize an empty git repository\nusing\n\n```\n$ git init\n$ git commit --allow-empty -m 'initial empty root commit'\n```\n\nIf you don't want to make an empty commit, add and commit a README or a LICENSE file instead.\n\nAt this point, you can install kangae using one of the following methods\n\n## using `git subtree`\n\n```\n$ git subtree add -P themes/kangae/ --squash https://github.com/ayushnix/kangae.git master\n```\n\n## using `git submodule`\n\n```\n$ git submodule add https://github.com/ayushnix/kangae.git themes/kangae\n```\n\n## download kangae in themes directory\n\nIf you want to keep things simple and figure out version control later, you can\n\n```\n$ git clone https://github.com/ayushnix/kangae.git themes/kangae\n```\n\n# Configuration\n\nTo begin using kangae after installing it,\n\n```\n$ cp themes/kangae/config.toml ./\n$ sed -i 's;# theme =\\(.*\\);theme =\\1;' config.toml\n```\n\nThe [`config.toml`][7] file of kangae has been documented carefully using TOML comments. If you have\nany questions about configuring kangae which haven't been answered in the `config.toml` file itself,\nplease [raise an issue][8].\n\n## Shortcodes\n\nkangae provides several shortcodes that can be used to add content in an accessible manner\n\n### kaomoji `(・_・)ノ`\n\nIf you want to use kaomoji in your posts, you can use insert them in an accessbile manner using\n\n```\nI don't know. {{ kaomoji(label=\"shrug kaomoji\", text=\"╮( ˘_˘ )╭\") }} I've never thought about it.\n```\n\nProviding a value for the `label` is optional but highly recommended. A short text should be\nmentioned that explains what the kaomoji means to convey. The value of `text` should be the actual\nemoticon itself.\n\nThis shortcode can also be used for any other ASCII emoticon that can fit in an inline paragraph.\nThis includes western emoticons such as `;)` and combination emoticons such as `\u003c(^_^\u003c)`.\n\n### Quotes\n\nYou can add quotes in your microblog posts using\n\n```\n{% quote(author=\"Nara Shikamaru\") %}\nYou would think just this once, when it was life or death, I could pull through.\n{% end %}\n```\n\nThis is the most basic form of improvement in writing quotes over simply using `\u003e` in markdown.\n\nIf you want to mention the name of the source from where the quote has been taken, such as the name\nof the book or a movie, you can use\n\n```\n{% quote(citation=\"Mass Effect 3\", author=\"Javik\") %}\nStand in the ashes of a trillion dead souls, and ask the ghosts if honor matters. The silence is your answer.\n{% end %}\n```\n\nA `citeurl` can also be given as an argument to this shortcode to provide the actual URL from where\nthe source is borrowed.\n\n```\n{% quote(author=\"Edward Snowden\", citeurl=\"https://old.reddit.com/r/IAmA/comments/36ru89/just_days_left_to_kill_mass_surveillance_under/crglgh2/\") %}\nArguing that you don't care about the right to privacy because you have nothing to hide is no different than saying you don't care about free speech because you have nothing to say.\n{% end %}\n```\n\nA live preview of these how these shortcodes look like can be found on [this blog post][14].\n\n## Optional Features\n\nkangae includes some optional features that aren't enabled by default\n\n- [style external links using a ↗ unicode symbol][11]\n\n# Donate\n\nIf you found kangae helpful in creating your own microblog website, please consider supporting me by\nbuying me a coffee :coffee:\n\n\u003ca href='https://www.buymeacoffee.com/ayushnix' target='_blank' rel=\"noopener\"\u003e\u003cimg src='https://cdn.buymeacoffee.com/buttons/default-blue.png' alt='buy ayushnix a coffee at buymeacoffee.com' border='0' height='36'\u003e\u003c/a\u003e\n\u003ca href='https://ko-fi.com/O5O64SQ4C' target='_blank' rel=\"noopener\"\u003e\u003cimg src='https://cdn.ko-fi.com/cdn/kofi1.png?v=2' alt='buy ayusnix a coffee at ko-fi.com' border='0' height='36'\u003e\u003c/a\u003e\n\nIf you're in India, you can also use UPI for donations. My UPI address is `ayushnix@ybl`.\n\n# Notes\n\nAlthough I'm not a web developer, I am interested in learning HTML and CSS to create lightweight\ntextual websites. You may be interested in reading [my log about how I learned HTML and CSS][12].\nHowever, that page is just an unorganized dump of my thoughts and isn't a polished blog post.\n[Seirdy's blog post on creating textual websites][13] is probably a better reference.\n\n# TODO (maybe?)\n\n- (responsive) image shortcodes\n- run prettier on HTML and CSS before deployment\n- twitter and mastodon shortcodes\n- add optional support for cross posting and commenting on mastodon without using JS\n- add optional support for [giscus][9] and [loading mastodon comments][10]\n- add shortcode for asciinema\n- add shortcode for blockquote and citation\n- pagination\n- light and dark mode switch\n- content tabs\n- microdata and microformats2\n\n[1]: https://kangae.ayushnix.com/\n[2]: https://www.getzola.org/\n[3]: https://zunzuncito.oriole.systems/\n[4]: https://microblog.ayushnix.com\n[5]: LICENSE\n[6]: https://www.getzola.org/documentation/getting-started/installation/\n[7]: config.toml\n[8]: https://github.com/ayushnix/kangae/issues/new\n[9]: https://giscus.app/\n[10]: https://carlschwan.eu/2020/12/29/adding-comments-to-your-static-blog-with-mastodon/\n[11]: https://github.com/ayushnix/kangae/blob/master/static/css/style-external-links.css\n[12]: https://wiki.ayushnix.com/frontend/creating-a-website/\n[13]: https://seirdy.one/2020/11/23/website-best-practices.html\n[14]: https://kangae.ayushnix.com/being-shikamaru-102/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayushnix%2Fkangae","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fayushnix%2Fkangae","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayushnix%2Fkangae/lists"}