<commit_before># <NAME> blog

Personal blog - published [here](https://cgarbin.github.io/).

The blog uses [Jekyll](http://jekyllrb.com/) and the [Minimal Mistakes theme](https://mmistakes.github.io/minimal-mistakes/).

Organization:

- Posts are in the `_posts` directory.
- Images are in the `images` directory.
- Static pages are in the `_pages` directory.

## Adding tags and categories pages

This method uses [the jekyll-archives plugin](https://github.com/jekyll/jekyll-archives).

The instructions below are based on the [Minimal Mistakes documentation](https://mmistakes.github.io/minimal-mistakes/docs/configuration/#archive-settings). If there is any discrepancy between the instructions and the plugin documentation, follow the plugin documentation.

Add the plugin to the `Gemfile`:

```text
group :jekyll_plugins do
  gem "jekyll-archives"
end
```

Install the plugin:

```bash
bundle install
```

Add the plugin to the `plugins` section in `_config.yml`:

```yaml
plugins:
  ...
  - jekyll-archives
```

Set the `..._archives` variables in `_config.yml` to use the plugin:

```yaml
category_archive:
  type: jekyll-archives
  path: /categories/
tag_archive:
  type: jekyll-archives
  path: /tags/
```

Uncomment (or add) the plugin configuration section in `_config.yml`:

```yaml
jekyll-archives:
  enabled:
    - categories
    - tags
  layouts:
    category: archive-taxonomy
    tag: archive-taxonomy
  permalinks:
    category: /categories/:name/
    tag: /tags/:name/
```

Copy the Minimal Mistakes tag and categories pages.

```bash
mkdir _pages
cp docs/_pages/category-archive.md _pages
cp docs/_pages/tag-archive.md _pages
```

To add a link to the tags page, modify `navigation.yml`:

```yaml
main:
  - title: 'Posts by tag'
    url: /tags/
  - title: 'About'
    url: /about/
```

Regenerate the site (stop and restart `bundle exec jekyll serve`).<commit_msg>Add instructions to test and publish<commit_after># <NAME> blog

Personal blog - published [here](https://cgarbin.github.io/).

The blog uses [Jekyll](http://jekyllrb.com/) and the [Minimal Mistakes theme](https://mmistakes.github.io/minimal-mistakes/).

Organization:

- Posts are in the `_posts` directory.
- Images are in the `images` directory.
- Static pages are in the `_pages` directory.

## Releasing new posts

1. Test the posts locally with `bundle exec jekyll serve`
   1. Open a browser window to the address shown
1. Release them with `./publish.sh`
   1. This will push the files generated by the `bundle exec..` command to the `gh-pages` branch

## Adding tags and categories pages

This method uses [the jekyll-archives plugin](https://github.com/jekyll/jekyll-archives).

The instructions below are based on the [Minimal Mistakes documentation](https://mmistakes.github.io/minimal-mistakes/docs/configuration/#archive-settings). If there is any discrepancy between the instructions and the plugin documentation, follow the plugin documentation.

Add the plugin to the `Gemfile`:

```text
group :jekyll_plugins do
  gem "jekyll-archives"
end
```

Install the plugin:

```bash
bundle install
```

Add the plugin to the `plugins` section in `_config.yml`:

```yaml
plugins:
  ...
  - jekyll-archives
```

Set the `..._archives` variables in `_config.yml` to use the plugin:

```yaml
category_archive:
  type: jekyll-archives
  path: /categories/
tag_archive:
  type: jekyll-archives
  path: /tags/
```

Uncomment (or add) the plugin configuration section in `_config.yml`:

```yaml
jekyll-archives:
  enabled:
    - categories
    - tags
  layouts:
    category: archive-taxonomy
    tag: archive-taxonomy
  permalinks:
    category: /categories/:name/
    tag: /tags/:name/
```

Copy the Minimal Mistakes tag and categories pages.

```bash
mkdir _pages
cp docs/_pages/category-archive.md _pages
cp docs/_pages/tag-archive.md _pages
```

To add a link to the tags page, modify `navigation.yml`:

```yaml
main:
  - title: 'Posts by tag'
    url: /tags/
  - title: 'About'
    url: /about/
```
{'fraction_non_alphanumeric': 0.11954887218045113, 'fraction_numerical': 0.0010025062656641604, 'mean_word_length': 3.8434466019417477, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 8, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '580803', 'n_tokens_mistral': 1325, 'n_tokens_neox': 1251, 'n_words': 433}