https://github.com/thenewtoncapstone/blog

A repository of what we're learning & our progress as we embark on this crazy journey!
https://github.com/thenewtoncapstone/blog

blog chirpy-theme jekyll utterances

Last synced: 3 months ago
JSON representation

A repository of what we're learning & our progress as we embark on this crazy journey!

• Host: GitHub
• URL: https://github.com/thenewtoncapstone/blog
• Owner: TheNewtonCapstone
• License: mit
• Created: 2024-07-24T16:00:21.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-09-20T03:14:16.000Z (3 months ago)
• Last Synced: 2024-10-10T00:03:00.998Z (3 months ago)
• Topics: blog, chirpy-theme, jekyll, utterances
• Language: Ruby
• Homepage: https://thenewtoncapstone.github.io/blog/
• Size: 1.02 MB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Chirpy Starter

[![Gem Version](https://img.shields.io/gem/v/jekyll-theme-chirpy)][gem] 

[![GitHub license](https://img.shields.io/github/license/cotes2020/chirpy-starter.svg?color=blue)][mit]

When installing the [**Chirpy**][chirpy] theme through [RubyGems.org][gem], Jekyll can only read files in the folders

`_data`, `_layouts`, `_includes`, `_sass` and `assets`, as well as a small part of options of the `_config.yml` file

from the theme's gem. If you have ever installed this theme gem, you can use the command

`bundle info --path jekyll-theme-chirpy` to locate these files.

The Jekyll team claims that this is to leave the ball in the user’s court, but this also results in users not being

able to enjoy the out-of-the-box experience when using feature-rich themes.

To fully use all the features of **Chirpy**, you need to copy the other critical files from the theme's gem to your

Jekyll site. The following is a list of targets:

```shell

.

├── _config.yml

├── _plugins

├── _tabs

└── index.html

```

To save you time, and also in case you lose some files while copying, we extract those files/configurations of the

latest version of the **Chirpy** theme and the [CD][CD] workflow to here, so that you can start writing in minutes.

## Prerequisites

Follow the instructions in the [Jekyll Docs](https://jekyllrb.com/docs/installation/) to complete the installation of

the basic environment. [Git](https://git-scm.com/) also needs to be installed.

## Installation

Sign in to GitHub and [**use this template**][use-template] to generate a brand new repository and name it

`USERNAME.github.io`, where `USERNAME` represents your GitHub username.

Then clone it to your local machine and run:

```console

$ bundle

```

## Usage

Please see the [theme's docs](https://github.com/cotes2020/jekyll-theme-chirpy#documentation).

## Contributing

The contents of this repository are automatically updated when new releases are made to the [main repository][chirpy].  

If you have problems using it, or would like to participate in improving it, please go to the main repository for feedback!

## License

This work is published under [MIT][mit] License.

[gem]: https://rubygems.org/gems/jekyll-theme-chirpy

[chirpy]: https://github.com/cotes2020/jekyll-theme-chirpy/

[use-template]: https://github.com/cotes2020/chirpy-starter/generate

[CD]: https://en.wikipedia.org/wiki/Continuous_deployment

[mit]: https://github.com/cotes2020/chirpy-starter/blob/master/LICENSE