{"id":19468367,"url":"https://github.com/neroblackstone/lume-blog-muse","last_synced_at":"2026-02-02T07:04:54.546Z","repository":{"id":139014954,"uuid":"375646626","full_name":"NeroBlackstone/lume-blog-muse","owner":"NeroBlackstone","description":"Lume blog template for musicians","archived":false,"fork":false,"pushed_at":"2022-05-23T07:46:39.000Z","size":641,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-14T08:02:35.756Z","etag":null,"topics":["blog-theme","deno","lume"],"latest_commit_sha":null,"homepage":"https://lume-blog-muse.pages.dev/","language":"CSS","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/NeroBlackstone.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":"2021-06-10T09:42:54.000Z","updated_at":"2024-12-18T22:39:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"12e57f70-0aa5-4936-abee-cd210f82069c","html_url":"https://github.com/NeroBlackstone/lume-blog-muse","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/NeroBlackstone/lume-blog-muse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeroBlackstone%2Flume-blog-muse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeroBlackstone%2Flume-blog-muse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeroBlackstone%2Flume-blog-muse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeroBlackstone%2Flume-blog-muse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NeroBlackstone","download_url":"https://codeload.github.com/NeroBlackstone/lume-blog-muse/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeroBlackstone%2Flume-blog-muse/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262748754,"owners_count":23358264,"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":["blog-theme","deno","lume"],"created_at":"2024-11-10T18:40:51.131Z","updated_at":"2026-02-02T07:04:54.484Z","avatar_url":"https://github.com/NeroBlackstone.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# lume-blog-muse -- Lume blog template for musicians\n\n`lume-blog-muse` is a out of box open source blog template powered by [lume](https://github.com/lumeland/lume). Lume is a Deno static site generator. \n\n[See template live demo](https://lume-blog-muse.pages.dev/)\n\n[See developer's blog using this template](https://neroblackstone-blog.pages.dev/)\n\n[see developer's blog repository, learn how to configure in action](https://github.com/NeroBlackstone/lume-blog)\n\nThis blog template base on [base-blog](https://github.com/lumeland/base-blog/), but it is more beautiful, and has more built-in features.\n\n- **Super lightweight.** Source code less than 2MB. **No need node_modules**. \n- **Easy to configure.** Only one configuration file, control all options.\n- **Auto dark mode.** Light theme and dark theme will change according to your system settings. (Or you can choose which theme to use)\n- **For musicians.** Built-in [OSMD](https://opensheetmusicdisplay.org/) support. Inserting MusicXML score in markdown is as easy as inserting image. Express your feelings about music freely.\n- **MIDI Player.** Built-in [midi player](https://github.com/cifkao/html-midi-player) and visualizer.\n- **LaTeX.** Built-in KaTex plugin.\n- **Mindmap** Built-in markmap support.\n- **Disqus** comment system.\n- **CloudFlare** web Analytics.\n- **Forestry.io** headless cms.  \n\n## Installation\n\n1. Please make sure you have installed [deno](https://deno.land/) and [lume](https://lumeland.github.io/).\n2. clike [here](https://github.com/NeroBlackstone/lume-blog-muse/generate) to create a new repository from `lume-blog-muse`.\n3. `git clone` your own project /  **Recommend: If you don't want to configure your site locally, you can also go [forestry.io](https://forestry.io/)  and configure all settings in wabpage gui.**\n\n## Configuration\n\nHere are all the files and folders you need pay attention to:\n\n```\n└── src\n    ├── _data\n    |   └── site.yml // This is your blog config file\n    ├── img // image used by site\n    ├── posts // Your blog posts markdown file\n    |   └── image // image used by posts\n    └── musicxml // Put all your MusicXML sheet here\n    └── about.md // your self-introduction\n```\n\n## Run\n\nUse `cd` change the current working directory to `lume-blog-muse`, then:\n\n```\nlume --serve\n```\n\nNow you can preview your site at [localhost](http://localhost:3000/).\n\n## Custom your blog\n\n**Be sure to confirm these options before your first deployment.**\n\n### Basic page content\n\nCheck `./src/_data/site.yml`, according your page content to modify this file. You can also change site theme in this file.\n\nDisqus and Cloudflare Web Analytics default statue is disable, you can enable it in this configuration file.\n\n## Write a blog post\n\nCheck `./src/posts/MarkdownExample.md` to know how to write markdown.\n\nIf you need to insert MusicXML, put xml file into `./src/xml/`, for example, you have a `Beethoven.xml`, then you can use `osmd-container` label in markdown to render this xml file. \n\n```\n\u003cosmd-container file=\"Beethoven\"\u003e\u003cosmd-container/\u003e\n```\n\nIf you want to insert midi-player, put midi file into `./src/midi/`, for example, you have a `sample.mid`, then you can use `midi-container` label in markdown to play this midi file.\n\n```\n\u003cmidi-container file=\"sample.mid\"\u003e\u003cmidi-container/\u003e\n```\n\nThere are three kinds of visualizer that can be attached to player: `piano-roll`, `waterfall`, `staff`.\n\n```\n\u003cmidi-container file=\"sample.mxl\" type=\"piano-roll\"\u003e\u003cmidi-container/\u003e\n```\n\n## Deployment\n\nHere is tutorial for deploy this lume project to [Cloudflare Pages](https://pages.cloudflare.com/):\n\n### Edit site.yml\n\nFirst of all, open `./src/_data/site.yml`, then edit `url` :\n\n```\nauthor:\n  url: https://lume-blog-muse.pages.dev/\n```\n\n\n\nThis is your site url. Cloudflare pages provide free domain for your site. For example, you will create a cloudflare pages project name `my-blog`, then free domain will be `https://my-blog.pages.dev/`, so replace `url`:\n\n```\nauthor:\n  url: https://my-blog.pages.dev/\n```\n\n\u003e What happended behind this: `_config.js` will read this value and put it in `lume({location: new URL(\"www.example.com\"),})`\n\nCommit changes, push to your blog repository.\n\n### Create Cloudflare Pages Project\n\nGo to your Cloudflare dashboard, click \"Pages\" -\u003e \"Create a project\".\n\nCreate a project from your lume blog repository.\n\nAt \"Set up builds and deployments\" step, fill in the following:\n\n1. Project name: `my-blog`\n2. Build command:\n\n```\ncurl -fsSL https://deno.land/x/install/install.sh | sh \u0026\u0026 /opt/buildhome/.deno/bin/deno run -A https://deno.land/x/lume/ci.ts\n```\n\nIf you forget what `url` you write in `site.yml`, or prompt \"A project with this name already exists\", you can also use `--location=` overriding url settings. \n\nFor example, now Cloudflare Pages project name is `my-blog2`, then use this build command:\n\n```\ncurl -fsSL https://deno.land/x/install/install.sh | sh \u0026\u0026 /opt/buildhome/.deno/bin/deno run -A https://deno.land/x/lume/ci.ts --location=https://my-blog2.pages.dev/\n```\n\n3. Build output directory: `_site`\n\nThat's all, click \"Save and Deploy\".\n\nWhenever your blog repository updated, deployment will auto start and keep your site up to date. You don't have to repeat this step again and again.\n\n### More platforms\n\nGo [base-blog](https://github.com/lumeland/base-blog#deployment) to learn how to deploy to more platforms.\n\n## Thanks \n\nThanks [Oscar Otero](https://github.com/oscarotero) who help me a lot. He is also the mainly maintainer of lume project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneroblackstone%2Flume-blog-muse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneroblackstone%2Flume-blog-muse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneroblackstone%2Flume-blog-muse/lists"}