You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

60 lines
2.4 KiB
Markdown

2 years ago
# 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:
2 years ago
- _sass/base.scss has list bulleting code removed
2 years ago
- _sass/base.scss has had formatting changes (wider display, bigger text, more header sizes!)
2 years ago
- 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.
2 years ago
- _layouts: page and post html file have had title added using <h1>
2 years ago
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?
2 years ago
2 years ago
## 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 is not the same one used on the site. That one is stored externally and symlinked when the site is built.
2 years ago
## compose.sh
Compose.sh is a bash script becuase I'm lazy. It creates a file populated with front matter:
```
---
title:
date:
2 years ago
permalink:
2 years ago
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.
2 years ago
Permalink is set to output .php extensions under /category/year/MON/day-title.php - modify how you need.