{"id":15516007,"url":"https://github.com/rafalkaron/r-jekyll-theme","last_synced_at":"2026-05-02T09:31:47.952Z","repository":{"id":54760139,"uuid":"322806076","full_name":"rafalkaron/r-jekyll-theme","owner":"rafalkaron","description":"A red portfolio theme.","archived":false,"fork":false,"pushed_at":"2021-02-13T08:42:07.000Z","size":6907,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-03-15T08:49:45.274Z","etag":null,"topics":["github-pages","jekyll","jekyll-theme","left-nav","portfolio-template","responsive","ruby"],"latest_commit_sha":null,"homepage":"https://rafalkaron.github.io/r-jekyll-theme","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/rafalkaron.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":"2020-12-19T08:57:18.000Z","updated_at":"2023-05-30T11:07:55.000Z","dependencies_parsed_at":"2022-08-14T02:00:47.378Z","dependency_job_id":null,"html_url":"https://github.com/rafalkaron/r-jekyll-theme","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafalkaron%2Fr-jekyll-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafalkaron%2Fr-jekyll-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafalkaron%2Fr-jekyll-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafalkaron%2Fr-jekyll-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rafalkaron","download_url":"https://codeload.github.com/rafalkaron/r-jekyll-theme/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246086166,"owners_count":20721294,"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":["github-pages","jekyll","jekyll-theme","left-nav","portfolio-template","responsive","ruby"],"created_at":"2024-10-02T10:05:21.035Z","updated_at":"2026-05-02T09:31:47.944Z","avatar_url":"https://github.com/rafalkaron.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# r-jekyll-theme\n\nA simple red Jekyll theme with left navigation that's perfect for portfolios and resumes.  \n\n\u003cimg width=\"2654\" height=\"1868\" alt=\"r-jekyll-theme-headers\" src=\"https://github.com/user-attachments/assets/c324cbf7-ab98-4a93-aa44-d7f9ee090d06\" /\u003e\n\u003cimg width=\"2654\" height=\"1868\" alt=\"r-jekyll-theme-blog-post\" src=\"https://github.com/user-attachments/assets/f45e2ce5-c7a4-461c-bf71-66648c6f5a1f\" /\u003e\n\n## Installation\n\nYou can install the github-remote or gem-based r-jekyll-theme. You can also fork the r-jekyll-theme GitHub repository.\n\n### Preparing for the theme installation\n\nYou need to create a directory for your Jekyll site and initialize a `Gemfile`.\n\n#### Before you begin\n\nEnsure that you have Ruby and Jekyll installed. See [Jekyll - Quickstart](https://jekyllrb.com/docs/).\n\n1. Create a directory in which you want to develop your Jekyll site.\n2. In the site directory, run `bundle init`  \n**Result:** A `Gemfile` is created.\n\n### Installing the github-remote-theme\n\nIf you plan to deploy your Jekyll site to GitHub-Pages, use this installation method.\n\n1. To the `Gemfile`, add:\n\n    ```ruby\n    gem \"github-pages\"\n    gem \"jekyll-remote-theme\"\n    ```\n\n2. In the site directory, create the `_config.yml` file.\n3. To the `_config.yml` file, add:\n\n    ```yaml\n    plugins:\n     - jekyll-remote-theme\n    remote_theme: rafalkaron/r-jekyll-theme@main\n    ```\n\n4. Run `bundle`\n\n### Installing the gem-based theme\n\nIf you're into old school, use this installation method.\n\n 1. To the `Gemfile`, add:\n\n    ```ruby\n    gem \"github-pages\"\n    gem \"r-jekyll-theme\"\n    ```\n\n 2. In the site directory, create the `_config.yml` file.\n 3. To the `_config.yml` file, add:\n\n    ```yaml\n    theme: r-jekyll-theme\n    ```\n\n 4. Run `bundle`\n\n### Forking the theme GitHub repository\n\nIf you want to heavily modify the template, use this installation method.\n\n1. Fork the [r-jekyll-theme](https://github.com/rafalkaron/r-jekyll-theme) repository.\n2. In the root directory of the forked repository, run `bundle`\n\n## Configuration\n\nThe r-jekyll-theme requires little configuration. You just need to add some content and fill in the `_config.yml` file with your site data and contact information.\n\n### Adding content\n\nYou add content by creating Markdown files in the root directory of your Jekyll site.  \n**NOTE:** You should start adding your content by creating the `index.md` file.\n\n1. In the root directory of your Jekyll site, create a Markdown file.  \nFor example, create the `index.md` file.\n1. Open the file and add:\n\n    ```markdown\n    ---\n    layout: page\n    title: Home\n    order: \"0\"\n    ---\n    ```\n\n    where:\n    * `layout` is the site HTML template. Always use the `page` value.\n    * `title` is the page title that appears in the site navigation and in the web browser tab.\n    * `order` is the position of the page link in the site navigation.\n1. Add Markdown (Kramdown) content.  \nFor reference, see [content.md](https://raw.githubusercontent.com/rafalkaron/r-jekyll-theme/main/content.md).  \n**TIP:** To keep your files organized, add any media files to the `assets` directory.\n1. Save the Markdown file.\n\n### Configuring site metadata and contact info\n\nYou configure site metadata and contact information by editing the `_confing.yml` file. For reference, see the default [_config.yml](https://raw.githubusercontent.com/rafalkaron/r-jekyll-theme/main/_config.yml).\n\n### Styling\n\nYou can override the default styling by creating the `main.scss` file in the `assets` directory.\n\n1. In the root directory of your Jekyll site, create the `assets` directory.\n2. In the `assets` directory, create and open the `main.scss` file.\n3. To the `main.scss` file, add:\n\n    ```scss\n    ---\n    ---\n    @import \"r\";\n    ```\n\n5. Under the `@import \"r\";` rule, add your styling.\n4. Save the `main.scss` file.\n\n### Previewing your site\n\nYou can generate and preview your site locally before publishing it.\n\n1. Set up your development environment by running `bundle install`  \n2. Run `bundle exec jekyll serve`\n3. In your web browser, go to `http://localhost:4000`\n4. Add pages, documents, data, styling etc. For more information, see [Jekyll Home](https://jekyllrb.com/).  \n**Info:** As you modify the theme or add content, your site should regenerate automatically in the web browser. However, to see any `_config.yml` updates, you need to restart the server.  \nIf your site does not regenerate automatically in the web browser, ensure that you have the following added to your `_config.yml` file:\n\n    ```yaml\n    livereload: true\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafalkaron%2Fr-jekyll-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frafalkaron%2Fr-jekyll-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafalkaron%2Fr-jekyll-theme/lists"}