{"id":14979374,"url":"https://github.com/pandasekh/jekyll-yamt","last_synced_at":"2025-04-05T22:07:30.233Z","repository":{"id":41174211,"uuid":"263430160","full_name":"PandaSekh/Jekyll-YAMT","owner":"PandaSekh","description":"YAMT is a minimal Jekyll theme focused on simplicity and ease-of-use.","archived":false,"fork":false,"pushed_at":"2022-10-23T19:18:13.000Z","size":4802,"stargazers_count":75,"open_issues_count":0,"forks_count":100,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-04-26T12:43:34.770Z","etag":null,"topics":["jekyll","jekyll-theme","jekyll-themes","minimal-theme"],"latest_commit_sha":null,"homepage":"https://pandasekh.github.io/Jekyll-YAMT/","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PandaSekh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-12T19:18:18.000Z","updated_at":"2024-04-16T18:57:36.000Z","dependencies_parsed_at":"2022-08-30T22:13:14.885Z","dependency_job_id":null,"html_url":"https://github.com/PandaSekh/Jekyll-YAMT","commit_stats":null,"previous_names":[],"tags_count":4,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PandaSekh%2FJekyll-YAMT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PandaSekh%2FJekyll-YAMT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PandaSekh%2FJekyll-YAMT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PandaSekh%2FJekyll-YAMT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PandaSekh","download_url":"https://codeload.github.com/PandaSekh/Jekyll-YAMT/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247406090,"owners_count":20933803,"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":["jekyll","jekyll-theme","jekyll-themes","minimal-theme"],"created_at":"2024-09-24T13:59:54.010Z","updated_at":"2025-04-05T22:07:30.216Z","avatar_url":"https://github.com/PandaSekh.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [YAMT - Yet Another Minimal Theme](https://yamt.netlify.app/)\n![](https://badgen.net/rubygems/dt/jekyll-yamt)\n[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/PandaSekh/Jekyll-YAMT/issues)\n![GitHub forks](https://img.shields.io/github/forks/PandaSekh/Jekyll-YAMT?label=Fork%20it%21\u0026style=social)\n## [Live Demo](https://yamt.netlify.app/)\n\n![Homepage](https://raw.githubusercontent.com/PandaSekh/Jekyll-YAMT/master/assets/img/screenshots/Screenshot.png?raw=true)\n\nYAMT is a minimal [Jekyll](http://jekyllrb.com) theme focused on simplicity and ease-of-use. It has great modularity, allowing you to easily decide what you actually want on your website.\n\n## Contents\n\n- [Features](#features)\n- [Screenshots](#screenshots)\n- [Installation](#installation)\n- [Customize](#customize)\n  - [Basics](#basics)\n  - [Typography](#typography)\n  - [Header](#header)\n  - [Home](#home)\n  - [Post](#post)\n  - [Contact Form](#contact-form)\n- [Development](#development)\n- [Credits](#credits)\n- [License](#license)\n\n## Features\n\n- Minimal and clean design.\n- Fully modular: activate and load only what you really need.\n- Works great on mobile and smaller screens.\n- Works on Github Pages.\n- Supports [Disqus](https://disqus.com/) comments activated only on button press, if you activate them.\n- [Google Analytics](https://www.google.com/analytics/) support.\n- [Open Graph](https://ogp.me/) and [Twitter Cards](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/guides/getting-started) support to better index the website content on search engines and social networks.\n- [MathJAX](https://www.mathjax.org/) and [LaTeX](https://www.latex-project.org/) optional support. Write beautiful math!\n- [RSS](https://github.com/jekyll/jekyll-feed) support.\n- Beautiful [Syntax Highlight](https://yamt.netlify.app/2020/05/19/special-formatting.html#syntax-highlight). Write some code and show it in a graceful way.\n\n## Screenshots\n\nMobile:  \n![Mobile](https://raw.githubusercontent.com/PandaSekh/Jekyll-YAMT/master/assets/img/screenshots/Screenshot_mobile.png?raw=true)\n\nCode Highlight:  \n![Code](https://raw.githubusercontent.com/PandaSekh/Jekyll-YAMT/master/assets/img/screenshots/Screenshot_code_highlight.png)\n\nMinimal:  \n![Minimal](https://raw.githubusercontent.com/PandaSekh/Jekyll-YAMT/master/assets/img/screenshots/Screenshot_minimal.png?raw=true)\n\n## Installation\n\nThere are four way to use YAMT: Netlify (suggested, as this theme has a contact module built-in working only on Netlify), Github Pages, as a gem-based theme, by forking this repo or by copying all the files into your directory.\n\n### Download the files\nYou can [download the files](https://github.com/PandaSekh/Jekyll-YAMT/releases/latest) and add them in your directory to start working.\n\n### Netlify\n\n1. [Fork this repo](https://github.com/PandaSekh/Jekyll-YAMT/generate). You can copy only master, set it to private or public and name it however you want.\n2. Go to [Netlify](https://app.netlify.com/), create a New site from Git, choose your repo or all repos, no difference. Back to Netlify, select the recently forked repo.\n3. Owner and branch are good to go. In build command write `bundle exec jekyll build` and publishing directory should be `_site/`.\n4. Deploy. Your site will shortly be available. Under domain settings you can change your subdomain, or add a primary level one. \n\n### Github Pages\n\nGithub Pages uses the [--safe flag](https://jekyllrb.com/docs/configuration/options/) to build jekyll websites, which disable custom plugins, caching to disk and ignore symbolic links. Because of that, I suggest you to use any other method. Netlify works great with a 5 minute config, so I suggest you use it.\n\n1. [Fork this repo](https://github.com/PandaSekh/Jekyll-YAMT/generate).\n2. Create a new branch in your repo and call it `gh-pages`.\n3. Publish your website and choose gh-pages as the target branch.\n\n### Remote theme\n\n[Follow these instructions](https://help.github.com/en/github/working-with-github-pages/adding-a-theme-to-your-github-pages-site-using-jekyll).\n\n### Gem-based theme \n1. Add this line to your Jekyll site's `Gemfile`:\n\n    ```ruby\n    gem \"jekyll-yamt\"\n    ```\n\n2. And add this line to your Jekyll site's `_config.yml`:\n\n    ```yaml\n    theme: jekyll-yamt\n    ```\n\n3. And then execute:\n\n    ``` bash\n    $ bundle\n    ```\n\n4. Or install it yourself as:\n    \n    ``` bash\n    $ gem install jekyll-yamt\n    ```\n\n#### ERROR: There was an error while loading `jekyll-yamt.gemspec`: No such file or directory - git ls-files -z. Bundler cannot continue.\nIf you encounter this error when running `bundle install`, please make sure git is installed.\n\n## Customize\n\nYAMT is easily customizable. If you don't need a functionality, just deactivate it in `_data/settings.yml`.\nMost of the customizable things are self-explanatory and found in the `_data` folder and in the `_config.yml`.\n\n### Basics\n\nUnder the `_data` folder there are three files: pages, settings and social.\nIn pages you can add other pages that will show up in the nav-\nIn social you can add your socials that will show up in the nav. To add a social, find a suitable icon on [FontAwesome](https://fontawesome.com/) and add it's name in the name tag.\nBrand defines Font Awesome's font type (fas is solid, fab is brand).\nOut of the box this theme has support colors for a bunch of social. If your social isn't supported, just add the color in the header.css \n\nIn `_data/settings.yml` you can activate or deactivate various functions of the theme, like analytics, disqus comments, related posts and so on.\n\n### Typography\nBy default YAMT uses the System Font STack, which greatly reduces load times. If you want to use the old Font Stack, in `assets/main.scss` change `typography` to `typography-old`.\n\n### Header\nIn `_data/settings.yml` you can choose to hide or show the subtitle, the page navigation or the social icons.\n\n### Home\nIn `_data/settings.yml` you can choose to hide or show the posts infos (date and read-time) and the featured image.\n\n### Post\nIn `_data/settings.yml` you can choose to hide or show the post infos, categories, related posts and comments.\nNote that by removing categories the Categories Archives will no longer be reachable.\n\n### Contact Form\nYAMT has a built-in contact form builded using [Netlify](https://app.netlify.com/) free form functionality. To make it work you only need the line `data-netlify=\"true\"` when declaring a form.  \nIf you don't want to use Netlify, remove the line `data-netlify=\"true\"`.\n\n## Development\n\n[Contributions are welcomed and encouraged](https://github.com/PandaSekh/Jekyll-YAMT/issues).\n\nTo set up your environment to develop this theme, run `bundle install`.\n\nYour theme is setup just like a normal Jekyll site! To test your theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.\n\nWhen your theme is released, only the files in `_layouts`, `_includes`, `_sass` and `assets` tracked with Git will be bundled.\nTo add a custom directory to your theme-gem, please edit the regexp in `yamt.gemspec` accordingly.\n\n## Credits\nTheme designed and created by [Alessio Franceschi](https://github.com/PandaSekh/).\nInspired by [Lagrange by LeNPaul](https://lenpaul.github.io/Lagrange/).  \nAlso great help from [this blog](https://blog.webjeda.com/), I've used this even before I created this theme.  \nImages from [Unsplash](https://unsplash.com/).\n\n## License\nThe theme is available as open source under the terms of the [MIT License](https://github.com/PandaSekh/Jekyll-YAMT/blob/master/LICENSE.txt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpandasekh%2Fjekyll-yamt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpandasekh%2Fjekyll-yamt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpandasekh%2Fjekyll-yamt/lists"}