{"id":34985854,"url":"https://github.com/junian/jekyll-jtdocs","last_synced_at":"2026-03-18T01:04:04.174Z","repository":{"id":327724584,"uuid":"1090653822","full_name":"junian/jekyll-jtdocs","owner":"junian","description":"Fork of just-the-docs Jekyll Theme","archived":false,"fork":false,"pushed_at":"2026-03-07T05:24:02.000Z","size":9304,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-07T12:58:06.704Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.junian.dev/jekyll-jtdocs/","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/junian.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"junian"}},"created_at":"2025-11-06T00:42:05.000Z","updated_at":"2026-03-07T05:24:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"859aefea-40a0-42ed-802a-15f10d9a0b6b","html_url":"https://github.com/junian/jekyll-jtdocs","commit_stats":null,"previous_names":["junian/jekyll-jtdocs"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/junian/jekyll-jtdocs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junian%2Fjekyll-jtdocs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junian%2Fjekyll-jtdocs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junian%2Fjekyll-jtdocs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junian%2Fjekyll-jtdocs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/junian","download_url":"https://codeload.github.com/junian/jekyll-jtdocs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junian%2Fjekyll-jtdocs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30638905,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-18T00:09:27.587Z","status":"ssl_error","status_checked_at":"2026-03-18T00:09:26.123Z","response_time":56,"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":[],"created_at":"2025-12-27T01:33:17.267Z","updated_at":"2026-03-18T01:04:04.166Z","avatar_url":"https://github.com/junian.png","language":"SCSS","funding_links":["https://github.com/sponsors/junian"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/junian/commons-media/refs/heads/master/svg/jekyll-logo-black.svg\" style=\"height: 128px;\" /\u003e\n\n# jekyll-jtdocs\n\nA modern, highly customizable, and responsive Jekyll theme for documentation with built-in search.\nEasily hosted on GitHub Pages.\nFork of [just-the-docs](https://just-the-docs.com).\n\n[**See it in action!**](https://www.junian.dev/jekyll-jtdocs)\n\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003eA video walkthrough of various jekyll-jtdocs features\u003c/p\u003e\n\nhttps://user-images.githubusercontent.com/85418632/211225192-7e5d1116-2f4f-4305-bb9b-437fe47df071.mp4\n\n## About\n\n- Fork of [just-the-docs](https://github.com/just-the-docs/just-the-docs/) with my own addition.\n- Check `master` branch for the modifications.\n- `main` will be synced with upstream without any modification.\n\n## Installation\n\n### Use as Standard GitHub Pages\n\nCreate or edit a `_config.yml` file and add `remote_theme: junian/jekyll-jtdocs`.\nFor example:\n\n```yaml\ntitle: jekyll-jtdocs\ndescription: A Jekyll theme for documentation. Fork of just-the-docs\nremote_theme: junian/jekyll-jtdocs\n```\n\nFor stability, use a certain version, such as:\n\n```yaml\nremote_theme: junian/jekyll-jtdocs@v0.12.0\n```\n\n### Use the template\n\nThe [jekyll-jtdocs Template] provides the simplest, quickest, and easiest way to create a new website that uses the jekyll-jtdocs theme. To get started with creating a site, just click \"[use the template]\"!\n\nNote: To use the theme, you do ***not*** need to clone or fork the [jekyll-jtdocs repo]! You should do that only if you intend to browse the theme docs locally, contribute to the development of the theme, or develop a new theme based on jekyll-jtdocs.\n\nYou can easily set the site created by the template to be published on [GitHub Pages] – the [template README] file explains how to do that, along with other details.\n\nIf [Jekyll] is installed on your computer, you can also build and preview the created site *locally*. This lets you test changes before committing them, and avoids waiting for GitHub Pages.[^2] And you will be able to deploy your local build to a different platform than GitHub Pages.\n\nMore specifically, the created site:\n\n- uses a gem-based approach, i.e. uses a `Gemfile` and loads the `just-the-docs` gem\n- uses the [GitHub Pages / Actions workflow] to build and publish the site on GitHub Pages\n\nOther than that, you're free to customize sites that you create with the template, however you like. You can easily change the versions of `just-the-docs` and Jekyll it uses, as well as adding further plugins.\n\n### Use as a Ruby Gem\n\nAlternatively, you can install the theme as a Ruby Gem, without creating a new site.\n\nAdd this line to your Jekyll site's `Gemfile`:\n\n```ruby\ngem \"just-the-docs\"\n```\n\nAnd add this line to your Jekyll site's `_config.yml`:\n\n```yaml\ntheme: just-the-docs\n```\n\nAnd then install all relevant dependencies:\n\n```shell\n$ bundle\n```\n\n## Usage\n\n[View the documentation][jekyll-jtdocs] for usage information.\n\n## Contributing\n\nBug reports, proposals of new features, and pull requests are welcome on GitHub at https://github.com/junian/jekyll-jtdocs. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.\n\n### Submitting code changes:\n\n- Submit an [Issue](https://github.com/junian/jekyll-jtdocs/issues) that motivates the changes, using the appropriate template\n- Discuss the proposed changes with other users and the maintainers\n- Open a [Pull Request](https://github.com/junian/jekyll-jtdocs/pulls)\n- Ensure all CI tests pass\n- Provide instructions to check the effect of the changes\n- Await code review\n\n### Design and development principles of this theme:\n\n1. As few dependencies as possible\n2. No build script needed\n3. First class mobile experience\n4. Make the content shine\n\n## Development\n\nTo set up your environment to develop this theme\n\n- Clone this repo\n- Run `npm run install` (or `bundle install`) from the root directory\n- Run `npm run serve` (or `bundle exec jekyll serve`) to start Jekyll server\n\nAdd 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 this theme is released, only the files in `_layouts`, `_includes`, and `_sass` tracked with Git will be included in the gem.\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).\n\n[^2]: [It can take up to 10 minutes for changes to your site to publish after you push the changes to GitHub](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll#creating-your-site).\n\n[Jekyll]: https://jekyllrb.com\n[jekyll-jtdocs Template]: https://pages-templates.github.io/jekyll-jtdocs/\n[jekyll-jtdocs]: https://www.junian.dev/jekyll-jtdocs/\n[jekyll-jtdocs repo]: https://github.com/junian/jekyll-jtdocs\n[GitHub Pages]: https://pages.github.com/\n[Template README]: https://github.com/pages-templates/jekyll-jtdocs/blob/main/README.md\n[GitHub Pages / Actions workflow]: https://github.blog/changelog/2022-07-27-github-pages-custom-github-actions-workflows-beta/\n[use the template]: https://github.com/pages-templates/jekyll-jtdocs/generate\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunian%2Fjekyll-jtdocs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjunian%2Fjekyll-jtdocs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunian%2Fjekyll-jtdocs/lists"}