pickmy-dot-org-jekyll-site/README.md

# pickmy.org Jekyll source

This is the main repository for pickmy.org's website. All the posts and custom code Jekyll uses to build the site.

The site is automatically built when I push stuff to the repository.

## Modifications To Theme

This uses [jekyll-theme-console by b2a3e8](https://github.com/b2a3e8/jekyll-theme-console) with a few modifications:

- _sass/base.scss has list bulleting code removed
- _sass/base.scss has had formatting changes (wider display, bigger text, more header sizes!)
- assets/list.scss now contains the list bullet code
- _includes/head.html modified to search for "list: bullet" in front matter
- _includes/header.html modified to look for page titled "/git" to display non-relative URL.
- _layouts: page and post html file have had title added using h1 tag
- _layouts: default.html has *pickmy.org added to img-src CSP since img.pickmy.org hosts images

All other changes are made in the markdown. 

## Organization Of Site

The concept of posts and pages the way they were with Wordpress are out the window. All posts are posts. All pages are posts.

I'm taking advantage of the fact I can make a folder, put a _posts folder under it, and Jekyll automatically categorizes those posts. This means there are three main types/categories of posts/pages:

- /blog: all general blogging type posts
- /pbx: all Asterisk related stuff
- /dev: all development based stuff

Post images or external resources ***ARE NOT*** stored in this repository. You think I'm crazy?

## Use of PHP

Despite being a static site generator; pickmy.org has usually had some form of random text line on it's pages since it's inception. To this effect I have specified permalinks on everything using a new format so Jekyll outputs .php files.

taglines.txt and tails.txt is not the same one used on the site. That one is stored externally and symlinked when the site is built. 

## compose.sh

Compose.sh is a bash script becuase I'm lazy. It creates a file populated with front matter:

```
---
title:
date:
permalink:
exceprt_seperator:
---
```

Post categories are determined by sub-folders automatically; in fact no posts exist in the default _posts folder for that reason. It also copies the file to the right spot based on what you tell it.

```
user@host:~/blogsite$ ./compose.sh blog Post Title Here
```

It's the blog category followed by the title. You don't have to enclose the title, the script automatically assumes every word after the first is the title.

Permalink is set to output .php extensions under /category/year/MON/day-title.php - modify how you need.