{"id":14979520,"url":"https://github.com/alex-1900/jekyll-theme-morph","last_synced_at":"2026-02-25T07:44:39.050Z","repository":{"id":56878920,"uuid":"371266494","full_name":"alex-1900/jekyll-theme-morph","owner":"alex-1900","description":"A simple Jekyll theme","archived":false,"fork":false,"pushed_at":"2021-06-09T16:51:18.000Z","size":229,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-18T22:14:15.608Z","etag":null,"topics":["github-page","jekyll","jekyll-theme","ruby"],"latest_commit_sha":null,"homepage":"http://www.alexis-otaku.top/jekyll-theme-morph/","language":"SCSS","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/alex-1900.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-05-27T06:15:32.000Z","updated_at":"2021-06-09T16:51:21.000Z","dependencies_parsed_at":"2022-08-20T23:10:46.429Z","dependency_job_id":null,"html_url":"https://github.com/alex-1900/jekyll-theme-morph","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alex-1900/jekyll-theme-morph","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex-1900%2Fjekyll-theme-morph","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex-1900%2Fjekyll-theme-morph/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex-1900%2Fjekyll-theme-morph/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex-1900%2Fjekyll-theme-morph/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alex-1900","download_url":"https://codeload.github.com/alex-1900/jekyll-theme-morph/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex-1900%2Fjekyll-theme-morph/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29814372,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T05:36:42.804Z","status":"ssl_error","status_checked_at":"2026-02-25T05:36:31.934Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["github-page","jekyll","jekyll-theme","ruby"],"created_at":"2024-09-24T14:00:12.536Z","updated_at":"2026-02-25T07:44:39.035Z","avatar_url":"https://github.com/alex-1900.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Morph\r\n\r\nMorph is a simple Jekyll theme for writers.\r\n\r\n[Demo](http://alex-1900.github.io/jekyll-theme-morph/)\r\n\r\n## Installation\r\nInstall with github page:\r\n\r\n### GitHub Pages\r\n1. Add these 2 lines in to your `Gemfile`:\r\n\r\n```ruby\r\ngem \"jekyll-remote-theme\"\r\ngem \"jekyll-paginate\"\r\n```\r\n\r\n2. Install the newly added gems:\r\n\r\n```bash\r\n$ bundle\r\n```\r\n\r\n3. In `_config.yml` add these lines:\r\n\r\n```yaml\r\nremote_theme: alex-1900/jekyll-theme-morph\r\n\r\npermalink: /:year/:month/:day/:title.markdown\r\npaginate: 5\r\n\r\nplugins:\r\n  - jekyll-paginate\r\n  - jekyll-remote-theme\r\n```\r\n\r\nRemove any other `theme:` or `remote_theme:` lines.\r\n\r\n4. Rename `index.md` to `index.html`. Without this, the `jekyll-paginate` gem will not work.\r\n\r\n## Layouts\r\n\r\n### Pinned articles\r\nAdd the `sticky` and `sticky_subtitle`(optional) field to post file, and you can find the article at pinned area.\r\n```yml\r\n---\r\nsticky: true\r\nsticky_subtitle: some words\r\n---\r\n```\r\n\r\n### Add tags and categories page\r\n1. create new pages `tags.html` and `categories.html` and add these lines to heads:\r\n```html\r\n---\r\nlayout: classify\r\nsource: tags\r\n---\r\n```\r\n\r\n```text\r\n---\r\nlayout: classify\r\nsource: categories\r\n---\r\n```\r\n\r\n2. add these lines to your `_config.yml`:\r\n```yml\r\nmorph:\r\n  navigation:\r\n    - name: tags\r\n      path: /tags\r\n    - name: categories\r\n      path: /categories\r\n```\r\n\r\nand can see the `tags` and `categories` buttons now.\r\n\r\n### Enable tags and categories sidebar\r\nadd these lines to your `_config.yml` in `morph` field:\r\n```yml\r\nmorph:\r\n  include:\r\n    home_categories_bar:\r\n      title: Top Categories\r\n      path: /categories\r\n    home_tags_bar:\r\n      title: Top Tags\r\n      path: /tags\r\n```\r\ncertainly, you can change the `titles` and `paths`\r\n\r\n### Add searching page\r\n1. create `search.json` at project root, and add these lines:\r\n```text\r\n---\r\nlayout: none\r\npermalink: /search.json\r\n---\r\n[\r\n{% for post in site.posts %}\r\n{\r\n    \"title\"    : {{ post.title | escape | jsonify }},\r\n    \"category\" : {{ post.category | jsonify }},\r\n    \"tags\"     : \"{{ post.tags | join: ', ' }}\",\r\n    \"url\"      : \"{{ site.baseurl }}{{ post.url }}\",\r\n    \"date\"     : \"{{ post.date }}\",\r\n    \"content\"  : {{ post.content | strip_html | strip_newlines | remove_chars | jsonify }}\r\n} {% unless forloop.last %},{% endunless %}\r\n{% endfor %}\r\n]\r\n```\r\n\r\n2. create a new file `search.html`, and add these lines to head:\r\n```html\r\n---\r\nlayout: search\r\n---\r\n```\r\n\r\n3. add change your `_config.yml` add a new page to `morph.navigation`:\r\n```yml\r\nmorph:\r\n  navigation:\r\n    - name: search\r\n      path: /search\r\n```\r\n\r\n### custom the article excerpt length in home page\r\n```yml\r\nmorph:\r\n  excerpt_length: 150  # default is 200\r\n```\r\n\r\n### custom css and javascript files\r\nAdd front matters in your pages\r\n```yaml\r\nscripts: [\r\n  /assets/your-custom-script1.js,\r\n  /assets/your-custom-script2.js\r\n]\r\n\r\nstyles: [\r\n  /assets/your-custom-stylesheet1.css,\r\n  /assets/your-custom-stylesheet2.css\r\n]\r\n```\r\n\r\n## Change the skin\r\nThere are two skins: `silver` (default) and `obsidian`, you can switching between multiple skins by `_config.yml`:\r\n```yml\r\nmorph:\r\n  skin: obsidian\r\n```\r\nand rebuild or restart the dev server\r\n\r\n#### Custom skin\r\ncreate file `_sass/skink/skin_name.scss`, and enable in `_config.yml`:\r\n```yaml\r\n# _config.yml\r\n\r\nsass:\r\n  sass_dir:     _sass\r\n  style:        compressed\r\n\r\nmorph:\r\n  skin: skin_name\r\n```\r\n\r\nand rebuild or restart the dev server\r\n\r\n## Multiple language\r\n1. Create directory and file `__data/language/[lang].yml`(the `[lang]` is abbreviation of your language)\r\n\r\n2. replace contents with another language, the following are the default values.\r\n\r\n```yml\r\nt:\r\n  posts: posts\r\n  tags_low: tags\r\n  tags_up: Tags\r\n  categories_low: categories\r\n  categories_up: Categories\r\n  about_low: about\r\n  about_up: About\r\n  search_low: search\r\n  search_up: Search\r\n  catalogue: Catalogue\r\n  home: Home\r\n  page: Page\r\n  post_up: Post\r\n  search_placeholder: input key words here...\r\n  update_time: Update time\r\n  pinned_articles: Pinned Articles\r\n  top_tags: Top Tags\r\n  top_categories: Top Categories\r\n  show_more: show more\r\n  catalogue_empty: Catalogue is empty\r\n  previous_page: Previous\r\n  next_page: Next\r\n```\r\n\r\n3 add your the `lang` item to your page files\r\n```html\r\n---\r\nlang: [lang]\r\n---\r\n```\r\n\r\n(the `[lang]` is abbreviation of your language)\r\n\r\n- for posts page, you can change the defaults scope:\r\n```yml\r\ndefaults:\r\n  - scope:\r\n      type: \"posts\"\r\n    values:\r\n      lang: [lang]  # the `[lang]` is abbreviation of your language\r\n```\r\n\r\nand rebuild or restart the dev server\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex-1900%2Fjekyll-theme-morph","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falex-1900%2Fjekyll-theme-morph","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex-1900%2Fjekyll-theme-morph/lists"}