{"id":23913007,"url":"https://github.com/drshika/jekyll-theme-manpage","last_synced_at":"2025-04-16T01:12:35.430Z","repository":{"id":270943237,"uuid":"911838529","full_name":"drshika/jekyll-theme-manpage","owner":"drshika","description":"jekyll theme inspired by my personal website","archived":false,"fork":false,"pushed_at":"2025-01-18T23:20:43.000Z","size":24722,"stargazers_count":7,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-16T01:12:29.416Z","etag":null,"topics":["jekyll","jekyll-blog","jekyll-theme","jekyll-themes","ruby-gem","rubygem"],"latest_commit_sha":null,"homepage":"https://jekyll-theme-manpage.netlify.app/","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/drshika.png","metadata":{"files":{"readme":"README.md","changelog":"news-archive.md","contributing":null,"funding":null,"license":"LICENSE.txt","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":"2025-01-04T01:39:42.000Z","updated_at":"2025-03-12T03:34:50.000Z","dependencies_parsed_at":"2025-01-04T20:03:17.935Z","dependency_job_id":null,"html_url":"https://github.com/drshika/jekyll-theme-manpage","commit_stats":null,"previous_names":["drshika/jekyll-theme-manpage"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drshika%2Fjekyll-theme-manpage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drshika%2Fjekyll-theme-manpage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drshika%2Fjekyll-theme-manpage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drshika%2Fjekyll-theme-manpage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/drshika","download_url":"https://codeload.github.com/drshika/jekyll-theme-manpage/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249178217,"owners_count":21225350,"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-blog","jekyll-theme","jekyll-themes","ruby-gem","rubygem"],"created_at":"2025-01-05T09:20:11.655Z","updated_at":"2025-04-16T01:12:35.412Z","avatar_url":"https://github.com/drshika.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📇 Jekyll Theme Manpage\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/d2497628-6688-4ba9-909c-4680a22f2a72/deploy-status)](https://app.netlify.com/sites/jekyll-theme-manpage/deploys)\n\u003ca href=\"https://jekyll-themes.com/drshika/jekyll-theme-manpage\"\u003e\n  \u003cimg\n    src=\"https://img.shields.io/badge/featured%20on-JT-red.svg\"\n    height=\"20\"\n    alt=\"Jekyll Themes Shield\"\n  /\u003e\n\u003c/a\u003e\n\nA minimalist Jekyll theme inspired by Linux man pages. Perfect for personal websites, portfolios, and blogs with a technical focus.\n\n![Preview](assets/readme/preview.png)\n\n## Features\n\n- 📱 Fully responsive layout\n- 🌙 Automatic dark mode support\n- ✍️ Blog/writing section with:\n  - Full-text search\n  - Tag filtering\n  - Table of contents\n  - Reading Time\n- 📐 LaTeX and mhChem support for mathematical and chemical expressions\n- 🎨 Multiple color skins with light/dark variants\n- 🚀 Fast and lightweight\n- 🔍 SEO optimized\n- 📊 Sitemap generation\n- 💬 Giscus comments integration\n- 📡 RSS feed support\n\n## Installation\n\n1. Follow the steps to [create repository from template](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template#creating-a-repository-from-a-template)\n\n## Usage\n\n### Basic Setup\n1. Set any social links you would like to include in `_data/social_links.yml`. You can add as many as you like!\n2. News posts are formatted like this:\n```\n{: .news-header}\n[Month, Year]\n\n{: .news}\nText for your news here\n```\nAdditional news posts can be added in the `news-archive.md` file with the same format.    \n\n3. Fun facts can be added in `_data/facts.yml`. The theme will automatically turn this into a linked list for you.   \n4. If you would like to add/remove sections from the home page, `_data/navigation.yml` has each page and the link. \nFor the links that go to a header on the homepage you can use the name of the header after the home page route: \n\n*file: index.md*\n```markdown\n# Section\n```\nwould be   \n*file: navigation.yml*\n``` yaml\n- name: Section\n  link: /#section\n```\nSee this [markdown reference](https://garrettgman.github.io/rmarkdown/authoring_pandoc_markdown.html#headers) for more guidance on how to figure out the links for your headers.\n\nFor links that go to other pages on the site you will most likely have to prefix the page name with `../../`. \n```yaml\n- name: Writing\n  link: ../../writing.html\n```\n \n\n### Writing Posts\n\nCreate posts in `_posts` directory following this format:\n\n```markdown\n---\nlayout: post\ntitle: Your Post Title\ndescription: Brief description\ntags: [tag1, tag2]\ntoc: true # Optional table of contents\n---\nYour content here...\n```\n\nMake sure to name the file with the `YYYY-MM-DD-Title.md`. \n\n\n### Customization\n\n#### Color Skins\n\nThe theme comes with several preset color schemes. You can set the base skin in the `config.yaml` file and the light and dark mode will automatically adapt to whatever the user has set as their preference. \n\n### Light Mode Variants\n| Theme | Preview |\n|-------|---------|\n| Purple | ![Purple Theme](assets/themes/purple.png) |\n| Tomorrow | ![Tomorrow Theme](assets/themes/tomorrow.png) |\n| GitHub | ![GitHub Theme](assets/themes/github.png) |\n| Dracula | ![Dracula Theme](assets/themes/dracula.png) |\n| Nord | ![Nord Theme](assets/themes/nord.png) |\n| Monokai | ![Monokai Theme](assets/themes/monokai.png) |\n\n### Dark Mode Variants\n| Theme | Preview |\n|-------|---------|\n| Purple | ![Purple Dark Theme](assets/themes/purple_dark.png) |\n| Tomorrow | ![Tomorrow Dark Theme](assets/themes/tomorrow_dark.png) |\n| GitHub | ![GitHub Dark Theme](assets/themes/github_dark.png) |\n| Dracula | ![Dracula Dark Theme](assets/themes/dracula_dark.png) |\n| Nord | ![Nord Dark Theme](assets/themes/nord_dark.png) |\n| Monokai | ![Monokai Dark Theme](assets/themes/monokai_dark.png) |\n\n#### Typography\n\nThis theme uses Nitti as its default font. You can purchase Nitti from [Adobe Fonts](https://fonts.adobe.com/fonts/nitti). If you have purchased the font, you can put it in the `assets/fonts` directory and it should automatically load. \n\nIf you want to use a different font, you will have to change lines 8-35 in `_sass/jekyll-theme-manpage.scss` to import/load the correct font. You will also need to set the default font in `_sass/variables.scss`\n\n```css\n// Typography\n$font-family-mono: \"Nitti\", \"Source Code Pro\", \"Inconsolata\", monospace;\n```\n\n## Development\n\nTo set up your environment to develop this theme:\n\n1. Clone this repo\n2. Run `bundle install`\n3. Run `bundle exec jekyll serve`\n4. Visit `http://localhost:4000`\n\nIf you want to try out the different skins, you will have to stop and start the bundler each time.\n\n## Optional Features\n\nEnable optional features in your `_config.yml`:\n\n```yaml\nfeatures:\n  comments: true  # Set to true to enable Giscus comments\n  rss_feed: true  # Set to true to enable RSS feed\n  search: true  # Set to true to enable search\n  google_analytics: false  # Set to true to enable Google Analytics\n  tags: true  # Set to true to enable tags\n  read_time: true  # Set to true to enable read time\n  back_to_top: false  # Set to true to enable back to top button\n```\n\n### Comments\n\nTo enable comments:\n\n1. Set `features.comments: true` in your `_config.yml`\n2. Get your Giscus script from [giscus.app](https://giscus.app)\n3. Paste the generated script into `_includes/comments.html`\n\nDisable comments for specific posts by adding `comments: false` to the post's front matter.\n\n### RSS Feed\n\nTo enable RSS feed:\n\n1. Set `features.rss_feed: true` in your `_config.yml`\n\nYour feed will be available at `/feed.xml`. See [Jekyll Feed documentation](https://github.com/jekyll/jekyll-feed) for additional configuration options.\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](https://www.contributor-covenant.org/) code of conduct.\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\n## Credits\n\nCreated with ❤️ by Drshika Asher\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrshika%2Fjekyll-theme-manpage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrshika%2Fjekyll-theme-manpage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrshika%2Fjekyll-theme-manpage/lists"}