{"id":17109952,"url":"https://github.com/oe/hexo-intuitive-image","last_synced_at":"2025-03-23T21:42:12.007Z","repository":{"id":57263515,"uuid":"422310204","full_name":"oe/hexo-intuitive-image","owner":"oe","description":"A better and intuitive way to store and use images alongside your post, with cdn supports","archived":false,"fork":false,"pushed_at":"2021-11-06T04:14:43.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T14:52:59.602Z","etag":null,"topics":["hexo","hexo-plugin","image","image-path"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/oe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-10-28T18:13:42.000Z","updated_at":"2021-11-06T04:14:46.000Z","dependencies_parsed_at":"2022-08-25T02:51:39.528Z","dependency_job_id":null,"html_url":"https://github.com/oe/hexo-intuitive-image","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oe%2Fhexo-intuitive-image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oe%2Fhexo-intuitive-image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oe%2Fhexo-intuitive-image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oe%2Fhexo-intuitive-image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oe","download_url":"https://codeload.github.com/oe/hexo-intuitive-image/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245175331,"owners_count":20572781,"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":["hexo","hexo-plugin","image","image-path"],"created_at":"2024-10-14T16:24:56.314Z","updated_at":"2025-03-23T21:42:11.977Z","avatar_url":"https://github.com/oe.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hexo-intuitive-image\nA better and intuitive way to store and use images alongside your post:\n- place image anywhere you want, use it with normal markdown image syntax\n- provide cdn for your images([Powered by jsDelivr](https://www.jsdelivr.com/features)) if your blog is served from github pages\n\n## Why\nWhy not use hexo builtin [Asset Folders](https://hexo.io/docs/asset-folders) ?\n\nMy original request: I customize `new_post_name` to `:year/:title/index.md`, I want to store any related images inside the folder `:title`, and use images in an intuitive way, so that I can change my post title with no cost.\n\n`Asset Folders` won't work out for two reasons:\n1. It's not friendly for none English users: I'm speaking Chinese but I don't like encoded codes in any uri path\n2. It won't working if you customize `new_post_name` instead of the default value. \n\n## How to use\n### Install\nwith yarn\n\n```sh\nyarn add hexo-intuitive-image -D\n```\n\nwith npm\n\n```sh\nnpm install hexo-intuitive-image -D\n```\n\n### Writing post\nuse local images by intuitive way:  \n\u003e you can refer any image from your post, the image path should be relative to your post.\n\u003e   there is no folder naming or structure requirements, refer an image at your will\n\nfor example:\n1. you got a post in path `source/_posts/2021/tips-for-google-search/index.md`\n2. and you have an image in `source/_posts/2021/vue-vs-react/vue.png`\n3. you can use image `vue.png` from the post in following syntax:\n   `![vue logo](../vue-vs-react/vue.png)`\n\n### Config\nyou may add following config to hexo's config `_config.yml` to enable more features:\n```yml\nintuitive_image:\n  # set to true to rename image name with its hash instead of its original name\n  #   to avoid naming conflicts(different images with same names) and file duplications(same images with different names)\n  hash: true\n  # enable cdn powered by jsdelivr.com\n  cdn:\n    # github repo path: \u003cgithub-username\u003e/\u003cgithub-repo-name\u003e\n    repo: oe/blog.evecalm.com\n    # branch that served github pages\n    #   leave it empty will use the default branch(normally `master` or `main`)\n    branch: gh-pages\n```\n\n## FAQ\n1. What's the final path of the images?\n  \u003e images will be under the same folder with the post's published path. e.g.:\n  \u003e   1. post path is `/2021/archived/tips-for-google-search.html`, images of it will be in path `/2021/image-assets/`\n  \u003e   2. post path is `/tips-for-google-search.html`, images of it will be in path `/image-assets/`\n2. Are all links will be handled?\n  \u003e only relative links will be processed, https/http images or images' paths start with `/` will be ignored.\n\nIf you got any questions or feature requests, feel free to [create an issue](https://github.com/oe/hexo-intuitive-image/issues/new).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foe%2Fhexo-intuitive-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foe%2Fhexo-intuitive-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foe%2Fhexo-intuitive-image/lists"}